Purpose

You can add additional services to a host with the aid of the addservice tool. Once the services are added, they can be managed using the Administration Tool just like the default services.
 

Location of the addservice tool:

server_root/bin/addservice	on Solaris
server_root\bin\addservice.exe	on Windows
where server_root is the directory of the installed Java Web Server.

The addservice tool is run from the command line -- the ability to create new services is not yet available through Administration Tool. In a future release, this ability will be fully integrated.

To Add Services to a Server:

1. Log in to your machine under the user name used to install Java^(TM) Web Server^(TM) (typically this is root, but need not be).
2. Make sure Java Web Server is running.
3. From the server_root/bin directory, or by specifying the full path name, invoke the tool by typing:

   addservice

   (server_root is the directory into which you installed Java Web Server.)
4. When prompted, type the username and password you use with Administration Tool.
5. From the list of servers found by the addservice utility, select the server to which you want to add a service. The prompt gives the default [javawebserver]. Press Return or Enter to accept the default, or type the name of another server.
6. From the list of services recognized by the addservice utility, select the service you want to add. The prompt gives the default [webpageservice]. Press Return or Enter to accept the default, or type the name of another service. The choices are webpageservice, secureservice, or adminservice.
7. When prompted, type a single word name for the service you are adding. For example, you may want to name an HTTP service internalHTTP.
8. When asked, type a description of the service you are adding. For instance, you may describe it as "HTTP service for internal users". This descriptive text will label the service in Administration Tool.
9. In the confirmation dialog box that appears, type yes to confirm that you really want to add the service. To cancel, type no.

Note:
The permissions set on the directories created by the addservice tool will be based on your login at the time the tool is run. If you run the tool with a login name such as root, be sure the new directories have appropriate permissions for the user who will subsequently run the server. (By default, the server sets uid to nobody when started as root). If the directories do not have the necessary permissions, modify them using the chmod command.

To Have the Administration Tool Recognize the New Service:

1. Log out out of Administration Tool if you are currently running it, then log back in.
2. Select the server to which you added the service.
3. Click Stop.
4. Click Restart.You can now manage the service through Administration Tool in the same manner as any of the default services.

Top java-server-feedback@java.sun.com

Copyright © 1999 Sun Microsystems, Inc. All Rights Reserved.