IBM Support

Rational Software Architect 8.5.5

Downloadable files


IBM Rational Software Architect, Version 8.5.5 has been made generally available on Passport Advantage and Fix Central.

Download Description

Table of Contents
Sections Description
This document provides an overview on what is new in this release with descriptions of new features and enhancements.
This section provides information related to the impact of this release to allow you to assess how your environment may be affected.
This section provides important information to review prior to the installation of this release.
This section provides the direct link to obtain the download package for installation in your environment.
This section provides the installation instructions necessary to apply this release into your environment.
This section contains a link to the known problems (open defects) identified at the time of this release.
Supporting Documentation
Document Description
Click the link to navigate to the system requirement report page. To run the report, select your Product, Version and Operating System. 
Note: Choose the parent version of your product to see the system requirements for fix pack releases.
The information center provides you with user assistance for Rational Software Architect. You can view, browse, and search online information related to the product.
Information about the supplemental software included with the product.
Click the link to find viewlets for some of the new or enhanced product features.
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.


Review the information about hardware and software requirements for installing the product in the system requirements.

Disk space requirements
You need the following disk space to store and extract the electronic parts, and install Rational Software Architect, Version 8.5:

Platforms Disk space required for compressed files Disk space required for extracted files Disk space required for installation
Windows, Linux 4.0 GB 5.0 GB 10 GB

Extracting the compressed files
Extract all compressed files into the same directory.

If you use FLEXlm floating or token licenses for your product and chargeable components, you must upgrade your license key server to Rational License Key Server, Version 8.1.2, or later, before installing the product.

Rational License Key Server, Version 8.1.2, or later, can used with earlier versions of the product.

For information about how to upgrade from v7.1.x or an earlier Rational License Key Server to v8.1.2, or later, see

Installation Instructions

Tab navigation

Tab navigation

Important: By default, you do not need to download the compressed files that contain the fix pack; the fix pack is downloaded and installed by IBM Installation Manager directly from the IBM update repository.

For instructions on installing this fix pack using Installation Manager, see the Installation instructions.

To download and install the fix pack from the compressed files:

  1. Download the fix pack files listed in the Download table below.
  2. Extract the compressed files in an appropriate directory. For example, extract the contents to C:\temp\update
  3. .
  4. Add the fix pack's repository location in IBM Installation Manager:
    1. Start IBM Installation Manager.
    2. On the Start page of Installation Manager, click File > Preferences, and then click Repositories. The Repositories page opens.
    3. On the Repositories page, click Add Repository.
    4. In the Add repository window, browse to or enter the file path to the diskTag.inf file, which is located in the disk1 sub-directory in the directory where you extracted the compressed files and then click OK. For example, enter C:\temp\update\disk1\diskTag.inf.
    5. Click OK to close the Preference page.
  5. Install the fix pack as described in the Installation instructions.

Tab navigation

Fix pack installation scenarios
There are two scenarios for installing the fix pack:
  • If IBM Rational Software Architect, Version 8.5, or later, is already installed on your computer, you can install this update by using the Update Packages wizard in IBM Installation Manager. For details, see Installing the fix pack as an update.
  • If you have not already installed product, you can install this update during the initial installation process by clicking Check for updates on the Install page of the Installing Packages wizard in IBM Installation Manager.

For information on how to install the product, see:

Installing the fix pack as an update
If IBM Rational Software Architect, Version 8.5, or later, is already installed on your system, then refer to the following sections for details on installing the fix pack as an update:

Restrictions for installing the fix pack as an update:

  • Rational Software Architect, Version 8.5, or later, must be installed.
  • The product cannot be open when you install this fix pack. Also, ensure that all browsers and other applications opened by Rational Software Architect are closed.
  • When installing the fix pack, use the same user account, or an ID with similar privileges, that you used to install Rational Software Architect v8.5.
  • If you installed the product from disks or downloaded installation files, they must be available when you use the update feature.

(Optional) Changing the repository search preferences

When Rational Software Architect is installed, the location of its update repository is automatically embedded in IBM Installation Manager. For Installation Manager to search the default update repository, the preference Search the linked repositories during installation and updates on the Repositories preference page must be selected. This preference is selected by default.

To install the fix pack from a different repository location (for example, if you downloaded the installation files, or if the fix pack is available on a shared drive or HTTP or HTTPS server), you must add the repository location in Installation Manager.

To add a repository location:

  1. Start Installation Manager.
  2. On the Start page of Installation Manager, click File > Preferences, and then click Repositories. The Repositories page opens.
  3. On the Repositories page, click Add Repository.
  4. In the Add repository window, enter the URL of the repository location or browse to it and enter a file path, and then click OK.
  5. Click OK to close the Preference page.

Steps for installing the fix pack as an update

To find and install the fix pack for Rational Software Architect, Version 8.5 as an update:

  1. Start IBM Installation Manager.
  2. On the Start page of Installation Manager, click Update.
  3. If a new version of Installation Manager is found, you are prompted to confirm that you want to install it before you can continue. Click OK to proceed. Installation Manager automatically installs the new version, stops, restarts, and resumes.
  4. In the Update packages wizard, select the Installed Location for Rational Software Architect and click Next. Installation Manager searches for updates in the Rational Software Architect repository on the web, as well as any repository locations that you entered. A progress indicator shows the search is taking place.
  5. By default, recommended updates are displayed and selected on the Update Package page. Ensure that you select Version 8.5.5 for Rational Software Architect, and then click Next.
  6. On the Licenses page, read the license agreements for the selected updates. On the left side of the License page, the list of licenses for the updates you selected is displayed; click each item to display the license agreement text. If you agree to the terms of all the license agreements, click I accept the terms of the license agreements and Click Next.
  7. On the Features page, select the features that you want to update and complete the following steps:
    1. learn more about a feature, click the feature and review the brief description under Details.
    2. If you want to see the dependency relationships between features, select Show Dependencies. When you click a feature, any features that depend on it and any features that are its dependents are shown in the Dependencies window. As you select or exclude features in the packages, Installation Manager will automatically enforce any dependencies with other features and display updated download size and disk space requirements for the installation.
    3. Click Next
  8. On the Summary page, review information displayed, and then click Update. A progress indicator shows the percentage of the installation completed.
  9. When the update process completes, a message that confirms the success of the process is displayed near the top of the page. Click View log file to open the log file for the current session in a new window. You must close the Installation Log window to continue.

