Red Hat Summit2.3.2. Running a ZIP Installation
Running Tomcat version 5 or 6
After extracting the zip file, check to see if a user called tomcat exists on the system by running the following command:
id tomcat
id tomcat
If the user does not exist then it will need to be added, along with the appropriate usergroup. In order to achieve this, execute the following:
groupadd -g 91 -r tomcat useradd -c "Tomcat" -u 91 -g tomcat -s /bin/sh -r -d /home/tomcat tomcat
groupadd -g 91 -r tomcat
useradd -c "Tomcat" -u 91 -g tomcat -s /bin/sh -r -d /home/tomcat tomcat
Once this is completed, if the
tomcat user will be running Tomcat, then the ownership of the tomcat directories will need to be changed to reflect this:
For Tomcat 5:
chown -R tomcat:tomcat tomcat5
chown -R tomcat:tomcat tomcat5
For Tomcat 6:
chown -R tomcat:tomcat tomcat6
chown -R tomcat:tomcat tomcat6
To test that the above commands have been successful, check that the
tomcat user has execution permission to the tomcat install path.
The
JAVA_HOME variable must now be set and this can be achieved by either modifying your .bashrc file or by modifying the Tomcat catalina.sh file.
If you chose to modify your
.bashrc file, add the following line with the correct path to suit your systems configuration (a path is provided here as an example only):
export JAVA_HOME=/usr/lib/jvm/java
export JAVA_HOME=/usr/lib/jvm/java
If you chose to modify your
tomcat5/bin/catalina.sh or tomcat6/bin/catalina.sh file (depending on the version of Tomcat installed), add the following line with the correct path to suit your systems configuration (a path is provided here as an example only):
JAVA_HOME=/usr/lib/jvm/java
JAVA_HOME=/usr/lib/jvm/java
To start and stop Tomcat, execute the follwing scripts as the user
tomcat:
To start Tomcat:
sh startup.sh
sh startup.sh
To stop Tomcat:
sh shutdown.sh
sh shutdown.sh
Once the Tomcat service has been started, you can verify that it is running by pointing your web browser to http://localhost:8080.
Running the HTTP Server
In order to run the HTTP Server, the distcache and pcre rpm packages must be installed as they are a requirement of mod_ssl. To check if these dependencies are already installed, execute the following in a command prompt:
rpm -q distcache pcre
rpm -q distcache pcre
The output will either say the rpms are not installed or it will display the package name followed by the version number. If distcache or pcre is not installed, execute:
for Red Hat Enterprise Linux 4:
up2date distcache up2date pcre
up2date distcache
up2date pcre
For Red Hat Enterprise Linux 5:
yum install distcache yum install pcre
yum install distcache
yum install pcre
While undertaking the install, you will be asked it you wish to proceed. When this occurs press the
y key.
Once installation is complete run the following command in order to check that the package was installed successfully.
rpm -q distcache rpm -q pcre
rpm -q distcache
rpm -q pcre
If the package was successfully installed then the output of the command will be the package name and the version number.
Now, after you have extracted the Enterprise Web Server zip file, change into the
httpd directory and run the post install script by executing the following:
./.postinstall
./.postinstall
Check to see if a user called
apache exists on the system by running the following command:
id apache
id apache
If the user does not exist then it will need to be added, along with the appropriate usergroup. In order to achieve this, execute the following:
groupadd -g 91 -r apache 2> /dev/null || : useradd -c "Apache" -u 91 -g apache -s /bin/sh -r -d /home/apache apache 2> /dev/null || :
groupadd -g 91 -r apache 2> /dev/null || :
useradd -c "Apache" -u 91 -g apache -s /bin/sh -r -d /home/apache apache 2> /dev/null || :
Once this is completed, if the
apache user will be running the httpd service, then the ownership of the HTTP directories will need to be changed to reflect this:
chown -R apache:apache httpd
chown -R apache:apache httpd
To test that the above commands have been successful, check that the
apache user has execution permission to the HTTP server install path.
Start the HTTP server by changing to the
httpd directory and executing:
su -m -c "./sbin/apachectl start"
su -m -c "./sbin/apachectl start"
Stop the HTTP server by executing:
su -m -c "./sbin/apachectl stop"
su -m -c "./sbin/apachectl stop"
Running the mod_jk
To load the mod_jk module, the file httpd/conf/httpd.conf needs to be updated, and a workers.properties file needs to be added in that directory. See doc/mod_jk/mod_jk.conf.sample and doc/mod_jk//workers.properties.sample for examples of how this can be achieved.
Running Apache Tomcat Native
The native library for Tomcat 6 is setup to be used by default, with the LD_LIBRARY_PATH and -Djava.library.path having been set accordingly within the catalina.sh file.
For Tomcat 6, start the service and check that you see a message similar to:
For Tomcat 5, start the service and if the tomcat native library is not used, a message similar to the one below will appear:
INFO: The Apache Tomcat Native library which allows optimal performance in production environments was not found on the java.library.path
INFO: The Apache Tomcat Native library which allows optimal performance in production environments was not found on the java.library.path
Running log4j for logging in a zip installation of Tomcat 6
In order to use log4j logging in Tomcat 6, copy the content of the extras/ directory into the lib/ directory and restart Tomcat.
'%20d='M201.5%20305.5c-13.8%200-24.9-11.1-24.9-24.6%200-13.8%2011.1-24.9%2024.9-24.9%2013.6%200%2024.6%2011.1%2024.6%2024.9%200%2013.6-11.1%2024.6-24.6%2024.6zM504%20256c0%20137-111%20248-248%20248S8%20393%208%20256%20119%208%20256%208s248%20111%20248%20248zm-132.3-41.2c-9.4%200-17.7%203.9-23.8%2010-22.4-15.5-52.6-25.5-86.1-26.6l17.4-78.3%2055.4%2012.5c0%2013.6%2011.1%2024.6%2024.6%2024.6%2013.8%200%2024.9-11.3%2024.9-24.9s-11.1-24.9-24.9-24.9c-9.7%200-18%205.8-22.1%2013.8l-61.2-13.6c-3-.8-6.1%201.4-6.9%204.4l-19.1%2086.4c-33.2%201.4-63.1%2011.3-85.5%2026.8-6.1-6.4-14.7-10.2-24.1-10.2-34.9%200-46.3%2046.9-14.4%2062.8-1.1%205-1.7%2010.2-1.7%2015.5%200%2052.6%2059.2%2095.2%20132%2095.2%2073.1%200%20132.3-42.6%20132.3-95.2%200-5.3-.6-10.8-1.9-15.8%2031.3-16%2019.8-62.5-14.9-62.5zM302.8%20331c-18.2%2018.2-76.1%2017.9-93.6%200-2.2-2.2-6.1-2.2-8.3%200-2.5%202.5-2.5%206.4%200%208.6%2022.8%2022.8%2087.3%2022.8%20110.2%200%202.5-2.2%202.5-6.1%200-8.6-2.2-2.2-6.1-2.2-8.3%200zm7.7-75c-13.6%200-24.6%2011.1-24.6%2024.9%200%2013.6%2011.1%2024.6%2024.6%2024.6%2013.8%200%2024.9-11.1%2024.9-24.6%200-13.8-11-24.9-24.9-24.9z'/%3e%3c/svg%3e){kind=small}