A 5-minute screencast of this blog post can be found here.

Would you like to run GemStone/S 64 Bit on a Microsoft Windows machine? If so, then the Windows Subsystem for Linux makes that possible. Starting with a 64-bit version of Windows 10, follow these steps:

Install Ubuntu 18.04

  1. Run Windows PowerShell as Administrator and enter the following (on one line): Enable-WindowsOptionalFeature -Online -FeatureName Microsoft-Windows-Subsystem-Linux
  2. Confirm a restart to complete the process.
  3. From the Windows Store application, install Ubuntu 18.04, pin it to the Start menu, and then launch it.
  4. When prompted, enter a new UNIX username and password and then update your system: sudo apt update && sudo apt upgrade

Install GemStone

  1. In the Linux shell, create some GemStone directories:
    1. sudo mkdir /opt/gemstone
    2. sudo chown $USER /opt/gemstone
    3. cd /opt/gemstone
    4. mkdir locks log
  2. In a web browser, navigate to the GemStone product page and copy the link for the Linux download. Use wget to download the product (enter command on one line): wget https://downloads.gemtalksystems.com/pub/GemStone64/3.4.2/GemStone64Bit3.4.2-x86_64.Linux.zip
  3. Install the unzip utility: sudo apt install unzip
  4. Unzip the product: unzip GemStone*
  5. Create a symbolic link to the unzipped directory: ln -s GemStone* product
  6. Edit your profile to add/update environment variables: vim ~/.profile
    1. export GEMSTONE=/opt/gemstone/product
    2. export PATH=$GEMSTONE/bin:$PATH
  7. Edit the services file to add an entry for NetLDI: sudo vim /etc/services
    1. gs64ldi    50377/tcp    # GemStone/S 64 Bit 3.4.2
  8. Copy in a new database:
    1. cp $GEMSTONE/bin/extent0.dbf $GEMSTONE/data/
    2. chmod +w $GEMSTONE/data/extent0.dbf

Start GemStone

  1. Open a new Linux shell to get your environment variables and start GemStone
    1. gslist
    2. startnetldi -g -a $USER
    3. startstone
    4. gslist

Install Jade

  1. Open a web browser on the Jade Releases.
  2. Download (Save) Jade.zip (one of the assets) to your Downloads folder.
  3. Open the Downloads folder and extract the download.
  4. Copy the entire Jade folder to C:\Program Files (x86).
  5. Pin Jade.exe to the Start Menu.
  6. Edit C:\Windows\System32\drivers\etc\services to add an entry for NetLDI:
    1. gs64ldi    50377/tcp    # GemStone/S 64 Bit 3.4.2

Log in to GemStone with Jade

  1. From the Start Menu, launch Jade.
    1. If Windows identifies Jade as an unrecognized app, click More info and then the Run anyway button.
  2. Ensure that the version shown in Jade is a close match to the GemStone version, and click the Login button.
  3. Now you can explore your GemStone/S database that is running in Windows!

Stop GemStone

  1. From a Linux shell you can stop GemStone:
    1. gslist
    2. stopstone gs64stone DataCurator swordfish
    3. stopnetldi
    4. gslist