Running the server

To run the server, follow these steps.

  1. Compile the entire Java source tree in both the /src and JNI_Supplement directories by importing all the Java source into a project in an IDE.
    Configure the IDE to have all the JAR files in the /libdirectory of the InterChange Server or Adapter Framework in the CLASSPATH.
  2. Create a directory called TwineBall under the connectors directory of your Adapter Framework or InterChange Server installation.
  3. Export all compiled class files into this directory using a normal Java package structure (that is, com.ibm.sample.MyClass stored as com/ibm/sample/Myclass.class).
  4. Copy all the files in the setup\scripts directory to this folder as well. Normally an application would be in a different directory than an adapter, but structuring it this way will simplify the install.
  5. Add the newly created TwineBall directory to your system CLASSPATH. This will allow the Java runtime to find the server classes.
  6. Make sure the Java Development Kit bin directory is in the CLASSPATH. Run the runrmic.bat file. This will produce the necessary stubs and skeletons necessary for RMI communication.
  7. Create a new directory called Properties inside the TwineBall directory.
  8. Place the TwineBall.policy and TwineBall.db2.properties files from the dependencies directory here and rename TwineBall.db2.properties to TwineBall.properties.
  9. Edit the TwineBall.properties file to change server.name to your system name. For instance, if your machine is called JEFFB, your server.name will be //JEFFB:2112/TwineBallServer.
  10. Start the TwineBall server by executing the runserver script. The message "Server ... has been registered" appears when it is working.
  11. Leave the server running in a window. Your ODA and adapter will connect to it via RMI.

Copyright IBM Corp. 1997, 2004