Welcome to the Harris Geospatial product documentation center. Here you will find reference guides, help documents, and product libraries.


Harris Geospatial / Docs Center / Licensing / Manage Licenses Online

Manage Licenses Online

Manage Licenses Online

Activating a license transfers the license rights from the Harris Download and Licensing Center to a node-locked (local) computer or license server. It also 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.

You can activate licenses on a local computer (node-locked license), or on a license server that can serve licenses to connected clients. These instructions describe how to activate node-locked licenses. To install and set up a license server, see the Install and Administer the Flexera License Server Service documentation for Windows or Linux that is included with the software download and on the installation DVD.

In this document, you will activate licenses over the Internet. If you do not have Internet access, contact Technical Support to receive separate instructions to activate your licenses offline.

The steps that follow describe how to use the Harris License Administrator tool to:

  • Activate node-locked licenses.
  • Deactivate node-locked licenses.
  • Connect to a license server to use served licenses.
  • Disconnect from a license server.
  • Borrow licenses from a license server for a limited time.
  • Return borrowed licenses to the license server.
  • View licenses and feature details.

To perform these same functions from the command line instead of the Harris License Administrator tool, see Activate Licenses from the Command Line for details.

The Harris License Administrator Tool


To open the Harris License Administrator tool described in this section, use one of the following:

  • Windows: From the Start menu, select Tools > Harris License Administrator under the shortcut group for your product installation. Administrator privileges are required.
  • Linux: From a terminal window, launch the harrislicense command from the INSTALL_DIR/idlxx/bin directory for IDL installations, or from the INSTALL_DIR/envixx/idlxx/bin directory for ENVI installations. Sudo or root permissions are required.
  • Mac: From a Finder window, double-click the LicenseAdminstrator.app icon located under the INSTALL_DIR/idlxx/bin directory for IDL installations, or the INSTALL_DIR/envixx/idlxx/bin directory for ENVI installations. Administrator privileges are required.

Activate Licenses


To activate licenses:

  1. In the Harris License Administrator tool, click Activate Licenses.
  2. Enter (or copy and paste) the activation codes from your product order email into the text box provided. The text box allows one activation code per line; press the Enter key after entering each code to start a new line.
  3. Enter the Quantity of licenses you are entitled to.
  4. Click Activate. A message appears when the codes are successfully activated. To view details on the activated licenses for the computer, click View Licenses. See View Licenses and Feature Details for more information.
  5. Click Close to exit the tool.

Deactivate Licenses


Licenses remain activated on a computer until you deactivate them. Deactivating a license returns it to the Harris Download and Licensing Center. Deactivated licenses can then be used on another computer, by either the same person or another person. For example, if you receive a new computer and you want to install the software on it, first deactivate the licenses from the old computer. 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 computer. If that occurs, Technical Support will need to deactivate the licenses for you.

To deactivate licenses:

  1. In the Harris License Administrator tool, click Deactivate Licenses.
  2. Use the check boxes to select the individual activation codes to deactivate, or enable the Select all check box to deactivate all activation codes.
  3. Click Deactivate.
  4. Click Close to exit the tool.

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:

  1. On the client, open the Harris License Administrator tool.
  2. In the Harris License Administrator tool, click Use License Server.
  3. In the Server field, enter the server name or IP address.
  4. In the Port field, enter the TCP/IP port number being used by the license server for communication with license clients. The default port is 7070.
  5. Click Connect. A message appears when the client successfully connects. To view details on served licenses for the computer, click View Licenses. See View Licenses and Feature Details for more information.
  6. Click Close to exit the tool.

Disconnect from a License Server


To disconnect a client computer from a license server:

  1. In the Harris License Administrator tool, click Use License Server. The Server and Port number fields populate with the information for the connected license server.
  2. Click Disconnect, then click Yes to confirm the request to disconnect. A message appears when the client successfully disconnects.
  3. Click Close to exit the tool.

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 7 days; then when the specified time has expired, the licenses will be automatically returned to the license server.

To borrow licenses from a license server:

  1. In the Harris License Administrator tool, click Borrow Licenses from a Server.
  2. The Server and Port fields populate with values if there is a current license server connection. Enter or change the values if needed.
  3. Use the check boxes to select the licenses to borrow, or enable the Select all check box to select all licenses.
  4. Enter the Borrow time in days. The default is 7. The maximum number of days allowed is 60.
  5. Enter the Quantity of licenses to activate. The default is 1.
  6. Click Borrow from Server. A message appears when the licenses are successfully borrowed. To view details on borrowed licenses for the computer, click View Licenses. See View Licenses and Feature Details for more information.
  7. Click Close to exit the tool.

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:

  1. In the Harris License Administrator tool, click Borrow Licenses from a Server.
  2. The Server and Port fields populate with values if there is a current license server connection. Enter or change the values if needed.
  3. Click Return all Licenses to Server. All borrowed licenses are returned to the server.
  4. Click Close to exit the tool.

View Licenses and Feature Details


