Contents

List of Examples

List of Figures

List of Tables

Title and Copyright Information

Preface

• Intended Audience
• Documentation Accessibility
• Related Documents
• Conventions

What's New

• Multiple Oracle Home Installations
• Resuming an Enterprise Manager Grid Control Installation
• Out-of-Box Secure Grid Environment
• Automated Startup Scripts (UNIX Only)
• Automated Secure Shell (SSH) Setup During Push Install
• Oracle Configuration Manager
• Enhanced Installer Screens

Part I Preinstallation

1 Preinstallation Requirements

• Planning Your Installation
• Enterprise Manager Components Overview
  • Enterprise Manager - Topology
• Preinstallation Considerations for Enterprise Manager
  • Licensing Information
  • Oracle Directory
  • Multiple Oracle Home Support
• Preinstallation Requirements for Enterprise Manager
  • Enterprise Manager Hardware Requirements
    • Recommended CPU and Memory Allocation
    • Temporary Disk Space Requirements on HP-UX
    • Temporary Disk Space Requirements on IBM AIX
    • Considering Resource Allocation
  • Enterprise Manager Platform and Target Certification Requirements
    • Operating System Certifications
    • Required Packages and Kernel Parameters
    • Browser Certifications for the Enterprise Manager Console
    • Certified Enterprise Manager Targets
  • Enterprise Manager Software Requirements
    • Management Repository Software Requirements
    • Management Service Software Requirements
  • Network Requirements
  • Prerequisite Checks
• Running the Prerequisite Check in Standalone Mode

2 Things to Know Before Installation

• Obtaining Software from the Oracle Technology Network
  • Extracting Software from the Zip Files
• Oracle Directory
• Installing in an Existing Oracle Home
• First-Time Installation of Oracle Enterprise Manager Grid Control
  • Installing Additional Languages
• Passwords and Restrictions
• Why Must I Log In as Root During Installation (UNIX Only)?
  • Running root.sh During Installation (UNIX Only)
• Starting Oracle Universal Installer (OUI)
• Enterprise Manager Configuration Plug-in (EMCP)

Part II Enterprise Manager Installation

3 Installing Enterprise Manager

• Accessing the Installation Software
  • Installing 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
  • Installing on Remote Computers Using Remote Access Software
    • Installing from a Hard Drive
    • Installing from a Remote DVD Drive
• Using Oracle Universal Installer
  • Specifying a Temporary Directory
  • Starting the Installer
• Enterprise Manager Installation Types
  • Installing Enterprise Manager 10g Grid Control Using a New Database
    • Permissions and Prerequisites
    • To Install Enterprise Manager Using a New Database
  • Installing Enterprise Manager 10g Grid Control Using an Existing Database
    • Prerequisites
    • To Install Enterprise Manager Using Existing Database
  • Installing an Additional Management Service
    • Prerequisites
    • To Install an Additional Management Service
  • Installing a Management Agent
    • Prerequisites
    • To Install an Additional Management Agent Using OUI
• Executing the runConfig Tool from the Command Line
  • Options You Can Specify to Execute runConfig
    • ORACLE_HOME
    • ACTION
    • MODE
    • COMPONENT_XML
    • RESPONSE_FILE
    • INV_PTR_LOC
    • RERUN
    • Typical Usage of the runConfig.sh
    • runConfig Log Files
  • Executing the configToolFailedCommands Script (UNIX Only)
• Deinstallation of Enterprise Manager Grid Control
  • Additional Deinstallation Steps for Windows Operating Systems
    • Remove Entries in Windows Registry
    • Clean Up Environment Settings
    • Delete Software and Start Menu Icons

4 Enterprise Manager Silent Installations

• Performing Silent Installations
  • Silent Installation of Enterprise Manager Using a New Database
  • Silent Installation of Enterprise Manager Using an Existing Database
  • Silent Installation of an Additional Management Service
  • Silent Installation of an Additional Management Agent
    • Setting Up Proxy Configuration for the Management Agent
• Assigning Custom Ports (Static Ports Feature)
• Formats for the Staticports.ini File
• Error Conditions that Cause the Installer to Resort to Default Ports

5 Prerequisites for Installing Enterprise Manager 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 Agent Installation on Clusters
    • Oracle Clusterware/Vendor Clusterware
  • Preinstallation Tasks for Oracle Real Application Clusters

6 Deploying the Management Agent

• Management Agent Installation/Deployment Options
• Installing the Management Agent Using Agent Deploy
  • Agent Deploy Installation Prerequisites
  • Accessing the Agent Deploy Application
  • Agent Deploy Installation Types
    • Fresh Installation of the Management Agent
    • Installation Using a Shared Agent Home
    • Concepts and Prerequisites
    • Performing the Installation
• Sharing the Agent Oracle Home Using the nfsagentinstall Script
  • Preinstallation Considerations
    • User Credentials
    • If Agent Is Not the First Oracle Product Installation
  • Performing an NFS Agent Installation
    • Usage of the nfsagentinstall Script
  • Deinstalling the NFSAgent
