Installing Tomcat on Ubuntu
Versions:
SDK: 1.5
JRE: 1.5
Tomcat: 5.5
Step 1 – Install JRE and SDK
Download and install the Java Software Development Kit (SDK) and J2SE Runtime Environment (JRE). These packages are available through Synaptic (the extra repositories have to be added).
Or in terminal type:
Code:
sudo apt-get install sun-j2re1.5
sudo apt-get install sun-j2sdk1.5
N.B. SDK is 146MB and JRE is 84.7MB.
You can verify that both items were installed corectly, by checking that you get a response when typing in terminal:
Code:
java -version
javac -help
Step 2 – Get tomcat
Download tomcat 5.5 from http://jakarta.apache.org/site/downloads/
In this example I am using jakarta-tomcat-5.5.9.tar.gz
Uncompress the file:
Code:
tar xvfz jakarta-tomcat-5.5.9.tar.gz
N.B. To make things simpler I also renamed the package to just 'tomcat'. If you do not do this, make sure you adjust these tutorial instructions to the name of your package whenever you see 'tomcat' written.
Step 3 – Add tomcat
Place the uncompressed package in:
/usr/local/
Step 4 – Set JAVA_HOME and CLASSPATH
You need to point out where you installed Java SDK. You will have to edit the file '.bashrc'. Backup this file first!
In terminal type:
Add the following lines to the file:
Code:
#Stuff we added to make tomcat go
export JAVA_HOME=/usr/lib/j2sdk1.5-sun/
export CLASSPATH=/usr/local/tomcat/common/lib/jsp-api.jar:/usr/local/tomcat/common/lib/servlet-api.jar
N.B. remember to change the word tomcat to the name of the package you placed in /usr/local.
Save and close. You will have to log out and back in again before these changes take effect.
The next steps are optional. They are for setting tomcat up to be used as a development environment. Skip to the last step ( Step 8 ) if you just want to start tomcat how it is.
Step 5 – Change default port number
Tomcats default port number is 8080. To change it to 80 or another number do the following.
In terminal type:
Code:
gedit usr/local/tomcat/conf/server.xml
Find the lines:
Code:
<Connector port="8080" ...
maxThreads="150" minSpareThreads="25" ...
Adjust the port number to 80 (or any other port number you want to use), save and close.
Step 6 – Turn on Servlet reloading
In terminal type:
Code:
gedit usr/local/tomcat/conf/context.xml
Find:
Change it to:
Code:
<Context reloadable="true">
Save and close.
Step 7 – Enable Invoker Servlet
In terminal type:
Code:
gedit usr/local/tomcat/conf/web.xml
Find and uncomment (remove the <-- and --> wrapped around the tags):
Code:
<servlet>
<servlet-name>invoker</servlet-name>
<servlet-class>
org.apache.catalina.servlets.InvokerServlet
</servlet-class>
...
</servlet>
Also find and uncomment:
Code:
<servlet-mapping>
<servlet-name>invoker</servlet-name>
<url-pattern>/servlet/*</url-pattern>
</servlet-mapping>
Save and close.
Step 8 – Start tomcat
Tomcat should now be ready to run.
In terminal type:
Code:
sh /usr/local/tomcat/bin/startup.sh
If everything is working fine, you will see the following lines:
Code:
Using CATALINA_BASE: /usr/local/tomcat
Using CATALINA_HOME: /usr/local/tomcat
Using CATALINA_TMPDIR: /usr/local/tomcat/temp
Using JRE_HOME: /usr/lib/j2sdk1.5-sun/
In your browser head to http://localhost/ and test if it is serving. If you didn't change the port number it was serving on, head to http://localhost:8080/
To stop tomcat type:
Code:
sh /usr/local/tomcat/bin/shutdown.sh
-----
I hope this helped! 8)
If you have any problems, I recommend this site for more details: http://www.coreservlets.com/
Bookmarks