Licensing

(This is ported from the v2.1 admin guide AND the RLM admin guide)

Licensing Models

Licensing is controlled through the RLM product from Reprise Software. There are two licensing models that can be used:

A license server process (rlm.exe) running on a designated license server machine, serving floating network, per-use licenses. This is the default model for corporate networks.
A licence file encoded for the client machine. This is the default model for single user systems and evaluations. The licence will only run on the target client.

We no longer support the hardware key (dongle) model.

Licence File

The licence file may have any file name (and you can change the file name), but will always have a .lic extension. The file is plain text and can be examined with a text editor, but you cannot edit the file contents without risking making the file invalid (except for example, adding a port number for the licence server).

All types of licence file are time-limited, and reissued on an annual basis, even for previously purchased "perpetual" licences.

A full description of the licence file is available through the RLM site.

The licence file may contain a mixture of licence types.

Setting up a standalone licence

Simply put the licence file into the StrataBugs folder OR set the environment variable RLM_LICENSE to point to the location of the licence file.

Setting up the licence for a floating server

These are

Download the RLM License Administrator Bundle from the RLM site.
Run the utility rlmutil.exe rlmhostid. Report the hostid of your server to StrataData support.
When you receive the license file, download the ISV daemon package from StrataData support.

Follow the RLM instructions to start the RLM service with the license file, with a command like rlm -c<licence file>. You should see startup messages about the server starting. Check for errors. At this point, the licence checkout can be tested from a client, before installing the service.

If you receive an error message about preventing running the license server on a virtual machine, we can supply a licence file which will permit this on request.
Install the licence server as a service (see RLM instructions).
Provide a reference for the clients using an environment variable in the format
```
RLM_LICENSE:port-number@license-server-host
```
For users, go to the Windows Control Panel | System | Advanced system Settings | environment Variables, and add a User or System variable. The variable name is RLM_LICENSE and the value might be 5053@server-host

The server has a built-in web server which allows easy monitoring and administration, simply point a browser to "server-host:5054" to connect to the process, where server-host if the name of your server.

Diagnosing problems

Run the application control panel with the following environment variable set: RLM_DIAGNOSTICS=rlmdiag.log, or start the application with Stratabugs_diagnostic.exe, which will contain this setting. Messages are shown on the command line as well as to the log file.

Roaming licenses

We can provide a floating licence which allows licences to be checked out for a period of time from the network server. If this is enabled you will have an argument to the LICENSE line in the licence file stating "max_roam=n" for the maximum number of days a licence can be roamed.

Use the licence roaming checkout option from the Config menu of the Control Panel. If for any reason this can’t be done, use the following procedure:

The environment variable RLM_ROAM should be set to the number of days the licence is required, before running the StrataBugs control panel. Thereafter the client can be disconnected from the network. A suitable script like this would work:

@echo off
REM start strataBugs with roaming options.
echo.
echo Enter the number days you want to take a StrataBugs licence for.
echo.
echo Enter 0 to leave unchanged.
echo Enter -1 to return the existing licence to the server.
echo.
SET /P RLM_ROAM=Days required :
echo.
echo. Remember to Open and Close the charts module

stratabugs
echo.
IF %RLM_ROAM% GTR 0 echo You can disconnect from the network and use StrataBugs for %RLM_ROAM% days.
SET /P TEMP=Press Return:

Additionally, if you have the flag issuer=user_roam set in the stratabugs LICENSE line of the licence file, you can enable users to choose roaming through the control panel themselves. The user selects the control panel menu option "Config | Licence roaming check in/check out". This brings up the following dialog:

The maximum number of allowable days roaming is set within the licence file, with an overall maximum of 180 days.