Readme for Rational Rhapsody 8.3.1 iFix001

Note that the installation of this iFix requires you to manually extract the content of a .zip file after you run the executable file provided. See the installation instructions at the end of this document for details.

Changes in iFix001

Installation instructions

Rhapsody APARs Fixed with 8.3.1 iFix001

Category APAR ID Summary
DiffMerge PI98085 DiffMerge detects an incorrect change on DiagramFrame using the new XML file format
Features Dialog PI97868 Unable to change stereotype on class member function; switches back to previous selection on Apply
Statechart PH00099 REGRESSION: CARRIAGE RETURNS ON MULTI-LINED TRANSITIONS ARE ERASED

Rhapsody Model Manager Defects Fixed with 8.3.1 iFix001

Category Defect ID Summary
RMM Rhapsody Client 64603 RMM rtc disconnects on migrate
RMM Rhapsody Client 64330 RMMRhapsodyClient: renaming a new package, leaves the old original name in RTC under unresolved changes
RMM Rhapsody Client 64533 A package which has OSLC links to remote requirement in collection is being mark as modified on login to RM
RMM Rhapsody Client 64563 "Resolve" menu on unresolved OSLC link in table do nothing
RMM Rhapsody Client 64607 Performance degradation when working with big collections
RMM Rhapsody Client 64414 Association and Association Ends don't have an OSLC Link Tab
RMM Rhapsody Client 64419 Don't refresh remote oslc links for Opt-Out Project when switching gc

Rhapsody Design Manager Defects Fixed with 8.3.1 iFix001

Category Defect ID Summary
RDM Rhapsody Client 64676 Allow Save As.. from Design Manager without fully loading the model

Applying the iFix

A number of steps in this section refer to the Share directory as being a subdirectory of the main Rhapsody installation directory. Note that if you performed a "split" installation of Rhapsody - meaning that you did not use the "Install all Rhapsody files in one location" option - then the Share directory will be located in the user home directory, for example, C:\Users\<username>\IBM\Rational\Rhapsody.

On Windows - using MSI installation to install iFix for 32-bit version of Rhapsody

  1. Verify that you have installed IBM Rational Rhapsody 8.3.1 (BuildNumber - 9835550).
  2. Make sure that Rhapsody is not currently running.
  3. Download the .zip file for the iFix: Rhapsody831iFix001_x86.zip
  4. Move the contents of the folder <Rhapsody installation directory>\RTCIntegration to a backup folder.
  5. After extracting the contents of the .zip file, run the executable file Rhapsody831iFix_x86.exe
  6. Click Update in the InstallShield Wizard.
  7. Click Finish when the installation is done.
  8. In the folder <Rhapsody installation directory>, locate the file RhapsodyRoot.zip.
  9. Use "extract here" to extract the contents of RhapsodyRoot.zip

On Windows - using MSI installation to install iFix for 64-bit version of Rhapsody

  1. Verify that you have installed IBM Rational Rhapsody 8.3.1 (BuildNumber - 9835550).
  2. Make sure that Rhapsody is not currently running.
  3. Download the .zip file for the iFix: Rhapsody831iFix001_x64.zip
  4. Move the contents of the folder <Rhapsody installation directory>\RTCIntegration to a backup folder.
  5. After extracting the contents of the .zip file, run the executable file Rhapsody831iFix_x64.exe
  6. Click Update in the InstallShield Wizard.
  7. Click Finish when the installation is done.
  8. In the folder <Rhapsody installation directory>, locate the file RhapsodyRoot.zip.
  9. Use "extract here" to extract the contents of RhapsodyRoot.zip.

On Windows - using archived files to install iFix for 32-bit version of Rhapsody

  1. Verify that you have installed IBM Rational Rhapsody 8.3.1 (BuildNumber - 9835550)
  2. Make sure that Rhapsody is not currently running.
  3. Download the .zip file for the iFix: Rhapsody831iFix001_Win32_manual.zip
  4. After extracting the contents of the .zip file, carry out the following steps:
    1. Copy RhapsodyRoot.zip into the <Rhapsody installation directory> folder.
    2. Back up the folder <Rhapsody installation directory> by copying all .exe and .dll files to a different folder.
    3. Move the contents of the folder <Rhapsody installation directory>\RTCIntegration to a backup folder.
    4. Open RhapsodyRoot.zip to see which files are going to be replaced, and decide if you want to back up any additional files from your current installation of Rhapsody. (You will need these files if you decide later to uninstall the iFix.)
    5. Use "extract here" to extract the contents of RhapsodyRoot.zip, answering "yes" to override existing files.
    6. Copy RhapsodyShare.zip into the <Rhapsody installation directory>\Share folder. (If you performed a "split" installation, copy the RhapsodyShare.zip file into the Share folder, usually located under C:\Users\<username>\IBM\Rational\Rhapsody.)
    7. Open RhapsodyShare.zip to see which files are going to be replaced, and decide if you want to back up any of these files from your current installation of Rhapsody. (You will need these files if you decide later to uninstall the iFix.)
    8. Use "extract here" to extract the contents of RhapsodyShare.zip, answering "yes" to override existing files.

