Build it yourself

To build, test, and run the Hello World sample, complete the following tasks:

  1. Import the Business Process Execution Language (BPEL) module.
  2. Modify the BPEL module to emit Common Base Events (CBEs).
  3. Generate the WebSphereŽ Business Monitor model.
  4. Add a new metric to the WebSphere Business Monitor model.
  5. Generate J2EE projects of the WebSphere Business Monitor model.
  6. Install the BPEL module and WebSphere Business Monitor model on a WebSphere Business Monitor development server.
  7. Create an instances dashboard for the WebSphere Business Monitor model.
  8. Test the WebSphere Business Monitor model.

In addition, you can complete the following optional tasks:

  1. Export the dashboard definition.
  2. Remove the dashboard definition.
  3. Export the BPEL module and WebSphere Business Monitor model .ear files.
  4. Uninstall the BPEL module and WebSphere Business Monitor model.
  5. Install the BPEL module and WebSphere Business Monitor model on a WebSphere Business Monitor production server.

Import the BPEL module

  1. From the Help menu, click Samples > Tutorials (WebSphere Integration Developer).

    2. Help menu

  2. On the Welcome page for the Hello World Part 1: Getting Started sample, click Import.

    3. Welcome panel

Modify the BPEL module to emit Common Base Events (CBEs)

  1. From the Business Integration view, right-click HelloWorldProcess and click Open.

    2. Open Hello World

  2. From the Properties view, click Event Monitor.

    3. Process properties

  3. Select All.

    4. All process properties

  4. From the HelloWorldProcess editor, click the InputMsg variable.

    5. InputMsg variable

  5. From the Properties view, select All.

    6. All variable properties

  6. From the File menu, click Save.

    7. File Save

Generate the WebSphere Business Monitor model

  1. From the Business Integration view, right-click HelloWorldModule and click Monitor Tools > Generate Monitor Model.

    2. Generate monitor model

  2. On the Generate Monitor Model dialog box:
    1. In the Target monitor project field, enter HelloWorldModel.
    2. In the Target monitor model name field, enter HelloWorldMM.
    3. Click Next.

      4. Generate monitor model, Next

  3. On the Warning dialog box, click Yes.

    4. Warning message

  4. On the New Business Monitoring Project dialog box, click Finish.

    5. Generate monitor model, Finish

  5. On the Generate Monitor Model dialog box:
    1. On the Event Source tab, select HelloWorldProcess.
    2. On the Monitoring Templates tab, click Select All.

      3. Generate monitor model

  6. Again on the Generate Monitor Model dialog box:
    1. On the Event Source tab, click InputMsg.
    2. On the Emitted Events tab, click Select All.
    3. Click Next.

      4. Choose what to monitor

  7. On the Generate Monitor Model dialog box, click Finish.

    8. Choose how to monitor

  8. On the Switch perspectives dialog box, click Yes.

    9. Switch perspectives prompt

Add a new metric to the WebSphere Business Monitor model

  1. From the HelloWorldMM editor, right-click HelloWorldProcess and click New > Metric.

    2. ?

  2. On the Create New Metric dialog box, in the Name field, enter HelloWorldProcess Name and then click OK.

    Create a new metric

  3. From the HelloWorldMM editor:
    1. Select the This metric can be used for sorting check box.
    2. On the Metric Value Expressions page, click Add.

      3. Metric details

  4. Again from the HelloWorldMM editor, on the Metric Value Expressions tab, select the Expression column and click the ... button.

    5. Metric value expressions

  5. On the Expression dialog box:
    1. In the text box, enter fn:substring(InputMsgCHANGED/InputMsg, 7) or use the expression builder (Ctrl + spacebar) to create the expression.
    2. Click OK.

      3. Expression panel

  6. From the File menu, click Save.

Generate the J2EE projects of the WebSphere Business Monitor model

  1. From the Project Explorer view, right-click the HelloWorldMM model and click Generate Monitor J2EE Projects.

    2. Generate monitor J2EE projects

  2. On the Generate Monitor J2EE Projects dialog box, click Finish.

    3. Generate monitor J2EE projects, Finish

Install the BPEL module and WebSphere Business Monitor model on a WebSphere Business Monitor development server

  1. From the Servers view, right-click WebSphere Business Monitor Server v6.1 on WebSphere Process Server and click Start.

    2. Start server

  2. Wait until the Status column on the Servers view indicates that WebSphere Business Monitor Server v6.1 on WebSphere Process Server has started.

    3. Server started

  3. Right-click WebSphere Business Monitor Server v6.1 on WebSphere Process Server and click Add and Remove Projects.

    4. Add and remove projects menu

  4. On the Add and Remove Projects dialog box:
    1. Select HelloWorldModuleApp and click Add.
    2. Select HelloWorldMMApplication and click Add.
    3. Click Finish.

    Add projects

  5. Wait until the Status column on the Servers view indicates that HelloWorldModuleApp and HelloWorldMMApplication have started.

    6. New application started

