Readme for Rational Rhapsody 8.3.1 iFix004

Changes in iFix004

Changes in iFix003

Changes in iFix002

Changes in iFix001

Installation instructions

Rhapsody APARs Fixed with 8.3.1 iFix004

Category APAR ID Summary
Activity Diagram PH09777 cannot show stereotype for CallBehavior element
AUTOSAR PH07881 Win10: Some elements not available from the AUTOSAR_40 context menu in Rational Rhapsody on Windows 10 Pro
AUTOSAR PH09004 AUTOSAR 4.x does not have Read Statements
Browser PH14048 packages are not loaded due to convert problem to rpyx
Code Generation PH06717 C CLASS ENUMERATION COMMENTS ARE NOT COPIED INTO DERIVED CLASS ENUMERATION
Code Generation PH09404 CG crash with big model
DiffMerge PH13404 Converted to xml format model is corrupted and causes DiffMerge crash and loss of unresolved packages
Features Dialog PH10938 crash when implicit object with ports is changed to type class
Graphic Editor - General PH09270 Deleting a Diagram View causes the original diagram to have diagram elements deleted.
Graphic Editors PH10481 Stereotype ("Association") is listed multiple times in the stereotype dropdown list.
Model Checker PH07870 Check Model: deselect all is not saved
Modeling - General PH10014 Spline line "User Points" are removed when the connected constraint parameter is moved.
Profiles - General PH04128 Rhapsody crashes with maximum no.(100) of plugins loaded.
Reporter Plus Templates PH05976 ReporterPLUS: Java error in HTML sample report when navigating
Repository PH09830 Need DebugTree: CONVERSION FROM .SBS TO .SBSX IS RESULTING IN PACKAGES THAT CAUSE RHAPSODY TO CRASH
Reverse Engineering PH12396 Reverse engineering fail to to identify  variable array as volatile
Reverse Engineering PH12399 Code generation of dependency on volatile variable don't add the "volatile" key word  to the dependency.
TestConductor PH10924 TestConductor Testcase Execution in Animation Mode often not possible
Use Case Diagram PH10769 Usecase diagram: duplicated ID and crash when adding a UCD with dependents
Use Case Diagram PH10833 Crash when Adding to model a UseCase diagram with dependents

Rhapsody Model Manager - Defects Fixed in 8.3.1 iFix004

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 or higher for Rational Collaborative Lifecycle Management Solution 6.0.6.

Category APAR or Defect ID Summary
RMM Rhapsody Client 69083 Block user of working with RMM Models, if they do not have the RMM Extension installed.
RMM Rhapsody Client 69782 RMM: Diff-Merge: Merging the Project renames the project to merged-content853153996924472887
RMM Rhapsody Client 69922 Remote requirement specification with "<" ">" chars displayed as "<" & ">"
RMM Rhapsody Client PH09558 Rhapsody model is modified after opening the model from RTC SCM
RMM Rhapsody Client 69942 Unable to resolve DNG artifacts that are owned by a team area
RMM Rhapsody Client 69965 Unresolved remote artifact diagram tooltip displays artifact name
RMM Rhapsody Client 70097 RRDG report on RMM mod+el: OSLC links displayed twice (template ProjectContentReportWithLinks.dta)
RMM Rhapsody Client PH10703 LINKS TO REMOTE REQUIREMENTS ARE NOT FULLY LOADED WITH IN RHAPSODY CLIENT
RMM Rhapsody Client PH11443 RMM: RT: Force Roundtrip removes OSLC Links of types "Derives From", "Refines", "Satisfies", "Trace"
RMM Rhapsody Client 70615 RMM: ImportFromDM: External Links get altered while Migrate OSLC Link, and after reopen
RMM Rhapsody Client PH12809 Request going out to RQM server to fetch linked RQM test case is missing the GC context
RMM Rhapsody Client PH12993 Rhapsody 8.3.1 with RMM causes unnecessary edits to be saved
RMM Rhapsody Client 70762 Crash: RMM: While closing sample model after opening big table View (+call stack)
RMM Rhapsody Client PH13346 UNWANTED CHANGES SHOWING UP IN DIFFMERGE
RMM Server 69893 Crash on refresh remote OSLC data after deleting a linked CCM artifact in CCM web client

iFix004 for Rhapsody 8.3.1 includes the following fixes, which were included in iFix003.

