Using "Getting Started with Rational Software"

The "Getting Started with Rational Software" web pages provide step-by-step instructions, examples, and graphics for obtaining and installing Rational license keys. Find "Getting Started with Rational Software" at www.rational.com. Click Support > Support Services > Getting Started.

---

Obtaining Licenses

AccountLink (http://www.rational.com/accountlink) is a Web tool that you can use to manage your permanent (or Term License Agreement) license keys. To use AccountLink, you need the License Key Certificate (included in your product shipment) to order and install your license keys. AccountLink's interface offers three license transactions:

1 . Get License Key(s) - Order your permanent license key by registering Rose to a specific system. To order a permanent license key, you need your Rational License Key Certificate and the hostid of the license server or client system.

You can register :

• Rose, that will be served from a Rational license server.
• Single, multiple, or redundant Rational license server's.
• Remote systems; you do not need to sit at the system you are requesting license keys for.

To order permanent license keys for a redundant server environment, specify the redundant server's hostids in the following order:

a . Primary license server

b . Secondary license server

c . Tertiary (Backup) license server

The client systems communicate with the redundant server's in that order.

Returning and Moving License Key(s) - Return the existing license key to your Rational account and then order a license key for the new system. This adjusts the count of registered products in your account and allows you to get the license key for the new system.

Returning License Keys

When you return a license key from a registered system, you do not physically give the license key back to Rational. Instead, you use the return transaction in AccountLink. This transaction updates Rationals records to indicate that you are no longer using Rose on that system. This adjusts the count of registered products in your account. After AccountLink makes the adjustments to your account, Rational sends you a license key file that contains updated license keys. If you have returned all the license keys for a system, the updated license file is empty. To comply with your License Agreement, import this updated license file (whether it is empty or not) on the system.

To return a license key:

1 . Use AccountLink to return the license keys to your Rational account.

2 . To complete the return process, import the license key update file that you receive from AccountLink on the license server or node-locked system from which you returned the license key.

Moving License Keys

If you want to move Rose to a new system, return the existing license keys from the old system to your Rational account. Then order license keys for the new system.

To move license keys from one system to another:

1 . Use AccountLink to return the license keys to your Rational account.

Note: To help prevent you from confusing the license key update file for the old system with the license key file for the new system, you may want to complete the return process before you order license keys for the new system.

2 . Import the updated license key file that you receive from AccountLink on the old system.

3 . Remove Rose or license server software from the old system.

4 . Install Rose or license server software on the new system.

5 . Request new license keys for the new system in AccountLink.

6 . Import the license key file on the new system.

7 . If you moved the license keys to a new license server, give users the name of the new license server.

Request a Copy of a License File - Get a copy of a license key file for any system that has license keys already registered to it. You will need this transaction when, you need to restore the software on your system, or your license keys become corrupt. It does not require you to return or add license keys.

With these three transactions, you can order and return permanent license keys for Rose from single or multiple Rational accounts.

Note: AccountLink does not support temporary license key transactions.

If you are not at the computer for which you are requesting license keys, you must have the following information available: hostname and hostid. If you do not know the FLEXlm Host ID (lmhostid) of your license server, run the tool gethostinfo.sh located in the CD-ROM extras/license directory. This tool is also available (and, may be downloaded) from AccountLink.

Receiving and Importing License Keys

After you register Rose to a specific system with AccountLink, Rational generates a license key file that contains the license key. The file is sent in an e-mail message to the contact e-mail address that you designate in AccountLink's License Contact page. You need to save the file to a known directory location as you will need to provide this information when you install the Rational software.

Note: If AccountLink is unavailable, see Requesting License Keys by Fax or call Rational Licensing Support. See Contacting Rational Technical Support for Support phone numbers.

Requesting License Keys by Fax

This section summarizes the steps for getting a node-locked or floating permanent license key when you do not have an internet connection or when Rational AccountLink is unavailable. Although this section gives customers instructions for obtaining license keys by fax, Rational recommends that you use Rational AccountLink (www.rational.com/accountlink) to request permanent license keys.

1 . Find your License Key Certificate in your Rational product shipment.

2 . Print the license request form.

The documentation browser can be used directly from the CD-ROM and from the installed product area. To view the form directly from the CD-ROM, run the command rs_help from the CD-ROM root directory.

3 . Use the License Key Certificate to fill out the form. Make sure that the contact, Rational account number, product, licensing, and host information are correct. Any errors will cause delays in receiving your license keys.

Note: If you are requesting a node-locked license, be sure to select NodeLocked UNIX.

4 . Fax the request to Rational. See Contacting Rational Licensing Technical Support for fax and phone numbers.

Call Rational Licensing Support if you cannot use Rational AccountLink or the fax form to order your permanent license keys. See Contacting Rational Licensing Technical Support for phone numbers.

Receiving Permanent License Keys

If you request a new license using AccountLink, Rational will send you a license key file through e-mail. If you request a permanent license key by fax and you have specified an e-mail address in your contact information, you will receive a license key file through e-mail. You can copy the permanent license file from the e-mail enabled system and install it on the system that is not e-mail enabled. If you cannot provide an e-mail address, contact Rational Licensing Support. See Contacting Rational Licensing Technical Support for the phone numbers.

Converting a Temporary License to a Permanent License

If you initially used a temporary license (evaluation or startup) to install Rose, you can convert your license to a permanent license by using the license_setup command. The license_setup command allows you to run a subset of the install script, rs_install. The license_setup command allows you to set up license options and run the license check sequence. You may also do this by running rs_install; however, using license_setup will save you time as there is no need to run through a full product installation or any of the post product installation setup. You need to have a permanent or TLA license before you start. See Requesting License Keys by Fax .

---

User-Based Licenses

User-based licenses are not supported in this release.

---

Frequently Asked Questions

• Can I use the Flex licensing software I already have installed?

  Yes. Install our license code in the default location (in rational_dir/base/cots) and use it to serve the Rational licenses.

  Use a common rational_dir for all Rational products. Exception: only one architecture of each Rose release may be installed in one rational_dir. For example, if the Sun Solaris Rose release is installed in the rational_dir, you may not install the Rose release for HP-UX 10.20 in the same rational_dir. You may however install HP-UX 10.20 and HP-UX 11.00 in the same rational_dir.

  No room? Create a link for a product to some other file system and install through the link. For example, to put Rose on some other big filesystem, do:

  cd rational_dir/releases

  mkdir /bigfs/rose.I.J.K

  ln -s /bigfs/rose.I.J.K rose.I.J.K

• I already have FLEXlm installed and managing non-Rational licenses, and now I want to install Rose for UNIX/Linux. Can I do this?

  Yes. You can have more than one lmgrd on a computer, but they must use different ports. You can only have one rational daemon on the computer.

  a . What do I do if my existing FLEXlm installation uses port 27000?

  27000 is the default port, so you need to specify a different port number for Rose 2002. This is done in the rs_install menu 4) Server and License File Settings.... Choose the next consecutive available port number such as 27001.

  b . What do I do if my existing FLEXlm installation uses a port other than 27000?

  You don't have to do anything since rs_install will default to port 27000. If you are using the same server for other Rational products, you must specify the port number you are using.

• What should I do if my vendor daemon dies with Status 39 when I try to start the license manager on my Sun computer?

  This is a file descriptor problem, and is corrected in FLEXlm 6.1b. To work around this issue, start lmgrd in a shell script, i.e.

  #/bin/sh
  ulimit -H -n 1024 lmgrd ...

• I already have DevelopmentStudio for UNIX installed, with FLEXlm serving DevelopmentStudio licenses. What do I need to do to install Rose 2002?

  You can use rs_install to setup Rose licenses. If you point rs_install at an existing license file, it will get backed up to license_file.priorN (N starts at 1 and counts up to the next available prior file) and the new license file is created. The rs_install program appends every license in the backup file that is not in the new license file.

• Can I use the FLEXlm redundant license server feature?

  If you want to use the FLEXlm redundant license server feature, then you should contact Rational Technical Support. See Preface for additional information.

---

FLEXlm User Guide

An HTML version of the FLEXlm User Guide is provided in the docs directory and at http://www.globetrotter.com/manual.htm.

Additional information on FLEXlm can be found at http://www.globetrotter.com/lmfaq.htm.