How to Run Multiple Tomcat Instances on One Server?

Dear 丶 2022-08-08 19:47 23阅读 0赞

# How to Run Multiple Tomcat Instances on One Server? #

Short link:

Last Updated on *November 26th, 2014* by [Crunchify][] [6 Comments][]

name="aswift\_0" width="728" height="90" id="aswift\_0" frameborder="0" marginwidth="0" marginheight="0" scrolling="no" vspace="0" hspace="0" allowfullscreen="true" style="left: 0px; top: 0px; position: absolute;" allowtransparency="true">

I’m sure you must have faced one of below question while developing Dynamic Web Project in past.

*  Running multiple [Tomcat instances][] on one server
 *  Advanced Configuration – Multiple Tomcat Instances
 *  Running Multiple Tomcat Instances on Single Machine
 *  java – Running Multiple Tomcat Instances on One Windows Machine
 *  use multiple CATALINA\_BASE to setup tomcat 6 instances on windows

If yes, then you are at right place..

[![Tomcat Multiple Instances][]][Tomcat Multiple Instances]

#### **Lets 1st understand [Tomcat][Tomcat instances] Directory Structure..** ####

When creating multiple instances of tomcat server, we need to play with the folders inside the server. These folders contain the actual scripts and code for the server. We have the option to either use the code base for tomcat in shared mode where all tomcat instances refer to the same physical code or we can create separate copies of these folder for each tomcat instance.

*  `/bin :` This directory contains the startup and shutdown scripts for both Windows and Linux.
 *  `/conf : `This directory contains the main configuration files for Tomcat. The two most important are the server.xml and the global web.xml .
 *  `/server : `This directory contains the Tomcat Java Archive files.
 *  `/lib :` This directory contains Java Archive files that Tomcat is dependent upon.
 *  `/logs :` This directory contains Tomcat’s log files.
 *  `/src :` This directory contains the source code used by the Tomcat server. Once Tomcat is released, it will probably contain interfaces and abstract classes only.
 *  `/webapps :` All web applications are deployed in this directory; it contains the WAR file.
 *  `/work :` This is the directory in which Tomcat will place all servlets that are generated from JSPs. If you want to see exactly how a particular JSP is interpreted, look in this directory.

#### **[Tomcat][Tomcat instances] server ports** ####

Having a good understanding of tomcat ports is essential to manage the multiple instances of the same server installation. These ports are used by tomcat for start-up, deployment and shut-down operations. The detail of each port is as:

*  `Connector Port `: This is the port where Apache Tomcat listen for the HTTP requests.
 *  `Shutdown Port `: This port is used when we try to shutdown the Apache Tomcat Server.
 *  `AJP (Apache JServ Protocol) Connector Port` : The Apache JServ Protocol (AJP) is a binary protocol that can conduct inbound requests from a web server through to an application server that sits behind the web server.
 *  `Redirect Port` : Any redirection happening inside Apache Tomcat will happen through this port. In Apache TOMCAT there are two instance where redirectPort is mentioned. First one is for the Apache TOMCAT server and other one is for the AJP port.

Other must read:

*  [How to Start Stop Apache Tomcat Server via Command Line?][How to Start Stop Apache Tomcat Server via Command Line]
 *  [How to Run Java Program Automatically on Tomcat Startup][]

#### Lets start creating multiple Tomcat Instances in Mac environment.. ####

### Step-1 ###

Download and Copy Tomcat Instances under `~/Documents/Crunchify/` folder.

[![Multiple Tomcat Instances][]][Multiple Tomcat Instances]

### Step-2 ###

name="aswift\_1" width="728" height="15" id="aswift\_1" frameborder="0" marginwidth="0" marginheight="0" scrolling="no" vspace="0" hspace="0" allowfullscreen="true" style="left: 0px; top: 0px; position: absolute;" allowtransparency="true">

Change below `HTTP, HTTPS, AJP, Shutdown Ports`for `Tomcat2` instance.

File location: `Tomcat2/conf/server.xml` file.

[![Apache Tomcat Server Shutdown Port][]][Apache Tomcat Server Shutdown Port] [ ![Apache Tomcat Server Connector Port][]][Apache Tomcat Server Connector Port] [ ![Apache Tomcat Server AJP Port][]][Apache Tomcat Server AJP Port]

### Step-3 ###

The `startup.sh` and `shutdown.sh` script files make use of `catalina.sh` for performing the startup and shutdown operations. We shall edit `catalina.sh` file as described below:

#### a) ####

For `tomcat1`, specify following two variables in `catalina.sh`  script file present in the bin folder of the tomcat\_home

