2. Configuring GBS for GemStone/S 64 Bit

Shared Libraries for Client Node

The GBS client requires a set of shared libraries (.so files) that are provided as part of the GemStone server or client product distribution.

The shared libraries must be the same version as the GemStone server. Since they are loaded into the client smalltalk VM, they must be appropriate for the client platform.

It is recommended to install the full GemStone/S 64 Bit Raspberry Pi Client on your GBS client node, as is described in Chapter 1 of this Installation Guide.

However, you may instead just copy the specific shared libraries that are needed.

$GEMSTONE/lib32/libgcirpc-3.5.1-32.so

$GEMSTONE/lib32/libssl-3.5.1-32.so

Library name to specify

For GemStone clients on the Raspberry Pi, the library name that will be loaded is always:

libgcirpc-3.5.1-32.dll

Setup GBS to load the new libraries

The client library is generally specified by executing code in the client image, prior to logging in.

There are a number of ways to specify the client library:

• Execute code to set full path

Set libraryName to the full path and file name of the client library file. This is the recommended option.

For example:

GbsConfiguration current libraryName:

	    'InstallDir/GemStone64Bit3.5.1-arm32.Linux/lib32/libgcirpc-

	3.5.1-32.so'

With this option, the shared libraries may be anywhere on the client; the libraries do not need to be on the $LD_LIBRARY_PATH.

• Execute code to set filename, allow system to determine path

Set libraryName to the file name of the client library file.

For example:

GbsConfiguration current libraryName: 

    'libgcirpc-3.5.1-32.so'

This option requires that the library be in a directory in the standard library directories.

• Allow system to determine path and filename (VisualWorks only)

Leave libraryName set to the empty string. This is the default, equivalent to:

GbsConfiguration current libraryName: '' 

This requires that the client libraries be in the current working directory, or in the bin directory or subdirectory of your VisualWorks image’s VISUALWORKS directory.

• Use file dialog to set path and filename

Use the file dialog to select the library name and path.

If the library name specified by libraryName in the previous options cannot be loaded, the resulting notification provides the option of selecting a file using a file dialog.

The load error may be due to an incorrect libraryName, copying the wrong library, or an additional required library failing to load.

Navigate to the location of the shared library and select the file. The dialog provides filename filtering, so only valid library names will appear.

Selecting a file using the file dialog will set libraryName to the full path selected.