IBM Support

How to upgrade Apache Tomcat server deployed on RDS and RDA prior to version 5.2.1 and 5.1.1.2

Question & Answer


Question

How do you upgrade the Apache Tomcat Server used in versions of IBM Rational Directory Server (RDS) and Rational Directory Administrator (RDA) prior to version 5.2.1 and 5.1.1.2?

Cause

Releases of the Rational Directory Administrator in RDS (Apache) prior to version 5.2.1 and 5.1.1.2, use Apache Tomcat 6.x as a Web Server. These versions can be affected by security vulnerabilities and the fix may require you to upgrade to an Apache Tomcat version.

Note: The newer versions of RDS, however, use IBM WebSphere Application Server (WAS) Liberty Profile 8.5.x which is free of such security vulnerabilities.

Answer

Apache Tomcat can be upgraded to the latest version by following these steps (UNIX / Linux below):

WINDOWS:

  1. Download the latest version of Apache Tomcat

  2. Extract the downloaded version of Apache Tomcat.

  3. Stop the Rational Directory Administrator:
    <RDS/RDA install Location>\WebAccessServer\apache-tomcat-6.0.xx\bin\catalina.bat stop

  4. Place the latest version (apache-tomcat-6.0.yy) at:
    <RDS/RDA install Location>\WebAccessServer

  5. Modify:
    "<RDS/RDA install Location>\WebAccessServer\Start_RDAWebServer.bat" file. Update the paths to the point to new apache-tomcat-6.0.yy folder

  6. Edit the following file:
    <RDS/RDA install Location>\WebAccessServer\apache-tomcat-6.0.yy\bin\catalina.bat

    Set the JRE Home path in the first valid line after the comments ('rem')
    "set JRE_HOME=<RDS/RDA install Location>\jre"

  7. Copy the following files from the existing install location to the new Apache Tomcat directory structure:
    • <RDS/RDA install Location>\WebAccessServer\apache-tomcat-6.0.xx\bin\
      - TDSConfiguration.xml
      - TDSResource_en_US.xml
      -       copyright.txt
      -       GroupSchema.xsd
      -       rdauser_preferences.ser
      -       tdsbuild.property
      -       UserSchema.xsd

      to

      <RDS/RDA install Location>\WebAccessServer\apache-tomcat-6.0.yy\bin\

    • <RDS/RDA install Location>\WebAccessServer\apache-tomcat-6.0.xx\webapps\
      - rds-help.war
      - webrda.war

      to

      <RDS/RDA install Location>\WebAccessServer\apache-tomcat-6.0.yy\webapps\

    • <RDS/RDA install Location>\WebAccessServer\apache-tomcat-6.0.xx\conf\server.xml

      to

      <RDS/RDA install Location>\WebAccessServer\apache-tomcat-6.0.yy\conf\

      Where:
      apache-tomcat-6.0.xx : Existing version of Apache Tomcat installed with RDS/RDA
      apache-tomcat-6.0.yy : New version of Apache Tomcat

  8. Start the Rational Directory Server:
    <RDS/RDA install Location>\WebAccessServer\Start_RDAWebServer.bat


Back to top


UNIX and Linux
  1. Download the latest version of Apache Tomcat

  2. Extract the downloaded version of Apache Tomcat

  3. Stop the Rational Directory Administrator:
    <RDS/RDA install Location>/WebAccessServer/apache-tomcat-6.0.xx/bin/catalina.sh stop

  4. Place the latest version (apache-tomcat-6.0.yy) at:
    <RDS/RDA install Location>/WebAccessServer

  5. Modify:
    "<RDS/RDA install Location>/WebAccessServer/Start_RDAWebServer.sh" file. Update the paths to the point to new apache-tomcat-6.0.yy folder

  6. Edit the Following file
    <RDS/RDA install Location>/WebAccessServer/apache-tomcat-6.0.xx/bin/catalina.sh

    Set the JRE Home path in the first valid line after the comments ('rem')
    "JRE_HOME=<RDS/RDA install Location>/jre"

    For Solaris platform only:
    JAVA_ENDORSED_DIRS="$JRE_HOME/lib/endorsed"
    JAVA_OPTS="$JAVA_OPTS -Djava.protocol.handler.pkgs=com.ibm.net.ssl.www2.protocol"

  7. Copy the below mentioned files from the existing install location to the new Apache Tomcat directory structure
    • <RDS/RDA install Location>/WebAccessServer/apache-tomcat-6.0.xx/bin/
      - TDSConfiguration.xml
      - TDSResource_en_US.xml
      - copyright.txt
      - GroupSchema.xsd
      - rdauser_preferences.ser
      - tdsbuild.property
      - UserSchema.xsd

      to

      <RDS/RDA install Location>/WebAccessServer/apache-tomcat-6.0.yy/bin/

    • <RDS/RDA install Location>/WebAccessServer/apache-tomcat-6.0.xx/webapps/
      - rds-help.war
      - webrda.war

      to

      <RDS/RDA install Location>/WebAccessServer/apache-tomcat-6.0.yy/webapps/

    • <RDS/RDA install Location>/WebAccessServer/apache-tomcat-6.0.xx\conf\server.xml

      to

      <RDS/RDA install Location>/WebAccessServer/apache-tomcat-6.0.yy/conf/

      Where:
      apache-tomcat-6.0.xx : Existing version of Apache Tomcat installed with RDS/RDA
      apache-tomcat-6.0.yy : New version of Apache Tomcat

  8. Start the Rational Directory Server:
    <RDS/RDA install Location>/WebAccessServer/Start_RDAWebServer.sh

Back to top

[{"Product":{"code":"SS4AKG","label":"Rational Directory Server"},"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Component":"General Information","Platform":[{"code":"PF002","label":"AIX"},{"code":"PF016","label":"Linux"},{"code":"PF027","label":"Solaris"},{"code":"PF033","label":"Windows"}],"Version":"5.1.1;5.1.1.1;5.2;5.2.0.1;5.2.0.2","Edition":"","Line of Business":{"code":"LOB15","label":"Integration"}},{"Product":{"code":"SSWND3","label":"Rational Directory Administrator"},"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Component":"General Information","Platform":[{"code":"PF002","label":"AIX"},{"code":"PF016","label":"Linux"},{"code":"PF027","label":"Solaris"},{"code":"PF033","label":"Windows"}],"Version":"6.0","Edition":"","Line of Business":{"code":"LOB15","label":"Integration"}}]

Document Information

Modified date:
16 June 2018

UID

swg21669669

Page Feedback