Installing Cloudscape in a Server Framework
Page 4 of 7

Libraries

The Cloudscape installation programs automatically install the Cloudscape (and optionally, Cloudconnector) libraries. If you want to deploy Cloudscape through a means other than the installation program, this section describes the Cloudscape product's directory structure.

Cloudscape libraries are installed in the /lib subdirectory of the cloudscape base directory. lib includes the following files:

  • cloudscape.jar
  • client.jar
  • tools.jar
  • cloudsync.jar (only if you have installed the Cloudscape synchronization option)

If you have installed the Cloudconnector option, frameworks/cloudconnect/lib includes weblogicaux.jar. Cloudconnector also uses the files in frameworks/cloudconnect/classes and frameworks/cloudconnect/license.

The server framework-specific libraries are installed in the frameworks subdirectory of the cloudscape base directory. The frameworks subdirectory always includes an RmiJdbc subdirectory. If you install the Cloudconnector option, frameworks also includes a cloudconnect subdirectory. If you install another server framework, you may want to install it in a directory under frameworks.

When to Use client.jar

The client.jar file is provided with all Cloudscape products.

When an application accesses a Cloudscape database by using Cloudconnector or the RmiJdbc server, the client application needs client.jar on its class path along with the Cloudconnector or RmiJdbc server client classes.

For other server frameworks, client applications may not need client.jar. Typically, JDBC client applications need client.jar and non-JDBC client applications do not. In general, server frameworks that completely hide Cloudscape from their client applications can safely omit client.jar from their client application libraries.

Specifically, a client application needs client.jar in its class path if either of the following is true:

  • The application can execute arbitrary SQL statements and get back data or exceptions from the database.
  • The application can make requests that return any COM.cloudscape.* objects, such as COM.cloudscape.types.TypeDescriptor. COM.cloudscape.* types are primarily used in the Cloudscape system catalogs and built-in system functions such as RuntimeStatistics.