Rhapsody APARs Fixed with 8.3.1 iFix003

Category APAR ID Summary
Add to Model PH00103 Rhapsody reports an error finding the referenced package and deletes previously added package on next reload
Checker PI97769 Check Model crash of Activity Diagram
Checker PI98594 NeedDebugTree:Model Check crash on model elements with RhapsodyRuntimeException: operation completed successfully
Checker PH07793 Rational Rhapsody crash while performing model check on some specific models.
Code Generation PH05507 Unable to call triggered operation via ports using OPORT macro
DiffMerge PH01741 DiffMerge crash when saving the merged model
DiffMerge PH03054 DiffMerge is crashing
Eclipse Rhapsody Plug-in PH00707 Rhapsody PLI, WFI and RTC Integration With Eclipse Prevents Eclipse from Restarting and Also throws Workspace in use Message.
Features Dialog PH04164 Rhapsody Crash on removing the interface block from proxy port
Graphic Editors PH03969 memory not released when working in diagrams leading to crash when using big models
Graphic Editors PH05394 NOT ABLE TO CREATE CONNECTION BETWEEN TWO PORT
Graphic Editors PI84730 RHAPSODY 8.1.5 CRASH IN LINUX/WINDOWS
Java API (COM) PH07624 Merging fix for escalation 82168 to Dev streams (original from testfix on 815 for GM)
Modeling PH04450 STEREOTYPE ORDER ON A MODEL ELEMENT AFFECTS APPLICATION OF PROPERTIES
Modeling PH05684 anchors point to wrong element and corrupt model
Profiles PH04128 Rhapsody crashes with maximum no.(100) of plugins loaded.
Report on Model PH01754 When reporting on model with reception on activity diagram Rhapsody throws a ReporterPLUS COM error
Sequence Diagram Compare PH06977 Sequence diagram lifelines are incorrectly duplicated after drag/drop operation from Browser
Statechart PH07688 Rhapsody crash while working on inherited state chart on Linux.
SysML PH06491 Properties to make compartment display options of FlowSpecifications the default don't work properly
TestConductor PH03966 TestConductor: Wrong Rhapsody’s code generation for test components with flowports
TestConductor PH04281 REGRESSION: TestConductor do not work with Willert RXF framework
User Interface PH07342 Rhapsody 8.3.1 does not react to changed read-only attribute.
User Interface PH08941 Changing the Display Option from Name to Label no longer removes the path name.
XMI PI97956 XMI IMPORT USING "AUTOMATIC MERGING" IS NOT FUNCTIONING
Graphic Editors PH09270 Deleting a Diagram View deletes elements from the original diagram

Rhapsody Model Manager - Defects Fixed in 8.3.1 iFix003

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 or higher for Rational Collaborative Lifecycle Management Solution 6.0.6.

Category APAR or Defect ID Summary
RMM Rhapsody Client PH05652 OSLC picker is throwing an error in the Rhapsody client for linking the model from second stream to a CCM work item
RMM Rhapsody Client 68559 Run RMM OSLC Plugin should run in a separate class loader
RMM Rhapsody Client 68634 Collection status is not refreshed on refresh collection which is set with "Linked" populate mode
RMM Rhapsody Client 68735 Support DNG enumeration data types with enums which has "RDF URI"
RMM Rhapsody Client 68792 Cannot login to RM
RMM Rhapsody Client 68794 Rhapsody will not load remote links - even after a refresh the collection says 1% loaded when using none default RM application name
RMM Rhapsody Client 68837 Following open GC picker one of Remote Artifact Packages is marked as login
RMM Rhapsody Client 68908 CCM WI which has quotation mark on its summary displays "<failure>" as its name in Rhapsody
RMM Rhapsody Client 68909 CCM WI in GC has no value on Status tag and is missing Priority Tag
RMM Rhapsody Client 68953 Crash on close model
RMM Rhapsody Client 69007 CustomOslcArtifactAppearance should be refreshed on model open
RMM Rhapsody Client 69041 Rhapsody fails to get CCM artifact data in case of using CCM PA as tool mapping criteria
RMM Rhapsody Client 69151 On Add New / Existing collection browser is not refreshed with added collection
RMM Rhapsody Client 69328 SSO - Failed to open remote artifact OSLC Picker on OSLC link creation
RMM Rhapsody Client 69344 RMM does not uses predefined "refine" & "trace" dependency stereotype instead of SysML "refine " & HarmonySE "trace" terms
RMM Rhapsody Client 69504 RMM: User cannot get rid of the message Enable RMM after migrating a project
RMM Rhapsody Client 69505 RMM Versions compatible: The RMM profile restored and enable after error message
RMM Rhapsody Client 69619 RMM: Automatic update from server failed for Rhapsody831 Release when rhapsody
RMM Rhapsody Client 69720 Support 9 digits DOORS artifact ID
RMM Rhapsody Client 69741 Having a DNG view in the model cause to RMM refresh button to have modification mark
RMM Rhapsody Client 69813 Remote OSLC links fail to load due to failure of log creation
RMM Web Client 68869 RMM: Diagrams on Web: Warning "Image is not synchronized with diagram" always appears, publishes/updates/refreshes don't help

