Oracle Enterprise Manager Adapter Installation and Configuration ...

Oracle Enterprise Manager Adapter Installation and Configuration Guide vCenter Operations Manager 1.0

This document supports the version of each product listed and supports all subsequent versions until the document is replaced by a new edition. To check for more recent editions of this document, see http://www.vmware.com/support/pubs.

EN-000798-05

Oracle Enterprise Manager Adapter Installation and Configuration Guide

You can find the most up-to-date technical documentation on the VMware Web site at: http://www.vmware.com/support/ The VMware Web site also provides the latest product updates. If you have comments about this documentation, submit your feedback to: [email protected]

Copyright © 2013 VMware, Inc. All rights reserved. This product is protected by U.S. and international copyright and intellectual property laws. VMware products are covered by one or more patents listed at http://www.vmware.com/go/patents. VMware is a registered trademark or trademark of VMware, Inc. in the United States and other jurisdictions. All other marks and names mentioned herein may be trademarks of their respective companies.

VMware, Inc. 3401 Hillview Ave. Palo Alto, CA 94304 www.vmware.com

2

VMware, Inc.

Contents

Oracle Enterprise Manager Adapter Installation and Configuration Guide

5

Updated Information 7

1 Introduction to the Oracle Enterprise Manager Adapter 9 How the Adapter Retrieves Data 9 Data that the Adapter Retrieves 10 Installation and Configuration Requirements

11

2 Installing the Oracle Enterprise Manager Adapter 13 Install the Adapter in a Standalone Installation Install the Adapter in a vApp Installation 14 Adapter Folders and Files 14

13

3 Configuring the Oracle Enterprise Manager Adapter 17 Add a Credential 17 Add an Adapter Instance 18 Validate the Adapter Data 19 Configuring Database Connection Properties Configuring Adapter Properties 20

19

4 Troubleshooting the Oracle Enterprise Manager Adapter 21 Troubleshooting an Oracle Enterprise Manager Adapter Instance Viewing System Log Files 21 Adapter Does Not Report the Correct Resource State 22 Adapter Does Not Create Resource Relationships 22

Index

VMware, Inc.

21

25

3

Oracle Enterprise Manager Adapter Installation and Configuration Guide

4

VMware, Inc.

Oracle Enterprise Manager Adapter Installation and Configuration Guide

The Oracle Enterprise Manager Adapter Installation and Configuration Guide provides information about installing and configuring the Oracle Enterprise Manager adapter.

Intended Audience This information is intended for anyone who needs to install or configure the Oracle Enterprise Manager adapter.

VMware, Inc.

5

Oracle Enterprise Manager Adapter Installation and Configuration Guide

6

VMware, Inc.

Updated Information

The Oracle Enterprise Manager Adapter Installation and Configuration Guide is updated with each release of the product or when necessary. This table provides the update history of the Oracle Enterprise Manager Adapter Installation and Configuration Guide. Revision

Description

EN-000798-05

n n n

Added the Relationships query to “Database Queries,” on page 9. Added information about supported resource relationships to “Data that the Adapter Retrieves,” on page 10. Added “Adapter Does Not Create Resource Relationships,” on page 22.

EN-000798-04

Updated the library files listed in “Adapter Folders and Files,” on page 14.

EN-000798-03

Added the Timezone field to “Add an Adapter Instance,” on page 18.

EN-000798-02

n

Changed the product name to reflect the new licensing model for the 5.6 release.

n

Added the open_source_license.txt file to “Adapter Folders and Files,” on page 14.

n

Corrected the connection and credential requirements in “Installation and Configuration Requirements,” on page 11. Updated the installation steps in “Install the Adapter in a Standalone Installation,” on page 13 and “Install the Adapter in a vApp Installation,” on page 14.

EN-000798-01

n

EN-000798-00

The Oracle Enterprise Manager Adapter Technical Note is now the Oracle Enterprise Manager Adapter Installation and Configuration Guide. The Oracle Enterprise Manager Adapter Technical Note was the initial release of this document.

VMware, Inc.

7

Oracle Enterprise Manager Adapter Installation and Configuration Guide

8

VMware, Inc.

Introduction to the Oracle Enterprise Manager Adapter

1

The Oracle Enterprise Manager adapter is an embedded adapter for vCenter Operations Manager. The adapter collects data from Oracle Enterprise Manager database management tables. This chapter includes the following topics: n

