Readme for Rational Rhapsody 8.2.1 iFix001

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

Improvements for Rhapsody Design Manager users

This iFix is required to complement Rhapsody DM 6.0.4 iFix001 (available on jazz.net).

Rhapsody APARs Fixed with 8.2.1 iFix001

Category APAR ID Summary
Code Generation PI82883 Rhapsody incorrectly stores ModifiedTime when disabled for a sub-statechart
Modeling - General PI78915 Inner actor that inherits from outer actor causes crash when user opens features window of panel diagram element
Modeling - General PI81026 adding activity to state as sub-element results in error No elements are allowed outside the top level element in subcharts
Runtime Target & RTOS & Adaptors PI82807 UNABLE TO INTEGRATE WINDRIVER WORKBENCH V3.2 WITH RHAPSODY V8.2

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.2.1 (BuildNumber - 9810313).
  2. Make sure that Rhapsody is not currently running.
  3. Download the .zip file for the iFix: Rhapsody821iFix001_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 Rhapsody821iFix_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.2.1 (BuildNumber - 9810313).
  2. Make sure that Rhapsody is not currently running.
  3. Download the .zip file for the iFix: Rhapsody821iFix001_x64_a.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 Rhapsody821iFix_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.2.1 (BuildNumber - 9810313)
  2. Make sure that Rhapsody is not currently running.
  3. Download the .zip file for the iFix: Rhapsody821iFix001_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.2.1 (BuildNumber - 9810313)
  2. Make sure that Rhapsody is not currently running.
  3. Download the .zip file for the iFix: Rhapsody821iFix001_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.2.1 (BuildNumber - 9810313)
  2. Make sure that Rhapsody is not currently running.
  3. Download the .zip file for the iFix: Rhapsody821iFix001-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.2.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.2.1" installation and click "Next".
  12. Select "IBM Rational Rhapsody Developer 8.2.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.2.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 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.2.1 (iFix 001)" and click "Next".
  4. Click Finish when done.