Contents

List of Examples

List of Figures

List of Tables

Title and Copyright Information

Preface

• Intended Audience
• Purpose of the Document
• Documentation Accessibility
• Related Documents
• Conventions

1 Getting Started with Enterprise Manager Grid Control

• Enterprise Manager's Ready-To-Use Configuration
  • Default Super Administrator: SYSMAN
  • E-mail Notifications
  • Notification Rules
  • Automatic Discovery
    • Troubleshooting Issues Concerning Target Discovery
• Using the Enterprise Manager Grid Control Console for the First Time
  • Enabling or Disabling the Licensed Function
• Controlling the Management Repository, Service, and Agent
  • Starting the Management Repository Database
  • Starting and Stopping the OMS
  • Starting and Stopping the Management Agent
  • Starting Oracle Application Server Console
  • Accessing Oracle Application Server Console from Enterprise Manager Grid Control Console
  • Accessing Enterprise Manager Grid Control
  • Unlock the DBSNMP User Account
  • Set Monitoring Credentials
    • Setting Monitoring Credentials for Database Targets
    • Setting Monitoring Credentials for ASM Targets
  • Privileges Required for Accessing the Database Performance Tab

Part I Overview and Preinstallation

2 Overview of Enterprise Manager Grid Control

• Grid Control Overview
• Grid Control Architecture

3 Preinstallation Requirements

• Hardware Requirements
  • Recommended CPU and Memory Allocation
  • Temporary Disk Space Requirements on HP-UX
  • Temporary Disk Space Requirements on IBM AIX
  • Considering Resource Allocation
• Operating System, Browser, Target Certification
• Software Requirements
  • Oracle Management Repository Software Requirements
  • Oracle Management Service Software Requirements
  • Oracle Management Agent Software Requirements
• Network Requirements
  • Proximity
  • Host File with Correct Host Name and IP Address
  • Server Name Dependent on the Order of the IP Address Entry
• UMASK Value Requirements
• Operating System Groups and Users Requirements
  • For All Installation Types
  • For The Installation Type "Enterprise Manager Grid Control with a New Database"
  • How To Create Operating System Groups and Users
    • Creating the Oracle Inventory Group
    • Creating the OSDBA Group
    • Creating an OSOPER Group (Optional)
    • Creating the Oracle Software Owner User

4 Things to Know Before Installation

• Understanding What This Guide Helps You Install and Upgrade
• Obtaining Software from Oracle Technology Network
  • Verifying the Downloaded Software
  • Extracting Software from the Zip Files
• Starting Oracle Universal Installer (OUI)
• Understanding Licensing Information
• Understanding Oracle Directory
• Multiple Oracle Home Support
• Installing in an Existing Oracle Home
• Installing Enterprise Manager Grid Control As the First Oracle Software
  • Installing Additional Languages
• Knowing About the Ports Used for Installation
• Understanding Passwords and Restrictions
• Understanding Permissions Required for Executing UTL_FILE
• Understanding Limitations with DHCP-Enabled Machines
• Logging In As Root During Installation (UNIX Only)?
  • Running root.sh During Installation (UNIX Only)
• Understanding Enterprise Manager Grid Control Configuration Plug-in (EMCP)
• Understanding Prerequisite Checks
• Running the Prerequisite Check in Standalone Mode

Part II Installing Enterprise Manager Grid Control

5 Overview of the Installation Process

• Installing and Configuring the Full Release, and then Patching
• Installing Only the Software Binaries of Full Release, and then Patching

6 Accessing the Installation Software

• Accessing the Software from a Remote DVD Drive (UNIX Only)
  • Setting the Mount Point for the DVD-ROM on Linux
  • Setting the Mount Point for the DVD-ROM on AIX
• Accessing the Software on Remote Hosts Using Remote Access Software
  • Installing from a Hard Drive
  • Installing from a Remote DVD Drive
• Downloading Management Agent Software Using Grid Control Console
• Using Oracle Universal Installer
  • Specifying a Temporary Directory
  • Starting the Installer

7 Using Oracle Universal Installer

• Specifying a Temporary Directory
• Starting the Installer

8 Installing Enterprise Manager Grid Control

• Understanding the Installation Types
• Accessing the Installer
• Installing Enterprise Manager Grid Control Using a New Database
  • Overview
  • Before You Begin
  • Prerequisites
  • Installing Procedure
