Installing Rhapsody Model Manager on individual computers

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

1. Install the Engineering Workflow Management Eclipse client:
   1. Download the compressed file for version 7.0.3 from jazz.net.
   2. Extract the contents of the file.
2. Install IBM Engineering Systems Design Rhapsody . The installation wizard includes a list of add-ons that can be installed. Make sure that the list of the selected add-ons includes the Rhapsody Model Manager add-on.
   
3. Install the Rhapsody plug-ins for integration with Engineering Workflow Management:
   1. Open Engineering Workflow Management 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. Go to the EWMIntegration folder in your Rhapsody installation directory. You see two folders - EWMEclipseClient32bitPlugins and EWMEclipseClient64bitPlugins. Select the folder that matches your version of the Engineering Workflow Management 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 Engineering Rhapsody Tools.
   7. Select the Engineering Rhapsody integration for Engineering Workflow Management 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 Engineering Workflow Management.

   Note: If Rhapsody does not seem to be communicating with the integration plug-in for Engineering Workflow Management even though you installed the plug-ins, try the steps that are listed in Troubleshooting the integration with Engineering Workflow Management.
4. Configure Engineering Workflow Management to use Rhapsody DiffMerge for comparisons:
   1. In Engineering Workflow Management, select Window > Preferences from the main menu.
   2. In the filter field on 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 For all files that match the specified file pattern, and use the following list for the file pattern: *.cfgx, *.clbx, *.clsx, *.cmpx, *.ctdx, *.dpdx, *.filx, *.folx, *.mscx, *.mttx, *.mtxx, *.omdx, *.pldx, *.rplx, *.rpyx, *.sbsx, *.stdx, *.tblx, *.tbtx, *.tmdx, *.ucdx
   4. In the Use an External Compare Tool for Auto-Resolve section, select For all files that match the specified file pattern, and use the following list for the file pattern: *.cfgx, *.clbx, *.clsx, *.cmpx, *.ctdx, *.dpdx, *.filx, *.folx, *.mscx, *.mttx, *.mtxx, *.omdx, *.pldx, *.rplx, *.rpyx, *.sbsx, *.stdx, *.tblx, *.tbtx, *.tmdx, *.ucdx
   5. Select the << custom >> option from the External Compare Tool to Use drop-down list.
   6. In the 2-way Compare section, in the Location of Executable field, click Browse.
   7. Browse to the root directory of your Rhapsody installation, for example, C:\IBM\Rhapsody, select the DiffMerge.exe file, and click Open.
   8. 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}"
   9. 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}"
   10. In the 3-Way Conflict Compare section, complete 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).
   11. 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}"
   12. In the Auto-Resolve section, complete 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).
   13. 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}"
   14. Click OK.
5. Add the files to the ignore list.
   1. a. From the menu, select Window > Preferences.
   2. In the filter box on the Preferences window, type ignore.
   3. From the filtered tree, select Team > Ignored Resources entry.
   4. In the Ignored resources panel, click Add Pattern.
   5. In the Add Ignore Pattern window, add the path pattern as *.ehl and click OK.
   6. Repeat the preceding steps to add the following patterns: *.rpwx, *.save, *_auto_rpy, *.jazzignore.
   7. Click OK to close the preferences window.
   8. Click OK to verify the changes.

   Note: The settings for the ignored resources and which diff tool to use are stored in a user's workspace, so each user must configure their Engineering Workflow Management client with these instructions.