In this tutorial, we will show you how to install Apache Tomcat 8 on Ubuntu 14.04. For those of you who didn’t know, Apache Tomcat is an open-source web server and servlet container developed by the Apache Software Foundation. It implements the Java Servlet, JavaServer Pages (JSP), Java Unified Expression Language, and Java WebSocket specifications from Sun Microsystems and provides a web server environment for Java code to run in.
This article assumes you have at least basic knowledge of Linux, know how to use the shell, and most importantly, you host your site on your own VPS. The installation is quite simple. I will show you the step-by-step installation of apache tomcat 8 on ubuntu 14.04.
Prerequisites
- A server running one of the following operating systems: Ubuntu 14.04, and any other Debian-based distribution.
- It’s recommended that you use a fresh OS install to prevent any potential issues.
- SSH access to the server (or just open Terminal if you’re on a desktop).
- A
non-root sudo user
or access to theroot user
. We recommend acting as anon-root sudo user
, however, as you can harm your system if you’re not careful when acting as the root.
Install Apache Tomcat 8 on Ubuntu 14.04
Step 1. JAVA is the first requirement of Tomcat installation.
Add the repository:
sudo apt-get install python-software-properties sudo add-apt-repository ppa:webupd8team/java
Update apt and install Java 8:
sudo apt-get update sudo apt-get install oracle-java8-installer
You can also verify it, by issuing the following command.
java -version
Step 2. Download and extract Tomcat packages.
After installing and configuring JAVA on the system, now it’s time to download the latest version of Apache Tomcat.
cd /opt wget http://www.apache.org/dist/tomcat/tomcat-8/v8.0.33/bin/apache-tomcat-8.0.33.tar.gz tar -xvf apache-tomcat-8.0.21.tar.gz
Add tomcat user and group:
ln -s /opt/apache-tomcat-8.0.21 /opt/tomcat-latest chown -hR tomcat8: /opt/tomcat-latest /opt/apache-tomcat-8.0.21
Step 3. Configure environment variables.
Before starting Tomcat, configure CATALINA_HOME environment variable in your system using the following commands.
# echo "export CATALINA_HOME=\"apache-tomcat-8.0.21\"" >> ~/.bashrc # source ~/.bashrc
Step 4. Configure Tomcat to run as a service.
cd /opt/apache-tomcat-8.0.21/bin ./startup.sh
You will get the following output.
Using CATALINA_BASE: /var/local/apache-tomcat-8.0.21 Using CATALINA_HOME: /var/local/apache-tomcat-8.0.21 Using CATALINA_TMPDIR: /var/local/apache-tomcat-8.0.21/temp Using JRE_HOME: /usr Using CLASSPATH: /var/local/apache-tomcat-8.0.21/bin/bootstrap.jar:/var/local/apache-tomcat-8.0.21/bin/tomcat-juli.jar Tomcat starte
You can verify the service running, by default tomcat runs on port no 8080.
[root@idroot ~]# netstat -antup | grep 8080 tcp 0 0 0.0.0.0:8080 0.0.0.0:* LISTEN
Step 5. Finally, open Tomcat from your browser, go to your IP or domain with the 8080 port (because Tomcat will always run on the 8080 port) as an example: mydomain.com:8080, replace mydomain.com with your IP or domain.
To shutdown Tomcat you can simply run the shutdown script in the same folder like this:
/opt/apache-tomcat-8.0.21/bin/shutdown.sh
Step 6. Set up user accounts.
Configure Tomcat users so they can access admin/manager sections. You can do this by adding the users in the conf/tomcat-users.xml file with your favorite text editor. Add this text to the file:
nano /opt/apache-tomcat-8.0.21/conf/server.xml
Place the following two lines just above the last line.
<!-- user manager can access only manager section --> <role rolename="manager-gui" /> <user username="manager" password="_SECRET_PASSWORD_" roles="manager-gui" /> <!-- user admin can access manager and admin section both --> <role rolename="admin-gui" /> <user username="admin" password="_SECRET_PASSWORD_" roles="manager-gui,admin-gui" />
Congratulations! You have successfully installed Apache Tomcat. Thanks for using this tutorial for installing apache tomcat 8 on ubuntu 14.04 systems. For additional help or useful information, we recommend you check the official Apache website.