On Windows - using archived files to install iFix for 64-bit version of Rhapsody

  1. Verify that you have installed IBM Rational Rhapsody 8.3.1 (BuildNumber - 9835550)
  2. Make sure that Rhapsody is not currently running.
  3. Download the .zip file for the iFix: Rhapsody831iFix001_x64_manual.zip
  4. After extracting the contents of the .zip file, carry out the following steps:
    1. Copy RhapsodyRoot.zip into the <Rhapsody installation directory> folder.
    2. Back up the folder <Rhapsody installation directory> by copying all .exe and .dll files to a different folder.
    3. Move the contents of the folder <Rhapsody installation directory>\RTCIntegration to a backup folder.
    4. Open RhapsodyRoot.zip to see which files are going to be replaced, and decide if you want to back up any additional files from your current installation of Rhapsody. (You will need these files if you decide later to uninstall the iFix.)
    5. Use "extract here" to extract the contents of RhapsodyRoot.zip, answering "yes" to override existing files.
    6. Copy RhapsodyShare.zip into the <Rhapsody installation directory>\Share folder. (If you performed a "split" installation, copy the RhapsodyShare.zip file into the Share folder, usually located under C:\Users\<username>\IBM\Rational\Rhapsody.)
    7. Open RhapsodyShare.zip to see which files are going to be replaced, and decide if you want to back up any of these files from your current installation of Rhapsody. (You will need these files if you decide later to uninstall the iFix.)
    8. Use "extract here" to extract the contents of RhapsodyShare.zip, answering "yes" to override existing files.

On Linux

  1. Verify that you have installed IBM Rational Rhapsody 8.3.1 (BuildNumber - 9835550)
  2. Make sure that Rhapsody is not currently running.
  3. Download the .zip file for the iFix: Rhapsody831iFix001-Linux.zip
  4. After extracting the contents of the .zip file, open IBM Installation Manager.
  5. From the menu, select File --> Preferences.
  6. Select "Add Repository".
  7. Click "Browse..." and select the file <Rhapsody8.3.1_iFix1 extract folder>\repository.config
  8. Clear the "search service repositories during installation and updates" check box.
  9. Click "OK" to close the Preferences dialog.
  10. Click "Update".
  11. Select "IBM Rational Rhapsody Developer 8.3.1" installation and click "Next".
  12. Select "IBM Rational Rhapsody Developer 8.3.1 iFix 001" and click "Next".
  13. Click "Update" to start the update process.
  14. Click Finish when the installation is done.

Uninstalling the iFix

On Windows - using MSI installation

  1. Go to Control Panel > All Control Panel Items > Programs and Features, and select "View installed updates".
  2. Select the relevant entry under IBM Rational Rhapsody 8.3.1xxxx
  3. Delete the current contents of the directory <Rhapsody installation directory>\RTCIntegration.
  4. Restore the content of the RTCIntegration folder from the backup that you created during the installation

On Windows - using archived files

  1. Restore the folder <Rhapsody installation directory>:
    1. Delete the current contents of the directory <Rhapsody installation directory>\RTCIntegration.
    2. Restore the following folders from the backup that you created during the installation:
      • <Rhapsody installation directory>
      • <Rhapsody installation directory>\RTCIntegration
    3. Remove the file RhapsodyRoot.zip
  2. Restore the folder <Rhapsody installation directory>\Share:
    1. Restore the content of any folders or files that you backed up during the installation
    2. Remove the file RhapsodyShare.zip

On Linux

  1. Open IBM Installation Manager.
  2. Click "Uninstall".
  3. Select "IBM Rational Rhapsody Developer 8.3.1 (iFix 001)" and click "Next".
  4. Click Finish when done.

Using Rhapsody Model Manager or Rhapsody Design Manager after uninstalling the iFix

When you uninstall the iFix, the ManagementMode variable in the rhapsody.ini file is set to NONE. This means that neither the Rhapsody Model Manager menu items nor the Rhapsody Design Manager menu items will be visible. If you plan to use Rhapsody Model Manager, set the value of ManagementMode to RMM. If you plan to use Rhapsody Design Manager, set the value of ManagementMode to DM.

If your Rhapsody installation included the Import from Design Manager feature, uninstalling the iFix also removes the EnableDmToRmmMigration variable from your rhapsody.ini file. If you will be migrating Rhapsody Design Manager projects to Rhapsody Model Manager, add EnableDmToRmmMigration=TRUE to the General section of the rhapsody.ini file.