• Installing Enterprise Manager Grid Control Using an Existing Database
  • Overview
  • Before You Begin
  • Prerequisites
    • Check Database Initialization Parameters
  • Installation Procedure
    • Configuration Assistant
  • Installing on Microsoft Windows 2008 and Microsoft Windows Vista
• Installing an Additional Management Service
  • Overview
  • Scenarios
  • Before You Begin
  • Prerequisites
    • Using the Same User Name, UID, and GID
  • Installation Procedure
  • Installing an Additional Management Service on Microsoft Windows 2008 or Microsoft Vista
  • Installing Additional Management Service in a 10.2.0.2 or 10.2.0.3 Environment
• Installing 'Software-Only' and Configuring Later
  • Overview
  • Installing 'Software-Only' and Configuring Later (Silent Mode)
    • Installing Enterprise Manager Grid Control Using a New Database
    • Installing Enterprise Manager Grid Control Using an Existing Database
    • Installing Additional Management Service
    • Installing Enterprise Manager 10g Grid Control Release 5 (10.2.0.5) Using Existing Oracle Database 11g
    • Installing Additional Management Service Using Existing Oracle Database 11g
  • Installing 'Software-Only' and Configuring Later (GUI Mode)
    • Installing Enterprise Manager Grid Control Using an Existing Database
    • Installing Additional Management Service
  • Installing 'Software-Only' and Configuring Later (Silent Mode) on Newly Supported Platforms
    • Installing Enterprise Manager 10g Grid Control Release 5 (10.2.0.5) Using Existing Database
    • Installing an Additional Oracle Management Service Release 5 (10.2.0.5)

9 Installing Enterprise Manager Grid Control in Silent Mode

• Available Response Files
• Running Response Files
• Silent Installation Process
• Using Silent Mode to Install Enterprise Manager Grid Control Using a New Database
• Using Silent Mode to Install Enterprise Manager Grid Control Using an Existing Database
• Using Silent Mode to Install Additional Management Service

10 Deploying Management Agent

• Installing Management Agent Using Agent Deploy Application
  • Overview
  • Prerequisites
  • Configurations Required for Management Agent to Communicate with Oracle Management Service with Server Load Balancer
  • Installation Procedure
    • Fresh Installation of the Management Agent
    • Installation Using a Shared Agent Home
• Installing Management Agent Using nfsagentinstall Script
  • Overview
  • Prerequisites
  • Installation Procedure
    • Usage of the nfsagentinstall Script
• Installing Management Agent Using agentDownload Script
  • Overview
  • Benefits of Using the Script
  • Prerequisites
  • Downloading the Script
  • Installation Procedure
  • Installing on a Cluster
  • Customizing the agentDownload Script
  • Downloading Management Agent Software for Different Platforms
• Installing Management Agent Using OUI
  • Overview
  • Prerequisites
  • Installation Procedure

11 Deploying Management Agent in Silent Mode

• Available Response Files
• Running Response Files
• Silent Installation Process
• Using Silent Mode to Install Additional Management Agent
  • Setting Up Proxy Configuration for the Management Agent

12 Deploying Management Agent on a Cluster

• Installing Management Agent on Each Node of a Cluster, Individually
  • Installing Management Agent on Release 9.2 Cluster
    • Using the agentDownload Script
    • Using the Agent Deploy Application
    • Using Oracle Universal Installer
  • Installing Management Agent on Oracle Clusterware
    • Using agentDownload Script
    • Using the Agent Deploy Application
    • Using Oracle Universal Installer
• Installing Management Agent on Many Nodes of a Cluster, in One Installation
  • Installing Management Agent on Release 9.2 Cluster
    • Using the agentDownload Script
    • Using the Agent Deploy Application
    • Using Oracle Universal Installer
  • Installing Management Agent on Oracle Clusterware
    • Using the agentDownload Script
    • Using the Agent Deploy Application
    • Using Oracle Universal Installer

13 Cloning Management Agent

• Cloning Management Agent Using Grid Control Console
  • Prerequisites for Cloning Management Agent
  • Cloning Management Agent
    • Running root.sh Script Manually
• Cloning Management Agent Using Command Line
  • Cloning Management Agent Installed with OMS or As Additional Agent
  • Logs to Review if Cloning Fails
