TOMCAT UPGRADE PROCESS
Software Requirements
1. Operating System:
· Windows Server 2003 R2 with SP2 (32-bit)/IA-32, x64
2. Tomcat version:
· Tomcat 5.5.28
· Tomcat 6.0.20
3. Java version:
· 5.0.x
· 6.0.x
Prerequisites for upgradation:
1. Take back up of following from webapps folder under tomcat. Path for the same is :
D:\Apache Software Foundation\Tomcat 6.0\webapps
a. da
b. roclient
c. documentum
d. webtop
e. webtopbase
f. webtop_ecs36004
Steps for upgradation:
1) Uninstall tomcat
2) Check the java version. It should be jre 5.0.x or 6.0.x. If the java version is not the mentioned one, then uninstall java and install the mentioned version.
3) Install tomcat.
4) Copy the entire folder for which we have taken backup into webapps folder.
5) To enable JSP tag pooling, edit the web.xml file, which is located under <tomcat_install_dir>\conf\web.xml. Find the JSP servlet entry in web.xml. Add the enablePooling initialization parameter and set it to false. Save changes to web.xml, like below:
<servlet>
<servlet-name>jsp</servlet-name>
<servlet-class>org.apache.jasper.servlet.JspServlet</servlet-class>
<init-param>
<param-name>enablePooling</param-name>
<param-value>false</param-value>
</init-param>
<init-param>
<param-name>fork</param-name>
<param-value>false</param-value>
</init-param>
<init-param>
<param-name>xpoweredBy</param-name>
<param-value>false</param-value>
</init-param>
<load-on-startup>3</load-on-startup>
</servlet>
6) To configure Tomcat, click on “Start” -> “Programs” -> “Apache Tomcat 6.0” -> “Configure Tomcat”.
· Select the “Java” tab. Set the “Initial memory pool” and “Maximum memory pool” values to 1024MB. In the “Java Options” text box, add the following lines:
-XX:MaxPermSize=192m
-XX:PermSize=128m
-XX:+CMSPermGenSweepingEnabled
-XX:+CMSClassUnloadingEnabled
-XX:+UseParallelOldGC
-Xloggc:<tomcat_install_dir>\logs\tomcatgc.log
For the Java Classpath, add the following:
;<tomcat_install_dir>\webapps\ROOT\WEB-INF\classes;<tomcat_install_dir>\lib\servlet-api.jar
where <tomcat_install_dir> is the destination folder chosen in Step 7.
Click “Apply”, then click “OK” to save your changes.
7) At this point, it may be desirable to ensure that the Apache Tomcat software is installed correctly. To start this process, click on “Start” -> “Settings” -> “Control Panel” -> “Administrative Tools” -> “Services”.
· In the “Services” window, stop and disable the following services (if installed): IIS Admin Service, Simple Mail Transport Protocol (SMTP), and World Wide Web Publishing Service.
· In the “Services” window, select the Apache Tomcat service, and click on the start button (the button with the arrow pointing to the right near the top of the window).
8) On another computer, start Internet Explorer, and in the Address box type in the following URL:
“http://<server_name>/”
where <server_name> is the name of the computer that Apache Tomcat is installed on. Once the URL is entered, press “enter” on the keyboard. If the installation is successful, the Apache Tomcat home page should appear.