Running Multiple Tomcat Instances on Single Machine

-
In this post we will see how to run multiple tomcat instances on single machine and under single user account.
We first see the tomcat directory structure. .






here each folder uses following purpose.

bin - It contains all binary and script files for running tomcat.

lib - contains all shared libraries used for tomcat

conf - contains configuration information like which port tomcat can bind , etc...

logs - it contain all logging details

temp - this folder tomcat used for temporary files purpose

webapps - this folder is very important. here we put all application war files.

work - If application contain any jsp then jsp is translated and converted into servlet its stores here.


In when run the tomcat its uses 5 environment variables. They are
CATALINA_HOME, CATALINA_BASE, CATALINA_TMPDIR, JRE_HOME/JAVA_HOME, CLASSPATH

in above list CATALINA_HOME and JAVA_HOME is mandatory environment variables. all others are optional and its can be calculated using CATALINA_HOME.



CATALINA_HOME - this environment variable should point to tomcat base folder, where tomcat binary are installed/extracted. so based on CATALINA_HOME we can get bin and lib folder

CATALINA_BASE - If we not specified then CATALINA_HOME value is set. This variable pointed to configuration and webapps folder. Based on this variable server uses conf, logs, temp, webapps, work folders.
Usual ways to run the tomcat is only set CATALINA_HOME environment variable. and run thestartup.bat script file. this startup.bat file automatically calculate and assign the values of other variables what we are not set.




startup.bat file set the environment variable and then call catalina.sh file. this files is read CATALINA_BASE value and attach conf i.e $CATALINA_BASE/conf folder and get server.xml. this file is heart of tomcat. it contains all configuration information. like which tomcat uses as shoutdown port, connector post, host name, application folder ,.. for example usually tomcat uses 8080 is a connector port, so we can access http://localhost:8080/

if we set the $CATALINA_BASE explicitly then tomcat uses our variable to search and get the server.xml file from our target place, what we specified in CATALINA_BASE.

this is trick to run multiple tomcat in single machine. we don't change CATALINA_HOME value. we need to change CATALINA_BASE value before start/shutdown the tomcat.


create one folder named "tomcat-instance1" anywhere, and copy conf, logs,temp, webapps,work folder from CATALINA_HOME folder and change conf/server.xml file in tomcat-instance1. we need to change 3 port shutdown port, connector port and ajp port.

shutdown port - this port is used for shutdown the tomcat. when we call the shutdown.batscript they send signal to shutdown port. this port listen by tomcat java process. if signal is received the that process then its cleanup and exit by itself.

connector Port -This port is actual port to expose the application to outside client.

ajp port - this port is used to apache httpd server communicate to tomcat. this port used when we setup load balanced server.

see the sample server.xml file

<server port="8005" shutdown="SHUTDOWN">
<connector connectiontimeout="20000" port="8080" protocol="org.apache.coyote.http11.Http11NioProtocol" redirectport="8443">
<connector port="8009" protocol="AJP/1.3" redirectport="8443"> </connector></connector></server>
so we change these three port to different number, because once this port is binded then other process can't bind it again. so wee bind different port. so tomcat-instance1/conf/server.xml file i configured server port =8105, connector port = 8181, ajp port = 8109.
<server port="8105" shutdown="SHUTDOWN">
<connector connectiontimeout="20000" port="8181" protocol="org.apache.coyote.http11.Http11NioProtocol" redirectport="8443">
<connector port="8109" protocol="AJP/1.3" redirectport="8443"> </connector></connector></server>

now we can create two script file for startup and shutdown the tomcat-instance1.
startup-instance1.bat
set JAVA_HOME=C:\Program Files\Java\jdk1.7.0_17

set CATALINA_HOME=c:\tomcat
set CATALINA_BASE=c:\tomcat-instance1

startup.bat


shutdown-instance1.bat
set JAVA_HOME=C:\Program Files\Java\jdk1.7.0_17

set CATALINA_HOME=c:\tomcat
set CATALINA_BASE=c:\tomcat-instance1

shutdown.bat



here we explicitly set the CATALINA_BASE variable and point to new tomcat-instance1
the we go to CATALINA_HOME/bin folder because all binary for running tomcat is still present in CATALINA_HOME folder then startup/shutdown the script.



Based on above technique we can create many instance folder and change conf/server.xml file port values and run that instance with own newly created script files.

Popular posts from this blog

Shrink you container size up to 95%.

-
BLAFS is a bloat-aware filesystem for container debloating. The design principles of BLAFS are effective, efficient, and easy to use. It detects the files used by the container, and then debloats the container by removing the unused files. The debloated containers are still functional and can run the same workload as the original containers, but with a much smaller size and faster deployment. https://github.com/negativa-ai/BLAFS?tab=readme-ov-file
Read more

alma linux: dnf Module yaml error: Unexpected key in data

-
While applying recent updates to a server running Rocky Linux 8, an error presented itself. Module yaml error: Unexpected key in data: static_context [line 9 col 3] Module yaml error: Unexpected key in data: static_context [line 9 col 3] The solution turned out to be a simple one. Update the libmodulemd first to correct the problem then perform the dnf updates as usual. dnf update libmodulemd For a detailed explanation as to the cause of this problem.
Read more