Public feed
#724712
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"><html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en"><head><!-- Run date = February 1, 2007 14:17:45 --><title>Oracle® Enterprise Manager Grid Control Release Notes for Linux and Microsoft Windows</title><meta http-equiv="Content-Type" content="text/html; charset=us-ascii" /><meta http-equiv="Content-Style-Type" content="text/css" /><meta http-equiv="Content-Script-Type" content="text/javascript" /><meta name="generator" content="Oracle DARB XHTML Converter - Version 4.5.3 Build 02" /><meta name="date" content="2005-07-10T12:57:20+08:00" /><meta name="robots" content="all" scheme="http://www.robotstxt.org/" /><meta name="doctitle" content="Oracle® Enterprise Manager Grid Control Release Notes for Linux and Microsoft Windows" /><meta name="relnum" content="10g Release 3 (10.2.0.3.0)" /><meta name="partnum" content="B40096-03" /><link rel="copyright" href="../../dcommon/html/cpyr.htm" title="Copyright" type="text/html" /><!--+++++++++++++++++++++++++++++++++++++++++++++++++++++++++--><!-- Styles begin here --><!--+++++++++++++++++++++++++++++++++++++++++++++++++++++++++--><style>body, p, table, td, th, ol, ul, a, dl, dt, dd, blockquote, caption { font-family: Arial, Helvetica, sans-serif; line-height: 1.25; color: black; background-color: white; /* Fahrner Method. See Zeldman. Working with Web Standards. pp. 323-5. */ font-size: x-small; voice-family: "\"}\""; voice-family: inherit; font-size: small;}html > body { font-size: small;}a { text-decoration: underline;}a:link { color: #630; background-color: white;}a:visited { color: #963; background-color: white;}a:hover { color: #f60; background-color: white;}a:active { color: #f60; background-color: white;}a.glossary-link { border-bottom: 1px dotted; text-decoration: none;}h1, h2, h3, h4 { font-family: Arial, Helvetica, sans-serif; color: #369; background-color: white;}h1 { font-size: 1.6em; font-weight: bold; border: solid #cc9; border-width: 0px 0px 1px 0px; width: 100%;}h2 { font-size: 1.3em; font-weight: bold;}h3 { font-size: 1.1em; font-weight: bold;}h4 { font-size: 1em; font-weight: bold;}pre, code { font-family: "Courier New", Courier, monospace; font-size: 1em;}code { color: #369; background-color: white;}code *.code-comment { color: black; background-color: white;}a:link code { color: #630; background-color: white;}a:visited code { color: #963; background-color: white;}a:hover code { color: #f60; background-color: white;}a:active code { color: #f60; background-color: white;}caption { text-align: center; font-weight: bold; width: auto;}dt { font-weight: bold;}td { vertical-align: top;}th { font-weight: bold; text-align: left; vertical-align: bottom; color: #369; background-color: white;}table.table-border { border: 1px solid #cc9;}table.table-border td,table.table-border th { padding: 2px 4px 2px 4px; color: black; background-color: white; border: 1px solid #cc9;}table.table-border th.table-header-border-left,table.table-border th.table-header-border-middle,table.table-border th.table-header-border-right { color: #369; background-color: #cc9;}table.table-border th.table-header-border-left { border-left: 1px solid #cc9; border-right: 1px solid white; color: black; background-color: #cc9;}table.table-border th.table-header-border-middle { border-left: 1px solid white; border-right: 1px solid white; color: black; background-color: #cc9;}table.table-border th.table-header-border-right { border-left: 1px solid white; border-right: 1px solid #cc9; color: black; background-color: #cc9;}span.gui-object, span.gui-object-action { font-weight: bold;}span.gui-object-title { }p.horizontal-rule { width: 100%; border: solid #cc9; border-width: 0px 0px 1px 0px; margin-bottom: 4ex;}div.zz-skip-header { margin-bottom: 0px; margin-top: -2px; padding: 0px; text-align: center; line-height: 1px;}div.zz-skip-header a:link,div.zz-skip-header a:visited,div.zz-skip-header a:hover,div.zz-skip-header a:active { color: white; background-color: white; text-decoration: none; font-size: 0.2ex; line-height: 1px;}td.zz-nav-header-cell { text-align: left; font-size: 0.95em; width: 99%; color: black; background-color: white; font-weight: normal; vertical-align: top; margin-top: 0ex; padding-top: 0ex;}a.zz-nav-header-link { font-size: 0.95em;}td.zz-nav-button-cell { white-space: nowrap; text-align: center; width: 1%; vertical-align: top; padding-left: 4px; padding-right: 4px; margin-top: 0ex; padding-top: 0ex;}a.zz-nav-button-link { font-size: 0.9em;}div.zz-nav-footer-menu { width: 100%; text-align: center; margin-top: 2ex; margin-bottom: 4ex;}p.zz-legal-notice, a.zz-legal-notice-link { font-size: 0.85em; /* display: none; */ /* Uncomment to hide legal notice */}/*************************************//* Begin DARB Formats *//*************************************/h5, h6 { font-family: Arial, Helvetica, sans-serif; color: #369; background-color: white; font-size: 0.95em; font-weight: bold;}h6 { font-weight: normal;}td li p { display: inline;}/* lose the h1 underscore *//*h1 { border-width : 0px 0px 0px 0px;}*//* Increase contrast between visited and unvisited links. *//*a:visited { color: #a30; background-color: white;}*/.bold, .codeinlinebold, .syntaxinlinebold, .term, .glossterm,.glossaryterm, .keyword, .msg, .msgexplankw, .msgactionkw, .notep1 { font-weight: bold;}.italic, .codeinlineitalic, .syntaxinlineitalic, .variable { font-style: italic;}.bolditalic, .codeinlineboldital, .syntaxinlineboldital,.titleinfigure, .titleinexample, .titleintable, .titleinequation { font-weight: bold; font-style: italic;}.bridgehead, .titleinrefsubsect, .subhead1, .subhead2, .subhead3 { font-family: Arial, Helvetica, sans-serif; color: #369; background-color: white; font-weight: bold;}.titleinrefsubsect, .subhead1 { font-size: 1.1em;}.subhead2 { font-size: 1.0em;}.subhead3 { font-size: 0.95em; display: inline;}.underline { text-decoration: underline;}.superscript { vertical-align: super;}.subscript { vertical-align: sub;}.listofeft { border: none;}.betadraft { color: #f00; background-color: white;}.betadraftsubtitle { text-align: center; font-weight: bold; color: #f00; background-color: white;}.comment { color: #080; background-color: white; font-weight: bold;}.copyrightlogo { text-align: center; font-size: 0.85em; border-style: none;}.tocsubheader { list-style-type: none;}/*************************************//* End DARB Formats *//*************************************/@media all { * { background-color: transparent; line-height: 1.2; } body { color: black; background-color: white; }/* dd { margin-bottom: 2ex; } dl:first-child { margin-top: 2ex; }*/}@media print { body, p, table, td, th, ol, ul, a, dl, dt, dd, blockquote, caption { font-family: "Times New Roman", Times, serif; font-size: 11pt; } h1, h2, h3, h4, h5, h6, th, thead td { font-family: Arial, Helvetica, serif; color: black; background-color: white; } div.zz-skip-header { display: none; } code, a:link, a:visited, a:hover, a:active { color: black; background-color: white; text-decoration: none; }}</style><!--+++++++++++++++++++++++++++++++++++++++++++++++++++++++++--><!-- Styles end here --><!--+++++++++++++++++++++++++++++++++++++++++++++++++++++++++--><link rel="start" href="../../index.htm" title="Home" type="text/html" /></head><body><div class="header"><a id="top" name="top"></a><div class="zz-skip-header"><a href="#BEGIN">Skip Headers</a></div><table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%"><tr><td align="left" valign="top"><b>Oracle® Enterprise Manager Grid Control Release Notes for Linux and Microsoft Windows</b><br /><b>10<span class="italic">g</span> Release 3 (10.2.0.3.0)</b><br />B40096-03</td><td valign="bottom" align="right"><table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="225"><tr><td> </td></tr></table></td></tr></table><hr /><table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100"><tr><td> </td></tr></table><a name="BEGIN" id="BEGIN"></a></div><!-- class="header" --><div class="ind"><!-- End Header --><h1>Oracle® Enterprise Manager</h1><p class="booktitle">Grid Control Release Notes for Linux and Microsoft Windows</p><p><span class="revnumber">10<span class="italic">g</span> Release 3 (10.2.0.3.0)</span></p><p class="invpartnumber">B40096-03</p><p class="date">January 2007</p><p>Oracle Enterprise Manager Grid Control (Grid Control) is a management solution that provides a centralized, integrated framework for managing different versions of Oracle products and some third-party products in the enterprise. Grid Control automates day-to-day maintenance requirements for an enterprise grid such as software installation, patching, upgrading, workload balancing, and security.</p><p>This Release Notes document is one of the documents that is bundled with 10.2.0.3.0 Grid Control Patch Set. The document provides information about the Patch Set and procedures that help you patch your previous releases of Grid Control and (or) Management Agent, that is any 10.2.x.x.x installation, and upgrade it to 10.2.0.3.0 release.</p><div align="center"><div class="inftblnote"><br /><table class="Note oac_no_warn" summary="This is a layout table to format a note" title="This is a layout table to format a note" dir="ltr" border="1" width="80%" frame="hsides" rules="groups" cellpadding="3" cellspacing="0"><tbody><tr><td align="left"><p class="notep1">Note:</p>This document helps you only patch any previous releases of Grid Control and (or) Management Agent, that is any 10.2.x.x.x installation, and upgrade it to 10.2.0.3.0 release. If you do not have a previous release, but want to have a 10.2.0.3.0 environment, then first install either 10.2.0.1.0 or 10.2.0.2.0 release, and then use this Patch Set to upgrade it to 10.2.0.3.0. For information about installing 10.2.0.1.0 or 10.2.0.2.0 Grid Control, refer to the installation guides available at:<p><code><a href="http://www.oracle.com/technology/documentation/oem.html">http://www.oracle.com/technology/documentation/oem.html</a></code></p></td></tr></tbody></table><br /></div><!-- class="inftblnote" --></div><p>This document contains the following sections:</p><ul><li type="disc"><p><a href="#BABEIBEJ">Patch Set Documentation</a></p></li><li type="disc"><p><a href="#CJAIACJA">New Components in This Patch Set</a></p></li><li type="disc"><p><a href="#BABFDEEA">Preinstallation Tasks</a></p></li><li type="disc"><p><a href="#BABEIBBH">Installation Procedure</a></p></li><li type="disc"><p><a href="#CHDIIBEB">Post Installation Tasks</a></p></li><li type="disc"><p><a href="#BABIAFFE">De-Installation of a Patch Set</a></p></li><li type="disc"><p><a href="#BABGEHBJ">Known Issues</a></p></li><li type="disc"><p><a href="#CJABHCEJ">Documentation Accessibility</a></p></li></ul><a id="BABEIBEJ" name="BABEIBEJ"></a><div class="sect1"><!-- infolevel="all" infotype="General" --><h2 class="sect1">Patch Set Documentation</h2><p>There are two documents related to this release of Grid Control Patch Set:</p><ul><li type="disc"><p><span class="italic">Oracle Enterprise Manager Grid Control Release Notes, 10<span class="italic">g</span> Release 3 (10.2.0.3.0)</span> (this document)</p><p>This document provides:</p><ul><li type="disc"><p>A list of new components included in this Patch Set</p></li><li type="disc"><p>Information about how to install or de-install the Patch Set</p></li><li type="disc"><p>A list of known issues relating to this release of Grid Control Patch Set</p></li></ul><div align="center"><div class="inftblnote"><br /><table class="Note oac_no_warn" summary="This is a layout table to format a note" title="This is a layout table to format a note" dir="ltr" border="1" width="80%" frame="hsides" rules="groups" cellpadding="3" cellspacing="0"><tbody><tr><td align="left"><p class="notep1">Note:</p>The information given in this document apply to Linux as well as Microsoft Windows platform. The commands shown in this document have the Linux conventions followed, for example, the usage of forward slashes to indicate a directory path. For Microsoft Windows, you can use the same commands, but consider backward slashes instead of forward slashes.</td></tr></tbody></table><br /></div><!-- class="inftblnote" --></div></li><li type="disc"><p><span class="italic">Oracle Enterprise Manager Grid Control</span> <span class="italic">List of Bugs Fixed, 10<span class="italic">g</span> Release 3 (10.2.0.3.0)</span></p><p>This document provides a list of all generic bugs related to Grid Control that have been fixed in this release.</p></li></ul><p>Both these documents are included with the 10.2.0.3.0 Patch Set. You can also find a consolidated document, which has the Document ID 405521.1, on Oracle<span class="italic">MetaLink</span> at:</p><p><code><a href="http://metalink.oracle.com/">http://metalink.oracle.com/</a></code></p><p>To locate document 405521.1:</p><ol type="1" start="1"><li><p>Click <span class="bold">Advanced</span> at the top of the Oracle<span class="italic">MetaLink</span> page.</p></li><li><p>Enter 405521.1 in the <span class="bold">Document ID</span> field and click <span class="bold">Submit</span>.</p></li></ol><p>You can also find this document on the Oracle Technology Network (OTN) Web site:</p><p><code><a href="http://www.oracle.com/technology/documentation/oem.html">http://www.oracle.com/technology/documentation/oem.html</a></code></p></div><!-- class="sect1" --><a id="CJAIACJA" name="CJAIACJA"></a><div class="sect1"><!-- infolevel="all" infotype="General" --><h2 class="sect1">New Components in This Patch Set</h2><p>The 10.2.0.3.0 Patch Set has the following new components bundled with it:</p><a id="sthref1" name="sthref1"></a><p class="subhead2">Oracle Content Database Plug-In</p><p>The Oracle Content Database Plug-Ins provide integration of Oracle Content Database Release 10.1.3.2.0 with Management Agent, Management Service, and Repository for Grid Control Release 10.2.0.3.0. In particular, they define target type metadata and default collection to monitor Content DB runtime performance and repository statistics in Grid Control.</p><a id="sthref2" name="sthref2"></a><p class="subhead2">Oracle Application Management Pack for Siebel</p><p>Oracle Application Management Pack for Siebel is a comprehensive solution for managing the configuration, performance, availability, and service level of Siebel CRM applications. It can be used to monitor the health of the servers and components, measure application response time, track configuration changes, and diagnose performance and execution problems.</p><a id="sthref3" name="sthref3"></a><p class="subhead2">Connectors (MOM and Remedy)</p><p>Microsoft Operations Management Connector enables Oracle Enterprise Manager to retrieve alerts from Microsoft Operations Manager (MOM). The retrieved alerts are stored in the Enterprise Manager repository and displayed through the Enterprise Manager console.</p><p>Remedy Connector enables you to integrate Remedy Trouble Ticket System with Enterprise Manager. This connector creates trouble tickets based on alerts retrieved from the Enterprise Manager notification system.</p><a id="sthref4" name="sthref4"></a><p class="subhead2">Oracle Configuration Manager</p><p>Oracle Configuration Manager (OCM) is designed to gather and provide customer's configuration information and store it in Oracle repository for maintenance and other related tasks. This feature was introduced from Grid Control Release 10.2.0.2.0 onwards.</p><a id="sthref5" name="sthref5"></a><p class="subhead2">Linux Management Pack</p><p>Available exclusively as part of the Oracle Unbreakable Linux support program, the Linux Management Pack provides an integrated and cost-effective solution for complete Linux server lifecycle management, including server provisioning, patching, monitoring, and administration.</p><a id="sthref6" name="sthref6"></a><p class="subhead2">Linux Server Administration</p><p>Enterprise Manager now supports Linux administration features for RedHat (RHEL4) and SuSE Linux (sles9), significantly simplifying the error-prone and time-consuming server setup tasks, such as System Services Configuration and Network Setup.</p></div><!-- class="sect1" --><a id="BABFDEEA" name="BABFDEEA"></a><div class="sect1"><!-- infolevel="all" infotype="General" --><h2 class="sect1">Preinstallation Tasks</h2><p>This section describes the preinstallation tasks to be performed.</p><div class="sect2"><!-- infolevel="all" infotype="General" --><a id="sthref7" name="sthref7"></a><h3 class="sect2">Preinstallation Tasks in General</h3><p>Oracle recommends that you back up the ORACLE_HOME that is being upgraded using this Patch Set. In the case of a Management Repository, Oracle recommends that you back up the repository database <span class="bold">because the Patch Set makes changes to the repository that cannot be rolled back</span>. Also, back up the Oracle Inventory directory to a pre-Patch Set state.</p><p>The product prerequisites (required operating system patches, packages, and so on) of 10.2.0.3.0 are the same as that of 10.2.0.1.0/10.2.0.2.0, so they are already met.</p><p><span class="bold">In case of Grid Control environment installed via "Enterprise Manager using New Database" option or "Enterprise Manager using an existing Database" option with 10.1.0.4 or 10.1.0.5 Database, then before upgrading to 10.2.0.3, apply the patch for bug 4329444 on the Database Home.</span></p><div align="center"><div class="inftblnote"><br /><table class="Note oac_no_warn" summary="This is a layout table to format a note" title="This is a layout table to format a note" dir="ltr" border="1" width="80%" frame="hsides" rules="groups" cellpadding="3" cellspacing="0"><tbody><tr><td align="left"><p class="notep1">Note:</p>The patch for bug 4329444 is currently available for Linux platform. However, for Microsoft Windows, the patch will be available in February 2007.</td></tr></tbody></table><br /></div><!-- class="inftblnote" --></div><p>If you have patch 5191377 applied in your environment, then follow these steps before upgrading to 10.2.0.3:</p><ol type="1" start="1"><li><p>Rollback the one-off patch 5191377</p><ol type="a"><li><p>Set your current directory to the directory where the patch is located:</p><p><code>% cd 5191377</code></p></li><li><p>Run the following command:</p><p><code>% opatch rollback -id 5191377</code></p></li></ol></li><li><p>Login as Repository Owner and execute the following command, against SQL prompt</p><p><code>SQL>drop index mgmt_current_violation_idx_05</code></p></li></ol></div><!-- class="sect2" --><div class="sect2"><!-- infolevel="all" infotype="General" --><a id="sthref8" name="sthref8"></a><h3 class="sect2">Preinstallation Tasks Specific to the Upgrade Type</h3><p>The preinstallation tasks can be broadly categorized based on the following types of upgrade you can perform:</p><ul><li type="disc"><p><a href="#CHDJHDFA">Upgrading the First Oracle Management Service and Repository</a></p></li><li type="disc"><p><a href="#CHDGHABB">Upgrading Additional Oracle Management Services After the Repository Is Upgraded to 10.2.0.3.0</a></p></li><li type="disc"><p><a href="#BABIEIGF">Upgrading Management Agents</a></p></li></ul><a id="CHDJHDFA" name="CHDJHDFA"></a><div class="sect3"><!-- infolevel="all" infotype="General" --><h4 class="sect3">Upgrading the First Oracle Management Service and Repository</h4><p>When you have multiple Oracle Management Services (OMS), you can choose to upgrade them one-by-one. When you upgrade the first OMS using the Patch Set, note that the Patch Set also upgrades the associated repository.</p><p>The steps to be taken before upgrading the first OMS are:</p><ul><li type="disc"><p>Leave the repository database and listener instance running.</p></li><li type="disc"><p><span class="bold">In case of Grid Control environment installed via "Enterprise Manager using New Database" option or "Enterprise Manager using an existing Database" option with 10.1.0.4 or 10.1.0.5 Database, then before upgrading to 10.2.0.3, apply the patch for bug 4329444 on the Database Home.</span></p><div align="center"><div class="inftblnote"><br /><table class="Note oac_no_warn" summary="This is a layout table to format a note" title="This is a layout table to format a note" dir="ltr" border="1" width="80%" frame="hsides" rules="groups" cellpadding="3" cellspacing="0"><tbody><tr><td align="left"><p class="notep1">Note:</p>The patch for bug 4329444 is currently available for Linux platform. However, for Microsoft Windows, the patch will be available in February 2007.</td></tr></tbody></table><br /></div><!-- class="inftblnote" --></div></li><li type="disc"><p>If you have patch 5191377 applied in your environment, then follow these steps before upgrading to 10.2.0.3:</p><ol type="1" start="1"><li><p>Rollback the one-off patch 5191377</p><p><span class="bold">a.</span> Set your current directory to the directory where the patch is located:</p><p><code>% cd 5191377</code></p><p><span class="bold">b.</span> Run the following command:</p><p><code>% opatch rollback -id 5191377</code></p></li><li><p>Login as Repository Owner and execute the following command, against SQL prompt</p><p><code>SQL>drop index mgmt_current_violation_idx_05</code></p></li></ol></li><li type="disc"><p>Shut down all OMS instances associated with the repository using the following command from the respective ORACLE_HOMEs from their respective hosts:</p><p><code>$ORACLE_HOME/opmn/bin/opmnctl stopall</code></p><div align="center"><div class="inftblnote"><br /><table class="Note oac_no_warn" summary="This is a layout table to format a note" title="This is a layout table to format a note" dir="ltr" border="1" width="80%" frame="hsides" rules="groups" cellpadding="3" cellspacing="0"><tbody><tr><td align="left"><p class="notep1">Note:</p><p>You have to stop all the OMS instances, although you are upgrading only the first OMS. This is because when you upgrade the first OMS, the Patch Set also upgrades the repository, and since the other OMS instances connect to the same repository, they also need to be stopped.</p><p>Also note that stopping the Management Agents is not mandatory, and as a result, there may be an increase in the number of Agent-related log files. However, this is harmless and can be ignored.</p></td></tr></tbody></table><br /></div><!-- class="inftblnote" --></div></li><li type="disc"><p>Apply the 10.2.0.3.0 Patch Set either interactively by executing the runInstaller (For Microsoft Windows, <code>setup.exe</code>) or silently by using the response file.</p></li></ul></div><!-- class="sect3" --><a id="CHDGHABB" name="CHDGHABB"></a><div class="sect3"><!-- infolevel="all" infotype="General" --><h4 class="sect3">Upgrading Additional Oracle Management Services After the Repository Is Upgraded to 10.2.0.3.0</h4><p>After you have upgraded the first OMS and the repository to 10.2.0.3.0, the only step to be performed before upgrading other OMS instances is to ensure that the other OMS instances are shut down, including the first OMS that was upgraded.</p></div><!-- class="sect3" --><a id="BABIEIGF" name="BABIEIGF"></a><div class="sect3"><!-- infolevel="all" infotype="General" --><h4 class="sect3">Upgrading Management Agents</h4><p>While manually applying the Patch Set using Oracle Universal Installer (OUI), the only preinstallation step to be performed is to shut down the Management Agent. Note that OUI validates for running Management Agent processes. If any Management Agent process is running, then the installer prompts to shut down the Management Agent, and then proceeds with the copying of files and subsequent relinking operation.</p><p>While applying the Patch Set using the Patch Wizard, the Management Agent should be up and running.</p><div align="center"><div class="inftblnote"><br /><table class="Note oac_no_warn" summary="This is a layout table to format a note" title="This is a layout table to format a note" dir="ltr" border="1" width="80%" frame="hsides" rules="groups" cellpadding="3" cellspacing="0"><tbody><tr><td align="left"><p class="notep1">Note:</p>For 10.2.0.1, the OMS installation not only installs an OMS, but also automatically installs a Management Agent. However, when you upgrade that OMS to 10.2.0.3.0 using the Patch Set, the Patch Set does not upgrade any of the associated Management Agents. To upgrade the Management Agents, you have to manually apply the Patch Set on the each of the Management Agent homes, as they are separate Oracle Homes.</td></tr></tbody></table><br /></div><!-- class="inftblnote" --></div></div><!-- class="sect3" --></div><!-- class="sect2" --></div><!-- class="sect1" --><a id="BABEIBBH" name="BABEIBBH"></a><div class="sect1"><!-- infolevel="all" infotype="General" --><h2 class="sect1">Installation Procedure</h2><p>This section describes the installation procedure.</p><div class="sect2"><a id="BABJGCFI" name="BABJGCFI"></a><h3 class="sect2">Extracting the Software</h3><p>For upgrading to 10.2.0.3.0, you have to manually download and extract the 10.2.0.3.0 Patch Set.</p><div align="center"><div class="inftblnote"><br /><table class="Note oac_no_warn" summary="This is a layout table to format a note" title="This is a layout table to format a note" dir="ltr" border="1" width="80%" frame="hsides" rules="groups" cellpadding="3" cellspacing="0"><tbody><tr><td align="left"><p class="notep1">Note:</p>Mass Agent patching is an exception. For Mass Agent patching, refer to <a href="#CJAIACHA">*, "Upgrading Management Agent - Multiple Hosts at a Time"</a>.</td></tr></tbody></table><br /></div><!-- class="inftblnote" --></div><p>To download and extract the Patch Set:</p><ol type="1" start="1"><li><p>Download the p3731593_102030_<platform name>.zip patch set installation archive to any directory that may or may not be an Oracle Home directory.</p></li><li><p>Enter the following command to unzip and extract the installation files:</p><p><code>$ unzip p3731593_102030_<platform name>.zip</code></p><p>This extracts the files to the "3731593" directory.</p></li></ol><div align="center"><div class="inftblnote"><br /><table class="Note oac_no_warn" summary="This is a layout table to format a note" title="This is a layout table to format a note" dir="ltr" border="1" width="80%" frame="hsides" rules="groups" cellpadding="3" cellspacing="0"><tbody><tr><td align="left"><p class="notep1">Important:</p>The same Patch Set can be used for patching OMS, Repository, and Management Agent. The procedures are described in the following sections.</td></tr></tbody></table><br /></div><!-- class="inftblnote" --></div></div><!-- class="sect2" --><div class="sect2"><!-- infolevel="all" infotype="General" --><a id="sthref9" name="sthref9"></a><h3 class="sect2">Upgrading Oracle Management Service</h3><p>Ensure that ORACLE_HOME is set to the ORACLE_HOME of the OMS that is intended to be upgraded. Navigate to the 3731593/Disk1 subdirectory and execute the runInstaller (For Microsoft Windows, execute setup.exe).</p><div align="center"><div class="inftblnote"><br /><table class="Note oac_no_warn" summary="This is a layout table to format a note" title="This is a layout table to format a note" dir="ltr" border="1" width="80%" frame="hsides" rules="groups" cellpadding="3" cellspacing="0"><tbody><tr><td align="left"><p class="notep1">Note:</p>The Patch Set contains new components like Siebel and Connectors, besides an older component, that is Oracle Configuration Manager (OCM). For these components to be installed and functioning properly, the Patch Set needs to be applied on OMS as well as on the Management Agent, so that the bits related to OMS and Management Agent are installed accordingly. The Patch Set, depending upon the ORACLE_HOME that is being patched, understands if it is an OMS or Management Agent, and then installs the OMS and Agent bits accordingly.</td></tr></tbody></table><br /></div><!-- class="inftblnote" --></div><div align="center"><div class="inftblnote"><br /><table class="Note oac_no_warn" summary="This is a layout table to format a note" title="This is a layout table to format a note" dir="ltr" border="1" width="80%" frame="hsides" rules="groups" cellpadding="3" cellspacing="0"><tbody><tr><td align="left"><p class="notep1">IMPORTANT:</p><span class="bold">In case of Grid Control environment installed via "Enterprise Manager using New Database" option or "Enterprise Manager using an existing Database" option with 10.1.0.4 or 10.1.0.5 Database, then before upgrading to 10.2.0.3, apply the patch for bug 4329444 on the Database Home.</span><p><span class="bold">Note that the patch for bug 4329444 is currently available for Linux platform. However, for Microsoft Windows, the patch will be available in February 2007.</span></p><p>If you have patch 5191377 applied in your environment, then follow these steps before upgrading to 10.2.0.3:</p><ol type="1" start="1"><li><p>Rollback the one-off patch 5191377</p><ol type="a"><li><p>Set your current directory to the directory where the patch is located:</p><p><code>% cd 5191377</code></p></li><li><p>Run the following command:</p><p><code>% opatch rollback -id 5191377</code></p></li></ol></li><li><p>Login as Repository Owner and execute the following command, against SQL prompt</p><p><code>SQL>drop index mgmt_current_violation_idx_05</code></p></li></ol></td></tr></tbody></table><br /></div><!-- class="inftblnote" --></div><p>If ORACLE_HOME is set in the environment or passed as a command line argument, then OUI automatically picks it up and goes through the following three phases.</p><div class="sect3"><!-- infolevel="all" infotype="General" --><a id="sthref10" name="sthref10"></a><h4 class="sect3">Interview Phase</h4><p>In this phase, OUI picks up the repository connection details from the configuration files and then prompts for the SYS password of the repository database. It validates if there are any existing connections to the repository. It does not check for operating system processes but looks for specific entries in the Enterprise Manager repository. Wait for few minutes for the session entries to get cleared after you shut down the OMS.</p><p><span class="bold">Oracle Configuration Manager Installation</span></p><p>In this step, the installer collects information to install the Oracle Configuration Manager (OCM) into the existing ORACLE_HOME location. OCM will be configured only if the license agreement is accepted.</p><p>Provide the Customer Service Identification (CSI), Oracle<span class="italic">MetaLink</span> Account User Name and the Country of license origin when configuring OCM on the OCM Configuration Page. If you want to configure the proxy settings, then click <span class="bold">Connection Settings</span> on the Configuration Page and provide the proxy settings.</p><div align="center"><div class="inftblnote"><br /><table class="Note oac_no_warn" summary="This is a layout table to format a note" title="This is a layout table to format a note" dir="ltr" border="1" width="80%" frame="hsides" rules="groups" cellpadding="3" cellspacing="0"><tbody><tr><td align="left"><p class="notep1">Note:</p>OCM is installed even when you decline the license agreement, but is not configured. The necessary directories are created and files are instantiated. You need to invoke <code>setupCCR</code> ($ORACLE_HOME/ccr/bin/setupCCR) at a later point of time to configure it. When <code>setupCCR</code> is invoked interactively, it prompts for the required parameter values. You can also accept the license agreement, but choose not to enable the Oracle Configuration Manager. You can disable Oracle Configuration Manager even after accepting the license agreement by unchecking or deselecting the "Enable Oracle Configuration Manager" option.</td></tr></tbody></table><br /></div><!-- class="inftblnote" --></div><p>If you install the Management Agent using "Agent Download", then you will have to manually configure OCM. To configure OCM, perform the following steps:</p><ol type="1" start="1"><li><p>Determine your CSI, Oracle<span class="italic">MetaLink</span> identifier, and the country where you purchased your service contract.</p></li><li><p>Execute one of the following commands according to your choice:</p><p>If you want to configure using proxy server:</p><p><code>$ORACLE_HOME/ccr/bin/setupCCR -p <proxy server></code></p><p>If you want to configure without using proxy server:</p><p><code>$ORACLE_HOME/ccr/bin/setupCCR</code></p><p>For more information about using setupCCR, use the setupCCR -help command.</p></li><li><p>The license agreement for Oracle Configuration Manager is displayed. To accept the license agreement, enter "Y".</p></li><li><p>When setup prompts for the CSI, Oracle<span class="italic">MetaLink</span> identifier, and country code, provide these details.</p></li><li><p>Setup then installs and configures OCM.</p></li><li><p>When setup is complete, OCM gathers configuration information for ORACLE_HOME, and uploads this information to Oracle for use while supporting your site.</p></li><li><p>If you want to check the status of OCM, run the following command:</p><p><code>$ORACLE_HOME/ccr/bin/emCCR status</code></p></li></ol></div><!-- class="sect3" --><div class="sect3"><!-- infolevel="all" infotype="General" --><a id="sthref11" name="sthref11"></a><h4 class="sect3">Copy and Relink Phase</h4><p>In this phase, the installer copies all necessary files and does relink operations.</p></div><!-- class="sect3" --><div class="sect3"><!-- infolevel="all" infotype="General" --><a id="sthref12" name="sthref12"></a><h4 class="sect3">Configuration Phase</h4><p>In this phase, the installer does the following:</p><ul><li type="disc"><p><span class="bold">Updates the Repository:</span> This assistant upgrades the repository to 10.2.0.3 release. If the repository has already been upgraded to 10.2.0.3.0 release and this is an additional OMS being patched, then the configuration phase does not update the repository.</p><div align="center"><div class="inftblnote"><br /><table class="Note oac_no_warn" summary="This is a layout table to format a note" title="This is a layout table to format a note" dir="ltr" border="1" width="80%" frame="hsides" rules="groups" cellpadding="3" cellspacing="0"><tbody><tr><td align="left"><p class="notep1">Note:</p>If the "Repository Upgrade Assistant" fails, then do not click <span class="bold">Retry</span>, as the Retry button says that the repository upgrade is successful, but the repository upgrade is not clean. For rectifying the repository errors, refer to the "Enterprise Manager Upgrade" section of "Chapter 11: Upgrading Enterprise Manager Grid Control" in the Enterprise Manager Grid Control Installation and Basic Configuration Guide available at:<p><code><a href="http://www.oracle.com/technology/documentation/oem.html">http://www.oracle.com/technology/documentation/oem.html</a></code></p><p>After rectifying the Repository errors, continue by clicking <span class="bold">Retry</span> for other confing assistants to run.</p></td></tr></tbody></table><br /></div><!-- class="inftblnote" --></div></li><li type="disc"><p><span class="bold">Redeploys the Enterprise Manager Application:</span> In this step, the OC4J application is redeployed.</p></li><li type="disc"><p><span class="bold">Deploys the Provisioning Application:</span> In this step, various provisioning application steps are configured, which you can use to deploy an application. Here, the Provision Archive files are also updated to the Enterprise Manager Repository. A Provisioning Archive file typically consists of new procedures, new directives, and new components that are used by the application.</p><p>If the software library is not set up, then a message is displayed stating that the provisioning configuration did not succeed. The tool has to be executed manually after upgrade and after setting up the software library. Software library can be created using any mounted file system that is readable and writeable from the all OMS instances.</p><p>To correct this, perform the following steps:</p><ol type="1" start="1"><li><p>Login to Enterprise Manager Grid Control as SYSMAN.</p></li><li><p>Navigate to <span class="bold">Deployments</span>, then <span class="bold">Provisioning</span> and then to <span class="bold">Administration</span>.</p></li><li><p>Navigate to the <span class="bold">Software Library Configuration</span> section and click <span class="bold">Add</span>.</p></li><li><p>Provide a valid directory path where you want to store the raw data for the component(s).</p></li><li><p>Login to the machine that hosts the OMS, and do the following:</p><ul><li type="circle"><p>Set the environment variable to "ORACLE_HOME" of the OMS</p></li><li type="circle"><p>Execute the following command:</p><p><code><ORACLE_HOME>/bin/PARDeploy -action -force deploy -parDir <OMSHome>/sysman/prov/paf</code></p></li></ul></li></ol></li><li type="disc"><p><span class="bold">Starting Oracle Management Service:</span> In this step, the OMS is started.</p></li><li type="disc"><p><span class="bold">Configures Oracle Configuration Manager:</span> This step configures the OCM, if you have accepted the license agreement. The necessary directories are created and files are instantiated. If there are problems during configuration, then the configuration is not performed. To configure it later, you can invoke <code>setupCCR</code> ($ORACLE_HOME/ccr/bin/setupCCR) at a later point of time.</p></li></ul></div><!-- class="sect3" --></div><!-- class="sect2" --><div class="sect2"><!-- infolevel="all" infotype="General" --><a id="sthref13" name="sthref13"></a><h3 class="sect2">Upgrading Management Agent</h3><p>The Management Agent can be upgraded in two ways - either one host at a time or many hosts at a time.</p><div align="center"><div class="inftblnote"><br /><table class="Note oac_no_warn" summary="This is a layout table to format a note" title="This is a layout table to format a note" dir="ltr" border="1" width="80%" frame="hsides" rules="groups" cellpadding="3" cellspacing="0"><tbody><tr><td align="left"><p class="notep1">Important:</p>The Patch Set contains new components like Siebel and Connectors, besides an older component Oracle Configuration Manager (OCM). For these components to be installed and functioning properly, the Patch Set needs to be applied on OMS as well as on Management Agent, so that the bits related to OMS and Agent are installed accordingly. The Patch Set, depending upon the ORACLE_HOME that is being patched, understands if it is an OMS or Management Agent, and installs the OMS and Agent bits accordingly.</td></tr></tbody></table><br /></div><!-- class="inftblnote" --></div><a id="CHDBCBJI" name="CHDBCBJI"></a><div class="sect3"><h4 class="sect3">Upgrading Management Agent - One Host at a Time</h4><p>To upgrade Management Agents, one host at a time, using OUI, follow these steps:</p><ol type="1" start="1"><li><p>Login to the specific host where the Management Agent is running.</p></li><li><p>Stop the Management Agent.</p></li><li><p>Ensure that ORACLE_HOME is set to the ORACLE_HOME that is intended for patching.</p></li><li><p>Run the <code>runInstaller</code> executable from the Patch Set media Disk1 subdirectory (For Microsoft Windows, run <code>setup.exe</code>).</p><p>If the ORACLE_HOME is set in the environment or passed as a command line argument, then OUI automatically picks it up.</p><p>It then validates if the Management Agent is up and running from ORACLE_HOME. If it is running, then the installer prompts to shut down the Management Agent, and then proceeds with the copying of files and subsequent relinking operation.After the installation is complete, the Patch Set automatically restarts the Management Agent.</p></li></ol></div><!-- class="sect3" --><a id="CJAIACHA" name="CJAIACHA"></a><div class="sect3"><h4 class="sect3">Upgrading Management Agent - Multiple Hosts at a Time</h4><p>To upgrade Management Agents, multiple hosts at a time, use either of the following two methods:</p><ul><li><p>Method 1 - By Distributing the Full Patch Set to a Number of Nodes</p></li><li><p>Method 2 - By Staging the Patch Set and Distributing Scripts to a Number of Nodes</p></li></ul><p>You can choose one of the methods for mass patching of Management Agents. Method 1 is based on "push" technique in which the entire set of patch binaries is transferred to all the targets. Method 2 is based on "pull" technique in which only a script is transferred to the targets and the patch is then installed over HTTP. Since it does not require to transfer the entire set of patch binaries in Method 2, it is the recommended method for large number of targets. Whereas Method 1 is more suitable for a limited number of targets. Note that for Method 2, the wget executable needs to be installed on the target machines and present in the PATH environment variable.</p><ul><li type="disc"><p><span class="bold">Method 1 - By Distributing the Full Patch Set to a Number of Nodes</span></p><ol type="1" start="1"><li><p>Login to Enterprise Manager Grid Control using SYSMAN credentials. Click Targets and check if the host is running.</p></li><li><p>Click <span class="bold">Setup</span> from the top-right corner of the Grid Control console. Then select <span class="bold">Patching Setup</span> from the panel to the left. Provide the Oracle<span class="italic">Metalink</span> credentials and click <span class="bold">Apply</span>.</p></li><li><p>Navigate to the <span class="bold">Jobs</span> tab. Create a job of the type "RefreshFromMetalink", and execute it.</p></li><li><p>Click <span class="bold">Deployments</span>, then <span class="bold">Patch Oracle Software</span>. Provide the patch number 3822442 and select the correct platform and 10.2.0.3.0 release.</p></li><li><p>You can then select a number of targets to apply the patch. After selecting the target, select "Use default patching script" or "Provide custom script" option to allow OCM to be installed in the target Agent's home.</p></li><li><p>If the target is a Microsoft Windows machine, then in the pre-script option specify the following:</p><p><code>%emd_root%\EMStagedPatches\3822442\3822442\ecm_3822442.bat</code></p></li></ol><p>This method copies the patch to the selected number of targets and runs a script to apply the patch. The script creates blackouts, shuts down the Management Agent before applying the Patch Set, applies the Patch Set, clears the blackouts after applying the Patch Set, and then restarts the Management Agent. It is advisable to choose a reasonable number of nodes so that the network is not overloaded.</p><div align="center"><div class="inftblnote"><br /><table class="Note oac_no_warn" summary="This is a layout table to format a note" title="This is a layout table to format a note" dir="ltr" border="1" width="80%" frame="hsides" rules="groups" cellpadding="3" cellspacing="0"><tbody><tr><td align="left"><p class="notep1">Important:</p>The Patch Set contains new components like Siebel and Connectors, besides an older component, that is OCM. For these components to be installed and functioning properly, the Patch Set needs to be applied on OMS as well as on Management Agent, so that the bits related to OMS and Agent are installed accordingly.</td></tr></tbody></table><br /></div><!-- class="inftblnote" --></div></li><li type="disc"><p><span class="bold">Method 2 - By Staging the Patch Set and Distributing Scripts to a Number of Nodes</span></p><div align="center"><div class="inftblnote"><br /><table class="Note oac_no_warn" summary="This is a layout table to format a note" title="This is a layout table to format a note" dir="ltr" border="1" width="80%" frame="hsides" rules="groups" cellpadding="3" cellspacing="0"><tbody><tr><td align="left"><p class="notep1">Note:</p>For Microsoft Windows target machines, patching through this method requires wget.exe to be in the PATH environment variable. If wget.exe is not in the PATH of the target machine, then add it to the PATH and rebounce the Management Agent by executing the following:<p><code><ORACLE_HOME>/bin/emctl stop agent</code></p><p><code><ORACLE_HOME>/bin/emctl start agent</code></p></td></tr></tbody></table><br /></div><!-- class="inftblnote" --></div><p>Perform the following steps on the OMS host:</p><ol type="1" start="1"><li><p>Navigate to the following location:</p><p><code>cd <OMS ORACLE_HOME>/sysman/agent_download/</code></p></li><li><p>Create a directory:</p><p><code>mkdir -p patchset/10.2.0.3.0/<platform name></code></p></li><li><p>You can then stage the Patch Set by either copying from a DVD or by extracting the contents of the Metalink patch 3731593.</p></li><li><p>Copy the <code>p3731593_102030_<platform name>.zip</code> from the DVD or Metalink patch to an empty, temporary directory.</p></li><li><p>Extract the contents of the ZIP file to that same temporary directory.</p></li><li><p>Now navigate to the 3731593/Disk1 directory and copy its contents to the newly created directory in step (2):</p><p>To navigate:</p><p><code>cd 3731593/Disk1</code></p><p>To copy the contents to the newly created directory in step (2):</p><p><code>cp -r * <ORACLE_HOME>/sysman/agent_download/patchset/10.2.0.3.0/<platform name></code></p><p>Here, ORACLE_HOME is the OMS ORACLE_HOME and "platform name" is one of the following:</p><div class="tblformal"><a id="sthref14" name="sthref14"></a><a id="sthref15" name="sthref15"></a><p class="titleintable">Table 1 Descriptions of Platform Names</p><table class="Formal" title="Descriptions of Platform Names" summary="Descriptions of Platform Names" dir="ltr" border="1" width="100%" frame="hsides" rules="groups" cellpadding="3" cellspacing="0"><thead><tr align="left" valign="top"><th align="left" valign="bottom" id="r1c1-t17">Platform Name</th><th align="left" valign="bottom" id="r1c2-t17">Description</th></tr></thead><tbody><tr align="left" valign="top"><td align="left" id="r2c1-t17" headers="r1c1-t17"><p>linux</p></td><td align="left" headers="r2c1-t17 r1c2-t17"><p>Linux</p></td></tr><tr align="left" valign="top"><td align="left" id="r3c1-t17" headers="r1c1-t17"><p>x86_64</p></td><td align="left" headers="r3c1-t17 r1c2-t17"><p>Linux X86_64</p></td></tr><tr align="left" valign="top"><td align="left" id="r4c1-t17" headers="r1c1-t17"><p>ppc64</p></td><td align="left" headers="r4c1-t17 r1c2-t17"><p>Linux on power PC</p></td></tr><tr align="left" valign="top"><td align="left" id="r5c1-t17" headers="r1c1-t17"><p>linux390</p></td><td align="left" headers="r5c1-t17 r1c2-t17"><p>z/Linux</p></td></tr><tr align="left" valign="top"><td align="left" id="r6c1-t17" headers="r1c1-t17"><p>ia64linux</p></td><td align="left" headers="r6c1-t17 r1c2-t17"><p>IA64 Linux</p></td></tr><tr align="left" valign="top"><td align="left" id="r7c1-t17" headers="r1c1-t17"><p>solaris</p></td><td align="left" headers="r7c1-t17 r1c2-t17"><p>Solaris 64 bit</p></td></tr><tr align="left" valign="top"><td align="left" id="r8c1-t17" headers="r1c1-t17"><p>solarisx86</p></td><td align="left" headers="r8c1-t17 r1c2-t17"><p>Solaris-x86</p></td></tr><tr align="left" valign="top"><td align="left" id="r9c1-t17" headers="r1c1-t17"><p>hpux</p></td><td align="left" headers="r9c1-t17 r1c2-t17"><p>HP-UX</p></td></tr><tr align="left" valign="top"><td align="left" id="r10c1-t17" headers="r1c1-t17"><p>decunix</p></td><td align="left" headers="r10c1-t17 r1c2-t17"><p>HP Tru64 UNIX</p></td></tr><tr align="left" valign="top"><td align="left" id="r11c1-t17" headers="r1c1-t17"><p>hpunix</p></td><td align="left" headers="r11c1-t17 r1c2-t17"><p>HP 64 bit</p></td></tr><tr align="left" valign="top"><td align="left" id="r12c1-t17" headers="r1c1-t17"><p>hpi</p></td><td align="left" headers="r12c1-t17 r1c2-t17"><p>HPUX-Itanium</p></td></tr><tr align="left" valign="top"><td align="left" id="r13c1-t17" headers="r1c1-t17"><p>aix</p></td><td align="left" headers="r13c1-t17 r1c2-t17"><p>AIX5L</p></td></tr><tr align="left" valign="top"><td align="left" id="r14c1-t17" headers="r1c1-t17"><p>macosx</p></td><td align="left" headers="r14c1-t17 r1c2-t17"><p>MACOSX</p></td></tr><tr align="left" valign="top"><td align="left" id="r15c1-t17" headers="r1c1-t17"><p>vms</p></td><td align="left" headers="r15c1-t17 r1c2-t17"><p>VMS</p></td></tr></tbody></table><br /></div><!-- class="tblformal" --><p>The above-mentioned operation stages the contents of the Patch Set in the OMS host.</p></li><li><p>After this happens, follow these steps:</p><p>(a) Login to Enterprise Manager Grid Control and navigate to the <span class="bold">Jobs</span> tab, and select a patch job.</p><p>(b) Provide the patch number 3731596 and select the correct platform and release of the target.</p><p>(c) You can then select a number of targets to apply the patch. After selecting the target, select "Provide custom script" option to allow OCM to be installed in the target Agent's home.</p><p>(d) If the target is a Microsoft Windows machine, then in the pre-script option specify the following:</p><p><code>%emd_root%\EMStagedPatches\3731596\3731596\ecm_3731596.bat</code></p></li></ol><p>This method copies the script to the selected number of nodes and runs a script to apply the Patch Set from the above staged location. It is advisable to choose a reasonable number of nodes so that the network is not overloaded.</p><div align="center"><div class="inftblnote"><br /><table class="Note oac_no_warn" summary="This is a layout table to format a note" title="This is a layout table to format a note" dir="ltr" border="1" width="80%" frame="hsides" rules="groups" cellpadding="3" cellspacing="0"><tbody><tr><td align="left"><p class="notep1">Important:</p>The Patch Set contains new components like Siebel and Connectors, besides an older component, that is OCM. For these components to be installed and functioning properly, the Patch Set needs to be applied on OMS as well as on Management Agent, so that the bits related to OMS and Agent are installed accordingly.</td></tr></tbody></table><br /></div><!-- class="inftblnote" --></div></li></ul></div><!-- class="sect3" --><div class="sect3"><!-- infolevel="all" infotype="General" --><a id="sthref16" name="sthref16"></a><h4 class="sect3">Upgrading Management Agent Clusters</h4><p>You can patch the Management Agent on selected nodes of a cluster. To do this, you can use either of the following two methods:</p><ul><li><p>Method 1 - By Distributing the Full Patch Set to a Number of Nodes</p></li><li><p>Method 2 - By Staging the Patch Set and Distributing Scripts to a Number of Nodes</p></li></ul><p>You can choose one of the methods for mass patching of Management Agents. Method 1 is based on "push" technique in which the entire set of patch binaries is transferred to all the targets. Method 2 is based on "pull" technique in which only a script is transferred to the targets and the patch is then installed over HTTP. Since it does not require to transfer the entire set of patch binaries in Method 2, it is the recommended method for large number of targets. Whereas Method 1 is more suitable for a limited number of targets. Note that for Method 2, the wget executable needs to be installed on the target machines and present in the PATH environment variable.</p><ul><li type="disc"><p><span class="bold">Method 1 - By Distributing the Full Patch Set to a Number of Nodes:</span></p><ol type="1" start="1"><li><p>Login to Enterprise Manager Grid Control. Navigate to the <span class="bold">Jobs</span> tab and select a patch job.</p></li><li><p>Provide the patch number 3822442 and select the correct platform and 10.2.0.3.0 release.</p></li><li><p>You can then select all the cluster nodes to apply the patch. After selecting the target, select "Provide custom script" option to allow OCM to be installed in the target Agent's home.</p></li><li><p>If the target is a Microsoft Windows machine, then in the pre-script option specify the following:</p><p><code>%emd_root%\EMStagedPatches\3822442\3822442\ecm_3822442.bat</code></p></li></ol><p>This method copies the patch to the selected cluster nodes and runs a script to apply the patch. The script creates blackouts, shutsdown the Management Agent before applying the Patch Set, clears the blackouts after applying the Patch Set, and then starts up the Management Agent. If the cluster is a very large one, then it is advisable to choose a reasonable number of nodes so that the network is not overloaded.</p></li><li type="disc"><p><span class="bold">Method 2 - By Staging the Patch Set and Distributing Scripts to a Number of Nodes:</span></p><div align="center"><div class="inftblnote"><br /><table class="Note oac_no_warn" summary="This is a layout table to format a note" title="This is a layout table to format a note" dir="ltr" border="1" width="80%" frame="hsides" rules="groups" cellpadding="3" cellspacing="0"><tbody><tr><td align="left"><p class="notep1">Note:</p>For Microsoft Windows target machines, patching through this method requires wget.exe to be in the PATH environment variable. If wget.exe is not in the PATH of the target machine, then add it to the PATH and rebounce the Management Agent by executing the following:<p><code><ORACLE_HOME>/bin/emctl stop agent</code></p><p><code><ORACLE_HOME>/bin/emctl start agent</code></p></td></tr></tbody></table><br /></div><!-- class="inftblnote" --></div><p>Perform the following steps on the OMS host:</p><ol type="1" start="1"><li><p>Navigate to the following location:</p><p><code>cd <OMS ORACLE_HOME>/sysman/agent_download/</code></p></li><li><p>Create a directory:</p><p><code>mkdir -p patchset/10.2.0.3.0/<platform name></code></p></li><li><p>You can then stage the Patch Set by either copying from the DVD or extracting the contents of the Metalink patch 3731593.</p></li><li><p>Copy the <code>p3731593_102030_<platform name>.zip</code> from the DVD or Metalink patch to an empty, temparory directory.</p></li><li><p>Extract the contents of the ZIP file to that same temporary directory.</p></li><li><p>Now navigate to the 3731593/Disk1 directory and copy its contents to the newly created directory in step (2):</p><p>To navigate:</p><p><code>cd 3731593/Disk1</code></p><p>To copy the contents to the newly created directory in step (2):</p><p><code>cp -r * <ORACLE_HOME>/sysman/agent_download/patchset/10.2.0.3.0/<platform name></code></p><p>Here, ORACLE_HOME is the OMS ORACLE_HOME and "platform name" is one of the following:</p><div class="tblformal"><a id="sthref17" name="sthref17"></a><a id="sthref18" name="sthref18"></a><p class="titleintable">Table 2 Descriptions of Platform Names</p><table class="Formal" title="Descriptions of Platform Names" summary="Descriptions of Platform Names" dir="ltr" border="1" width="100%" frame="hsides" rules="groups" cellpadding="3" cellspacing="0"><thead><tr align="left" valign="top"><th align="left" valign="bottom" id="r1c1-t20">Platform Name</th><th align="left" valign="bottom" id="r1c2-t20">Description</th></tr></thead><tbody><tr align="left" valign="top"><td align="left" id="r2c1-t20" headers="r1c1-t20"><p>linux</p></td><td align="left" headers="r2c1-t20 r1c2-t20"><p>Linux</p></td></tr><tr align="left" valign="top"><td align="left" id="r3c1-t20" headers="r1c1-t20"><p>x86_64</p></td><td align="left" headers="r3c1-t20 r1c2-t20"><p>Linux X86_64</p></td></tr><tr align="left" valign="top"><td align="left" id="r4c1-t20" headers="r1c1-t20"><p>ppc64</p></td><td align="left" headers="r4c1-t20 r1c2-t20"><p>Linux on power PC</p></td></tr><tr align="left" valign="top"><td align="left" id="r5c1-t20" headers="r1c1-t20"><p>linux390</p></td><td align="left" headers="r5c1-t20 r1c2-t20"><p>z/Linux</p></td></tr><tr align="left" valign="top"><td align="left" id="r6c1-t20" headers="r1c1-t20"><p>ia64linux</p></td><td align="left" headers="r6c1-t20 r1c2-t20"><p>IA64 Linux</p></td></tr><tr align="left" valign="top"><td align="left" id="r7c1-t20" headers="r1c1-t20"><p>solaris</p></td><td align="left" headers="r7c1-t20 r1c2-t20"><p>Solaris 64 bit</p></td></tr><tr align="left" valign="top"><td align="left" id="r8c1-t20" headers="r1c1-t20"><p>solarisx86</p></td><td align="left" headers="r8c1-t20 r1c2-t20"><p>Solaris-x86</p></td></tr><tr align="left" valign="top"><td align="left" id="r9c1-t20" headers="r1c1-t20"><p>hpux</p></td><td align="left" headers="r9c1-t20 r1c2-t20"><p>HP-UX</p></td></tr><tr align="left" valign="top"><td align="left" id="r10c1-t20" headers="r1c1-t20"><p>decunix</p></td><td align="left" headers="r10c1-t20 r1c2-t20"><p>HP Tru64 UNIX</p></td></tr><tr align="left" valign="top"><td align="left" id="r11c1-t20" headers="r1c1-t20"><p>hpunix</p></td><td align="left" headers="r11c1-t20 r1c2-t20"><p>HP 64 bit</p></td></tr><tr align="left" valign="top"><td align="left" id="r12c1-t20" headers="r1c1-t20"><p>hpi</p></td><td align="left" headers="r12c1-t20 r1c2-t20"><p>HPUX-Itanium</p></td></tr><tr align="left" valign="top"><td align="left" id="r13c1-t20" headers="r1c1-t20"><p>aix</p></td><td align="left" headers="r13c1-t20 r1c2-t20"><p>AIX5L</p></td></tr><tr align="left" valign="top"><td align="left" id="r14c1-t20" headers="r1c1-t20"><p>macosx</p></td><td align="left" headers="r14c1-t20 r1c2-t20"><p>MACOSX</p></td></tr><tr align="left" valign="top"><td align="left" id="r15c1-t20" headers="r1c1-t20"><p>vms</p></td><td align="left" headers="r15c1-t20 r1c2-t20"><p>VMS</p></td></tr></tbody></table><br /></div><!-- class="tblformal" --><p>The above operation stages the contents of the Patch Set in the OMS host.</p></li><li><p>After this happens, follow these steps:</p><p>(a) Login to Enterprise Manager Grid Control and navigate to the <span class="bold">Jobs</span> tab, and select a patch job.</p><p>(b) Provide the patch number 3731596 and select the correct platform and release of the target.</p><p>(c) You can then select a number of targets to apply the patch. After selecting the target, select "Provide custom script" option to allow OCM to be installed in the target Agent's home.</p><p>(d) If the target is a Microsoft Windows machine, then in the pre-script option specify the following:</p><p><code>%emd_root%\EMStagedPatches\3731596\3731596\ecm_3731596.bat</code></p></li></ol><p>This method copies the patch to the selected cluster nodes and runs a script to apply the Patch Set from the above staged location. It is advisable to choose a reasonable number of nodes so that the network is not overloaded.</p></li></ul></div><!-- class="sect3" --></div><!-- class="sect2" --></div><!-- class="sect1" --><a id="CHDIIBEB" name="CHDIIBEB"></a><div class="sect1"><!-- infolevel="all" infotype="General" --><h2 class="sect1">Post Installation Tasks</h2><p>This section describes the post installation tasks to be performed.</p><div class="sect2"><!-- infolevel="all" infotype="General" --><a id="sthref19" name="sthref19"></a><h3 class="sect2">Post Installation Tasks in General</h3><p>If you had chosen to upgrade the OMS instances one-by-one, that is by upgrading the first OMS and the repository, then after the upgrade is complete, restart all the Management Agents that you had stopped. The OMS gets restarted automatically after the upgrade is complete, but the Management Agents have to be manually restarted. For information about upgrading the first OMS and repository, refer to <a href="#CHDJHDFA">*, "Upgrading the First Oracle Management Service and Repository"</a>.</p></div><!-- class="sect2" --><div class="sect2"><!-- infolevel="all" infotype="General" --><a id="sthref20" name="sthref20"></a><h3 class="sect2">Post Installation Tasks Specific to Solaris Agent Hosts</h3><p>This section describes the post installation tasks that need to be performed for Solaris Agent Hosts.</p><p>Ignore this section if Solaris 10.2.0.1.0 Management Agent was never deployed in your Enterprise Manager deployment. It is sufficient to perform the following steps once after upgrading all the Solaris 10.2.0.1 Management Agents to 10.2.0.2 or later release. If you are not sure, it is acceptable to repeat the process described in this section multiple times.</p><ol type="1" start="1"><li><p>Identify Solaris Agents with Host 3.0 metadata in the Enterprise Manager repository. Upgrade them to 10.2.0.2.0 release or later:</p><ol type="a"><li><p>To check if Solaris 3.0 metadata is present in the Enterprise Manager repository, execute lfm_check_solaris_3_0_metadata:</p><p><code>% sqlplus sysman/<sysman_passwd> @lfm_check_solaris_3_0_metadata</code></p><p>If this step returns "0", you can ignore this section.</p></li><li><p>To identify the hosts that require an upgrade, execute list_lfm_solaris_3_0_metadata_hosts.sql against the Enterprise Manager Repository :</p><p><code>% sqlplus sysman/<sysman_passwd> @list_lfm_solaris_3_0_metadata_hosts</code></p><p>If this step returns an empty list, then there are no Solaris Agent Hosts. You can ignore this section.</p></li><li><p>Download Solaris 10.2.0.2.0 Patch Set or later Patch Set release from OracleMetalink Web site. Apply this patch on the Solaris Agents identified in the previous step.</p><p>Log on to the Solaris host with Management Agent owner account. Upload the pending data using emctl upload command. Shutdown the Management Agent using emctl stop agent. Now apply the 10.2.0.2 Management Agent portion of the Patch Set. Start the Management Agent using emctl start agent.</p></li><li><p>After an hour, execute list_lfm_solaris_3_0_metadata_hosts.sql again to see if there are any more Agents that need to be patched.</p></li></ol></li><li><p>Remove customizations specific to "Generic Log File Monitoring" from "Monitoring Templates". For more details about "Generic Log File Monitoring" feature, refer to "Configuring Generic Log File Monitoring Criteria" online help.</p><ol type="a"><li><p>Execute list_lfm_templates.sql to identify the templates with customizations:</p><p><code>% sqlplus sysman/<sysman_passwd> @list_lfm_templates</code></p><p>If this step returns an empty list, go to step 3.</p></li><li><p>For each notification rule listed in the step 2 (a), perform the following steps:</p><ul><li type="circle"><p>Log on to Enterprise Manager Console with appropriate privileges to edit the template.</p></li><li type="circle"><p>Click Setup, then Monitoring Templates on the left pane.</p></li><li type="circle"><p>Search the template by it's name and select it by clicking the radio button.</p></li><li type="circle"><p>You can either delete or update the template to remove the "Generic Log File Monitoring" related customization.</p><p>To delete the template, click View to make note of the Template Settings, so that you can use it at a later point in time. Click OK to return to Monitoring Templates page. Select the template and click Delete. Then, click Yes on the Delete Template Confirmation page.</p><p>To update the template, click Edit and then click the Metrics Thresholds tab. Click the edit icon that is next to "Log File Pattern Matched Line Count", and make a note of the settings in the "Monitored Objects" table for future reference. Click Continue (page level) to return to the Metric Tresholds tab. Select <span class="bold">Log File Pattern Matched Line Count</span> and click <span class="bold">Remove Metrics from Template</span> to remove it. Click OK (page level) to commit the changes.</p></li></ul></li><li><p>Perform to step 2 (a) to see if there are any more templates with customizations.</p></li></ol></li><li><p>Remove filters related to "Generic Log File Monitoring" from "Notification Rules". You can do this by performing the following steps:</p><ol type="a"><li><p>Execute list_lfm_notif_rules.sql to identify rules with the customization:</p><p><code>% sqlplus sysman/<sysman_passwd> @list_lfm_notif_rules</code></p><p>If this step returns an empty list, go to step 4.</p></li><li><p>For each rule listed in step 3 (a), perform the following steps:</p><ul><li type="circle"><p>Log on to the Grid Control console with credentials/privileges that help you edit the notification rule.</p></li><li type="circle"><p>Click Preferences, then click Rules under <span class="bold">Notification</span> on the left pane. Select the rule by clicking the radio button. You can either delete or update the rule. Update choices include deleting the "Log File Pattern Matched Line Count" metric or updating the "Log File Pattern Matched Line Count" metric to notify on "All Objects".</p><p>To delete a Notification Rule, click <span class="bold">View</span>, and make a note of the current settings for future reference. Then click <span class="bold">Notification Rules</span> bread crumb to return to the previous page. Then, click <span class="bold">Delete</span> and then <span class="bold">Yes</span> on the confirmation page.</p><p>To update by removing "Log File Pattern Matched Line Count" metric, click <span class="bold">Edit</span>, and then click the <span class="bold">Metrics</span> tab. Select the row for "Log File Pattern Matched Line Count" metric and make note of the current settings. Click on table level <span class="bold">Remove</span>. Click <span class="bold">OK</span> (page level) to commit the changes.</p></li><li type="circle"><p>To update "Log File Pattern Matched Line Count" metric, to notify on "All Objects", click <span class="bold">Edit</span>, and then click the <span class="bold">Metrics</span> tab. Click the edit icon that is next to "Log File Pattern Matched Line Count" metric. Make a note of current settings. Select "All Objects" by clicking the radio button and click <span class="bold">Continue</span> (page level) to return to the Metrics page. Then, click <span class="bold">OK</span> (page level) to commit the changes.</p></li></ul></li><li><p>Peform step 3 (a).</p></li></ol></li><li><p>Remove "Generic Log File Monitoring" related custom configuration done via setting metric thresholds for "Log File Pattern Matched Line Count" host metric:</p><ol type="a"><li><p>Execute list_lfm_threshold_hosts.sql to identify hosts with custom configuration:</p><p><code>% sqlplus sysman/<sysman_passwd> @list_lfm_threshold_hosts</code></p><p>If the above step returns an empty list, go to Step 5.</p></li><li><p>For each host listed in step 4 (a), perform the following steps:</p><ul><li type="circle"><p>Log on to Grid Control console with credentials/privileges that help you edit the host thresholds.</p></li><li type="circle"><p>Go to the home page for the given host and click <span class="bold">Metric and Policy Settings</span>.</p></li><li type="circle"><p>Click the edit icon that is on the same row as "Log File Pattern Matched Line Count" metric.</p></li><li type="circle"><p>Make a note of the settings in the "Monitored Objects" table for future reference.</p></li><li type="circle"><p>Remove all rows from the "Monitored Objects" table except "All others" row.</p></li><li type="circle"><p>Click Continue (page level) to return to "Metric Thresholds" tab and click OK (page level) to commit the changes.</p></li></ul></li><li><p>Perform step 4 (a).</p></li></ol></li><li><p>Clear and purge "Log File Pattern Matched Line Count" severities from Solaris 3.0 metadata based hosts:</p><ol type="a"><li><p>Run list_lfm_severity_solaris_hosts.sql to identify the hosts:</p><p><code>% sqlplus sysman/<sysman_passwd> @list_lfm_severity_solaris_hosts</code></p></li><li><p>If this returns an empty list, go to Step 6.</p></li><li><p>For each host listed in the step 5 (a), perform the following steps:</p><ul><li type="circle"><p>Log on to Grid Control console with credentials/privileges that help you edit the host thresholds.</p></li><li type="circle"><p>Go to the home page for the given host and click <span class="bold">Log File Alerts</span>.</p></li><li type="circle"><p>Click <span class="bold">Clear Every Open Alert</span>.</p></li><li type="circle"><p>To purge the clear alerts, click <span class="bold">Show Cleared Alerts</span> and then <span class="bold">Purge Every Alert</span>. This is an optional step.</p></li></ul></li><li><p>Perform step 5 (a).</p></li></ol></li><li><p>Shutdown the Grid Control Console on all OMS nodes.</p></li><li><p>Execute lfm_fix_host_metadata.sql to the Enterprise Manager Repository:</p><p><code>% sqlplus sysman/<sysman_passwd> @lfm_fix_host_metadata</code></p><p>Then quit the sqlplus session by entering the exit command.</p></li><li><p>Start the Grid Control Console on all OMS nodes.</p></li><li><p>Verify that the patch has been applied properly. To do this, perform the following steps:</p><ul><li type="disc"><p>Log on to Grid Control console.</p></li><li type="disc"><p>Go to the home page of a UNIX host (such as Solaris or Linux) and click <span class="bold">Metric and Policy Settings</span>.</p></li><li type="disc"><p>Click the edit icon that is next to "Log File Pattern Matched Line Count", and verify that the following columns are displayed in the "Monitored Objects" table: Select, Log File Name, Match Pattern in Perl, Ignore Pattern in Perl, Comparison Operator, Warning Threshold, Critical Threshold, Corrective Action</p></li></ul></li><li><p>Recreate any custom settings that have been removed from the previous steps.</p></li></ol><div align="center"><div class="inftblnote"><br /><table class="Note oac_no_warn" summary="This is a layout table to format a note" title="This is a layout table to format a note" dir="ltr" border="1" width="80%" frame="hsides" rules="groups" cellpadding="3" cellspacing="0"><tbody><tr><td align="left"><p class="notep1">Note:</p>Never deploy Solaris 10.2.0.1.0 Management Agent in the future. Instead, deploy 10.2.0.2.0 or later releases of Solaris Management Agents.</td></tr></tbody></table><br /></div><!-- class="inftblnote" --></div></div><!-- class="sect2" --></div><!-- class="sect1" --><a id="BABIAFFE" name="BABIAFFE"></a><div class="sect1"><!-- infolevel="all" infotype="General" --><h2 class="sect1">De-Installation of a Patch Set</h2><p>There is no mechanism provided for de-installing Patch Sets. If you are concerned about being able to de-install a Patch Set, Oracle recommends that you back up your software installation before applying the Patch Set. If you have to de-install a Patch Set, the use one of the following procedures (in the order of preference):</p><ul><li type="disc"><p>Restore the ORACLE_HOME directory that was backed up</p></li><li type="disc"><p>Re-install the baseline release and any Patch Sets previously applied, up to but not including this Patch Set</p></li><li type="disc"><p>Restore the repository database that was backed up</p></li><li type="disc"><p>Restore the Oracle Inventory that was backed up</p></li></ul><p>Regardless of how you de-install a Patch Set, contact Oracle Support Services to verify if the problem you are encountering is being addressed.</p></div><!-- class="sect1" --><a id="BABGEHBJ" name="BABGEHBJ"></a><div class="sect1"><!-- infolevel="all" infotype="General" --><h2 class="sect1">Known Issues</h2><p>This section lists the known issues pertaining to this release.</p><div class="sect2"><!-- infolevel="all" infotype="General" --><a id="sthref21" name="sthref21"></a><h3 class="sect2">Installation and Upgrade Issues</h3><p>This section addresses installation and upgrade issues.</p><div class="sect3"><!-- infolevel="all" infotype="General" --><a id="sthref22" name="sthref22"></a><h4 class="sect3">Installation and Upgrade Issues In General</h4><p>This section covers all installation and upgrade issues in general.</p><div class="sect4"><!-- infolevel="all" infotype="General" --><a id="sthref23" name="sthref23"></a><h5 class="sect4">Repository Upgrade Failure</h5><p>When you apply the 10.2.0.3 Patch Set to upgrade your repository, the upgrade may fail.</p><p>In case of Grid Control environment installed via "Enterprise Manager using New Database" option or "Enterprise Manager using an existing Database" option with 10.1.0.4 or 10.1.0.5 Database, then before upgrading to 10.2.0.3, apply the patch for bug 4329444 on the Database Home.</p><div align="center"><div class="inftblnote"><br /><table class="Note oac_no_warn" summary="This is a layout table to format a note" title="This is a layout table to format a note" dir="ltr" border="1" width="80%" frame="hsides" rules="groups" cellpadding="3" cellspacing="0"><tbody><tr><td align="left"><p class="notep1">Note:</p>The patch for bug 4329444 is currently available for Linux platform. However, for Microsoft Windows, the patch will be available in February 2007.</td></tr></tbody></table><br /></div><!-- class="inftblnote" --></div><p>(Bug 5648438, 5665837)</p></div><!-- class="sect4" --><div class="sect4"><!-- infolevel="all" infotype="General" --><a id="sthref24" name="sthref24"></a><h5 class="sect4">Repository Upgrade Fails for Sites With 5191377 One-Off Patch</h5><p>If you have patch 5191377 applied in your environment, then follow these steps before upgrading to 10.2.0.3:</p><ol type="1" start="1"><li><p>Rollback the one-off patch 5191377</p><ol type="a"><li><p>Set your current directory to the directory where the patch is located:</p><p><code>% cd 5191377</code></p></li><li><p>Run the following command:</p><p><code>% opatch rollback -id 5191377</code></p></li></ol></li><li><p>Login as Repository Owner and execute the following command, against SQL prompt</p><p><code>SQL>drop index mgmt_current_violation_idx_05</code></p></li></ol><p>(Bug 5758101)</p></div><!-- class="sect4" --><div class="sect4"><!-- infolevel="all" infotype="General" --><a id="sthref25" name="sthref25"></a><h5 class="sect4">Errors While Doing an Additional OMS Install</h5><p>If you are doing an additional OMS install pointing to a repository whose key is not present, then you will see following message:</p><p>"The emkey for securing the current Management Service does not exist in the repository you have specified. From the first Oracle Management Service install, execute "emctl prepare repository -new_oms_install" before proceeding with this install."</p><p>In the this message, the command that needs to be executed is incorrect. Therefore, follow these steps instead:</p><ol type="1" start="1"><li><p>Rebounce the database.</p></li><li><p>Copy <code>emkey.ora</code> into <code>/OH/sysman/config/</code></p></li><li><p>run <code>./emctl config emkey -emkeyfile /OH/sysman/config/emkey.ora</code></p></li></ol><p>(Bug 5658897)</p></div><!-- class="sect4" --><div class="sect4"><!-- infolevel="all" infotype="General" --><a id="sthref26" name="sthref26"></a><h5 class="sect4">After Upgrading OMS, Additional OMS Install Is Blocked</h5><p>You cannot perform an additional 10.2.0.1.0 OMS install by using the repository of 10.2.0.3.0 OMS.</p><p>You can install additional OMS with the following workaround, if the repository is already upgraded to 10.2.0.3.0. To do this, perform the following steps:</p><ol type="1" start="1"><li><p>Convert the repository version to 10.2.0.1.0 from 10.2.0.3.0 by using the following sql statement:</p><p><code>UPDATE sysman.mgmt_versions SET version = '10.2.0.1.0' where component_name='CORE'; commit;</code></p></li><li><p>Provide the repository credentials for the Specify Database Configuration Screen and click <span class="bold">Next</span>.</p></li><li><p>Update the repository version to 10.2.0.3.0 by using the following sql statement:</p><p><code>UPDATE sysman.mgmt_versions SET version = '10.2.0.3.0' where component_name='CORE'; commit;</code></p></li><li><p>Proceed with the installation.</p></li></ol><p>(Bug 4910745)</p></div><!-- class="sect4" --><div class="sect4"><!-- infolevel="all" infotype="General" --><a id="sthref27" name="sthref27"></a><h5 class="sect4">I/O Error Displayed at the End of Agent Download Installation</h5><p>While performing an Agent Download Install using the agentdownload.linux script, at the end of the installation, the following error is displayed:</p><p><code>error: db4 error(5) from dbcursor->c_get: Input/output error</code></p><p>This error is harmless and can be ignored. The Management Agent gets installed successfully and works fine.</p><p>(Bug 5761062)</p></div><!-- class="sect4" --></div><!-- class="sect3" --><div class="sect3"><!-- infolevel="all" infotype="General" --><a id="sthref28" name="sthref28"></a><h4 class="sect3">Installation and Upgrade Issues Specific to Agent Deploy Application</h4><p>This section covers issues that related to the Agent Deploy application.</p><p>For more information about Management Agent deployment, refer to the Management Agent Deployment Best Practices document available at:</p><p><code><a href="http://www.oracle.com/technology/products/oem/pdf/10gr2_agent_deploy_bp.pdf">http://www.oracle.com/technology/products/oem/pdf/10gr2_agent_deploy_bp.pdf</a></code></p><div class="sect4"><!-- infolevel="all" infotype="General" --><a id="sthref29" name="sthref29"></a><h5 class="sect4">Application Error Is Displayed If "Temp" Directory Does Not Have Permission</h5><p>The directory specified in SCRATCH_PATH on your local host should be writable, otherwise you will see an application error. (By default, it is set to C:\tmp)</p><p>The directory specified in "nttempdir" in the <code>agentpush.properties</code> file on your remote host should have permission, as this will be used to copy <username>_agentOHQuery.sh (in case of cluster, it is NFS install). Otherwise, you will see an application error. (By default, it is set to C:\tmp)</p><p>(Bug 5665925)</p></div><!-- class="sect4" --><div class="sect4"><!-- infolevel="all" infotype="General" --><a id="sthref30" name="sthref30"></a><h5 class="sect4">sshConnectivity.sh Overwrites the Keys in Silent Install Mode</h5><p>If you have existing SSH setup on some machines and if you are using the sshConnectivity.sh script to do a new setup manually, then to restore the old setup, you need to perform the following steps manually:</p><ul><li type="disc"><p>mv $HOME/.ssh/identity.pub.ri.bak $HOME/.ssh/identity.pub</p></li><li type="disc"><p>mv $HOME/.ssh/identity.ri.bak $HOME/.ssh/identity</p></li><li type="disc"><p>mv $HOME/.ssh/known_hosts.ri.bak $HOME/.ssh/known_hosts</p></li><li type="disc"><p>mv $HOME/.ssh/config.ri.bak $HOME/.ssh/config</p></li><li type="disc"><p>chmod 644 $HOME/.ssh/identity.pub</p></li><li type="disc"><p>chmod 600 $HOME/.ssh/identity</p></li><li type="disc"><p>chmod 644 $HOME/.ssh/known_hosts</p></li><li type="disc"><p>chmod 644 $HOME/.ssh/config</p></li></ul><p>For more information, refer to the Management Agent Deployment Best Practices document available at:</p><p><code><a href="http://www.oracle.com/technology/products/oem/pdf/10gr2_agent_deploy_bp.pdf">http://www.oracle.com/technology/products/oem/pdf/10gr2_agent_deploy_bp.pdf</a></code></p><p>(Bug 5484944)</p></div><!-- class="sect4" --><div class="sect4"><!-- infolevel="all" infotype="General" --><a id="sthref31" name="sthref31"></a><h5 class="sect4">Test Connection Displays Error During OCM Registration of OUI</h5><p>When Patch Set is applied on OMS and if the Management Agent is installed interactively from the agent download kit, then on the "Configuration Manager Registration" page, when you click <span class="bold">Connection Settings</span> before clicking <span class="bold">Test Registration</span>, the following error appears and the install does not proceed.</p><pre xml:space="preserve" class="oac_no_warn">Unable to locate Oracle Configuration Manager Trusted Keystore /scratch/DUMMY/.dummy/ccr/admin/security/certca( No such file or directory</pre><p>(Bug 5591205)</p></div><!-- class="sect4" --></div><!-- class="sect3" --></div><!-- class="sect2" --><div class="sect2"><!-- infolevel="all" infotype="General" --><a id="sthref32" name="sthref32"></a><h3 class="sect2">Oracle Management Service and Management Agent Issues</h3><p>This section addresses OMS and Management Agent-related issues.</p><div class="sect3"><!-- infolevel="all" infotype="General" --><a id="sthref33" name="sthref33"></a><h4 class="sect3">Issues While Configuring Server Load Balancer</h4><p>While configuring Server Load Balancer between Grid Control console and Management Service as described in the Section 3.6.2 of <span class="italic">Oracle® Enterprise Manager Advanced Configuration 10g Release 2 (10.2)</span>, the Management Service redirects the client browser to a Management Service host bypassing the Server Load balancer.</p><p>For example, in a Grid Control deployment with three Oracle Management Services (say on omshost1.example.com, omshost2.example.com, omshost3.example.com) and a Server Load Balancer (slbhost.example.com), the client browser request for http(s)://slbhost.example.com[:port]/em gets redirected to http(s)://omshost[1,2,3][:port]/em.</p><p>To prevent the browser from bypassing the load balancer when a URL is redirected, edit the *|ServerName|* directive defined in the Oracle HTTP Server configuration file at $ORACLE_HOME/sysman/config/httpd_em.conf to match the name of the server load balancer host. So, for the example above, the directive should look as follows :</p><pre xml:space="preserve" class="oac_no_warn">ServerName slbhost.example.com</pre><p>This workaround has to be done in addition to the configuration defined in Section 3.6.2.3 "Configuring Oracle HTTP Server When Using a Server Load Balancer for the Grid Control Console" of the <span class="italic">Oracle® Enterprise Manager Advanced Configuration 10g Release 2 (10.2)</span>.</p><p>Also, note that in a multi-OMS setup, this workaround has to be done for all the Management Services.</p><p>(Bug 5692755)</p></div><!-- class="sect3" --><div class="sect3"><!-- infolevel="all" infotype="General" --><a id="sthref34" name="sthref34"></a><h4 class="sect3">Memory Leak Issue in Management Agent</h4><p>There is a memory leak in the Management Agent that is amplified while monitoring iAS targets, or more generally, when a lot of HTTP requests are sent to the Management Agent. The leak is in the xdk code that is used by the Management Agent and is tracked by bug 5573534.</p><p>To resolve this issue, apply the one-off patch for bug 5573534.</p><p>(Bug 5575154, 5573534)</p></div><!-- class="sect3" --><div class="sect3"><!-- infolevel="all" infotype="General" --><a id="sthref35" name="sthref35"></a><h4 class="sect3">RDBMS Issues Related to Daylight Saving Time</h4><p>According to the "The Energy Policy Act of 2005" beginning 2007, the Daylight Saving Time has been extended by one month and the schedule for the states of the United States that adopt daylight saving time will use the following rules:</p><ul><li type="disc"><p>Start: Second Sunday in March</p></li><li type="disc"><p>End: First Sunday in November</p></li><li type="disc"><p>Time: 2 am local time</p></li></ul><p>The new rules have been incorporated in jdk "1.5.0_06". The details can be found at this site:</p><p><code><a href="http://bugs.sun.com/bugdatabase/view_bug.do?bug_id=6317178">http://bugs.sun.com/bugdatabase/view_bug.do?bug_id=6317178</a></code></p><p>Oracle recommends that you apply the patch to reflect this change. Otherwise, it can cause unexpected behavior in the Grid Control, especially with the job system. This includes jobs being scheduled an hour later than expected.</p><p>For more information, see Metalink Note:359145.1 titled "Impact of 2007 USA daylight savings changes on the Oracle database" on the Oracle<span class="italic">Metalink</span> site.</p><p>(Bug 5351247)</p></div><!-- class="sect3" --><div class="sect3"><!-- infolevel="all" infotype="General" --><a id="sthref36" name="sthref36"></a><h4 class="sect3">Unsecuring of Management Agent Not Supported if OMS Is Secured</h4><p>You cannot unsecure a Management Agent if the OMS is secured and locked.</p><p>(Bug 5531324)</p></div><!-- class="sect3" --><div class="sect3"><!-- infolevel="all" infotype="General" --><a id="sthref37" name="sthref37"></a><h4 class="sect3">Helpsets Missing in Japanese Version</h4><p>The translated online help is not available for the following:</p><ul><li type="disc"><p><span class="bold">Target Metrics:</span> Oracle Content DB Metrics, Voicemail and Fax Recording Service, JBoss Application Server Metrics, Oracle BPEL Process Manager Metrics, IBM WebSphere MQ Queue Manager Metrics, Identity Manager Server Target Metrics, Identity Manager Repository Target Metrics, Access Manager - Identity Server Metrics, Access Manager - Access Server Metrics, Siebel Server Target Metrics, Siebel Component Metrics, Siebel Gateway Target Metrics, and Siebel Component Group Target Metrics.</p></li><li type="disc"><p><span class="bold">Application Server Management:</span> Managing Oracle BPEL Process Manager, Managing IBM WebSphere MQ Queue Manager, Managing Identity Federation Server, Managing JBoss Application Server, Managing Identity Manager, Managing Access Manager - Access and Identity Servers, Managing JBoss Partition, and Managing IBM WebSphere MQ Cluster.</p></li><li type="disc"><p><span class="bold">Target Policies:</span> Secure Configuration for Oracle Database, Secure Configuration for Oracle Real Application Cluster Database, and Secure Configuration for Oracle Listener.</p></li><li type="disc"><p><span class="bold">Management Operations:</span> Managing Data Exchange, Managing Management Connectors, Managing Policy Groups, and Managing Siebel Targets.</p></li></ul><p>(Bug 5715773)</p></div><!-- class="sect3" --><div class="sect3"><a id="sthref38" name="sthref38"></a><h4 class="sect3">SQL Exception While Deleting OOB Reports</h4><p>The repository upgrade from 10.2.0.1 production to 10.2.0.2 Patch Set release may fail if the SYSMAN user has created new reports from out-of-box reports, that is by using the "Create Like" feature, with the same name as the out-of-the-box report. This failure may occur only if the 10.2.0.2 release includes a new copy of the out-of-box reports.</p><p>To resolve this issue, as a Super Administrator of Enterprise Manager, you can either rename the newly created report so that the name is unique across the enterprise or delete the newly created report. Once the report is renamed or deleted, rerun the upgrade process.</p><p>(Bug 5225689)</p></div><!-- class="sect3" --><div class="sect3"><!-- infolevel="all" infotype="General" --><a id="sthref39" name="sthref39"></a><h4 class="sect3">Loaders Errors After Upgrading to10.2.0.3 Grid Control with Seed</h4><p>After you upgrade to 10.2.0.3 release with seed, you will see some loader errors. This is because of bug 4482253 that deals with loader being unable to process files due to ORA-01801 errors. This problem is caused by RDBMS bug 3944226.</p><p>To resolve this issue, try restarting the repository database. If the problem is persistent, then contact Oracle Support to obtain the patch for RDBMS bug 3944226.</p><p>(Bug 5614815)</p></div><!-- class="sect3" --></div><!-- class="sect2" --><div class="sect2"><!-- infolevel="all" infotype="General" --><a id="sthref40" name="sthref40"></a><h3 class="sect2">Patch Management Issues</h3><p>This section addresses patch management -related issues.</p><div class="sect3"><!-- infolevel="all" infotype="General" --><a id="sthref41" name="sthref41"></a><h4 class="sect3">"Oracle Patch Prerequisite Checker for CRS" Fails in "Stage Patches" Step</h4><p>CRS home is owned by the root. If a non-root user is running the CRS pre-req DP and has provided a patch staging folder under ORACLE_HOME, then there will be permission-related issue.</p><p>The resolve this issue, provide a folder outside the CRS Home with permission for the patching user to stage the patch, for example: <code>/tmp</code>.</p><p>(Bug 5686511)</p></div><!-- class="sect3" --><div class="sect3"><!-- infolevel="all" infotype="General" --><a id="sthref42" name="sthref42"></a><h4 class="sect3">Patching Deployment Procedures Fail at Initialization Stage</h4><p>For all patching Deployment Procedures where the opatch upgrade step is enabled, the opatch patches for the right release of the homes being patched must be in the software library. Either the opatch patch should be uploaded manualy to the software library or the job "Optach patch" should be run successfully. This job needs to be run only once. A dump directory needs to be provided for this job to run, which can be specified on the <span class="bold">Offline Patching Settings</span> page. To veiw that page, select <span class="bold">Setup</span> and then select <span class="bold">Patching Setup</span>.</p><p>(Bug 5701915)</p></div><!-- class="sect3" --><div class="sect3"><!-- infolevel="all" infotype="General" --><a id="sthref43" name="sthref43"></a><h4 class="sect3">"Patch Oracle Clusterware -Rolling" Hangs at the "Execute Root Script" Step</h4><p>While applying a Patch Set on 10.2.0.1 CRS, if you are a user as specified in Target Credentials who does not have "sudo" privileges on the CRS targets or nodes, then you would ideally customize the "Patch Oracle Clusterware" CRS deployment procedure to execute the "sudo" steps as "PAM" steps and also specify a PAM command script. However, if you have not updated the PAM command script to set the umask value to 0022, then you will see the following error in a loop and the Deployment Procedure execution hangs at the "Execute Root Script" step.</p><pre xml:space="preserve" class="oac_no_warn">Startup will be queued to init within 90 seconds. /scratch/aime/CRS/crs/bin/crsctl.bin: error while loading shared libraries: libclntsh.so.10.1: cannot open shared object file: No such file or directory</pre><p>To resolve this issue, ensure that the PAM command script being used is updated to have the umask value set to 0022.</p><p>(Bug 5691165)</p></div><!-- class="sect3" --><div class="sect3"><!-- infolevel="all" infotype="General" --><a id="sthref44" name="sthref44"></a><h4 class="sect3">CRS Patching Not Supported on Microsoft Windows</h4><p>The CRS patching deployment procedure is not supported on Microsoft Windows targets.</p><p>(Bug 5683930)</p></div><!-- class="sect3" --><div class="sect3"><!-- infolevel="all" infotype="General" --><a id="sthref45" name="sthref45"></a><h4 class="sect3">"Patch Oracle Clusterware" Deployment Procedure - Failure Due to Home Ownership</h4><p>If patching fails at "Opatch upgrade" step because of home ownership issue, then run the deployment procedure with the following updates:</p><ul><li type="disc"><p>Disable the "Upgrade opatch" step and validate that the opatch version on the CRS Home is as per patch requirements.</p></li><li type="disc"><p>Stage the patch outside the CRS Home in a directory where the patching user has write permission.</p></li></ul><p>(Bug 5704923)</p></div><!-- class="sect3" --><div class="sect3"><!-- infolevel="all" infotype="General" --><a id="sthref46" name="sthref46"></a><h4 class="sect3">Microsoft Windows Patchset Application Fails for ASM and Database (Some Releases)</h4><p>Application of 10.2.0.2.0 and 10.2.0.3.0 Patch Sets for RDBMS and ASM could fail, when Deployment Procedures are used for application of the patch. This issue is relevant for Microsoft Windows targets only. The deployment procedure could fail at "Apply Patch" step due to this issue.</p><p>As a workaround, you may modify the "Apply Patch" directive with the following:</p><p><code>L1045: $runInst_loc_win = File::Spec -> catfile($runInst_loc_win, "oui.exe");</code></p><p>(Bug 5759231)</p></div><!-- class="sect3" --><div class="sect3"><!-- infolevel="all" infotype="General" --><a id="sthref47" name="sthref47"></a><h4 class="sect3">AS Deployment Patch Fails on Microsoft Windows</h4><p>On Microsoft Windows, while applying the patch using the AS Deployment Procedure, the procedure fails at the "Shutdown Application Server" step. This happens because the perl module "Config" was not used in the scripts.</p><p>To resolve this issue, modify the scripts of the following two directives to include the module "Config" as the first line of the script as "Use Config":</p><pre xml:space="preserve" class="oac_no_warn">Directive: Oracle Directives/Common/AS/All/Generic/PA_Startup_ASName of script: pa_startup_as.plDirective: Oracle Directives/Common/AS/All/Generic/PA_Shutdown_ASName of the script: pa_shutdown_as.pl</pre><p>(Bug 5757192)</p></div><!-- class="sect3" --></div><!-- class="sect2" --><div class="sect2"><!-- infolevel="all" infotype="General" --><a id="sthref48" name="sthref48"></a><h3 class="sect2">Client Side Monitoring Issues</h3><p>This section addresses the client side monitoring issues.</p><div class="sect3"><!-- infolevel="all" infotype="General" --><a id="sthref49" name="sthref49"></a><h4 class="sect3">Cannot Monitor Web Cache Target and Forms Transactions from the Same Agent</h4><p>You may see the following message:</p><p>"No data coming from a beacon for the forms transactions."</p><p>If you do so, then try these:</p><ol type="1" start="1"><li><p>Verify forms transaction from that beacon.</p></li><li><p>If it is hanging, then check to see if the Management Agent that the beacon is deployed on is monitoring a Web Cache target.</p></li><li><p>Due to bug 5700255, if a Management Agent is monitoring a Web Cache target, then it cannot run the forms transactions.</p></li><li><p>To resolve this issue, deploy the forms transactions on a different Management Agent.</p></li></ol><p>(Bug 5700255)</p></div><!-- class="sect3" --><div class="sect3"><!-- infolevel="all" infotype="General" --><a id="sthref50" name="sthref50"></a><h4 class="sect3">Beacon Availability Computation Error Under Management Services and Repository</h4><p>In Grid Control, when you select <span class="bold">Targets</span>, <span class="bold">All Targets</span>, and then <span class="bold">Management Services and Repository</span> from the list of targets, you are taken to the Overview page of the selected Management Services and Repository. From here, when you select the Errors tab, you may see the following errors:</p><pre xml:space="preserve" class="oac_no_warn">Beacon Availability Computation n/a Nov 13, 2006 5:07:04 PM Error EXEC_AVAIL_JOB failed. Error: ORA-30036: unable to extend segment by 8 in undo tablespace 'UNDOTBS2'</pre><p>Note that if Grid Control is installed on a pre-existing database, then it does not create UNDO tablespaces. To resolve this issue, you should ensure that the UNDO tablespace is already existing in the database with at least 200MB of space.</p><p>(Bug 5659103)</p></div><!-- class="sect3" --><div class="sect3"><!-- infolevel="all" infotype="General" --><a id="sthref51" name="sthref51"></a><h4 class="sect3">Issues While Adding Beacon to 10.2.0.3 Management Agent That Is Pointing to 10.2.0.2 OMS</h4><p>Certain beacon operations such as adding a beacon to a 10.2.0.3 Management Agent fail when attempted from older release of OMS, that is from release 10.1.0.x, 10.2.0.1, or 10.2.0.2. When the operation fails, the following error message is displayed</p><pre xml:space="preserve" class="oac_no_warn">Error:oracle.sysman.emSDK.emd.comm.CommException: SAXParseException in parsingResponse :: Key columns cannot be transient or computed</pre><p>For these operations to succeed, you should first upgrade your OMS to 10.2.0.3. If you do not want to upgrade the OMS only for this purpose, then you can download the one-off patch for bug 5729053 and apply it on the Management agent.</p><p>(Bug 5729053)</p></div><!-- class="sect3" --><div class="sect3"><!-- infolevel="all" infotype="General" --><a id="sthref52" name="sthref52"></a><h4 class="sect3">Cannot Create Service Tests if OMS Is installed on a Remote Repository</h4><p>If you are setting up OMS on a remote repository (not the one declared in the emoms.properties file), then you will run into the problem of test metadata not being populated correctly. You will experience the following:</p><ul><li type="disc"><p>Not being able to create a service with any test type.</p></li><li type="disc"><p>Not being able to see any tests in the service create or edit pages.</p></li></ul><p>The workaround is to run the following commands:</p><p><code>$ORACLE_HOME/jdk/jre/bin/java -classpath</code></p><p><code>$ORACLE_HOME/jdbc/lib/ojdbc14.jar:$ORACLE_HOME/sysman/jlib/emCORE.jar:$ORACLE_HOME/sysman/jlib/log4j-core.jar:$ORACLE_HOME/lib/servlet.jar:$ORACLE_HOME/jdbc/lib/orai18n.jar:$ORACLE_HOME/sysman/jlib/emagentSDK.jar</code></p><p><code>oracle.sysman.eml.gensvc.test.data.SeedMetadata "<<repository connect string>>" <<db_sysman_username>> <<db_sysman_password>> "$ORACLE_HOME"</code></p><p>If you are using Microsoft Windows, then the variables should be referred as %VAR_NAME% instead of $VAR_NAME. That is, $ORACLE_HOME would be %ORACLE_HOME%.</p><p>(Bug 5584394)</p></div><!-- class="sect3" --><div class="sect3"><!-- infolevel="all" infotype="General" --><a id="sthref53" name="sthref53"></a><h4 class="sect3">Cannot Create a Test-Based Service Target from Scratch</h4><p>When you create a test-based Forms Application target, you need to record a Forms transaction for the target to be created. The recording would fail if the Forms server has not been previously configured to enable transaction monitoring. However, the link to the "Enable Forms Transaction Monitoring" page is only available in the context of a Forms Application target that's already been created.</p><p>You need to first create the Forms Application target as system-based, then configure the Forms server on "Enable Forms Transaction Monitoring" page, then change the Forms Application target to be test-based, and then record the transactions.</p><p>(Bug 5696760)</p></div><!-- class="sect3" --></div><!-- class="sect2" --><div class="sect2"><!-- infolevel="all" infotype="General" --><a id="sthref54" name="sthref54"></a><h3 class="sect2">Job System Issues</h3><p>This section addresses the job system issues.</p><div class="sect3"><!-- infolevel="all" infotype="General" --><a id="sthref55" name="sthref55"></a><h4 class="sect3">Upgrade Failed - Inconsistent Corrective Action Data</h4><p>If you are using the corrective actions feature, then you may run into a schema inconsistency that could cause an upgrade to fail (bug 5855008). If you are using CAs, then run the following PL/SQL block in the Enterprise Manager repository using sqlplus (connected as SYSMAN), <span class="bold">BEFORE</span> doing the upgrade, in order to clean up the inconsistent data.</p><pre xml:space="preserve" class="oac_no_warn">BEGIN FOR r IN (SELECT job_id FROM mgmt_corrective_action a WHERE NOT EXISTS (SELECT 1 FROM mgmt_job j WHERE j.job_id = a.job_id) ) LOOP UPDATE mgmt_policy_assoc_cfg c SET crit_action_job_id = NULL WHERE crit_action_job_id = r.job_id ; UPDATE mgmt_policy_assoc_cfg c SET warn_action_job_id = NULL WHERE warn_action_job_id = r.job_id ; UPDATE mgmt_policy_assoc_cfg c SET info_action_job_id = NULL WHERE info_action_job_id = r.job_id ; DELETE FROM mgmt_corrective_action WHERE job_id = r.job_id ; COMMIT; END LOOP; COMMIT;END;/</pre><p>(Bug 5855008)</p></div><!-- class="sect3" --></div><!-- class="sect2" --><div class="sect2"><!-- infolevel="all" infotype="General" --><a id="sthref56" name="sthref56"></a><h3 class="sect2">Connector Framework Issues</h3><p>This section addresses the connector framework issues.</p><div class="sect3"><!-- infolevel="all" infotype="General" --><a id="sthref57" name="sthref57"></a><h4 class="sect3">Run PL/SQL Procedure Periodically</h4><p>Oracle recommends that you run the following PL/SQL procedure as the repository owner (SYSMAN) periodically. For normal load, run the procedure weekly. If there are large numbers of tickets created everyday, then run it daily.</p><p>To run the procedure, login to the repository database as SYSMAN through SQLPLUS and run the following command:</p><p><code>execute mgmt_cntr_tt.clean_up_old_ticket_recs;/</code></p><p>(Bug 5700394)</p></div><!-- class="sect3" --></div><!-- class="sect2" --><div class="sect2"><!-- infolevel="all" infotype="General" --><a id="sthref58" name="sthref58"></a><h3 class="sect2">Enterprise Integration Issues</h3><p>This section addresses enterprise integration issues.</p><div class="sect3"><!-- infolevel="all" infotype="General" --><a id="sthref59" name="sthref59"></a><h4 class="sect3">Cannot Delete the Underlying Jobs of the Sessions Associated with a Hub</h4><p>After deleting a data exchange hub, the underlying sessions associated with the hub are deleted, but the underlying jobs associated with the outbound data exchange sessions are not deleted. This problem exists only for outbound data exchange sessions and not for inbound ones. On the contrary, these jobs are still scheduled and run.</p><p>To resolve this issue, delete the sessions if any before deleting the hub. Alternatively, navigate to the Jobs page and delete all the jobs corresponding to the outbound sessions.</p><p>(Bug 5664615)</p></div><!-- class="sect3" --></div><!-- class="sect2" --><div class="sect2"><!-- infolevel="all" infotype="General" --><a id="sthref60" name="sthref60"></a><h3 class="sect2">Enterprise Configuration Management Issues</h3><p>This section addresses enterprise configuration management issues.</p><div class="sect3"><!-- infolevel="all" infotype="General" --><a id="sthref61" name="sthref61"></a><h4 class="sect3">Collection Warning Reported on the Console After Upgrading 10.2.0.2 OMS to 10.2.0.3</h4><p>When you upgrade your 10.2.0.2 OMS to 10.2.0.3, then one will see an Inventory Collection warning. The warning message is:</p><pre xml:space="preserve" class="oac_no_warn">unknown external name for the following patchset: Patchset: internal name:<oracle.sysman.patchset>; external name: <UNKNOWN>; version: <10.2.0.2.0>;install time: <>; description: <></pre><p>This warning message is benign and can be ignored.</p><p>If you upgrade a 10.2.0.1 OMS to 10.2.0.3 directly without applying the 10.2.0.2 Patch Set, then this warning does not occur.</p><p>(Bug 5854480)</p></div><!-- class="sect3" --></div><!-- class="sect2" --><div class="sect2"><!-- infolevel="all" infotype="General" --><a id="sthref62" name="sthref62"></a><h3 class="sect2">Database Management Issues</h3><p>This section addresses Database management issues.</p><div class="sect3"><!-- infolevel="all" infotype="General" --><a id="sthref63" name="sthref63"></a><h4 class="sect3">Invalid UTF8 Encoding Error Occurs</h4><p>While executing "db2gc", you may see the error the following error in the terminal session window.</p><pre xml:space="preserve" class="oac_no_warn">Invalid UTF8 encoding. : Start of root element expected</pre><p>This error occurs only when the charset encoding setting of the terminal session window is not UTF8-based, and if you choose to rename the current target display name to another one that includes multibyte and native language-based characters.</p><p>To resolve this issue, do these:</p><ol type="1" start="1"><li><p>Do not rename the target display name if no urgent request.</p></li><li><p>Make sure the charset encoding setting of the terminal session window is UTF8-based. If it is not, set it to UTF8 and try again.</p></li></ol><p>(Bug 5724384)</p></div><!-- class="sect3" --><div class="sect3"><!-- infolevel="all" infotype="General" --><a id="sthref64" name="sthref64"></a><h4 class="sect3">Issues While Migrating Collections with Node Names That Do Not Have Domain Name</h4><p>The db2gc utility does not migrate metric customizations to GridControl for RAC database targets. After the target migration, review the <span class="bold">All Metrics</span> page to customize Metric Thresholds and (or) Collection Frequency as needed.</p><p>(Bug 5709028)</p></div><!-- class="sect3" --><div class="sect3"><!-- infolevel="all" infotype="General" --><a id="sthref65" name="sthref65"></a><h4 class="sect3">"Add Instance" of RAC Though Grid Control Has Error</h4><p>You may face errors while performing the "Add Instance" operation of a RAC Database. To workaround this problem, add "+ASM2.instance_number=2" to the <code>init.ora</code> file of source node, stop the ASM instance with "srvctl stop asm -n destination_node_name" and start it again with "srvctl start asm -n destination_node_name", and then instance2 can be started normally with "srvctl stop instance -d RAC_DB_NAME -i Destination_INSTANCE_NAME".</p><p>(Bug 5260570)</p></div><!-- class="sect3" --><div class="sect3"><!-- infolevel="all" infotype="General" --><a id="sthref66" name="sthref66"></a><h4 class="sect3">Issues with Starting and Stopping 9i Series RAC Database</h4><p>If you have any 9i series RAC Database on Microsoft Windows, then you cannot start or stop these targets from the Cluster Database Home Page of the Grid Control console.</p><p>However, starting and stopping is possible at instance level. So if you have multiple database instances within a cluster, then you can navigate to the home page of any of those database instances, and then start or stop them.</p><p>(Bug 5730084)</p></div><!-- class="sect3" --></div><!-- class="sect2" --><div class="sect2"><!-- infolevel="all" infotype="General" --><a id="sthref67" name="sthref67"></a><h3 class="sect2">Application Server Management Issues</h3><p>This section addresses application server management issues.</p><div class="sect3"><!-- infolevel="all" infotype="General" --><a id="sthref68" name="sthref68"></a><h4 class="sect3">Metric Collection Errors for 10.1.3 Oracle HTTP Server</h4><p>In order to see accurate values on the "mod_oc4j Metrics Page" for a version 10.1.3.0 Oracle HTTP Server, you must patch your Oracle Application Server 10.1.3.0 installation with patch 5161311 and patch 5088239 available on Oracle<span class="italic">Metalink</span> site. For additional information, refer to the patches' ReadMes.</p><p>(Bug 5042008)</p></div><!-- class="sect3" --><div class="sect3"><!-- infolevel="all" infotype="General" --><a id="sthref69" name="sthref69"></a><h4 class="sect3">Issues While Discovering Oracle Application Server Release 9.0.4</h4><p>Grid Control fails to discover some installations of Oracle Application Server release 9.0.4. This is due to an internal error that occurs during the discovery, and this is likely to happen when Oracle Process Connect component is present in the application server instance. However, no error message is displayed.</p><p>(Bug 5735044)</p></div><!-- class="sect3" --><div class="sect3"><!-- infolevel="all" infotype="General" --><a id="sthref70" name="sthref70"></a><h4 class="sect3">BPEL Processes Monitoring Issues When Using 10.2.0.2 Agent with OMS 10.2.0.3</h4><p>If you have upgraded your OMS to 10.2.0.3, but have left the Management Agent as 10.2.0.2 or any other previous release, then for the Oracle BPEL Process Manager target, that is BPEL Process Manager release 10.1.3.1, will always show "Down" status. Also, on the <span class="bold">Processes</span> page, the processes will not get listed.</p><p>To resolve this issue and view the processes on the Processes page, upgrade the Management Agent to 10.2.0.3.</p><p>To view the correct status, do one of these:</p><ol type="1" start="1"><li><p>Upgrade the Management Agent to 10.2.0.3.</p></li><li><p>Apply the one-off patch 5708626 on the Management Agent.</p></li><li><p>As a temporary solution, follow these steps:</p><ol type="a"><li><p>Open the following file:</p><p><code>${OH}/sysman/admin/metadata/oracle_integrationbpm.xml</code> (agent OH)</p></li><li><p>Go to the Response metric and look for the following line in the execution descriptor:</p><p><code><Filter COLUMN_NAME="opmn_process_type" OPERATOR="CONTAINS">OC4J_BPEL</Filter></code></p></li><li><p>In that line, replace "OC4J_BPEL" with the name of the OC4J instance on which BPEL is running. For example, if the OC4J instance name is "home", then after making the changes, the line would look like this:</p><p><code><Filter COLUMN_NAME="opmn_process_type" OPERATOR="CONTAINS">home</Filter></code></p></li><li><p>Save the file, go to ${OH}/bin (agent OH), and execute the following command:</p><p><code>emctl reload agent</code></p></li></ol></li></ol><p>(Bug 5708626, 5704583)</p></div><!-- class="sect3" --><div class="sect3"><!-- infolevel="all" infotype="General" --><a id="sthref71" name="sthref71"></a><h4 class="sect3">OC4J "Enable Logging" Takes You to the OC4J Topology Page Instead of the Trace Configuration Page</h4><p>As a Grid Control admin user, when you try to configure 10.1.3.1 OC4J to enable the end-to-end tracing feature by clicking <span class="bold">Enable Logging</span> on the Manage OC4J Data Collection page, you are redirected to the Application Server Control.</p><p>The desired behavior is that after you login to Application Server Control, you should be redirected to the OC4J Trace Property Configuration Page. Instead, you are re-directed to the Application Server Control Topology Page, where you have to manually drill down to get to the appropriate page. This problem is applicable to Application Server 10.1.3.1 Release.</p><p>To workaround this issue, after you login to Application Server Control, on the Topology page, select the appropriate OC4J instance, click the <span class="bold">Administration</span> tab, click <span class="bold">Edit Server Properties</span>, and then scroll down to the bottom of the page and click <span class="bold">Trace Properties</span>.</p><p>(Bug 5439369)</p></div><!-- class="sect3" --><div class="sect3"><!-- infolevel="all" infotype="General" --><a id="sthref72" name="sthref72"></a><h4 class="sect3">Deployment Procedure Fails to Restart the Web Tier</h4><p>When you try the deployment procedure using Grid Control to restart the web tier, the procedure may end successfully with the message that the web tier has been restarted, but it may not actually restart the web tier.</p><p>To resolve this issue, you have to modify the directive <code>manuallymanagedclusterconfig.pl</code> before executing of the deployment procedure.</p><p>To modify the directive <code>manuallymanagedclusterconfig.pl</code>, follow these steps:</p><ol type="1" start="1"><li><p>In the Grid Control console, click <span class="bold">Deployments</span> to navigate to the Deployments page.</p></li><li><p>On the Deployments page, click <span class="bold">Provisioning</span> and select the <span class="bold">Directives</span> tab.</p></li><li><p>From the table, select <span class="bold">Directives</span>, then select <span class="bold">Oracle Directives</span>, then select <span class="bold">myJ2EECompany</span> <span class="bold">Provisioning</span>. Now select <span class="bold">10.1.2.0.2</span> and then select <span class="bold">Configure Manually Managed Cluster</span>.</p></li><li><p>Now click <span class="bold">Edit</span> to reach the Edit Directive page.</p></li><li><p>On the Edit Directive page, click the <span class="bold">Upload File</span> tab.</p></li><li><p>Click the currently associated file <code>manuallymanagedclusterconfig.pl</code> to display the contents.</p></li><li><p>Now copy the contents of that file to an editor (for example: Notepad or Wordpad.)</p></li><li><p>Make the following changes:</p><ul><li type="disc"><p>In the function <code>parseCommandLineParams()</code>, change line number 135, that is <code>$hmpParams{"INSTALL_BASE"} = "true";</code> to <code>$hmpParams{"INSTALL_BASE"} = $ARGV[ $i + 1 ];</code></p></li><li type="disc"><p>Similarly, change line number 140, that is <code>$hmpParams{"VIRTUAL_HOST"} = "true";</code> to <code>$hmpParams{"VIRTUAL_HOST"} = $ARGV[ $i + 1 ];</code></p></li></ul></li><li><p>Save the modified file to your local machine as <code>manuallymangedclusterconfig.pl</code>.</p></li><li><p>In the Grid Control console, on the Edit Directive page where you see the currently associated file under the Upload File tab, select <span class="bold">Upload from Local Machine</span>.</p></li><li><p>Select <span class="bold">Browse</span> and upload the file <code>manuallymangedclusterconfig.pl</code> that was saved in step 9.</p></li><li><p>Select <span class="bold">Finish</span>.</p></li></ol><p>(Bug 5684224)</p></div><!-- class="sect3" --></div><!-- class="sect2" --><div class="sect2"><!-- infolevel="all" infotype="General" --><a id="sthref73" name="sthref73"></a><h3 class="sect2">Identity Management Issues</h3><p>This section addresses identity management issues.</p><div class="sect3"><!-- infolevel="all" infotype="General" --><a id="sthref74" name="sthref74"></a><h4 class="sect3">Infrastructure Performance Charts of an Identity Federation Server Have No Value</h4><p>When you access the <span class="bold">Infrastructure Performance</span> tab of an Identity Federation System, and select <span class="bold">Real Time: Manual Refresh</span> from the <span class="bold">View Data</span> menu to view metric information at real time, the charts appear but the data is not depicted.</p><p>(Bug 5700277)</p></div><!-- class="sect3" --><div class="sect3"><!-- infolevel="all" infotype="General" --><a id="sthref75" name="sthref75"></a><h4 class="sect3">Internal Error Is Thrown While Associating Oracle Identity Manager Targets with Existing Identity Management System</h4><p>Internal exception is found while associating discovered Oracle Identity Manager targets with existing Identity Manager system. Therefore, the discovery of Oracle Identity Manager components fails to complete.</p><p>To resolve this issue, discover the Oracle Identity Manager components by associating them with new Identity Manager system. You can then add these components to an existing system from the Systems tab of the Grid Control console.</p><p>(Bug 5751839)</p></div><!-- class="sect3" --></div><!-- class="sect2" --><div class="sect2"><!-- infolevel="all" infotype="General" --><a id="sthref76" name="sthref76"></a><h3 class="sect2">Siebel Applications Management Issues</h3><p>This section addresses Siebel application management issues.</p><div class="sect3"><!-- infolevel="all" infotype="General" --><a id="sthref77" name="sthref77"></a><h4 class="sect3">Beacon Enhancement Is Not Supported on Microsoft Internet Explorer 7</h4><p>The Beacon Enhancement functionality is not being supported on Microsoft Internet Explorer 7 browser, as Siebel does not support this browser currently for High Interactive applications.</p><p>For more information on the support provided, refer to this site:</p><p><code><a href="http://supportweb.siebel.com/support/private/content/knowledgedocs/enu/SOD/IE7-SOD.pdf">http://supportweb.siebel.com/support/private/content/knowledgedocs/enu/SOD/IE7-SOD.pdf</a></code></p><p>Refer to the "Planned Support for Microsoft Internet Explorer 7 on Windows XP SP2" section. According to this document, the support for High Interactivity applications on Microsoft Internet Exxplorer 7 will be provided in early CYQ207.</p><p>(Bug 5724954)</p></div><!-- class="sect3" --><div class="sect3"><!-- infolevel="all" infotype="General" --><a id="sthref78" name="sthref78"></a><h4 class="sect3">Siebel Service Status Is Always "Down" Even Though the Service Test Runs</h4><p>The Management Agent performs the remote playback functionality. For this, it spawns a browser and replays the recorded script. The Management Agent runs as a Windows service using the system account credentials. If the system account does not have appropriate privileges or permissions, then this functionality is not permitted.</p><p>This particular issue is faced with beacons on Microsoft Windows 2003 Server. So, on these hosts, the status of the application is always shown "Down", and the metrics collected do not have any values. This issue is not faced on Microsoft Windows 2000 and Microsoft Windows XP hosts.</p><p>(Bug 5676927)</p></div><!-- class="sect3" --><div class="sect3"><!-- infolevel="all" infotype="General" --><a id="sthref79" name="sthref79"></a><h4 class="sect3">Siebel Enterprise Discovery Fails, or Only a Subset of Components Are Discovered</h4><p>In Grid Control 10.2.0.3.0 release, support is not provided for monitoring a Siebel server when the total number of enabled Siebel components and component groups in that server is more than 70.</p><p>(Bug 5724329)</p></div><!-- class="sect3" --><div class="sect3"><!-- infolevel="all" infotype="General" --><a id="sthref80" name="sthref80"></a><h4 class="sect3">Issues With Starting and Stopping Siebel Server Components</h4><p>When there are multiple Siebel server installations, if the siebel home directories on which the servers are installed are different on different machines, then you may face issues while starting and stopping the components of a Siebel server.</p><p>Make sure that the installation directories of the siebel servers are identical across all machines. Otherwise, as a workaround, perform your start/stop operations from the server manager utility.</p><p>For information about using the server manager utility, refer to the following document available at:</p><p><code><a href="http://supportweb.siebel.com/support/private/content/Bookshelf/78Siebel/books/SystAdm/SystAdm_SrvrMgrCLI.html#wp1003500">http://supportweb.siebel.com/support/private/content/Bookshelf/78Siebel/books/SystAdm/SystAdm_SrvrMgrCLI.html#wp1003500</a></code></p><p>(Bug 5747767)</p></div><!-- class="sect3" --><div class="sect3"><!-- infolevel="all" infotype="General" --><a id="sthref81" name="sthref81"></a><h4 class="sect3">View Configuration Page Property Navigation Does Not Work</h4><p>The navigation in View Configuration Page for Siebel targets, that is for Siebel Server, Siebel Gateway Server, and Siebel components, does not work.</p><p>To resolve this issue, use the "Show All" option from the navigation menu.</p><p>(Bug 5702824)</p></div><!-- class="sect3" --><div class="sect3"><!-- infolevel="all" infotype="General" --><a id="sthref82" name="sthref82"></a><h4 class="sect3">Newly Added Services Do Not Get Reflected in the Service Dashboard</h4><p>Manually added services do not get reflected in the services dashboard. To resolve this issue, follow these steps:</p><ol type="1" start="1"><li><p>Click <span class="bold">Reports</span>.</p></li><li><p>Select the respective service dashboard and click <span class="bold">Edit</span>.</p></li><li><p>Click <span class="bold">Elements</span> and then click the <span class="bold">Set Parameters</span> link.</p></li><li><p>Add the newly added service and then click <span class="bold">Continue</span>.</p></li><li><p>Click <span class="bold">OK</span>.</p></li></ol><p>(Bug 5718696)</p></div><!-- class="sect3" --><div class="sect3"><!-- infolevel="all" infotype="General" --><a id="sthref83" name="sthref83"></a><h4 class="sect3">Cannot Handle Two Siebel Enterprises with Identical Names</h4><p>Grid Control cannot handle two Siebel Enterprises with identical names.</p><p>(Bug 5654804)</p></div><!-- class="sect3" --><div class="sect3"><!-- infolevel="all" infotype="General" --><a id="sthref84" name="sthref84"></a><h4 class="sect3">Need to Package Release Version of Sarmquery with Management Agent</h4><p>SARM metrics are not getting collected in Siebel 7.7 and 7.8 environments as SARM query executables are not bundled with Siebel 7.7 and 7.8 versions. To resolve this issue, apply the one-off patch for bug 5684381.</p><p>(Bug 5684381)</p></div><!-- class="sect3" --><div class="sect3"><!-- infolevel="all" infotype="General" --><a id="sthref85" name="sthref85"></a><h4 class="sect3">Incorrect Values Shown in Charts</h4><p>The charts that appear on the Siebel Enterprise Home Page show incorrect values.</p><p>(Bug 5747754)</p></div><!-- class="sect3" --></div><!-- class="sect2" --><div class="sect2"><!-- infolevel="all" infotype="General" --><a id="sthref86" name="sthref86"></a><h3 class="sect2">Host Management Issues</h3><p>This section addresses host management issues.</p><div class="sect3"><!-- infolevel="all" infotype="General" --><a id="sthref87" name="sthref87"></a><h4 class="sect3">99% Memory Cosmopolite on Patching 10.2.0.1 OMS to 10.2.0.2</h4><p>After applying the 10.2.0.3 patch on OMS, Grid Control might report 99% memory utilization for the target host.</p><p>To resolve this problem, select <span class="bold">Deployment</span> and click <span class="bold">Refresh Host Configuration</span> on that page. Now, select the related host from the <span class="bold">Available Hosts</span> and click <span class="bold">Refresh Hosts</span>.</p><p>(Bug 5141414)</p></div><!-- class="sect3" --><div class="sect3"><!-- infolevel="all" infotype="General" --><a id="sthref88" name="sthref88"></a><h4 class="sect3">Issues with Microsoft Windows OMS and Management Agent</h4><p>Administration Tab is shown for the Microsoft Windows host targets, even though this feature is supported for RedHat(RHEL4) and Suse Linux (sles9) hosts only. This issue will be addressed in the next Patch Set.</p><p>(Bug 5689719)</p></div><!-- class="sect3" --><div class="sect3"><!-- infolevel="all" infotype="General" --><a id="sthref89" name="sthref89"></a><h4 class="sect3">Message to Instal YAST Patch Is Displayed Even if it Is Installed</h4><p>In case of Full agent install or Patch agent install on RHEL4 or sles9, the UI asks you to install the required components and patches, even if the YaST patch for Suse is already installed.</p><p>To resolve this issue, follow these steps:</p><p>Full agent install on RHEL4 or sles9</p><ul><li type="disc"><p>Bounce the agent by running the following commands:</p><p><code>emctl stop agent</code></p><p><code>emctl start agent</code></p></li></ul><p>Patch agent install on RHEL4 or sles9</p><ul><li type="disc"><p>Bounce the agent by running the following commands:</p><p><code>emctl stop agent</code></p><p><code>emctl start agent</code></p></li><li type="disc"><p>Change the permissions in $ORACLE_HOME/sysman/admin/scripts as follows:</p><p><code>chmod 755 EM*.ycp</code></p><p><code>chmod 755 DiscoverYast2.pl</code></p><p><code>chmod 755 RunYast.sh</code></p></li></ul><p>(Bug 5718456)</p></div><!-- class="sect3" --><div class="sect3"><!-- infolevel="all" infotype="General" --><a id="sthref90" name="sthref90"></a><h4 class="sect3">RedHat Linux Specific Issues with Network Cards</h4><p>On the Network Card page, changing the Name Server IP address under Global DNS Settings does not work. This issue will be fixed in the next Patch Set.</p><p>(Bug 5724608)</p></div><!-- class="sect3" --></div><!-- class="sect2" --><div class="sect2"><!-- infolevel="all" infotype="General" --><a id="sthref91" name="sthref91"></a><h3 class="sect2">Third-Party Application Server Monitoring Issues</h3><p>This section addresses third-party application server monitoring issues.</p><div class="sect3"><!-- infolevel="all" infotype="General" --><a id="sthref92" name="sthref92"></a><h4 class="sect3">Metric Collection Error While Monitoring BEA WebLogic Managed Server Targets</h4><p>While monitoring BEA WebLogic Managed Server targets, you may face metric collection errors. You may see an error message like:</p><pre xml:space="preserve" class="oac_no_warn">weblogic.rmi.extensions.RemoteRuntimeException: Unexpected Exception - with nested exception</pre><p>This error is caused when a Management Agent is used to monitor one application server target that is compatible with one version of JMX, and another application server target that is compatible with another version of JMX. For example, when you monitor BEA WebLogic release 8.1 and BEA WebLogic release 9 using the same Management Agent, you will see this error.</p><p>To resolve this issue, do not use the same Management Agent for monitoring both these targets. Have one Management Agent monitor one target and another one monitor another target.</p><p>(Bug 5458460)</p></div><!-- class="sect3" --><div class="sect3"><!-- infolevel="all" infotype="General" --><a id="sthref93" name="sthref93"></a><h4 class="sect3">Management Agent Should Be Restarted After Discovering Third-Party Application Servers</h4><p>After discovering IBM WebSphere Application Server, IBM WebSphere Application Server Cell, or BEA WebLogic Server Domain, restart the Management Agent. This is required only when you are discovering these third-party application server for the first time.</p><p>(Bug 4451228)</p></div><!-- class="sect3" --><div class="sect3"><!-- infolevel="all" infotype="General" --><a id="sthref94" name="sthref94"></a><h4 class="sect3">Discovery of MQ Target Fails on Microsoft Windows Non-English Edition</h4><p>If IBM MQ Series is installed on Microsoft Windows non-English edition, or on Linux with characterset of OS locale that is neither 'iso88591' nor 'UTF8', then discovering MQ target from Grid Control fails.</p><p>To resolve this issue, install IBM MQ Series on Microsoft Windows English edition or on Linux with OS locale using characterset 'iso88591' or 'utf8'. For example, en_US.iso88591 and zh_CN.utf8.</p><p>(Bug 5722258)</p></div><!-- class="sect3" --></div><!-- class="sect2" --><div class="sect2"><!-- infolevel="all" infotype="General" --><a id="sthref95" name="sthref95"></a><h3 class="sect2">Network Appliance Filer Management Issues</h3><p>This section addresses network appliance filer management issues.</p><div class="sect3"><!-- infolevel="all" infotype="General" --><a id="sthref96" name="sthref96"></a><h4 class="sect3">After Testing The Connection, Clear The Encrypted Fields and Re-Enter Them While Reloading The "Add Target" Page</h4><p>While adding a target on the Agent home page, you may choose to test the connection. While doing so, the test may be successful and you may be able to add the target to Grid Control. However, when you return to that target's home page, you will see metric collection error for the response metric.</p><p>To resolve this issue, when test connection is successful, remove and re-enter the encrypted password before adding the target to Grid Control.</p><p>(Bug 5642074)</p></div><!-- class="sect3" --></div><!-- class="sect2" --></div><!-- class="sect1" --><a id="CJABHCEJ" name="CJABHCEJ"></a><div class="sect1"><h2 class="sect1">Documentation Accessibility</h2><p>Our goal is to make Oracle products, services, and supporting documentation accessible, with good usability, to the disabled community. 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</p><p><code><a href="http://www.oracle.com/accessibility/">http://www.oracle.com/accessibility/</a></code></p><a id="sthref97" name="sthref97"></a><p class="subhead2">Accessibility of Code Examples in Documentation</p><p>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.</p><a id="sthref98" name="sthref98"></a><p class="subhead2">Accessibility of Links to External Web Sites in Documentation</p><p>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.</p><a id="sthref99" name="sthref99"></a><p class="subhead2">TTY Access to Oracle Support Services</p><p>Oracle provides dedicated Text Telephone (TTY) access to Oracle Support Services within the United States of America 24 hours a day, seven days a week. For TTY support, call 800.446.2398.</p></div><!-- class="sect1" --><a id="sthref100" name="sthref100"></a><hr /><p>Oracle Enterprise Manager Grid Control Release Notes, 10<span class="italic">g</span> Release 3 (10.2.0.3.0) for Linux and Microsoft Windows</p><p>B40096-03</p><p>Copyright © 2007, Oracle. All rights reserved.</p><p>The Programs (which include both the software and documentation) contain proprietary information; they are provided under a license agreement containing restrictions on use and disclosure and are also protected by copyright, patent, and other intellectual and industrial property laws. Reverse engineering, disassembly, or decompilation of the Programs, except to the extent required to obtain interoperability with other independently created software or as specified by law, is prohibited.</p><p>The information contained in this document is subject to change without notice. If you find any problems in the documentation, please report them to us in writing. This document is not warranted to be error-free. Except as may be expressly permitted in your license agreement for these Programs, no part of these Programs may be reproduced or transmitted in any form or by any means, electronic or mechanical, for any purpose.</p><p>If the Programs are delivered to the United States Government or anyone licensing or using the Programs on behalf of the United States Government, the following notice is applicable:</p><p>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, use, duplication, disclosure, modification, and adaptation of the Programs, including documentation and technical data, shall be subject to the licensing restrictions set forth in the applicable Oracle license agreement, and, to the extent applicable, the additional rights set forth in FAR 52.227-19, Commercial Computer Software--Restricted Rights (June 1987). Oracle USA, Inc., 500 Oracle Parkway, Redwood City, CA 94065.</p><p>The Programs are not intended for use in any nuclear, aviation, mass transit, medical, or other inherently dangerous applications. It shall be the licensee's responsibility to take all appropriate fail-safe, backup, redundancy and other measures to ensure the safe use of such applications if the Programs are used for such purposes, and we disclaim liability for any damages caused by such use of the Programs.</p><p>Oracle, JD Edwards, PeopleSoft, and Siebel are registered trademarks of Oracle Corporation and/or its affiliates. Other names may be trademarks of their respective owners.</p><p>The Programs may provide links to Web sites and access to content, products, and services from third parties. Oracle is not responsible for the availability of, or any content provided on, third-party Web sites. You bear all risks associated with the use of such content. If you choose to purchase any products or services from a third party, the relationship is directly between you and the third party. Oracle is not responsible for: (a) the quality of third-party products or services; or (b) fulfilling any of the terms of the agreement with the third party, including delivery of products or services and warranty obligations related to purchased products or services. Oracle is not responsible for any loss or damage of any sort that you may incur from dealing with any third party.</p></div><!-- class="ind" --><!-- Start Footer --><div class="footer"><hr /><table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%"><tr><td valign="bottom" width="33%"><table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100"><tr><td> </td></tr></table></td><td class="copyrightlogo"><a href="../../dcommon/html/cpyr.htm"><img class="copyrightlogo" src="../../dcommon/gifs/oracle.gif" alt="Oracle Logo" /><br /><span class="copyrightlogo">Copyright © 2007, Oracle. All rights reserved.</span></a></td><td valign="bottom" align="right" width="33%"><table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="225"><tr><td> </td></tr></table></td></tr></table></div><!-- class="footer" --></body></html>