vmware vrealize end point operations for oracle · pdf fileoracle database end point agent...

VMWARE VREALIZE END POINT OPERATIONS FOR

Oracle Database

User Guide

2 Blue Medora VMware vRealize End Point Operations for Oracle Database

1. Product Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32. Product Version Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33. Known Issues/Limitations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34. System Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35. Setting Oracle Database User Privileges . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36. Installing End Point Operations for Oracle Database . . . . . . . . . . . . . . . . . . . . . . . . 4

6.1 Prerequisites . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46.2 Installing the End Point Operations Management Agent . . . . . . . . . . . . 46.3 Uploading the Installation (.pak) file in vRealize Operations . . . . . . . . 46.4 What to do next . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5

7. Configuring Oracle Database Credentials . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67.1 Prerequisites . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67.2 Procedure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67.3 What to do next . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7

8. Oracle Database End Point Agent Overview Dashboard . . . . . . . . . . . . . . . . . . . . 89. Metrics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 810. Troubleshooting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9

TABLE OF CONTENTS

NOTE: This document supports the version of each product listed, as well as all subsequent versions, until a new edition replaces it.

You can find the most up-to-date technical documentation on the Blue Medora support site at: http://support.bluemedora.com.

The Blue Medora website also provides the latest product updates. If you have comments about this documentation, submit your feeDatabaseack to: [email protected].

http://support.bluemedora.com

mailto:support%40bluemedora.com?subject=


1. Product OverviewBlue Medora VMware vRealize End Point Operations for Oracle Database collects performance data from Oracle Database database resources and makes it available within VMware vRealize Operations (vROps).

2. Product Version Information

VERSION RELEASE DATE DESCRIPTION

6.3.1010007 March 16, 2017 Initial release by Blue Medora

3. Known Issues/LimitationsNone at this time.

4. System RequirementsBefore installing the End Point operations for Oracle Database, ensure your system meets the following requirements:

Table 1: System Requirements

Operating System (OS)

• Windows• Linux

vRealize Operations (vRops)

vRealize Operations v6.3+

Oracle Database

Oracle Database 11.2+

Oracle Database User Name/Password

NOTE: See section “5 Setting Oracle Database User Privileges” for details on creating a least-privileged Oracle database monitoring user.

5. Setting Oracle Database User Privileges

A user with the DBA role (sys by default) is required to grant SELECT privileges on the specified tables.

Switch to the sys user (which has the DBA role) to grant SELECT privileges on the specified tables:connect sys/<sys-role-password> as sysDatabasea;SET ECHO ON

Create the least-privileged user to be used by the Oracle Database End Point Operations agent:CREATE USER <least-privileged-user-name> IDENTIFIED BY <least-privileged-user-password>;

Grant CREATE SESSION permission:GRANT CREATE SESSION TO <least-privileged-user-name>;

Grant SELECT permissions:GRANT SELECT on GV_$TEMPSTAT to <least-privileged-user-name>;GRANT SELECT on GV_$FILESTAT to <least-privileged-user-name>;GRANT SELECT on GV_$PARAMETER to <least-privileged-user-name>;GRANT SELECT on DatabaseA_DATA_FILES to <least-privileged-user-name>;GRANT SELECT on DatabaseA_UNDO_EXTENTS to <least-privileged-user-name>;


6. Installing End Point Operations for Oracle Database

To successfully install End Point Operations for Oracle Database, you must first install the End Point Operations Management agent on your Oracle Database host machines, then upload the EP Ops for Oracle Database installation file in vRealize Operations.

6.1 PrerequisitesObtain the End Point Operations for Oracle Database installation (.pak) file from the VMware Solution Exchange.

6.2 Installing the End Point Operations Management AgentInstall the End Point Operations Management agent on your Oracle Database host machines. For instructions, refer to VMware’s online help for your specific version of vRealize Operations:

vROps version 6.3: End Point Operations Management Agent Installation and DeploymentvROps version 6.4: End Point Operations Management Agent Installation and DeploymentvROps version 6.5: End Point Operations Management Agent Installation and Deployment

NOTE: When you install the End Point Operations Management agents on a distributed system, ensure that you install the agent on every machine that you would like to monitor.

6.3 Uploading the Installation (.pak) file in vRealize Operations

1. Save the .pak file in a temporary location.

2. Log in to vRealize Operations as an admin user.

3. In the left pane, select Administration, then click Solutions.

4. In the right panel, the Solutions list will be displayed.

5. Click the Add icon ( ). In the dialog that appears, browse to the location of the saved .pak file, then click Upload.

https://pubs.vmware.com/vrealizeoperationsmanager-63/topic/com.vmware.vcom.core.doc/GUID-296A7845-7AF0-4A68-BFEA-FB0188483CE0.html

http://pubs.vmware.com/vrealizeoperationsmanager-64/topic/com.vmware.vcom.core.doc/GUID-296A7845-7AF0-4A68-BFEA-FB0188483CE0.html

