tomcat - CATALINA_BASE and CATALINA_HOME variables

java tomcat environment-variables
souser picture souser · Jun 22, 2010 · Viewed 199.7k times · Source

I have multiple instances of tomcat 6 running on the same server (Linux) and it works as expected. I am trying to find out what the standard practice is with regards to setting the CATALINA_HOME and CATALINA_BASE variables.

In my tomcat installation, I have setup CATALINA_HOME to point to a "common" folder (say /tomcat6) and the CATALINA_BASE variable varies depending on the instance name (say /tomcat_instance1, /tomcat_instance2)

My question is this:

  • Do I really need two variables?
  • Or Can I just have one CATALINA_HOME and do away with CATALINA_BASE (or vice-versa) ?

Answer

Russ picture Russ · Dec 21, 2011

If you are running multiple instances of Tomcat on a single host you should set CATALINA_BASE to be equal to the .../tomcat_instance1 or .../tomcat_instance2 directory as appropriate for each instance and the CATALINA_HOME environment variable to the common Tomcat installation whose files will be shared between the two instances.

The CATALINA_BASE environment is optional if you are running a single Tomcat instance on the host and will default to CATALINA_HOME in that case. If you are running multiple instances as you are it should be provided.

There is a pretty good description of this setup in the RUNNING.txt file in the root of the Apache Tomcat distribution under the heading Advanced Configuration - Multiple Tomcat Instances

Related questions

How to set CATALINA_HOME variable in windows 7?

I have downloaded apache-tomcat-7.0.35. My JDK version is jdk1.6.0_27. How do I configure CATALINA_HOME as an environment variable and how do I run Tomcat server under Windows 7?

Read More
JRE_HOME variable missing with Tomcat (win7)

I installed tomcat and Apache http-servers like two weeks ago. I got it running and I was able to run the JSP-pages from another computers. I had a little pause and now that I'm trying to run the system it …

Read More
Passing JVM arguments to Tomcat when running as a service?

I need to pass a couple of JVM arguments to the JVM which Tomcat is running in so that my application can pick them up. I want to follow the process outlined in this article to pick up environment variables. …

Read More