“How the Adapter Retrieves Data,” on page 9

n

“Data that the Adapter Retrieves,” on page 10

n

“Installation and Configuration Requirements,” on page 11

How the Adapter Retrieves Data On initial startup, the Oracle Enterprise Manager adapter uses the MGMT$METRIC_DETAILS view to collect data. The adapter runs from the current time minus 25 hours, in one-hour segments, to preload the adapter. In real-time collection mode, the adapter uses the MGMT$METRIC_CURRENT view to collect the last data point, which eliminates the need to use date-driven queries. The adapter stores the last successful collection time per resource in the lastcollect.properties file. If the collector or adapter is unavailable for an extended period of time, the adapter uses the MGMT $METRIC_DETAILS view to collect data and cover the gap from the last collection time to the current time. The adapter runs one query per time zone on each collection cycle in both historical and real-time collection mode. NOTE Previously, the adapter converted the time values for all rows in the database before requesting a specified window in UTC time. The query could fail if the adapter converted an invalid data and time pair in the database. This problem is resolved in the current release because the adapter no longer performs UTC conversion.

Database Queries The Oracle Enterprise Manager adapter runs the Discovery, Realtime Collect, Historical Collect, Availability Check, Timezone Check, and Relationships queries to obtain data from the Oracle Enterprise Manager database.

Discovery Query SELECT TARGET_NAME, DISPLAY_NAME AS RESOURCENAME,TARGET_TYPE AS KINDKEY FROM MGMT$TARGET WHERE TARGET_TYPE in ([INCLUDED_TARGET_TYPES])

VMware, Inc.

9

Oracle Enterprise Manager Adapter Installation and Configuration Guide

Realtime Collect Query SELECT T.DISPLAY_NAME AS RESOURCENAME, T.TARGET_TYPE, M.TARGET_NAME, M.METRIC_NAME, M.METRIC_COLUMN, M.METRIC_LABEL, M.COLUMN_LABEL, M.KEY_VALUE, M.METRIC_TYPE, M.VALUE, M.COLLECTION_TIMESTAMP FROM MGMT$METRIC_CURRENT M LEFT JOIN MGMT$TARGET T ON M.TARGET_NAME=T.TARGET_NAME WHERE T.TARGET_TYPE in ([INCLUDED_TARGET_TYPES]) AND T.TIMEZONE_REGION=[TIMEZONE_REGION] [(OPTIONAL BASED ON MAXFILTERSIZE) AND M.TARGET_NAME IN ([INCLUDED_TARGET_NAMES])] AND M.COLLECTION_TIMESTAMP >= [LAST_DATA_TIME]

Historical Collect Query SELECT T.DISPLAY_NAME AS RESOURCENAME, T.TARGET_TYPE, M.TARGET_NAME, M.METRIC_NAME, M.METRIC_COLUMN, M.METRIC_LABEL, M.COLUMN_LABEL, M.KEY_VALUE, M.METRIC_TYPE, M.VALUE, M.COLLECTION_TIMESTAMP FROM MGMT$METRIC_DETAILS M LEFT JOIN MGMT$TARGET T ON M.TARGET_NAME=T.TARGET_NAME WHERE T.TARGET_TYPE in ([INCLUDED_TARGET_TYPES]) AND T.TIMEZONE_REGION=[TIMEZONE_REGION] [(OPTIONAL BASED ON MAXFILTERSIZE) AND M.TARGET_NAME IN ([INCLUDED_TARGET_NAMES])] AND M.COLLECTION_TIMESTAMP >= [INTERVAL_START_TIME] AND M.COLLECTION_TIMESTAMP < [INTERVAL_END_TIME]

Availability Check Query SELECT TARGET_NAME, TARGET_TYPE, AVAILABILITY_STATUS FROM MGMT$AVAILABILITY_CURRENT WHERE TARGET_TYPE in ([INCLUDED_TARGET_TYPES])

Timezone Check Query SELECT DISTINCT( TIMEZONE_REGION ) from MGMT$TARGET WHERE TARGET_TYPE IN ([INCLUDED_TARGET_TYPES]) [(OPTIONAL BASED ON MAXFILTERSIZE)] AND TARGET_NAME IN ([INCLUDED_TARGET_NAMES))

