IBM Support

Rational License Key Server Administration and Reporting Tool (ART) and Administration Agent Refresh Pack 2 (8.1.5.2) for Version 8.1.5

Download


Abstract

Refresh Pack 2 for Version 8.1.5 has been made generally available and contains improvements/enhancements to version 8.1.5.

Download Description

Table of Contents
Sections Description

The Change history section provides an overview on what is new in this release with a description of any new functions or enhancements when applicable.

The How critical is this fix section provides information related to the impact of this release to allow you to assess how your environment may be affected.

The Prerequisites section provides important information to review prior to the installation of this release.

The Download package section provides the direct link to obtain the download package for installation in your environment.

The Installation instructions section provides the installation instructions necessary to apply this release into your environment.

The Known side effects section contains a list of known issues identified at the time of this release.

Supporting Documentation
Document Description

Click to review the detailed system requirements information for a complete list of hardware requirements, supported operating systems, prerequisites and optional supported software, with component-level details and operating system restrictions.

IBM Knowledge Center provides an entry point to product documentation. You can view, browse, and search online information related to the product.

Click to review a complete list of the defects (APARs) resolved in this release including a list of resolved defects for the entire version family.

For fixes for security vulnerabilities, see Security Bulletin.

Prerequisites

Attention: Rational License Key Server Administration and Reporting Tool (ART) and IBM Rational License Key Server Administration Agent MUST BE CONFIGURED according to the following hardware and software specifications. Otherwise, failure may occur during license administration and usage reporting.

Prerequisites include:

Version of IBM Installation Manager required: http://www-01.ibm.com/support/docview.wss?uid=swg24043138 IBM Installation Manager 1.8.6.

Additional notes: Upgrade the agent and ART to version 8.1.5.2. to obtain the RFE and improvements that are included in this release.

Important: If you are upgrading ART from version 8.1.5 to 8.1.5.2, you must upgrade the ART component first, before you upgrade the agent.

However, if you are currently using ART version 8.1.4.4 or later, you can upgrade to version 8.1.5.2. using the IBM Installation Manager Update option.

Data backup and upgrade

When you upgrade from version 8.1.4.9 or earlier, the installer automatically creates a backup of your license usage data. However, if you prefer to create your own backup, copy this directory: RLKSAdmin/server/conf/lqe.

Hardware requirements

Rational License Key Server Administration and Reporting Tool

  • Memory: 16 GB RAM
  • Disk space: 100 GB

Rational License Key Server Administration Agent

  • Memory: 8 GB RAM
  • Disk space: 50 GB

Software requirements

Web browser requirement for Rational License Key Server Administration and Reporting Tool

  • Mozilla Firefox: 10 ESR and future fix packs
  • Internet Explorer: Version 11
    Important: Switch to Standard View by clicking Tools > Developer tools to work with ART. Internet Explorer does not render ART properly in Compatibility View.

Rational License Key Server Administration and Reporting Tool

  • Rational License Key Server: version 8.1.2, 8.1.3, 8.1.4, or 8.1.5
    Note: ART does not support Rational License Key Server 8.1.1
  • Jazz team server version 4.0.1 and later
  • Operating systems: ONLY 64-BIT OPERATING SYSTEMS ARE SUPPORTED

Rational License Key Server Administration Agent

  • Installation prerequisite: The Server Administration Agent MUST BE COLLOCATED with the license server.
  • Operating Systems: All operating systems supported by Rational License Key Server (version 8.1.2 and later versions) and the IBM solution for Collaborative Lifecycle Management (version 4.0.1 and later versions) server.

Other

Special characters supported by reports

  • For a list of special characters that are supported by reports in ART, see the technical document.

Installation Instructions

Before you proceed with the installation of the Rational License Key Server for 8.1.5.2, ensure that you have met all prerequisites.
Installation Instructions for upgrading the Rational License Key Server Agent
----------------------------------------------------------------------------------------------------------

  1. From IBM Fix Central, download the Rational License Key Server for 8.1.5.2 .zip media files.
  2. Create a temporary directory (for example, ../8152) and extract the downloaded zip into this directory.
  3. Launch Installation Manager in wizard or console mode.
  4. In Installation Manager, click File->Preferences->Repositories and add 8152\RLKS_ADMIN_AGENT\disk1\diskTag.inf as a repository.
  5. Click Apply and OK.
  6. Click Update.
  7. Select the Installation Manager package. The default is IBM RLKS Administration Agent, which contains the RLKS Agent version 8.1.5.2.
  8. Click Next.
  9. Select IBM Rational License Key Server Administration Agent 8.1.5.2 and complete the upgrade.

Installation Instructions for upgrading the Rational License Key Server Administration and Reporting Tool
---------------------------------------------------------------------------------------------------------------------------------

  1. In Installation Manager, click File->Preferences->Repositories and add 8152\RLKS_ADMIN\disk1\diskTag.inf as a repository.
  2. Click Apply and OK.
  3. Click Update.
  4. Select the Installation Manager package. The default is IBM RLKS Administration and Reporting Tool, which contains the RLKS Administration and Reporting Tool version 8.1.5.2.
  5. Click Next.
  6. Select IBM Rational License Key Server Administration and Reporting Tool 8.1.5.2 and complete the upgrade.

Download Package

The following sections provide detailed information related to this release.

