How To Install Apache Tomcat on CentOS 7 Step by Step

Install Apache Tomcat on CentOS 7

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. In this tutorial we will learn how to Install Apache Tomcat on CentOS 7 Step by Step.

Prerequisites

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 and assumes you are running in the root account, if not you may need to add ‘sudo’ to the commands to get root privileges. I will show you through the step by step install Apache Tomcat on CentOS 7 server.

Install Apache Tomcat on CentOS 7

Step 1. First let’s start by ensuring your system is up-to-date.

yum clean all
yum -y update

Step 2. Installing Java 8.

Apache Tomcat 9 requires Java 8 or newer to be installed on the server. Run the following command to install Java 8:

yum install java-1.8.0-openjdk.x86_64 java-1.8.0-openjdk-devel.x86_64

Once installed, You can also verify it, by issuing the following command:

java -version

Step 3. Install Apache Tomcat 9 on CentoS 7.

First, go to the official Apache Tomcat website and download the most recent version of the software to your server. At the moment the most recent release is version 9.0.7:

wget http://www.apache.org/dist/tomcat/tomcat-9/v9.0.7/bin/apache-tomcat-9.0.7.zip

Unpack the downloaded zip archive:

unzip apache-tomcat-9.0.7.zip -d /opt

Next, create a new directory named ‘apache-tomcat-9.0.7’. We will rename it to something simpler:

cd /opt
mv apache-tomcat-9.0.7/ tomcat

Then, run the following commands to set the CATALINA_HOME environment variable:

echo "export CATALINA_HOME='/opt/tomcat/'" >> ~/.bashrc
source ~/.bashrc

It is not recommended to run Apache Tomcat as user root, so add tomcat user and group:

useradd -r tomcat --shell /bin/false
chown -R tomcat:tomcat /opt/tomcat/

Now, Create the a systemd file with the following content:

### nano /etc/systemd/system/tomcat.service

[Unit]
Description=Apache Tomcat 9
After=syslog.target network.target[Service]
User=tomcat
Group=tomcat
Type=forking
Environment=CATALINA_PID=/opt/tomcat/tomcat.pid
Environment=CATALINA_HOME=/opt/tomcat
Environment=CATALINA_BASE=/opt/tomcat
ExecStart=/opt/tomcat/bin/startup.sh
ExecStop=/opt/tomcat/bin/shutdown.sh
Restart=on-failure

[Install] WantedBy=multi-user.target

Save the file and run the following command to reload the systemd manager:

systemctl daemon-reload
systemctl start tomcat
systemctl enable tomcat

Step 4. Assessing Apache Tomcat 9.

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: http://IP_address:8080/manager/html using user ‘admin’ and password ‘PASSWORD’

Congratulation’s! You have successfully installed Apache Tomcat. Thanks for using this tutorial for installing Apache Tomcat on CentOS 7 systems. For additional help or useful information, we recommend you to check the official Apache Tomcat web site.

How To Install Apache Tomcat 8 on CentOS

Install Apache Tomcat 8 on CentOS

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.

Install Apache Tomcat 8 on CentOS

Step 1. JAVA is the first requirement of Tomcat installation.

CentOS 32 bit:

wget --no-cookies \
--no-check-certificate \
--header "Cookie: oraclelicense=accept-securebackup-cookie" \
"http://download.oracle.com/otn-pub/java/jdk/8u5-b13/jdk-8u5-linux-i586.rpm" \
-O /opt/jdk-8-linux-i586.rpm
 rpm -Uvh /opt/jdk-8-linux-i586.rpm

CentOS 64 bit:

wget --no-cookies \
--no-check-certificate \
--header "Cookie: oraclelicense=accept-securebackup-cookie" \
"http://download.oracle.com/otn-pub/java/jdk/8u5-b13/jdk-8u5-linux-x64.rpm" \
-O /opt/jdk-8-linux-x64.rpm
 rpm -Uvh /opt/jdk-8-linux-x64.rpm

Next, configure newly installed JAVA 8 files using command ‘alternatives‘, run the following series of commands on the terminal to configure Java.

# alternatives --install /usr/bin/java java /usr/java/jdk1.8.0_05/jre/bin/java 20000
# alternatives --install /usr/bin/jar jar /usr/java/jdk1.8.0_05/bin/jar 20000
# alternatives --install /usr/bin/javac javac /usr/java/jdk1.8.0_05/bin/javac 20000
# alternatives --install /usr/bin/javaws javaws /usr/java/jdk1.8.0_05/jre/bin/javaws 20000
# alternatives --set java /usr/java/jdk1.8.0_05/jre/bin/java
# alternatives --set javaws /usr/java/jdk1.8.0_05/jre/bin/javaws
# alternatives --set javac /usr/java/jdk1.8.0_05/bin/javac
# alternatives --set jar /usr/java/jdk1.8.0_05/bin/jar

You can also verify it, by issuing the following command.

 java -version

Step 2. Download and extract Tomcat archive.

Once installing and configuring JAVA on the system, now it’s time to download 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 pache-tomcat-8.0.21.tar.gz


Step 3. 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 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 started.

You can verify the service running, by default tomcat runs on port no 8080.

[root@server ~]# 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. Setup 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" />

Congratulation’s! You have successfully Apache Tomcat. Thanks for using this tutorial for installing Apache Tomcat 8 on CentOS system. For additional help or useful information, we recommend you to check the official Apache Tomcat web site.