IBM Support

IBM Rational Rhapsody 8.2.1



IBM Rational Rhapsody 8.2.1 has been made generally available and contains fixes to version 8.2 including all predecessor fix packs.

Download Description

Table of Contents
Sections Description

The Change history section provides an overview on what is new in this release with a description of any new functions or enhancements when applicable.

The How critical is this fix section provides information related to the impact of this release to allow you to assess how your environment may be affected.

The Prerequisites section provides important information to review prior to the installation of this release.

The Download package section provides the direct link to obtain the download package for installation in your environment.

The Installation instructions section provides the installation instructions necessary to apply this release into your environment.

The Known side effects section contains a link to the known problems (open defects) identified at the time of this release.

Supporting Documentation
Document Description

Click to review the detailed system requirements information for a complete list of hardware requirements, supported operating systems, prerequisites and optional supported software, with component-level details and operating system restrictions.

IBM Knowledge Center provides an entry point to product documentation. You can view, browse, and search online information related to the product.

Click to review a complete list of the defects (APARs) resolved in this release including a list of resolved defects for the entire version family.

Click for information about the migration of existing Rational Rhapsody projects to this version of the product.

Find technical developer content and resources.


Prerequisites include:

Review the Pre-installation tasks section in IBM Knowledge Center.

Installation Instructions

Review the installation page in IBM Knowledge Center.

Before installation, review the Planning the installation section in IBM Knowledge Center.

After installation, review the Post-installation tasks section in IBM Knowledge Center.

Download Package

Download options
Access type Description

Passport Advantage and Passport Advantage Express clients are required to sign in to download the software package.

IBM Software Group OEM offerings are designed for partners who develop and sell business solutions with embedded or bundled IBM middleware software. Clients with Flexible Contract Type (FCT) license purchases and IBM Business Partners must sign in to download the software package.

How critical is this fix?

Impact Assessment
Impact Description

This is a maintenance release. It contains fixes for client-reported and internally found defects.

Test Results


Regression: An error in the Maintenance Delivery Vehicle (MDV) that produces incorrect or unexpected behavior causing a supported feature to stop functioning as designed.
This includes:

  • Coding errors that cause a regression
  • Documentation or packaging problems that cause a regression
  • Errors reported in a new function delivered in a MDV that cause a regression

Incomplete: An error in the MDV has not regressed, but does not work as designed.
This includes:

  • Fixed APARs which did not solve the original problem but did not break anything new
  • APARs reporting documentation errors, such as readme errors, that cause problems applying an MDV but do not lead to a regression

  • Regression and incomplete APARs are considered fix-in-error or MDV-in-error
  • Definitions above apply only to valid APARs that result in product fixes (APARs returned as working-as-designed are not assessed for being fix-in-error)
  • Issues in major releases due to new functionality do not apply in this definition

There are no known regressions to report.

Problems Solved

Defects resolved

Fix List

Known Side Effects

Review the following list of known issues and open defects:

There are no known issues to report.

Open defects

Review technote 1461170: Open APARs for Rational products available on the Web for information on how to configure your MyNotifications subscription account and subscribe to the APARs you are interested in following.

Change History

What's new

AUTOSAR 4.3.0 support

Rational Rhapsody now supports AUTOSAR 4.3.0 modeling.

AUTOSAR: ARXML import and export

A number of changes were made to improve performance when importing or exporting to ARXML.

AUTOSAR: greater differentiation between icons

New icons were added to make it easier to differentiate between element icons and diagram icons in the browser when modeling with the AUTOSAR profile.

AUTOSAR: migration of projects to newer or older versions of AUTOSAR

The range of available versions has been extended for the migration of existing AUTOSAR projects to newer versions of AUTOSAR. Beginning in this release, you can also migrate existing projects to older versions of AUTOSAR.For the exact versions available, see the user interface.

Ada code generation: initialization of discriminant attribute for class instantiated with a relation

Prior to release 8.2.1, a value could be set for a discriminant attribute for classes instantiated with a part. Now, you can also set a value for a discriminant attribute for classes instantiated with a relation.

Ada code generation: support for additional types

Code generation in Ada now supports a number of additional predefined types for UML and SysML models: Real, UnlimitedNatural, and Untyped.

Code generation: InvokePostProcessor property

The keyword $FullCodeGeneratedFileName, which represents the path to the generated file, can now be used in the property CG::File::InvokePostProcessor.

Configuration management: automatic delivery of changes in RTC (Rational Team Concert)

In addition to the option of having modifications made to units in Rhapsody automatically checked-in to RTC (introduced in release 8.2), you can now have modifications to units automatically checked-in and delivered.

