Deploying Java Web on CentOS

Last updated: 2019-10-16 18:09:23


This document describes how to deploy Java Web projects on CentOS. It is suitable for new individual users of Tencent Cloud.

Software Version

The versions of software tools used in this document are as follows, which may be different from your software versions during actual operations.

  • Operating system: CentOS 7.5
  • Tomcat: apache-tomcat-8.5.39
  • JDK: JDK 1.8.0_201

Installing JDK

After purchasing the CLB service, you can click Log in on the CVM details page to log in to your CVM instance. And then enter your username and password to set up the Java Web environment. For more information on how to create a CVM instance, see Creating CVM Instance.

Downloading JDK

Enter the following command:

mkdir /usr/java  # Create a Java folder
cd /usr/java     # Enter a Java folder
# Executing the command: Use wget to download the package, which cannot be decompressed because a downloaded package declines the Oracle BSD License by default. Please go to to accept the license agreement and obtain the download link with your cookies. You can also directly download the JDK installation package and upload it to your instance.
wget --no-check-certificate --no-cookies --header "Cookie: oraclelicense=accept-securebackup-cookie"
# Decompression
chmod +x jdk-8u201-linux-x64.tar.gz
tar -xzvf jdk-8u201-linux-x64.tar.gz

Setting an Environmental Variable

  1. Open the /etc/profile file.
    vi /etc/profile
  2. Press I to enter the editing mode and add the following information to the file.
    # set java environment
    export JAVA_HOME=/usr/java/jdk1.8.0_201
    export CLASSPATH=$JAVA_HOME/lib/tools.jar:$JAVA_HOME/lib/dt.jar:$JAVA_HOME/lib
    export PATH=$JAVA_HOME/bin:$PATH
  3. Press Esc to exit the editing mode and enter :wq to save and close the file.
  4. Load the environmental variable.
    source /etc/profile

Viewing JDK Installation Result

Run the java -version command. If the JDK version information is displayed, JDK has been successfully installed.

Installing Tomcat

Downloading Tomcat

Enter the following command:

tar -xzvf apache-tomcat-8.5.39.tar.gz
mv apache-tomcat-8.5.39 /usr/local/tomcat/

The following files are in the /usr/local/tomcat/ directory:

  • bin: script file, which contains scripts for starting and stopping the Tomcat service.
  • conf: global configuration files, of which the most important ones are server.xml and web.xml.
  • webapps: the main web release directory in Tomcat, which is the default directory for storing web application files.
  • logs: Tomcat log files.

If the download link expired, replace it with the latest link at Tomcat's official website.

Adding a User

# Add a general user `www` to run Tomcat
useradd www
# Create a Website Root Directory
mkdir -p /data/wwwroot/default
# Upload the Java Web project files (WAR package) to the website root directory and modify the file permission under the directory to `www`. This example shows how to create a Tomcat test page in the website root directory:
echo Hello Tomcat! > /data/wwwroot/default/index.jsp
chown -R www.www /data/wwwroot

Setting JVM Memory Parameters

  1. Create a /usr/local/tomcat/bin/ script file.
    vi /usr/local/tomcat/bin/
  2. Press I to enter the editing mode, add the following, and save.
    JAVA_OPTS=' -server -Xms256m -Xmx496m -Dfile.encoding=UTF-8'

Configuring server.xml

  1. Switch to the /usr/local/tomcat/conf/ directory.
    cd /usr/local/tomcat/conf/
  2. Back up the server.xml file.
    mv server.xml server_default.xml
  3. Create a new server.xml file.
    vi server.xml
  4. Press I to enter the editing mode and add the following.
    <?xml version="1.0" encoding="UTF-8"?>
    <Server port="8006" shutdown="SHUTDOWN">
    <Listener className="org.apache.catalina.core.JreMemoryLeakPreventionListener"/>
    <Listener className="org.apache.catalina.mbeans.GlobalResourcesLifecycleListener"/>
    <Listener className="org.apache.catalina.core.ThreadLocalLeakPreventionListener"/>
    <Listener className="org.apache.catalina.core.AprLifecycleListener"/>
    <Resource name="UserDatabase" auth="Container"
    description="User database that can be updated and saved"
    <Service name="Catalina">
    <Connector port="8080"
    <Engine name="Catalina" defaultHost="localhost">
    <Realm className="org.apache.catalina.realm.LockOutRealm">
    <Realm className="org.apache.catalina.realm.UserDatabaseRealm"
    <Host name="localhost" appBase="/data/wwwroot/default" unpackWARs="true" autoDeploy="true">
    <Context path="" docBase="/data/wwwroot/default" debug="0" reloadable="false" crossContext="true"/>
    <Valve className="org.apache.catalina.valves.AccessLogValve" directory="logs"
    prefix="localhost_access_log." suffix=".txt" pattern="%h %l %u %t &quot;%r&quot; %s %b" />
  5. Press Esc to exit the editing mode and enter :wq to save and exit.

Starting Tomcat

Method A

Enter the bin directory of the Tomcat server and run the ./ command to start the Tomcat server.

cd /usr/local/tomcat/bin

The execution result is as follows:

Method B

  1. Set up quick start, so that the Tomcat server can be started anywhere through service tomcat start.
    mv Tomcat-init /etc/init.d/tomcat
    chmod +x /etc/init.d/tomcat
  2. Run the following command and set the JAVA_HOME startup script.
    sed -i 's@^export JAVA_HOME=.*@export JAVA_HOME=/usr/java/jdk1.8.0_201@' /etc/init.d/tomcat
  3. Set auto-run.
    chkconfig --add tomcat
    chkconfig tomcat on
  4. Start Tomcat.
    # Start Tomcat
    service tomcat start
    # View Tomcat server status
    service tomcat status
    # Stop Tomcat
    service tomcat stop
    The execution result is as follows:
  5. If the system prompts that you have no permissions, enter the following.
    cd /usr/local
    chmod -R 777 tomcat
  6. Enter http://public IP:port (where the port is the connector port set in server.xml) in the address bar of the browser. If the following page appears, the installation is successful.

Configuring a Security Group

In case of access failure, check the security group. As shown in the above example, the connector port is 8080 in server.xml, so you need to open TCP:8080 to the internet in the security group bound to the corresponding CVM instance.