24.2 Setting Up a License Server

The task of setting up a host to be a license server host is part of the overall ClearCase installation process. Initial license server setup is described in the Installation Guide for the ClearCase Product Family.

NOTE: If you are using a Windows computer to serve ClearCase licenses for both UNIX and Windows, the Windows license server host must be a member of a domain in which user accounts are defined for all UNIX users who will acquire licenses from this server. See Managing User Accounts for more about matching UNIX and Windows user account names.

Adding New Licenses to an Existing License Server Host

Some organizations purchase an initial set of ClearCase licenses and purchase additional licenses later. Each time a new set of licenses is purchased, you receive a text line containing the new license authorization code from Rational.

1. Determine the host name of the license server host. If you do not know the name of the license server host, you can find out from any ClearCase client host.

• On a UNIX client host, examine the contents of the license_host file.

cat /var/adm/atria/config/license_host
fermi

• On a Windows host, click Start > Settings > Control Panel, and then start the ClearCase program. Click the Licensing tab to display the name of the license server host.

2. Log on to the license server host. Log on as root on a UNIX host or as a local administrator on a Windows host.

3. Add the licenses. On UNIX, you can use any text editor to append the license strings to the end of the license_db file. Be sure to enter this line exactly as it appears on the fax from Rational.

On a Windows host, click Start > Settings > Control Panel, and then start the ClearCase program. Click the Licensing tab, and select the The local system can act as a license server check box. Enter the license key exactly as it appears on the fax from into the License Keys box. Click Apply or OK.

Setting Up Additional License Server Hosts

When you purchase a new set of ClearCase licenses, you can place them on another host, rather than adding them to the existing license server host. Having two or more license server hosts provides a redundant source of licenses.

NOTE: You must make this decision before you send the ClearCase Product Family License Registration Form to Rational; you must include the machine ID of the intended license server host on this form.

To set up a new license server host:

1. Determine the machine ID of the new license server host. You can use the clearlicense command:

clearlicense -hostid
XXXYYYZZZ	(architecture-dependent machine-ID string)




(If you need to determine the machine ID of a host on which ClearCase is not yet installed, follow the instructions on the License Registration Form to determine the machine ID.)

On a Windows host, click Start > Settings > Control Panel, and then start the ClearCase program. Click the Licensing tab to display the licensing host ID.

2. Fill out the ClearCase Product Family License Registration Form. A copy of this form appears at the back of the Installation Guide for Rational ClearCase and ClearCase MultiSite. Fax the form to Rational and wait for a return fax that lists your license authorization code.

3. Log on to the new license server host. Log on as root on a UNIX host or as a local administrator on a Windows host.

4. Add licenses to the new host's license database. On UNIX, you can use cat to append the license strings to the end of the license_db file:

# cat >> /var/adm/atria/license.db
-license ClearCase sun *.19 19960419 xxxxx.yyyyy.zzzzz
<CTRL+D>

Or you can use any text editor. Be sure to enter this line exactly as it appears on the fax from .

On a Windows host, click Start > Settings > Control Panel, and then start the ClearCase program. Click the Licensing tab and select the The local system can act as a license server check box. Enter the license key exactly as it appears on the fax from Rational into the License Keys box. Click Apply or OK.

5. Stop and restart ClearCase on the license server host.

6. Reconfigure ClearCase client hosts to use the new license server host. On UNIX hosts, edit /var/adm/atria/config/license_host to contain the name of the new license server host. On a Windows host, click Start > Settings > Control Panel, and then start the ClearCase program. Click the Licensing tab and enter the new license server's name in the Hostname of the license server box. Click OK.

You can also use the ClearCase Administration Console to change the license server used by any ClearCase host in your network:

• Go to the host node for the host whose license server you want to change. This can be the My Host node or a subnode of the ClearCase Network node in ClearCase Administration Console, or the top-level node in ClearCase Host Administration.

• Click Action > Properties. This command opens a dialog box in which you can change the host's license server. To change the license server for a remote host, the host must be configured to allow remote administration, and you must be a member of the ClearCase administrators group.