• Cloning Management Agent on a Cluster

14 Prerequisites for Installing Enterprise Manager Grid Control on Oracle RAC

• Preinstallation Requirements
  • Configure Oracle Cluster Synchronization Services (CSS)
  • Certification for Agents on Oracle Real Application Clusters (Oracle RAC)
  • Additional Software Requirements for Management Agent Installation on Clusters
    • Oracle Clusterware/Vendor Clusterware
  • Preinstallation Tasks for Oracle Real Application Clusters

Part III Postinstallation Configuration

15 Postinstallation Configuration Tasks

• Running Configuration Scripts After the Installation Process (UNIX Only)
  • For Silent Installations
  • For agentDownload Script-Based Installations
• Checking Database Settings
  • UNDO Tablespace and Temporary Tablespace
  • Archive Logging
  • Ensure the Database is Not in QUIESCE Mode
• Accessing My Oracle Support (formerly Metalink) Web Site
  • Accessing Management Packs
    • Impact of Management Packs on Targets
  • Optional Configurations
    • Specifying the My Oracle Support (formerly Metalink) Credentials
    • Setting Up Proxy Configuration for the OMS
• Configuring Database and ASM Targets for Monitoring
• Exporting Environment Variable for Starting and Stopping Agent
• Reconfiguring and Rediscovering Agent
  • Rediscover and Reconfigure Targets on Standalone Agents
  • Reconfiguring a Standalone Agent to an Oracle RAC Agent
  • Reconfiguring an Existing RAC Agent
  • Rediscovering Targets on a Oracle RAC Agent
• Installing 'Clone Support Files' After Patching
• Restarting OMS Whenever Management Agent IP Adress Changes

Part IV Advanced Enterprise Manager Configuration

16 Introduction to Enterprise Manager Advanced Configuration

• Types of Advanced Configuration Tasks
• Understanding the Enterprise Manager Directory Structure
  • Understanding the Enterprise Manager Directories Installed with Oracle Enterprise Manager 10g Grid Control
    • About the Oracle Management Service Home Directory
    • About the Oracle Management Agent Home (AGENT_HOME) Directory
    • Summary of the Important Directories in the Management Service Home
  • Understanding the Enterprise Manager Directories Installed with the Management Agent
    • Summary of the Important Directories in the Management Agent Home
    • Understanding the Management Agent Directory Structure on Windows
  • Understanding the Enterprise Manager Directories Installed with Oracle Application Server
  • Understanding the Enterprise Manager Directories Installed with Oracle Database 10g
  • Tip for Identifying the Oracle Home When Using the emctl Command
  • Configuring Database Console During and After the Oracle Database 10g Installation
    • Configuring Database Console During Installation
    • Configuring Database Console with DBCA
    • Configuring Database Console with EMCA
    • Using an Input File for EMCA Parameters
    • Using EMCA with Oracle Real Application Clusters
    • Specifying the Ports Used By the Database Console
    • EMCA Troubleshooting Tips
  • Deconfiguring Database Control
• Enabling Enterprise Manager Accessibility Features
  • Enabling Enterprise Manager Accessibility Mode
  • Providing Textual Descriptions of Enterprise Manager Charts

17 Grid Control Common Configurations

• About Common Configurations
• Deploying Grid Control Components on a Single Host
• Managing Multiple Hosts and Deploying a Remote Management Repository
• Using Multiple Management Service Installations
  • Understanding the Flow of Management Data When Using Multiple Management Services
  • Determining When to Use Multiple Management Service Installations
    • Monitoring the Load on Your Management Service Installations
    • Monitoring the Response Time of the Enterprise Manager Web Application Target
• High Availability Configurations - Maximum Availability Architecture
  • Configuring the Management Repository
    • Post Management Service - Install Management Repository Configuration
  • Configuring the Management Services
    • Management Service Install Location
    • Configure Management Service to Management Repository Communication
    • Configure Management Service to Direct Traffic Through SLB
  • Installing Additional Management Services
    • Configuring Shared File Areas for Management Services
  • Configuring a Load Balancer
    • Configuring Oracle HTTP Server When Using a Load Balancer for the Grid Control Console
    • Configuring Console URL
    • Understanding the Flow of Data When Load Balancing the Grid Control Console
  • Configuring the Management Agent
    • Load Balancing Connections Between the Management Agent and the Management Service
  • Disaster Recovery
    • Prerequisites
    • Setup Standby Database
    • Setup Standby Management Service
    • Switchover
    • Failover
    • Automatic Failover