Relationships Query SELECT DISPLAY_NAME, TARGET_NAME, TARGET_TYPE, HOST_NAME FROM MGMT$TARGET WHERE TARGET_TYPE in ([INCLUDED_TARGET_TYPES]) ORDER BY (case TARGET_TYPE when 'host' then 0 else 1 end)

Data that the Adapter Retrieves The Oracle Enterprise Manager adapter retrieves resources and resource relationships from the Oracle Enterprise Manager database. The adapter does not collect change events. You list the kinds of resources that the adapter retrieves in the allowedResourceKinds property in the oem.properties file. For example: allowedResourceKinds = oracle_database, host

The values that you list in the allowedResourceKinds property must correspond to values in the TARGET_TYPE column in the database MGMT$TARGET view. The Oracle Enterprise Manager adapter supports relationships between host targets and other targets that reside in those hosts. For example, Oracle database targets are children of host targets. The Oracle Enterprise Manager adapter creates metrics in vCenter Operations Manager when it retrieves resources.

10

VMware, Inc.

Chapter 1 Introduction to the Oracle Enterprise Manager Adapter

Oracle Enterprise Manager Adapter Resource Identification The Oracle Enterprise Manager adapter uses certain resource identifiers. You must specify resource identifiers when you reference Oracle Enterprise Manager adapter resources with the vCenter Operations Manager API. The Oracle Enterprise Manager adapter predefines the adapter instance resource. It defines other types of resources during discovery.

Adapter Kind The type of adapter for the Oracle Enterprise Manager adapter is OEM adapter and the identifier key is OEM_ADAPTER.

Adapter Instance Resource Kind The adapter instance resource for an Oracle Enterprise Manager adapter instance is OEM Adapter Instance and the identifier key is OEMAdapter Instance. An OEM Adapter Instance resource has the following identifier keys. Table 1‑1. Adapter Instance Resource Identifier Keys Key

Part of Uniqueness

Default Name (en)

Description

URL

Yes

JDBC URL

Identifies the JDBC URL that points to the Oracle Enterprise Manager database.

SUPPORT_AUTODISCOVERY

Yes

Support Autodiscovery (yes/no)

Indicates whether auto discovery is enabled or disabled for the adapter instance.

Oracle Enterprise Manager Target Resource Kinds During discovery, the adapter creates types of resources that represent Oracle Enterprise Manager targets. The value from the TARGET_TYPE column becomes both the resource name and the resource identifier key. An Oracle Enterprise Manager target type resource has the following identifier key. Table 1‑2. Target Type Resource Identifier Key Key

Part of Uniqueness

Default Name (en)

Description

TARGET_NAME

Yes

Target Name

Target name from the TARGET_NAME column of a Collect or Discovery query result.

Installation and Configuration Requirements Before you install the Oracle Enterprise Manager adapter, verify that your system meets certain requirements.

Oracle Enterprise Manager Compatibility The Oracle Enterprise Manager adapter is compatible with Oracle Enterprise Manager 10, 11, and 12c.

VMware, Inc.

11

Oracle Enterprise Manager Adapter Installation and Configuration Guide

Connection Requirements The Oracle Enterprise Manager adapter requires a JDBC connection to the Oracle Enterprise Manager database. The adapter connection has certain requirements. n

You must open an Oracle JDBC port on the firewall. The default port number is 1521.

n

You must use a valid Oracle JDBC connection URL, for example, jdbc:oracle:thin:@host:port:SID.

Credential Requirements The user account that the adapter uses to connect to the Oracle Enterprise Manager database must have read access to the following SYSMAN database views: n

MGMT$AVAILABILITY_CURRENT

n

MGMT$METRIC_CURRENT

n

MGMT$METRIC_DETAILS

n

MGMT$TARGET

The user account must have rights to the run the Discovery, Realtime Collect, Historical Collect, Availability Check, and Timezone Check queries. The user account must also have ALTER SESSION system privileges to enable execution of database queries.

12

VMware, Inc.

Installing the Oracle Enterprise Manager Adapter

2

How you install the Oracle Enterprise Manager adapter depends on whether you have a vCenter Operations Manager Standalone or vApp installation. This chapter includes the following topics: n

“Install the Adapter in a Standalone Installation,” on page 13

n

“Install the Adapter in a vApp Installation,” on page 14

n

“Adapter Folders and Files,” on page 14

