233 Rate this article:
No rating

How to Configure the Harris FlexNet License Server to Activate Licenses through an HTTP Proxy Server

Summary

Activation of Harris Geospatial product licenses to the Harris FlexNet License Server requires internet communication with:

   
https://harrisgeospatial.flexnetoperations.com

If your license server service is installed on a computer that requires internet communications to be explicitly redirected to an HTTP networking proxy server, then the license server will need to be specially configured to allow for the activation of your licenses.

This article discusses how to configure the Harris FlexNet license server in a way that can enable license activations to occur through an HTTP proxy server. Note that the FlexNet license server depends on Java Runtime to provide networking services.

Description

To configure the FlexNet license server to be able to activate its licenses through a networking proxy server you'll need to define proxy parameters in the server’s local settings (plain text) file on the license server machine.  Below are the steps to do this.  Windows Administrator or Linux root/sudo privileges will be required to make the described changes.

1.) Ensure that the FlexNet license server service is stopped.

  • On Windows, open the Windows Services utility (from Start button search field search for "services" and open the "Services" program).  In the Services utility, locate the service named
FlexNet License Server - idl_lmgrd

Stop the service if it is currently Started.
  • On Linux, from a command shell, as root or with sudo privileges, issue the command to stop the license service, for example:
sudo /sbin/service flexnetls-idl_lmgrd stop

2.) Next, locate the license server's local settings file.

  • On Windows the local settings file is located under the FlexNet license server installation at FLEXNET-SERVER-DIR\server\flexnetls.settings (where FLEXNET-SERVER-DIR is your actual FlexNet license server installation directory path), for example:
C:\Program Files\Harris\flexnetls-x64_windows-2016.03.0\server\flexnetls.settings

  • On Linux the server's local settings file is located at:

/etc/default/flexnetls-idl_lmgrd

3.) Edit the server's local settings file using a plain text editor.

a.) To define the proxy parameters in the license server's local settings file, you'll first need to uncomment the EXTRA_SYSPROPERTIES line in the file by removing the "#" character at the beginning of the line.

b.) Next, specify on the EXTRA_SYSPROPERTIES line the proxy parameters needed for license server communication through your networking proxy server. 

The following proxy parameters are supported (note that these parameter strings are case-sensitive, even on Windows):

• http.proxyHost

• http.proxyPort

• http.proxyUser

• http.proxyPassword

where:

• http.proxyHost defines the hostname or IP address of your proxy server.

• http.proxyPort defines your HTTP proxy server's communication port number. If not specified, the default port, 80, is used.

If your proxy server requires authentication with a username and password, you'll need to use the http.proxyUser and http.proxyPassword parameters. Otherwise these parameters should be omitted.

These parameters are passed to the Java Runtime system to identify the HTTP proxy.

Each of the proxy parameters should be specified on the EXTRA_SYSPROPERTIES line with the following syntax:

-Dproperty=  value

where each of the parameters is separated by a space and the entire set of parameters must be enclosed in double quote characters (even if only a single proxy parameter is specified on the EXTRA_SYSPROPERTIES line).  For example, on a single line:

EXTRA_SYSPROPERTIES="-Dhttp.proxyHost=10.11.12.13 -Dhttp.proxyPort=1234 -Dhttp.proxyUser=123mypw456 -Dhttp.proxyPassword=user1apwd35"

 

Proxy Authentication: Obfuscating a Password

If user authentication is required when communicating with your network proxy server, it is recommended that you use an obfuscated form of your proxy password specified by the http.proxyPassword parameter.

To generate an obfuscated version of your proxy password, call commands like the following from a command shell, after changing directories to the  "server" subdirectory of your FLEXNET-SERVER-DIR directory.

java -jar flexnetls.jar --password=PASSWORD-STRING

(Note that this command utilizes JRE's default string obfuscation capabilities.)

For example,  on Windows: 

> cd "C:\Program Files\Harris\flexnetls-x64_windows-2016.03.0\server"

> java -jar flexnetls.jar --password=123mypw456

123mypw456 => OBF:1234567890123456789012345678901234567890

On Linux: 

$ cd /usr/local/harris/flexnetls_2016.03.0/server

$ java -jar flexnetls.jar --password=123mypw456

123mypw456 => OBF:1234567890123456789012345678901234567890

Note that you must use the entire obfuscated string result, including the OBF: prefix, to define the http.proxyPassword value, for example:

-Dhttp.proxyPassword=OBF:1234567890123456789012345678901234567890

 

4.) Restart the license server service.

·         On Windows, open the Windows Services utility (from Start button search field search for "services" and open the "Services" program).  In the Services utility, locate the service named:

        FlexNet License Server - idl_lmgrd

and then start the service again.

·         On Linux, from a command shell, as root or with sudo privileges, issue the command to stop the license service, for example:

sudo /sbin/service flexnetls-idl_lmgrd start

5.) After restarting the license service, activate your licenses to the license server, per instructions in the Harris Products Install and Administer the Flexera License Server Service guide:

  • Install and Administer the Flexera License Server Service on Windows
http://www.harrisgeospatial.com/Support/SelfHelpTools/HelpArticles/HelpArticles-Detail/TabId/2718/ArtMID/10220/ArticleID/15154/Install-and-Administer-the-ENVI-54-and-IDL-86-Flexera-License-Server-on-Windows.aspx
  • Install and Administer the Flexera License Server Service on Linux
http://www.harrisgeospatial.com/Support/SelfHelpTools/HelpArticles/HelpArticles-Detail/TabId/2718/ArtMID/10220/ArticleID/15153/Install-and-Administer-the-ENVI-54-and-IDL-86-Flexera-License-Server-on-Linux.aspx

Related Articles 

  • Harris Product FlexNet Licensing: How to View Licenses and Feature Details
http://www.harrisgeospatial.com/Support/SelfHelpTools/HelpArticles/HelpArticles-Detail/TabId/2718/ArtMID/10220/ArticleID/15104/Harris-Product-FlexNet-Licensing-How-to-View-Licenses-and-Feature-Details.aspx
  • Harris Product FlexNet Licensing: How to Connect a Client to a License Server
http://www.harrisgeospatial.com/Support/SelfHelpTools/HelpArticles/HelpArticles-Detail/TabId/2718/ArtMID/10220/ArticleID/15117/%E2%80%8BHarris-Product-FlexNet-Licensing-How-to-Connect-a-Client-to-a-License-Server.aspx


 

Written by JU (28-feb-2017)

Please login or register to post comments.