Oracle® Enterprise Manager

Release Notes for System Monitoring Plug-In for Oracle Exadata Storage Server

Release 1.0.3.0.0, 1.1.4.0.0, 1.2.4.0.0

E13106-06

September 2010

Oracle Enterprise Manager System Monitoring Plug-Ins (System Monitoring Plug-Ins) enhance the solutions offered by Enterprise Manager Grid Control by infusing additional capabilities to monitor non-Oracle components, such as third-party databases, third-party middleware, storage, and network devices.

The System Monitoring Plug-In for Oracle Exadata Storage Server extends Oracle Enterprise Manager Grid Control (Grid Control) to add support for managing Oracle Exadata Storage Server

This document is the Release Notes for System Monitoring Plug-In for Oracle Exadata Storage Server.

Note:

You can access the latest version of this document at any time from Oracle Technology Network (OTN) available at the following URL.

http://www.oracle.com/technology/documentation/oem.html

On the main documentation page, from the table, click View Library. On the Enterprise Manager documentation library page, click the Documentation tab, and scroll down to see this document in the portlet System Monitoring Plug-ins.

You can find the following information in this document:

Installing a Plug-In
Known Issues
Documentation Accessibility

Installing a Plug-In

You can download the System Monitoring Plug-In archives from OTN by clicking Downloads, then Enterprise Manager. If you have a DVD, the plugin_archives directory contains the necessary plug-in archives to install each of the plug-ins.

To install a plug-in, do the following:

Copy or Save the desired plug-in archive to your desktop.
Launch the Grid Control console using a browser.
Follow the instructions outlined in the System Monitoring Plug-In Installation Guide.

Known Issues

This section describes the issues that exist for this release.

Universal Bugs and Limitations

The following generic Grid Control bugs and limitations impact the System Monitoring Plug-In for Oracle Exadata Storage Server.

Oracle Bug #4736085 — Error message is shown while undeploying the target

An inconsistent error state occurs if you undeploy System Monitoring Plug-Ins from multiple Agents if any Agent has preferred credentials set incorrectly.
- Cause — If you first attempt to undeploy plug-ins from multiple Agents, but some Agents do not have the preferred credentials set, an expected error message appears. However, if you then attempt to undeploy from Agents that have the correct credentials set, caching problems continue to show the same error message.
- Workaround — If you encounter this problem, log out and log back in. Navigate to the Undeploy Management Plug-ins page, and select only the Agents that have preferred credentials set.

Oracle Bug #5219848 — Successive deployments have problems if the first deployment failed
- Cause — Deployment of a plug-in fails on the first attempt on an Agent. Subsequent deployments, though reporting successfully, may not be fully successful. Configuration-related information on the View Configuration page and in reports will display an error.
- Workaround — Redeploying the plug-in resolves the problem. Clean up Enterprise Manager and remove all traces of the plug-in as follows:
1. Delete all existing plug-in targets.
2. Undeploy the plug-in.
3. Delete the plug-in.
4. Reimport the plug-in.
5. Freshly deploy the plug-in on an Agent that satisfies all prerequisites.

Oracle Bug #5179581 — Error: Target in broken state - metric collection errors encountered

Note:
This bug has been fixed for Oracle Management Agent version 10.2.0.3 and higher. You might encounter this issue only for Agent versions lower than 10.2.0.3.
- Cause — This behavior occurs when target, agent, or both and/or target system become slow or heavily loaded and computation of dynamic properties take longer than the default timeout value.
- Workaround — Execute the following command:
  
  emctl reload agent dynamicproperties <target name>:<target type>
  
  OR
  
  You can alternatively resubmit the target instance properties:
1. Click on the Monitoring Configuration link (under the Related Links section on the plug-in target home page).
2. Reenter the encrypted properties.
3. Click OK.

Context-sensitive Help — None of the System Monitoring Plug-ins have context-sensitive online help.
If you use Enterprise Manager Grid Control 10.2.0.3 or lower, then while adding a plug-in target, you may encounter a warning message on the Add Targets Page even after providing the credentials. On this page, you can provide the credentials and click Test Connection to test the connection to the server. However, after successful testing of the connection, when you click OK to add the target, you may see a warning message.
- Cause — This is because the page refreshes when OK is clicked, but the credentials are not cached and loaded on the page, though some encrypted values are displayed for those fields.
- Workaround — To resolve this issue, re-enter the credentials and then click OK.

Known Issues Specific to System Monitoring Plug-In for Oracle Exadata Storage Server

Oracle Bug #7037880, 7031995 - Error Displayed When You Click The Performance Data on Performance Reports

