Readme for Rational Rhapsody 8.3.1 iFix002

Changes in iFix002

Changes in iFix001

Installation instructions

Rhapsody APARs Fixed with 8.3.1 iFix002

Category APAR ID Summary
Features Dialog PI98485 Check Model checks fail to scroll in a read only component
RHP Framework PH00797 Crash in the SXF framework OMMainThread::postTimeouts code
RHP Graphic Editors PI99259 NeedDebugTree: Rhapsody crashed with Add to Model
TestConductor PI97425 TestConductor with Tag "ComputeModelCoverage" enabled causes Rhapsody to crash

Rhapsody Model Manager - Defects Fixed and Enhancements Added in 8.3.1 iFix002

Note that to use Rhapsody Model Manager in conjunction with Rational DOORS with this iFix, you must install the updated DXL scripts that are provided with the iFix. For more information, see the relevant section in the Rational Rhapsody Knowledge Center.

Note that the defect fixes and enhancements for Rhapsody Model Manager require that you also install iFix003 for Rational Collaborative Lifecycle Management Solution 6.0.6 (scheduled release date: September 28, 2018).

Category Defect ID Summary
RMM Rhapsody Client 64605 Big performance degradation when working with large collections
RMM Rhapsody Client 64898 [RMM] Optimize Remote Requirements functionality to reduce load on DNG server
RMM Rhapsody Client 66680 Table refresh on notifications is very slow
RMM Rhapsody Client 66753 OSLC link information is lost when merging units prior to RMM import
RMM Rhapsody Client 68217 Rhapsody tries to fetch unresolved Remote Artifacts over and over again
RMM Rhapsody Client 68529 Detect Remote Requirements changes doesn't detect collection changes
RMM Rhapsody Client 66490 Sequence Diagrams that are not units show up as unsynchronized in RMM

Rhapsody Design Manager - Defects Fixed and Enhancements Added in 8.3.1 iFix002

Category Defect ID Summary
RDM Rhapsody Client 65575 RHAPSODY RUNS EXPENSIVE QUERIES ON DNG SERVER
RDM Rhapsody Client 65869 Save as from design manager fails due to server timeouts.
RDM Rhapsody Client 68545 Provide a way to save model from Design Manager if part of it causes a crash

Improvements included in iFix002 for Rhapsody users

Rhapsody API - accessing data from specific cells in tables

New methods have been added to IRPTableView and IRPMatrixView for:

In addition, in tables that use the Rhapsody API to customize cell behavior, the getter, setter, and picker methods now include arguments that represent the column number and row number for the cell.

Rhapsody API (COM version only) - method IRPPort.PortContract replaces IRPPort.Contract

Beginning with 8.3.1 iFix002, if you use Rhapsody API applications that include calls to the method IRPPort.Contract, all calls to that method must be replaced by calls to the method IRPPort.PortContract. Note that this is relevant only for applications that use the COM version of the Rhapsody API.

