Example: Installing the JAX-WS Web Services samples with the console

The product provides a web services sample application that you can install on an application server.

Before you begin

Download and extract the JaxWSServicesSample sample application. For more information, see Accessing the samples.

About this task

The JaxWSServicesSamples.ear enterprise application and supporting Java™ archives (JAR) files are located in the installableApps directory within the JaxWSServicesSamples sample application.

This topic describes how to install and start the JaxWSServicesSamples.ear enterprise application using an administrative console.

1. Click Applications > New Application > New Enterprise Application in the console navigation tree.
2. On the first Preparing for the application installation page, specify to install JaxWSServicesSamples.ear.
   1. Click Local file system or Remote file system and specify the full path name of the JaxWSServicesSamples.ear file.

      .../installableApps/JaxWSServicesSamples.ear

   2. Click Next.
3. On the second Preparing for the application installation page, select the fast path option.
   1. Select Fast Path - Prompt only when additional information is required.
   2. Click Next.
4. Click Next on each page until you reach the Summary page.

   Do not go directly from Step 1 to the Summary page. You must click Next on each page that has mandatory settings to enter values for those settings. Simply click Next to enter the default values. You optionally can change the values to suit your environment.

5. On the Summary page, verify the cell, node, and server onto which the application modules will install, and then click Finish.
6. Examine the application installation progress messages.

   If the application installs successfully, the message Application JaxWSServicesSamples installed successfully is displayed. Click Save. After the configuration changes are saved, you can see the name of the application in the list of deployed applications on the Enterprise applications page accessed by clicking Applications > Application Types > WebSphere enterprise applications in the console navigation tree.

   If the application does not install successfully, read the messages to identify why the installation failed. Correct problems with the server or application and try installing the application again.

Results

The JaxWSServicesSamples application is in the list of deployed applications on the Enterprise applications page.

What to do next

After the application installs successfully, do the following:

1. Start the application.

   On the Enterprise applications page, select the check boxes for JaxWSServicesSamples, and then click Start.

2. Test the application. Point your web browser at:

   http://localhost:9080/wssamplesei/demo

   If the localhost address does not load, substitute the host name (IP address) of the computer for localhost; for example, http://9.22.33.44:9080/wssamplesei/demo. For a secure URL, use the https protocol and the 9443 default secure port number.

   If you have another WebSphere® Application Server installation on your machine, the server port number is likely not 9080 or 9443. See the Ports table in the administrative console to find the WC_defaulthost or WC_defaulthost_secure server port number. Click Servers > Server Types > WebSphere application servers > server1 > Ports. The Port descriptions table lists the important ports.

   Table 1. Port descriptions. Use the WC_defaulthost port in the URL to test the sample.

   Port name	Description
   WC_adminhost	Port used to open an unsecure administrative console in the URL http://host_name:administrative_port/ibm/console
   WC_adminhost_secure	Port used to open a secure administrative console in the URL https://host_name:administrative_port/ibm/console
   WC_defaulthost	Port used to test running applications in the URL http://host_name:server_port/servlet_name
   WC_defaulthost_secure	Port used to securely test running applications in the URL https://host_name:server_port/servlet_name