Network License Troubleshooting

 
 
     
 
 
  
 
 

Updating the server to SentinelLM 7.2:

First, upgrading the server software to the latest version may solve the problem, please to the following:

1. Download Sentinel License Manager Software 7.2 sentlm72.zip

2. Uninstall the previous version of SentinelLM from the Windows Services using loadls.exe

The installations of Hypercube, Inc.'s products may have installed SentinelLM to any of the following locations:

C:\HyperChem_Server

C:\Hyper7_Server

C:\Hyper6_Server

C:\SentinelLM_Server

C:\Program Files\Rainbow Technologies\SentLM

To remove the SentinelLM service from the Windows (NT, 2000 or XP) services list, use the server\loadls.exe command and select Remove from the options.

3. Save the \server\winnt\lservrc file. This file contains a stored copy of the the current license.

4. Unzip the sentlm72.zip file and either replace the previous files with the files contained in the zip file or use a new location, such as C:\HyperChem_Server.
The locking code should not change as a result of this update, but please check the locking code after the update using the echoid.exe program.

5. Move the lservrc file into the C:\HyperChem_Server\server\winnt\ folder.

6. Restart the SentinelLM service by executing C:\HyperChem_Server\server\winnt\loadls.exe and selecting 'Add.'

7. Check the license is correctly installed by executing C:\HyperChem_Server\admin\wlmadmin.exe or C:\HyperChem_Server\admin\lsmon.exe.

If you need to reinstall the license, execute 'lslic -F licensefile.lic' from the Command Prompt and test it using the wlmadmin.exe utility, lsmon.exe or HyperChem itself.

Finding if SentinelLM is installed using lswhere

The lswhere command can be used to verify that the license server is running. The utility will scan the network and report computers running the SentinelLM server software.

Usage and sample output:

C:\HyperChem_Server\admin>lswhere

SentinelLM 7.0.0 Search Tool For License Servers
Copyright (C) 1999 Rainbow Technologies, Inc.

Server Address: 192.168.20.214
Server Name: sentlmserver.domain.com

Explanation of the Heartbeat

The HyperChem clients refresh the license with the license server at every specified interval. This means that the HyperChem client and the server must have a reliable TCP/IP connection at all times. The interval (heartbeat) is set in the license and is usually five minutes. This is significant for two reasons:

1. The shorter the interval, the more network traffic will be used. For networks with many HyperChem users, network traffic may be noticeable if the connection speed is slow.

2. Only when a license is not refreshed by a HyperChem client, will the license server allow another computer to use the license. For example, when all the licenses are used by HyperChem clients and one user closes HyperChem, the license server may take as long as the heartbeat interval to regain the license and allow another client to run.

The default heartbeat is 5 minutes.

License Servers with Multiple Network Cards

The SentinelLM software does not support a license server with more than one network interface card (NIC). The license installation may fail, or the license communication mechanism may fail subsequently. Also, the license server must have a permanent IP address. Please use a computer with a single network card and a permanent IP address.

License Servers with Dynamic IP Addresses

The SentinelLM software should not be installed on a computer with a dynamic IP address. This is because the locking code will change every time the IP address is changed, potentially resulting in significant downtime. Please ensure that the SentinelLM server software is only installed on a computer with a permanent IP address.

lslic - "Failed to add License..." Error

Cause:

If the problem you are having is that you cannot install the license correctly, that is, you are receiving the 'Failed to add license...' error, there are, in total, five reasons why this could happen:

1. Host unknown.

Resolution:

If the error ends with '... on host 'unknown' then the lslic utility does not know where to install the license. Setting the environment variable LSHOST to 'localhost' will solve this problem. When installing the license, execute the following two commands from the Command Prompt:

C:\HyperChem_Server\admin>set LSHOST=localhost

C:\HyperChem_Server\admin>lslic -F licensefile.lic

2. License Corrupted.

The license contains encoded information which the license server uses to authenticate the HyperChem clients. If the encoded file becomes corrupted or contains incorrect information, the clients will not receive a license. The lsdecode utility from the \HyperChem_Server\admin folder may be used to decode the license and verify the information.

Usage of lsdecode:

C:\HyperChem_Server\admin>lsdecode -s licensefile.lic

Sample Output:

SentinelLM 7.0.0 License Decoding Utility
Copyright (C) 1999 Rainbow Technologies, Inc.

Reading license codes from file: "licensefile.lic"

License Type : Normal Network
Feature Name : "HC75-Network" Feature Version : "7.5"