Rhapsody Design Manager - Defects Fixed in 8.3.1 iFix003

Category APAR or Defect ID Summary
RDM Rhapsody Client PH04351 MODEL ELEMENTS DISAPPEAR FROM DIAGRAM ONCE IT IS LOADED FROM THE SERVER
RDM Rhapsody Client PH08666 Rhapsody is crashing when expanding a package after opening a BDD for model from DM server
RDM Rhapsody Client PI87256 Stereotype applied on dependency disappear from diagram while opening model from DM
RDM Rhapsody Client 69800 File Fake error while working with Block or BDD in DM

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

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: Rhapsody831iFix004_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_*.jar to a backup folder.
  6. Move the file <Rhapsody installation directory>\Share\DesignManager\Communicator\plugins\com.ibm.rational.rhapsody.jazz.svg_*.jar to a backup folder.
  7. Move the file <Rhapsody installation directory>\RP_CODEGEN_DLL.dll to a backup folder.
  8. Move the file <Rhapsody installation directory>\RP_CODEGENTRANS_DLL.dll to a backup folder.
  9. If you installed XMI Toolkit when you installed Rational Rhapsody, move the following files to a backup folder:
    1. <Rhapsody installation directory>\Sodius\XMI_Toolkit\lib\mdworkbench\com.sodius.mdw.UML21toRhapsody_*.jar
    2. <Rhapsody installation directory>\Sodius\XMI_Toolkit\lib\mdworkbench\com.sodius.toolkit.rhapsody_*.jar
    3. <Rhapsody installation directory>\Sodius\XMI_Toolkit\lib\XMI4Rhapsody.jar
    4. <Rhapsody installation directory>\Sodius\XMI_Toolkit\resources\install.ini
    5. <Rhapsody installation directory>\Sodius\XMI_Toolkit\doc\XMI_Toolkit_Changes.pdf
  10. 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.)
  11. Using the command prompt, switch to the directory containing setup.bat and run setup.bat with administrator privileges.
  12. Click Update in the InstallShield Wizard.
  13. Click Finish when the installation is done.
  14. If you plan on using the integration with Rational Team Concert or Rhapsody Model Manager, open your Rational Team Concert client and install the new integration plugins that are provided with this iFix (located in the RTCIntegration folder).

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: Rhapsody831iFix004_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_*.jar to a backup folder.
  6. Move the file <Rhapsody installation directory>\Share\DesignManager\Communicator\plugins\com.ibm.rational.rhapsody.jazz.svg_*.jar to a backup folder.
  7. Move the file <Rhapsody installation directory>\RP_CODEGEN_DLL.dll to a backup folder.
  8. Move the file <Rhapsody installation directory>\RP_CODEGENTRANS_DLL.dll to a backup folder.
  9. If you installed XMI Toolkit when you installed Rational Rhapsody, move the following files to a backup folder:
    1. <Rhapsody installation directory>\Sodius\XMI_Toolkit\lib\mdworkbench\com.sodius.mdw.UML21toRhapsody_*.jar
    2. <Rhapsody installation directory>\Sodius\XMI_Toolkit\lib\mdworkbench\com.sodius.toolkit.rhapsody_*.jar
    3. <Rhapsody installation directory>\Sodius\XMI_Toolkit\lib\XMI4Rhapsody.jar
    4. <Rhapsody installation directory>\Sodius\XMI_Toolkit\resources\install.ini
    5. <Rhapsody installation directory>\Sodius\XMI_Toolkit\doc\XMI_Toolkit_Changes.pdf
  10. 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.)
  11. Using the command prompt, switch to the directory containing setup.bat and run setup.bat with administrator privileges.
  12. Click Update in the InstallShield Wizard.
  13. Click Finish when the installation is done.
  14. If you plan on using the integration with Rational Team Concert or Rhapsody Model Manager, open your Rational Team Concert client and install the new integration plugins that are provided with this iFix (located in the RTCIntegration folder).

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: Rhapsody831iFix004_x86_archive.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. Back up the folder <Rhapsody installation directory>\Share\Profiles\AUTOSAR.
    4. Back up the folder <Rhapsody installation directory>\Share\Profiles\HarmonySE.
    5. Back up the folder <Rhapsody installation directory>\TestConductor.
    6. Move the contents of the folder <Rhapsody installation directory>\RTCIntegration to a backup folder.
    7. Move the file <Rhapsody installation directory>\Share\Profiles\RhapsodyModelManager\com.ibm.rational.rhapsody.rmm.client_lib\com.ibm.rational.rhapsody.rmm.svg_*.jar to a backup folder.
    8. Move the file <Rhapsody installation directory>\Share\DesignManager\Communicator\plugins\com.ibm.rational.rhapsody.jazz.svg_*.jar to a backup folder.
    9. 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.)
    10. Use "extract here" to extract the contents of RhapsodyRoot.zip, answering "yes" to override existing files.
    11. 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.)
    12. 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.)
    13. Use "extract here" to extract the contents of RhapsodyShare.zip, answering "yes" to override existing files.
    14. If you installed XMI Toolkit when you installed Rational Rhapsody, copy XMI_Toolkit.zip into the <Rhapsody installation directory>\Sodius\XMI_Toolkit folder.
      1. Open XMI_Toolkit.zip to see which files are going to be replaced, and back up the files that are going to be replaced. (You will need these files if you decide later to uninstall the iFix.)
      2. Move the file <Rhapsody installation directory>\Sodius\XMI_Toolkit\lib\mdworkbench\com.sodius.mdw.UML21toRhapsody_*.jar to a backup folder.
      3. Move the file <Rhapsody installation directory>\Sodius\XMI_Toolkit\lib\mdworkbench\com.sodius.toolkit.rhapsody_*.jar to a backup folder.
      4. Use "extract here" to extract the contents of XMI_Toolkit.zip, answering "yes" to override existing files.
    15. Run C:\Windows\System32\cmd.exe to open a command prompt.
      (Don't use cmd.exe that is located under C:\Windows\SysWOW64.)
    16. 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
  5. If you plan on using the integration with Rational Team Concert or Rhapsody Model Manager, open your Rational Team Concert client and install the new integration plugins that are provided with this iFix (located in the RTCIntegration folder).

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: Rhapsody831iFix004_x64_archive.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. Back up the folder <Rhapsody installation directory>\Share\Profiles\AUTOSAR.
    4. Back up the folder <Rhapsody installation directory>\Share\Profiles\HarmonySE.
    5. Back up the folder <Rhapsody installation directory>\TestConductor.
    6. Move the contents of the folder <Rhapsody installation directory>\RTCIntegration to a backup folder.
    7. Move the file <Rhapsody installation directory>\Share\Profiles\RhapsodyModelManager\com.ibm.rational.rhapsody.rmm.client_lib\com.ibm.rational.rhapsody.rmm.svg_*.jar to a backup folder.
    8. Move the file <Rhapsody installation directory>\Share\DesignManager\Communicator\plugins\com.ibm.rational.rhapsody.jazz.svg_*.jar to a backup folder.
    9. 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.)
    10. Use "extract here" to extract the contents of RhapsodyRoot.zip, answering "yes" to override existing files.
    11. 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.)
    12. 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.)
    13. Use "extract here" to extract the contents of RhapsodyShare.zip, answering "yes" to override existing files.
    14. If you installed XMI Toolkit when you installed Rational Rhapsody, copy XMI_Toolkit.zip into the <Rhapsody installation directory>\Sodius\XMI_Toolkit folder.
      1. Open XMI_Toolkit.zip to see which files are going to be replaced, and back up the files that are going to be replaced. (You will need these files if you decide later to uninstall the iFix.)
      2. Move the file <Rhapsody installation directory>\Sodius\XMI_Toolkit\lib\mdworkbench\com.sodius.mdw.UML21toRhapsody_*.jar to a backup folder.
      3. Move the file <Rhapsody installation directory>\Sodius\XMI_Toolkit\lib\mdworkbench\com.sodius.toolkit.rhapsody_*.jar to a backup folder.
      4. Use "extract here" to extract the contents of XMI_Toolkit.zip, answering "yes" to override existing files.
    15. Run C:\Windows\System32\cmd.exe to open a command prompt.
      (Don't use cmd.exe that is located under C:\Windows\SysWOW64.)
    16. 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
  5. If you plan on using the integration with Rational Team Concert or Rhapsody Model Manager, open your Rational Team Concert client and install the new integration plugins that are provided with this iFix (located in the RTCIntegration folder).

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: Rhapsody831iFix004-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_iFix3 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 004" 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 and uninstall it
  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. Delete the file <Rhapsody installation directory>\Share\Profiles\RhapsodyModelManager\com.ibm.rational.rhapsody.rmm.client.bootstrap.jar
  7. Delete the file <Rhapsody installation directory>\Share\DesignManager\Communicator\plugins\com.ibm.rational.rhapsody.jazz.svg_*.jar
  8. Restore the file <Rhapsody installation directory>\Share\Profiles\RhapsodyModelManager\com.ibm.rational.rhapsody.rmm.client_lib\com.ibm.rational.rhapsody.rmm.svg_*.jar from the backup that you created during the installation
  9. Restore the file <Rhapsody installation directory>\Share\DesignManager\Communicator\plugins\com.ibm.rational.rhapsody.jazz.svg_*.jar from the backup that you created during the installation
  10. Restore the file <Rhapsody installation directory>\RP_CODEGEN_DLL.dll from the backup that you created during the installation
  11. Restore the file <Rhapsody installation directory>\RP_CODEGENTRANS_DLL.dll from the backup that you created during the installation
  12. Restore the file <Rhapsody installation directory>\RP_CODEGENTRANS_DLL.dll from the backup that you created during the installation
  13. If you installed XMI Toolkit when you installed Rational Rhapsody:
    1. Delete the file <Rhapsody installation directory>\Sodius\XMI_Toolkit\lib\mdworkbench\com.sodius.mdw.UML21toRhapsody_*.jar
    2. Delete the file <Rhapsody installation directory>\Sodius\XMI_Toolkit\lib\mdworkbench\com.sodius.toolkit.rhapsody_*.jar
    3. Restore the files under <Rhapsody installation directory>\Sodius\XMI_Toolkit that you backed up 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
      • <Rhapsody installation directory>\TestConductor
    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. Delete the file <Rhapsody installation directory>\Share\Profiles\RhapsodyModelManager\com.ibm.rational.rhapsody.rmm.client.bootstrap.jar
    3. Delete the file <Rhapsody installation directory>\Share\DesignManager\Communicator\plugins\com.ibm.rational.rhapsody.jazz.svg_*.jar
    4. Restore the file <Rhapsody installation directory>\Share\Profiles\RhapsodyModelManager\com.ibm.rational.rhapsody.rmm.client_lib\com.ibm.rational.rhapsody.rmm.svg_*.jar from the backup that you created during the installation
    5. Restore the file <Rhapsody installation directory>\Share\DesignManager\Communicator\plugins\com.ibm.rational.rhapsody.jazz.svg_*.jar from the backup that you created during the installation
    6. Restore the content of any folders or files that you backed up during the installation
    7. Remove the file RhapsodyShare.zip
  3. If you installed XMI Toolkit when you installed Rational Rhapsody:
    1. Delete the file <Rhapsody installation directory>\Sodius\XMI_Toolkit\lib\mdworkbench\com.sodius.mdw.UML21toRhapsody_*.jar
    2. Delete the file <Rhapsody installation directory>\Sodius\XMI_Toolkit\lib\mdworkbench\com.sodius.toolkit.rhapsody_*.jar
    3. Restore the files under <Rhapsody installation directory>\Sodius\XMI_Toolkit that you backed up during the installation.

On Linux

  1. Open IBM Installation Manager.
  2. Click "Uninstall".
  3. Select "IBM Rational Rhapsody Developer 8.3.1 (iFix 004)" 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.