Download
FAQ
History
HomeHomeNext 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 the terminal prompt:
    •   <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.2Right 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.
  6. This user name and password combination is assigned the roles of admin, and manager by default. To use admintool, you must log in with a user name and password combination that has been assigned the role of admin, such as the user name and password defined when you installed the Java WSDP.

    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" />

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

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 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
HomeHomeNext 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.