• Installation Best Practices for Enterprise Manager High Availability
  • Configuring the Management Agent to Automatically Start on Boot and Restart on Failure
  • Configuring Restart for the Management Agent
  • Installing the Management Agent Software on Redundant Storage
  • Install the Management Service Shared File Areas on Redundant Storage
• Configuration With Grid Control
  • Console Warnings, Alerts, and Notifications
  • Configure Additional Error Reporting Mechanisms
  • Component Backup
  • Troubleshooting
    • Upload Delay for Monitoring Data
    • Notification Delay of Target State Change

18 Configuring Oracle Enterprise Manager for Active and Passive Environments

• Using Virtual Host Names for Active and Passive High Availability Environments in Enterprise Manager Database Control
  • Set Up the Alias for the Virtual Host Name and Virtual IP Address
  • Set Up Shared Storage
  • Set Up the Environment
  • Ensure That the Oracle USERNAME, ID, and GROUP NAME Are Synchronized on All Cluster Members
  • Ensure That Inventory Files Are on the Shared Storage
  • Start the Installer
    • Windows NT Specific Configuration Steps
  • Start Services
• Configuring Grid Control Repository in Active/Passive High Availability Environments
  • Installation and Configuration
  • Set Up the Virtual Host Name/Virtual IP Address
  • Set Up the Environment
  • Synchronize Operating System User IDs
  • Set Up Inventory
  • Install the Software
    • Windows NT Specific Configuration Steps
  • Startup of Services
  • Summary
• How to Configure Grid Control OMS in Active/Passive Environment for High Availability Failover Using Virtual Host Names
  • Overview and Requirements
  • Installation and Configuration
  • Setting Up the Virtual Host Name/Virtual IP Address
  • Setting Up Shared Storage
  • Setting Up the Environment
  • Synchronizing Operating System IDs
  • Setting Up Shared Inventory
  • Installing the Software
    • Windows Specific Configuration Steps
  • Starting Up Services
  • Summary
• Configuring Targets for Failover in Active/Passive Environments
  • Target Relocation in Active/Passive Environments
  • Installation and Configuration
    • Prerequisites
    • Configuration Steps
  • Failover Procedure
  • Fallback Procedure
  • EM CLI Parameter Reference
  • Script Examples
    • Relocation Script
    • Start Listener Script
    • Stop Listener Script
• Configuring Additional Oracle Enterprise Management Agents for Use in Active and Passive Environments
  • Installation and Configuration
  • Switchover Steps
  • Performance Implications
  • Summary

19 Enterprise Manager Security

• About Oracle Enterprise Manager Security
  • Oracle Enterprise Manager Security Model
  • Classes of Users and Their Privileges
  • Resources Protected
  • Authorization and Access Enforcement
  • Leveraging Oracle Application Server Security Services
  • Leveraging Oracle Identity Management Infrastructure
• Configuring Security for Grid Control
  • About Enterprise Manager Framework Security
  • Overview of the Steps Required to Enable Enterprise Manager Framework Security
  • Enabling Security for the Oracle Management Service
    • Checking the Security Status
  • Enabling Security for the Oracle Management Agent
  • Enabling Security with Multiple Management Service Installations
  • Restricting HTTP Access to the Management Service
  • Managing Agent Registration Passwords
    • Using the Grid Control Console to Manage Agent Registration Passwords
    • Using emctl to Add a New Agent Registration Password
  • Enabling Security with a Server Load Balancer
  • Enabling Security for the Management Repository Database
    • About Oracle Advanced Security and the sqlnet.ora Configuration File
    • Configuring the Management Service to Connect to a Secure Management Repository Database
    • Enabling Oracle Advanced Security for the Management Repository
    • Enabling Security for a Management Agent Monitoring a Secure Management Repository or Database
  • Configuring Third Party Certificates
    • Configuring Third Party Certificate for HTTPS Upload Virtual Host
    • Configuring Third Party Certificate for HTTPS Apache Virtual Host
