Upgrading Rational Rhapsody

If you have an older version of the product, you can upgrade to a newer version in most situations. There are upgrade restrictions for the product depending on your upgrade situation.

About this task

These restrictions apply to the following upgrade situations:
  • All add-on features/software must be part of the same specific installation. For example, the IBM® Rational® Rhapsody® Gateway and Rational Rhapsody versions are coordinated for a specific installation. Therefore, an older version of Rational Rhapsody Gateway is not supported in an upgraded version of Rational Rhapsody. See the "System Requirements for Rational Rhapsody" page for a list of the supported software versions.
  • Before you upgrade to a Rational Rhapsody product that is in the same version number family, you must uninstall the previous Rational Rhapsody installation. For example, if Rational Rhapsody version 7.5.3 is already installed, you must remove that version before you install Rational Rhapsody version
    Note: You can have Rational Rhapsody version 7.5, version 7.6, and version 8.0 installed on the same machine. In addition, you can also have Rational Rhapsody versions 7.5.1, 7.5.2, and 7.5.3 installed as well.


  1. Remove the older version of Rational Rhapsody, if necessary. For Windows, see the topic on removing the product from a Windows system before you upgrade Rational Rhapsody. For Linux, see the topic on deleting the product from a Linux system before you upgrade Rational Rhapsody.
  2. Restart your system before you install the newer version of the product.
  3. Run the installation for the new version; see the topics in the section on installing Rational Rhapsody.
  4. If you are using the Rational Rhapsody plug-in for Eclipse, you have to upgrade the plug-in as well; see the topic on upgrading the Rational Rhapsody plug-in for Eclipse.
  5. Review the topic in the Migrating section of the Rational Rhapsody help for the version of Rational Rhapsody you are upgrading to and make sure that you understand any model / framework changes the product might make or require before you open the new version of the product.
  6. If you have your own operating system adapter, rebuild your framework libraries in the new version of the product.
  7. Regenerate and rebuild the code for any application that was created with the older version of the product.