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 |
|
---|---|
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:
Check you meet the System Requirements.
- Read the upgrade caveats.
- Obtain the required installers from Rhapsody.
Obtain the correct license before installing Rhapsody.
- Make copies of your wrapper files,
log4j.properties
file andjava.security
file, and move them to a backup location.
Preparing for an Upgrade
To prepare Rhapsody (the Rhapsody Engine and Rhapsody IDE) for upgrade:
- Close (quit) all programs and stop the Rhapsody service before proceeding.
- Stop all input communication points.
- Ensure that all messages on the route have completed processing.
- After all the messages have been processed, stop all the output communication points and routes.
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.
- 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:
- Obtain the Rhapsody installers from Rhapsody Support.
Upgrade the Rhapsody engine using the Rhapsody engine installer:
Environment
Refer to...
Windows®
*nix
If you select the Cancel button during the upgrade, you may not be able to start your engine.
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.
- 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:
- Start the Rhapsody engine. If using Windows®, ensure the Rhapsody Service Monitor icon indicates that the Rhapsody engine is running.
- Double-click the Rhapsody Service Monitor icon, or enter
http://<server>:<port>/rhapsody
in your browser to access the Management Console. - Log on to the Management Console as an administrator. The administrator password remains unchanged after installing the upgrade.
- Ensure that the version number in the title bar is
<majorVersion>.<minorVersion>.<servicePack>.<build>
. - Start Rhapsody IDE and connect to the Rhapsody engine as an administrator.
- 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.