This recipe deploys Monitor Express to BAM so that the Monitor Express dashboard can be used to monitor the status of BPEL processes. This is an interface that can be given to a non-technical user, providing them with a view onto the current state of the BPEL processes. Before Monitor Express can be used, it must be deployed to the BAM server, and this recipe explains how to perform that deployment.
Open a command prompt (shell) on the machine where SOA Suite is installed. Log on to Oracle BAM at http://hostname:port/OracleBAM and launch BAM Active Viewer.
- In the command shell, set the
ORACLE_HOMEenvironment variable to point to SOA Home.- For Linux:
$ ORACLE_HOME=/home/oracle/Middleware/OracleSOA1 $ export ORACLE_HOME
- For Windows:
C:> set ORACLE_HOME=C:OracleMiddlewareOracleSOA1
- For Linux:
- Set the
JAVA_HOMEenvironment variable to point to the JDK.- For Linux:
$ JAVA_HOME=/home/oracle/jdk1.6.0_31 $ export JAVA_HOME
- For Windows:
C:> set JAVA_HOME=C:Oraclejdk1.6.0_31
- For Linux:
- Edit the
$ORACLE_HOME/bam/config/BAMICommandConfig.xmlfile and set the following:ServerName: The name of the BAM server or localhost if the command is run on the same machine as the serverServerPort: The listening port of the BAM serverICommand_Default_User_Name: The administrative usernameICommand_Default_Password: The administrative user password
Sample settings are shown as follows:
<ServerName>soavbox</ServerName> <ServerPort>7001</ServerPort> <ICommand_Default_User_Name>weblogic</ICommand_Default_User_Name> <ICommand_Default_Password>welcome1</ICommand_Default_Password>
- Change the directory to
$ORACLE_HOME/bam/samples/bam/monitorexpress/binand run the setup command:- For Linux:
$ ./setup.sh - For Windows:
C:> setup.cmd
A sample output is shown as follows:
BAM Home =/home/oracle/Middleware/Oracle_SOA1/bam Using JAVA_HOME=/home/oracle/jdk1.6.0_31 Creating the Data Objects Oracle BAM Command Utility [Build 16734, BAM Repository Version 2025] Copyright © 2002, 2011, Oracle and/or its affiliates. All rights reserved. Importing from file "/home/oracle/app/Middleware/Oracle_SOA1/bam/samples/bam/monitorexpress/data_objects/MonitorExpress_DataObjects.xml". ... Reports successfully created Setup ends successfully
- For Linux:
- Verify the Monitor Express report from BAM Active Viewer by pressing the Select Report button to bring up Select a Report -- Webpage Dialog.
From the drop-down menu, choose Shared Reports and then double-click through the Samples and Monitor Express folders to reach the Monitor Express Dashboard report. Double-click on Monitor Express Dashboard to open the report and verify that it opens.
Monitor Express is shipped as a sample set of reports by Oracle. Before use it must be deployed, and the setup script uses BAM ICommand to deploy the Monitor Express BAM objects and Monitor Express reports. After the reports are deployed, it is necessary to instrument your BPEL processes to feed data to the Monitor Express BAM objects.
Now that Monitor Express is deployed in your BAM server, you can start instrumenting your BPEL processes to be displayed in Monitor Express Dashboard.
