About the JewelSuite licensing model

When a JewelSuite application is executed, one of the first things it does is check for a valid software license. JewelSuite software licenses are provided using Flexera Software FlexNet licensing.

FlexNet Licensing and the Licensing Wizard

FlexNet license configuration is handled by the JewelSuite Licensing Wizard. The Licensing Wizard can be opened at any time from the Windows Start menu.

The JewelSuite licensing configuration is stored per user account. If multiple users share a single machine, each user must run the Licensing Wizard separately to configure access to the license. This is a common reason why one user can run the software while another on the same machine cannot.

The Licensing Wizard can install a new license or update an existing (expired) one. Have your license activation information ready before proceeding. On the first panel, click Next to reach the Import License panel, which offers the following options:

Use a Local License File

Use this option if you have a .lic file on your computer. The wizard will link the license file to the software.

Use a JewelSuite Floating License Server

This option allows FlexNet licenses to be shared across a network. A license server manages which licenses are in use. Enter the hostname and port number of your floating license server as configured by your IT department. The default port is 10000.

Borrow/Early Return a License

When your company uses a floating license server, you can borrow a license for offline use. A borrowed license can be used even if the license server is unreachable. For example, when taking a laptop off-site. To borrow, you must be connected to the license server. Specify a borrow expiry date and select the features to borrow. The maximum borrow duration is set by your license administrator. If you do not return the license early, it is automatically released on the expiry date.

Retrieve a license from the JewelSuite Licensing Server

Use this option to download a license file from the online JewelSuite Licensing Server hosted by Baker Hughes. The host ID of your local machine and your credentials are used to determine which license files are available for download.

View Current License Status

Displays information about the current license configuration. Use this option to verify the expiration date or which features are licensed after completing any of the above options.

License file format

A JewelSuite floating license file contains the following key sections:

SERVER localhost a1b2c3d4e5f6 10000
DAEMON joa C:/FlexLM/JewelSuite/joa.exe PORT=10001
USE_SERVER
FEATURE FEATURE_1 joa 10.0 31-dec-2020 1 ISSUED=27-Mar-2019 \
BORROW=250 NOTICE="Generated for: Baker Hughes" SIGN="<redacted>"
FEATURE FEATURE_2 joa 10.0 31-dec-2020 1 ISSUED=27-Mar-2019 \
BORROW=250 NOTICE="Generated for: Baker Hughes" SIGN="<redacted>"

The SERVER line identifies the license server and the port that lmgrd listens on:

SERVER hostname hostid port

The DAEMON line identifies the vendor daemon and the port it uses for feature checkouts:

DAEMON vendor vendor_daemon_path PORT=port

The vendor daemon runs as a separate process from lmgrd and uses its own port. Both the lmgrd port (SERVER line) and the vendor daemon port (DAEMON line) must be reachable from client machines. By default, the vendor daemon picks a random port at startup; adding a fixed PORT= value to the DAEMON line makes the port predictable and allows it to be opened in a firewall. See Installing the JewelSuite Floating License Server for instructions.

The USE_SERVER line instructs the client to obtain its license from the server rather than reading the feature lines directly from the file. The FEATURE lines define what is licensed and are validated by the vendor daemon; they must not be edited.

Contact our support department at SoftwareSupport@bakerhughes.com for additional information.