Libraries

GigaSpaces libraries located at <GigaSpaces Root>\lib folder:

You may find the space runtime library at <GigaSpaces Root>\lib\JSpaces.jar and 3rd party libraries located at sub-folders under <GigaSpaces Root>\lib.

Client Classpath

When a client application accessing GigaSpaces running in a remote mode the client should have the following jars as part of its classpath:
<GigaSpaces Root>\lib\JSpaces.jar
<GigaSpaces Root>\lib\jini\jsk-platform.jar
<GigaSpaces Root>\lib\jini\jsk-lib.jar

java -cp c:\GigaSpacesEE5.0\lib\JSpaces.jar com.j_spaces.examples.hellospace.
HelloWorld jini://localhost/*/mySpace?groups=myGroup

Jars shouldn't be located in directories that contain a space as part of their names. For example, do not place GigaSpaces jars under the C:\Documents and Settings or its sub-folders. As a workaround you may specify the classpath using: C:\Docume~1.

Server Classpath

An application running GigaSpaces in embedded mode should set the following libraries and directories as part of its classpath.
<GigaSpaces Root>\jini\jsk-platform.jar
<GigaSpaces Root>\jini\jsk-lib.jar
<GigaSpaces Root>\jini\start.jar
<GigaSpaces Root>\rio\webster.jar
<GigaSpaces Root>\rio\boot.jar
<GigaSpaces Root>\log4j\log4j.jar

To simplify the classpath configuration, JSpaces.jar contains the above list as part of its manifest file. As of JDK 1.5, you can include only the main JAR,(JSpaces.jar), and the compiler or JVM finds the rest of the libraries through the manifest classpath entry.

In the example below, only JSpaces.jar is added to the classpath. The rest of the libraries are located implicitly by the JVM.

If you want to copy the libraries to your own environment, you must maintain the directory structure of the libraries as listed above. The full classpath definition for running GigaSpaces is provided in the GigaSpaces setenv under the GS_JARS environment variable. You can call the setenv shell that is provided as part of the GigaSpaces/bin directory from your application script and use the GS_JARS variable as = part of your classpath.

Where the GS_JARS environment variable.

For Windows:
call %JSHOMEDIR%\bin\setenv
echo GigaSpaces Classpath= %GS_JARS}

For Unix:
source ${JSHOMEDIR}/bin/setenv.sh
echo GigaSpaces Classpath= ${GS_JARS}

Adding Libraries to the GigaSpaces Server Classpath

Sometimes a patch must be installed or new libraries included as part of the GigaSpaces server system classpath. To simplify the installation, perform these updates without changing the existing configuration files. For this purpose, GigaSpaces maintains the lib/ext directory. Each JAR installed in this directory is automatically included as part of the GigaSpaces classpath. You can use the LCP environment variable as a reference to this directory.