Click the FC link below to obtain the release from Fix Central.


How critical is this fix?

Impact Assessment
Impact Description

This is an release of Rational License Key Server 8.1.5.2. It contains critical fixes and enhancements to Rational License Key Server Administration and Reporting Tool and Administration Agent.

Test Results

Definitions

Regression: An error in the Maintenance Delivery Vehicle (MDV) that produces incorrect or unexpected behavior causing a supported feature to stop functioning as designed.
This includes:

  • Coding errors that cause a regression
  • Documentation or packaging problems that cause a regression
  • Errors reported in a new function delivered in a MDV that cause a regression

Incomplete: An error in the MDV has not regressed, but does not work as designed.
This includes:

  • Fixed APARs which did not solve the original problem but did not break anything new
  • APARs reporting documentation errors, such as readme errors, that cause problems applying an MDV but do not lead to a regression


Notes:
  • Regression and incomplete APARs are considered fix-in-error or MDV-in-error
  • Definitions above apply only to valid APARs that result in product fixes (APARs returned as working-as-designed are not assessed for being fix-in-error)
  • Issues in major releases due to new functionality do not apply in this definition

There are no known regressions to report.

Problems Solved

Defects resolved

Click the Fix List link in the table of contents above to review a list of the problems solved in this release.

Known Side Effects

The following are known limitations in this release:

  1. For the scenarios with a charge back group where duplicate users have different cases. If you generate a group based charge back report with this group and the user name case sensitivity is Off, the information in the report for such duplicate users generates incorrectly.
  2. The Administration Agent fix for handling frequent license server restarts, does not handle the following scenarios:
    • Cannot correct the inaccuracies originating due to historical data.
    • If the license server is down for any reason while the hourly conversion occurs, the data generated is inaccurate.
  3. For "Rational Rhapsody Architect for Software" and "Rational Rhapsody Tool & Utilities" products, you may see a difference of token counts between the token value and the user based reports. Because of this difference the license hours in user based report cannot be matched with the product usage hours in the token value report.
  4. The data displayed in "License Hours" column for user based report and "Product Usage Hours" column for token value report for the same set of parameters may be inaccurate. This inaccuracy arises when the products are CLMs and a user has re-attempted the login after a web session timeout.
  5.  Suppose a user exists in LDAP with an ID user1, Rational License Key Server Administration and Reporting Tool V8.1.4.9. is configured to work with this LDAP server. If the user logs in with some case-variant of the ID user1 e.g. User1 or USER1, you cannot retain the data that belongs to particular user when you are upgrading to Rational License Key Server Administration and Reporting Tool V8.1.5 or higher.

Open defects

Review the following list of open defects for Rational License Key Server on the IBM Support Portal.

Review technote 1461170: Open APARs for Rational products available on the Web for information on how to configure your MyNotifications subscription account and subscribe to the APARs you are interested in following.

Change History

What's new



  • All the validations used on the LDAP configuration page have been revised to provide more uniform and better user experience. The messages displayed on the UI appear exactly the same as in the ART logs to prevent from missing any events.
  • The V8.1.5.2 of Rational License Key Server Administration and Reporting Tool supports the following version levels of the LDAP servers:
    • IBM Security Directory V6.3.1
    • Microsoft Active Directory 2012
    • Oracle Directory V11.1.1.5.0
  • When configuring the Db2 database, you must create an artdata database. For details, see the Creating artdata database topic. Then the Rational License Key Server Administration and Reporting Tool database schema is created and updated in the following ways:
    • After installing and starting for the first time, the Rational License Key Server Administration and Reporting Tool database schema is automatically created.
    • When you are upgrading the Rational License Key Server Administration and Reporting Tool, the database schema is updated as required on the first run of the application.
  • The ART log has been enhanced and a new log level called "NOTE" is introduced. In this log level you can get more granular and organized information about the data received from the agents.
  • You can now configure the retained or deleted data that is generated at the agent. This allows detailed debugging in case the Data Conversion at agent is corrupted.
  • Improved error and information messages are displayed during communication between Rational License Key Server Administration and Reporting Tool and Rational License Key Server Agent that includes more specific information such as connection timeout.
  • Improved documentation available for troubleshooting information when installing and configuring Rational License Key Server Administration and Reporting Tool database.

Click the "FC" link in the Download Options column:

On
[{"DNLabel":"Rational Common Licensing 8.1.5.2 Refresh Pack","DNDate":"20 Sep 2017","DNLang":"English","DNSize":"1","DNPlat":{"label":"Windows","code":"PF033"},"DNURL":"http://www.ibm.com/support/fixcentral/swg/quickorder?parent=ibm%7ERational&product=ibm/Rational/Rational+Common+Licensing&release=All&platform=All&function=all&source=fc","DNURL_FTP":" ","DDURL":null}]

Technical Support



[{"Product":{"code":"SSTMW6","label":"Rational License Key Server"},"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Component":"RLKS Administration and Reporting Tool","Platform":[{"code":"PF002","label":"AIX"},{"code":"PF010","label":"HP-UX"},{"code":"PF016","label":"Linux"},{"code":"PF027","label":"Solaris"},{"code":"PF033","label":"Windows"}],"Version":"8.1.5.2","Edition":"","Line of Business":{"code":"LOB45","label":"Automation"}}]

Document Information

Modified date:
20 July 2018

UID

swg24044037