913

How to reserve license seats from a license server and for a given client machine

 

This document provides example steps to reserve served license features to a license client computer.

 

Notes:

  • The FlexNet license server allows you to RESERVE some or all served license features for a client computer.
  • License feature counts may only be reserved for one license client at a time and cannot be shared by multiple license clients.
  • Reserved licenses are effectively node-locked to a client computer.
  • License reservations are allowed beginning with IDL 8.6.1 and ENVI 5.4 SP1.
  • Consider alternatives to license reservations: License borrowing or node-lock license to client computer.

 

Sections:

1. List current reservations on the license server

2. Determine the license features that need to be reserved for your Harris Geospatial program session

3. Create Reservations JSON File

4. Load the Reservations JSON file to the license server

5. Show active reservations and reservation group IDs

6. List details of reservation

7. Start a Harris Geospatial program session on the client that has the license feature reservation

8. Delete the reservation on the client

 

1. List current reservations on the license server

 

Example (Linux):

 

> cd /usr/local/harris/flexnetls_2017.08/enterprise

> flexnetlsadmin.sh -server http://localhost:7070 -reservations

Total number of reservation entries : 0

 

Example (Windows Command Prompt):

 

> cd "C:\Program Files\Harris\flexnetls-x64_windows-2017.08.0\enterprise"

> flexnetlsadmin.bat -server http://localhost:7070 -reservations

 

2. Determine the license features that need to be reserved for your Harris Geospatial program session

 

On the license client computer that needs to have reserved licenses, do the following:

  1. Obtain the 20-character Device ID for the license client computer for which the licenses will be reserved.

 

You can obtain the 20-character Device ID for your license client computer by launching the Harris License Administrator tool and then viewing the View Log view of the GUI.

Alternatively, from a shell prompt, run the "activate" command line utility with the "-d" switch. For example:

Windows:

cd "C:\Program Files\Harris\ENVI56\IDL88\license_utils\bin.x86_64"

activate.exe -d

Linux:

cd /usr/local/harris/envi56/idl88/license_utils/bin.linux.x86_64

./activate -d

Mac OS X:

cd /Applications/harris/envi56/idl88/bin.darwin.x86_64

./activate -d

 

  1. Start a session of Harris Geospatial program that will be using the reserved licenses. To ensure that all of the required license features for the reservation will be taken into account, also be sure that program session accesses all of its needed functionality.

For example, if you need to reserve the licensing for ENVI with Feature Extraction and NITF module functionality then launch an ENVI session and from that session access that module functionality.

Or, for example, if you need to reserve licensing for IDL and Dataminer module functionality, you could start and IDL session and then from the IDL session, issue the command "db_exists()".

 

  1. While the program session from step (2b) is running: On the license server computer, from a command shell, issue the command to determine the license feature strings and quantities that will be needed for the license reservation.

For your command, use the actual path to your "flexnetlsadmin" utility and the 20-character Device ID obtained from step (2a) above (instead of "12345678901234567890", as used in the examples below).

 

Windows:

cd "C:\Program Files\Harris\flexnetls-x64_windows-2017.08.0\enterprise"

flexnetlsadmin.bat -server localhost:7070 -licenses -verbose | find "12345678901234567890"

Linux:

cd /usr/local/harris/flexnetls_2017.08/enterprise

./flexnetlsadmin.sh -server localhost:7070 -licenses -verbose | grep 12345678901234567890

 

The resulting output might look something like this, showing the license client session Device ID and license features (and quantities) currently in use by that license client:

12345678901234567890 sv-idl_dm(1) sv-idl(1)

 

3. Create Reservations JSON File

 

Next, using the Device ID (2a) and the license features that will be needed for the reservation (2c), create a Reservations JSON file (named for example, "reservation_test.json") with contents like the following.

Notes:

  • You must use the "sv-*" version of the license features. (The "nl-*" version of the license feature is not usable from a license server environment.)
  • The license feature and counts being reserved must be available, and must NOT already be in use by any license client, including the client that will be using the reservation. If the license features and quantities are not available at the time the reservation is requested on the license server, then the reservation will fail.

 

Example Reservations JSON File:

 

