Running admintool

The admintool Web application can be used to manipulate Tomcat while it is running. For example, you can add a context or set up users and roles for container-managed security.

Start Tomcat by calling its startup script from the command line, as follows:

<JWSDP_HOME>/bin/startup.sh (Unix platform)

<JWSDP_HOME>\bin\start startup.bat (Microsoft Windows)

Start a Web browser.

In the Web browser, point to the following URL:

http://localhost:8080/admin

This command invokes the Web application with the context of admin.

This user name and password combination is assigned the roles of admin, manager, and provider by default. To use admintool, you must log in with a user name and password combination that has been assigned the role of admin.

If you've forgotten the user name and password, you can find them in the file <JWSDP_HOME>/conf/tomcat-users.xml, which is viewable with any text editor. This file contains an element <user> for each individual user, which might look something like this:

<user name="your_name" password="your_password" roles="admin,manager,provider" />

Perform Tomcat Web Server Administration tasks.

After you have made changes to Tomcat, select the Save button on that page to save the attributes for the current Tomcat process. Select the Commit Changes button to write the changes to the <JWSDP_HOME>/conf/server.xml file so that the changes to the Tomcat server are persistent and will be retrieved when Tomcat is restarted.

The previous version of server.xml is backed up in the same directory, with an extension indicating when the file was backed up, for example, server.xml.2003-02-15.12-11-54. To restore a previous configuration, shut down Tomcat, rename the file to server.xml, and restart Tomcat.

Log out of admintool by selecting Log Out when you are finished.

Shut down Tomcat by calling its shutdown script from the command line, as follows:

<JWSDP_HOME>/bin/shutdown.sh (Unix platform)

<JWSDP_HOME>\bin\shutdown.bat (Microsoft Windows)

This document contains information about using admintool to configure the behavior of Tomcat. For more information on these configuration elements, read the Tomcat Configuration Reference, which can be found at <JWSDP_HOME>/docs/tomcat/config/index.html.

This document does not attempt to describe which configurations should be used to perform specific tasks. For information of this type, refer to the documents listed in Further Information.