Oracle® Enterprise Manager Cloud Control Getting Started with Oracle Fusion Middleware Management 12c Release 1 (12.1.0.1) Part Number E24215-01 |
|
|
PDF · Mobi · ePub |
This chapter describes how you can discover and configure the components of the SOA Suite 11g using Enterprise Manager Cloud Control.
In particular, this document covers the following:
The new features that have been introduced in the 12c version of the SOA Suite are:
Dehydration Store: You can view the performance of the database relevant to the SOA engine. You can review the general health of the database engine and identify problems that are causing a performance bottleneck.
Service Topology: You can see a graphical end to end view of the composite applications. It depicts the various application components and their interactions happening at runtime.
SOA Partition: You can deploy SOA composite applications into separate sections of the SOA Infrastructure known as partitions.
Instance Tracing Enhancements: Instance tracing can now be performed at the component level and you can view the audit trail for individual component instances.
UDDI Publishing: Publishing a service to UDDI is now supported.
The following are the versions of the SOA Suite 11g that are supported in Enterprise Manager Cloud Control 12c:
11.1.1.2.0 (PS1)
11.1.1.3.0 (PS2)
11.1.1.4.0 (PS3)
11.1.1.5.0 (PS4)
The following describes the overall process involved in discovering and monitoring SOA Suite 11g in Enterprise Manager Cloud Control. Follow the instructions outlined against each step in this process to successfully discover and monitor the SOA Suite.
Table 8-1 Understanding the Discovery Process
Oracle SOA Suite Version | Application Server Deployed To | Discovery Mechanism | Process |
---|---|---|---|
Oracle SOA Suite 11.1 PS2 |
Oracle WebLogic Managed Server |
Manual Discovery |
|
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.
Login to Oracle Enterprise Manager Cloud Control.
Click Targets and then Middleware.
Oracle Enterprise Manager Cloud Control displays the Middleware page that lists all the middleware targets being monitored.
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.
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.You can discover the SOA Suite 11g using a remote agent which may be running on a host that is different from the host on which the Administration Server is running. In this case, you may not be able to perform certain operations like instance tracing and viewing recoverable instances.
To ensure the all the metric data is collected, add the soa-infra-mgmt.jar
and the oracle-soa-client-api.jar
files to the $AGENT_HOME/plugins/oracle.sysman.emas.agent.plugin_12.1.0.0.0/archives/jlib/
(the Agent Home directory). If the extjlib
directory does not exist, it can be created. This step is required only if you are using a remote agent to monitor the SOA Suite.
Note:
For SOA PS3 and higher, thejrf-api.jar
file must also be present in the Agent Home directory.After discovering the SOA Suite 11g, you must perform the following additional configuration steps:
Set the instance state in the Common Properties page:
Click Fusion Middleware Control on the SOA Infrastructure Home Page.
Navigate to the Home page of the SOA Infrastructure target.
Select Common Properties from the SOA-Infra drop-down menu.
On the Common Properties page, select the Capture Composite Instance State check box.
Set the SOA database details like the host name, port, and credentials.
Navigate to the Middleware page in Enterprise Manager Cloud Control.
Select a SOA Infrastructure home from the list and click Configure.
The SOA Infrastructure Home page is displayed. Click Monitoring Configuration from the SOA-Infra drop-down menu.
Set the SOA database details in the Monitoring Configuration page.
Set preferred credentials for the WebLogic Domain.
Click the Setup > Security > Preferred Credentials.
Select the Oracle WebLogic Domain target and click the Managed Preferred Credentials.
Select WebLogic Administrator Credentials in the Target Preferred Credentials and click Set.
Enter the user name and password in the Select Named Credentials window and click Save.
To enable Instance Tracing for any SOA Infrastructure instances involved in executing composite instances:
Follow the sequence listed under Step 3 of the Section 8.5, "Post Discovery Steps" section.
To view the state of the listed instances, enable the Capture Composite State flag by following the sequence listed Step 1 of the Section 8.5, "Post Discovery Steps" section.
If the SOA instance is being monitored by the ADP Manager, additional metrics such as Arrival Rate, Minimum, Maximum, and Average Response Time will be collected.
Tip:
The ADP Manager must be registered before it can collect the metric data. For details on registering the ADP Manager, see Oracle Enterprise Manager Cloud Control Advanced Installation and Configuration Guide.To configure and trace a SOA Composite instance, follow these steps:
Login to Enterprise Manager and navigate to the SOA Composite Home page of the instance to be traced.
Select the Trace Instance option from the SOA Composite menu.
Find the instance you want to trace by specifying search criteria such as Instance ID, Instance Creation Time Window, Instance Count, Sensor Values and so on. Click Search.
Note:
You must set the Preferred Credentials must be set for the WebLogic Domain and the Monitoring Agent Host to retrieve search data.WebLogic Domain: To set the Administrator Credentials for the WebLogic Domain (SOA Domain Target), click Setup > Security > Preferred Credentials. Select Oracle WebLogic Domain as the Target Type and click Manage Preferred Credentials. Specify the WebLogic Administrator credentials and click OK.
Monitoring Agent Host: To set the Preferred Credentials for the host on which the Management Agent has been installed, click Setup > Security > Preferred Credentials. Select Host as the Target Type and click Manage Preferred Credentials. Specify the Normal Host Credentials for the host and click OK.
The list of instances that match the search criteria is displayed. Select the instance you want to trace and click Trace.
In the Select SOA Infrastructure window, select one or more SOA Infrastructure targets for which the trace information is to be gathered. Specify the WebLogic Administration and Host Credentials for these targets and click OK.
A trace job is submitted to collect the instance trace data from the selected targets and the flow trace for the instance is generated.
When the job has been completed, click the Job Status to view the flow trace data. Click the Log Viewer link to access the log messages related to the instance.
Click the Component Instance to drill down to the component instance audit trail which shows the activity level execution details.
This section describe the procedure to create SOA Reports.
To access the reports wizard, click the Reports tab on the Enterprise Manager Console Home page.
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.
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.
In the General page, enter the following details:
Enter the BPEL Process Name as the title.
Click the Set Time Period to set the time interval for the report.
Click the Run report using target privileges of the Report Owner (SYSMAN) checkbox in the Privileges section.
Click the Elements tab and click the Set Parameters icon for the Pending Instance Statistics Element in the table.
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.
Select a Component Name from the list, enter the Result Set Size and click Continue to return to the Elements page.
The selected target name is displayed in the Elements table.
To schedule periodic report generation, click the Schedule tab.
Specify the schedule type and other details and click OK.
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.
The dehydration store monitoring feature allows you to see the performance of the database instance relevant to the SOA Infrastructure. Using this data, the SOA administrator can identify problems that are causing the performance bottleneck.
Before you can view the dehydration diagnostics data, ensure that:
The database has been configured and is available as a target in Enterprise Manager.
The SOA Repository properties have been specified in the Monitoring Configuration page.
To view the dehydration diagnostics data, follow these steps:
Log into Enterprise Manager Cloud Control.
Click a SOA Infrastructure target on the Middleware page.
In the SOA Infrastructure Home page, click the Dehydration Store tab.
The following details area displayed:
Throughput indicators that provide details of the general health of the database instance.
Wait bottleneck issues related to the CPU, I/O, and Wait events.
Tablespace utilization for the SOA schema.
Performance data recorded by the ASH.
Key SOA tables and tablespace details related to the SOA schema.
The Service Topology provides a graphical end to end view of the composite applications. It depicts the various application components and their interactions happening at runtime. It allows you to view the service level dependencies among the components and provides key performance statistics and incidents information for them.Composite applications are distributed in nature and this view helps you quickly visualize the structure, status, availability, dependencies, configuration changes, and performance of business-critical distributed applications from one place and easily identify any availability or performance issues.
The Service Topology Viewer shows the following:
Service to Service Calls: It allows you to view the Service to Service calls between any two SOA entities (Composites/J2EE Applications/OSB/BPEL 10g instances) by clicking the link between the entities.
Dependency Highlighting: It allows you to view the dependencies for any service. If you click on a service, all the services that it is dependent on and vice versa are highlighted.
Database Associations: Shows all the databases used by the SOA Composites, BPEL 10g instance and J2EE applications.
External Services: Shows the services that are used by a SOA Composite application but are external to it or not managed by Enterprise Manager Cloud Control.
For more details, refer to the Enterprise Manager Online Help.
To publish a service to UDDI, navigate to the Services and References Home page, select a service from the table and click Publish to UDDI from the menu. The Publish Service to UDDI window is displayed with the following fields:
Service Name: The name of Web Service to be published to the UDDI Registry. This is a Read Only field.
Service Description: The description of the selected Web Service.
Service Definition Location: The URL location of the Service Definition. This is a Read Only field.
UDDI Source: A logical name for an external UDDI registry source. Select the UDDI Source from the drop down list.
Business Name: The name of the data structure in the UDDI registry. Select a Business Name that has been registered with the UDDI from the list.
Click OK to start the process that publishes the web service to UDDI or click Cancel to cancel publishing the service.
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.
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:
The following error occurs when the SOA instances are being discovered.
Table 8-2 Error Message:
Error Message | Workaround Steps |
---|---|
New SOA Composite deployed on the SOA Server from JDeveloper are not displayed automatically in Enterprise Manager Cloud Control. |
To discover the newly deployed SOA Composites in Enterprise Manager Cloud Control, you must run the Refresh Farm menu option for the associated Weblogic Domain. |
The following error occurs when the collection frequency causes a delay in the collection of configuration data.
The following error occurs when the instance is traced.
Instance Search Fails - Same reason as BPEL first column. If Management Agent is down or unreachable.
Table 8-4 Error Message:
Error Message | Workaround Steps |
---|---|
Instance Tracing Job Fails |
|
The following errors occur when:
All instances with faults are not displayed as only the last 10 values are collected.
The most recently collected fault instances do not appear in the Faults and Messages page.
Table 8-5 Error:
Error Description | Workaround Steps |
---|---|
All instances with faults are not populated in Enterprise Manager Cloud Control. |
By default, you can only view the latest 10 faults collected during the last 15 minutes. To view additional faults, navigate to Fusion Middleware by clicking the link in the General section on the target Homepage. |
When you click on the Application Dependency and Performance link in the SOA Instance Home page, you may see a blank page. This error may occur if:
Application Dependency and Performance is not being used to monitor the SOA instance.
Application Dependency and Performance has not been registered in Enterprise Manager Cloud Control.
This section lists report related errors.
Table 8-7 Error Message:
Error Description | Workaround Steps |
---|---|
Report generation fails due to invalid database details. |
|
No targets found message for Oracle SOA Composite Reports. |
You cannot use the out-of-box reports directly. You must use the Create Like option to generate custom reports based on the SOA Composite Target type. |
|
Set valid credentials for the host target on which the SOA Infrastructure instance is running. |
The following error occur when you try to refresh a service that has not been created.
Table 8-8 Error Message:
Error Message | Workaround Steps |
---|---|
Create Service option does not work. |
System and service creation depends on the configuration collection of the SOA Infrastructure and related targets. Check the log file for details. |
Refresh Service option does not work. |
The Refresh Service function works for an existing Infrastructure service. In case the service does not exist, it should be created using the Create Service menu option. |
The following error occurs when invalid credentials are provided.
The following error occurs if the SOA Management Pack EE has not been enabled.
Table 8-10 Error Message
Error Message | Workaround Steps |
---|---|
The page requested is part of the SOA Management Pack EE. |
The SOA Management Pack EE must be enabled for the specific SOA Infrastructure target. To enable the license, follow these steps:
|