The Internal Tomcat Server Installation

See Also

When you install the IDE, an installation of the Tomcat web server called Internal is added automatically. This installation cannot be removed. You can also configure the IDE to deploy web modules to external installations of Tomcat. See Adding a Tomcat Installation for more information.

In the Internal Tomcat, configuration files reside in the base directory, located under the directory that the IDE has allocated to the individual user. The base directory is called tomcat406_base. The home directory resides under the IDE installation directory and is called tomcat406. Note that this setup differs from a typical Tomcat installation, where the base directory and home directory coincide. See http://jakarta.apache.org/tomcat/tomcat-4.0-doc/RUNNING.txt for more information.

The existence of a separate base directory allows several instances of the server, which run different web modules, to share the same installation, including libraries. Shared libraries used by web modules must be added to the tomcat406 directory, that is, the home directory. Do not add shared libraries to the tomcat406 directory.

Developers using a common IDE installation need to exercise caution when adding shared libraries to the tomcat406 directory. Libraries stored in the tomcat406 directory are shared by all web modules that are deployed on the server, so the potential for version conflicts exists.

Configuration files for the Tomcat Internal installation reside in the tomcat406_base directory, that is, the base directory. You can also edit configuration files using the IDE. See Editing the Tomcat Server Configuration File for more information.

On the UNIX platform, the IDE is sometimes installed in a read-only directory. If this is the case, you will not be able to add shared libraries to the Internal Tomcat installation. Ask the person responsible for the IDE installation to make writable all directories under the Tomcat home directory. Alternatively, you could add an installation of Tomcat, then configure it to meet your needs. See Adding a Tomcat Installation for more information.

See Also

Creating a Web Module
Debugging JSP and Servlet Files


Legal Notices