Install the Adapter in a Standalone Installation If you have a standalone installation, you install the Oracle Enterprise Manager adapter by extracting the adapter installation file from a TGZ file and running an installation utility. Prerequisites n

Download the adapter installation TGZ file anonymously from ftp://ftp.integrien.com/.

n

Make a note of the build number in the TGZ file name. The build number appears after the adapter name, for example, adaptername-buildnumber.tgz.

n

Read the release notes that are included with the TGZ file.

Procedure 1

Open the TGZ file and extract the TAR file to a temporary folder on your vCenter Operations Manager server.

2

In the temporary folder, open the TAR file and extract and run the installer for your operating system platform.

3

Log in to the Custom user interface as an administrator.

4

Select Admin > Support.

5

On the Info tab, find the Adapters Info pane and click the Describe icon ( ). The Describe icon is located at the top right of the Adapters Info pane.

6

Click Yes to start the describe process and click OK. The Custom user interface finds the adapter files, gathers information about the abilities of the adapter, and updates the user interface with information about the adapter. If you have remote collectors, it installs the adapter on the remote collectors. The describe process might take several minutes. When the describe process is finished, the adapter appears in the Adapters Info pane. The build number is in the Adapter Version column.

VMware, Inc.

13

Oracle Enterprise Manager Adapter Installation and Configuration Guide

7

Verify that the build number in the Adapter Version column for the adapter matches the build number in the TGZ file that you downloaded.

Install the Adapter in a vApp Installation If you have a vApp installation, you install the Oracle Enterprise Manager adapter from a PAK file Prerequisites n

Download the adapter installation PAK file anonymously from ftp://ftp.integrien.com.

n

Make a note of the build number in the PAK file name. The build number appears after the adapter name, for example, adaptername-buildnumber.pak.

n

Read the release notes that are included with the PAK file.

Procedure 1

Save the PAK file in a temporary folder.

2

Log in to the Admin user interface as the admin user. For example: https://ipaddress/admin/

3

On the Update tab, click Browse to locate the temporary folder and select the PAK file.

4

Click Update and click OK to confirm the update. The Admin user interface uploads the PAK file. The upload might take several minutes.

5

Read and accept the EULA and click OK.

6

Click OK to confirm and start the update process. The update might take several minutes. Status information appears on the Update tab when the update is finished.

7

Log in to the Custom user interface as an administrator. For example: https://ipaddress/vcops-custom/

8

Select Admin > Support.

9

On the Info tab, find the Adapters Info pane and click the Describe icon ( ). The Describe icon is located at the top right of the Adapters Info pane.

10

Click Yes to start the describe process and click OK. The Custom user interface finds the adapter files, gathers information about the abilities of the adapter, and updates the user interface with information about the adapter. The describe process might take several minutes. When the describe process is finished, the adapter appears in the Adapters Info pane. The build number is in the Adapter Version column.

11

Verify that the build number in the Adapter Version column for the adapter matches the build number in the PAK file that you uploaded.

Adapter Folders and Files The installer places the Oracle Enterprise Manager adapter files in the oem_adapter3 folder. The oem_adapter3 folder contains several subfolders and files.

14

VMware, Inc.

Chapter 2 Installing the Oracle Enterprise Manager Adapter

Table 2‑1. Oracle Enterprise Manager Adapter Folders and Files Folder

Files

Description

conf

db.properties

Contains database connection properties.

oem.properties

Contains adapter configuration properties.

describe.xml

Describes the adapter.

version.txt

Contains the adapter version.

history.txt

Contains the history of adapter changes.

open_source_license.txt

Open source license file.

OSS library files:

JAR files that contain the classes and resources used to implement the adapter.

lib

commons-dbcp-1.2.1.jar n commons-pool-1.2.jar Non-OSS library files:

n

n

work

VMware, Inc.

ojdbc14.jar

lastcollect.properties

Contains the last collection time, in milliseconds, per resource.

15

Oracle Enterprise Manager Adapter Installation and Configuration Guide

16

VMware, Inc.

Configuring the Oracle Enterprise Manager Adapter

3

To configure the Oracle Enterprise Manager adapter, you add a credential and an adapter instance in vCenter Operations Manager. You can optionally change database connection and adapter configuration properties. This chapter includes the following topics: n

“Add a Credential,” on page 17