Click View Licenses in the Harris License Administrator tool to view license details and features for the computer. The license names, activation codes, and maintenance IDs available to the computer will be listed in a table. Licenses that are available from a license server will be marked with an asterisk (*) next to the Name column. 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:

  • The expiration date is listed for licenses that have a termination date.
  • For licenses borrowed from a license server, the expiration date is listed as a maximum of seven days from the date you are viewing the details.
  • Permanent indicates the license does not have a termination date.

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.

The steps that follow describe how to:

  • Activate node-locked licenses using commands.
  • Deactivate node-locked licenses using commands.
  • Manually create a file to connect a client to a license server.
  • Remove a client connection to a license server.
  • Borrow licenses from a license server for a limited time using commands.
  • Return borrowed licenses to a license server using commands.

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.

The Activate Utility


For steps in the next sections that refer to using the activate utility, the utility is located in the following directories:

  • Windows: INSTALL_DIR\IDLxx\license_utils\bin.x86_64 for IDL installations, or INSTALL_DIR\ENVIxx\IDLxx\license_utils\bin.x86_64 for ENVI installations.
  • Linux: INSTALL_DIR/idlxx/license_utils/bin.x86_64 for IDL installations, or INSTALL_DIR/envixx/idlxx/license_utils/bin.x86_64 for ENVI installations.
  • Mac: INSTALL_DIR/idlxx/license_utils/bin.x86_64 for IDL installations, or INSTALL_DIR/envixx/idlxx/license_utils/bin.x86_64 for ENVI installations.

Activate Licenses


To activate node-locked licenses, open a command or terminal window, change to the directory that contains the activate utility, and type the following at the command line:

Windows:

activate.exe -a activation-code [-q quantity]

Example:

  activate.exe -a AAAA-BBBB-CCCC-DDDD -q 1

Linux and Mac:

./activate -a activation-code [-q quantity]

Example:

  ./activate -a AAAA-BBBB-CCCC-DDDD -q 1

Where:

  • -a specifies the activation ID.
  • -q specifies the quantity of licenses. The default is 1.

To view details on activated licenses for the computer, see View Licenses and Feature Details for commands.

Deactivate Licenses


Licenses remain activated on a computer until you deactivate them. Deactivating a license returns it to the Harris Download and Licensing Center. Deactivated licenses can then be used on another computer, by either the same person or another person. For example, if you receive a new computer and you want to install the software on it, first deactivate the licenses from the old computer. 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 computer. If that occurs, Technical Support will need to deactivate the licenses for you.

To deactivate licenses, change to the directory that contains the activate utility, and type the following at the command line:

Windows:

activate.exe -a activation-code [-q quantity]        

Example:

  activate.exe -a AAAA-BBBB-CCCC-DDDD -q 0        

Linux and Mac:

./activate -a activation-code [-q quantity]        

Example:

  ./activate -a AAAA-BBBB-CCCC-DDDD -q 0        

If you originally activated a quantity greater than 1, you can reduce the quantity to a specified number without deactivating all licenses. For example:

Windows:

  activate.exe -a AAAA-BBBB-CCCC-DDDD -q 1        

Linux:

  ./activate -a AAAA-BBBB-CCCC-DDDD -q 1        

Connect a Client to the License Server


Create a plain text file on the client computer to reference the license server. Perform the following steps:

  1. Create a plain text file that contains a reference to the license server URL. Format the text as follows:

    http://[license-server-hostname-or-IP-address]:7070/fne/bin/capability

    For example:

    http://myserver.mycompany.com:7070/fne/bin/capability
  2. Save the file with the name o_licenseserverurl.txt.
  3. Copy the file to the license subdirectory located under your Harris installation directory. The file should have read privileges for all product users.

    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.

Borrow Licenses from a License Server


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

Example:

  activate.exe -a AAAA-BBBB-CCCC-DDDD -s LicenseServer:7070 -t 86400

Linux and Mac:

./activate -a activation-code -s serverName:serverPort -t seconds

Example:

  ./activate -a AAAA-BBBB-CCCC-DDDD -s LicenseServer:7070 -t 86400

Where:

  • -a specifies the activation ID.
  • -s specifies a license server.
  • -t specifies the borrow interval, in seconds. The default is 86400 seconds (one day). The maximum number of days allowed is 60 (5184000 seconds). When this value expires, the features are automatically returned to the license server for use by another process.

The following are also valid command-line arguments for borrowing with activate:

  • -b specify the name of a buffered license file, to display the features it contains.
  • -c use this option with -b, to display the C source code for a buffer license.
  • -g groups features by their license source (i.e., License Portal and borrowed from a license server).

To view details on borrowed licenses for the computer, see View Licenses and Feature Details for commands.

Return Borrowed Licenses to a License Server


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:

Windows:

activate -r -s serverName:serverPort

Example:

  activate -r -s LicenseServer:7070

Linux and Mac:

./activate -r -s serverName:serverPort

Example:

  ./activate -r -s LicenseServer:7070

Where:

  • -r returns all borrowed licenses to a license server.
  • -s specifies a license server.



© 2017 Exelis Visual Information Solutions, Inc. |  Legal
My Account    |    Buy    |    Contact Us