Setting up Rational Rhapsody for use with Rational Synergy

Before you can use IBM® Rational® Synergy with IBM Rational Rhapsody®, you must set up Rational Rhapsody so that the two systems can communicate with each other using SCC mode.

Procedure

  1. Install the SCC add‑on for Rational Synergy. Download it from the IBM website at http://www.ibm.com/support/docview.wss?uid=swg21380569:
    1. Select your Rational Synergy product version.
    2. Sign in with your IBM ID and password.
    3. On the Downloads page, in the Integrations section, select the check box for an applicable PC Integration and download the file.
  2. To enable the integration and display the Rational Synergy toolbar within Rational Rhapsody, add the following flag to the General section of the rhapsody.ini file:
    ShowSynergyTaskBar=TRUE
  3. Be certain that the location of the ccm.exe file (in <Rational Synergy installation path>\bin) is in the PATH environment variable.
  4. When using Rational Synergy with IBM Rational Rhapsody DiffMerge, you must include the location of the DiffMerge.exe file that is in the Rational Rhapsody installation folder (for example, <Rational Rhapsody installation path>\Rhapsody76) in the PATH environment variable.
  5. To add Rational Rhapsody types to the Rational Synergy Type Manager, use the Rational Synergy client to import the rhapsodytypes.xml file into Rational Synergy. It also links Rational Rhapsody DiffMerge to perform comparison and merging on Rational Rhapsody files within Rational Synergy. The rhapsodytypes.xml file is located in <Rational Rhapsody installation path>\Share\cm\Synergy.
    Note: The instructions for using the Rational Synergy client to import the rhapsodytypes.xml file is provided by that product. See its readme file. Also, the Rational Synergy installer for the integration with Rational Rhapsody might include the rhapsodytypes.xml file.
  6. Add the following code to your ccm.ini file. For more information about the ccm.ini file, see the topic at http://www.ibm.com/support/docview.wss?uid=swg21325190.
    rhapsodytypes_merge_cmd = DiffMerge.exe -xmerge %file1 
       %file2 -base %ancestor -out %outfile
  7. If you use the Rational Synergy Java client, add the following code to your ccm.properties file:
    windows.tool.compare.rhapsodytypes = DiffMerge.exe -xcompare "%file1" 
    "%file2" -base "%ancestor"
    windows.tool.merge.rhapsodytypes = DiffMerge.exe -xmerge "%file1" 
    "%file2" -base "%ancestor" -out "%outfile"

Feedback