View source for License Roaming

[[Category: Analytica installation and licenses]]
{{ReleaseBar}}

__TOC__

An N-seat floating license allows anyone in your group to run Analytica, as long as no more than ''N'' people are running it at any given moment.  To run Analytica from a floating license, your computer must be able to communicate with the [http://www.reprisesoftware.com/index.php Reprise License Manager (RLM)] server, which manages the license, so it can check out the license while Analytica is running.  However, if you take your notebook computer with you on a business trip, it won't be able to communicate with your license server, and thus, you'll need to make use of ''License Roaming''. 

'''License roaming''' checks out a license to your computer for a specified period of time, during which that license may be used on your computer even if the RLM server is not accessible from your computer.  Thus, if you are going on a business trip, you might roam the license for 7 days, meaning it belongs to you for the next 7 days.  While you are roaming a license, that seat is not available for use by other people.

When you return to the office, you could release (unroam) the license, thus returning it to the floating pool to be available to others.  Alternatively, you might extend the roaming period -- for example, if there are still 2 roaming days remaining, you might extend that to 7 again.

== When do I need to roam a license? ==

There are two reasons to roam a license.  The most common is because you will be removing your notebook computer from the office where it can't communicate with the license server, so you need to roam the license to take it with you.  A second reason is to roam is to "hog" a floating license at a critical time, so someone else isn't using it when you need it.  

Roaming only make sense if you are using a license managed by an [http://www.reprisesoftware.com/index.php Reprise License Manager (RLM)] server -- if you are using an individual license, there is no need to worry about roaming.  You can tell which you have by looking at the '''Update license...''' dialog off Analytica's '''Help''' menu.  If the checkbox to use an RLM server is checked, then your license is managed and you will need to roam the license before leaving the office.

Your company's IT manager can configure permissions for which users or computers are able to roam a license.  In most cases, if your IT manager has not configured restrictions on roaming, then if you can use Analytica on the license, you can roam it.  Lumina usually distributes Analytica and its RLM-based licenses with permissions to roam; however, in certain special circumstances, Lumina may distribute Analytica licenses that do not allow roaming.

Licenses issued by [http://lumina.com Lumina] are limited to a maximum of 14 days of roaming.  Your IT manager may adopt a policy that permits fewer than 14 days, which he can configure through the RLM server administration interface.

If you use a named-user license managed by an RLM server, then you are the only user of that license.  However, you still may need to roam the license when you remove your computer from the office. Here, there is very little reason to ''unroam'' the license, except that your IT administrator cannot re-assign ownership of the license to someone else while it is being roamed.

== How to roam a license ==

First, you must roam a license ''before'' you leave on your trip.  To obtain a roamed license, your computer will need to communicate with the RLM server.  After it is roamed, then you can remove your computer from your office.

There are two methods to roam an Analytica license.  One utilizes an Analytica command line option.  The other uses the <code>RLM_ROAM</code> environment variable.  If you use Reprise licenses with other products, you may already be used to the <code>RLM_ROAM</code> method, but otherwise, we think the command line option is the more convenient one.  We recommend setting up some shortcuts on your start menu with the roaming options that you like to use, and we'll describe how to do that first.

=== Command-line method of roaming ===

You can run Analytica from a command line as follows:
:<code>Analytica{{Release||5.4|64}}.exe /roam:7</code>

When you do this, Analytica starts up and roams its license for the next 7 days.  If you were already roaming the license and had roaming days still remaining, this will extend the roaming time to expire in 7 days.

When you return from your trip, you can return the license to the pool by running:
:<code>Analytica{{Release||5.4|64}}.exe /roam:-1</code>

This resets the roaming status, so that when you close Analytica, the license is returned to the managed pool of floating licenses.

::Notes: 
::* If you are using 32-bit Analytica, run <code>Analytica{{Release|5.5||32}}.exe</code> in place of <code>Analytica{{Release||5.4|64}}.exe</code> above.
::* Before executing the above commands in a <code>CMD</code> window, you will first need to change directory to your Analytica install directory, usually:
::*:<code>CD "C:\Program Files\Lumina\Analytica {{#svarget:anarelease|5.4}}"</code>

When you run Analytica without the /roam option (or with <code>/roam:0</code>), it continues using a roamed license but does not extend the roaming period.

If you are a notebook computer user, who will make use of roaming, we recommend setting up two new shortcuts on your start menu.  Place these in the '''Start &rarr; Programs &rarr; Analytica {{#svarget:anarelease|5.4}}''' menu:
* <code>Roam Analytica''' &rarr; ''runs: Analytica{{Release||5.4|64}}.exe /roam:7</code>
* <code>Unroam Analytica''' &rarr; ''runs: Analytica{{Release||5.4|64}}.exe /roam:-1</code>

From the start menu, you'll now have three ways to run Analytica.  You'll only use the roam option just prior to leaving on your trip, and the unroam shortcut once when you return.  You can, of course, specify however many days you'd like (instead of the 7 days demonstrated here).

=== Environment Variable method of roaming ===

An alternative method of controlling roaming is to set the environment variable <code>RLM_ROAM</code> prior to launching Analytica.  Note that you must actually launch Analytica after changing the environment variable to cause the roaming to occur.  The environment variable impacts all products that use the Reprise license manager, so if you use other non-[http://lumina.com Lumina] products that also use Reprise licenses, the same setting can be used for all.

:<code>set RLM_ROAM = 7</code>
:<code>Analytica{{Release||5.4|64}}.exe      ''&rarr; roams for 7 days''</code>
:<code>set RLM_ROAM =     ''&rarr; Unset it so it doesn't keep extending the horizon''</code>

:<code>set RLM_ROAM = -1</code>
:<code>Analytica{{Release||5.4|64}}.exe      ''&rarr; Unroams the license</code>

The <code>RLM_ROAM</code> environment variable is Reprise's standard method for controlling roaming, although as mentioned above, we think using shortcuts with a command line option is a more convenient method.

==History==
Introduced in [[Analytica 4.2]].

== See Also ==
* [[Installation and licenses]]
* Webinar on Analytica License Roaming: [http://WebinarArchive.analytica.com/License_roaming.wmv License_roaming.wmv]
* [[Configuring an RLM Server]]
* [[How to Install Analytica -- Centrally Managed License]]
* [[What License do I Purchase?]]