Decorations on elements: multiple enhancements

A number of enhancements have been made to the element decoration feature, including: 1) better default location of decoration on element 2) ability to customize the exact location of the decoration 3) performance improvements. In addition, the issues that existed when applying decorations to certain types of elements have been resolved.

Diagrams and Browser: custom views

You can now define Custom View elements for your model to act as filters in determining which elements should be displayed in a given diagram and how the elements should be formatted. Custom Views can be applied individually or in combination in order to customize the appearance of a diagram. Custom Views can also be used to filter the display of model elements in the browser.

Diagrams: creation of Object Model Diagrams in response to Activity Diagram changes

In Activity Diagrams that have swimlanes representing classifiers, if you connect two actions with a control flow or object flow, an Object Model Diagram will be created and it will contain the relevant elements, connected by flows. Note that this feature requires the ModelSynchronization profile.

Diagrams: enhancement of ability to add shortcut list to graphic elements

In release 8.2, the ability to add a shortcut list to graphic elements was introduced for classes, objects, and composite classes. In this release, this ability has been expanded to include other types of graphic elements, including: attribute, comment, constraint, interface, instance specification, operation, package, requirement, stereotype, tag, and type.

Diagrams: Locate in Diagram

When you select Locate in Diagram, the relevant element in the diagram is now highlighted with a flashing color outline for a few seconds. There are a number of properties that can be used to customize the color used for highlighting, and to control how many times the element flashes and the frequency of the flashing. You can find these properties by searching for "LocateInDiagram" on the Properties tab.

Diagrams: Re-Route All - addition of keyboard shortcut

In addition to the Re-Route All menu item, you can now use the Ctrl+Shift+R shortcut to re-route all of the connectors in a diagram.

Diagrams: back and forward navigation buttons

In this release, a change was made to the behavior of the back/forward diagram navigation buttons. Now, when you press the back button, you will be taken to the diagram that you last visited.

Diagrams: hovering Drawing toolbar

In addition to the standard Drawing toolbar, Rational Rhapsody now provides a hovering Drawing toolbar, which is displayed near the current location of the cursor on the drawing canvas. This toolbar is displayed when you click the canvas or a diagram element with the left mouse button. The hovering toolbar is context-sensitive, displaying the icons that are relevant for the current context. For example, if an item such as a class or object is selected on the diagram, the toolbar will display the various connector icons.

Diagrams: new layouts for Populate Diagram and Rearrange

When you select the Populate Diagram or Rearrange options, new layout policies are now available, in addition to the existing Hierarchical and Orthogonal layouts. (Note that the ReArrange submenu is now called Layout.)

Diagrams: straightening of connectors in diagrams

A new property, General::Graphics::SnapEdgeAlignmentDistance, was added to make it easier to straighten connectors that have bends in them. When the distance required to straighten such a connector is smaller than the value set for this property, you only have to move the connector slightly in the appropriate direction, and the connector will "snap" to the point required to make it straight.

Features dialog: Criteria tab for Queries and Table Layouts

In the Features dialog for Queries and Table Layouts, the Criteria tab (formerly the Element Types & Criteria tab) is now aligned with the Search dialog and provides the same filtering capabilities.

MXF framework: increased MISRA compliance

Changes have been made to the MXF framework in order to increase compliancy with the MISRA standard.

Properties: export of property information to csv file

It is now possible to export the property information for the currently selected element to a csv file. The output is always a reflection of the information displayed on the Properties tab of the Features window. So if you select a filter for viewing the properties, that filter will be reflected in the generated csv file. A number of properties are provided for customizing the csv output.

RTC integration: inclusion of project name in change set comment

