Download FAQ History |  | API Search Feedback

> ## 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: StartProgramsJava Web Services Developer Pack 1.2Start Tomcat.
> 2. Start a Web browser.
> 3. In the Web browser, point to the following URL:

> `http://localhost:8080/admin`

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

> 4. Log in to `admintool` using a user name and password combination that has been assigned the role of `admin`.

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

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

Download FAQ History |  | API Search Feedback

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.