n

“Add an Adapter Instance,” on page 18

n

“Validate the Adapter Data,” on page 19

n

“Configuring Database Connection Properties,” on page 19

n

“Configuring Adapter Properties,” on page 20

Add a Credential An Oracle Enterprise Manager adapter instance uses a user name and password to connect to the Oracle Enterprise Manager database. You use this user name and password to create a credential for the adapter instance in vCenter Operations Manager. You can add the credential before you create the adapter instance and select the correct credential when you define the adapter instance, or you can add the credential when you define the adapter instance. Prerequisites n

Install the Oracle Enterprise Manager adapter. See Chapter 2, “Installing the Oracle Enterprise Manager Adapter,” on page 13.

n

Verify that the user account meets credential requirements. See “Credential Requirements,” on page 12.

Procedure 1

Log in to the Custom user interface as an administrator.

2

Select Environment > Configuration > Credentials.

3

Select OEM adapter from the Adapter Kind drop-down menu.

4

Select a credential from the Credential kind drop-down menu.

5

At the top of the list of credentials, next to Action, click Add.

6

Type a unique name for the credential instance in the Instance name text box.

7

Type the user name and password combination in the User name and Password text boxes.

8

Click OK to add the credential for the adapter.

VMware, Inc.

17

Oracle Enterprise Manager Adapter Installation and Configuration Guide

The credential appears in the list in the Manage Credentials window.

Add an Adapter Instance You must create an adapter instance for the Oracle Enterprise Manager adapter. The adapter instance defines the adapter type and describes how to connect to the Oracle Enterprise Manager database. Prerequisites n

Install the Oracle Enterprise Manager adapter. See Chapter 2, “Installing the Oracle Enterprise Manager Adapter,” on page 13.

n

Create a credential, or, if you plan to create a credential when you add the adapter, become familiar with creating credentials. See “Add a Credential,” on page 17.

Procedure 1

Log in to the Custom user interface as an administrator.

2

Select Environment > Configuration > Adapter Instances.

3

Select the collector to use from the Collector drop-down menu. Unless you added additional collectors, the only available collector is vCenter Operations Standard Server. You can change the name of this collector when you install the standalone version.

4

Select OEM adapter from the Adapter Kind drop-down menu.

5

Click the Add New Adapter Instance icon.

6

Type a name for the adapter in the Adapter Instance Name text box.

7

Type the URL that the adapter instance uses to connect to the Oracle Enterprise Manager database in the JDBC URL text box. For example: jdbc:oracle:thin:@host:port:SID

8

(Optional) If the database for your OEM installation does not have time zone region information, select the time zone region in the Timezone drop-down menu. For example, US/Pacific. Certain OEM versions, including 10.1 and some 10.2 versions, do not have time zone region information. If you have one of these OEM versions, and you do not provide the time zone region in the Timezone drop-down menu, the OEM adapter instance cannot gather information from your OEM installation. To determine whether your OEM installation has time zone region information, run a select TIMEZONE_REGION from MGMT$TARGET query against the database. If you receive a message that states TIMEZONE_REGION is an invalid column identifier or column name, you must provide time zone region information in the Timezonedrop-down menu.

9

Select true or false in the Support Autodiscovery (true/false) drop-down menu to enable or disable auto-discovery. For example, US/Pacific. If you enable auto-discovery, the data collection process discovers new resources and creates the resources for you. If you disable auto-discovery, you must use manual discovery to create resources.

18

10

Select the credential to use to sign on to the data source from the Credential drop-down menu, or click Add to add a new credential.

11

Click OK to save your configuration.

VMware, Inc.

Chapter 3 Configuring the Oracle Enterprise Manager Adapter

Validate the Adapter Data After you add an adapter instance for the Oracle Enterprise Manager adapter, verify that resources are created and that metrics are collected through the adapter instance in vCenter Operations Manager. Prerequisites n

Add an adapter instance for the Oracle Enterprise Manager adapter. See “Add an Adapter Instance,” on page 18.

n

If you disabled auto-discovery when you created the adapter instance, discover the resources manually. For information about using manual discovery, see the online help.

Procedure 1

Log in to the Custom user interface as an administrator.

2

Select Environment > Environment Overview and examine the resources on the Environment Overview page.

3

Verify the details for each resource. a

