Preparing to Install Agent for Apache Tomcat 6.0

Follow the specific steps outlined in the following section before you install the agent to reduce the chance of complications occurring during and after the installation.

To Prepare to Install Agent for Apache Tomcat 6.0

Perform the following pre-installation steps:

1. Ensure that the agent distribution files are properly unzipped on the Apache Tomcat 6.0 instance as described in the substeps that follow:

   1. Create a directory in which to download the tomcat_v6_agent.zip file.

      For example:

      Agent_Home
      

   2. Download the tomcat_v6_agent.zip file to the newly created directory.

   3. From the newly created directory, unzip the tomcat_v6_agent.zip file using the appropriate utility or command for your platform.

      For example, on Solaris systems, issue the following:

      unzip tomcat_v6_agent.zip

2. Ensure that Policy Agent 2.2 for Apache Tomcat 6.0 is supported on the desired platform as listed in Supported Platforms and Compatibility of Agent for Apache Tomcat 6.0.

3. Install Apache Tomcat 6.0 if not already installed.

   ---

   Caution –

   While the present release of Agent for Apache Tomcat 6.0 supports the .exe extension of the Apache Tomcat 6.0 bits, an extra task is required to make the installation work. For those instructions, see (Conditional) To Use the .exe Version of Apache Tomcat 6.0 Server.

   The extra task is unnecessary if you use the .zip files or .gz files. For example, for version 6.0.14, you could download either of the following compressed files and perform the installation without having to implement the extra task:

   apache-tomcat-6.0.14.zip

   apache-tomcat-6.0.14.tar.gz

   Compressed files for Apache Tomcat 6.0 as well as installation-related documentation are available at the Apache web site at http://apache.org/

   ---

4. (Conditional) If the Apache Tomcat 6.0 instance on which you are about to install the agent is running, shut it down.

5. Create a valid agent profile in Access Manager Console if one has not already been created.

   For information on how to create an agent profile, see Creating a J2EE Agent Profile.

   To avoid a misconfiguration of the agent, ensure that you know the exact ID and password used to create the agent profile. You must enter the agent profile password correctly in the next step and you must enter the agent profile ID correctly when installing the agent.

6. Create a text file and add the agent profile password to that file.

   Ensure that this file is located in a secure directory of your choice. You will refer to this file during the agent installation process.

   With the agent profile password in this file, stored in a secure location, you do not need to enter sensitive information in the console. A valid password file can have only one line that contains the agent profile password.

7. (On Red Hat Enterprise Linux Advanced Server only) Ensure that the Sun Microsystems java file is configured to be retrieved instead of the Red Hat java file.

   You can achieve this using various methods. Pick the method of choice. The following is an example of how you can accomplish this:

   Set the JAVA_HOME environment variable to point to the Sun Microsystems java file. The location varies, but the following example illustrates a feasible location for this file:

   /share/builds/components/jdk/1.5.0_06/Linux

(Conditional) To Use the .exe Version of Apache Tomcat 6.0 Server

As described in To Prepare to Install Agent for Apache Tomcat 6.0, you can install Agent for Apache Tomcat 6.0 on a .exe version of Apache Tomcat 6.0. However, you must implement the steps in this task prior to installing the agent for the deployment to work.

The Apache Tomcat 6.0 bits with the .exe extension do not contain certain files (scripts, JAR files, etc.) required by the agent. Therefore, you must copy the required files from the .zip bundle to the Apache Tomcat 6.0 installation base.

1. Download the .exe and the .zip versions of Apache Tomcat 6.0.

   For example, you could download the two following Apache Tomcat 6.0 versions:

   • apache-tomcat-6.0.14.exe

   • apache-tomcat-6.0.14.zip

2. Install Apache Tomcat 6.0 using the .exe version.

   If the version of Apache Tomcat 6.0 is indeed 6.0.14, the following would be a feasible location for CATALINA_HOME:

   /opt/apache-tomcat-6.0.14
   

3. In a directory separate from the .exe distribution, unzip the apache-tomcat-6.0.14.zip file.

4. Copy the following scripts from the unzipped bundle to the bin directory of the installation (${CATALINA_HOME}/bin):

   catalina-tasks.xml
   catalina.bat
   catalina.sh
   commons-daemon.jar
   cpappend.bat
   digest.bat
   digest.sh
   jsvc.tar.gz
   service.bat
   setclasspath.bat
   setclasspath.sh
   shutdown.bat
   shutdown.sh
   startup.bat
   startup.sh
   tomcat-native.tar.gz
   tool-wrapper.bat
   tool-wrapper.sh
   version.bat
   version.sh 

Next Steps

After you have implemented this task, the best practice is to start and stop the Apache Tomcat 6.0 instance using the command line since problems have occurred in this scenario when attempting to stop and start the server via services.

At this point, you can install Agent for Apache Tomcat 6.0.