Install Rational Publishing Engine remote and data services as an upgrade

Reinstall the latest version of the Rational® Publishing Engine remote and data services as an upgrade.

Before you begin

Procedure

  1. Download the Rational Publishing Engine package from IBM® Passport Advantage®.
  2. Extract the Rational Publishing Engine archive.
  3. 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:
      • Windows icon: launchpad.exe
      • Linux icon: 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:
      • Windows icon: launchpad.exe
      • Linux icon: ./launchpad.sh
    The Rational Publishing Engine launchpad opens.
  4. Click Install IBM Rational Publishing Engine. Installation Manager opens.
  5. Select the IBM Rational Publishing Engine package and click Next.
  6. 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.

  7. Select I accept the terms in the license agreement and click Next.
  8. 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.
  9. 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.
  10. In the Translations page, select the languages to install and click Next.
  11. 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.
    • 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.
    Click Next.
  12. 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 Help > Help Contents, 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 Help > Help Contents, you open the local version of the documentation.
    • Access help from a server on your intranet: From the application, when you click Help > Help Contents, you open documentation that is installed on a common server. Enter the server and port number for the common server.
  13. 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.
  14. 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.
      1. In the server configuration section, click Browse and select the installation directory of the application server.
      2. The default application server port 9080 is entered for you; you can change the selection from the default value if you choose to.
      3. 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.
  15. 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.
  16. If you are installing any Reporting Data Services Adapters, enter the configuration details that are required and click Next.
  17. Review the summary information. To change a selection, click Back to return to your selections.
  18. 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.

Feedback