IBM Platform Symphony 6.1.1 Solution #330422 Readme File

Abstract

Upgrading Apache Tomcat from 5.5.36 to 6.0.43 and Apache Ant from 1.6.5 to 1.9.2 for use with Platform Symphony 6.1.1.

Description

This document provides guidance on upgrading and configuring your Platform Symphony 6.1.1 cluster while upgrading Tomcat from 5.5.36 to 6.0.43 and Ant from 1.6.5 to 1.9.2.

This solution applies to linux2.6-glibc2.3-x86_64.

Readme file for: IBM® Platform Symphony

Product/Component Release: 6.1.1

Update Name: Enhancement pack

Solution ID: sym-6.1.1-build330422

Publication date: 18^th March 2015

Last modified date: 18^th March 2015

Contents:

1. Download location

2. Scope

3. Installation and configuration

4. List of files

5. Copyright and trademark information

1. Download location

Download this solution from the following location: http://www.ibm.com/eserver/support/fixes/

Download the Tomcat 6.0.43 package, apache-tomcat-6.0.43.tar.gz, from the following location: http://archive.apache.org/dist/tomcat/tomcat-6/v6.0.43/bin/

2. Scope

Applicability

Operating systems

Linux2.6-glibc2.3-x86_64

Platform Symphony version

6.1.1

Cluster types

This solution applies to a single Platform Symphony cluster.

Installation files

symSetup6.1.1_lnx26-lib23-x64_build330422.tar.gz

Limitation

Prerequisites

Ensure two patches of sym-6.1.1-spk-Security-build227853 and sym-6.1.1-build241698-fixpack-2014-oct are applied in the cluster

3. Installation and configuration

3.1 Notes

l If you want to apply this solution with the Platform Symphony 6.1.1 security fix, you must first apply the security fix according to that documentation, and then apply this solution. Otherwise, simply apply this solution to your Platform Symphony 6.1.1 cluster.

l This solution only applies to management hosts.

l Download the package, apache-tomcat-6.0.43.tar.gz, from the Apache website: http://archive.apache.org/dist/tomcat/tomcat-6/v6.0.43/bin/

3.2 Before installation

1. Stop WEBGUI, PLC and purger services.

Log on to the master host as the cluster administrator and run:

> source $EGO_TOP/cshrc.platform

> egosh service stop WEBGUI plc purger

2. Back up files.

1) Back up the following folder and files on each management host:

$EGO_TOP/gui/1.2.8/tomcat/

$EGO_TOP/gui/1.2.8/common_ui/WEB-INF/web.xml

$EGO_TOP/gui/ego/1.2.8/platform/WEB-INF/web.xml

$EGO_TOP/gui/perf/1.2.8/perfgui/WEB-INF/web.xml

$EGO_TOP/gui/soam/6.1.1/soamgui/WEB-INF/web.xml

$EGO_TOP/gui/soam/6.1.1/symgui/WEB-INF/web.xml

$EGO_TOP/gui/is/6.1.1/isgui/WEB-INF/web.xml

$EGO_TOP/gui/soam/6.1.1/symgui/WEB-INF/lib/soamgui.jar

$EGO_TOP/gui/is/6.1.1/isgui/WEB-INF/classes/log4j.properties

$EGO_TOP/gui/perf/1.2.8/perfgui/WEB-INF/classes/log4j.properties

$EGO_TOP/gui/soam/6.1.1/soamgui/WEB-INF/classes/log4j.properties

$PERF_TOP/1.2.8/lib/ant-1.6.5.jar

2) If you have previously run egoconfig mghost shared_dir during the installation, back up the following files in the shared directory.

$EGO_CONFDIR/../../gui/conf/catalina.policy

$EGO_CONFDIR/../../gui/conf/catalina.properties

$EGO_CONFDIR/../../gui/conf/context.xml

$EGO_CONFDIR/../../gui/conf/logging.properties

$EGO_CONFDIR/../../gui/conf/server.xml

$EGO_CONFDIR/../../gui/conf/tomcat-users.xml

$EGO_CONFDIR/../../gui/conf/web.xml

3) If you don’t run egoconfig mghost shared_dir during the installation, back up the following files on each management host’s local /conf directory.

$EGO_TOP/gui/conf/catalina.policy

$EGO_TOP/gui/conf/catalina.properties

$EGO_TOP/gui/conf/context.xml

$EGO_TOP/gui/conf/logging.properties

$EGO_TOP/gui/conf/server.xml

$EGO_TOP/gui/conf/tomcat-users.xml

$EGO_TOP/gui/conf/web.xml

3.3 Installation steps

1. Remove the following old Ant jar file from management hosts that will be upgraded:

> rm $PERF_TOP/1.2.8/lib/ant-1.6.5.jar

2. Copy the symSetup6.1.1_lnx26-lib23-x64_build330422.tar.gz package to a temporary folder and decompress the file:

> cp symSetup6.1.1_lnx26-lib23-x64_build330422.tar.gz /tmp

> tar –zxvf symSetup6.1.1_lnx26-lib23-x64_build330422.tar.gz

3. Copy the decompressed files into each management host:

> cp -rf gui/conf/ $EGO_CONFDIR/../../gui

> cp gui/1.2.8/common_ui/WEB-INF/web.xml $EGO_TOP/gui/1.2.8/common_ui/WEB-INF/

> cp perf/1.2.8/lib/ant-1.9.2.jar $PERF_TOP/1.2.8/lib/

> cp gui/soam/6.1.1/symgui/WEB-INF/lib/soamgui.jar $EGO_TOP/gui/soam/6.1.1/symgui/WEB-INF/lib/

Check whether the old $EGO_TOP/gui/ego/1.2.8/platform/WEB-INF/web.xml file contains the text . If the file contains the text, copy the following file:

> cp gui/ego/1.2.8/platform/WEB-INF/web.xml $EGO_TOP/gui/ego/1.2.8/platform/WEB-INF/