Friday, December 02, 2016
Install and Administer the Flexera License Server Service on Linux
These instructions describe how to install and configure the Flexera FlexNet license server for use with Harris Geospatial (Exelis VIS) products.
See the following:
System Requirements
Supported FlexNet License Server platforms:
Operating System
CPU Architecture
Tested with Operating System Versions
Linux
x86-64
CentOS 6.x and 7.x
Red Hat Enterprise Linux (RHEL) 6.x and 7.x
Ubuntu 16
Root or Sudo Privileges
You need root or sudo privileges to perform the steps in this document.
Firewall Configuration
By default, the license server is configured to communicate on local TCP/IP port 7070. If a firewall is deployed on the license server, it will be necessary to configure the firewall to allow external listening connections by the license server machine on TCP port 7070. If needed, consult your local system or network administrator for assistance in configuring your server's firewall.
Correct System Time and Date
To allow proper communication, the system time and date of both the license server and the license client computer should be configured to accurately reflect the current time and date.
Contact Us
If you need assistance, visit the Request Technical Support page at https://www.harrisgeospatial.com/Support.aspx.
Install the License Server Service
gunzip filename.tar.gz tar -xf filename.tar
Note: The License Server installer is a separate product download file. It is not included as part of other Harris Geospatial product downloads.
umount /dev/hdc mount -o ro -t udf /dev/hdc /media
Note: Be sure to specify the correct directory for your system, for example: /dev/dvd instead of /dev/hdc.
Administer License Server Licenses from the Harris License Administrator Tool
Activating a license transfers the license rights from the Harris Download and Licensing Center to a node-locked (local) computer or license server and creates the features and quantities of licenses that enable the software to run. When you purchase Harris Geospatial products, you will receive an email with an activation code to use to activate your software license. The license is a concurrent-process license for each product that was purchased.
These instructions describe how to use the Harris License Administrator tool to activate your licenses on a license server. The Harris License Administrator tool is available if you have a full version of IDL or ENVI installed on the license server. If the license server will not have IDL or ENVI installed on it, you can perform these same functions from the command line, described in Activate License Server Licenses from the Command Line. This document also intended for you to activate licenses over the Internet. If you do not have Internet access, contact Technical Support to receive separate instructions to activate your licenses offline.
You will use the activation codes provided in your product order email to activate the licenses. Clients will then create a connection to the license server to acquire those licenses when they launch their application. If a client attempts to launch the application before licenses are activated on the license server, or before the client has a connection to the license server, they will receive an error message.
The steps that follow describe how to use the Harris License Administrator tool to:
The Harris License Administrator Tool
The steps that follow use the Harris License Administrator tool. If the tool is not already open, access it from a terminal window by launching the harrislicense command from one of the following installation directories:
Sudo or root permissions are required.
Activate Licenses
To activate licenses on the license server:
Deactivate Licenses
Licenses remain activated on a license server until you deactivate them. Deactivating a license returns it to the Harris Download and Licensing Center. Deactivated licenses can then be used on another license server. For example, if you receive a new computer and you want to install the license server service on it, first deactivate the licenses from the old license server. If you do not deactivate the licenses (and the old computer is no longer accessible to you), you will be unable to activate them on the new license server. If that occurs, Technical Support will need to deactivate the licenses for you.
To deactivate licenses on the server:
Connect a Client to a License Server
A client computer can connect to only one license server at a time; however, a client can use a combination of node-locked licenses activated locally on the computer and served licenses from a connected license server.
To connect a client to a license server:
Disconnect from a License Server
To disconnect a client computer from a license server:
Borrow Licenses from a License Server
Client computers can optionally borrow licenses from a license server. Borrowing licenses activates them locally to the client computer, for a limited time. One example of borrowing is when you need to work in a remote region for one week and will be unable to connect to the license server to acquire licenses. In this case, you borrow the needed licenses for a week; then when the specified time has expired, the licenses will be automatically returned to the license server.
To borrow licenses from a license server:
Return Borrowed Licenses to a License Server
Borrowed licenses are automatically returned to the license server at the end of the specified period, but you can return all of the licenses earlier.
To return licenses on a server:
View Licenses and Feature Details
Click View Licenses in the Harris License Administrator tool to view license details and features for the license server. License names, activation codes, and maintenance IDs available to the license server will be listed in a table. To refresh the data in the table, click the refresh icon.
To view feature details for the licenses, select one or more table rows and enable the Show feature details check box. Select all table rows to show all licenses. To filter the details further to show only in-use features, enable the Show in-use only check box.
In the feature details Expiration column:
You can copy the details of all features to the clipboard, or save them to a .json file.
To view the license activity log for the computer, or to view device information for the computer, click View Log.
Activate License Server Licenses from the Command Line
The steps that follow describe how to:
These steps have you activate licenses over the Internet. If you do not have Internet access, contact Technical Support for separate instructions to activate your license offline.
You can also activate the licenses from the command line:
cd /usr/local/harris/flexnetls-x64_linux-xxxx.xx.x/enterprise
./flexnetlsadmin.sh -server http://server:port -activate -id xxxx-xxxx-xxxx-xxxx -count quantity
Example:
./flexnetlsadmin.sh -server http://localhost:7070 -activate -id AAAA-BBBB-CCCC-DDDD -count 3
Where:
To view details on the activated licenses for the license server, see View Licenses and Feature Details for commands.
Specifying a -count of 0 deactivates the specified licenses on the license server. For example:
./flexnetlsadmin.sh -server http://localhost:7070 -activate -id AAAA-BBBB-CCCC-DDDD -count 0
Create a plain text file on the client computer to reference the license server. Perform the following steps:
http://[license-server-hostname-or-IP-address]:7070/fne/bin/capability
For example:
http://myserver.mycompany.com:7070/fne/bin/capability
Examples using the default locations:
Windows: C:\Program Files\Harris\license\o_licenseserverurl.txt
Linux: /usr/local/harris/license/o_licenseserverurl.txt
Mac: /Applications/harris/license/o_licenseserverurl.txt
To view details on served licenses for the computer, see View Licenses and Feature Details for commands.
Remove a Client Connection to a License Server
To remove the client computer's connection to the license server, delete the o_licenseserverurl.txt from the license subdirectory located under your Harris installation directory.
The Activate Utility
For the steps in the next section, you will find the activate utility in the following directories:
Use the activate utility to borrow licenses from a license server for a period of time.
To borrow licenses, open a command or terminal window on the client, change to the directory that contains the activate utility, and type the following at the command line:
Windows:
activate.exe -a activation-code -s serverName:serverPort -t seconds
activate.exe -a AAAA-BBBB-CCCC-DDDD -s LicenseServer:7070 -t 86400
Linux and Mac:
./activate -a activation-code -s serverName:serverPort -t seconds
./activate -a AAAA-BBBB-CCCC-DDDD -s LicenseServer:7070 -t 86400
The following are also valid command-line arguments for borrowing with activate:
To view details on borrowed licenses for the computer, see View Licenses and Feature Details for commands.
Use the activate utility to return borrowed licenses before their expiration date.
To return borrowed licenses, open a command or terminal window, change to the directory that contains the activate utility, and type the following at the command line:
activate -r -s serverName:serverPort
activate -r -s LicenseServer:7070
./activate -r -s serverName:serverPort
./activate -r -s LicenseServer:7070
Additional License Server Administration Tasks from the Command Line
This section provides commands to administer and uninstall the license server service. See the following:
To view details on licensed features, open a terminal window and change directories to INSTALL_DIR/flexnetls-x64_linux-xxxx.xx.x/enterprise. From a command line, use the following commands:
./flexnetlsadmin.sh -server http://localhost:7070 -status
./flexnetlsadmin.sh -server http://localhost:7070 -features
./flexnetlsadmin.sh -server http://myserver.mycompany.com:7070 -licenses
./flexnetlsadmin.sh -server http://123.456.789.10:7070 -licenses -verbose
Manage the License Server Service
/sbin/service flexnetls-idl_lmgrd start
Upon success, this command returns a result that the service is starting.
/sbin/service flexnetls-idl_lmgrd stop
/sbin/service flexnetls-idl_lmgrd status
/var/opt/flexnetls/idl_lmgrd/logs/
Uninstall the License Server Service
cd /usr/local/harris/flexnetls_xxxx.xx.x/enterprise
./flexnetlsadmin.sh -server http://localhost:7070 -activate -id xxxx-xxxx-xxxx-xxxx -count 0
where in the example command:
cd /usr/local/harris/flexnetls_xxxx.xx.x/server ./flexnetls uninstall
rm -R /opt/flexnetls/idl_lmgrd
rm /etc/default/flexnetls-idl_lmgrd
rm -R /var/opt/flexnetls/idl_lmgrd
© 2017 Exelis Visual Information Solutions, Inc., a subsidiary of Harris Corporation. All Rights Reserved. This information is not subject to the controls of the International Traffic in Arms Regulations (ITAR) or the Export Administration Regulations (EAR). However, this information may be restricted from transfer to various embargoed countries under U.S. laws and regulations.
Number of views (688)/Comments (0)
more »
Sign Up for News & Updates: Stay informed with the latest news, events, technologies and special offers.