Cloudscape Access Using RmiJdbc
Page 3 of 6

Configuring Cloudscape for RmiJdbc

Setting Class Path

Before starting the server, add the class paths of the RmiJdbc and Cloudscape libraries to your class path. For instance, if you have installed Cloudscape under C:\cloudscape, add C:\cloudscape\frameworks\RmiJdbc\classes\RmiJdbc.jar and C:\cloudscape\lib\cloudscape.jar to the class path. Also add the libraries for any Java classes used in your databases.

Cloudscape also provides script files for setting the class path, located in $CLOUDSCAPE_INSTALL\frameworks\RmiJdbc\bin.

See Getting Started with Cloudscape for more information on setting class path.

RmiJdbc JVM Information

RmiJdbc is compatible with JDK1.1.x. and JDK 1.2.

By default, Cloudscape does not install the JDK security manager. If you want to use the security manager, use the -sm flag when booting an RmiJdbc server.

NOTE: The RmiJdbc server uses the 1.1 JDK package to look up the server host name (java.net.InetAddress.getLocalHost). On Solaris, this method is sometimes unreliable and may return "localhost" instead of the server host name, which means that clients will not be able to connect. To get around this problem, set the property java.rmi.server.hostname to the actual server host name when starting the RmiJdbc server. For example:

java -ms16m -mx32m -Djava.rmi.server.hostname=godfrey
    RmiJdbc.RJJdbcServer COM.cloudscape.core.JDBCDriver

For information on permissions and security with JDK1.2, see the JDK Web site: at http://java.sun.com/products/jdk/1.2/docs/index.html.

Setting Port Numbers

By default, Cloudscape using RmiJdbc listens on TCP/IP port number 1099. If you want to use a different port number, you can specify it on the command line when starting the RmiJdbc server. For example:

java -ms16m -mx32m -noasyncgc RmiJdbc.RJJdbcServer -port 1088
    COM.cloudscape.core.JDBCDriver

It is better, however, to specify these changes in the startCS.bat or startCS.ksh scripts. See Starting and Stopping the RmiJdbc Server for more information on these scripts.