<table> 
 <tbody> 
  <tr> 
   <td> 
    <div style="line-height:14px!important; font-size:12px!important"> 
     <div>
       1 
     </div> 
     <div>
       2 
     </div> 
    </div> </td> 
   <td> 
    <div style=""> 
     <div> 
      <span>export </span> 
      <span>CATALINA_HOME</span> 
      <span>=</span> 
      <span> </span> 
      <span>/</span> 
      <span>Users</span> 
      <span>/</span> 
      <span>&lt;</span> 
      <span>username</span> 
      <span>&gt;</span> 
      <span>/</span> 
      <span>Documents</span> 
      <span>/</span> 
      <span>Crunchify</span> 
      <span>/</span> 
      <span>Tomcat1</span> 
     </div> 
     <div> 
      <span>export </span> 
      <span>CATALINA_BASE</span> 
      <span>=</span> 
      <span> </span> 
      <span>/</span> 
      <span>Users</span> 
      <span>/</span> 
      <span>&lt;</span> 
      <span>username</span> 
      <span>&gt;</span> 
      <span>/</span> 
      <span>Documents</span> 
      <span>/</span> 
      <span>Crunchify</span> 
      <span>/</span> 
      <span>Tomcat1</span> 
     </div> 
    </div> </td> 
  </tr> 
 </tbody> 
</table>

#### b) ####

For `tomcat2`, specify following two variables in `catalina.sh` script file present in the bin folder of the tomcat\_home

<table> 
 <tbody> 
  <tr> 
   <td> 
    <div style="line-height:14px!important; font-size:12px!important"> 
     <div>
       1 
     </div> 
     <div>
       2 
     </div> 
    </div> </td> 
   <td> 
    <div style=""> 
     <div> 
      <span>export </span> 
      <span>CATALINA_HOME</span> 
      <span>=</span> 
      <span> </span> 
      <span>/</span> 
      <span>Users</span> 
      <span>/</span> 
      <span>&lt;</span> 
      <span>username</span> 
      <span>&gt;</span> 
      <span>/</span> 
      <span>Documents</span> 
      <span>/</span> 
      <span>Crunchify</span> 
      <span>/</span> 
      <span>Tomcat2</span> 
     </div> 
     <div> 
      <span>export </span> 
      <span>CATALINA_BASE</span> 
      <span>=</span> 
      <span> </span> 
      <span>/</span> 
      <span>Users</span> 
      <span>/</span> 
      <span>&lt;</span> 
      <span>username</span> 
      <span>&gt;</span> 
      <span>/</span> 
      <span>Documents</span> 
      <span>/</span> 
      <span>Crunchify</span> 
      <span>/</span> 
      <span>Tomcat2</span> 
     </div> 
    </div> </td> 
  </tr> 
 </tbody> 
</table>

### Step-4 ###

Startup scripts are a whole other topic, but here’s the brief rundown. The main different from running a single Tomcat instance is you need to set `CATALINA_BASE`  to the directory you set up for the particular instance you want to start (or stop).

Here’s a typical startup routine:

<table> 
 <tbody> 
  <tr> 
   <td> 
    <div style="line-height:14px!important; font-size:12px!important"> 
     <div>
       1 
     </div> 
     <div>
       2 
     </div> 
     <div>
       3 
     </div> 
     <div>
       4 
     </div> 
     <div>
       5 
     </div> 
    </div> </td> 
   <td> 
    <div style=""> 
     <div> 
      <span>JAVA_HOME</span> 
      <span>=</span> 
      <span>/</span> 
      <span>usr</span> 
      <span>/</span> 
      <span>java</span> 
     </div> 
     <div> 
      <span>JAVA_OPTS</span> 
      <span>=</span> 
      <span>"-Xmx1024m -Xms300m"</span> 
     </div> 
     <div> 
      <span>export </span> 
      <span>JAVA_HOME </span> 
      <span>JAVA_OPTS </span> 
      <span>CATALINA_HOME </span> 
      <span>CATALINA</span> 
      <span>_</span>BASE 
     </div> 
     <div>
       &nbsp; 
     </div> 
     <div> 
      <span>$</span> 
      <span>CATALINA_HOME</span> 
      <span>/</span> 
      <span>bin</span> 
      <span>/</span> 
      <span>catalina</span> 
      <span>.</span> 
      <span>sh </span> 
      <span>start</span> 
     </div> 
    </div> </td> 
  </tr> 
 </tbody> 
</table>

Have anything to add to this article? Please chime in and join the conversion.

[Crunchify]: http://crunchify.com/about
[6 Comments]: http://crunchify.com/how-to-run-multiple-tomcat-instances-on-one-server/#disqus_thread
[Tomcat instances]: http://crunchify.com/category/apache-tomcat/
[Tomcat Multiple Instances]: http://cdn3.crunchify.com/wp-content/uploads/2013/05/Tomcat-Multiple-Instances.png
[How to Start Stop Apache Tomcat Server via Command Line]: http://crunchify.com/how-to-start-stop-apache-tomcat-server-via-command-line-setup-as-windows-service/
[How to Run Java Program Automatically on Tomcat Startup]: http://crunchify.com/how-to-run-java-program-automatically-on-tomcat-startup/
[Multiple Tomcat Instances]: http://cdn3.crunchify.com/wp-content/uploads/2013/06/Multiple-Tomcat-Instances.png
[Apache Tomcat Server Shutdown Port]: http://cdn3.crunchify.com/wp-content/uploads/2013/06/Apache-Tomcat-Server-Shutdown-Port.png
[Apache Tomcat Server Connector Port]: http://cdn3.crunchify.com/wp-content/uploads/2013/06/Apache-Tomcat-Server-Connector-Port.png
[Apache Tomcat Server AJP Port]: http://cdn.crunchify.com/wp-content/uploads/2013/06/Apache-Tomcat-Server-AJP-Port.png