When you use the automatic check-in feature, the default change set comment now includes the name of the project. You can customize this comment by modifying the value of the property UnitAutomaticChangeSetComment. For information on other keywords that you can use with conditional properties, see the topic titled "Conditional properties" in the Rhapsody KC (

ReporterPLUS: including tables and matrices as HTML tables

Beginning in this release, for HTML reports generated with ReporterPLUS, you can have tables and matrices from your model included as HTML tables rather than as images (for an example, see the TabularViewsHTML.tpl template).

ReporterPLUS: support for ReporterPLUS in 64-bit version of Rational Rhapsody

ReporterPLUS is now available in the 64-bit version of Rational Rhapsody.

Repository files: detection of changes made outside of Rhapsody

If changes are made outside of Rhapsody to files that represent units, Rhapsody will now notify you of the change and ask if you want to reload the file. (If you want to turn this feature off, add the following variable to the [General] section of your rhapsody.ini file: SandBoxWatcher=false.)

Rhapsody API: additional search criteria for IRPSearchQuery

Additional methods have been added to the IRPSearchQuery interface to allow API-based searches to use all of the search criteria that are available in the Rhapsody GUI.

Rhapsody API: new methods added to RPApplicationListener

Two new methods have been added to the RPApplicationListener class - activeProjectAboutToChange and activeProjectHasChanged. The method activeProjectAboutToChange is triggered when the user selects a different project to serve as the "active" project. The method activeProjectHasChanged is triggered after Rhapsody has changed the "active" project to the one that the user selected.

Rhapsody DM client: partial loading of requirement collections

For collections of remote requirements, you can now choose to load all the requirements, none of the requirements, or only the requirements that have OSLC links to model elements.

Rhapsody Design Manager - Simulink models: hotspot location in diagrams

Improvements have been made in terms of hotspot location for Simulink diagrams in Design Manager.

Rhapsody Design Manager - Simulink models: importing models with nested subsystems

Changes were made to the mechanism for importing Simulink models in order to overcome the following two issues: 1) subsystems with identical names at different levels 2) name of nested path being too long

Rhapsody Design Manager - Simulink models: improved diagram quality

Changes were made to the handling of graphics when importing Simulink models to RDM. In addition to making the import process smoother, these changes result in clearer graphics after import to RDM.

Rhapsody Design Manager - Simulink models: improvements to import process

A number of improvements have been made to reduce the time required for importing Simulink models. In addition, models are now checked for modifications before import. If no changes were made, the model is not imported. A progress bar has also been added, to reflect the progress of the import.

Rhapsody Design Manager - Simulink models: support for MatLab 2016b

RDM now supports Simulink models from MatLab 2016b.

Rhapsody in Ada: warnings during framework compilation

To prevent warnings during the compilation of the RiA frameworks, the -gnatwX option was added to the GNAT configurations for the frameworks.

RulesComposer: loading when Rational Rhapsody API files cannot be found

In cases where the files for the Rational Rhapsody API cannot be found, RulesComposer can now be launched in degraded mode.

RulesComposer: progress bar during loading

A progress bar is now displayed while RulesComposer loads.

RulesComposer: update-site archive for Eclipse Neon (Eclipse 4.6)

RulesComposer workbench has not yet been migrated to Eclipse Neon, however, the update-site archive has been updated to allow the integration of RulesComposer into Eclipse Neon.

Saving Rational Rhapsody models in XML format

As part of the planned move to saving models in XML format, this feature has been introduced in the current iteration as a tech preview. To have Rhapsody save models in XML, add the following variables to the General section of your rhapsody.ini file: WriteXML=TRUE, ShowMissingXMLAttributeMessage=TRUE. Note that at this stage the new XML format cannot be used with: 1) Design Manager 2) Reverse engineering in the 64-bit version of Rhapsody 3) Gateway 4) Models where units have been added without being copied to the project directory

Search and replace: UI enhancements

A number of user interface enhancements have been made to the Search and Refactor features.

Software Architect in 64-bit version of Rhapsody

There is now a 64-bit version of Rational Rhapsody Architect for Software

TestConductor: user-defined mapping of instance lines when creating tests from sequence diagrams

TestConductor now supports user-defined mapping of instance lines (including split/merge) when creating a test case from an existing sequence diagram / test scenario.

TestConductor: navigation to problematic diagram elements when creating test case from sequence diagram

When sequence diagrams are used for creating test cases, you can now navigate directly from problem reports to the problematic message or instance line in the sequence diagram.

TestConductor: sample for use of TC assert macros when testing RAL model

The installation now includes a sample (CppCompositeCoffeeMachine_RAL) that demonstrates the use of assert macros when testing models that use Rhapsody's action language.

TestConductor: support for Rhapsody's action language

TestConductor now supports testing of models that use Rhapsody's action language.

XMI Toolkit: import of SysML 1.4 models

XMI can now import models that use SysML 1.4 into Rhapsody.

[{"Product":{"code":"SSB2MU","label":"IBM Engineering Systems Design Rhapsody"},"Business Unit":{"code":"BU059","label":"IBM Software w\/o TPS"},"Component":"Installation","Platform":[{"code":"PF016","label":"Linux"},{"code":"PF033","label":"Windows"}],"Version":"8.2.1","Edition":"","Line of Business":{"code":"LOB59","label":"Sustainability Software"}}]

Product Synonym

Rational Rhapsody

Problems (APARS) fixed

Document Information

Modified date:
27 May 2022