1. Installing GemStone/S 64 Bit Windows Client

Next chapter

This chapter describes the procedure for installing the Windows client component for GemStone/S 64 Bitâ„¢ version 3.6.7.

This client installation provides shared libraries that can be used to log in from a client running on Windows to a GemStone/S 64 Bit server on a server machine, utilities such as topaz and VSD that can be run on the Windows client, and provides the include files used to link client GCI applications on the Windows client.

The GemStone/S 64 Bit server does not run directly on the Windows platform.

System Requirements

The following system requirements are for the GemStone/S 64 Bit client components; which are released with, and must be compatible with, the GemStone/S server product.

For system requirements for the client Smalltalk environments, and for GemBuilder for Smalltalk (GBS) supported platforms, refer to the documentation that is provided with your client smalltalk product, and to the GemBuilder for Smalltalk installation Guide.

GBS depends on the client shared libraries provided by this distribution; support for GBS client platforms is limited to platforms that are supported by the GemStone/S 64 Bit server.

Operating system versions

  • Windows 2016
  • Windows 10

Windows 7 reached end of life in January of 2020. This is no longer a certified platform, although it may continue to work.

If you are using GemBuilder for Smalltalk, you should also ensure that your version of client Smalltalk – VisualWorks or VA Smalltalk – is supported on the given OS version, and that GemBuilder for Smalltalk is supported on that version.

Installing the GemStone/S 64 Bit Windows Client

Perform the following steps to install GemStone/S 64 Bit Windows client components.

1. As the Windows Administrator account or as an account that belongs to the Administrators group, log in to the client machine.

2. Select an installation directory, InstallDir, and make this directory the current working directory.

3. GemStone/S 64 Bit is provided as a zipped archive file with a name similar to GemStone64BitClient3.6.7-x86.Windows_NT.zip. Extract the contents of this archive into the directory location in which GemStone will be installed, InstallDir.

You may perform this extraction using unzip or another uncompress application, or using Windows Explorer.

4. Verify that InstallDir now contains a GemStone directory with a name similar to GemStone64BitClient3.6.7-x86.Windows_NT.

The following directories and files are included:

bin\

64-bit shared libraries, and executables for VSD and topaz.

bin32\

32-bit shared libraries, and executables for topaz.

externals.sha.txt

Git sha for externals included in the distribution

include\

Include files used for GCI applications

lib\

64-bit TCL libraries for VSD, and lib files

lib32\

32-bit lib files

licenses\

GemStone licence file and licenses for open-source code included with GemStone.

sys\

Topaz help file

ualib\

Empty directory for user action libraries.

version.txt

Contains information on the particular product and release of this GemStone client.

Set the Environment

Perform the following steps to properly configure the operating environment.

You may not need to do this if you are not running the GemStone/S 64 Bit utilities, such as topaz and gslist, on the Windows client. However, you may need to configure your windows path to include the directory containing the shared library files.

1. Add or update the %GEMSTONE% environment variable. This is required only if you will be executing topaz on the windows client, or linking a shared library.

a. Open System Settings, and select System and Security and then System.

b. On the left-side menu, select Advanced System Settings, then on the Advanced tab.

c. Select the Environment Variables button.

d. Set the environment variable GEMSTONE to the full pathname of your new GemStone installation directory.

If this is a new installation, in the System Environment Variables list, click on the New button, and enter the full path, starting with the drive, of your new Gemstone Installation directory.

If you are updating an existing installation, select GEMSTONE in the System Environment Variables list. Click on the Edit button, and update the value with your new GemStone new installation directory

2. Add or update the %Path% environment variable. This is required if your client Smalltalk library loading uses the %Path% to locate the client shared libraries, as well as when running topaz or linking a shared library.

a. Open System Settings, and select System and Security and then System.

b. Click on the Advanced tab, then on the Environment Variables button.

c. In the System Environment Variables list, select the Path variable, and click on the Edit button. Add %GEMSTONE%/bin to the front of the path string.

If you are updating an existing installation, remove the previous GemStone directory from the path.

Define the NetLDI Service Name

To log in remotely to a GemStone/S 64 Bit server, there must be a NetLDI service running on the server machine. A NetLDI is not needed and can not be run on the Windows client.

By default, the server NetLDI name is gs64ldi. In order to log in using the name of the NetLDI service, either gs64ldi or the name you select, this service name must be defined in your Windows client TCP/IP network database, and define the same port number as defined on the server.

If you do not define the NetLDI name and port on the Windows client, you can still login using the port number within your login parameters, rather than the name.

To define a NetLDI name on the Windows client:

1. Open the TCP/IP network database, which is located at:

C:\WINDOWS\system32\drivers\etc\services

2. Add an entry similar to the following :

gs64ldi 50377/tcp #GemStone 3.6.7

This port number must be the same as the NetLDI service you will connect to on the GemStone/S 64 Bit server machine.

3. Save the file and exit.

Next chapter