iFix002 for Rhapsody 8.3.1 includes the following fixes, which were included in iFix001.

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, or in the directory C:\ProgramData\IBM\Rational\Rhapsody (if installed for all users).

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: Rhapsody831iFix002b_x86.zip
  4. Move the contents of the folder <Rhapsody installation directory>\RTCIntegration to a backup folder.
  5. Move the file <Rhapsody installation directory>\Share\Profiles\RhapsodyModelManager\com.ibm.rational.rhapsody.rmm.client_lib\com.ibm.rational.rhapsody.rmm.svg_6.0.600.201805082129.jar to a backup folder.
  6. Move the file <Rhapsody installation directory>\RP_CODEGEN_DLL.dll to a backup folder.
  7. Move the file <Rhapsody installation directory>\RP_CODEGENTRANS_DLL.dll to a backup folder.
  8. After extracting the contents of the .zip file, run C:\Windows\System32\cmd.exe to open a command prompt.
    (Don't use cmd.exe that is located under C:\Windows\SysWOW64.)
  9. Using the command prompt, switch to the directory containing setup.bat and run setup.bat with administrator privileges.
  10. Click Update in the InstallShield Wizard.
  11. Click Finish when the installation is done.

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: Rhapsody831iFix002b_x64.zip
  4. Move the contents of the folder <Rhapsody installation directory>\RTCIntegration to a backup folder.
  5. Move the file <Rhapsody installation directory>\Share\Profiles\RhapsodyModelManager\com.ibm.rational.rhapsody.rmm.client_lib\com.ibm.rational.rhapsody.rmm.svg_6.0.600.201805082129.jar to a backup folder.
  6. Move the file <Rhapsody installation directory>\RP_CODEGEN_DLL.dll to a backup folder.
  7. Move the file <Rhapsody installation directory>\RP_CODEGENTRANS_DLL.dll to a backup folder.
  8. After extracting the contents of the .zip file, run C:\Windows\System32\cmd.exe to open a command prompt.
    (Don't use cmd.exe that is located under C:\Windows\SysWOW64.)
  9. Using the command prompt, switch to the directory containing setup.bat and run setup.bat with administrator privileges.
  10. Click Update in the InstallShield Wizard.
  11. Click Finish when the installation is done.

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: Rhapsody831iFix002_x86_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. Move the file <Rhapsody installation directory>\Share\Profiles\RhapsodyModelManager\com.ibm.rational.rhapsody.rmm.client_lib\com.ibm.rational.rhapsody.rmm.svg_6.0.600.201805082129.jar to a backup folder.
    5. 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.)
    6. Use "extract here" to extract the contents of RhapsodyRoot.zip, answering "yes" to override existing files.
    7. 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 or under the directory C:\ProgramData\IBM\Rational\Rhapsody.)
    8. Open RhapsodyShare.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.)
    9. Use "extract here" to extract the contents of RhapsodyShare.zip, answering "yes" to override existing files.
    10. Run C:\Windows\System32\cmd.exe to open a command prompt.
      (Don't use cmd.exe that is located under C:\Windows\SysWOW64.)
    11. Using the command prompt, switch to the directory where you extracted the contents of the .zip file for the iFix, and run the following command with administrator privileges: post_install.bat 32bit 8.3.1

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: Rhapsody831iFix002_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. Move the file <Rhapsody installation directory>\Share\Profiles\RhapsodyModelManager\com.ibm.rational.rhapsody.rmm.client_lib\com.ibm.rational.rhapsody.rmm.svg_6.0.600.201805082129.jar to a backup folder.
    5. 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.)
    6. Use "extract here" to extract the contents of RhapsodyRoot.zip, answering "yes" to override existing files.
    7. 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 or under the directory C:\ProgramData\IBM\Rational\Rhapsody.)
    8. Open RhapsodyShare.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.)
    9. Use "extract here" to extract the contents of RhapsodyShare.zip, answering "yes" to override existing files.
    10. Run C:\Windows\System32\cmd.exe to open a command prompt.
      (Don't use cmd.exe that is located under C:\Windows\SysWOW64.)
    11. Using the command prompt, switch to the directory where you extracted the contents of the .zip file for the iFix, and run the following command with administrator privileges: post_install.bat 64bit 8.3.1

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: Rhapsody831iFix002-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_iFix2 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 002" 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
  5. Delete the file <Rhapsody installation directory>\Share\Profiles\RhapsodyModelManager\com.ibm.rational.rhapsody.rmm.client_lib\com.ibm.rational.rhapsody.rmm.svg_*.jar
  6. Restore the file <Rhapsody installation directory>\Share\Profiles\RhapsodyModelManager\com.ibm.rational.rhapsody.rmm.client_lib\com.ibm.rational.rhapsody.rmm.svg_6.0.600.201805082129.jar from the backup that you created during the installation
  7. Restore the file <Rhapsody installation directory>\RP_CODEGEN_DLL.dll from the backup that you created during the installation
  8. Restore the file <Rhapsody installation directory>\RP_CODEGENTRANS_DLL.dll 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. Delete the file <Rhapsody installation directory>\Share\Profiles\RhapsodyModelManager\com.ibm.rational.rhapsody.rmm.client_lib\com.ibm.rational.rhapsody.rmm.svg_*.jar
    2. Restore the file <Rhapsody installation directory>\Share\Profiles\RhapsodyModelManager\com.ibm.rational.rhapsody.rmm.client_lib\com.ibm.rational.rhapsody.rmm.svg_6.0.600.201805082129.jar from the backup that you created during the installation
    3. Restore the content of any folders or files that you backed up during the installation
    4. 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 002)" 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.