• Installing the Agent Using the agentDownload Script
  • About agentDownload Script
  • Benefits of the agentDownload Script
  • Obtaining the agentDownload Script
  • Using the agentDownload Script
    • Cluster Installation
    • Script Details
    • Customizing the agentDownload Script
  • Downloading 10.2.0.3.0 Agent Installation Software for Different Platforms

7 Postinstallation Configuration Tasks

• Running root.sh to Complete the Installation Process (UNIX Only)
• Checking Database Settings
  • UNDO Tablespace and Temporary Tablespace
  • Archive Logging
  • Ensure the Database is Not in QUIESCE Mode
• Accessing the OracleMetaLink Web Site
  • Accessing Management Packs
    • Impact of Management Packs on Targets
  • Optional Configurations
    • Specifying the OracleMetaLink Credentials
    • Setting Up Proxy Configuration for the Management Service
• Configuring Database and ASM Targets for Monitoring
• Agent Reconfiguration and Rediscovery
  • 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

8 Deploying Cluster Agent

• Installing the Agent on a Release 9.2 Cluster
  • Installing a Standalone Agent on a Release 9.2 Cluster Node
    • Installing a Standalone Agent Using the agentDownload Script
    • Installing a Standalone Agent Using the Agent Deploy Application
    • Installing a Standalone Agent Using Oracle Universal Installer
  • Installing a Cluster Agent on a Release 9.2 Cluster
    • Installing a Cluster Agent Using the agentDownload Script
    • Installing a Cluster Agent Using the Agent Deploy Application
    • Installing a Cluster Agent Using the Interactive Installer
• Installing the Agent on Oracle Clusterware
  • Installing a Standalone Agent on Oracle Clusterware
    • Installing a Standalone Agent Using agentDownload Script
    • Installing a Standalone Agent Using the Agent Deploy Application
    • Installing a Standalone Agent Using Oracle Universal Installer
  • Installing a Cluster Agent on Oracle Clusterware
    • Installing a Cluster Agent Using the agentDownload Script
    • Installing a Cluster Agent Using the Agent Deploy Application
    • Installing a Cluster Agent Using Oracle Universal Installer
  • Installing Oracle RAC Agent on Windows

9 Management Agent Cloning

Part III Postinstallation Configuration

10 Getting Started with Enterprise Manager

• 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 Management Service
  • Starting and Stopping the Management Agent
  • Starting the Oracle Application Server 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

Part IV Enterprise Manager Upgrade

11 Upgrading Enterprise Manager Grid Control

• Software Prerequisites
• Checks to Be Performed Before Starting the Upgrade
  • Shut Down Enterprise Manager 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
• Manual Configuration to Be Performed For Upgrade
  • Tasks to be Performed Before Upgrading from 10.1.0.4 to 10.2.0.1 or 10.2.0.2
  • Tasks to be Performed For Upgrading from 10.1.0.4 to 10.2.0.1 or 10.2.0.2
  • Tasks to be Performed Before Upgrading from 10.2.0.1 to 10.2.0.2 or 10.2.0.3.0
  • Tasks to be Performed For Upgrading from 10.2.0.1 to 10.2.0.2 or 10.2.0.3.0
• 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
• Enterprise Manager Upgrade
  • Enterprise Manager Upgrade 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 V 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
  • 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 User Equivalence 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
• 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
    • 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
  • 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
• 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
• 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
• Need More Help

B Platform-Specific Package and Kernel Requirements

• Package Requirements
  • Required Packages on Linux
  • Required Packages on Solaris
    • Checking for 32-Bit and 64-Bit Application Support
    • Required Patches
    • Checking for Patches
  • Required Packages on HP-UX
  • 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 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
  • Configure Shell Limits and System Configuration Parameters on AIX
    • Configuring Shell Limits
    • Specifying System Configuration Parameters

C Agent Deploy Application - Installation Prerequisites

• Prerequisites
  • Check Platform-Specific Package Requirements for Agent Installation
  • Set Up SSH (Secure Shell) User Equivalence
    • Setting Up SSH User Equivalence Using sshConnectivity.sh
    • 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
    • Dropping SSH Connection
    • Checking if SSH Connection is Removed
  • Validate All Command Locations
    • Location of Properties File
    • Location of Installation Logs
  • Modify Response File for Big IP Host and Port
  • Verify oraInventory Permissions on Remote Hosts
  • Verify User Credentials
• Prerequisite Checks Executed by Agent Deploy
  • Prerequisite Checks Executed on the Local Host
  • Prerequisite Checks Executed on Remote Hosts
• 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

• Additional Parameters Supported by agentDownload Script
• Additional Parameters Supported by Oracle Universal Installer
  • Command-Line Variable Usage During Silent Installation

E Enterprise Manager Firewall Port Requirements

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 Oracle Reserved Words

• List of Oracle Reserved Words

Index