Max concurrent users : 5
Soft limit on users : Unlimited.
License start date : Morning of Jan 1, 2000
Expiration date : License has no expiration.
Server lock code : Primary = "843DE"
Lock code depends on : IP Address
: Disk ID
: Host name
: Ethernet Address
Valid on subnet(s) : 192.168.20.* and 192.168.21.*
Additive/exclusive : Exclusive license (overrides additive licenses).
Held licenses : Allowed, hold time set by application.
Key lifetime (heartbeat) : 300 secs (5 min(s))
Action on clock tamper : No action.
Vendor Info : "Hypercube,Inc."

3. Locking code changed.

If the locking code of the license server computer changed since the license has been generated by Hypercube, then the license will not install correctly. You may check the server locking code by executing echoid.exe or wechoid.exe. You may check the license file by comparing locking code obtained by echoid or wechoid with the locking code used to generate the license, available by decoding the license in the step above. (The '1E' signifyer corresponds to using the IP Address, Disk ID, Host name, Ethernet Address for the locking criteria.) If the locking codes do not match, request a license transfer from license@hyper.com.

4. Server not running.

SentinelLM server software must be running before the license can be installed. Use the lswhere command to determine if the license server is running and start the SentinelLM service or the server application and try to install the license again.

To start the SentinelLM service on Window NT, 2000 or XP execute loadls from the C:\HyperChem_Server\server\winnt folder and select Install.

To start the SentinelLM server application on Window 9x or ME execute lserv9x.exe from the C:\HyperChem_Server\server\win9x folder.

5. Multiple installed copies of SentinelLM installed.

When installing or updating the SentinelLM software, it's important to know the location of the SentinelLM service. The installations of Hypercube, Inc.'s products may have installed SentinelLM to any of the following locations:

C:\HyperChem_Server

C:\Hyper7_Server

C:\Hyper6_Server

C:\SentinelLM_Server

C:\Program Files\Rainbow Technologies\SentLM

Ensure that only one copy of the SentinelLM is installed and running. To remove the SentinelLM service from the Windows (NT, 2000 or XP) services list, use the server\loadls.exe command and select Remove from the options.

6. License conflict.

If there was a previous license of a particular product installed on the license server, then there may be a conflict with other licenses of that product. If the file 'lservrc' is present in the license folder, usually 'C:\Hyper7_Server\Server\winnt' then delete the file and license the product using the lslic command. This will ensure that previous licenses are not preventing a new license from working.

7. Manually install the license.

If the lslic command cannot install the license, you may try to install the license manually. Please do the following:

1. Make a copy of the license file you received from Hypercube.

2. Stop the SentinelLM service using loadls.exe command.

3. Rename the license file to 'lservrc' with no extension.

4. Move lservrc into the license server folder (such as C:\HyperChem_Server\server\winnt)

5. Restart the SentinelLM service using the loadls.exe command.


Resolutions:

1. Check the locking code again, to make sure it matches the original.

2. Make sure the computer has only one network card and a permanent IP address.

3. Remove any previously installed licenses by deleting the C:\HyperChem_Server\server\winnt\lservrc file, if one exists.

4. Make sure that the SentinelLM service is installed by checking the Windows services list.
(Start Menu->Control Panel->Administrative Tools->Services)
If SentinelLM does not appear, install the service by running C:\HyperChem_Server\server\winnt\loadls.exe.

5. Enter the Command Prompt and enter the following commands:

set LSHOST=localhost
C:\HyperChem_Server\admin\lslic -F licensefile.lic


This command should let you that the license was installed.

SentLM - 21E- locking code

The locking code that your computer generated begins with '21E' which means that echoid.exe is using the ProcessorID (on a Pentium 3 computer). We can't make licenses that begin with '21E.'

Please use the wechoid.exe program and uncheck the processor ID. You should use the IP address, DiskID, Host Name and Ethernet Address and get a code that starts with '1E.' Please send that locking code to us.

lslic - License disappears after the server is reset

If the license is installed correctly, but disappears when the server is reset, make sure to install the license with the command 'lslic -F '. The capital -F switch will make the license permanent by storing it in the 'lservrc' file.


SentLM - Installing the HyperChem Client on the License Server

The HyperChem installation allows you to install either HyperChem or the server software, but not both. In order to be able to install the HyperChem client software the same computer as the license server, you'll have to delete the following folder (for HyperChem 7.5):

C:\Program Files\InstallShield Installation Information\{E02D5A35-D84B-4883-8CFE-BBAA1A943980}

This is where the HyperChem installation stores previous installation information, and deleting it will trick the installation into a client install, rather than a server uninstall.

NOTE: The C:\Program Files\InstallShield Installation Information folder may be hidden. To allow you to see hidden files, please do the following:

