Configuring an RLM Server
This page describes the steps required for installing and configuring a Reprise License Manager for use with Lumina software. The instructions are relevant for an IT manager within your organization who manages software licenses.
Analytica end-users, who wish to install the software, should see How to Install Analytica -- Individual License and How to Install Analytica -- Centrally Managed License.
You can watch a video showing the installation of the RLM server, use of the RLM administration console, and activation of Lumina codes here: RLM_Install.wmv (22 minutes). This video is a little rough around the edges.
What you need
- License Server computer
- You'll need to identify a server computer that will host the Reprise License Manager (RLM) server. This computer needs to be on your internal company network where it can be reached by all the computers in your organization that may need to check out licenses. It should also be a server with high availability -- i.e., that isn't turned off. It can serve licenses for other products from other vendors that also use RLM as well.
- The load imposed on the server from RLM, especially from Analytica applications, is extremely light, so it by no means needs to be a dedicated server. You can easily use a computer whose primary purpose is for something else.
- The Server can be nearly any platform, including Windows or Unix (i.e., any platform supported by Reprise).
- RLM does support redundant failover servers, but this is seldom required and isn't covered here.
- Generic RLM Server Software
- If you are already running RLM for other applications using RLM 7 or higher, then you already have what you need. Otherwise, download the end-user bundle from reprisesoftware.com. For a windows platform, this is downloaded as a file x86_w1.enduser.zip.
- You'll also need the lumina-specific settings file (right click, select Save Target As...) lumina.set, and save it in your RLM directory.
- Analytica or ADE license(s).
- These are provided to you by Lumina when you purchase ADE or Analytica.
- They should contain 16 numeric digits, such as: 1234-5678-9012-3456
- If you have a multi-seat license, then each activation key also has a count (aka number of seats) associated with it. Most commonly, licenses are 1-seat licenses, so if you were not given a count with your activation key, you can assume it is a 1-seat license.
Installation Steps
The installation steps are given here for a Windows machine, but are the same with just minor differences on Unix servers. In Windows computers, especially if Vista, you'll probably need to be in an administrator account to perform these steps.
1. Download the RLM License Administration bundle for Windows.
2. Double click the file and extract it to a directory of your choice, such as:
- C:\Program Files (x86)\Reprise\RlmServer (On 64 bit windows)
- C:\Program Files\Reprise\RlmServer (On 32 bit windows)
3. Copy the lumina.set file to the same directory.
4. Start a CMD-line window.
- On Windows Vista and Windows 7, start the CMD-line window as Administrator. To start CMD-line window as Administrator:
- Click on the Start menu on the bottom left.
- Type in cmd in the Search box.
- Press Ctrl + Shift + Enter
5. Navigate to the chosen directory by typing cd and then the address of the chosen directory.
- For example: cd C:\Program Files\Reprise\RlmServer
6. Type rlm -dlog "address" -install_service where address is the path to the log file. For example:
- rlm -dlog "c:\Program Files (x86)\Reprise\RlmServer\rlm.log" -install_service (On 64 bit windows)
- rlm -dlog "c:\Program Files\Reprise\RlmServer\rlm.log" -install_service (On 32 bit windows)
- You must include the full path to the log file, without using relative paths.
- There are additional configuration options, for a listing help type: rlm -?
- The local system account (which the RLM service will run under) must have write permissions to the RlmServer directory, so that it can write activated license files and the log file.
7. Type: net start rlm
- The RLM service should now be running.
8. Enter the administration panel:
- Point a browser to http://localhost:5054.
9. Install any Analytica or ADE licenses.
- Lumina should have provided you with Activation keys for your Analytica or ADE wiki.lumina.comon keys contain 16 numeric digits, such as:
- 1234-5678-9012-3456
- Click the "Activate License" button
- Click "BEGIN License Activation", then enter these fields:
- Click Other (URL) and enter AnalyticaOnline.com into the text-box.
- ISV: lumina.
- License activation key: 1234-5678-9012-3456 {Your activation code here}
- License Server hostid: { Use the value filled in for you }
- License count: { The number of seats. Normally 1. }
- License File to create: { A *.lic file in the licenses directory from step 4}
- Press REQUEST LICENSE.
- If an error occurs, see Solving problems during managed license activation.
- When prompted, restart RLM server to reread licenses.
- Click Other (URL) and enter AnalyticaOnline.com into the text-box.
10. Click on Status
- Verify that the Lumina ISV is listed.
11. If you have more than one activation key, repeat step 7-8 for each.
Additional Configuration
You, as an IT manager, may want to configure RLM permissions to control who can use the Analytica licenses and who can manage the RLM server. On the bottom left of the RLM Administration Console, there is a link to the RLM Manual...
To control access to the RLM server, and administration of its capabilities, see the section on RLM Options File. Among the access control settings you can configure are these (copied from that manual):
Privilege | Name to use in RLM options file | Meaning |
---|---|---|
edit_options | edit_options | Allows editing options files for ISV servers |
edit_rlm_options | edit_rlm_options | Allows editing options files for the rlm server |
edit_transfer | edit_transfer | Allows editing server-server license transfer settings for ISV servers |
reread | reread | Allows access to the functions which do reread commands on license servers |
shutdown | shutdown | Allows access to the functions which shut down license servers |
status | status | Allows display of status and debug log information from the license servers |
You may also want to restrict which users can checkout licenses, for example, restricting usage to specific users in your department. For that, see the section The ISV Options File in the RLM Manual. Also consult that section for information on assigning named-user licenses to specific users.
See Also
- RLM_Install.wmv: Video - installing RLM and Activating centrally managed Analytica licenses (22 minutes).
- Manual Activation
- What License do I Purchase?
- How to Install Analytica -- Individual License
- How to Install Analytica -- Centrally Managed License
- RLM for License Administrators and Users -- info, downloads, FAQs and troubleshooting tips from Reprise.
Enable comment auto-refresher