The performance reports available from the Reports tab provide performance data in the form of hyperlinks in a table. You can click these hyperlinks to drill down further and view more detailed information about the metric. However, if the Oracle Exadata Storage Server target name contains an underscore ("_") , then these hyperlinks displayed in the reports will break and display the following error:

Error: metricColumn - metricColumn page property expected.

To circumvent this issue, either try to avoid using underscores in the name or, if you must use it, then prefix the underscore with an asterisk (*) in the target name. For example, if you must name the target "storage_server", then rename it "storage*_server".

No Performance Data Displayed When Target Monitored in Enterprise Manager 10g Grid Control Release 3 (10.2.0.3)

If you use Enterprise Manager 10g Grid Control Release 3 (10.2.0.3) to monitor Oracle Exadata Storage Server, then the performance reports may not display any data.

To circumvent this issue, upgrade Enterprise Manager 10g Grid Control Release 3 (10.2.0.3) to Enterprise Manager 10g Grid Control Release 4 (10.2.0.4).

Documentation Accessibility

Our goal is to make Oracle products, services, and supporting documentation accessible to all users, including users that are disabled. To that end, our documentation includes features that make information available to users of assistive technology. This documentation is available in HTML format, and contains markup to facilitate access by the disabled community. Accessibility standards will continue to evolve over time, and Oracle is actively engaged with other market-leading technology vendors to address technical obstacles so that our documentation can be accessible to all of our customers. For more information, visit the Oracle Accessibility Program Web site at http://www.oracle.com/accessibility/.

Accessibility of Code Examples in Documentation

Screen readers may not always correctly read the code examples in this document. The conventions for writing code require that closing braces should appear on an otherwise empty line; however, some screen readers may not always read a line of text that consists solely of a bracket or brace.

Accessibility of Links to External Web Sites in Documentation

This documentation may contain links to Web sites of other companies or organizations that Oracle does not own or control. Oracle neither evaluates nor makes any representations regarding the accessibility of these Web sites.

Deaf/Hard of Hearing Access to Oracle Support Services

To reach Oracle Support Services, use a telecommunications relay service (TRS) to call Oracle Support at 1.800.223.1711. An Oracle Support Services engineer will handle technical issues and provide customer support according to the Oracle service request process. Information about TRS is available at http://www.fcc.gov/cgb/consumerfacts/trs.html, and a list of phone numbers is available at http://www.fcc.gov/cgb/dro/trsphonebk.html.

Release Notes for System Monitoring Plug-In for Oracle Exadata Storage Server Release 1.0.3.0.0, 1.1.4.0.0, 1.2.4.0.0

E13106-06

This software and related documentation are provided under a license agreement containing restrictions on use and disclosure and are protected by intellectual property laws. Except as expressly permitted in your license agreement or allowed by law, you may not use, copy, reproduce, translate, broadcast, modify, license, transmit, distribute, exhibit, perform, publish, or display any part, in any form, or by any means. Reverse engineering, disassembly, or decompilation of this software, unless required by law for interoperability, is prohibited.

The information contained herein is subject to change without notice and is not warranted to be error-free. If you find any errors, please report them to us in writing.

If this software or related documentation is delivered to the U.S. Government or anyone licensing it on behalf of the U.S. Government, the following notice is applicable:

U.S. GOVERNMENT RIGHTS Programs, software, databases, and related documentation and technical data delivered to U.S. Government customers are "commercial computer software" or "commercial technical data" pursuant to the applicable Federal Acquisition Regulation and agency-specific supplemental regulations. As such, the use, duplication, disclosure, modification, and adaptation shall be subject to the restrictions and license terms set forth in the applicable Government contract, and, to the extent applicable by the terms of the Government contract, the additional rights set forth in FAR 52.227-19, Commercial Computer Software License (December 2007). Oracle USA, Inc., 500 Oracle Parkway, Redwood City, CA 94065.

This software is developed for general use in a variety of information management applications. It is not developed or intended for use in any inherently dangerous applications, including applications which may create a risk of personal injury. If you use this software in dangerous applications, then you shall be responsible to take all appropriate fail-safe, backup, redundancy, and other measures to ensure the safe use of this software. Oracle Corporation and its affiliates disclaim any liability for any damages caused by use of this software in dangerous applications.

Oracle is a registered trademark of Oracle Corporation and/or its affiliates. Other names may be trademarks of their respective owners.

This software and documentation may provide access to or information on content, products, and services from third parties. Oracle Corporation and its affiliates are not responsible for and expressly disclaim all warranties of any kind with respect to third-party content, products, and services. Oracle Corporation and its affiliates will not be responsible for any loss, costs, or damages incurred due to your access to or use of third-party content, products, or services.