IBM Rational License Key Server, Version 8.1.3 readme file

Contents

1.0 About this release

1.1 New in this release

2.0 Installation information

2.1 Hardware requirements

2.2 Software requirements: Operating systems

2.3 Installation information

2.4 Update Instructions

2.5 Uninstalling Rational License Key Server

3.0 Known limitations, problems, and workarounds

4.0 IBM Rational Software Support

5.0 Notices and trademarks

1.0 About this release

This release contains updates for the version 8.1.3 release of IBM Rational® License Key Server. The daemon versions for this release are as follows: Rational License Key Server Version 8.1.3 is compatible with earlier versions of the client products that use Rational Common Licensing from earlier releases.

1.1 New in this release

2.0 Installation information

This section describes the installation requirements and specific installation instructions for this release. For more information about installing Rational License Key Server version 8.13, administering license servers, and license keys, see the IBM Rational Software Information Center..

2.1 Hardware requirements

There are no additional processor or memory requirements for installing this release.

2.2 Software requirements: Operating systems

To view the operating systems that IBM Rational License Key Server version 8.1.3 supports, go to http://publib.boulder.ibm.com/infocenter/prodguid/v1r0/clarity/osForProduct.html , and enter IBM Rational License Key Server in the search field. When the search has completed, select version 8.1.3 in the list and click Submit.

2.3 Installing Rational License Key Server, Version 8.1.3

Microsoft Windows operating systems.

Requirements for installing Rational License Key Server on Windows.
  • The Windows server must have a C:\drive.
  • You must have Windows administrator privileges on the local computer.

Use IBM Installation Manager to install the Rational License Key Server. Information about installation is available in the IBM Rational Software Information Center.

Note:
  1. You cannot upgrade from an earlier release of Rational License Key Server. If you have Rational® License Server 7.1 or earlier installed, you must uninstall the license server before installing Rational License Key Server 8 or later. You cannot upgrade license servers versions 7.1 or earlier to version 8 or later.
  2. Rational License Key Server version 8 or later cannot be on the same machine as IBM Rational Common License version 7.1 or earlier and IBM Rational License Server TL 2.0
  3. You can upgrade Rational License Key Server version 8.1.1 to versions 8.1.2 and 8.1.3.
To download Rational License Key Server on Windows:
  1. Go to Rational Support: Downloads and upgrades.
  2. Locate Rational License Key Server in the product name list, and then click Continue.
  3. Depending on how you purchased your software and your maintenance agreement, select a link to Passport Advantage® Online, IBM Software Group OEM portal, or the Rational Product Release area.
  4. Select Rational License Key Server Version 8.1.3 eAssembly and follow the instructions for download.
  5. Extract the compressed file in an appropriate directory. For example, choose to extract to C:\temp.
To install Rational License Key Server on Windows:
  1. Log in as a user with administrator rights on the local computer on which you want to install the product.
  2. Extract the installation files for Rational License Key Server. The extracted files are the repository for Rational License Key Server. The installation files include Installation Manager. You do not need to download Installation Manager separately. 
  3. Navigate to the //windows/disk1 directory.
  4. Double-click launchpad.exe. The IBM Rational License Key Server splash screen opens.
  5. Click IBM Rational License Key Server version to open the Installation Manager interface. Installation Manager is not installed.
  6. Select both Installation Manager and Rational License Key Server; then click Next.
    Note: The installation of Rational License Key Server requires Installation Manager to be installed.
  7. Click Next after the prerequisites are validated. To validate prerequisites again, click Recheck Status located in the lower right corner.
  8. Accept the license agreement; then click Next.
  9. For both the Shared Resources directory and Installation Manager directory locations, either accept the default value or enter a different directory location; then click Next.
    Important: You cannot change the location of the Shared Resources directory after Installation Manager is installed.
    The default values are as follows:
    • Shared Resources directory: C:\Program Files\IBM\IMShared
    • Installation Manager directory: C:\Program Files\IBM\Installation Manager\eclipse
  10. Accept the default installation directory for the license server or enter a different installation directory. The default installation directory is: C:\Program Files\IBM\RationalRLKS.
  11. Select additional languages to install; then click Next.
  12. Review the features to install; then click Next.
  13. Click Install.
  14. Click Finish.