Select the resource on the List tab and click the Show Detail icon. The Resource Detail page appears for the resource.

b

Examine the metric graph and compare the values to the source values. You can view the source data in the Oracle Enterprise Manager console.

Configuring Database Connection Properties You can change Database Connection Pool (DBCP) parameters by modifying properties in the

db.properties file.

Table 3‑1. db.properties File Properties Property

Description

Default Value

defaultAutoCommit

Default auto-commit state of connections that the pool creates.

true

maxActive

Maximum number of active connections that can be allocated from the pool at the same time. Set to a negative number for no limit.

1

initialSize

Initial number of connections that are created when the pool starts.

1

minIdle

Minimum number of connections that can remain idle in the pool, without extra connections being created, or zero to create no connections.

1

maxIdle

Maximum number of connections that can remain idle in the pool, without extra connections being released. Set to a negative number for no limit.

1

poolPreparedStatements

Boolean value that specifies whether to enable prepared statement pooling for the pool.

false

VMware, Inc.

19

Oracle Enterprise Manager Adapter Installation and Configuration Guide

Table 3‑1. db.properties File Properties (Continued) Property

Description

Default Value

maxWait

When no connections are available, the maximum number of milliseconds that the pool waits for a connection to be returned before throwing an exception, or -1 to wait indefinitely.

3000

maxOpenPreparedStatements

Maximum number of open statements that can be allocated from the statement pool at the same time. Set to zero for no limit.

0

Configuring Adapter Properties You can tune adapter operation by modifying properties in the oem.properties file. In a vApp installation, you modify the oem.properties file on the Analytics virtual machine. Table 3‑2. oem.properties File Properties

20

Property

Description

Default Value

maxSendChunkInterval

Maximum interval, in milliseconds, to buffer data before sending it to vCenter Operations Manager in historical collection mode.

3600000 milliseconds

deltaMonitoringInterval

Specifies whether to fill the gap with historical data if the gap size is greater than monitoringInterval + deltaMonitoringInterval.

120000 milliseconds

allowedResourceKinds

Comma-delimited list of allowed types of resources . the values that you list must correspond to values in the TARGET_TYPE column in the database MGMT$TARGET view.

oracle_database,host

resourceUpStatuses

Comma-delimited list of AVAILABILITY_STATUS column values that indicate a resource is available. This property determines resource availability.

Target_Up

schema

Schema that contains Oracle Enterprise Manager objects.

SYSMAN

historicLoadEnabled

Specifies whether to enable historic load.

false

stringValuesEnabled

Specifies whether to send string metrics.

true

maxQueryWindow

Maximum trailing time from the current time to query, in minutes.

15 minutes

minQueryWindow

Minimum trailing time from the current time to query, in minutes.

1 minute

historicFetchSize

Number of records to process at a time during historical metric collection. A higher value increases memory use during collection but improves data processing performance.

500

mainFetchSize

Number of records to process at a time during current metric collection. A higher value increases memory use during collection but improves data processing performance.

500

maxFilterSize

Maximum number of resources to use as a filter in query statements. If the number of monitored resources is less than this value, resource names are included in the query statement and query and processing performance is improved. If the number of resources exceeds this value, resource names are not included in the filter. This value is ignored if auto-discovery is enabled.

100

VMware, Inc.

Troubleshooting the Oracle Enterprise Manager Adapter

4

Known troubleshooting information can help you diagnose and correct common problems with the Oracle Enterprise Manager adapter. This chapter includes the following topics: n

“Troubleshooting an Oracle Enterprise Manager Adapter Instance,” on page 21

n

“Viewing System Log Files,” on page 21

n

“Adapter Does Not Report the Correct Resource State,” on page 22

n

“Adapter Does Not Create Resource Relationships,” on page 22

Troubleshooting an Oracle Enterprise Manager Adapter Instance Perform these general troubleshooting steps to diagnose and correct problems with an Oracle Enterprise Manager adapter instance. n

Verify that the Oracle Enterprise Manager database is running.

n

View the collection status and collection state of the adapter instance resource on the Environment Overview page in the Custom user interface.

n

Check the adapter and collector logs for errors. See “Viewing System Log Files,” on page 21.

n

If the state of a resource is Down but the adapter is receiving data for the resource, see “Adapter Does Not Report the Correct Resource State,” on page 22.

