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.
ORACLE_HOME
environment variable to point to SOA Home.$ ORACLE_HOME=/home/oracle/Middleware/OracleSOA1 $ export ORACLE_HOME
C:> set ORACLE_HOME=C:OracleMiddlewareOracleSOA1
JAVA_HOME
environment variable to point to the JDK.$ JAVA_HOME=/home/oracle/jdk1.6.0_31 $ export JAVA_HOME
C:> set JAVA_HOME=C:Oraclejdk1.6.0_31
$ORACLE_HOME/bam/config/BAMICommandConfig.xml
file 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 passwordSample 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>
$ORACLE_HOME/bam/samples/bam/monitorexpress/bin
and run the setup command:$ ./setup.sh
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
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.