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.
- Start Tomcat as follows:
- 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
.- Log in to
admintool
using a user name and password combination that has been assigned the role ofadmin
, 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.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 ofadmin
intomcat-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:
![]()
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 ofserver.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 toserver.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 athttp://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.
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.