{ "name": "reserve_test", "reservations": [

{ "hostId": { "value": "12345678901234567890", "type": "STRING" },

"reservationEntries": [

{ "featureName": "sv-idl", "featureVersion": "8.8", "featureCount": 1 },

{ "featureName": "sv-idl_dm", "featureVersion": "8.8", "featureCount": 1 } ] }

] }

General syntax:

 

Be sure to replace the items included in the "<<>>" with your actual values when using the following lines as a template for your license server reservations template.

{ "name" : "<<RESERVATION-GROUP-NAME>>", "reservations" : [

{ "hostId": { "value" : "<<20-CHAR-DEVICE-ID-A>>", "type" : "STRING" },

"reservationEntries": [

{ "featureName": "<<LIC-FEATURE-STRING>>", "featureVersion": "<<LIC-FEATURE-VERSION>>","featureCount": <<COUNT>> },

{ "featureName": "<<LIC-FEATURE-STRING>>", "featureVersion": "<<LIC-FEATURE-VERSION>>","featureCount": <<COUNT>> }

]

},

{ "hostId": { "value" : "<<20-CHAR-DEVICE-ID-B>>", "type" : "STRING" },

"reservationEntries": [

{ "featureName": "<<LIC-FEATURE-STRING>>", "featureVersion": "<<LIC-FEATURE-VERSION>>","featureCount": <<COUNT>> }

]

}

] }

 

4. Load the Reservations JSON file to the license server

 

NOTE: The license feature and counts being reserved must be available, and must NOT already be in use by any license client, including the client that will be using the reservation. If the license features and quantities are not available at the time the reservation is requested on the license server, then the reservation will fail.

 

Example (Linux):

 

> cd /usr/local/harris/flexnetls_2017.08/enterprise

> flexnetlsadmin.sh -server http://localhost:7070 -reservations -load reservation_test.json

SUCCESS Reservation added successfully

 

Example (Windows Command Prompt):

 

> cd "C:\Program Files\Harris\flexnetls-x64_windows-2017.08.0\enterprise"

> flexnetlsadmin.bat -server http://localhost:7070 -reservations -load reservation_test.json

 

5. Show active reservations and reservation group IDs

 

Example (Linux):

 

> cd /usr/local/harris/flexnetls_2017.08/enterprise

> ./flexnetlsadmin.sh -server http://localhost:7070 -reservations

Total number of reservation entries : 1

28 reserve_test

 

Example (Windows Command Prompt):

 

> cd "C:\Program Files\Harris\flexnetls-x64_windows-2017.08.0\enterprise"

> flexnetlsadmin.bat -server http://localhost:7070 -reservations

 

6. List details of reservation

 

Using the example group ID #28 that was obtained in the previous section, list the details of the reservation group.

 

Example (Linux):

 

> cd /usr/local/harris/flexnetls_2017.08/enterprise

> flexnetlsadmin.sh -server http://localhost:7070 -reservations -group 28

Reservation ID,Name,Type:35,005057A614F8AEE23B12,STRING

Resrv Entry ID Feature Name Version Count State

-------------------------------------------------------------

 

63 sv-idl_rt 8.8 1 ENABLED

64 sv-idl 8.8 1 ENABLED

 

Example (Windows Command Prompt):

 

> cd "C:\Program Files\Harris\flexnetls-x64_windows-2017.08.0\enterprise"

> flexnetlsadmin.bat -server http://localhost:7070 -reservations -group 28

 

7. Start a Harris Geospatial program session on the client that has the license feature reservation

 

No other license client will be able to access the reserved license feature / license count.

 

8. Delete the reservation on the client

 

Delete reservation with example Group ID #28.

 

Example (Linux):

 

> cd /usr/local/harris/flexnetls_2017.08/enterprise

> ./flexnetlsadmin.sh -server http://localhost:7070 -reservations -delete -group 28

 

Example (Windows Command Prompt):

 

> cd "C:\Program Files\Harris\flexnetls-x64_windows-2017.08.0\enterprise"

> flexnetlsadmin.bat -server http://localhost:7070 -reservations -delete -group 28

 

 

-----------------

created & reviewed by CS/JU on 8/3/2020

Please login or register to post comments.