Uninstalling the fix pack

You can revert to the previous version by using the rollback feature of Installation Manager. For instructions on uninstalling the product, see the Uninstalling product packages topic in the product information center.

The rollback feature uninstalls the updated resources and reinstalls the resources from the previous version. You can only roll back one version level at a time.

When you roll back to an earlier version of a package, it will be restored with same features that were associated with that version; any features that you added after updating to this fix pack for version 8.5 will be removed, and any features that you removed will be restored.

During the rollback process, Installation Manager must access files from the earlier version of the package. By default, these files are stored on your system when you install a package. If you changed the default setting or deleted the files by using the Remove Stored Files option on the Roll Back preferences page (File > Preferences > Rollback Files), Installation Manager will require access to your installation repository or media. If you installed the product from a repository, you must have listed in your Preferences (File > Preferences > Repositories) the repository from which you installed the previous version of the product. If you installed the product from disks or downloaded installation files, they must be available when you use the rollback feature.

Before you roll back this fix pack for Rational Software Architect, Version 8.5, complete the following steps:

  1. Log in with a user account that has the same privileges as the account that was used to install the packages to be uninstalled.
  2. Close Rational Software Architect and any other applications that you installed by using Installation Manager.
  3. If any applications started by Rational Software Architect are still open or running, such as a browser or WebSphere Application Server, close them.

To roll back an updated package, complete the following steps:
  1. Start IBM Installation Manager.
  2. On the Start page, click Roll Back.
  3. In the Rollback wizard, from the Package Group Name list, select the package group that contains the packages that you want to roll back and click Next.
  4. Select the version of the package that you want to roll back to and click Next.
  5. Read the summary information and click Roll Back.

For additional instructions on uninstalling Rational Software Architect, see the product information center or the IBM Installation Manager information center.

Download package

Download options
Access type Description
Passport Advantage Passport Advantage and Passport Advantage Express clients are required to sign in to download the software package.
IBM OEM software 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.
Fix Central Fix Central provides fixes and updates for your system's software, hardware, and operating system.

How critical is this fix?

Impact Assessment
Impact Description
Recommended This release is a service release of Rational Software Architect 8.5. It contains new features as well as 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 issues to report.

Problems solved

Click the Fix List link in the table of contents above to review a list of the problems solved in this release.

Known side effects

Known problems are recorded in individual documents in the Support knowledge base. As problems are discovered and resolved, the knowledge base will be updated and maintained with any new information. By searching the knowledge base, you can quickly find workarounds or solutions to problems.

To learn about the problems or limitations that were found in this version at the time of its release and any workarounds or solutions that are available, see IBM Support Portal.

The following defects were not resolved in this release.

APAR Description
PM86270 Unreadable characters on printed class diagrams
PM93931 Using Profile Tooling, closing diagrams/palette leads to "SWTError" and hanging
PM94736 Impossible to add an association instance for an association between classes generalizing the same class
PM95972 Adding an association instance for an association between classes generalizing the same class is not possible.
PM95486 Exception Occured running UPIA Modeling Generate Resource Exchanges
PM94084 Missing attributes in XSD from UML-to-WSDL transformation
PM95777 UML-to-WSDL transformation does not generate all Derived types
PM84070 In V8.0.4, analyze Topology for Automation Signature matches hangs
PM56184 Popup warnings like: "The license key for this product will expire in..." breaks automatic script.

Change history

See the New features and enhancments document for a complete description of the new features and enhancements in the version 8.5.x releases.

Download RELEASE DATE LANGUAGE SIZE(Bytes) Download Options
What is Fix Central(FC)?
Fix Central 13 Sep 2013 English 1 FC

Technical support

Tab navigation

IBM Rational Software Support Communities

  • Visit the IBM Support Portal to configure your support portal experience and review FAQs, lists of known problems, fixes, and a wealth of important support information.

  • Visit developerWorks to access an online collection of tutorials, sample code, standards, forums and other resources provided by experts at IBM to assist software developers using Rational tools including access to the IBM RFE Community.

  • Visit the Jazz Community if you use a Rational product created using the Jazz platform to interact directly with the Jazz development team and other community members, download product trials and betas and track developement progress.

Helpful Hints For Obtaining Technical Assistance:

Before you contact IBM Rational Software Support, gather the background information that you need to describe the problem. When you describe a problem to an IBM software support specialist, be as specific as possible and include all relevant background information so that the specialist can help you solve the problem efficiently. To save time, know the answers to these questions:

  • What software versions were you running when the problem occurred?
  • Do you have logs, traces, or messages that are related to the problem?
  • Can you reproduce the problem? If so, what steps do you take to reproduce it?
  • Is there a workaround for the problem? If so, be prepared to describe the workaround.

If you have helpful information to diagnose or identify the problem on your system, you can provide this data by following the instructions to exchange information with IBM Technical Support.

Follow IBM Rational Client Support on Twitter | Facebook | YouTube | devWorks Blog

Document information

More support for: Rational Software Architect

Software version: 8.5.5

Operating system(s): Linux, Windows

Reference #: 4035434

Modified date: 13 September 2013