Create an instances dashboard for the WebSphere Business Monitor model

  1. From the Servers view, right-click WebSphere Business Monitor Server v6.1 on WebSphere Process Server and click WebSphere Business Monitor Dashboard.

    2. Dashboard menu

  2. From the WebSphere Business Monitor Dashboard editor:
    1. In the User ID field, enter your user ID (the default is admin).
    2. In the Password field, enter your password (the default is admin).
    3. Click Login.

      4. Dashboard login panel

  3. From the WebSphere Business Monitor Dashboard editor, click New.

    4. New dashboard

  4. On the New Dashboard dialog box, in the Name field, enter HelloWorld Instances and then click OK.

    5. New dashboard name

  5. From the WebSphere Business Monitor Dashboard editor, click Add to Dashboard.

    6. Add to dashboard

  6. On the Add to Dashboard dialog box, from the drop-down menu, select Instances and then click OK.

    7. Add item to dashboard

  7. From the WebSphere Business Monitor Dashboard editor, click Personalize.

    Personalize dashboard

  8. From the WebSphere Business Monitor Dashboard editor:
    1. Click Advanced.
    2. From the Model drop-down menu, select HelloWorldMM (All Versions).

      3. Advanced personalization

  9. From the WebSphere Business Monitor Dashboard editor:
    1. Click Show/Hide.
    2. In the Available table, select HelloWorldProcess Instance ID and click >.
    3. In the Available table, select HelloWorldProcess Start Time and click >.
    4. In the Available table, select HelloWorldProcess Name and click >.
    5. Click OK.

      6. Select columns for dashboard

  10. From the WebSphere Business Monitor Dashboard editor, confirm that the HelloWorld Instances dashboard has been created.

    11. Verify dashboard

Test the WebSphere Business Monitor model

  1. Click the Open Perspective icon and select Business Integration.

    2. Business integration view

  2. From the Business Integration view, right-click HelloWorldModule and click Test > Test Module.

    3. Test module menu

  3. From the HelloWorldModule_Test editor:
    1. In the Detailed Properties section, click the Value column of the Initial request parameters table
      2. .
    2. In the Value field, enter your name and then click the Continue icon.

      3. Test value

  4. On the Deployment Location dialog box, in the Deployment Location table, click WebSphere Business Monitor Server v6.1 on WebSphere Process Server and then click Finish.

    5. Select deployment location

  5. From the HelloWorldModule_Test editor, wait for Invoke returned to appear in the Events section:
    1. In the Events section, click Return (HelloWorldProcess:SendMsg).
    2. In the Detailed Propertiessection, in the Value column of the Returned Parameters table, confirm that text you entered appended to Hello.

      3. Test information

  6. Confirm that the text that you entered is in the HelloWorldProcess Name column.

    7. Dashboard test results

Export the dashboard definition

  1. From the WebSphere Business Monitor Dashboard editor:
    1. Select the Manage tab.
    2. Next to the HelloWorld Instances dashboard, select the check box in the Select column and then click Export.

      3. Select dashboard instance

  2. On the File Download dialog box, click Save.

    3. Save file download

  3. On the Save As dialog box, in the File name field, enter a name for this data file and then click Save.

    4. Dashboard Save As panel

  4. Close the Download complete dialog box.

    5. Download complete, Close

Remove the dashboard definition

From the WebSphere Business Monitor Dashboard editor, on the Manage panel, click the check box in the Select column next to the HelloWorld Instances dashboard and then click Delete.

Removing the dashboard

Export the BPEL module and WebSphere Business Monitor model .ear files

  1. Click the Open Perspective icon and select J2EE.

    2. Open J2EE perspective

  2. From the Project Explorer view, right-click HelloWorldModuleApp and click Export > EAR file.

    3. Export EAR file

  3. On the Export dialog box, in the Destination field, enter an .ear file path and name and then click Finish.

    4. EAR export, Finish

  4. From the Project Explorer view, right-click HelloWorldMMApplication and click Export > EAR file.

    5. Export model menu

  5. On the Export dialog box, in the Destination field, enter an .ear file path and name and then click Finish.

    6. Export EAR file, Finish

Uninstall the BPEL module and WebSphere Business Monitor model

  1. From the Servers view, right-click WebSphere Business Monitor Server v6.1 on WebSphere Process Server and click Add and Remove Projects.

    2. Add and Remove projects menu

  2. On the Add and Remove Projects dialog box:
    1. In the Configured Projects table, select HelloWorldModuleApp and click Remove.
    2. In the Configured Projects table, select HelloWorldMMApplication and click Remove.
    3. Click Finish.

      4. Remove projects

  3. Confirm that HelloWorldModuleApp and HelloWorldMMApplication are no longer installed on WebSphere Business Monitor Server v6.1 on WebSphere Process Server.

    4. Verify that projects were removed

  4. Right-click WebSphere Business Monitor Server v6.1 on WebSphere Process Server and click Stop.

    5. Stop the server

  5. Confirm that Stopped displays in the Status column for WebSphere Business Monitor Server v6.1 on WebSphere Process Server.

    6. Server stopped

Install the BPEL module and WebSphere Business Monitor model on a WebSphere Business Monitor production server

    For instructions on how to install the sample on a WebSphere Business Monitor production server, refer to the Run the sample section.