Use the IBM® Installation Manager wizard to
install the IBM Rational® Publishing Engine
clients, and Document Builder on a server
for your organization.
Before you begin
- Verify that your environment meets the hardware and software requirements.
- If you have another version of Rational Publishing Engine already
installed, close all open Rational Publishing Engine applications.
About this task
This task is to be completed by server administrators on a server. When the task is
complete, the following features might be installed if you selected them:
- Optional: Document Studio
- Optional: Launcher
- Optional: Add-ins
- Document Builder(included with RPE Remote Services), which is a simplified web interface for users to assemble and
generate documents.
The 1.x Remote Services applications (Central Management, Monitor and Control,
Remote Document Generation, and Report Scheduler) are deprecated in this release. You can now
perform these tasks using Document Builder. See Migrating assets from 1.x Remote services to 2.0 Document Builder.
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
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.
- 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.
- 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
Click Next.
- 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.
- 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
After you install the application server, deploy the remote
applications:
If you are installing the documentation on an intranet server, see the
Intranet help (Enterprise solution) section of the Help content configurations topic.