Upgrading the JewelSuite Floating License Server

This topic describes how to upgrade the FlexNet license server executables (lmgrd.exe and the joa vendor daemon) to a newer version on the same server. This is required when a new release of JewelSuite ships with a newer version of the FlexNet license libraries.

The license file and your port configuration do not change during this process. Only the executables are replaced.

Before you start

1. Download the new JewelSuite Floating License Executables from the Baker Hughes download portal and extract them to a temporary location on the server.
2. Check how many clients currently have licenses checked out by running the following on the server:
   lmutil lmstat -c 10000@localhost -a

Stopping the license server

1. Log on to the server that is hosting the JewelSuite licenses.
2. Browse to the existing JewelSuite license server folder and run lmtools.exe as Administrator.
3. Go to the Config Services tab and select the JewelSuite license service from the Service Name dropdown.
4. Go to the Start/Stop/Reread tab and click Stop Server. If the server does not stop within 30 seconds, select the Force Server Shutdown checkbox and try again.
5. Go to the Config Services tab and make sure the JewelSuite license service is selected.
6. Uncheck Start Server at Power Up and click Save Service. This prevents the service from restarting automatically during the upgrade.

Installing the new license server

It is recommended to copy the new executables to a new versioned folder rather than overwriting the existing files. This keeps the previous executables available for rollback if needed. For example:

Once the new executables are in place, update the lmtools service to point to them:

1. Browse to the new JewelSuite license server folder and run lmtools.exe as Administrator.
2. On the Config Services tab in lmtools, select the Service Name field.
   Enter a descriptive name that includes the version number, such as JewelSuite Floating License Service 11.19.9.1.
3. Update Path to the lmgrd.exe file to point to lmgrd.exe in the new folder.
4. Update Path to the debug log file if you want to write the log to the new folder.
5. The Path to the license file does not need to change. If you had it next to the executables, you can copy it to the new folder.
6. Check both Use Services and Start Server at Power Up so the license server starts automatically after a server reboot.
7. Click Save Service.

Starting and verifying the upgraded server

1. Go to the Start/Stop/Reread tab and click Start Server.
2. Go to the Server Status tab and click Perform Status Enquiry. Confirm that lmgrd and joa are both listed as running.
3. Return to the Config Services tab and click View Log. Verify the log lists all expected features without errors.
4. Open JewelSuite on a test client machine and verify that the application starts and licenses are checked out successfully.

Rollback procedure

Because the new executables were registered as a separate service entry, the previous service entry is still available in lmtools. If the upgraded server does not start correctly and you need to restore service quickly:

1. On the Config Services tab, select the new JewelSuite license service from the Service Name dropdown, uncheck Start Server at Power Up and click Save Service.
2. Select the previous JewelSuite license service from the Service Name dropdown, re-check Start Server at Power Up and click Save Service.
3. Go to the Start/Stop/Reread tab and click Start Server.
4. Verify the server is serving licenses before proceeding to diagnose the upgrade issue.

For common server startup errors and their resolutions, see Troubleshooting license errors.