Installation and setup requirements

Each product installation includes the common component and the product's DevOps CM API subprovider. For example, the Rational® ClearQuest® installation includes the ClearQuest CM API subprovider. The subprovider layer ensures that the ClearCase® CM API component infrastructure is installed. Depending on the combination of products installed, systems can have all or a subset of the following JAR files:
  • DevOps CM API component infrastructure JAR files
  • DevOps CM API subprovider JAR file for ClearCase
  • DevOps CM API subprovider JAR file for ClearQuest

The DevOps CM API infrastructure is designed to function regardless of whether all the subproviders are present. The provider interface allows subprovider JAR files to be at different release levels.

The DevOps CM API component has a multipart version number. Installing one subprovider overwrites the infrastructure component installed by a previous version of the subprovider, but only if the infrastructure component is a newer version than the one that is already installed.

All the JAR files from the CM API plugin reside in the Installation Manager shared area for your operating system:
  • /opt/ibm/IMShared/plugins/com.ibm.rational.teamapi_latest_version
  • C:\Program Files\IBM\IMShared\plugins\com.ibm.rational.teamapi_latest_version
To use the DevOps CM API JAR files, you must add their locations to your class path. These examples use a wildcard character (*) to specify all JAR files in the directory:
  • java -cp bin:/opt/ibm/IMShared/plugins/com.ibm.rational.teamapi_9.0.1.v20191028_0348/* your-main-class
  • java -classpath bin;"C:\Program Files\IBM\IMShared\plugins\com.ibm.rational.teamapi_9.0.1.v20191028_0348\*" your-main-class
Note: Every time you upgrade to a new version or fix pack, you must update the class path as well.