Adding a Tomcat Server

See Also

When you install the IDE, the installer automatically adds the bundled Tomcat servlet container. You can also configure the IDE to deploy web modules to other installations of supported versions of Tomcat, as shown in the following steps. This version of the IDE supports Tomcat version 5.0.19.

tip  Before you can add a server, you must have a Tomcat username that has the manager role associated with it. By default, there are no Tomcat user names with the manager role. You must either create a user and associate the manager role with the user or you must add the manager role to an existing username. For more information, see http://jakarta.apache.org/tomcat/tomcat-5.0-doc/manager-howto.html.

To add a Tomcat Server:

  1. Make sure the server is not running. If the server is running and there is a port number conflict with other installed servers, the IDE will not be able to resolve the conflict.
  2. In the Runtime window, expand the Server Registry node, right-click the Tomcat 5 Servers node, and choose Add New Server from the contextual menu to display the Add New Server dialog box.
  3. In the Install Directory text box, type or browse to the Tomcat installation directory on your local system. Note that the system verifies that you have specified a valid Tomcat home directory.
  4. (Optional) If you expect to use Tomcat in a multi-user configuration, select the Shared Installation checkbox. and, in the Base Directory text box, type or browse to the base directory. Typically, a base directory is placed under a user's directory. If you associate a base directory with the server, the base directory must have the following subdirectories. In addition, the conf directory must have a server.xml file.
  5. Type a user name and password. The user must be a Tomcat user who has a manager role.
  6. (Optional) If you are using the server for production purposes only, you may want to clear the Enable HTTP Monitor checkbox to reduce its impact on the server's performance. The HTTP Monitor is useful for debugging web modules. You can also enable and disable the monitor from the server's property sheet.
  7. Click OK. The IDE displays the server's port number in the server node's text. If another server instance is using this port, you must change one of the servers' port numbers. To change a port number, right-click the server's node, choose Start/Stop Server from the contextual menu, and stop the server. Next, right-click the server node and choose Properties from the contextual menu. Change the server port number and restart the server.
  8. (Optional) If you want the IDE to use this server for executing web modules, right-click the server's node and choose Set as Default from the contextual menu. The URL for the default server appears in parentheses next to the Server Registry node.

If you want to change any setting that you entered in the New Server Dialog box, right-click the server's node in the Runtime window and choose Properties from the contextual menu.

See Also
Tomcat Instance Node
Tomcat Instance Property Sheet

Legal Notices