2. Configuring GBS for GemStone/S 64 Bit

Previous chapter

While the GemStone/S 64 Bit Windows Client provides a number of server utilities that can be run on Windows, the primary purpose of the GemStone/S 64 Bit Windows Client is to provide the libraries that support client applications on Windows, such as GemBuilder for Smalltalk (GBS) client applications.

This chapter describes how to configure or update your client Smalltalk application using GBS on Windows to run with a GemStone/S 64 Bit version 3.7 server.

The GemStone/S 64 Bit v3.7 server requires a compatible version of GBS; versions of GBS earlier than v8.7 for VisualWorks Smalltalk, or v5.4.7 for VA Smalltalk are not fully supported with GemStone/S 64 Bit v3.7 or later servers.

In addition to using the appropriate version of GBS, you must use GemStone/S 64 Bit 3.7 client libraries with your GBS client application, to be able to log in to the v3.7 server. These libraries are specific to the GemStone/S 64 Bit server version and to the client platform.

Only RPC logins are available from Windows.

The GemStone/S 64 Bit Windows Client provides both 64-bit libraries and 32-bit libraries.

For instructions on installing and configuring GBS, see the GemBuilder for Smalltalk Installation Guide for the appropriate version of GBS.

Supported GBS client Smalltalk Platforms with Windows

The following client Smalltalk versions are supported on Windows platforms:

GemBuilder for Smalltalk/VW v8.7
  • VisualWorks 9.1.1 (32-bit and 64-bit)
  • Windows 10
GemBuilder for Smalltalk/VA v5.4.7
  • VA Smalltalk 11.0.1
  • WindowsServer 2016 and Windows 10
  • VA Smalltalk 10.0.2
  • WindowsServer 2016 and Windows 10
  • VA Smalltalk 8.6.3
  • Windows Server 2016 and Windows 10

GBS Setup or Upgrade Procedure

Shared Libraries for GBS Client Node

The GBS client requires a set of shared libraries (.dlls) that are provided as part of the GemStone server product distribution. Since the GemStone/S 64 Bit server itself is not available for Windows, the Windows Client distribution is provided, which includes the shared libraries as well as other server utilities that can be run on Windows.

When these client shared libraries are loaded into the VisualWorks or VA Smalltalk image in which GBS code is installed, the GBS client can log into the GemStone server.

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 and client executable bit size (32-bit or 64-bit).

You can either install the full GemStone/S 64 Bit Windows Client on your GBS client node, or just copy the specific shared libraries you need.

Full GemStone/S 64 Bit Windows Client installation on client node

One option for installation is to install the complete GemStone/S 64 Bit Windows Client on the client machine.

In addition to the shared libraries, the GemStone/S 64 Bit client installation includes tools such as topaz and VSD, that may be useful to run on your client.

To perform this installation, follow the instructions in Chapter 1 of this Installation Guide.

Libraries only

If you do not require tools such as vsd or topaz on the client, you do not need to install the full GemStone/S 64 Bit Windows Client on the client node. You may just copy the set of library files that GBS requires.

32-bit VisualWorks or VAST clients:

For RPC logins from 32-bit VisualWorks or VA Smalltalk, the following files need to be copied to the client node:

%GEMSTONE%\bin32\libgcirpc-3.7.0-32.dll
%GEMSTONE%\bin32\libssl-3.7.0-32.dll
%GEMSTONE%\bin32\msvcr100.dll
64-bit VisualWorks clients:

For RPC logins from 64-bit VisualWorks, the following files need to be copied to the client node:

%GEMSTONE%\bin\libgcirpc-3.7.0-64.dll
%GEMSTONE%\bin\libssl-3.7.0-64.dll
%GEMSTONE%\bin\msvcr100.dll

GBS provides a number of options as to where to place the shared libraries on the client machine. Refer to the GemBuilder for Smalltalk Installation Guide for details on these options.

Upgrade GBS to a version that supports v3.7

Versions of GBS earlier than 8.7 for VisualWorks and 5.4.7 for VA Smalltalk are not supported with GemStone/S 64 Bit v3.7 or later.

If you are currently running with an older version of GBS, you will need to upgrade your GBS client application, and possibly also upgrade VisualWorks or VAST to a more recent version, in order to use these clients with v3.7.

GBS does not support upgrade from an image in which an older version of GBS has been previously installed. To upgrade GBS, start with a client Smalltalk image in which GBS is not installed. Follow the instructions in the GemBuilder for Smalltalk Installation Guide, and then restore your application code.

See the GemBuilder for Smalltalk Installation Guide for more information, and the GemBuilder for Smalltalk Release Notes for details on the changes in these versions.

Update GBS to reference v3.7 libraries

Once you have installed the GemStone Windows Client on the GBS client machine, or copied the appropriate shared libraries, you need to ensure that the client Smalltalk executable – a VisualWorks or VA Smalltalk application – will load the v3.7 libraries.

Determining library name to specify

Whether or not you have a full GemStone/S 64 Bit Windows client installation on the client or have copied a few libraries, there is a specific library name you will specify to have GBS load using the libraryName: parameter.

32-bit VisualWorks or VAST clients:
libgcirpc-3.7.0-32.dll
64-bit VisualWorks clients:
libgcirpc-3.7.0-64.dll
Setup GBS to load the new libraries
  • If you have set the GBS configuration parameter libraryName:, update this to the new library name, and save your image.
  • If you have set the GBS configuration parameter libraryName: to an empty string, ensure that no other client libraries of the same name are in the current working directory or the bin directory or subdirectory of your VisualWorks image’s VISUALWORKS directory. This is not applicable to VA Smalltalk.
  • For a new GBS application, refer to the GemBuilder for Smalltalk Installation Guide for details on the library loading setup options.
Stop and restart the client VM

GBS loads the client libraries into the client Smalltalk VM the first time a GemStone server call is made after each startup of the VM.

GBS is now ready to use.

Previous chapter