Network Quick Start Guide¶
Overview¶
The network version of our product consists of two parts:
A 3rd party server component (Reprise License Manager) for checking out license seats
A client component containing the core product
Network installations involve two components, an installation of Stat-Ease 360 ® software, version 13 running on the client (see Client Installation section below), and the license server running on a central computer in order fulfill license requests from the clients.
Reprise License Manager for 32-bit and 64-bit Windows platforms and 64-bit Linux platforms are capable of metering Stat-Ease 360 seats.
Please refer to the following documents for important installation, activation, and troubleshooting instructions:
For more advanced features of the Reprise License Manager, refer to their documentation.
Please note that you may need to contact your network system administrator to install the license manager.
The commands used in this installation walkthrough may not be available in all network environments. Substitute your equivalent commands as necessary.
Extract the Network Bundle¶
Download the Network Bundle appropriate to your server (32 or 64-bit) from the Downloads & Updates page. Extract the bundle to a permanent location on your server (example: c:).
Open Command Prompt¶
Launch a command prompt using the “Run as administrator” option.
Now change the directory to the location of the Network Bundle folder (replace C:statease-rlm-x86 with the path you extracted to):
C:\Windows\system32>cd C:\statease-rlm-x86
C:\statease-rlm-x86>
Determine Host ID of Virtual Server¶
You may skip this section if you are installing RLM on a physical server (although it is still useful to know how to determine your server’s host id in case internet activation fails).
If your server is a virtual server, you will need to give it a static MAC address identical to the host id address reported by dex_activate.exe.
To determine the host id, call dex_activate.exe /showhostid from the command line:
C:\statease-rlm-x86>dex_activate.exe /showhostid
Host ID: 0000000000
Press any key to continue:
Make note of this number and set your virtual server’s MAC address to correspond.
Internet Activation¶
Type dex_activate.exe and hit enter. Input your 16-digit network license serial number and follow the prompts to complete activation.
C:\statease-rlm-x86>dex_activate.exe
Enter serial-number: XXXX-XXXX-XXXX-XXXX
Activating license for XXXX-XXXX-XXXX-XXXX
Activation successful! License file C:\statease-rlm-x86\dex.lic
Press any key to continue:
This retrieves the license file containing the number of seats to which you are entitled. This is stored to the file dex.lic in the same directory.
If this step fails (usually with a -105 error indicating a firewall issue) proceed to the manual activation step.
Manual Activation¶
Type dex_activate.exe /showhostid at the command line and record the entire line that it reports. This is the host id for the server.
C:\statease-rlm-x86>dex_activate.exe /showhostid
Host ID: 0000000000
Press any key to continue:
Email the host id, the host name of the server, and your serial number to support@statease.com. We will reply with a license file and instructions on how to install it.
Install and Start the Reprise License Manager Service¶
Next, install the Reprise License Manger (RLM) executable as a service. The command shown below installs the RLM service and instructs it to append messages to a log file in the same directory.
C:\statease-rlm-x86>rlm.exe -install_service -dlog +C:\statease-rlm-x86\rlm.log
To start the service use the service control command: sc start RLM.
C:\statease-rlm-x86>sc start RLM
SERVICE_NAME: RLM
TYPE : 10 WIN32_OWN_PROCESS
STATE : 2 START_PENDING
(NOT_STOPPABLE, NOT_PAUSABLE, IGNORES_SHUTDOWN)
WIN32_EXIT_CODE : 0 (0x0)
SERVICE_EXIT_CODE : 0 (0x0)
CHECKPOINT : 0x0
WAIT_HINT : 0x7d0
PID : 3724
FLAGS :
You can also start and view the service from the services.msc dialog:
Installing Stat-Ease 360 on the Client Machines¶
Now you are ready to install Stat-Ease 360 on the client machines.
The client installers are MSI packages. They may be downloaded here. Download the version appropriate to your client machine platform (32-bit or 64-bit).
Please read the important notes below.
Important Notes¶
Note
TCP Port 5053 and should be open on your firewall and available on the server and client.
Note
TCP Port 5054 should be open on the server to manage and troubleshoot RLM through its web interface.
Note
RLM dynamically allocates another port for the ISV service each time it starts, but this is configurable. It is not always necessary, but recommended that this port be configured. As an example, to set the ISV port to 49155 change the line in dex.lic from “ISV statease” to “ISV statease port=49155” and then open port 49155 in your firewall.
Note
Access the license manager interface by entering SERVER:5054 in a web browser address bar where SERVER is the name of the machine on which RLM is running.
Note
Do not enter your 16-digit serial number in the Stat-Ease 360 13 License Options dialog for a network installation. Activation is done via dex_activate.exe on the server for the network product.
Note
If you are running on a virtual machine, you will need to ensure that it has a static MAC address set. Otherwise each time you reboot the VM the host id (MAC address) will change and invalidate the license.
Administration Console¶
On start RLM also launches an administration interface on port 5054. You can access it by opening a browser and typing “http://YOURSERVERNAME:5054” where YOURSERVERNAME is the name of your server.
Stopping and Deleting the Service¶
You can stop and remove the service using the service control commands sc stop
RLM
C:\statease-rlm-x86>sc stop RLM
SERVICE_NAME: RLM
TYPE : 10 WIN32_OWN_PROCESS
STATE : 1 STOPPED
WIN32_EXIT_CODE : 0 (0x0)
SERVICE_EXIT_CODE : 0 (0x0)
CHECKPOINT : 0x0
WAIT_HINT : 0x0
and sc delete RLM.
C:\statease-rlm-x86>sc delete RLM
[SC] DeleteService SUCCESS