• Configuring Security for the Enterprise Manager Application Server Control
• Configuring Security for the Database Control
• Enterprise Manager User Administration
  • Creating / Modifying Administrators
  • Configuring Enterprise Manager for Use with Oracle Application Server Single Sign-On
    • Configuring Enterprise Manager to Use the Single Sign-On Logon Page
    • Registering HTTP Port With Single Sign On Server
    • Configuring Enterprise Manager to Use Single Sign-On with the osso.conf File
    • Registering Single Sign-On Users as Enterprise Manager Administrators
    • Creating Single Sign-On Users Using EMCLI
    • Grid Control as a Single Sign-On Partner Application
    • Bypassing the Single Sign-On Logon Page
  • Configuring Enterprise Manager for Use with Enterprise User Security
    • Registering Enterprise Users as Enterprise Manager Users
    • Using EMCLI to Create Enterprise Manager Users of Type Enterprise Users
  • Changing SYSMAN and MGMT_VIEW User Passwords
    • Changing the SYSMAN User Password
    • Changing the MGMT_VIEW User Password
• Setting Up the Auditing System for Enterprise Manager
  • Configuring the Enterprise Manager Audit System
    • Enabling and Disabling Auditing Using emcli Commands
    • Enabling and Disabling Auditing Using PL/SQL
  • Configuring the Audit Data Export Service
  • Searching the Audit Data
• Configuring the emkey
  • Generating the emkey
  • emctl Commands
    • emctl status emkey
    • emctl config emkey -repos
    • emctl config emkey -emkeyfile
    • emctl config emkey -emkey
    • emctl config emkey -remove_from_repos
    • emctl config emkey -copy_to_repos
  • Install and Upgrade Scenarios
    • Installing the Management Repository
    • Installing the First Oracle Management Service
    • Installing Additional Oracle Management Service
    • Upgrading from 10.1 to 10.2
    • Recreating the Management Repository
• Additional Security Considerations
  • Responding to Browser-Specific Security Certificate Alerts
    • Responding to the Internet Explorer Security Alert Dialog Box
    • Responding to the Netscape Navigator New Site Certificate Dialog Box
    • Preventing the Display of the Internet Explorer Security Information Dialog Box
  • Configuring Beacons to Monitor Web Applications Over HTTPS
• Other Security Features
  • Using ORACLE _HOME Credentials
  • Patching Oracle Homes When the User is Locked
  • Cloning Oracle Homes
  • Using the sudo Command

20 Configuring Enterprise Manager for Firewalls

• Considerations Before Configuring Your Firewall
• Firewall Configurations for Enterprise Management Components
  • Firewalls Between Your Browser and the Grid Control Console
  • Configuring the Management Agent on a Host Protected by a Firewall
    • Configuring the Management Agent to Use a Proxy Server
    • Configuring the Firewall to Allow Incoming Communication From the Management Service
  • Configuring the Management Service on a Host Protected by a Firewall
    • Configuring the Management Service to Use a Proxy Server
    • About the dontProxyfor Property
    • Configuring the Firewall to Allow Incoming Management Data From the Management Agents
  • Firewalls Between the Management Service and the Management Repository
  • Firewalls Between the Grid Control and a Managed Database Target
  • Firewalls Used with Multiple Management Services
  • Configuring Firewalls to Allow ICMP and UDP Traffic for Beacons
  • Configuring Firewalls When Managing Oracle Application Server
• Viewing a Summary of the Ports Assigned During the Application Server Installation
• Additional Considerations for Windows XP

21 Reconfiguring the Management Agent and Management Service

• Reconfiguring the Oracle Management Agent
  • Configuring the Management Agent to Use a New Management Service
  • Securing the Management Agent
  • Changing the Management Agent Port
  • Controlling the Amount of Disk Space Used by the Management Agent
  • About the Management Agent Watchdog Process
  • Setting the Management Agent Time Zone
    • Understanding How the Management Agent Obtains Time Zone Information
    • Resetting the Time Zone of the Management Agent Due to Inconsistency of Time Zones
    • Troubleshooting Management Agent Time Zone Problems
    • Troubleshooting Management Service Time Zone Problems
  • Adding Trust Points to the Management Agent Configuration
