|
|
 Copyright © 2006, Oracle. All rights reserved. |
|
|
Oracle® Enterprise Manager Management Agent Release Notes for Windows Itanium
10g Release 1 (10.1.0.5) B28849-01 |
|
Management Agent Release Notes for Windows Itanium
10g Release 1 (10.1.0.5)
B28849-01
June 2006
These Release Notes identify differences between the delivered Oracle Enterprise Manager Management Agent for Windows Itanium Release 10.1.0.5 product and its documented functionality.
|
Note: To check for updates to this document and view other Oracle documentation, see the Documentation section on the Oracle Technology Network (OTN) Web site: |
This document contains the following sections:
This section addresses installation and configuration issues.
On Microsoft Windows 2000, installation of Oracle Management Agent (Management Agent) Release 10.1.0.5 (Windows 32-bit) fails if the machine has SAV10 (Symantec Antivirus 10) installed.
To avoid this issue:
Copy the 10.1.0.5 Management Agent to your machine before running setup.exe
Or
Downgrade SAV10 to SAV9, and then run setup.exe
(Bug 4476828)
On Microsoft Windows 2000 with Service Pack 4, Oracle Universal Installer may not start up properly. It may appear and then disappear. This is due to an underlying JRE bug.
To avoid this issue, run this utility:
install\win32\setup.exe -J-Dsun.java2d.noddraw=true
For 10.1 Agent installations, the -noconfig option is not supported. You cannot execute the runInstaller/setup with -noconfig option, and then execute the //OH/cfgtoollogs/configToolCommands, as the execution of configToolCommands is also not supported.
(Bug 4761878)
If you are installing the Management Agent on a host that is running Calendar, you should install it as the operating system user who installed Calendar. If the users are different, then Management Agent will not be able to monitor Calendar.
(Bug 3146883)
Machines with multiple network interfaces and virtual hosts bound to single or multiple network adapters are accessible by more than one IP address. Oracle Enterprise Manager installation for Oracle Management Agent always selects the primary machine alias.
In the configuration section of the agent install, the Secure Agent action may fail if the Oracle Management Service is down or busy processing other requests. You can retry the "Secure Agent" action multiple times from the installer until the Management Agent is secured successfully. Alternatively, complete the installation with this failure, and use the following command at the command line to secure the Management Agent.
% emctl secure agent <reg password>
If the existing Management Agent host name remains unchanged but resolves to a new IP address, then no changes are required. However, if the Management Agent host is assigned a new machine name (a new primary alias that resolves to the current IP address or a new IP address), then follow these steps to rename the Management Agent on the managed node.
Create a backup of the existing targets.xml file.
Edit the existing targets.xml file, replacing the old host name with the new host name.
Modify the Management Agent configuration file. Edit the EMD_URL property in the following file to reflect the new host name:
$ORACLE_HOME/sysman/config/emd.properties
Restart the Management Agent.
Verify that the new host name appears in the Enterprise Manager console along with its associated targets.
|
Note:
|
You can change the listen port of a Management Agent by editing the EMD_URL property in the $OH/sysman/config/emd.properties file.
|
Note: In a RAC environment, theemd.properties file will be under $ORACLE_HOME/<HOSTNAME>/sysman/config directory.
|
If you do this for the Management Agent that has already been secured, you will have to re-secure the Management Agent (via emctl secure agent). If you do not re-secure the Management Agent, the agent uploads to Oracle Management Service will fail, - data will back up at the Management Agent, and Oracle Management Service will not be able to contact the Management Agent to retrieve real-time metric values.
(Bug 2814831)
If you launch emctl in a non-English environment, make sure that the default locale and NLS_LANG settings of the operating system are configured properly.
(Bug 3128644)
Make sure LC_ALL or LANG environment variables are set with the appropriate value. To check the current setting, issue the locale command "% locale." For specific value in each operating system, refer to the platform-specific documents.
Make sure NLS_LANG environment variable is set with the appropriate value, a value that is compatible with the operating system's default locale setting and the repository database character set. For specific values for the language or the character set, refer to the Globalization Support Guide of the Oracle product you are using. On Microsoft Windows, use the default NLS_LANG setting in the registry.
If you remove (uninstall) Enterprise Manager ORACLE_HOME directory using Oracle Universal Installer, it unregisters the directory from the central inventory and the oratab file. It may, however, leave some files within that directory. Once the ORACLE_HOME directory is successfully removed (this can be verified using Oracle Universal Installer by clicking on the "Installed products" button), you can manually delete these files using appropriate commands on the operating system. Follow these steps to uninstall:
Shut down the Management Agent in the agent home using the command "emctl stop agent".
Run Oracle Universal Installer and select the ORACLE_HOME to uninstall it. It will then be removed from the central inventory.
Remove the remaining files from the ORACLE_HOME directory by using the appropriate operating system commands.
This section addresses operational issues.
The Management Agent installation does not discover cluster database targets out-of-the-box.
To discover cluster database targets, after installing the Management Agent, run the Add Database Target wizard from Targets -> Databases -> Add.
If the data from Management Agent is not uploaded to Oracle Management Service, review the agent trace file to identify the problem.
The agent trace file is available at:
$ORACLE_HOME/sysman/log/emagent.trc
In this file, look for messages with the string "ERROR upload:". If Oracle Management Service is overloaded and takes more time than expected to load the files, then you should see entries like these:
2003-10-31 15:48:45 Thread-1499 ERROR upload: FxferSend: HTTP Error=-2 reading request response from: http://ap401ses.us.oracle.com:4889/em/upload/ 2003-10-31 15:48:45 Thread-1499 ERROR upload: Failed to upload file A0000002.xml , ret = -2
If you see similar entries, access the httpd.conf file and increase the timeout value of the Apache server. This file is available at:
$OH/Apache/Apache/conf/httpd.conf
In this file, change the Timeout setting from "Timeout 300" to "Timeout 600".
Then restart Oracle Management Service for the new settings to take effect. The system will now not timeout within a short duration as it used to in the past. The increased timeout value will help the system retry the operation until the data is successfully loaded or until the increased timeout value is reached.
If you are configuring more than one application server home for central management by using the same Management Agent, then an internal file "targets.xml" can get accidentally deleted.In the event that this happens, you can recover all application server targets by following these steps:
Remove the centralagents.lst file, if any, from the application server home located under sysman/emd.
Create a new targets.xml file under sysman/emd of the Management Agent home directory with the following entry:
<Targets> <Target TYPE="host" NAME="<hostname>"/> </Targets>
where <hostname> is the full hostname.
For example:
my-sun.us.oracle.com
Reload the Management Agent by running "emctl reload agent" from the Management Agent home directory.
Reconfigure the application server home from the Application Server Control Infrastructure tab.
By doing so, you restore all application server homes to the internal file "targets.xml". However, targets that do not belong to the application server home do not get recovered. To recover those targets, perform a manual discovery.
(Bug 3678671)
On Microsoft Windows, if you are deleting a database target from a centrally managed home using DBCA, your change may not be fully propagated to Management Agent.
To resolve this issue, explicitly delete the database target from the Management Agent's home using Enterprise Manager Grid Control.
(Bug 3488516)
On Microsoft Windows 2000 and Windows 2003, the Management Agent accesses floppy drives periodically. However, on Microsoft Windows XP, there is no such problem.
This problem has been identified as an issue with Microsoft's DLL file (perfdisk.dll). Microsoft has released hotfixes to address this issue. Details of this issue and hotfixes are available at:
http://support.microsoft.com/default.aspx?scid=kb;en-us;842900
(Bug 519087)
If you are running the Management Agent on Microsoft Windows NT 4.0 host, you may find that the Management Agent does not shut down or recover gracefully from a timeout. This may lead to an inconsistency between the status reported by emctl and the status reported by the Microsoft Windows service control manager.
To avoid this issue, use the following internal command to shut down the Management Agent.
emctl istop agent
You may then bring up the Management Agent using your Microsoft Windows service control manager.
(Bug 3320183)
This section addresses issues related to blackouts.
"Operator" privileges are required to black out a group. By default, "Operator" privileges for a group are not automatically granted to the creator of a group.
So if you create a group and decide to black out that group later, you should ensure that you have "Operator" privileges for that operation. You can request the Enterprise Manager superuser to grant you those privileges on the group.
The start of an immediate, one-time blackout or the first occurrence of recurring blackout with an immediate start time may be postponed by up to 2 minutes.
The goal is to use the target's time as the blackout start time, and the target's time, in turn, is determined based on its monitoring Management Agent's last heartbeat time to the Oracle Management Service.
The additional 2 minutes are added by Oracle Management Service to the Management Agent's heartbeat time to accommodate any network delays in receiving such heartbeat information. This time is then used as the blackout start time.
This calculation was specifically designed to ensure proper handling of potential metric severities pending from the Management Agent. Because blackouts suspend monitoring, severities that have a timestamp before the official blackout start time will be retained; others will be discarded.
(Bug 3299198)
After a blackout on a target ends, Enterprise Manager re-evaluates the target status. During this brief evaluation period, users may see the target in either "Agent Unreachable" state (for host targets) or "Status Pending" state (for non-host targets). These states are temporary and will be resolved once the true status of the target is determined.
(Bug 3317976)
An Enterprise Manager administrator needs at least "Operator" privileges on a target to be able to black out the target. The Create Blackout page displays only targets for which the current Enterprise Manager administrator has at least "Operator" privileges. When creating a blackout, if no targets are available for selection, then it means that the administrator does not have "Operator" privileges on any target.
To resolve this, the administrator should request the Enterprise Manager super administrator (that is administrator with superuser privileges) for "Operator" privileges on the targets that need to be blacked out.
When creating a blackout, a "reason" for the blackout must be specified. Only Enterprise Manager administrators with superuser privileges (super administrators) can create a "reason" during blackout creation.
When creating a blackout, if the appropriate value for "reason" is not available for selection, request the Enterprise Manager super administrator to create the reason by creating a "dummy" blackout that has the appropriate reason in it. The dummy blackout can be, for example, a future blackout for any target. As soon as the dummy blackout is created, the reason has also been created. At that point, the Enterprise Manager super administrator should stop and delete the dummy blackout. Make sure the dummy blackout does not actually start and is deleted because a blackout will stop monitoring the targets under blackout, and will appear in the target's availability records.
(ER 3145500)
Daylight savings time is not supported for blackouts. You have to manually adjust the schedule of a blackout, as needed, to accommodate schedule changes due to daylight savings time.
When a blackout is submitted and the Oracle Management Service is down for the entire duration of the blackout, and no severities come in for a target during the blackout window, the blackout window will be compressed to a one-second window in the availability history. Note that this does not cause any unnecessary notifications to be sent, because it happens only when no severities are generated for the target during the blackout.
(Bug 3317965)
This section addresses issues relating to monitoring the system.
If the name specified for the database User-Defined Metric is more than 30 characters, then the metric is not evaluated properly.
Ensure that the metric name is not more than 30 characters.
(Bug 3301697)
If the evaluation of a User-Defined Metric results in an error, then there is no return value associated with the metric in the User-Defined Metrics page.
Access the Errors subtab of the Alerts tab to get information about the metric error.
(Bug 3301699)
If you delete a User-Defined Metric that is still in warning or critical alert, then the alert still remains.
Make sure the User-Defined Metric is in the "clear" state before deleting it.
(Bug 3301704)
If a target is currently in the "Agent Unreachable" state, then on the Availability page for that target, this "Agent Unreachable" state is shown in "white" (that is no color) in the bar graph that represents the target's availability over time.
Typically, the "Agent Unreachable" state is reached if there are network problems between the Oracle Management Service and the Management Agent that is monitoring the target, making the true target status unavailable for display in the console.
Once the target is out of the "Agent Unreachable" state, the "Agent Unreachable" period is replaced in the bar graph with the appropriate status of the target (up, down, and so on.)
(Bug 3152217)
Response Actions do not work for server-generated alerts. (Bug 3129353)
Response Actions for metrics can be specified in the Console only by Enterprise Manager users with superuser privileges.
When specifying a Response Action script for the Target Down condition, be careful when saving your entry. Specifically, after you enter the Response Action script, click OK. This brings you back to the Edit Thresholds page.
On the Edit Threshold page, click Cancel, and not OK. If you click OK, your Response Action script entry may not have been saved (Bug 3465495). However, clicking Cancel may result in not saving any other changes to the Edit Thresholds page.
Hence, if you are making changes other than specifying a Response Action script, make sure you save these other changes first (by clicking OK on the Edit Thresholds page), and then enter the Response Action script later as indicated.
If you are running the Management Agent on a Microsoft Windows NT 4.0 host with more than 2 GB of RAM, you may find that certain host metrics related to host memory are inaccurate.
(Bug 3294952)
In some cases, when you display a metric on the Metric Detail Page and click Help on that page, the help window displays the Table of Contents of the help system, and not the appropriate help topic for that metric.
In this situation, the workaround is to choose one of the real-time options from the View Data menu, and then click Help to view the appropriate help topic.
(Bug 3341196)
You may see errors such as: "An internal error has occurred" or "Error getting data for target {target-name}. Exception: null" when Enterprise Manager tries to display a page showing real-time metrics for a target that was deleted and recreated.
This may occur if you discover a target such as an application server, then remove it and rediscover it. If you see these errors, stop and restart the Management Agent monitoring the target:
{agent-home}/bin/emctl stop agent {agent-home}/bin/emctl start agent
(Bug 3381701)
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 http://www.oracle.com/accessibility/.
Accessibility of Code Examples in Documentation
Screen readers may not always correctly read the code examples in this document. The conventions for writing code require that closing braces should appear on an otherwise empty line; however, some screen readers may not always read a line of text that consists solely of a bracket or brace.
Accessibility of Links to External Web Sites in Documentation
This documentation may contain links to Web sites of other companies or organizations that Oracle does not own or control. Oracle neither evaluates nor makes any representations regarding the accessibility of these Web sites.
TTY Access to Oracle Support Services
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.
Oracle Enterprise Manager Management Agent Release Notes for Windows Itanium, 10g Release 1 (10.1.0.5)
B28849-01
Copyright © 2006, Oracle. All rights reserved.
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.
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.
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:
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
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.
Oracle, JD Edwards, PeopleSoft, and Retek are registered trademarks of Oracle Corporation and/or its affiliates. Other names may be trademarks of their respective owners.
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.