Installing Tomcat 4.1.12

1. First you need Java SDK. I installed the latest greatest 1.4.1 at
   this moment. Look at the log of Java install under Solaris at:
   /cca/software/JAVA/J2SDK-1.4.1/solaris2.8.shtml

2. Created a directory /usr/local/tomcat_4.1.12/distribution/bin directory.
   I made the files under  /usr/local/tomcat_4.1.12/ and directory itself
   owned by the "webrun" user (the user and a group which runs Apache
   and Tomcat on our machine). Then, I did everyting as webrun user,
   rather then root.  I retrieved Tomcat distribution from Jakarta
   Apache site: http://jakarta.apache.org/. The actual directory
   in this case is:
   http://jakarta.apache.org/builds/jakarta-tomcat-4.0/release/v4.1.12/
   and placed it in the /usr/local/tomcat_4.1.12/distribution/bin
   directory. Since I will run Tomcat under Java 1.4.x, I retrieved file
   jakarta-tomcat-4.1.12-LE-jdk14.tar.gz, which does
   not pack parsers and other files already available in J2SDK 1.4.1
   distribution. If you are not using Sun JDK, or if you use earlier
   Sun JDK, you need to retrieve the Tomcat full distribution which
   contains parsers. Also, retrieve the latest distribution, since
   bug and security problem fixes appear quite often.


3. I unpacked the distribution using GNU tar (the regular tar which
   comes with Solaris, is not really useful in this case, since you
   would have to first gunzip the tar.gz file, and only then untar it).

     cd /usr/local/tomcat_4.1.12/distribution/bin
     tar zxvf jakarta-tomcat-4.1.12-LE-jdk14.tar.gz

   This created the directory: jakarta-tomcat-4.1.12-LE-jdk14
   which contains the standard tree of TOMCAT_HOME. To make the
   path human-friendly I did the following:

     cd /usr/local/tomcat_4.1.12/distribution/bin/jakarta-tomcat-4.1.12-LE-jdk14
     mv * /usr/local/tomcat_4.1.12
     TOMCAT_HOME=/usr/local/tomcat_4.1.12
     export TOMCAT_HOME


   This helps, since I can go to the top of Tomcat tree by just doing

      cd $TOMCAT_HOME   


4. Now, making tomact RUN. You definitely need to read the file:
   ${TOMCAT_HOME}/RUNNING.txt which comes with the distribution.
   I started from making sure that my port assignments do not collide
   with other servers which I run on the machine. I edited the 
   ${TOMCAT_HOME}/conf/server.xml file and made all post starting
   from 80xx, changed to start from 412xx to make sure I can do
   some testing without interfaring with other Tomcat which currently
   uses the default ports. Namely:
         8005 --> 41205
         8008 --> 41208
         8009 --> 41209
         8080 --> 41280
         8082 --> 41282
         8083 --> 41283
         8443 --> 41243
   Note that most statements using these ports are commented out.
   But I changed just in case, so it is consistent in case I later
   need to uncomment some connectors.

5. Testing tomcat. Before starting Tomcat, you need to set the
   JAVA_HOME environmental variable (read $TOMCAT_HOME/bin/catalina.sh
   script for more information). In my case:

     JAVA_HOME=/usr/local/j2sdk1.4.1
     export JAVA_HOME
     cd ${TOMCAT_HOME}/bin
     ./startup.sh


   I actually created a small script called jkl-up.sh which contained:

     JAVA_HOME=/usr/local/j2sdk1.4.1
     export JAVA_HOME
     TOMCAT_HOME=/usr/local/tomcat_4.1.12
     export TOMCAT_HOME
     cd ${TOMCAT_HOME}/bin
     ./startup.sh

   to make sure, I have things set up correctly. I placed it in
   $TOMCAT_HOME/bin, changed its mode to 755, and started it as:

    cd $TOMCAT_HOME/bin
    ./jkl-up.sh


    I also created a script called jkl-down.sh which was quite similar:

     JAVA_HOME=/usr/local/j2sdk1.4.1
     export JAVA_HOME
     TOMCAT_HOME=/usr/local/tomcat_4.1.12
     export TOMCAT_HOME
     cd ${TOMCAT_HOME}/bin
     ./shutdown.sh


    I then checked in my browser, if I am getting something by opening
    the page: http://heechee.ccl.net:41280/  (heechee was my machine,
    where I installed tomcat). I went through examples, and ran a few...
    Some ran, some did not (e.g., Send mail example did not run,
    since there are not JavaMail jar in the CLASSPATH at this point).
    Then I shut down tomcat as:

    cd $TOMCAT_HOME/bin
    ./jkl-down.sh