• Reconfiguring the Oracle Management Service
  • Configuring the Management Service to Use a New Management Repository
    • Changing the Repository Properties in the emoms.properties File
    • About Changing the Repository Password
  • Configuring the Management Service to Use a New Port
  • Configuring the Management Service to Prompt You When Using Execute Commands

22 Additional Configuration Tasks

• Understanding Default and Custom Data Collections
  • How Enterprise Manager Stores Default Collection Information
  • Restoring Default Collection Settings
• Enabling Multi-Inventory Support for Configuration Management
  • AGENT_HOME Versus AGENT_STATE Directories
• Manually Configuring a Database Target for Complete Monitoring
• Modifying the Default Login Timeout Value
• Configuring Clusters and Cluster Databases in Grid Control
  • Configuring Clusters
  • Configuring Cluster Databases
  • Discovering Instances Added to the Cluster Database
    • Troubleshooting
• Collecting Client Configurations
  • Configuring the Client System Analyzer
    • Client System Analyzer in Oracle Grid Control
    • Deploying Client System Analyzer Independently
  • Configuration Parameters
    • Associating the Parameters with an Application
  • Rules
  • Customization
  • CSA Deployment Examples
    • Using Multiple Collection Tags
    • Privilege Model for Viewing Client Configurations
    • Using the Customization API Example
    • Using the CSA Servlet Filter Example
    • Sample Deployments
• Setting Up and Configuring a Software Library With Oracle Enterprise Manager
  • Setting Up a Software Library
  • Configuring a Software Library
  • Deleting or Cleaning Up a Software Library
• Configuring Privilege Delegation Providers
  • Creating a Privilege Delegation Setting
    • Creating a Sudo Setting Using EM CLI
    • Creating a PowerBroker Setting Using EM CLI
  • Applying Privilege Delegation Setting
    • Applying Settings to Host Targets
    • Applying Settings to a Composite Target
  • Disabling Host Privilege Delegation Provider Settings
  • Sudo Configuration: Sudoers File

Part V Upgrading Enterprise Manager Grid Control

23 Upgrading Enterprise Manager Grid Control

• Software Prerequisites
• Checks to Be Performed Before Starting the Upgrade Process
  • Shut Down Grid Control Before Upgrade
  • Check for Symbolic Links
  • Customizations and User Permissions
  • Recompile EMD_MAINTENANCE for Manually Upgraded Databases
  • Verify Inventory.xml for Oracle Home Path
  • Select an Agent That Is Not Secure
  • Shut Down Database Listener (UNIX Only)
    • Impact on Firewall Ports and Software Load Balancers
  • Verify Partitioning of Database
  • Back Up the Repository
• Manual Configuration to Be Performed for Upgrade
  • Upgrading from 10.1.0.4 (or higher) to 10.2.x.x
    • PreUpgrade Tasks
    • Upgrade Tasks
  • Patching 10.2.x.x and Migrating to Another Patch Set Release of 10.2.x.x
    • PrePatching Tasks
    • Patching Tasks
    • PostPatching Tasks
• Upgrade Scenarios
  • Upgrading Oracle Management Service that Is Installed Using a New Database
  • Upgrading Management Service that Is Installed Using an Existing Database
  • Upgrading the Oracle Management Service
  • Upgrading the Management Agent
    • Upgrading 10.1.0.4 Agents that Monitor User-Defined Metrics
• Grid Control Upgrade
  • Upgrading Enterprise Manager Grid Control Using Oracle Universal Installer
    • Upgrade Logs
    • Post-Upgrade Configuration
    • Enterprise Manager Grid Control Upgrade Diagnostics
  • Upgrading Management Agent Using the Agent Deploy Application
    • Possible Parameters that You Can Specify During Agent Upgrade
  • Upgrading Management Agent Using agentDownload Script
  • General System Installation Requirements for Real Application Clusters
    • Hardware Requirements for Real Application Clusters Setup
    • Software Requirements for Real Application Clusters Setup

Part VI Deinstalling Enterprise Manager Grid Control and Management Agent

24 Deinstalling Enterprise Manager Grid Control

• Deinstalling Enterprise Manager Grid Control Using OUI
  • Additional Deinstallation Steps
    • Remove Entries in Windows Registry
    • Clean Up Environment Settings
    • Delete Software and Start Menu Icons
