use multiple CATALINA_BASE to setup tomcat 6 instances on windows

Question

The RUNNING.txt that comes with tomcat distribution indicates the use of CATALINA_BASE variable to enable multiple tomcat instance. But how can I set the CATALINA_BASE environment variable for each tomcat instance directory?

Answer 1

Having multiple Tomcat instances on your development machine is great. Here's how I usually do it for Windows (the important parts for setup are in steps 2, 3, 4 and 5):

1. Install a copy of Tomcat 6 to a directory (like C:\apache-tomcat-6.0.20).
2. Copy the conf directory to another directory (like C:\tomcat-1)
3. Under C:\tomcat-1, create a bin directory

4. In the C:\tomcat-1\bin directory, create a file called startup.bat that reads like this:

   set CATALINA_BASE=C:\tomcat-1

   set CATALINA_HOME=C:\apache-tomcat-6.0.20

   C:\apache-tomcat-6.0.20\bin\startup.bat

5. In the C:\tomcat-1\bin directory, create a file called shutdown.bat that reads like this:

   set CATALINA_BASE=C:\tomcat-1

   set CATALINA_HOME=C:\apache-tomcat-6.0.20

   C:\apache-tomcat-6.0.20\bin\shutdown.bat

6. OPTIONAL: create a file called setenv.bat in the C:\tomcat-1\bin directory to set any environment variables mentioned in C:\apache-tomcat-6.0.20\bin\catalina.bat. This is the place to set system properties, JPDA addresses, etc.

7. Create the logs, temp, webapps and work directories under C:\tomcat-1
8. From the C:\tomcat-1 directory, run bin\startup.bat
9. Repeat for your other installs from step 2 for as many tomcat instances as you need.

Try not to install Tomcat in a directory that has spaces in its name. It should work, but you'll experience fewer problems that way. I do not know how this would work if you were using the "tomcat as a service" option for Windows.

From here, you should be able to isolate tomcat instances. Just be sure to edit your conf\server.xml file so that the shutdown ports and HTTP connector ports don't interfere with other Tomcat instances that may be running. I usually assign values like 8005, 8006, 8007, etc. for the shutdown port and 8080, 8081, 8082, etc. for the HTTP connector port.

Answer 2

There is an easier way. Simply don't define the CATALINA_HOME as a Environment variable on your machine. startup.bat and shutdown.bat already come with the following code:

if not "%CATALINA_HOME%" == "" goto gotHome
set "CATALINA_HOME=%CURRENT_DIR%"

You should be all set. PS: Remember to edit server.xml and put a new port number though. :)