How to upgrade RTC plain Java client libraries bundled with Rational Synergy?

Answer

Rational Synergy bundles Rational Team Concert (RTC) plain Java client libraries, so that it can integrate with RTC.

Synergy 7.2.1.4 and below versions bundle RTC 4.0 client libraries and Synergy 7.2.1.5 and above versions bundle RTC 5.0.2 client libraries alone.

Those libraries can be upgraded or downgraded to a different version by following the below mentioned steps:

1. Download the RTC plain Java client libraries for version x.x from jazz.net
2. Stop all the Synergy services/daemons.
3. Backup the folder "$CCM_HOME/lib/rtcjars/" from the Synergy server run-area.
4. Delete all the jar files from the folder "$CCM_HOME/lib/rtcjars/".
5. Unzip the downloaded package in the machine where Synergy server is running. Copy all the jar files from the extracted location to "$CCM_HOME/lib/rtcjars/". (Note: The folder "rtcjars" should be empty before you copy the new jar files)
6. Start the Synergy services/daemons.

• RTC client library version can not be greater than the RTC server version, which shall be integrated with Synergy.
• It is recommended to use the default RTC libraries bundled with Synergy. If you plan to upgrade the libraries, then a thorough testing in the pre-production environment is required before applying in the production environment.
• Synergy-RTC integration has been validated with RTC 4.0 and 5.0.2 client libraries.

1. Stop all the Synergy services/daemons.
2. Delete the folder "$CCM_HOME/lib/rtcjars/" from the Synergy server run-area.
3. Restore the folder "$CCM_HOME/lib/rtcjars/" from the backup made during upgrade.
4. Start the Synergy services/daemons.