Note: Install the floating license keys on the license server before you start the license server. Go to the Rational® License Key Center to order your permanent license keys. See Use the IBM Rational License Key Center to obtain license keys for more information about the Rational License Key Center.

License files that you use with Rational Common Licensing versions 7.1.x and earlier or IBM Rational License Server TL version 2.0 must be migrated to the Rational Common Licensing version 8.1.3 required format. The format requires: VENDOR ibmratl as the vendor line. You can use the License Migration Utility to migrate the license files. The utility is included with Rational Common Licensing version 8.1.3.

To migrate license files on Windows:

  1. At a command prompt, go to the Rational Common Licensing common directory. The default location for the common directory is: C:\Program Files\IBM\RationalRLKS\common.
  2. Run the licmigrationutil.cmd command.
  3. Enter the path to the license file. You must include the license file name in the path.
  4. Press Enter. The license file is updated.

UNIX platforms.

Requirements for installing Rational License Key Server on UNIX platforms:

You must have your license key file when you install the IBM Rational License Key Server. Go to the Rational® License Key Center to order your permanent license keys. See Use the IBM Rational License Key Center to obtain license keys for more information about the Rational License Key Center.

The Rational License Key Center sends the license file to an email account when you request a license. The name of the license file has this format: license_for_server.upd. You must have the license file filename.upd stored in a known location, such as the $HOME directory, on the license server.

You do not have to install the license server as root. If you do install the server as root, you will receive a message that indicates a possible security risk during the installation process. Attempts could be made to access the lmgrd process through its TCP/IP port and run other programs with root permissions.

Use IBM Installation Manager to install the Rational License Key Server. Information about installation is available in the IBM Rational Software Information Center .

To download Rational License Key Server on UNIX platforms:
  1. Go to the IBM site for Rational Support: Downloads and upgrades.
  2. Locate Rational License Key Server in the product name list, and then click Continue.
  3. Depending on how you purchased your software and your maintenance agreement, select a link to Passport Advantage Online, IBM Software Group OEM portal, or the Rational Product Release area.
  4. Select Rational License Key Server Version 8.1.3 eAssembly and follow the instructions for download.
  5. Extract the compressed file in an appropriate directory.
To install Rational License Key Server on UNIX platforms:
  1. Navigate to the disk1 directory.
  2. Extract the installation files for Rational License Key Server. The extracted files are the repository for Rational License Key Server. The installation files include Installation Manager. You do not need to download Installation Manager separately.
  3. Run launchpad.sh. The IBM Rational License Key Server splash screen opens.
  4. Click IBM Rational License Key Server version to open the Installation Manager interface. Installation Manager is not yet installed.
  5. Select both Installation Manager and Rational License Key Server; then click Next.
    Note: The installation of Rational License Key Server requires Installation Manager to be installed.
  6. After the prerequisites are validated, click Next. To validate prerequisites again, click Recheck Status located in the lower-right corner. Four validation checks occur automatically during the prerequisite step:
    • A check that all applications are closed and that your antivirus software is disabled.
    • A check on whether you are installing as a root user. If you install as a root user, you will receive a warning message. Click Show Details to receive more information and instructions on next steps.
    • A check on whether earlier versions of Rational or Telelogic license key servers are installed. If older versions are installed, you will receive a warning message. Click Show Details to receive more information and instructions on next steps.
    • A check on whether earlier versions of Rational or Telelogic license key servers are running. If older versions are running, you will receive a warning message. Click Show Details to receive more information and instructions on next steps.
  7. Accept the license agreement; then click Next.
  8. For both the Shared Resources directory and Installation Manager directory locations, either accept the default value or enter a different directory location; then click Next.
    Important: You cannot change the location of the Shared Resources directory after Installation Manager is installed.
    The default values are as follows:
    • Shared Resources directory: /opt/IBM/IBMIM
    • Installation Manager directory: /opt/IBM/Installation Manager/eclipse
  9. Accept the default installation directory for the license server or enter a different installation directory. The default installation directory is: /opt/IBM/RationalRLKS.
  10. Select additional languages to install; then click Next.
  11. Review the features to install; then click Next.
  12. Enter the absolute path to the license file and the port number for the license server; then click Next.
    Note: Two validation checks occur during the configuration step. If you have entered an invalid license file, you receive an error message at the top of the page. If you enter an invalid port number, you receive an error message at the top of the page.
  13. Click Install.
  14. Click Finish.
