Upgrading without any form of backup is best suited for environments where the entire engine state does not matter or where a configuration backup (perhaps by RLC) is all that is necessary.

Requirements
  • Sufficient downtime for:
    • Upgrade to be performed.
    • Post-upgrade tasks to be completed.
Upgrade Type Standard.
Backup Type None.
Rollback None.

Before You Begin

It is strongly recommended that you carry out the upgrade on a test or development server before you upgrade your production server.

Complete the following tasks before you upgrade Rhapsody:

Preparing for an Upgrade

To prepare Rhapsody (the Rhapsody Engine and Rhapsody IDE) for upgrade:

  1. Close (quit) all programs and stop the Rhapsody service before proceeding.
  2. Stop all input communication points.
  3. Ensure that all messages on the route have completed processing.
  4. After all the messages have been processed, stop all the output communication points and routes.
  5. Stop the Rhapsody engine.

    Because of changes to the Data Validation Service in Rhapsody 6.3, ensure you perform a clean shutdown of the engine (stop all the components before shutting down the engine) before upgrading from versions of Rhapsody before Rhapsody 6.3.

  6. Uninstall the existing Rhapsody IDE. Refer to Uninstalling Rhapsody IDE for details.

Under certain circumstances, side-by-side installations of older and newer versions of Rhapsody IDE are possible. Refer to Rhapsody IDE's Upgrade Recommendations for details.

Upgrading Rhapsody

To upgrade Rhapsody:

  1. Obtain the Rhapsody installers from Rhapsody Support.
  2. Upgrade the Rhapsody engine using the Rhapsody engine installer:

    If you select the Cancel button during the upgrade, you may not be able to start your engine.

  3. Install Rhapsody IDE in a Windows® environment using the Rhapsody IDE installer. Refer to Installing Rhapsody IDE for details. Ensure you do not configure the installer to start the engine automatically upon upgrade.

  4. Manually copy any changes you have made to the new wrapper files and log4j.properties file from your backup copies.

The Rhapsody engine and Rhapsody IDE can be upgraded in any order.

Post-upgrade tasks

Verifying the Upgrade

To verify the overall success of upgrade:

  1. Start the Rhapsody engine. If using Windows®, ensure the Rhapsody Service Monitor icon indicates that the Rhapsody engine is running.
  2. Double-click the Rhapsody Service Monitor icon, or enter http://<server>:<port>/rhapsody in your browser to access the Management Console.
  3. Log on to the Management Console as an administrator. The administrator password remains unchanged after installing the upgrade.
  4. Ensure that the version number in the title bar is <majorVersion>.<minorVersion>.<servicePack>.<build>.
  5. Start Rhapsody IDE and connect to the Rhapsody engine as an administrator.
  6. If applicable, register and license your engine. Refer to  Registering and Licensing Rhapsody for details.

If the upgrade is unsuccessful, you can attempt to re-install Rhapsody.