Upgrading the Rational Connector software

You use IBM® Installation Manager to install the connector software into a new package group. If you are using WebSphere® Application Server to run the connector ear application, you use the console to update that ear file. If you are using Apache Tomcat to run the connector war file, you copy the war file from the new installation to your 4.0 installation.

Before you begin

Complete these tasks before you upgrade the connector software:

About this task

You use IBM Installation Manager to install a new version of the connector, side-by-side to the older version. After the installation finishes, you either upgrade the connector application ear file by using the WebSphere Application Server administrative console or you copy the connector application war file to your 4.0 Tomcat installation.

Procedure

  1. Follow these steps to install the software, see Installing from IBM Installation Manager.

Set up WebSphere Application Server to work with the connector. Skip to the next section if the Apache Tomcat application server is running the connector application.

  1. If you deployed the connector ear file on WebSphere Application Server, do these steps:
    1. Update the connector enterprise application, click Update.

      The Preparing for application update page is displayed.

    2. Under Specify the EAR, WAR, JAR, RAR, or SAR module to upload and update
      • Ensure that Application to be updated refers to the application to be updated.
      • Under Application update options, select the installed application (SAPConnector.ear)
      • Under Full path, enter the path to the SAPConnector.ear enterprise application file. The default directory is 4.0.0.2_install_dir/server/webapps/SAPConnector.ear
    3. Select Replace the entire application option, enter the location of the web application 4.0.0.2_install_dir/server/webapps/SAPConnector.ear, and click Next.
    4. Select Fast Path - Prompt only when additional information is required and click Next.
    5. Keep the default settings for the installation options and click Next
    6. Select the SAPConnector module and click Next.
    7. Click Finish.
    8. To make sure that the application is properly installed, click Applications > Application Types > WebSphere enterprise applications. The SAPConnector application is listed as a resource with a red "X" mark for the Application Status, indicating that it was not started.

      Installed SAPConnector application

    9. Next, click Start. A green arrow indicates that the application restarted.
    10. Point your browser to https://fully qualified hostname:port/SAPConnector. Log in to the Rational® Connector for SAP Solution Manager server by using an account that has administrator privileges.
      Tip: You can find the port number that is used for your application server from the administrative console. Click Servers > Server Types > WebSphere Application Servers > server_ name > Ports. If you are using an HTTP Transport Port, look for the value for the port name WC_defaulthost. If you are using an HTTPS Transport Secure Port, look for the value for the port name WC_defaulthost_secure.

Set up Apache Tomcat application server to work with the connector.

  1. Copy the SAPConnector.war file from your 4.0.0.2 Tomcat server directory to your 4.0.0.0 Tomcat server directory.
    cp 4.0.0.2_install_dir/server/tomcat/webapps/SAPConnector.war 4.0.0.0_install_dir/tomcat/webapps/SAPConnector.war
  2. Remove the 4.0.0.0 Tomcat server work directory.
    rm 4.0.0.0_install_dir/server/tomcat/work/Catalina/localhost/SAPConnector

Results

The connector software is upgraded to the latest version.
Tip: If you experience issues with the software update, you can revert the software to the version installed before the upgrade by using the Installation Manager rollback feature. For more information about the rollback feature, see Roll back updates by using wizard mode.

Feedback