4-4 Oracle Fusion Middleware Integration Guide for Oracle Enterprise Repository
Part II
Part II
Oracle Enterprise Repository Integration with Runtime Monitoring Tools
This part describes how to use the Enterprise Manager Integration Utility to integrate Enterprise Manager with Oracle Enterprise Repository. The Enterprise Manager
Integration Utility is used from the command line.
This part contains the following chapters:
■
Chapter 5, Enterprise Manager Integration Utility
■
Chapter 6, Integration with Amberpoint
5
Enterprise Manager Integration Utility 5-1
5
Enterprise Manager Integration Utility
This chapter describes how to get started with the Enterprise Manager Integration Utility and use it to integrate Enterprise Manager with Oracle Enterprise Repository.
This chapter contains the following sections:
■
Section 5.1, Overview
■
Section 5.2, Using the Enterprise Manager Integration Utility
■
Section 5.3, Configuring the Enterprise Manager Integration Utility
■
Section 5.4, Encrypting the Configuration File Passwords
■
Section 5.5, Known Issues
5.1 Overview
Enterprise Manager EM is a comprehensive monitoring tool. It includes support for monitoring Oracles SOA Products, as well as J2EE Servers, Databases, JVMs, and
Operating Systems.
The EM Integration utility closes the loop between runtime and design-time by providing a summary of runtime performance metrics from EM into Oracle Enterprise
Repository. The EM Integration utility pulls metrics from EM and pushes to Oracle Enterprise Repository. The EM Integration tool currently supports and works with EM
Grid Control 10g R3 10.2.0.5 and EM Grid Control 11g.
EM Grid control EMGC is capable of monitoring multiple versions of a product or target simultaneously for one EMGC instance, be it EMGC 10g or EMGC 11g. For
example, Oracle Service Bus 10g and 11g can be simulataneously monitorerd by EMGC, and hence metrics for both these instances can be pulled back into a single
Oracle Enterprise Repository instance, which has projects harvested from Oracle Service Bus 10g or 11g. So Oracle Enterprise Repository-EM Integration also supports
gathering metrics for multiple product version targets into Oracle Enterprise Repository regardless of EM GC 10g or 11g.
This section contains the following topics:
■
Section 5.1.1, Prerequisites
■
Section 5.1.2, Obtaining the Enterprise Manager Integration Utility
■
Section 5.1.3, High Level Use Cases
5.1.1 Prerequisites
Before using the EM Integration utility, you must perform the following prerequisites:
5-2 Oracle Fusion Middleware Integration Guide for Oracle Enterprise Repository
■
The EM Integration utility requires the OER-Harvester datapack to be installed in Oracle Enterprise Repository.
■
The assets that receive metrics from EM must already be in Oracle Enterprise Repository. They should have been published to Oracle Enterprise Repository
from SOA SuiteBPEL-PM or Oracle Service Bus using the Oracle Enterprise Repository Harvester. The EM Integration utility requires the OER-Harvester
datapack to be installed in Oracle Enterprise Repository.
For more information about importing, see Oracle Fusion Middleware Configuration Guide for Oracle Enterprise Repository.
■
The EM Integration utility needs read access to the Enterprise Manager shared database views.
For more information about Enterprise Manager Database views, see http:download.oracle.comdocscdB16240_
01docem.102b40007views.htmBACCEIBI.
To create a read-only user in Enterprise Manager in cases where you do not have a SYSMAN repository owner privilege:
1.
Log in to Enterprise Manager Grid Control EMGC console as SYSMAN or any super administrator. The Oracle Enterprise Manager Fusion Middleware
Control page is displayed.
2. In the top-right corner, click Setup, and then select Administrators on the left
pane and click Create. 3.
Enter the username and password and accept the defaults for the other fields, and then click Next.
4.
Remove the Public role that is listed in the table on the right hand side.
5. Under Create Administrator: System Privileges, select VIEW ANY TARGET.
6.
Under Create Administrator: Targets, select all the targets that this new admin should be able to view.
7. Under Create Administrator: Target Privileges , select BATCH ASSIGN and
then click View.
8. Click Apply.
9.
Login to SQLPLUS with SYSMAN user to grant additional privileges to this new user, for example, oem_view.
Grant SELECT on MGMTMETRIC_DAILY to oem_view; Grant SELECT on MGMTMETRIC_CURRENT to oem_view;
Grant SELECT on MGMTTARGET_PROPERTIES to oem_view; Grant SELECT on MGMT_VERSIONS to oem_view;
Grant SELECT on MGMT_TARGET_PROPERTIES to oem_view; Grant SELECT on MGMT_TARGET_ASSOCS to oem_view;
Grant SELECT on MGMT_TARGETS to oem_view; Grant SELECT on MGMT_TARGET_ASSOC_DEFS to oem_view;
■
The EM Integration utility requires Java SDK version 6 or higher.
Note: In most cases, the View option might be selected and grayed
out.
Enterprise Manager Integration Utility 5-3
■
Install 10g or 11g EM Grid Control to enable EM Integration tool to harvest metrics into Oracle Enterprise Repository. The Oracle Enterprise Repository EM
Integration tool, currently, integrates with EM-Grid control and works with both 10g and 11g version of SOA.
■
When integrating with EM 11g, use the em-integration-settings.xml configuration file. However, when integrating with EM 10g, you have to use the
em-integration-settings-em10.xml configuration file.
5.1.2 Obtaining the Enterprise Manager Integration Utility
To obtain the Enterprise Manager Integration utility:
1.
Navigate to this Oracle_HOME\repositoryXXX\core\tools\solutions directory on your computer. A list of all the solution packs for Oracle Enterprise
Repository is displayed.
2. Unzip the 11.1.1.x.x-EM-Integration.zip file to a temporary directory.
3. Import the 11.1.1.x.x-OER-Harvester-Solution-Pack.zip file into Oracle Enterprise
Repository using the ImportExport Tool. For more information, see Oracle Fusion Middleware Users Guide for Oracle Enterprise Repository.
5.1.3 High Level Use Cases
You can use the EM Integration utility to:
■
Publish metrics from Oracle Service Bus Services in EM to existing Oracle Enterprise Repository assets.
■
Publish metrics from BPEL-PM Processes in EM to existing Oracle Enterprise Repository assets.
■
Publish metrics from Web Services in EM to existing Oracle Enterprise Repository assets.
■
Publish Endpoint and Deployment : BPEL assets in Oracle Enterprise Repository from deployment information in EM.
■
Support links back to the detailed metrics in EM, from the Oracle Enterprise Repository Web UI.
■
Support configurability and extensibility, so that new targets in EM can be mapped to Oracle Enterprise Repository assets.
■
Support capturing metrics for Oracle SOA Suite composite targets in EM 11g. EM Integration allows you to publish metrics for composites that are invoking a
service and are being monitored in EM 11g. However, unlike the other targets such as Oracle Service Bus, BPEL, WebLogic, if the service endpoint does not exist in
Oracle Enterprise Repository, it will not be created during the integration process. If the assets do exist, they will be updated with the metrics.
5.2 Using the Enterprise Manager Integration Utility
This section describes how to use the Enterprise Manager Integration Utility. This section contains the following topics:
■
Section 5.2.1, Running from Command Line
■
Section 5.2.2, Scheduling from Enterprise Manager
