Use the IBM® Installation Manager wizard
to install the IBM Rational® Publishing Engine clients,
the Web Services application,
and the Data Services application on
a server for your organization.
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
- Launcher
- Optional: Add-ins
- Web Services application,
which includes the Remote document generation component, Monitor & Control component,
and Central
Management component
- Optional: Reporting Data Services Adapters
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 you have an earlier version of Installation
Manager installed
than the Rational Publishing Engine version
requires, you must update it before you can continue with the installation.
- Rational Publishing Engine 1.2
requires Installation
Manager version
1.5.2 or later.
- Rational Publishing Engine 1.2.0.1
requires Installation
Manager version
1.6.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.
Tip: The
Launcher and Document Studio features are selected by default, but
you are not required to install Document Studio to deploy the remote
services. However, the Launcher must be installed.
- 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.
- Web applications:
- RPE Web Services: Includes the Remote document
generation component, Monitor & Control component,
and Central
Management component features.
To relocate the publishing jobs to the server or store assets in a Central
Management component,
you must install the Web Services application.
- Data Services Adapters: The adapters allow
you to connect to data sources that use a REST interface. Select only
the adapters you must use to connect to that specific data source.
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.
- In the Application Servers tab of
the Common Configurations page, enter the server
configuration details.
- If you have a 32-bit version of WebSphere® Application Server installed
already, select the installed application server.
- In the server configuration section, click Browse and
select the installation directory of the application server.
- The default application server port 9080 is
entered for you; you can change the selection from the default value
if you choose to.
- Select Enable application security check
box and enter the administrator user name and password if your application
server requires authentication.
- If you have a 64-bit version of WebSphere Application Server installed
already, select Manual installation. You cannot
deploy the web applications automatically to a 64-bit version of WebSphere Application Server.
- If you do not have WebSphere Application Server installed
yet and plan on installing it after you complete the Rational Publishing Engine installation,
select Manual installation.
- If you do not have Apache Tomcat installed yet or plan on
installing it after you complete the Rational Publishing Engine installation,
select Manual installation.
Click Next.
- Optional: In the RPE Web Services tab,
you can enter the URL for the Web Services application,
if you know what the URL will be after the Web Services application is
deployed. By entering the URL now, you are configuring the clients
that are being installed on the server. The Web Services application still
must be deployed and configured. Example: http://<server>:<port>/rpews/. Click Next.
- If you are installing any Reporting Data Services Adapters,
enter the configuration details that are required and 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.
Note: The installation takes longer to complete if you selected
an available application server because the web applications are being
deployed for you.
Results
If you had a 32-bit version of WebSphere Application Server installed
and you selected it in the server configuration page, a new profile
named
RPE is created and the web applications you
selected to install are deployed for you.
What to do next
If you selected Manual installation in the Application
server configuration page because you did not install an application
server yet, install WebSphere Application
Server or Apache Tomcat.
Warning: If you have installed a WebSphere Application Server Interim
Fix for PM44303 or a Fix Pack containing PM44303, there is a potential
security exposure with some versions of WebSphere Application Server.
You must install a fix that is specific to your version of WebSphere Application Server and
your operating system. See
http://www-01.ibm.com/support/docview.wss?uid=swg21613438 for
a technote containing more information.
After
you install the application server, deploy the web applications:
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.