This page discusses common issues seen with licenses when upgrading CLM applications.
License compatibility
All licenses are hosted by the Jazz Team Server in a CLM deployment unless you are using token licenses with the Rational License Server. Jazz Team Server version 4.x can host both 3.x and 4.x licenses including floating, token and authorized users single install. Therefore, if you decide to do an incremental upgrade, the JTS Application
must be upgraded first. Similarly, version 4.x licenses can only be installed on a version 4.x Jazz Team Server.
Some important notes:
- Version 3.0.x applications will continue to function with version 4.x licenses
- If you are upgrading from version 3.0.1.x, you must obtain 4.0 licenses.
- Version 4.x licenses must be utilized for version 4.x applications
- Version 4.0.1 applications will work with version 4.0 licenses, but do not work with version 3.x licenses.
- If you are upgrading from version 4.0.0.x, you are not required to obtain new licenses for 4.0.1.
Upgrade process for licenses
Version 3.0.x licenses (floating, token or authorized user single install) can be upgraded to 4.x by installing its version 4.x license counterpart. Essentially, this means importing the new license JAR or ZIP file which will overwrite the existing 3.x license. Existing user assignments of each version 3.0.x license are maintained after upgrading to its 4.x license counterpart, except in the following situations:
- If different license types (for example, token licenses) are installed in 4.x, than the license types used in 3.0.x (for example, floating), then user license assignments must be manually updated.
- Installing a version 4.x term license does not update its 3.0.x license counterpart. Therefore, user license assignment must be manually updated.
Licenses required for Rational Requirements Composer online migration
The user completing the online migration of Rational Requirements Composer must posses a valid version 4.x analyst license (floating, token, authorized user single install or trial) prior to invoking particular operation. While the online migration occurs, the Jazz Team Server is in
read-only mode.
The following operations are permitted while Jazz Team Server 4.x is in
read only mode:
- Upgrading the existing version 3.0.x licenses to their 4.x counterparts
- Installing new version 4.x licenses which were not utilized for 3.0.x applications
- Updating or altering user license assignments
Known issue: License not compatible error
This section discusses the "License not compatible" error that can occur during an upgrade.
Symptom and Cause:
You are unable to install the Rational Team Concert WorkGroup license after the upgrade. The error "License not compatible" is displayed.
There is a known defect with the Rational Team Concert Developer for Workgroups trial license in 4.0 which is missing a rule. It will cause this type of license to be incompatible with RTC 4.0 or 4.0.0.x. This defect is fixed in 4.0.1 and is tracked by
defect work item 242921.
Solution:
The solution is to upgrade to 4.0.1 where this defect is fixed.
If you are unable to upgrade to version 4.0.1, the workaround is to perform the following steps:
- Install the Developer Trial license attached to defect 242921.
- Install the Developer WG license downloaded from Rational License Key Center.
For further reference
Product specific links:
Comments