IBM Rational Debug Extension for IBM Rational Team Concert Server, V7.5.5.2

The Debug Extension for Rational Team Concert Server (Team Debug) allows the transfer of Java-based debug sessions between Rational Team Concert team members. During a debug session, a team member can decide to transfer the debug session to another team member. The transfer results in the receiver establishing control of the debug session. The session is at the point where the transfer occurred. The receiver can then continue to debug the application from that point.

This section provides instructions for installing or updating to Rational Debug Extension for IBM Rational Team Concert Server, v7.5.5.2, either by using IBM Installation Manager or by manually installing.

Configuring IBM Installation Manager to install or update Rational Debug Extension for IBM Rational Team Concert Server directly from the IBM update repository
If you will use IBM Installation Manager to install or update to Rational Debug Extension for IBM Rational Team Concert Server, v7.5.5.2, then it is not required that you download the compressed file from the "Download Packages" section of this document. Instead you can update to Rational Debug Extension for IBM Rational Team Concert Server, v7.5.5.2 directly from the IBM update repository.

To install or update to Rational Debug Extension for IBM Rational Team Concert Server, v7.5.5.2 directly from the IBM update repository, you must manually add the repository information in IBM Installation Manager:

1. Start IBM Installation Manager.
2. On the Start page of Installation Manager, click File > Preferences, and then click Repositories.
3. On the Repositories page, click Add Repository.
4. In the Add repository window, browse to or type the following Web address: http://public.dhe.ibm.com/software/rationalsdp/v75/debug4rtcs/updates/
5. Click OK to close the Preference page.

Configuring IBM Installation Manager to install or update Rational Debug Extension for IBM Rational Team Concert Server from downloaded file

If you must download the compressed file to locally install or update to Rational Debug Extension for IBM Rational Team Concert Server, v7.5.5.2, complete the following steps:

1. Download the update file from Fix Central by following the link listed in the download table below.
2. Extract the compressed files in an appropriate directory. For example, choose to extract to C:\temp\update.
3. Add the update's repository location in IBM Installation Manager:
4. Start IBM Installation Manager.
5. On the Start page of Installation Manager, click File > Preferences, and then click Repositories.
6. On the Repositories page, click Add Repository.
7. In the Add repository window, browse to or enter the file path to the diskTag.inf file, which is located in the DebugExt\disk1 sub-directory in the directory where you extracted the compressed files and then click OK. For example, enter C:\temp\updates\DebugExt\disk1\diskTag.inf.
8. Click OK to close the Preference page.

Updating Debug Extension for Rational Team Concert Server to version 7.5.5.2 by using IBM Installation Manager

To update Debug Extension for Rational Team Concert Server to version 7.5.5.2 by using IBM Installation Manager, complete the following steps:

1. Close Rational Team Concert.
2. Start IBM Installation Manager by using the same user ID that installed Rational Debug Extension, v7.5, or a user ID with the same authority.
3. Click Update.
4. On the first page of the Update Packages wizard, select IBM Rational Debug Extension for Rational Team Concert Server, version 7.5.5.2 and click Check for Other Versions and Extensions to install the latest available version of the selected packages. If a newer version is available, it is automatically selected for installation. Then, click Next.
5. On the Licenses page, read the license agreements for the selected packages. On the left-hand side of the License page, click each package version to display its license agreement. If you agree to the terms of all the license agreements, click I accept the terms of the license agreements and click Next to continue.
6. Select the package group where you installed Rational Team Concert Server and click Next.
7. Click Install. When the installation process is complete, a message confirms the success of the process.
8. Close Installation Manager.

Installing Rational Debug Extension for Rational Team Concert Server by using IBM Installation Manager

If you already used IBM Installation Manager to install Rational Team Concert Server then you can use it to install Rational Debug Extension for IBM Rational Team Concert Server, v7.5.5.2.

To install Rational Debug Extension for Rational Team Concert Server, complete the following steps:

1. Close Rational Team Concert.
2. Start IBM Installation Manager by using the same user ID that installed Rational Team Concert Server, or a user ID with the same authority.
3. Click Install.
4. On the first page of the Install Packages wizard, select IBM Rational Debug Extension for Rational Team Concert Server. Click Check for Other Versions and Extensions to install the latest available version of the selected packages. If a newer version is available, it is automatically selected for installation. Click Next.
5. On the Licenses page, read the license agreements for the selected packages. On the left-hand side of the License page, click each package version to display its license agreement. If you agree to the terms of all the license agreements, click I accept the terms of the license agreements and click Next to continue.
6. Select the package group where you installed Rational Team Concert Server and click Next.
7. Click Install. When the installation process is complete, a message confirms the success of the process.
8. Close Installation Manager.

If Rational Team Concert Server is not using the default Tomcat server that is included in its installation files, then you must update the <install_dir>/server/provision_profiles/teamdebugservice_profile.ini file and <install_dir>/server/provision_profiles/teamdebugcommon_profile.ini file ( Note: In version 2.0, the path to these files is <install_dir>/server/conf/jazz/provision_profiles/)::
Under the URL, instead of using a relative path, change it to an absolute path, for example, change url=file:../ext/rad-teamdebug-update-site to url=file:C:/Program Files/IBM/RTC/ext/rad-teamdebug-update-site.

Rational Debug Extension for Rational Team Concert Server is installed.

Installing or updating to Rational Debug Extension for Rational Team Concert Server, v7.5.5.2 manually
If you did not use IBM Installation Manger to install Rational Team Concert Server, you can optionally manually install or update Rational Debug Extension for Rational Team Concert Server.

Close Rational Team Concert before you manually install Rational Debug Extension for Rational Team Concert Server.

To manually install Rational Debug Extension for Rational Team Concert Server, complete the following steps:

1. Download the update file from Fix Central by following the link listed in the download table below to the same computer where you installed Rational Team Concert Server.
2. Extract the compressed files in an appropriate directory. For example, choose to extract to C:\temp\update.
3. Open the DebugExt\disk1\ZipImage sub-directory in the directory where you extracted the compressed files. and then click OK. For example, open C:\temp\updates\DebugExt\disk1\ZipImage
4. Delete the following directories or files if they already exist:
   • (For version 1.0) <install_dir>/server/provision_profiles/teamdebugcommon_profile.ini ; (For version 2.0) <install_dir>/server/conf/jazz/provision_profiles/teamdebugcommon_profile.ini
   • (For version 1.0) <install_dir>/server/provision_profiles/teamdebugservice_profile.ini; (For version 2.0) <install_dir>/server/conf/jazz/provision_profiles/teamdebugservice_profile.ini
   • <install_dir>/ext/rad-teamdebug-update-site/
5. Extract the contents of the compressed file DebugExtUpdate.zip to the same directory where you installed Rational Team Concert Server.
6. If Rational Team Concert Server is not using the default Tomcat that comes with the install image, you must update the <install_dir>/server/provision_profiles/teamdebugservice_profile.ini and <install_dir>/server/provision_profiles/teamdebugcommon_profile.ini files (Note: In version 2.0, the path to these files is <install_dir>/server/conf/jazz/provision_profiles/): Under the URL, instead of using a relative path, change it to an absolute path, for example, change url=file:../ext/rad-teamdebug-update-site to url=file:C:/Program Files/IBM/RTC/ext/rad-teamdebug-update-site.
7. Start the Jazz server.
8. Use your browser to access the Jazz server to reset the installed components:
9. In the browser address field, enter https://localhost:9443/jazz/admin?internal#action=com.ibm.team.repository.admin.serverReset and press Enter.
10. Log in by using your Jazz Admin ID and password.
11. Click Reset.
12. Close and restart the Jazz server.

Rational Debug Extension for Rational Team Concert Server is installed.

You can download the update from Fix Central using either Download Director or HTTP. Follow the link in the table below to access Fix Central.

1. Under group_refresh_pack: 7.5.5.2-Rational-RAD-groupfixpack (IBM Rational Application Developer for WebSphere Software), Version 7.5.5.2 , click Show contained fixes.
2. Ensure that you select fix pack: 7.5.5.2-Rational-DEBUG4RTCS-fixzippack (Rational Debug Extension for IBM Rational Team Concert Server Version 7552).

If you are unable to use Fix Central, then you can download the fix pack using HTTP from the following URL:

http://delivery04-bld.dhe.ibm.com/sar/CMA/RAA/0140j/0/debug4rtcs7552.offering.disk1.zip