1. Open Windows Explorer or any folder

2. Open the Folder Options (Tools->Folder Options)

3. Open the View tab

4. Select Show hidden files and folders

5. Click OK



For versions other that HyperChem 7.5, delete the folder corresponding to the Product ID from the table below:

HyperChem 7.5 Professional

E02D5A35-D84B-4883-8CFE-BBAA1A943980

HyperChem 7.5 Student

6F00BC68-E112-441F-8F99-BDD5E5EAEBC8

HyperChem Lite 2.0

07B4DCA0-EB6B-45A8-82BC-B94DBCB01478



HyperChem 7.0/7.1 Professional

3046BD15-210C-4BE7-828D-CBC458637C14

HyperChem 7.0 Student

ADFED1F3-46EF-43A7-A55F-90C85C5204BB



HyperChem 6.0 Professional

04A07962-7267-11D3-BF46-00C0F04E0FAA

Confirming the license by using lsmon and wlmadmin

The lsmon.exe and wlmadmin.exe utilities can be used to confirm that the license is installed correctly and available. These tools are installed on the license server in the C:\HyperChem_Server\admin folder and on the client in the C:\Hyper75\admin folder.

Usage and output of lsmon.exe:

C:\Hyper75\admin>lsmon

SentinelLM 7.0.0 Application Monitor
Copyright (C) 1999 Rainbow Technologies, Inc.

[Contacting SentinelLM server on host "sentlm.domain.com"]

License type : "Normal License."
Commuter License Allowed : NO
Feature name : "HC75-Network" Feature version : "7.5"
Max concurrent user(s) : 5
Unreserved keys in use : 0 Available unreserved : 5
Reserved keys in use : 0 Available reserved : 0
Soft limit on users : Unlimited.
License start date : Fri Aug 01 00:00:00 2003
Expiration date : License has no expiration.
App-server locking : Floating license.
Valid on subnet(s) : 192.168.20.* and 192.168.21.*
Additive/exclusive : Exclusive license (overrides additive licenses).
Held licenses : Allowed, hold time set by application.
Key lifetime (heartbeat) : 300 secs (5 min(s))

The wlmadmin.exe utility is a graphical version of lsmon.exe that has sever additional options.

HyperChem Client Troubleshooting

SentLM - Using the LSHOST environment variable:

If the license key server is not on the same subnet as the client machines, you may be having a problem communicating through a network gateway. HyperChem client normally uses broadcast calls to locate the license server, and the SentinelLM software can use broadcast calls for name resolution when no other mechanism is available. When the clients and license server are separated by a router (such as when using multiple subnets) special considerations are required. On the clients an environment variable, LSHOST, must be set to the IP address of the license server.

A. Set the LSHOST Environment Variable to the IP address of the license server.

On a Windows 95, 98 or ME client, set the environment variable by including the line 'SET LSHOST=' in the autoexec.bat file of the client computer. You will need to restart the computer before this change will go into effect.

On an Windows NT or 2000 client set the environment variable by selecting 'Properties' from My Computer and selecting the 'Advanced' tab. Click on 'Environment Variables...' and then click New under 'User variables.' The variable name should be LSHOST and the value is the IP address of the license server computer.

B. Alternatively, create a file named "LSHOST", containing the IP address or hostname of the license server machine. Place this file in the directory containing HyperChem program executables.

Subnets, Routers, Firewalls and Broadcast Considerations

HyperChem uses broadcast calls to locate the license server, and the SentinelLM software can uses broadcast calls for name resolution when no other mechanism is available. When the clients and license server are separated by a router (such as when using multiple subnets) special considerations are required. On the clients an environment variable, LSHOST, must be set to the IP address of the license server.

If there is a firewall between the license server and the clients, ensure that the transmission is not blocked by the firewall. The SentinelLM software uses the UDP protocol for direct client/server communication.

Check the TCP/IP Protocol

The license server and the HyperChem clients must have the Microsoft TCP/IP protocol installed.


Name Resolution

The license server must be able to look up the names of all the HyperChem client computers.


Using the UDP Test

The UDP Test is a simple client/server tool to test the communication between the client and server through the UDP protocol. The SentinelLM server software used UDP to communicate and will fail if this protocol is blocked by a firewall.  The UDP Port used should be 5094.

The UDP test is available from our FTP site at the following location:

http://www.hyper.com/Portals/0/Downloads/Utilities/UDPCCLI.zip

The readme.txt file explains the usage.

 
 
     
 
 
     
   Designed by MakoLab (C) 1985-2007, Hypercube, Inc. All Rights Reserved