• Deinstalling Enterprise Manager Grid Control In Silent Mode
  • Deinstalling Enterprise Manager 10g Grid Control Release 4 (10.2.0.4) or Lower
  • Deinstalling Enterprise Manager 10g Grid Control Release 5 (10.2.0.5) or Higher

25 Deinstalling Management Agent

• Deinstalling Oracle Management Agent Using OUI
  • Additional Deinstallation Steps
    • Remove Entries in Windows Registry
    • Clean Up Environment Settings
• Deinstalling Oracle Management Agent in Silent Mode
  • Deinstalling Oracle Management Agent 10g Release 4 (10.2.0.4) or Lower
  • Deinstalling Oracle Management Agent 10g Release 5 (10.2.0.5) or Higher
• Deinstalling NFSAgent

Part VII Appendixes

A Troubleshooting Enterprise Manager

• Installation Issues
  • Installation Fails with an Abnormal Termination
  • PERL Environment Variable is Forced on the environment During an Enterprise Manager 10g R2 (10.2.0.2) Installation
  • Installation Fails Due to Network Configuration Issues
  • Management Agent Installation Fails
    • Prerequisite Check Fails with Directories Not Empty Error During Retry
    • Agent Deployment on Linux Oracle RAC 10.2 Cluster Fails
    • SSH Verification Fails During Agent Installation
    • SSH Setup Fails with "Invalid Port Number" Error
    • sshConnectivity.sh Script Fails
    • Troubleshooting the "command cygrunsrv not found" Error.
    • SSH Setup Verification Fails with "Read from socket failed: Connection reset by peer." Error
    • SSHD Service Fails to Start
    • Timezone Prerequisite Check Fails
    • OMS Version Is Not Displayed
    • Discrepancy Between Agent and Repository URL Protocols
    • Last Successful Upload Does Not Have a Time Stamp
    • emctl status Log File is Empty
    • Installation Fails When No Group ID or Group Name Is Created
    • Installation Fails with Host Name Error on the Product-Specific Prerequisite Check Page
    • Installation Fails While Securing Agent Communication with OMS
  • Oracle Configuration Manager Fails While Installing Management Agent
• Configuration Issues
  • Configuration Assistants Fail During Enterprise Manager Installation
    • Invoking the One-Off Patches Configuration Assistant in Standalone Mode
    • Invoking the Database Configuration Assistant in Standalone Mode
    • Invoking the OMS Configuration Assistant in Standalone Mode
    • Invoking the Agent Configuration Assistant in Standalone Mode
    • Invoking the OC4J Configuration Assistant in Standalone Mode
    • Options You Can Specify to Run runConfig Tool
  • Enterprise Manager Deployment Fails
  • Oracle Management Service Configuration Fails
    • Oracle Management Service Fails While Deploying Enterprise Manager AgentPush Application
    • In 'Enterprise Manager with new Database' Install, Oracle Management Service Configuration Fails While Unlocking Passwords
    • Dropping of Repository Hangs If SYSMAN Sessions are Active
    • If Oracle Management Service Configuration is Retried, oracle.sysman.emSDK.svlt.ConsoleServerHost and oracle.sysman.emSDK.svlt.ConsoleServerName in emoms.properties are Swapped and There is an Extra Underscore in ConsoleServerHost
• Enterprise Manager Upgrade and Recovery Issues
  • Agent Upgrade Issues
    • Agent Does Not Start Up After Upgrade
    • Missing Directories When Upgrading Agent from 10.1.0.5 to 10.2.0.1
    • Agent Deploy Application Keeps Running Even After Upgrade on an NT Shared Location Is Successful
  • Enterprise Manager Recovery
    • Steps to Follow for Agent Recovery
    • Steps to Follow for OMS Recovery
    • Steps to Re-create the Repository
  • Repository Creation Fails
  • Collection Errors After Upgrade
• Oracle Management Service Upgrade Issues
  • OMS Upgrade Stops at OracleAS Upgrade Assistant Failure
  • OMS Configuration Stops at EMDeploy Failure
  • OMS Configuration Stops at Repository Schema Failure (RepManager)
  • Monitoring Agent Does Not Discover Upgraded Targets
  • CSA Collector Is Not Discovered During Agent Upgrade
  • ias_admin Password Is Set To welcome1 After Upgrade
  • Oracle Management Service Upgrade Fails If Older Listener Is Running On A Port Other Than 1521
  • If TAF String Is Used in Grid Control, then Upgrade Fails
