Reinstall the latest version of the Rational® Publishing Engine client
applications as an upgrade.
Procedure
- Download the Rational Publishing Engine package
from IBM® Passport Advantage®.
- Extract the Rational Publishing Engine archive.
- Run the Rational Publishing Engine launchpad
file by either:
- Opening the extracted ratlPublishingEngine_version_Win_Linux/RPE/disk1 directory
in an explorer window and double-clicking the launchpad file that
corresponds to your operating system:
: launchpad.exe
: launchpad.sh
- Opening a command prompt, navigating to extracted ratlPublishingEngine_version_Win_Linux/RPE/disk1 directory,
and entering the command that corresponds to your operating system:
: launchpad.exe
: ./launchpad.sh
The Rational Publishing Engine launchpad
opens.
- Click Install IBM Rational Publishing Engine. Installation
Manager opens.
- Select the IBM Rational Publishing Engine package
and click Next.
- If required, install or update Installation
Manager. Rational Publishing Engine 1.2.1
requires Installation
Manager version 1.6.3.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 I accept the terms in the
license agreement and click Next.
- Select a location for the shared resources
directory and click Next. The default
location is the application_files_directory\IBM\IMShared. Example: C:\Program Files\IBM\IMShared. If you used Installation
Manager before
to install another program, the shared resources directory might already
be defined. If the shared resources directory is already defined,
this page of the wizard is skipped. You can continue to the next step.
- In the Install Packages page,
the Create a new package group option is selected
by default. This selection installs a version directory for the application
files in application_files_directory\IBM\Rational\Publishing
Engine. Example: C:\Program Files\IBM\Rational\Publishing
Engine. In the documentation, this location is referred
to as %RPE_HOME% because an environment variable
is created on your system during installation, which is named RPE_HOME for
this directory. Click Next.
- In the Translations page, select the languages
to install and click Next.
- Select the features to install. The Launcher and Document
Studio features are selected by default.
- Document Studio: The application used
to create templates.
- Launcher: The application used to create
document specifications.
- Install Addins: If you use IBM Rational DOORS® or IBM Rational Tau,
you can start the publishing processes directly from your tool.
Click Next.
- In the Help System tab of
the Common Configurations page, select a method
for accessing the documentation from the installation and click Next.
- Access help from the Web: From the
application, when you click , you open the online
version of the documentation.
- Download help and access the content locally:
When you open the application for the first time, the documentation
is downloaded automatically onto your local computer. When you click , you open the local version of the documentation.
- Access help from a server on your intranet:
From the application, when you click , you open documentation
that is installed on a common server. Enter the server and port number
for the common server.
- In the Common Licensing tab
of the Common Configurations page, enter the
license server key. If the license server key is not entered now,
you are prompted to enter it when the applications are started after
installation is complete. Click Next.
- Optional: In the RPE Remote services tab,
you can enter the URL for the Remote services application, which allows
you to connect to the remote document generation, Monitor & Control
component, Central Management component, and Reporting scheduling
component for your organization. Example: http://<server>:<port>/rpews/
Note: If a Remote services application URL is entered during
installation, the URL cannot be edited from the Remote services preferences
later.
Click Next.
- Review the summary information. To change
a selection, click Back to return to your selections.
- To begin the installation, click Install.
When the installation is finished, click Finish.
What to do next
Configure the add-ins:
- If you installed the IBM Rational Tau Add-in,
activate it from the Rational Tau add-ins
page of the Customize window. In the Customize window,
you can enable the Rational Publishing Engine add-in
in the application.
- If you must extract Rational DOORS data
with DXL security settings, see Extracting Rational DOORS data
with DXL security settings.
Configure the help:
- If you are installing the documentation locally, the files are
downloaded when the Document Studio or Launcher applications are started
for the first time.
- If you are installing the documentation on an intranet server,
see the Intranet help (Enterprise solution) section
of the Methods for accessing help topic.
- If you chose to access the help from the web, no additional configuration
is required.
Optional:
Configure the clients for remote document generation