[INTERNAL USE ONLY] FlexNet Licensing: Steps to Activate Licenses to an Offline License Server
Anonym
DESCRIPTION:
This internal help article provides steps to complete an offline license server activation, where the license server machine resides on a network that does not have access to the internet. The instructions below include steps for both the end user and for Technical Support.
This licensing method requires a binary file import to the offline license server machine, as well as interaction with Harris Geospatial Technical Support.
An alternative to offline license server activation is offline node-locked (local) license activation, which currently, does not require interaction with technical support to get a binary license response file.
If the customer cannot use offline license server activation because of limited business hours to support the creation of the binary license response file, then a non-tech support-interaction alternative would be to use offline activation node-locked licensing. .
However, since node-locked license re-hosting of a limited number of license seats for many host machines in an offline environment may be impractical, it is conceivable that a workaround solution may require delivering activation codes supporting a total quantity of license seats that are equal to the number of possible computers that will need to use the licenses. In this case, please work with the customer's Harris sales account manager to determine an appropriate work-around license configuration.
Hopefully, in the near future, we will be able to provide customers with offline license server technology that does not require Technical Support to manually process the binary request file to generate a binary response file to delivery back to the customer.
|
SUMMARY:
This INTERNAL help article provides steps to be completed by a customer, as well as by Technical Support, 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 24 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.
IN ACTUALITY, THE BINARY FILE HAS AN EXPECTED LIFETIME OF 72 HOURS. WE CAN STILL MODIFY COMMUNICATION OF THIS DETAIL IN THESE ARTICLES IF SEEMS BENEFICIAL.
|
Below are detailed customer steps to activate licensing to an offline license server machine.
A
companion customer-facing internal help article to this Internal use only article is available for distribution to customers for whom this offline license server license activation approach is acceptable for their security and network situation:
DETAILS:
NOTES:
- These instructions assume that the FlexNet License Server product, downloaded by the customer through Harris Download and License Center web site, has been installed to the designated offline license server machine, with the license server service running and listening at TCP port 7070.
- Administrator or sudo/root privileges may be required to complete these instructions.
|
A. CUSTOMER OFFLINE SERVER STEPS
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-ObjectSystem.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. Open a Linux or a Windows command prompt to run the command:
hostname
This output should be copied for delivery to Harris Technical Support.
|
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 similar* information to above, as follows:
c. 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
---------------------------------------------------------
d. 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:
cd "C:\Program Files\Harris\ENVI54\IDL86\license_utils\bin.x86_64"
activate.exe -d
cd /usr/local/harris/envi54/idl86/license_utils/bin.linux.x86_64
sudo ./activate -d
The output will look similar to this:
{
"deviceID" : "12345678ABCDAEE23B12",
"deviceIDType" : "FLC_HOSTID_TYPE_STRING",
"machineName" : "myofflineserver"
}
* Tech Support: Please note that the "Device ID" information obtained from the Harris License Administrator utilty or from the "activate -d" command is not exactly the same as the Server ID information obtained in step #3a above. Only use the first 12 characters of the "Device ID" information to configure the offline license server Server ID information on the FNO web site, as discussed in step #7 below.
|
3. The customer should a copy of the Activation Code, Server ID, and Hostname information obtained from steps #1 and #2, to Harris Technical Support (or the customer's local distributor to deliver to Harris Technical Support).
B. TECHNICAL SUPPORT STEPS
4. After receiving the information from step #3 above, Harris Technical Support should then login to the manager interface of the FNO website:
https://manager.flexnetoperations.com
5. Harris Technical Support should first search for the target offline License Server device in the FNO manager interface. To do this select the menu item:
Manage Hosts > Search License Servers
It is recommended to use the License Server ID provided by the customer (step#3) to complete the Search (the Alias – i.e. hostname - is not always available for searching license server devices). If you find that the Server already exists in FNO, skip step #6, below.
6. If the Server ID is not found, Harris Technical Support will need to create a new Server device item.
a. Next, select the menu item, Manage Hosts > Add License Servers.
b. Enter/select the requested information to the Add Server form:
• License Server ID : Provided by the customer from section A step 2a, for example,"123456ABCDEF"
• Host ID Type : Provided by the customer from section A step 2a, for example"ETHERNET".
• Alias : The hostname of the license server machine, provided by the customer from section A step 2b, for example, "myserver".
• System Account ID : To get the System Account ID, search for the associated Entitlement (menu item Entitle Customers > Search Entitlements) using the provided Activation Code(s), for example, "90078827".
c. For the additional fields, select these specific values:
• Deployment : Local License Server
• Server Host Type : FLX_SERVER
• Identity : HarrisGeospatial_rsa1024
> The screen capture below illustrates how to configure the new Server device,
based on the example information discussed.
d. After adding the required information, click on the Add server button to create the Server device.
7. After finding (step 5) or creating (step 6) the Server device in FNO, go to the View Server page for this device, and then proceed to "map" the license entitlement "add-ons", by Activation Code(s) and Quantity, as provided by the customer, as follows:
a. Select the menu item Add-ons > Map Add-ons.
b. From the Map Add-ons page, search for the specific license Add-ons by Activation Code or Entitlement ID (Maintenance ID), as provided by the customer.
b. For each relevant Add-on enter the desired license quantity in the Qty Add field.
c. Click on the "Map add-ons" button.
d. Click on the Generate response button.
e. Select the menu item View > Download Response in order to download the resulting "response.bin" file. (There is a "24" hour useful lifetime after the response is generated.)
|
Deactivating a License
To DEACTIVATE a license use these alternative step for item #7:
After finding (step 5) or creating (step 6) the Server device in FNO, go to the View Server page for this device, and then proceed to "map" the license entitlement "add-ons", by Activation Code(s) and Quantity, as provided by the customer, as follows:
a. Select the menu item Add-ons > Remove Add-ons.
b. On the Remove Add-ons page, search for the license Add-ons by Activation Code as provided by the customer.
c. For each relevant Add-on enter the desired license quantity to remove in the Qty to Remove field.
d.Click on the "Map add-ons" button.
e.Click on the Generate response button.
f. Select the menu item View > Download Response in order to download the resulting "response.bin" file. (There is a "24"hour useful lifetime after the response is generated.)
|
8. The resulting response binary file should be delivered to the customer, who should then copy the file to the offline license server machine.
If needed, the binary file "response.bin" may be renamed, for example, "activate-aaaa-aaaa-aaaa-aaaa.bin" or "activate-mnt-xxxxxxx.bin" (or "deactivate-aaaa-aaaa-aaaa-aaaa.bin" for deactivation) before delivery to the customer.
C. CUSTOMER OFFLINE SERVER STEPS
10. The response.bin file contains the license activation rights for the offline license server. To process the response file on the license server, the customer should first open a command terminal window on the license server machine and CD to the directory:
<license_server_installation_path>/enterprise/
as discussed in step #1, and then issue a command with the following syntax
flexnetlsadmin -server http://<LicenseServer_IP_or_Hostname>:7070 -activate -load response.bin
where "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 response.bin
or on Linux:
sudo ./flexnetlsadmin.sh -server http://myserver:7070 -activate -load /home/joeuser/response.bin
11. 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
12. The customer can then connect client machines to the server using the same instructions for served licenses that have been activated online:
D. DEACTIVATE LICENSES FROM LICENSE SERVER
13. To deactivate licenses from the license server, for example, in order to allow activation of the same licenses to a different computer, follow the customer instructions above (Section A and Section C), except request a license "de-activation". Without this step, the licenses that are still activated to the license server will not be available to be used by other computers.
To rehost an offline license server license, both a license de-activation and license activation may be requested at the same time. In this case, two binary license response files will be returned to the customer. However, in order to comply with your Harris Geospatial product End-User License Agreement (EULA), you must follow the steps to deactivate your licenses from the former license server computer.
Reviewed by JU (2/1/2017)