HyperChem for Network Diagnostics


This document will provide a guide for diagnosing problems HyperChem for Networks and describe the appropriate solution.

Step 1.  License-Type

HyperChem for Networks comes in two varieties: Software-locked and Hardware-locked.  The Software-locked version requires that the license server is installed with a software-based license key, which is specific to one particular server and must be obtained from Hypercube.   The Hardware-locked version required that a physical device (dongle) be attached to the parallel port of the license server.  Driver software provided with HyperChem then reads the information from the hardware lock and issues the appropriate licenses.

Do you have the Software-locked or hardware-locked version of  HyperChem 6 for Networks?

Software-locked.  Go on to Step 2.
Hardware-locked.  Contact Support.  Online help is under construction. 

Step 2.  SentinelLM Installation

The Sentinel License Manager (SentinelLM) is the software that allows HyperChem to be licensed at one central location and used by a specified number of users throughout the network.  SentinelLM may be installed from the HyperChem disc by choosing Purchased Product, Networked, Network license server and Software-locked options when installing HyperChem.  SentinelLM is required for HyperChem for Networks to function. 

Is the License Manager software installed?  

Yes.  Go on to Step 3.
No.  Please consult the HyperChem 6 for Networks Installation.

Step 3.  Network License

In order to provide HyperChem Licenses to your network, the license server must be installed with the number of licenses purchased.  To obtain a license key for HyperChem for Networks, please contact license#064;hyper.com with the Serial Number, server locking code and your client IP subnets requirements.

Have you obtained and installed a license from Hypercube, Inc.?

Yes.  Go on to Step 4.
No.  Please consult the HyperChem 6 for Networks Installation.

Step 4.  Confirm the Network License

To check whether the license server and license key have been installed correctly, use the administration tools provided with SentinelLM.  On the license server, execute C:\Hyper6_Server\admin.net\win32\wlmadmin.exe.  Select the license server and check the information to determine if the license was installed correctly.

Are the correct number of licenses is installed?

Yes.  The licenses are  installed correctly.  Go on to Step 5.
No.  Please consult the HyperChem 6 for Networks Installation.  If you still have problems, contact Technical Support.

Step 5.  Install the HyperChem Client software.

The HyperChem Client software needs to be installed on every computer that is to run HyperChem.  Use the HyperChem disc and install with the Purchased Product, Networked, HyperChem client and From a Software-Locked Server options.  When the installation is completely installed, execute HyperChem.

Additional Information: HyperChem Client Installation.

Does HyperChem function correctly?

Yes.  HyperChem for Networks is installed and ready for computation!
No.  "Error E002: Can't obtain a network license" appears.  Go to Step 6.

Step 6.  LSHOST Environment Variable

Use the LSHOST Environment Variable to direct HyperChem 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=<IP address of server>' 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.

Alternatively, create a file named "LSHOST" (no extension), containing the IP address or hostname of the license server machine. Place this file in the directory containing HyperChem program executables (usually C:\Hyper6\program\).

Does HyperChem function correctly?

Yes.  HyperChem for Networks is installed and ready for computation!
No.  Still can't obtain a network license.  Go to Step 7.

Step 7.  Install the HyperChem Client on the License Server

Before looking into Network Configuration problems, try to install HyperChem on the License Server.  The SentinelLM software should be able to issue a license to HyperChem running on the same computer, provided the IP address is in the subnet range of the license.  If HyperChem runs correctly on the license server and fails to run on the clients, the network configuration is a possible cause.  If HyperChem does not run on the license server, SentinelLM is not installed correctly.

Does HyperChem run correctly on the license server?

Yes.  The network configuration may be the problem. Go to Step 8.
No.   SentinelLM is not installed correctly.  Please consult the HyperChem 6 for Networks Installation or contact Technical Support

Step 8.  Network Configuration

Open the Network Properties settings on the server and determine that the TCP/IP protocol is installed.

Open the Network Properties settings on the client and determine that the both the TCP/IP protocol and the Client for Microsoft Networking are installed.

Yes.  The correct protocols are installed but HyperChem does not work.  Go to Step 9.
No.   Please contact Technical Support to verify a custom set of protocols. 

Step 9.  Check the IP address of the HyperChem client

Check the IP address of the client by running 'ipconfig' from a DOS window on the client and verify that the license key included this number in the range.  You can check the IP subnets included in the license file by running wlmadmin.exe

For further information on the license key, you may run 'lsdecode -s <licensefile>' on the server from the 'C:\Hyper6_Server\admin.net\win32' where <licensefile> is the file that you were sent from Hypercube, Inc. It will have the *.lic extension.

Is the IP address of the client included in the license key installed on the license server?

Yes.  The correct IP addresses are installed.  Go to Step 10.
No.   Please use a client with a IP address corresponding to the license key, or consult the HyperChem 6 for Networks Installation on obtaining a new license. 

Step 10.    Check the name resolution of your network.

The license server must be able to recognize the clients by IP address and by computer name.  From the server, run 'ping <client IP address>' and 'ping <client NAME>'. The results should match. If the client is addressable by IP number and not by computer name, then name resolution on your network is not working and the client will NOT be able to receive a license.

This situation can occur if your clients are configured to receive a dynamic IP address from a DHCP server, and a method for name resolution is not set up. In this case, the individual computers will broadcast a request for name resolution. Broadcast calls are blocked by some network equipment to reduce network traffic.

Permanent IP addresses are issued through a DNS server, which also provides name resolution.

Additional information:  Name Resolution

Is name resolution functioning properly on your network?

Yes.  Each computer recognizes others by IP address and computer name.  Please contact Technical Support for further information. 
No.   Below are possible solutions.  Please contact Technical Support for further information. 

Solution 1: Install a WINS server and direct each DHCP computer to register their computer name with the WINS server.

Solution 2: Set up and maintain an hosts file containing the IP addresses of each computer on the network with their corresponding computer name. This is a text file will serve as a look-up table for name resolution. Each line of the file should look like:

<IP address> <Computer name>

On Windows 95, 98 or ME computers, save this file with the name 'HOSTS.SAM' in the 'C:\Windows' folder. On Windows NT or Windows 2000 computers save this file with the name 'HOSTS' in the 'C:\Winnt\system32\drivers\etc' folder.

Solution 3: Change your network configuration to use permanent IP addresses through a DNS server.


[Products] [Sales] [Support] [Science] [News] [Corporate] [Search] [Home]


(c) 2003, Hypercube, Inc. All Rights Reserved.
1115 NW 4th Street, Gainesville, FL 32601 USA
Phone (352) 371-7744 Fax (352) 371-3662 email info@hyper.com