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 ® software, version 22.0 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 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.

../_images/cmd-admin.png

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:

../_images/run-services.png
../_images/services.png

Installing Stat-Ease on the Client Machines

Now you are ready to install Stat-Ease 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 22.0 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.

../_images/rlm-admin.png

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