Setting up a Licence Server for Site Network Licenses

Site network licenses require a license server application to be installed and run on a server on the network. DesignBuilder runs on the client machines on the same Windows network and obtains licences from the license server on a concurrent basis.

Summary of Process

In summary, the steps to set up DesignBuilder Site Licenses are:

 

  1. Download the designb_rlm.zip file from the Downloads > Software area of the DesignBuilder website
  2. Extract the files in the designb_rlm.zip file to the folder on the server to be used to store DesignBuilder site license files (e.g. c:\RLMSERVER)
  3. Obtain the License file by clicking on activate.cmd, following instructions on the webpage and saving the license file to the site license folder.
  4. Run the RLM server as a service and start the service.
  5. On client machines which are to run the DesignBuilder software, open the Licence Manager dialog (Help > License menu option) and enter the ip address or hostname of site license server host.

 

The above steps are detailed below.

Detailed Steps

Obtain your License File

With Site Network Licenses the License file is obtained through the activation code you received when ordering the software.

 

  1. Before you run the rlm server you will need to obtain your license file and save it into the rlm installation folder. That's the folder containing rlm.exe and other files listed above.
  2. You should have received an activation code from your site license purchase. This is an 8-digit number and is needed to activate the license.
  3. Open the rlm installation folder in Windows Explorer and double click on activate.cmd
  4. This loads a web page at www.designbuilder.co.uk with a form for you to enter your activation code.
  5. Other values in the form such as Hostid are automatically filled in for you. After entering your activation code click Activate License and if successful you will be presented with a download link for your activated license file.
  6. Download the license file and save in your rlm installation folder.

 

 

ClosedIf your server cannot access the Internet

 

If your server computer has no internet connection then activate.cmd will not be able to connect a browser window to the designbuilder.co.uk web server and you will have to activate manually by following these steps:

 

  1. Obtain your server hostid by running the command rlmutil rlmhostid -q 32
  2. Obtain the ip address using the command rlmutil rlmhostid -q internet
  3. Obtain the hostname with command rlmutil rlmhostid -q host
  4. Make a note of the hostid, ip address, hostname and your DesignBuilder activation code and go to a computer with internet connection and run:

    http://www.designbuilder.co.uk/license/activate_site.php

  5. Enter your details in to the form and download the resulting .lic file.
  6. Place a copy of the .lic file in the site license installation folder on your host server.

Running the RLM Server

The server can be run directly by double clicking rlm.exe. This runs a command window and logs activity to the window. This is useful when you first run the license server as you'll be able to see the license server starting up correctly and loading the license file as well as DesignBuilder clients obtaining licenses from the server.

Running RLM as a Service

It is best to set rlm up to run as a Windows service rather than in the command window, otherwise you'll need to remember to manually restart the license server when the computer reboots.

 

If you are running rlm in a command window you should close that before starting up rlm as a service.

 

To create the Windows service to run rlm automatically double click on service_install.cmd or use Manage Windows Service in the admin interface.

 

Note: The service will be added to Windows services but not started.

 

Use Control Panel > Services to start DesignBuilder License Server.

 

 

Once started in this way the service will restart automatically if the computer is rebooted. By default the service will write a log file designb_rlm.log into the rlm installation folder. If you want this in a different location you can use the admin interface (above) to set up the service then you can specify the service name and the log file location.

 

You may experience problems with permissions when setting up the service. You can either disable the UAC or try right clicking service_install.cmd and choosing "Run as administrator".

 

Even this doesn't always give you access to the Service Control Manager. You can check this by running a cmd prompt, changing folder to the license server installation folder and running the rlm install service command (below).

 

If you edit service_install.cmd you'll see the command being executed is:

 

rlm -install_service -dlog "%CD%\designb_rlm.log" -service_name "DesignBuilder License Server" -c "%CD%"

 

If you see this error returned "Error: Access to Service Control Manager denied" you can get over this by running cmd as administrator and then run the install command. To do this right click Command Prompt on the start menu and run as administrator. Change folder to the license manager installation folder and run the rlm.exe -install_service command given above and it should work.

 

More on this in the License Manager FAQs at http://www.reprisesoftware.com/support/faq.php

RLM Server Admin Interface

RLM provides a browser-based administration interface to the license server. To run this, double click on the admin_interface.cmd file in the RLM folder using Windows Explorer.

 

Refer to the RLM End User Manual (double click online_manual.cmd) for more details on using the admin interface.

 

Note: DesignBuilder does not use the Activation page of the admin interface.

 

Reprise Software, developers of the RLM licensing system, always maintains a current version of the RLM End User's Manual here:

 

www.reprisesoftware.com/RLM_Enduser.html

Adding a lic file for extra seats

If you purchase additional seats for a site network license system, the new licenses are provided in the form of a lic file download. The process of obtaining the additional lic file is the same as described above under Obtaining your License File. The new lic file does not replace the existing lic files, but is used in addition to the existing licenses. The license server reads these multiple lic files, licenses from multiple lic files adding to give the total number of seats of concurrent use that are allowed.

Setting up Client Machines

This steps involved in pointing client machines to the License Server is described on the main Licensing & Activation page. From DesignBuilder you can check out or check back in module licenses using the License Manager which can be accessed from the Help menu.