HiCLAS1  HiPERiSM Consulting, LLC, Linking with AS1MET Services

[Under Construction]

News
Products
Services Home
QAreports.htm
downloads.htm
FAQ.htm
sales.htm
MEDlist.htm

HCTM Installation Issues FAQ

bullet How do I find and start the rlm-hiclas1 service in windows?
bullet How (and why) should I disable secondary network interfaces?
bullet How do I check if the license file environment variable is set?
bullet The rlm-hiclas1.log file shows the message "Port ... in use, waiting" and HCTM doesn't work: what is wrong?

How do I find and start the rlm-hiclas1 service in windows?

The HCTM installer adds the rlm-hiclas1 service to Windows services. However, it does not start this service nor should it be started before the license extractor application is received from HiCLAS1. Whenever a license extractor is executed then this service needs to be started. Customers who have previously installed a HiCLAS1 product need to simply "restart" the service, whereas customers who are installing their first HiCLAS1 product need to "start" the service.  Follow these steps to start (or restart) the rlm-hiclas1 service (these steps are for MicroSoft® Windows XP, with similar steps for Windows 2000).

  1. From the Windows Control Panel select Administrative Tools

  2. From the Administrative Tools panel click on the Services icon

  3.  In the services panel scroll to find the “rlm-hiclas1” service

  4.  Select it and right click

  5. Choose "start" (or "restart")

  6. Close the services panel

 Back to top of page.

How (and why) should I disable secondary network interfaces?

It is not uncommon for modern computers to have more than one network interface, for example two Ethernet ports, wireless access, etc. When installing HiCLAS1 applications it is preferable to have only one network interface enabled (hereafter the primary network interface). For the primary network interface choose the one you know will always be used whenever the machine is on. After the installation is complete any number of network interfaces may be enabled. The reason for this is because the procedure used to build your unique hostid for licensing purpose queries each enabled network interface. If you submit a hostid file based on a 'secondary' network interface, then the license checkout may fail and the HiCLAS1 application will not run if a secondary interface should happen to be disabled on your platform. Likewise, even with a license based on the primary network interface, the license checkout will fail if the primary network interface is disabled when HCTM is executing.  Follow these steps to check which network interfaces you have enabled and how to disable the secondary ones (these steps are for MicroSoft® Windows XP, with similar steps for Windows 2000)

  1. Select the “My Network Places” or “Network Neighborhood” icon

  2. Right click

  3.  Select “Properties”

  4.  In the Network Connections panel look in the section for “LAN or high speed internet.”

  5.  Right click on of the secondary interfaces and select “Disable”

  6. Install the HiCLAS1 application

  7. View the contents of the hostid-string.txt file. This should show a copy of the hiclas1.lic file in addition to one host string that is non-zero

  8. Repeat steps 1 to 5 (above) to enable the secondary network interfaces

. Back to top of page.

How do I check if the license file environment variable is set?

The license file is located by the value of an environment variable:

Environment Variable:     RLM_LICENSE_FILE

Value:                           C:\my_hctm_directory\hctm8\hiclas1.lic

Where ‘my_hctm_directory’ is your choice for locating the HCTM8 application. Usually this environment variable would have been defined and set by the installer application. The following steps are for the case that problems occur when the HCTM application will not find the license file. Follow these steps to check that this environment variable is set with the correct value and how to do this if it is not (these steps are for MicroSoft® Windows XP, with similar steps for Windows 2000).

1.       Check for the environment variable

                                                               i.      Open a command prompt and type “echo %RLM_LICENSE_FILE%”

2.       If no value is returned in the above step then it must be set manually as follows (this needs to be done once only and will survive computer restart):

                                                               i.      Right click on the desktop “my computer” icon

                                                             ii.      Select “Properties”

                                                            iii.      In the System Properties panel select the “Advanced” tab

                                                            iv.      Click on the “Environment Variables” button

                                                              v.      Scroll down in the “System Variables” window and look to see that the RLM_LICENSE_FILE environment variable is set and has the correct value

                                                            vi.      If it does not exist, then click the “New” button and define its name and value in the “New System Variable” panel

                                                           vii.      If it does exist but has the wrong value (or no value), then click the “Edit” button and define the correct value in the “Edit System Variable” panel

                                                         viii.      Click “OK” buttons to exit and save changes in the System Properties Panel

3.       Open a new Command prompt window

                                                               i.      To confirm the value is assigned type “echo %RLM_LICENSE_FILE%” and inspect the response

                                                             ii.      Navigate to the folder C:\my_hctm_directory\hctm8\ where HCTM8 was installed and execute the rlm.bat script

                                                            iii.      View the contents of the hostid-string.txt file. This should show a copy of the hiclas1.lic file in addition to the host string. If the hostid-string.txt file existed before the execution of the rlm.bat script then new contents are appended to it.

4.       Check the number of hostid strings found

                                                               i.      If there is only one hostid string then submit the file for a license application

                                                             ii.      If the hostid string is all zeros, then you have disabled all network interfaces. Enable your primary network interface (usually your primary Ethernet connection) and execute the rlmhostid.exe application and append the output to the hostid-string.txt file before submitting your license request

                                                            iii.      If there are multiple hostid strings then you need to read the FAQ on “How (and why) should I disable secondary network interfaces?” (see above).

 Back to top of page.

The rlm-hiclas1.log file shows the message "Port ... in use, waiting"  and HCTM doesn't work: what is wrong?

This log file in the location C:\hiclas1\rlm-hiclas1.log shows the rlm license server status as it listens for license requests on this port. A message such as this suggests that after installation a prior instance of hiclas1.exe is still executing on this platform and has blocked the port. Follow these steps in sequence to rectify the problem (these steps are for MicroSoft® Windows XP, with similar steps for Windows 2000)

  1. In the windows services panel stop the rlm-hiclas1 service. For the details on how to do this see the FAQ How do I find and start the rlm-hiclas1 service in windows?

  2. Bring up the "Windows Task Manager" and select the "Processes" tab

  3.  Look to see if there is a hiclas1.exe process running

  4.  If yes, select it and choose "End Process", then confirm that no other instances of this process are executing

  5. In the windows services panel start the rlm-hiclas1 service

Back to top of page.

 

backnext page

Send mail to george@hiclas1.com with questions or comments about this web site.
Copyright © 2007 HiCLAS1
Last modified:  04/15/2009