InfoCenter Home >
6: Administer applications >
6.6: Tools and resources quick reference >
6.6.0: About user assistance >
6.6.0.14: XML-SOAP Admin tool

6.6.0.14: XML-SOAP Admin tool

Use the SOAPEarEnabler tool to add administrative interfaces to your EAR files. You can then use the XML-SOAP Admin tool with these EAR files.

WebSphere Application Server provides a modified version of the Apache SOAP XML-Admin interface (or XML-SOAP Admin tool) for each SOAP-enabled EAR file. This interface allows you to do the following for each context root:

  • List configured services, showing active and stopped services
  • Stop a service
  • Start a service
  • View the Apache Soap deployment descriptor for a service

Accessing the XML-SOAP Admin tool

Access the XML-SOAP Admin tool through a Web browser by specifying:

 http://localhost/<contextroot>/admin/index.html
Note:  The context root, in this example, is the context specified when installing the SOAP-enabled .ear file. The context root for SOAP samples is soapsamples.
Therefore to use this interface with the SOAP samples, enter:
http://localhost/soapsamples/admin/index.html

You cannot use the XML-SOAP Admin tool to add or remove a service. Use the SOAP Ear Enabler tool to add or remove services. A "stopped" service is persisted across starts and stops of the application server. Therefore, if you stop a service, it will remain stopped until the next time you use the XML-SOAP Admin tool to start it again.

You can add the XML-SOAP Admin tool interface to an enterprise application when you SOAP-enable the EAR file. In interactive mode, you are asked whether you want to add the XML-SOAP Admin tool interface. Replying "yes" will add the necessary JSP files and bindings that allow you to access the XML-SOAP Admin tool interface for the application. The interface is an optional addition because you may not want to expose it in a production environment. Optionally, you may choose to use the application assembly tool to assign roles to the XML-SOAP Admin tool so that it is secure.

Updating an existing SOAP-enabled Enterprise Application

The Application Assembly tool is used to update the contents and configuration of an enterprise application. For example, to secure the XML-SOAP Admin tool interface for a particular EAR, use the application assembly tool to secure the resource. (See article Securing applications for security information.) However, you cannot use the application assembly tool to add or remove a Web service.

To add or remove a service to the XML-SOAP Admin tool, start with the original EAR file and execute the enabling process again.

Note:  The SOAP Ear Enabler tool saves a backup copy of the EAR file.

Go to previous article: Log Analyzer Preferences notebook -- Analyzer output Go to next article: Deployment Tool

 

 
Go to previous article: Log Analyzer Preferences notebook -- Analyzer output Go to next article: Deployment Tool