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.
|
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:
- 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.
- 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.
- 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.
- (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.
- conf. Directory for server configuration files
- logs. Directory for log and output files
- webapps. Directory for automatically loaded web applications
- work. Temporary working directory for web applications
- Type a user name and password. The user must be a Tomcat user who has a
manager role.
- (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.
- 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.
- (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.
Legal Notices