Home TOC Index

Starting the Browser

To start the browser, go to the bin directory of your Java WSDP installation or place this directory in your path.

The following commands show how to start the browser on a UNIX system and a Microsoft Windows system, respectively:

jaxr-browser.sh
 
jaxr-browser
 

In order to access the Registry Server through the browser, you must make sure to start Tomcat and the Xindice database before you perform any queries or submissions to the browser; see Setting Up the Registry Server for details.

In order to access external registries, the browser needs to know your Web proxy settings. By default, the browser uses the settings you specified when you installed the Java WSDP. These are defined in the file <JWSDP_HOME>/conf/jwsdp.properties. If you want to override these settings, you can edit this file or specify proxy information on the browser command line.

To use the same proxy server for both HTTP and HTTPS access, specify a nondefault proxy host and proxy port as follows. The port is usually 8080. The following command shows how to start the browser on a UNIX system:

jaxr-browser.sh httpHost httpPort
 

For example, if your proxy host is named websys and it is in the south subdomain, you would enter

jaxr-browser.sh websys.south 8080
 

To use different proxy servers for HTTP and HTTPS access, specify the hosts and ports as follows. (If you do not know whether you need two different servers, specify just one. It is relatively uncommon to need two.) On a Microsoft Windows system, the syntax is as follows:

jaxr-browser httpHost httpPort httpsHost httpsPort
 

After the browser starts, enter the URL of the registry you want to use in the Registry Location combo box, or select a URL from the drop-down menu in the combo box. The menu allows you to choose among the IBM and Microsoft registries and the Registry Server.

There may be a delay of a few seconds while a busy cursor is visible.

When the busy cursor disappears, you have a connection to the URL. However, you do not establish a connection to the registry itself until you perform a query or update, so JAXR will not report an invalid URL until then.

The browser contains two main panes, Browse and Submissions.

Home TOC Index

This tutorial contains information on the 1.0 version of the Java Web Services Developer Pack.

All of the material in The Java Web Services Tutorial is copyright-protected and may not be published in other works without express written permission from Sun Microsystems.