Accessing the Samples (Samples Gallery)

Samples of integration application artifacts are available in the Samples Gallery, an option to install when you install this product.

Why and when to perform this task

The Samples Gallery contains samples of simple artifacts such as those that would be generated by IBM® WebSphere® Integration Developer and deployed on IBM WebSphere Process Server.

To install and view the WebSphere Process Server Samples Gallery, perform the following steps.

Steps for this task

  1. Install WebSphere Process Server. The samples package is selected for installation by default. (If you are installing WebSphere Process Server on top of WebSphere Application Server, the base WebSphere Application Server Samples Gallery must be installed in order for you to use the samples.)

    The samples are installed in the install_root/samples directory.

    Applications that are run on WebSphere Process Server have XML artifacts, such as business objects, relationship definitions, and business rules, which must be deployed before installing the application. WebSphere Process Server provides a utility named serviceDeploy to build and deploy these artifacts. The enterprise archive (EAR) file in install_root/samples/lib for each sample application contains these artifacts. The sampleDeploy utility invokes serviceDeploy with specific parameters required for the samples. Running sampleDeploy creates a second EAR file named sample_ nameDeployed.ear in the same directory as the original EAR file. This new EAR file contains the Web archive (WAR) files that were in the original EAR file plus the additional Java archive (JAR) and WAR files that contain the deployed artifacts. The deployed EAR file may be installed as an enterprise application in WebSphere Process Server.

    For more information, see Creating an installable EAR file using serviceDeploy.

  2. Start the server.
  3. Start the Samples Gallery by selecting Samples Gallery on the First Steps panel. WebSphere Process Server samples are initially listed as installable samples in the Samples Gallery.
  4. Click each sample that you want to install and follow the instructions that appear in the browser window for installation of each sample.
  5. Click Refresh in the Samples Gallery and the samples are listed as installed samples. For each installed sample, you can select the sample name to open a browser window with additional information and an option to run the sample.
  6. Icon indicating 6.0.1 content only If you are running the samples in a distributed WebSphere Process Server environment without clustering, complete the following steps.
    1. On the machine with the deployment manager node, run the command install_root/samples/bin/installwbi -node node_name -server server_name -samples SamplesGallery WBISamplesGallery.
    2. In the administrative console, under Enterprise Applications, start the SamplesGallery and WBISamplesGallery.
    3. Open a browser to access the Samples Gallery at http://host_name:host_port /WSsamples/index.jsp.
    4. Follow the instructions in the Samples Gallery to install and run each sample, making sure to use the -node node_name -server server_name parameters with the installwbi command.
  7. Icon indicating 6.0.1 content only If you are running the samples in a distributed WebSphere Application Server environment with clustering, complete the following steps.
    1. In the administrative console, click Applications > Install New Application.
    2. Click the browse button and locate the SamplesGallery.ear file in install_root/samples/lib/SamplesGallery directory.
    3. Install the EAR file, accepting all defaults, except for the target mapping panel, where you can designate a server or cluster on which to install the Samples Gallery.
    4. Repeat the previous steps for the WBISamplesGallery.ear file in the install_root/samples/lib/SamplesGallery.
    5. Start the applications that you just installed.
    6. Open a browser to access the Samples Gallery at http://host_name:host_port /WSsamples/index.jsp.
    7. Follow the instructions in the Samples Gallery to install and run each sample, but use Install New Application on the administrative console instead of the installwbi command, which does not support clusters. Locate the deployed EAR files in the install_root/samples/lib/sample_name directory for each sample.

Terms of use |

Last updated: Thu Apr 27 14:28:02 2006

(c) Copyright IBM Corporation 2006.
This information center is powered by Eclipse technology (http://www.eclipse.org)