7 Discovering and Monitoring SOA Suite 11g

New Features in This Release

The new features that have been introduced in the 11.1 version of the SOA Suite are:

• SOA Home Page: The SOA Home page provides a single view of all the SOA related artifacts being monitored by Enterprise Manager Grid Control. You can access this page by clicking on the SOA Home related link in the Middleware page.

• Instance Tracing: This feature allows to trace the message flow across SOA Composites and SOA Infrastructure instances monitored by Enterprise Manager Grid Control. The message flow can be traced across servers, clusters, and WebLogic domains.

• Historic Chart (Home Pages): The Home pages show real time and historic metric data. You can click on a specific metric value to view its historic trend.

Supported Versions

The following are the versions of the SOA Suite 11g that are supported in Enterprise Manager Grid Control 11g Release1:

• Oracle SOA Suite 11g PS1

• Oracle SOA Suite 11g PS2

Understanding the Discovery Process

The following describes the overall process involved in discovering and monitoring SOA Suite 11g in Enterprise Manager Grid Control. Follow the instructions outlined against each step in this process to successfully discover and monitor the SOA Suite.

Discovering SOA Suite 11g

This section describes the procedure for discovering the SOA Suite 11g. You can use a local or a remote Management Agent to perform the discovery process. In the case of discovery using a local agent, you need to use a Management Agent that is running on the same host as the Administration Server.

1. Login to Oracle Enterprise Manager Grid Control.

2. Click Targets and then Middleware.

   Oracle Enterprise Manager Grid Control displays the Middleware page that lists all the middleware targets being monitored.

3. In the Middleware page, from the Add list, select Oracle Fusion Middleware / WebLogic Domain and click Go. Specify the Administration Server Host, Port, User Name, Password, Agent (local or remote) and the JMX Protocol and click Continue.

4. You will return to the Middleware page. You will see the SOA instances under the WebLogic Domain.

   Note:

   New SOA Composites are not displayed by default. To display all the SOA Composites, navigate to the Home page of the WebLogic Server target and select the Refresh Domain option from the menu.

Post Discovery Steps

After discovering the SOA Suite 11g, you must perform the following additional configuration steps:

1. Set the instance state in the Common Properties page:

   1. Click Fusion Middleware Control on the SOA Infrastructure Home Page.

   2. Navigate to the Home page of the SOA Infrastructure target.

   3. Select Common Properties from the SOA-Infra drop-down menu.

   4. On the Common Properties page, select the Capture Composite Instance State check box.

2. Set the SOA database details like the host name, port, and credentials.

   1. Navigate to the Middleware page in Enterprise Manager Grid Control.

   2. Select a SOA Infrastructure home from the list and click Configure.

   3. The SOA Infrastructure Home page is displayed. Click Monitoring Configuration from the SOA-Infra drop-down menu.

   4. Set the SOA database details in the Monitoring Configuration page.

3. Set preferred credentials for the WebLogic Domain.

   1. Click the Preferences link in the top-right corner of the main page in Enterprise Manager Grid Control.

   2. In the Preferences page, click Preferred Credentials on the right pane.

   3. Select the Oracle WebLogic Domain target and click the Set Credentials icon.

   4. On the Oracle WebLogic Domain Preferred Credentials page, in the Target Credentials section, specify the administrator credentials and host credentials and click Apply.

   5. Similarly, on the Preferences page, select the Host target and click the Set Credentials icon.

   6. On the Host Preferred Credentials page, in the Target Credentials section, specify the normal credentials and privileged credentials. Then click Apply.

Creating Reports

This section describe the procedure to create SOA Reports.

1. To access the reports wizard, click the Reports tab on the Enterprise Manager Console Home page.

2. On the Report Definitions tab, select the SOA Composite target type and click Go.

   The out-of-box SOA reports are displayed under the SOA Performance Reports section.

3. Select a report from the section (for example, you can select Pending Instance Statistics) and click Create Like. The Create Report Definition page is displayed.

4. In the General page, enter the following details:

   1. Enter the BPEL Process Name as the title.

   2. Click the Set Time Period to set the time interval for the report.

   3. Click the Run report using target privileges of the Report Owner (SYSMAN) checkbox in the Privileges section.

5. Click the Elements tab and click the Set Parameters icon for the Pending Instance Statistics Element in the table.

6. In the Set Parameters page, click the torch icon to select a Composite Name. The Result Set Size with default values for the Pending Instance Statistics report is displayed.

7. Select a Component Name from the list, enter the Result Set Size and click Continue to return to the Elements page.

8. The selected target name is displayed in the Elements table.

9. To schedule periodic report generation, click the Schedule tab.

10. Specify the schedule type and other details and click OK.

11. You will return to the Report Home page where the newly scheduled report is displayed in the table. Click the report name to view the details.

Provisioning SOA Artifacts and Composites

The SOA Artifacts Deployment Procedure allows you to:

• Provision SOA Artifacts from a reference installation or from a gold image

• Create a gold image of the SOA Artifacts

• Provision SOA Composites either from the Software Library or from another accessible location.

For more details on the SOA Artifacts Deployment Procedure, see the Enterprise Manager Administrator's Guide for Software and Server Provisioning and Patching.

Troubleshooting

This section describes the errors you might encounter while discovering the SOA Suite 11g and the workaround steps you can follow to resolve each of them.

This section covers the following:

• Discovery

• Monitoring

• Instance Tracing

• Faults

• Application Dependency and Performance Integration

• Reports

• Systems and Services

• BPEL Recovery

New SOA Composite deployed on the SOA 
Server from JDeveloper are not 
displayed automatically in Enterprise 
Manager Grid Control.

All metrics are not displayed.

Instance Tracing Job Fails

All instances with faults are not populated in Enterprise Manager Grid Control. 

Missing ADP Data - Add the metrics - 
and add one for blank page.

Report generation fails due to invalid database details.

No targets found message for Oracle SOA Composite Reports.

Create Service option does not work.

Refresh Service option does not work.

Invalid Host and WebLogic Domain Credentials