View source for Configuring an RLM Server/Solving problems during managed license activation

[[Category: Analytica installation and licenses]]
[[Category: Error messages]]

__TOC__


This page contains information to help you diagnose problems or errors that occur when trying to activate a centrally managed license (e.g., a floating license) for a [http://lumina.com Lumina] product on an [http://www.reprisesoftware.com Reprise License Manager] (RLM) server. If you are looking for RLM installation and activation instructions, see [[Configuring an RLM Server]]. These instructions do not apply to individual licenses.

Reprise Software, who makes the RLM licensing software, provides a [http://www.reprisesoftware.com/admin/software-licensing.php page on technical support issues], which you should also check for known issues and help.

The errors listed here are problems you might encounter when you press '''Request License''' in Step 9 of [[Configuring an RLM Server]].

== Cannot connect to specified URL (-132) ==
:<code>''...Attempting to access license generator at www.analyticaonline.com''</code>

;Possible causes
# Your server is not connected to the internet (and thus, can't "talk" to the activation server on analyticaonline.com).
# A firewall at your institution is preventing your server from communicating with analyticaonline.com.
# Lumina's server is down
# The internet is down.

;Remedies:
Manual activation: If your computer can't talk directly to analyticaonline.com, you can [http://www.lumina.com/support/activate-analytica/ manually activate] your license. The steps are:
::1. Go to [http://www.lumina.com/support/activate-analytica/ http://www.lumina.com/support/activate-analytica]
::2. Enter your information. Be sure to select '''Centrally managed license''' and to enter the correct number of seats.
::3. A license file (extension <code>*.lic</code>) will be emailed to you. 
::4. Transfer the license file to your server computer and save in your RLM license directory. To find the license directory:
:::a. Go to <code>http://localhost:5054</code> on your server computer.
:::b. Click '''Manage Windows Service'''
:::c. The directory is listed as '''Server License File Directory'''
::5. Go to <code>http://localhost:5054</code> on your server computer (the RLM server administration panel)
::6. Click '''Reread/Restart Servers'''
:If you think the [http://lumina.com Lumina] server is down (rare) or the internet is down (even rarer), wait a couple minutes and try again.

== Bad HTTP transaction with activation server (-136), HTTP:404 ==
:<code>''...Attempting to access license generator at www.reprisesoftware.com''</code>

;Causes:You did not specify <code>www.analyticaonline.com</code> as the ''ISV activation website''.
;Remedy: Back up to the page '''"(step 1 of 5) - select activation server"''' and enter <code>www.analyticaonline.com</code>

== Error connecting to server for isv ... Bad or missing login credentials (-182) ==
This error means that  client authentication is turned on (rlm 13 or newer) in the license server and the user isn't in the list of authorized clients.  

The client computer trying to access rlm is not passing the correct password with the environment variable RLMAUTH.

To add a user you need to use rtlmutil rlmadduser from a commmand line. Usage is rlmutil rlmadduser <opt file> <username> <password>
eg: from an elevated  command prompt in the rlmserver directory enter 

<code> rlmutil rlmadduser lumina.opt Dave 1234</code>

Then have the user add the environment variable RLMAUTH on the client computer with the value <password>.

== Error creating license. Invalid hostid type (-1007) ==

;Causes: We've seen this one when you don't include the "<code>disksn=</code>" prefix in the host id that you enter into the manual activation form. For example, the host id on the server might be "<code>disksn=DPLM5HRB9C8FUZ</code>", but you enter only "<code>DPLM5HRB9C8FUZ</code>" into the form. When entering the host id for a centrally managed (floating) license, the disksn= prefix is part of the host id that you need to enter.
;Remedy: Back up and prepend <code>disksn=</code> to your entered host id.

== Activation key not found in database. Error -1021 ==
:<code>''...Attempting to access license generator at www.analyticaonline.com''</code>

;Causes: The activation key you entered does not match a know activation key. You probably typed in wrong. 
;Remedy: Back up and re-enter activation key. Be sure to preserve hyphens (e.g., <code>1234-5678-9876-5432</code>).

==See Also==
* [[Installation and licenses]]
* [[How to Install Analytica -- Centrally Managed License]]
* [http://www.reprisesoftware.com/admin/software-licensing.php RLM Support for License Administrators and Users] on Reprise Software's site.
* [http://www.reprisesoftware.com Reprise License Manager]
* [[Configuring an RLM Server]]
* [http://WebinarArchive.Analytica.com/2009-06-04-RLM_Install.wmv RLM_Install.wmv]: Video - installing RLM and Activating centrally managed Analytica licenses (22 minutes)
*  [http://www.lumina.com/support/activate-analytica/ Manual activation]