Installing Rhapsody Model Manager on individual computers

These are the steps required to install Rhapsody Model Manager on end-user computers.

Note: Before carrying out these steps, verify that your system administrator has installed the necessary server components as described in Installing server components for Rhapsody Model Manager and created a project area as described in Create a Rhapsody Model Manager project area using the Rational Team Concert client.
  1. Install the Rational Team Concert Eclipse client:
    1. Download the compressed file for version 6.0.6 from jazz.net
    2. Extract the contents of the file.
  2. Install Rational Rhapsody. The installation wizard includes a list of add-ons that can be installed. Make sure that the list of add-ons you have selected includes the Rhapsody Model Manager add-on.
    List of Rhapsody add-ons that can be installed
  3. Install the Rational Rhapsody plug-ins for integration with Rational Team Concert:
    1. Open Rational Team Concert and select Help > Install New Software.
    2. On the Available Software page, click Add.
    3. On the Add Repository page, click Local to display the directories on your computer.
    4. Navigate to the RTCIntegration folder in your Rational Rhapsody installation directory. You will see two folders - RTCEclipseClient32bitPlugins and RTCEclipseClient64bitPlugins. Select the folder that matches your version of the Rational Team Concert client, and click OK.
    5. Add a name for the local repository and click OK to close the Add Repository page.
    6. On the Available Software page, expand IBM Rational Rhapsody Tools.
    7. Select the IBM Rational Rhapsody integration for Rational Team Concert plug-in, and then click Next.
    8. On the Install Details page, click Next.
    9. On the Review License page, accept the terms of the license agreement, and then click Finish.
    10. When the installation completes, restart Rational Team Concert.
    Note: If Rational Rhapsody does not seem to be communicating with the integration plugin for Rational Team Concert even though you installed the plugins, try the steps listed in Troubleshooting the integration with Rational Team Concert.
  4. Configure Rational Team Concert to use Rational Rhapsody DiffMerge for comparisons:
    1. In Rational Team Concert, select Window > Preferences from the main menu.
    2. In the filter field at the top of the panel, type Compare, and then select Jazz Source Control > External Compare Tools.
    3. In the Use an External Compare Tool for Compare section, select Always.
    4. In the Use an External Compare Tool for Auto-Resolve section, select Always.
    5. In the 2-way Compare section, in the Location of Executable field, click Browse.
    6. Browse to the root directory of your Rational Rhapsody installation, for example, C:\IBM\Rhapsody, select the DiffMerge.exe file, and click Open.
    7. In the 2-Way Compare section, in the Local Compare Arguments field, enter the following text (include the quotation marks): "${file1Path}" "${file2Path}" -AliasLeft "${file1Title}" -AliasRight "${file2Title}"
    8. In the 2-Way Compare section, in the Remote Compare Arguments field, enter the following text (include the quotation marks): "${file1Path}" "${file2Path}" -AliasLeft "${file1Title}" -AliasRight "${file2Title}"
    9. In the 3-Way Conflict Compare section, fill in the Location of Executable field by pasting in the full path for DiffMerge.exe (same path that you used in the 2-way Compare section).
    10. In the 3-Way Conflict Compare section, in the Compare Arguments field, enter the following text (include the quotation marks): -xmerge "${file1Path}" "${file2Path}" -base "${ancestorFilePath}" -out "${mergeFilePath}" -AliasLeft "${file1Title}" -AliasRight "${file2Title}" -AliasBase "${ancestorFileTitle}"
    11. In the Auto-Resolve section, fill in the Location of Executable field by pasting in the full path for DiffMerge.exe (same path that you used in the 2-way Compare section).
    12. In the Auto-Resolve section, in the Auto-resolve Arguments field, enter the following text (include the quotation marks): -merge "${file1Path}" "${file2Path}" -base "${ancestorFilePath}" -out "${mergeFilePath}" -AliasLeft "${file1Title}" -AliasRight "${file2Title}"
    13. Click OK.
    Note: The settings for the diff tool to use are stored in a user's workspace, so each user will have to configure their Rational Team Concert client with these instructions.