[INTERNAL] How to "lock-in" the Server ID value for the License Server Service
TOPIC:
The Harris FlexNet License Server Service (supported on Windows and Linux only) uses the physical (MAC) address of the license server computer's network communication device (e.g., ethernet card) as the Server ID (sometimes known as a Host ID). If multiple network devices are configured on the computer, only one of the MAC addresses is automatically recognized as the Server ID.
Sometimes the license server service can recognize a different Server ID than was originally used to configure the served Harris product license activations, resulting in a failure to serve licenses to license clients.
If the automatically selected Server ID value seems to change, depending on the network configuration of the license server computer, causing the license server to lose access to licenses that were previously activated to the license server installation, it may be possible to "lock in" a specific, consistently available MAC address as the Server ID. Note that the selected MAC address should be for a network device that is also consistently configured to communicate with remote license clients computers.
This help article provides instructions for "locking in" a specific Server ID to try to solve this type of a changing Server ID issue.
|
Note that sometimes a changing Server ID / MAC address can be attributed to a user-configurable setting, such as an internal wired network interface device being set to automatically power on or off, depending on if that device is connected to a network. If something like this might be the case, it may be possible that setting that network interface device to always be on, even if it is not being used to connect to a network, may solve this type of changing Server ID problem -- without having to specify a non-default Server ID, using the instructions below.
Another example of a changing Server ID might be attributed to the use of a laptop docking station with its own built-in network card, which, when docked, the laptop will use docking station's network card rather than the laptop's built-in network card. In this case, again, it may be possible solve the problem just by setting the laptop's built-in network interface device to always be on.
|
DETAILS:
To lock-in a Server ID that will be used with the Harris FlexNet License Server Service on Windows or Linux, do the following:
|
Note: Administrative or root/sudo privileges are required to make changes described in this help article.
|
1) Verify that the selected Server ID is changing under different network environments.
To get the currently selected Server ID information, from the "enterprise" subdirectory of your Harris FlexNet License Server installation issue the appropriate commands for your platform. Examples for the default installation directory locations:
Windows
cd "C:\Program Files\Harris\flexnetls-x64_windows-2017.08.0\enterprise"
flexnetlsadmin.bat -server http://localhost:7070 -config -filter general | find "Binding"
Linux
cd /usr/local/harris/flexnetls_2017.08.0/enterprise
./flexnetlsadmin.sh -server http://localhost:7070 -config -filter general | grep Binding
Example of the resulting output:
(host_id) Binding ID : ETHERNET (ABCDEF123456)
1)
2) Repeat step #1 under different network environments to determine which of the available Server ID ("hostid") values is consistently present under circumstances where the default-selected Server ID changes.
1)
2)
3) Configure your license server to always use / lock-in the consistently available Server ID value.
WINDOWS
a) Deactivate the licenses from your license server.
b) Edit the file:
C:\Program Files\Harris\flexnetls-x64_windows-2016.03.0\server\flexnetls.settings
modifying the following section:
#Active hostid in <value>/<type> format,such as C001D9999/Ethernet. If not set will use default hostid
#ACTIVE_HOSTID=
where you should uncomment the"#ACTIVE_HOSTID=" line by removing the "#" character and then specify the non-default Server ID value number, for example:
#Active hostid in <value>/<type> format,such as C001D9999/Ethernet. If not set will use default hostid
ACTIVE_HOSTID=ABCDEF12345678/Ethernet
c) From a command prompt window, running as Administrator, change directories to the directory:
<FLEXNET-SERVER-DIR>\server
where you should replace <FLEXNET-SERVER-DIR> with the correct path for your installation, for example:
cd "C:\Program Files\Harris\flexnetls-x64_windows-2016.03.0\server"
d) Then at the command prompt issue the command:
flexnetls.bat -update
e) Then run the additional command:
flexnetls.bat -start
f) Wait to allow time for the license server service to fully reinitialize (maybe a minute or so).
g) Re-activate your licenses to the license server.
h) Check the status of the licenses on the license server.
1)
a)
LINUX
a) Deactivate the licenses from your license server.
b) Stop the license server service:
sudo service flexnetls-idl_lmgrd stop
c) Edit the following file:
/etc/default/flexnetls-idl_lmgrd
modifying the following section:
#Active hostid in <value>/<type> format,such as C001D9999/Ethernet. If not setwill use default hostid
#ACTIVE_HOSTID=
where you should uncomment the"#ACTIVE_HOSTID=" line by removing the "#" character and then specify the non-default Server ID value number, for example:
#Active hostid in <value>/<type> format,such as C001D9999/Ethernet. If not set will use default hostid
ACTIVE_HOSTID=ABCDEF12345678/Ethernet
d) Next, run the command:
sudo service flexnetls-idl_lmgrd start
e) Wait to allow time for the license server service to fully reinitialize (maybe a minute or so).
f) Re-activate your licenses to the license server.
g) Check the status of the licenses on the license server.
1)
a)
b)
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 Installation and Licensing Documentation
http://harrisgeospatial.com/docs/routines-169.html
Written by JU (1/25/2017), updated by CS (7/20/2020)