Installing and accessing the Samples Gallery

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

The Samples Gallery contains samples of simple artifacts such as those generated by IBM WebSphere Integration Developer and deployed on IBM IBM BPM. Other Business Process Management samples are available at http://publib.boulder.ibm.com/bpcsamp/index.html.

To install and view the WebSphere Process Server Samples Gallery...


Procedure

  1. Install IBM BPM and select the samples package on the feature selection panel, and create a profile as part of the product installation.

    If installing IBM BPM 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.

  2. Unload the contents of the WebSphere Process Server for z/OS installation media. The samples package is loaded onto the system when you unload the installation media. Run the installation script to create the symlinks to the files in the samples directory

    The samples are installed in the INSTALL_ROOT/samples/bin directory.

  3. Start the server.
  4. Start the Samples Gallery by selecting Samples Gallery on the First Steps console. WebSphere BPM samples are initially listed as installable samples in the Samples Gallery. You can expand Installable Samples and look for samples under Business Integration that you want to deploy and run.

    Applications that are run on IBM BPM have XML artifacts, such as business objects, relationship definitions, and business rules, which must be deployed before installing the application. IBM BPM 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 can be installed as an enterprise application in WebSphere BPM.

  5. If the IBM BPM installable samples were not installed automatically on the Samples Gallery, install and deploy them manually.

    • To install and deploy samples in a distributed IBM BPM deployment environment with clustering.

      1. In the administrative console, expand Applications and click Install New Application.

      2. Click Browse and locate the SamplesGallery.ear file in the following directory:

        • INSTALL_ROOT/samples/lib/SamplesGallery

        • INSTALL_ROOT\samples\lib\SamplesGallery

      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 SamplesGallery directory.

      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 deploy and run each sample, but use Install New Application on the administrative console instead of the installwbi command, which does not support clusters. You can locate the deployed EAR files in the following directory for each sample:

        • INSTALL_ROOT/samples/lib/ sample_name

        • INSTALL_ROOT\samples\lib\ sample_name

    • To install and deploy samples in a distributed IBM BPM deployment environment without clustering...

      1. On the workstation with the dmgr node:

        • INSTALL_ROOT/samples/bin/installwbi -node node_name -server server_name -samples SamplesGallery WBISamplesGallery

        • INSTALL_ROOT\samples\bin\installwbi -node node_name -server server_name -samples SamplesGallery WBISamplesGallery

        If administrative security is enabled on the IBM BPM profile, you must also type the -samplepw parameter and type the password created when creating the profile.

      2. In the administrative console, expand Applications, click Enterprise Applications, and 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 deploy and run each sample, making sure to use the -node node_name -server server_name parameters with the installwbi command.

  6. The Samples Gallery can be accessed directly from a web browser with the link http://xxxxxxxx:9080/WESBsamples/en/index.html, where xxxxxxxx represents a host name or IP address of the target z/OS system and 9080 is the port name assigned for the default host. The actions of deploying and installing each sample into the server is part of the samples themselves. WebSphere Process Server samples are initially listed as installable samples in the Samples Gallery.
  7. Start the Samples Gallery and click Refresh. You can deploy any of the installable samples by following the instructions that appear in the browser window. The samples that you previously deployed are listed as installed samples that you can run by selecting an option in the browser window.
  8. Run each of the z/OS deployed samples by following the instructions on the screen.


Related information:
Tutorial: Service component performance monitoring