Viewing System Log Files You can view Oracle Enterprise Manager adapter errors in the adapter and collector log files. You can view log files in the Custom user interface or in an external log file viewer. The logging level is set to ERROR by default. To troubleshoot issues, set the logging level to INFO. To view detailed messages, including micro steps, queries, and returned results, set the logging level to DEBUG. You can set the log level for each class in the log4j.properties file in the vcenter-ops/log/conf/collector folder, for example: log4j.logger.com.integrien.adapter3.oem.OEMAdapter=DEBUG

NOTE If you set the logging level to DEBUG, log files can become large very quickly. Set the logging level to DEBUG only for short periods of time. For information about viewing log files and modifying logging levels, see the online help.

VMware, Inc.

21

Oracle Enterprise Manager Adapter Installation and Configuration Guide

Oracle Enterprise Manager Adapter Classes The Oracle Enterprise Manager adapter uses certain adapter classes. Table 4‑1. Adapter Classes Class Name

Notes

com.integrien.adapter3.oem.OEMAdapter

Logs main logic.

com.integrien.adapter3.oem.OEMConstants com.integrien.adapter3.oem.OEMProperties

Logs property loading errors.

com.integrien.adapter3.oem.db.DBUtil

Logs SQL and discovery processing errors.

com.integrien.adapter3.oem.db.DBConnectionManager

Logs connection errors.

Adapter Does Not Report the Correct Resource State The resource state is set to Down, but the Oracle Enterprise Manager adapter is collecting data for the resource. Problem The adapter is setting the resource state to Down when the resource is still available. Cause The adapter uses the following query for availability checking: SELECT M.TARGET_NAME, M.TARGET_TYPE, M.AVAILABILITY_STATUS FROM MGMT$AVAILABILITY_CURRENT M WHERE M.TARGET_TYPE in ()

The adapter compares the value from the M.AVAILABILITY_STATUS column to the values specified in the resourceUpStatuses property in the oem.properties file. If the value is not specified in the resourceUpStatuses property, the adapter sets the resource state to Down. The default available state is Target Up. Solution 1 2

Run the query for availability checking externally and examine the value of the M.AVAILABILITY_STATUS column to find the AVAILABILITY_STATUS value for the resource. If you do not want the adapter to alert on the status value, add the status value to the

resourceUpStatuses property in the oem.properties file.

The resourceUpStatuses property is a comma-delimited list of status values. Do not include spaces before and after the status values.

Adapter Does Not Create Resource Relationships After you upgrade the Oracle Enterprise Manager adapter, the adapter instance fails to create resource relationships. Problem The Oracle Enterprise Manager adapter instance does not create resource relationships after an adapter upgrade. Cause The Oracle Enterprise Manager adapter creates relationships for only newly discovered resources.

22

VMware, Inc.

Chapter 4 Troubleshooting the Oracle Enterprise Manager Adapter

Solution To recreate relationships for existing resources, perform manual discovery for the adapter instance and deselect the Only New Resources check box. When you deselect the Only New Resources check box, the adapter instance includes previously added resources in the discovery results. This procedure enables you to recover deleted relationships. For complete information about performing manual discovery, see the VMware vCenter Operations Manager Administration Guide (Custom User Interface).

VMware, Inc.

23

Oracle Enterprise Manager Adapter Installation and Configuration Guide

24

VMware, Inc.

Index

A adapter adding instances 18 classes 22 configuring 17 installing 13 operation overview 9 audience information 5 auto discovery 18 AVAILABILITY_STATUS value 22 Availablility Check query 9

C

resourceUpStatus property 22

S system requirements 11

T Timezone Check query 9 troubleshooting general 21 incorrect resource state 22 resources 21

U

credentials, adding 17

updated information 7

D

V

db.properties file 19 Discovery query 9

validating adapter data 19 vApp installation 14

H Historical Collect query 9

I installation folders 14 installing the adapter 13

J JDBC URL, configuring 18

L lastcollect.properties file 9 log files 21

M M.AVAILABILITY_STATUS column 22 MGMT$METRIC_CURRENT table 9 MGMT$METRIC_DETAILS table 9

O oem.properties file 20, 22

R Realtime Collect query 9 resource identification 11 resource relationship problems 22 resources 10

VMware, Inc.

25

Oracle Enterprise Manager Adapter Installation and Configuration Guide

26

VMware, Inc.