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.
Before you begin
If you are upgrading from version 1.1.2.2 or earlier:
The version number directory was removed from the installation
path in Rational Publishing Engine 1.2.
To remove this directory, you must uninstall Rational Publishing Engine.
If you do not want to remove this directory, you can complete this
task to upgrade.
About this task
Note: If you had the Monitor & Control component (RPEMC)
installed with Rational Publishing Engine 1.1.2.2
or earlier, it is uninstalled when you upgrade. In Rational Publishing Engine 1.2
and later, the features of the Monitor & Control component are
included in the Remote Services application so a separate web application
is no longer needed.
Procedure
- Close all open applications.
- On a local server, extract the Rational Publishing Engine update
package to a directory that you can use as the update repository.
- On each computer with Rational Publishing Engine installed,
start Installation
Manager.
Click .
- In Installation
Manager,
click .
- Enter the path to the local update repository and click OK.
Click OK to close the Preferences window.
- Click Update. The Installation
Manager checks
for updates.
- On the Update Packages page, select
the package group Rational Publishing Engine and
click Next.
Rational Publishing Engine 1.2.1.1 requires Installation
Manager version 1.7.1 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.
- Select one of the following options:
- To update Installation
Manager:
- Click Yes at the prompt.
- When the update completes, click OK to
restart Installation
Manager.
- Click Update.
- 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.
- Select the release and click Next.
- Select I accept the terms in the
license agreement and click Next.
- 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. You must install this feature on
the server.
- Install Addins: If you use IBM Rational DOORS® or IBM Rational Tau,
you can start the publishing processes directly from your tool. On
this server, if you do not plan on generating documents from Rational DOORS or Rational Tau
clients, you do not need to install this feature.
- Remote components:
- RPE Remote Services: Includes the Remote
document generation component, Monitor & Control component, Central
Management, and Report scheduling component features. To reallocate
the publishing jobs to the server or store assets in a Central Management
component, you must install the Remote services application.
- Reporting Data Services: Includes adapters
to connect to data sources that use a REST interface. Select only
the adapter you must use to connect to that specific data source.
- Optional: In the RPE
Remote Services tab, you can enter the URL for the Remote
Services application, if you know what the URL will be after the Remote
Services application is deployed. By entering the URL now, you are
configuring the clients that are being installed on the server. The
Remote Services application still must be deployed and configured. Example: http://<server>:<port>/rpews/. Click Next.
- Review the summary information. To change
a selection, click Back to return to your selections.
- To begin the upgrade, click Update.
When the upgrade is finished, click Finish to
close the Update Packages windows.
- Close Installation
Manager.
What to do next
Complete the tasks in the
Post-upgrade checklist.
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 information
center.