[VERSION FOR CUSTOMERS] FlexNet Licensing: Steps to Activate Licenses to an Offline License Server
Anonym
Note: Do not set external - Send attached PDF or COPY/PASTE text for customers
==========================================================================
Download a PDF version of the document to send to a customer.
==========================================================================
Or copy/paste the information below to provide to customers.
Harris Geospatial Technical Support Help Article Title:
FlexNet Licensing: Steps to Activate Licenses to an Offline License Server
Last updated: March 29, 2017
© 2017 Exelis Visual Information Solutions, Inc., a subsidiary of Harris Corporation
This help article provides steps to be completed by a customer to do offline license server activation, in cases where the license server machine resides on a network that does not have access to the internet.
| Note: The following instructions assume that the Harris FlexNet License Server product (obtained as a separate installer file from the Harris Download and License Center) has been downloaded and installed to the offline license server machine. (The Harris FlexNet License Server is only supported on Windows and Linux. See the license server documentation for platform request.) |
| Note: The Harris License Administrator GUI tool is currently available through an IDL 8.6 or ENVI 5.4 (or later) product installation. At this time, the Harris License Administrator tool is not provided with the separately downloaded and installed Harris FlexNet License Server product. |
In summary, after installing the FlexNet License Server service for Harris products (obtained from the Harris Download and License Center) to the designated offline license server machine, the customer will need to do the following:
a.) Determine which of your license Activation Codes and license quantities that will be used on the license server.
b.) Collect the Server ID and hostname information for the offline license server machine
c.) Deliver the activation code and license server machine information to Harris Technical Support or a local distributor.
d.) In return, the customer will receive a binary license response file. The binary response file should be transferred to the offline license server computer.
e.) Finally, the binary license response file should be processed on the license server to activate the licenses.
| Note: The binary response license file has a 72 hour lifetime during which it must be processed on the offline license server. If this time limit is exceeded, the file will no longer be useful to license the offline license server. In this case, a new binary license response file must be requested and obtained in order to successfully license the offline license server computer. |
Below are detailed customer steps to activate licensing to an offline license server machine.
DETAILS:
1. Determine which of your Harris Geospatial product license activation codes and quantities will be used to license your offline license server machine.
| Note: Designated license administrator will have received their Harris product license activation codes by email (subject line includes Maintenance ID / Harris Download and License Center) from harrisgeospatial@flexnetoperations.com. |
2. Obtain the Server ID and hostname information from the offline license server computer:
a. Server ID
There are several ways to obtain the Server ID information from the offline license server machine:
• Open a web browser and enter the following URL:
http://localhost:7070/api/1.0/hostids/selected
• Or from a Windows Power Shell, issue the following 2 commands:
$serverid = (New-Object System.Net.WebClient).DownloadString( "http://localhost:7070/api/1.0/hostids/selected" )
echo $serverid
• Or from a Linux command prompt issue the following "curl" command:
curl -X GET --url http://localhost:7070/api/1.0/hostids/selected
Here is an example of the resulting output:
{
"type" : "ETHERNET",
"value" : "12345678ABCD"
}
This information should be copied for delivery to Harris Technical Support.
b. Hostname
For the server hostname, open a Linux or a Windows command prompt to run the command:
hostname
This output from this command should be copied for delivery to Harris Technical Support.
| If you have also installed IDL 8.6 or ENVI 5.4 on the offline license server machine, you may also use the "activate" command line utility or the Harris License Administrator GUI tool to quickly get the Server ID and hostname information. To do this, see the Appendix section at the bottom of this help article. |
3. The customer should provide the Activation Codes and quantities (step #1), as well as the Server ID and hostname information (step #2) for the offline license server, to Harris Technical Support or your local distributor. After the information has been processed, an offline binary license response file ("response.bin") will be returned to the customer.
4. After receiving the offline binary license response file, the customer should transfer it the to the offline license server machine.
| Note: The offline binary license response file has a usable lifetime of 72 hours, during which the file must be used on the offline license server machine to activate the licenses. |
5. The "response.bin" file contains the license activation rights for the offline license server. To process the response file on the offline license server computer, the customer should first open a command terminal window on the license server machine and CD to the following directory:
<license_server_installation_path>/enterprise/
cd C:\Program Files\Harris\flexnetls-x64_windows-2016.03.0\enterprise
cd /usr/local/harris/flexnetls_2016.03.0/enterprise
6. Next, from the command window issue a command with the following syntax:
flexnetlsadmin -server http://<LicenseServer_IP_or_Hostname>:7070 -activate -load [path]response.bin
where "[path]response.bin" is the file name or filepath name of the binary response license file. For example, on Windows:
flexnetlsadmin.bat -server http://10.11.12.13:7070 -activate -load "C:\Users\joeuser\response.bin"
or on Linux:
sudo ./flexnetlsadmin.sh -server http://myserver:7070 -activate -load /home/joeuser/response.bin
7. Once the licensing has been activated to the license server, the customer can check the status of the activated license features on the license server with a command like the following (Windows):
flexnetlsadmin.bat -server http://10.11.12.13:7070 -features
or on Linux:
./flexnetlsadmin.sh -server http://10.11.12.13:7070 -features
----------------------------
Connecting License Client Computers to the License Server
After activating licensing to the offline license server, the customer can then connect license client computers (in the offline network) to the license server using the instructions provided in the Harris product Activate Licenses Online or the Install and Administer the Flexera License Server Service guide documents, available for downloaded from the Harris Download and License Center. See the sections titled "Connect a Client to a License Server" for details.
The contents of these guides can also be found on the Harris Geospatial Documentation Center at:
An article summarizing these steps can be found in the following help article:
| Note: The Harris License Administrator GUI tool is currently available through an IDL 8.6 or ENVI 5.4 (or later) product installation. At this time, the Harris License Administrator tool is not provided with the separately downloaded and installed Harris FlexNet License Server product. |
----------------------------
Deactivating Licenses from an Offline License Server
To deactivate license from an offline license server, in order to allow activation of the same license activation codes to a different computer, follow the instructions in steps #1 through #7 above, except for step #3, you should ask for
deactivation of the supplied activation codes.
After receiving the resulting offline binary license response file from Harris Technical Support or your local distributor, transfer the response file to the offline license server computer.
Finally, process the deactivation binary response file on the license server to comply with your Harris Geospatial product End User License Agreement. After deactivating the licenses, the licenses will be available for activation to another computer.
APPENDIX:
Accessing the Server ID and Hostname for an offline license server using the "activate" command line utilty or the Harris License Administrator
| Note: Although the "Device ID" information is not exactly the same as the "Server ID" information obtained from step #3 above, it is sufficient for the purposes of requesting an offline license server license activation binary file. |
Alternatively, if the customer has also separately installed the IDL 8.6 or ENVI 5.4 product to the offline license server machine, the customer may access the needed information as described in step #3 above, as follows:
a. Launch the Harris License Administrator GUI utility, click on the View Log button and copy the device information provided at the top of the displayed log window, for example:
Harris License Administrator
IDL 8.6.0, Nov 21 2016 (325531) (Win32 x86_64)
Tue Jan 03 14:18:31 2017
Computer name: myofflineserver
Device ID: 12345678ABCDAEE23B12
License Directory: C:\Program Files\Harris
b. Or from a Linux or Windows command prompt, change directories to use the "activate" command line tool, located in the [IDL-Directory]\license_utils\bin.x86_64 directory for a Windows installation, or the [IDL-Directory]/license_utils/bin.[platform].x86_64 directory for a Linux or Mac installation. To obtain the offline license server information in this way, issue commands like the following:
Windows (2 commands)
cd "C:\Program Files\Harris\ENVI54\IDL86\license_utils\bin.x86_64"
cd /usr/local/harris/envi54/idl86/license_utils/bin.linux.x86_64
The output will look similar to this:
{
"deviceID" : "12345678ABCDAEE23B12",
"deviceIDType" : "FLC_HOSTID_TYPE_STRING",
"machineName" : "myofflineserver"
}
Reviewed by JU (2/1/2017)