Note: License files used with Rational Common Licensing versions 7.1.x and earlier or IBM Rational License Server TL version 2.0 must be migrated to the Rational Common Licensing version 8.1.3 required format. The format requires VENDOR ibmratl as the vendor line. You can use the License Migration Utility to migrate the license files. The utility is included with Rational Common Licensing version 8.1.3.
To migrate license files on UNIX platforms:
  1. At a command prompt, go to the Rational Common Licensing common directory. The default location for the common directory is: install_dir/config/migrationutility.
  2. Run the ./licmigrationutil.sh command.
  3. Enter the path to the license file. You must include the license file name in the path.
  4. Press Enter. The license file is updated.

2.4 Updating Rational License Key Server, Version 8.1.3

Windows .
  1. Log in as a user with administrator rights on the local computer on which you intend to update Rational License Key Server.
  2. Extract the installation files for Rational License Key Server. The extracted files are the repository for Rational License Key Server.
  3. Navigate to the disk1 directory.
  4. Double-click launchpad.exe. The IBM Rational License Key Server splash screen opens.
  5. Click Install or Update IBM Rational License Key Server to open the Installation Manager interface. Installation Manager opens.
  6. Click Update.
  7. Select the package group for IBM Rational License Key Server; then click Next.
  8. Verify that Version 8.1.3 is selected; then click Next.
  9. Click Next after the prerequisites are validated. To validate prerequisites again, click Recheck Status located in the lower-right corner.
  10. Accept the license agreement; then click Next.
  11. Review the features to install; then click Next.
  12. Review the summary information; then click Update.
  13. Click Finish.

2.5 Uninstalling Rational License Key Server

To uninstall:
  1. Open IBM Installation Manager.
  2. Click Uninstall.
  3. Select IBM Rational License Key Server version.
  4. Click Next.
  5. Click Uninstall.

3.0 Known limitations, problems, and workarounds

Known problems are recorded in individual documents in the Support knowledge base. As problems are discovered and resolved, the knowledge base is updated and maintained with new information. By searching the knowledge base, you can quickly find workarounds or solutions to problems. To learn about the known limitations and problems in this update, and any workarounds that are available, see:

http://www.ibm.com/support/search.wss?q=license+server+RN8.1.3

4.0 IBM Rational Software Support

IBM Software Support for Rational products provides you with technical assistance. For contact information and guidelines or reference materials that you need when you require support, read the IBM Software Support Handbook. For FAQs, lists of know problems and fixes, and other support information, visit the IBM Rational Software Support website. For Rational software product news, events, and other information, visit the IBM Rational Software website. Before you contact Rational Software Support, gather the background information that you need to describe your problem. When describing a problem to an IBM software support specialist, be as specific as possible and include all relevant background information so that the specialist can help you solve the problem efficiently. To save time, know the answers to these questions:
  • What software versions were you running when the problem occurred?
  • Do you have logs, traces, or messages that are related to the problem?
  • Can you reproduce the problem? If so, what steps do you take to reproduce it?
  • Is there a workaround for the problem? If so, be prepared to describe the workaround.

