Installing the Collaborator Plug-In for Rational Team Concert Server

Installing the Collaborator Plug-In for Rational Team Concert Server

This topic explains how to install the Collaborator plug-in for Rational Team Concert. Important: Since version 8.5 Collaborator requires Java 7. Whereas, Rational Team Concert 4.x - 6.0 (prior to 6.0.1) require Java 6, and RTC 3.x requires Java 5. Rational Team Concert 6.0.1 and later require Java 7. Therefore to integrate Collaborator and Rational Team Concert you will need to install a specific version of Rational Team Concert Plug-In. To integrate with Rational Team Concert 3.x you also need to downgrade your Collaborator (both Server and Client components) to CodeCollaborator/PeerReview Complete version 6.5.x (as only these versions supported Java 5). 1. Download the update site .zip package with the plug-in from our web site: • For Rational Team Concert Server version 6.0.1 and higher download Rational Team Concert Plug-In version 10.x. • For Rational Team Concert Server versions 4.x - 6.0 (prior to 6.0.1) download Rational Team Concert Plug-In version 8.4.8406.001. • For Rational Team Concert Server versions 3.x download Rational Team Concert Plug-In version 6.5.6511. Note: For more information about different versions, see Overview. 2. Extract files from the downloaded .zip archive to the <$JAZZ_ROOT>/ccollab-update-site folder on the Rational Team Concert server computer. For example, the folder name can be like C:\Program Files\IBM\JazzTeamServer\ccollab-update-site. 3. Copy the com.smartbear.ccollab-profile.ini file from this folder to the <$JAZZ_ROOT>\server\conf\ccm\provision_profilesfolder. 4. Now you need to reset your Jazz Team Server: • Open the following web page in your web browser: If you use Rational Team Concert 4-6: • https://$Your_Jazz_server/jts/admin?internal#action=com.ibm.team.repository.admin.serverReset If you use Rational Team Concert 3 or earlier: •  https://$Your_Jazz_server/jazz/admin?internal=true • On the page, click Request Server Reset. This will command Rational Team Concert to load the Collaborator plug-in next time the Rational Team Concert service restarts. 5. Restart the Jazz Server. To do this: • Select Stop the Jazz Team Server from Windows' Program Files menu, or run the shutdown.bat file in the Jazz Install directory. • Run the server by selecting Start the Jazz Team Server from the Program Files menu: 6. Check whether the plug-in is loaded: • Open the Component Status page: https://$Your_Jazz_server/ccm/admin?internal=true#action=com.ibm.team.repository.admin.componentStatus • Click the refresh icon next to the Component Status item in the left-side menu to update the page after it loads. • Check that the com.smartbear.rtc.process.ICodeCollaboratorService service is active. • Now click Provision Status in the menu menu entry: • Search for smartbear on the page and make sure that the plug-in has been installed and initialized. Provision Status page: Checking whether the plug-in is installed CRJAZ0300I This feature is being installed: "com.smartbear.collaborator.rtc.process.feature_NN.N.NNNNN.NNN". CRJAZ0299I Installing bundle from the URL "file:/<JAZZ_ROOT>/server/conf/../../ccollab-update-site/plugins/com.smartbear.collaborator_NN.N.NNNNN.NNN.jar". CRJAZ0299I Installing bundle from the URL "file:/<JAZZ_ROOT>/server/conf/../../ccollab-update-site/plugins/com.smartbear.collaborator.libdependencies_NN.N.NNNNN.NNN.jar". CRJAZ0299I Installing bundle from the URL "file:/<JAZZ_ROOT>/server/conf/../../ccollab-update-site/plugins/com.smartbear.collaborator.rtc.common_NN.N.NNNNN.NNN.jar". CRJAZ0299I Installing bundle from the URL "file:/<JAZZ_ROOT>/server/conf/../../ccollab-update-site/plugins/com.smartbear.collaborator.rtc.process_NN.N.NNNNN.NNN.jar". CRJAZ0299I Installing bundle from the URL "file:/<JAZZ_ROOT>/server/conf/../../ccollab-update-site/plugins/com.smartbear.collaborator.rtc.component_NN.N.NNNNN.NNN.jar". where NN.N.NNNNN.NNN stands for the version number of Collaborator plug-in. Provision Status page: Checking whether the plug-in is started CRJAZ0307I Starting the bundle "com.smartbear.collaborator_NN.N.NNNNN.NNN". CRJAZ0307I Starting the bundle "com.smartbear.collaborator.libdependencies_NN.N.NNNNN.NNN". CRJAZ0307I Starting the bundle "com.smartbear.collaborator.rtc.common_NN.N.NNNNN.NNN". CRJAZ0307I Starting the bundle "com.smartbear.collaborator.rtc.process_NN.N.NNNNN.NNN". CRJAZ0307I Starting the bundle "com.smartbear.collaborator.rtc.component_NN.N.NNNNN.NNN". where NN.N.NNNNN.NNN stands for the version number of Collaborator plug-in. Other Configuration Actions After you installed the plug-in, you need to configure it. See Configuring the Collaborator Plug-In for Rational Team Concert.