The JavaTM Web Services Tutorial
Home
TOC
PREV TOP NEXT

Using admintool

New to this release of the Java Web Services Developer Pack is the Tomcat Server Administration tool, admintool. admintool is a Web application that 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 the Tomcat server as described in Starting Tomcat.
  2. Start a Web browser.
  3. In the Web browser, point to the following URL:
       http://localhost:8080/admin
     
    
    This command invokes the admin Web application. Before you can use this application you must add your user name/password combination and associate the role name admin with it. The initial user name and password necessary to access this tool are set up during Java WSDP installation. If you've forgotten the user name and password, you can view <JWSDP_HOME>/conf/tomcat-users.xml with any text editor. This file contains an element <user> for each individual user, which might look something like this:
       <user name="adeveloper" password="secret" 	
          roles="admin, manager" />
     
    
  4. Log in to admintool using a user name and password combination that has been assigned the role of admin.
  5. When you have finished, log out of admintool by selecting the appropriate link in the upper pane.

Adding Roles Using admintool

To set up new roles for container-managed security, follow these instructions. Additions, deletions, and changes made in admintool are written to the tomcat-users.xml file.

  1. Scroll down the left pane of admintool to the Administration node.
  2. Select Role Administration.
  3. From the Available Actions List, select Create New Role.
  4. Enter a Role Name and Description, for example Customer.
  5. Select Save.

Adding Users Using admintool

To set up new users for container-managed security, follow these instructions. Additions, deletions, and changes made in admintool are written to the tomcat-users.xml file.

  1. Scroll down the left pane of admintool to the Administration node.
  2. Select User Administration.
  3. From the Available Actions List, select Create New User.
  4. Enter a User Name, Password, and select a Role for the new user.
  5. Select Save.
Home
TOC
PREV TOP NEXT