Download
FAQ
History
PrevHomeNext API
Search
Feedback
Divider

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.

To start admintool, follow these steps.

  1. Start Tomcat as follows:
    • On the Unix platform, type the following at a terminal window:
    •   <JWSDP_HOME>/bin/startup.sh

    • On the Microsoft Windows platform, start Tomcat from the Start menu by following this chain: StartRight ArrowProgramsRight ArrowJava Web Services Developer Pack 1.3Right ArrowStart Tomcat.
  2. Start a Web browser.
  3. In the Web browser, point to the following URL:
  4.   http://localhost:8080/admin

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

  5. Log in to admintool using a user name and password combination that has been assigned the role of admin, such as the user name and password that you entered when you installed the Java WSDP, or a user name and password combination that you entered subsequent to installation and to which you have assigned the role of admin.
  6. For security purposes, admintool verifies that you (as defined by the information you provide when you log into the application) are a user who is authorized to install and reload applications (defined as a user with the role of admin in tomcat-users.xml) before granting you access to the server.

    If you've forgotten this 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" />

When a successful user name and password combination is entered, the admintool Web application displays in the Web browser window:

The admintool Web application as it displays in the Web browser window.

Figure A-1 The Tomcat Server Administration Tool

Once admintool is running, you can perform any of the Tomcat Web Server administration tasks listed in the rest of this appendix. After you have made changes to Tomcat, select the Save button on that page to save the attributes for the current Tomcat process.

If you want the changes to the Tomcat server to be available when Tomcat is restarted, select the Commit Changes button. This writes the changes to the <JWSDP_HOME>/conf/server.xml file. 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-10-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.

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 http://jakarta.apache.org/tomcat/tomcat-5.0-doc/index.html.

This appendix 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.

Divider
Download
FAQ
History
PrevHomeNext API
Search
Feedback
Divider

All of the material in The Java(TM) Web Services Tutorial is copyright-protected and may not be published in other works without express written permission from Sun Microsystems.