Upgrading from a previous release

IBM® Rational® Publishing Engine uses IBM Installation Manager to upgrade Rational Publishing Engine. When your role is a data administrator, document designer, or document generator, you can complete this task to upgrade Rational Publishing Engine on your local computer.

About this task

Procedure

  1. Close all open applications.
  2. You can either download the update package or connect to a remote repository. To download the update package and use the local repository:
    1. On a local server, extract the Rational Publishing Engine update package to a directory that you can use as the update repository.
    2. On each computer with Rational Publishing Engine installed, start Installation Manager. Click Start > All Programs > IBM Installation Manager > IBM Installation Manager.
    3. In Installation Manager, click File > Preferences > Add Repository.
    4. Enter the path to the local update repository and click OK.
    To update from the remote repository:
    1. On each computer with Rational Publishing Engine installed, start Installation Manager. Click Start > All Programs > IBM Installation Manager > IBM Installation Manager.
    2. In Installation Manager, click File > Preferences > Add Repository.
    3. In the Repository field, enter https://www.ibm.com/software/repositorymanager/com.ibm.rational.rpe.offering/repository.xml and then click OK.
    4. Enter your IBM ID and password.
  3. Click OK to close the Preferences window.
  4. Click Update. The Installation Manager checks for updates.
  5. On the Update Packages page, select the package group Rational Publishing Engine and click Next.

    Rational Publishing Engine 2.1.1 requires Installation Manager version 1.8.5 or later.

    The appropriate Installation Manager version is included with each version of the Rational Publishing Engine installation files. You do not have to download the required version separately.

  6. Select one of the following options:
    • To update Installation Manager:
      1. Click Yes at the prompt.
      2. When the update completes, click OK to restart Installation Manager.
      3. Click Update.
      4. On the Update Packages page, select the package group Rational Publishing Engine and click Next.
    • If your Installation Manager is current, continue to the next step.
  7. Select the release and click Next.
  8. Select I accept the terms in the license agreement and click Next.
  9. Select the features to install and click Next. The features you installed previously are already selected for you, but you can choose to install additional features.
    • Document Studio: This application is used to create templates. On this server, if you do not plan on designing templates, you do not need to install this feature.
    • Launcher: This application is used to create document specifications and generate documents locally. On this server, if you do not plan on designing templates, you do not need to install this feature.
    • DOORS Addin: If you use IBM Rational DOORS® , you can start the publishing processes directly from your tool. On this server, if you do not plan on generating documents from Rational DOORS clients, you do not need to install this feature.
    • RPE Document Builder: Includes Document Builder a web application to build reports from templates, manage assets and schedule document generation, and a document generation service
  10. Review the summary information. To change a selection, click Back to return to your selections.
  11. To begin the upgrade, click Update. When the upgrade is finished, click Finish to close the Update Packages windows.
  12. Close Installation Manager.

What to do next

Complete the Post-upgrade tasks.
Some selections you made during the installation are stored in installRegistry.xml, which was created by Installation Manager and stored in your application data directory. These selections include the configurations for the help system and common licensing. If the installRegistry.xml was corrupted or moved, the Update wizard cannot access the information you previously entered.
If you need to change any of this information, complete the update and complete the following applicable steps:

For more information about the installRegistry.xml, see the Agent data location topic in the Installation Manager product documentation.


Feedback