How to Install Licenses on a Floating License Server

This article is part of the Licensing for Keysight Test & Measurement series of articles. It shows how to install new licenses onto a floating license server. For complete documentation, refer to the “See also” section at the end of this article.

How to Install Licenses on a Floating License Server

This article is part of the Licensing for Keysight Test & Measurement series of articles. It shows how to install a new license on an already exit floating license server. For complete documentation, refer to the “See also” section at the end of this article.

 

⚠This process assumes you have already set up a license server and a new license file to install. How to Set Up a Keysight Floating License Server

⚠The complete instructions for this can be found in the Keysight Licensing Quick Start Guide.

 

Step 1 - Check Server Version

Verify that the license server is the latest version. If it is not, update it to the newest version.

⚠ Licensing may fail if the server is not up to date.

 

How to find the installed versions

1. Navigate to the server installation directory, open the ReadMe.txt file

1. Windows: C:\Program Files\Common Files\Keysight\Licensing Daemon\bin
2. Linux: /opt/keysight/licensing-daemon/bin

2. Compare the agileesofd and lmgrd, with the latest versions for your operating system. You can find the latest versions at http://www.keysight.com/find/licenseserver

 

Exact instructions for updating the license server are in the Keysight Licensing Quick Start Guide.

 

Step 2: Obtain a license file

If you don’t already have a license file, you will need to get one from Keysight Software Manager. You will need the Host ID. These two articles show how to do accomplish this.

• How to Find the Host ID for a Keysight Floating License Server
• How Can I redeem a Software License from Keysight Software Manager (KSM)?

 

Step 3: Save the license file

1. Make a copy of the license file on your hard disk, in:

• Windows: C:\ProgramData\Keysight\Licensing\Licenses\Server
• Linux: /var/opt/keysight/licensing/licenses/server

2. Open or view the license files in the directory to ensure they all specify the same port value (between 27000 and 27009, inclusive) in their SERVER statements. If not, edit them to have the same port value. You will experience licensing failures if the licenses have conflicting port numbers. See Port Number Conflicts as needed.
3. On Linux, you must set the file permissions so that it can be read by lmgrd. For example:

chmod a+r <filename.lic>

Step 4: Restart the license server manager

 

Windows

To start the FlexNet license server manager (lmgrd) and vendor daemon (agileesofd), restart the Windows service (typically named EEsof EDA License Server).

 

Linux

Start the license server manager (lmgrd) and vendor daemon (agileesofd) on the machine to which the license is tied as follows:

a. Change directory to the location of your server files (for example, /opt/keysight/licensing/agileesofd).

b. Run the following command to start lmgrd:

./lmgrd -c <license file path> -l <license log file path>

where:

• <license file path> specifies one or more full path names to license file(s) and/or folder(s) containing license files.
• <license log file path> is the full path name to the debug log file.

Step 5: Configure the client machine(s)

6. Install the licensed software on the machine(s) where you will use it (the clients).
7. In PathWave License Manager, follow the on-screen instructions to Specify a Remote License Server, so that the product can get its license from the server machine.
8. Select View Licenses to see your new license.
9. Borrow the license.

 

Port Number Conflicts

All the Keysight agileesofd (vendor daemon) licenses on your system must use the same port. If license files have conflicting port numbers, or if some licenses have port numbers and others do not, you will experience licensing failures.

 

To check and correct the port numbers in your license files, do the following on the license server machine.

 

First find the files in your licensing directories:

Windows

dir C:\ProgramData\Keysight\Licensing\Licenses\Server

dir C:\ProgramData\Keysight\Licensing\Licenses\Other

Linux

ls -al /var/opt/keysight/licensing/licenses/server

ls -al /var/opt/keysight/licensing/licenses/other

macOS

ls -al /Library/Application

Support/Keysight/Licensing/Licenses/Other

 

Open or view each .lic file to determine whether they all specify the same port value (between 27000 and 27009, inclusive) in their SERVER statements.

The format of the SERVER statement is:

SERVER host hostid [port] [PRIMARY_IS_MASTER] [HEARTBEAT_INTERVAL=seconds]

For example, a license file with port 27009 might have the following SERVER statement:

SERVER my_server 17007ea8

With no port number specified, the file might look like this:

SERVER my_server 17007ea8

 

If your license files have different port numbers, or if not all your license files have port numbers, choose a single port number to use (between 27000 and 27009, inclusive). Then open each license file in your preferred text editor (notepad, gedit, etc.) and modify it to specify that port number. When you add a new license to a machine, if its port number does not match others already installed, the license installation may fail; or, when you attempt to restart the license server process, it may fail. Either at installation time or when you try to start the server process, you may see an error message explaining that the port numbers do not match. If this happens, edit the port numbers to match, as described above, then try again.

This is documented in the Keysight Licensing Administrator's Guide.