Enabling License Management

AccuRev license management is enabled automatically after a successful AccuRev installation. In some instances, however, you might want to adjust the default license settings, and AccuRev and RLM server configurations, so that they are appropriate for your environment. This and the following sections describe how to accomplish these tasks.

License, Configuration, and Options Files

This section describes three files related to AccuRev license management:

•	accurev.lic (the AccuRev license file)

•	acserver.cnf (the AccuRev server configuration file)

•	accurev.opt (the ISV options file)

Generally speaking, you do not need to modify any of these files, but this section describes common modifications -- such as changing the listener port or extending the minimum check-out period -- and how to perform them.

The accurev.lic License file

The AccuRev license file, accurev.lic, is a simple text file that you receive from AccuRev when you purchase your licenses. This file is typically located in the \storage\site_slice directory where you installed AccuRev. For example: C:\Program Files (x86)\AccuRev\storage\site_slice\accurev.lic.

The first line of the accurev.lic file specifies the port that the RLM server is listening on. For example:

HOST localhost ANY 2375

Its default value is 2375. You can change this port if necessary. See Changing the RLM Listener Port Value on page 124 for more information.

For additional information about where to place the accurev.lic file and any edits that you may need to make to it, see the AccuRev Installation and Release Notes and the instructions that you receive with the license file.

The acserver.cnf Configuration File

The acserver.cnf file is a configuration file that is generated during installation. It is typically located in the bin directory where you installed AccuRev. For example:
C:\Program Files (x86)\AccuRev\bin\acserver.cnf.

The LICENSE_PORT value identifies the port on which the RLM server is listening. For example:

LICENSE_PORT = 2375

Its default value is 2375, the same as the port value on the HOST line in the accurev.lic file.

Note: The acserver.cnf LICENSE_PORT for RLM differs from the existing AccuRev PORT value (default value 5050), which clients use to connect to the AccuRev host.

ISV options and accurev.opt

RLM provides the ability to define an “ISV options” file that allows you to adjust certain parameters, such as extending the idle time allowed before a license gets checked back in, or maintaining a list of users who are prevented from obtaining a license. By default, AccuRev installs an ISV options files named accurev.opt in the same folder as the license manager executable (rlm.exe), typically
<ac-install>/rlm (where <ac-install> is your AccuRev installation directory). This file has a time-out setting line “TIMEOUT 120”, to enable automatic idle license check-in.

A common modification of this file is to reserve licenses for specific users so that they stay checked out beyond the usual expiration period.

For example, if a principal developer with the user name “jsmith” is working on an important project and requires special access to a dedicated license, if you are an administrator you can specify a RESERVE line in the accurev.opt file such as:

RESERVE 1 accurev-ent user jsmith

Note: Make sure not to accidentally modify the existing “TIMEOUT 120” when you edit accurev.opt.

For more information about ISV files, see the RLM documentation referenced in Additional RLM Documentation on page 127.

Changing the RLM Listener Port Value

If you need to change the value of the port on which the RLM server is listening, you must change the value in both the HOST line in the accurev.lic file and the LICENSE_PORT line in the acserver.cnf file as described here:

1.	Change the value at the end of the HOST line in the accurev.lic file (the value that follows ANY).

2.	Change the LICENSE_PORT in the acserver.cnf file to the same value.

3.	Stop the AccuRev Server. See Stopping and Starting the AccuRev and RLM Servers on page 128 if you need help with this step.

4.	Stop and restart the RLM Server. See Stopping and Starting the AccuRev and RLM Servers on page 128 if you need help with this step.

5.	Restart the AccuRev Server. See Stopping and Starting the AccuRev and RLM Servers on page 128 if you need help with this step.

Accessing the RLM Web Interface

The RLM Web Interface allows you to perform administrative tasks such monitoring RLM server status, shutting down and starting up the RLM server, and changing the RLM Web Interface password.

To access the RLM Web Interface, point your web browser to port 5054 on the license server machine. For example:

http://<license_server_machine>:5054

If you are logged into the license server machine, you can use localhost instead of the server name.

Tip: The RLM Web Interface works best with Microsoft Internet Explorer. Not all features of the RLM Web Interface, notably, setting the username/password, are supported in other web browsers.

See the RLM License Administration Manual for more information on features of the RLM Web Interface. (See Additional RLM Documentation on page 127.)

Password Required by Default

When you access the RLM Web Interface, you are prompted for a username/password to authenticate yourself with the RLM server. The default username/password values are admin/admin. AccuRev recommends that you change them.

Note: AccuRev recommends that you change the default username/password authentication credentials and carefully consider granting access to others.

Changing the RLM Password

To change the default password:

1.	Log in to the web interface as user admin.

2.	Select the Change Password menu item, and enter a new password.

Passwords cannot contain the colon character (:).

3.	When you save your changes, the password is encrypted and written to the rlm.pw password file located in the rlm directory where you installed AccuRev.

Note: Do not enter or change the RLM password directly in the rlm.pw password file.

Suppressing Authentication

If you wish, you can suppress authentication by removing (or renaming) the rlm.pw password file from the rlm directory where you installed AccuRev. If this file is not present in the rlm directory when a user attempts to access the RLM Web Interface, no authentication is required.

The rlm.pw password file can also be used to grant and restrict access to the RLM server. See Specifying RLM Privileges on page 125 for more information.

Note: AccuRev recommends that you retain RLM Web Interface authentication.

Specifying RLM Privileges

In addition to controlling access to RLM using authentication, you can also specify privileges for each user to whom you grant access using the rlm.pw file. Privileges are summarized in the following table. See Additional RLM Documentation on page 127.

Table 1. Summary of RLM User Privileges

Privilege Name	Description
all	Special privilege name, enables all privileges
edit_meter*	Allows modifying count for meter counters
edit_options*	Allows editing options files for ISV servers
edit_rlm_options*	Allows editing license files and options files for the rlm server
edit_xfer*	Allows editing server-server license transfer settings for ISV servers
logfiles	Enables the functions which change log files - switch, switchr, newlog
remove*	Allows the user to remove a license from a running process
reread	Allows access to the functions which do reread commands on license servers
shutdown*	Allows access to the functions which shut down license servers
status	Allows display of status and debug log information from the license servers

*Enable “status” privilege even if not explicitly set.

Format of the rlm.pw File

Each line in the rlm.pw file corresponds to one user and has the following format:

<username>:<password>:<list-of-privileges>

For example:

tom:$5ukMApW1jixwcrGqRALO91:all

harry::edit_options,edit_rlm_options,reread

In this example, Tom has a password (it is encrypted when it is created) and his privileges are set to all. Harry has no password; his privileges are edit_options, edit_rlm_options, and reread.

How to Specify RLM Privileges

To specify RLM privileges:

1.	Open the rlm.pw file in the rlm directory where you installed AccuRev.

2.	Enter privileges for the desired user in a comma-separated list.

Note: Do not enter or change the RLM password directly in the rlm.pw password file.

3.	Save and close the file.

Note: A user with no privileges assigned will have access to the following menu items in the RLM Web Interface: "Activate License", "Diagnostics", "RLM Manual...", "System Info", "About", "Change Password", and "Logout".