2
2.2 Setup & Installation 10
2.3 Troubleshooting 14
2.1 Introduction
Network Licensing utilizes a Sentinel RMS License Manager to manage network licenses for the client workstations. The license manager is typically installed on a server residing in the same office location that it will be accessed from. The software programs, such as spMats, can be installed on any number of client workstations on the network. The client workstation acquires a license from the network license server when the software is launched, and remains in use until the software is closed. The number of available licenses, or seats, is encoded in the license code hosted on the server. License codes are unique to the designated license server.
The main steps in this process are illustrated below:
Step 1: Installing the License Manager
The Sentinel RMS License Manager software should be installed on a reliable server. The server should be located on the same subnet as the client computers, depending on the license type and license agreement at the time of purchase.
1. Login as Administrator on the Network License Server computer.
2. Download the Sentinel RMS License Manager Installer.zip from StructurePoint’s website.
3. Unzip Sentinel RMS License Manager Installer.zip to your preferred location and run setup.exe.
4. Follow the steps in the installation wizard to install the Sentinel RMS service and utilities. Default settings are recommended.
Step 2: Obtaining Locking Code
Network license codes are locked to the server by a unique locking code that is specific to each server. Reformatting the server, changes to the operating system, or updating hardware on the server could disable licenses or render them incompatible with the server, and new license codes will be required.
1. If setting up Sentinel for the first time, a locking code is needed by StructurePoint. To retrieve the locking code, launch wechoid.exe located in C:\Program Files (x86)\Common Files\SafeNet Sentinel\Sentinel RMS Utilities.
2. If you already have an existing Sentinel License Manager, and received license codes for your server, proceed to configuring the license server (Step 3).
3. In wechoid.exe, uncheck all boxes under “Locking Criteria” except Disk ID (shown above).
4. E-mail a screenshot of the wechoid.exe window, along with the order number or license serial number to Licensing@StructurePoint.org. Our licensing team will process the request and send the License Code(s) via e-mail.
If you have a Sentinel License Manager/Utilities that is later than version 8.5.2, please download and use this version (wechoid.exe) to obtain the old-style server locking code. The format in the earlier version (old style) is needed to generate a license.
Step 3: Configuring License Server
1. Run the WlmAdmin.exe utility located in C:\Program Files (x86)\Common Files\SafeNet Sentinel\Sentinel RMS Utilities. If your Sentinel installation is not installed in the default folder above, locate and open the WlmAdmin.exe utility.
2. Expand the Subnet Servers list, and locate your server’s name under the Subnet Servers list. You may already see licenses here.
3. To add the new license, right-click the server’s name in the Subnet Servers list and select Add Feature | From a String | To Server and its File | from the menu selections.
4. Copy the license code/string for one StructurePoint product from the license code e-mail and then paste it into the License code field. Click the Add button to continue.
5. Repeat steps 3 and 4 to add additional StructurePoint software licenses. Added licenses will be listed under the server’s name. The software version installed on the client workstation should be the same or higher than the license version on the server.
6. If you are adding a new license to an existing, non-expired license, both licenses will be active and available until the expiration date of the old license.
Step 4: Configuring Applications on Client Workstations
These step must be repeated for each StructurePoint application (e.g. spWall) on each client workstation. By default, the StructurePoint software applications are installed in C:\Program Files (x86)\StructurePoint\.
1. After installing the software on the client, configure the program to connect to the designated server hosting the network license:
a) For all programs except spMats v10.00 and spColumn v10.00:
– Navigate to C:\Program Files (x86)\StructurePoint\spMats
– Open “lshost.txt”, and change “no-net” to the IP address or hostname of the designated license server. Close and save lshost.txt
– Launch the program.
b) For spMats v10.00 and spColumn v10.00:
– Launch the program and select Network Licensing
– Input the IP address or Hostname of the designated license server and select Activate.
The license server and client installation/configuration are now complete. When the software is launched, the program will use the lshost.txt file to determine where it will look for a license.
On the server, the “Sentinel RMS” service must be continuously running in order to host and serve the network licenses.
1. License Server Does Not Appear on Subnet
If the license server is not listed under the subnet servers when running the WlmAdmin.exe application (C:\Program Files (x86)\Common Files\SafeNet Sentinel\Sentinel RMS Utilities), the Sentinel RMS service may need to be started. Please run the “loadls.exe” as an administrator in the above path to start the Sentinel RMS service.
2. Client Computer Cannot Find License Server
If the workstation cannot checkout a license after completing the setup of the license server and configuration of the client workstations, please consider the following actions:
1. Open the StructurePoint software folder in the default path (C:\Program Files (x86)\StructurePoint\spColumn). For spMats v10.00 and spColumn v10.00, this file is called lshosts.txt and is located in (C:\ProgramData\StructurePoint\spColumn\10.00).
2. Make sure that either the IP address or the license server name is in this file (these can be used interchangeably).
3. Using the WlmAdmin.exe tool located in C:\Program Files (x86)\Common Files\SafeNet Sentinel\Sentinel RMS Utilities, the license manager should display the designated license server, with active licenses (non-expired) listed beneath the server.
4. Verify that the software version installed on the client workstation is supported (version should be the same or later than the version of the license installed on the license server). Please refer to https://www.structurepoint.org/software-update.asp for details.
5. If all of the above steps have been executed and you are still having trouble with the client workstation connecting to the license server, a Sentinel specific port (UDP 5093) may need to be opened to allow communication between the client and server.
6. Uninstalling and reinstalling Sentinel RMS is recommended if none of the above steps are successful. You may also contact our support team at licensing@structurepoint.org or 847-966-4357 for assistance.
3. License Server Does Not Release Licenses
When StructurePoint software is closed on a client workstation, the license is released and becomes available to other client workstations. If the license is not released automatically, try the following:
1. Wait a few minutes and run the application on client computer again. Sentinel checks the status of all the licenses on client computers and releases a license automatically if a connection has been inactive for about 10 minutes.
2. On the computer that may have the license checked out, open the Task Manager and make sure there is no process listed for the software (spSlab, spColumn, etc.)
3. Open WlmAdmin.exe and right-click the license in question under the subnet server and select “Remove Feature”. Proceed to re-add the license using #2 in Step 3: Configuring the License Server.
4. Restart the Sentinel RMS service by opening the services on your server and locating “Sentinel RMS”. Right-click on the service and select “Restart” or “Start”.
5. Reboot the license server could possibly resolve this issue if the above options do not work.