5.0 Notices and trademarks

© Copyright IBM Corporation 2004, 2012. U.S. Government Users Restricted Rights - Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.

This information was developed for products and services offered in the U.S.A.

IBM may not offer the products, services, or features discussed in this document in other countries. Consult your local IBM representative for information on the products and services currently available in your area. Any reference to an IBM product, program, or service is not intended to state or imply that only that IBM product, program, or service may be used. Any functionally equivalent product, program, or service that does not infringe any IBM intellectual property right may be used instead. However, it is the user's responsibility to evaluate and verify the operation of any non-IBM product, program, or service. IBM may have patents or pending patent applications covering subject matter described in this document. The furnishing of this document does not grant you any license to these patents. You can send license inquiries, in writing, to:

IBM Director of Licensing IBM Corporation North Castle Drive Armonk, NY 10504-1785 U.S.A.

For license inquiries regarding double-byte character set (DBCS) information, contact the IBM Intellectual Property Department in your country or send inquiries, in writing, to:

Intellectual Property Licensing Legal and Intellectual Property Law IBM Japan, Ltd. 1623-14, Shimotsuruma, Yamato-shi Kanagawa 242-8502 Japan

The following paragraph does not apply to the United Kingdom or any other country where such provisions are inconsistent with local law: INTERNATIONAL BUSINESS MACHINES CORPORATION PROVIDES THIS PUBLICATION "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. Some states do not allow disclaimer of express or implied warranties in certain transactions, therefore, this statement may not apply to you.

This information could include technical inaccuracies or typographical errors. Changes are periodically made to the information herein; these changes will be incorporated in new editions of the publication. IBM may make improvements and/or changes in the product(s) and/or the program(s) described in this publication at any time without notice.

Any references in this information to non-IBM websites are provided for convenience only and do not in any manner serve as an endorsement of those websites. The materials at those websites are not part of the materials for this IBM product and use of those websites is at your own risk.

IBM may use or distribute any of the information you supply in any way it believes appropriate without incurring any obligation to you.

Licensees of this program who wish to have information about it for the purpose of enabling: (i) the exchange of information between independently created programs and other programs (including this one) and (ii) the mutual use of the information which has been exchanged, should contact:

Intellectual Property Dept. for Rational Software IBM Corporation 5 Technology Park Drive Westford, MA 01886 U.S.A.

Such information may be available, subject to appropriate terms and conditions, including in some cases, payment of a fee.

The licensed program described in this document and all licensed material available for it are provided by IBM under terms of the IBM Customer Agreement, IBM International Program License Agreement or any equivalent agreement between us.

Any performance data contained herein was determined in a controlled environment. Therefore, the results obtained in other operating environments may vary significantly. Some measurements may have been made on development-level systems and there is no guarantee that these measurements will be the same on generally available systems. Furthermore, some measurements may have been estimated through extrapolation. Actual results may vary. Users of this document should verify the applicable data for their specific environment.

Information concerning non-IBM products was obtained from the suppliers of those products, their published announcements or other publicly available sources. IBM has not tested those products and cannot confirm the accuracy of performance, compatibility or any other claims related to non-IBM products. Questions on the capabilities of non-IBM products should be addressed to the suppliers of those products.

All statements regarding IBM's future direction or intent are subject to change or withdrawal without notice, and represent goals and objectives only.

IBM, the IBM logo, and ibm.com® are trademarks or registered trademarks of International Business Machines Corp., registered in many jurisdictions worldwide. Other product and service names might be trademarks of IBM or other companies. A current list of IBM trademarks is available on the web at www.ibm.com/legal/copytrade.shtml.

Linux is a registered trademark of Linus Torvalds in the United States, other countries, or both. Microsoft and Windows are trademarks of Microsoft Corporation in the United States, other countries, or both. UNIX is a registered trademark of The Open Group in the United States and other countries.