http://pubs.vmware.com/vrealizeoperationsmanager-65/topic/com.vmware.vcom.core.doc/GUID-296A7845-7AF0-4A68-BFEA-FB0188483CE0.html


6. Read and accept the End User License Agreement (EULA) , then click Next. The upload might take several minutes to complete. Status information appears in the Installation Details text box throughout the installation process.

7. Click Finish when the installation process is complete.

6.4 Changes to Advanced Settings or Credentials while an EP Ops Agent is runningOnce the Oracle Database EP Ops agent is running, any changes to Advanced Settings (e.g., port, host) require the Override agent configuration data setting to be set to True.

Credential addition/changes do NOT require the Override agent configuration data setting to be set to True. However, credential changes do require the End Point Operations Management agent be restarted to take full effect.

Changing the credentials of a running EP Ops agent instance in vROps causes multiple instances of the agent to be running on the target host. Therefore, whenever a customer needs to change their credentials (except when setting them for the first time), the customer will need to access the target host, navigate to the End Point Operation Management agent’s install directory, and restart the agent.

To restart the Management agent, perform the following commands:

Linux (terminal):<agent-install-path>/bin/ep-agent.sh restart

Windows (command prompt):<agent-install-path>\bin\ep-agent.bat restart

6.5 What to do next

After End Point Operations for Oracle Database has been installed, configure your Oracle Database credentials. vRealize Operations Manager will discover and monitor the objects that belong to the plug-ins.


7. Configuring Oracle Database CredentialsAfter the End Point Operations for Oracle Database .pak file has been installed, you must configure the credentials of the Oracle Database instance in order to collect performance data.

7.1 PrerequisitesWait for vRealize Operations Manager to complete one collection cycle so that the installed agent can be discovered.

7.2 Procedure

1. In the left pane of vRealize Operations Manager, click Administration, then Inventory Explorer.

2. Click Adapter Types > EP Ops Adapter.

3. Select the Oracle Database database for which you want to collect metrics, then click the Edit Object (pencil) icon. The Edit Object dialog box opens.


4. Click on the Add New plus sign beside Credentials. The Manage Credential dialog box will appear.5. Enter the Credential details, then click OK.

• Oracle Database User Name• Oracle Database Password

7.3 What to do nextNow that the credentials for your Oracle Database instance have been configured, your End Point Operations for Oracle Database agent should start returning performance metrics for the database(s) on the configured host. Navigate to your Dashboard List and select the Oracle Database End Point Agent Overview dashboard.


8. Oracle Database End Point Agent Overview DashboardEnd Point Operations for Oracle Database includes the following out-of-the-box overview dashboard. Select a database from the Oracle Database Selector widget on the left to view its key performance metrics on the right.

NOTE: Additional Oracle Database-related resources, metrics, dashboards, query analysis, and alerts can be

found in the Oracle Database Management Pack for vROps. Click on the orange Learn More button for more information.

9. MetricsThe following metrics are collected by the End Point Operations solution for Oracle Database.

Table 2: Oracle Database Metrics

RESOURCE KIND RESOURCE GROUP RESOURCE ATTRIBUTE

Oracle Database UTILIZATION Average I/O Time

Oracle Database UTILIZATION Average Read Time

Oracle Database UTILIZATION Average Write Time

Oracle Database UTILIZATION Max Read Time

Oracle Database UTILIZATION Max Write Time

Oracle Database UTILIZATION Total Physical Reads

Oracle Database UTILIZATION Total Physical Writes

Oracle Database UTILIZATION Undo Tablespace Size

Oracle Database UTILIZATION Expired Undo Extents Size

Oracle Database UTILIZATION Unexpired Undo Extents Size


10. Troubleshooting

10.1 Viewing Errors in the Agent Log File

You can review EP Ops agent errors in the agent.log file, which can be viewed in the vROps user interface or in an external log viewer. The log file can be found at $VCOPS_BASE/user/log/agent.log.

You can find the most up-to-date technical documentation on the Blue Medora support site at: http://support.bluemedora.com.

The Blue Medora website also provides the latest product updates. If you have comments about this documentation, submit your feeDatabaseack to: [email protected].

Copyright © 2017 Blue Medora Inc. All rights reserved. U.S. and international copyright and intellectual property laws protect this product. Blue Medora is a registered trademark or trademark of Blue Medora in the United States and/or other jurisdictions.

The Oracle name (including Oracle Database) and logo are trademarks or registered trademarks of Oracle Corporationin the United States and/or other jurisdictions. All other marks and names mentioned herein may be trademarks of their respective companies.

Blue Medora3225 N Evergreen Dr. NE Suite 103Grand Rapids, MI 49525

bluemedora.com

http://support.bluemedora.com

mailto:support%40bluemedora.com?subject=

http://bluemedora.com

vmware vrealize end point operations for oracle · pdf fileoracle database end point agent...

Documents