• Troubleshooting Management Agent Issues
  • Generating a Diagnosable Dump
    • Command Line Options to Generate the Dump File
    • Platforms Supported
  • Reference Counting
  • Tracking CPU Thread Times
    • Platforms Supported
• Network Issues
  • Incorrect Format For Entries In /etc/hosts File
  • Enterprise Manager Installation on Computers With Multiple Addresses
  • Agent Configuration Fails on A Non-Network Computer
  • Loopback Adapter On Windows and Related Known Issues
  • Installation Fails with Host Name Error on the Product-Specific Prerequisite Check Page
• Other Installation and Configuration Issues
  • Storage Data Has Metric Collection Errors
  • Cannot Add Systems to Grid Environment from the Grid Control Console
• Error During Deinstallation of Grid Control Targets
• Discovery Issues
  • Unable to Discover Targets Deployed on Hosts
  • Unable to View Metric Details of Targets
• Need More Help

B Platform-Specific Package and Kernel Requirements for Enterprise Manager Grid Control

• Package Requirements
  • Required Packages on Linux
  • Required Packages for Linux x86_64
  • Required Packages on Solaris
    • Checking for 32-Bit and 64-Bit Application Support
    • Required Patches
    • Checking for Patches
  • Required Packages on HP-UX PA-RISC
  • Required Packages for HP-UX Itanium
  • Required Packages on AIX
    • To Verify Whether the Filesets Are Installed and Committed
    • Verify Whether or Not APAR is Installed
• Kernel Parameter Requirements
  • Kernel Parameter Requirements on Linux
  • Kernel Parameter Requirements on Linux x86_64
  • Kernel Parameter Requirements on Solaris
    • View and Change Kernel Parameter Values on Solaris 8 and 9
    • View and Change Kernel Parameter Values on Solaris 10
  • Kernel Parameter Requirements on HP-UX
    • View and Change Kernel Parameter Values
  • Kernel Parameter Requirements on HP-UX Itanium
  • Configure Shell Limits and System Configuration Parameters on AIX
    • Configuring Shell Limits
    • Specifying System Configuration Parameters

C Agent Deploy Application - Installation Prerequisites

• Check Platform-Specific Package Requirements for Agent Installation
• SSH (Secure Shell) Setup
  • Setting Up SSH Using sshConnectivity.sh
    • sshConnectivity.sh Script Usage
  • Setting Up SSH on UNIX Using sshUserSetup.sh
  • Setting Up SSH Server (SSHD) on Microsoft Windows
  • Setting Up SSH on Microsoft WIndows Using sshUserSetupNT.sh
  • Setting Up the Timezone Variable on Remote Hosts
    • Set the TZ variable and Restart the SSH Daemon
    • Set the TZ Variable in the "Shell rc" File
  • Dropping SSH Connection
  • Checking if SSH Connection is Removed
• Validate All Command Locations
  • Location of Properties File
  • Location of Installation Logs
• Verify User Credentials
• Prerequisite Checks Executed by Agent Deploy
  • Prerequisite Checks Executed on the Local Host
  • Prerequisite Checks Executed on Remote Hosts
  • Skipping Prerequisite Checks
• Troubleshooting Failed Prerequisite Checks
  • Prerequisite Check Errors and Resolutions on Local Host
  • Prerequisite Check Errors and Resolutions on Remote Hosts
• Commands and Arguments Executed to Run Agent Deploy Plugins
• Sample Properties Files

D Additional Parameters for Agent Deploy Application

• Additional Parameters Supported by agentDownload Script
• Additional Parameters Supported by Oracle Universal Installer

E Agent Log Files

• Logs Present on OMS Host
• Logs Present on Target Host

F Installation and Configuration Log File Locations

• Enterprise Manager Grid Control Installation Log Files
  • Configuration Logs
  • Installation Logs
  • Repository and Secure Logs
    • Repository Log Location
    • Secure Log Location
• Agent Deploy Log Files

G Enterprise Manager Firewall Port Requirements

H Format of Staticports.ini File and Reasons for Using Default Ports

• Formats for the Staticports.ini File
• Causes for the Installer to Use Default Ports

I Oracle Reserved Words

• List of Oracle Reserved Words

Index