Contents

Title and Copyright Information

Send Us Your Comments

Preface

Intended Audience

Documentation Accessibility

Related Documents

1 Introduction to Enterprise Manager Advanced Configuration

1.1 Types of Advanced Configuration Tasks

1.2 Understanding the Enterprise Manager Directory Structure

1.2.1 Understanding the Enterprise Manager Directories Installed with the Oracle Enterprise Manager 10g Grid Control

1.2.1.1 About the Oracle Management Service Home Directory

1.2.1.2 About the Oracle Management Agent Home (AGENT_HOME) Directory

1.2.1.3 Summary of the Important Directories in the Management Service Home

1.2.2 Understanding the Enterprise Manager Directories Installed with the Management Agent

1.2.2.1 Summary of the Important Directories in the Management Agent Home

1.2.2.2 Understanding the Management Agent Directory Structure on Windows

1.2.3 Understanding the Enterprise Manager Directories Installed with Oracle Application Server

1.2.4 Understanding the Enterprise Manager Directories Installed with Oracle Database 10g

1.2.5 Configuring the Database Control During and After the Oracle Database 10g Installation

1.2.5.1 Configuring the Database Control During Installation

1.2.5.2 Configuring the Database Control with DBCA

1.2.5.3 Configuring the Database Control with EMCA

1.2.5.4 Using an Input File for EMCA Parameters

1.2.5.5 Using EMCA with Real Application Clusters

1.2.5.6 EMCA Troubleshooting Tips

1.3 Starting and Stopping Enterprise Manager Components

1.3.1 Controlling the Oracle Management Agent

1.3.1.1 Starting, Stopping, and Checking the Status of the Management Agent on UNIX

1.3.1.2 Starting and Stopping the Management Agent on Windows

1.3.1.3 Checking the Status of the Management Agent on Windows

1.3.2 Controlling the Oracle Management Service

1.3.2.1 Using OPMN to Start and Stop the Management Service

1.3.2.2 Using emctl to Start, Stop, and Check the Status of the Oracle Management Service

1.3.2.3 Starting and Stopping Oracle Application Server Web Cache

1.3.3 Controlling the Application Server Control

1.3.4 Controlling the Database Control on UNIX

1.3.4.1 Starting the Database Control on UNIX

1.3.4.2 Stopping the Database Control on UNIX

1.3.5 Starting and Stopping the Oracle Enterprise Manager 10g Grid Control Framework

1.3.5.1 Starting the Grid Control Framework

1.3.5.2 Stopping the Grid Control Framework

1.4 Additional Management Agent Commands

1.4.1 Uploading and Reloading Data to the Management Repository

1.4.2 Specifying New Target Monitoring Credentials

1.4.2.1 Using the Grid Control to Modify the Monitoring Credentials

1.4.2.2 Using the Enterprise Manager Command Line to Modify the Monitoring Credentials

1.4.3 Listing the Targets on a Managed Host

1.4.4 Controlling Blackouts

1.5 Enabling Enterprise Manager Accessibility Features

1.5.1 Enabling Enterprise Manager Accessibility Mode

1.5.2 Providing Textual Descriptions of Enterprise Manager Charts

2 Enterprise Manager Security

2.1 About Oracle Enterprise Manager Security

2.1.1 Oracle Enterprise Manager Security Model

2.1.2 Classes of Users and Their Privileges

2.1.3 Resources Protected

2.1.4 Authorization and Access Enforcement

2.1.5 Leveraging Oracle Application Server Security Services

2.1.6 Leveraging Oracle Identity Management Infrastructure

2.2 Configuring Security for the Grid Control Framework

2.2.1 About Enterprise Manager Framework Security

2.2.2 Overview of the Steps Required to Enable Enterprise Manager Framework Security

2.2.3 Enabling Security for the Oracle Management Service

2.2.4 Enabling Security for the Oracle Management Agent

2.2.5 Enabling Security with Multiple Management Service Installations

2.2.6 Restricting HTTP Access to the Management Service

2.2.7 Managing Agent Registration Passwords

2.2.7.1 Using the Grid Control to Manage Agent Registration Passwords

2.2.7.2 Using emctl to Change the Agent Registration Password

2.2.8 Enabling Security for the Management Repository Database

2.2.8.1 About Oracle Advanced Security and the sqlnet.ora Configuration File

2.2.8.2 Configuring the Management Service to Connect to a Secure Management Repository Database

2.2.8.3 Enabling Oracle Advanced Security for the Management Repository

2.2.8.4 Enabling Security for the Management Agent that is Monitoring a Secure Management Repository or Database

2.3 Configuring Security for the Enterprise Manager Application Server Control

2.4 Configuring Security for the Oracle Enterprise Manager 10g Database Control

2.5 Configuring Enterprise Manager for Use with Oracle Application Server Single Sign-On

2.5.1 Configuring Enterprise Manager to Use the Single Sign-On Logon Page

2.5.2 Registering Single Sign-On Users as Enterprise Manager Administrators

2.5.3 Grid Control as a Single Sign-On Partner Application

2.5.4 Bypassing the Single Sign-On Logon Page

2.6 Configuring Enterprise Manager for Use with Enterprise User Security

2.7 Additional Security Considerations

2.7.1 Responding to Browser-Specific Security Certificate Alerts

2.7.1.1 Responding to the Internet Explorer Security Alert Dialog Box

2.7.1.2 Responding to the Netscape Navigator New Site Certificate Dialog Box

2.7.1.3 Preventing the Display of the Internet Explorer Security Information Dialog Box

2.7.2 Configuring Beacons to Monitor Web Applications Over HTTPS

3 Configuring Enterprise Manager for Firewalls

3.1 Considerations Before Configuring Your Firewall

3.2 Firewall Configurations for Enterprise Management Components

3.2.1 Firewalls Between Your Browser and the Grid Control

3.2.2 Configuring the Management Agent on a Host Protected by a Firewall

3.2.2.1 Configuring the Management Agent to Use a Proxy Server

3.2.2.2 Configuring the Firewall to Allow Incoming Communication From the Management Service

3.2.3 Configuring the Management Service on a Host Protected by a Firewall

3.2.3.1 Configuring the Management Service to Use a Proxy Server

3.2.3.2 About the dontProxyfor Property

3.2.3.3 Configuring the Firewall to Allow Incoming Management Data From the Management Agents

3.2.4 Firewalls Between the Management Service and the Management Repository

3.2.5 Firewalls Between the Grid Control and a Managed Database Target

3.2.6 Firewalls Used with Multiple Management Services

3.2.7 Configuring Firewalls to Allow ICMP and UDP Traffic for Beacons

3.3 Viewing a Summary of the Ports Assigned During the Application Server Installation

4 Configuring Application Performance Management

4.1 Before You Begin Configuring Application Performance Management

4.2 Summary of Application Performance Management Configuration Tasks

4.3 Configuring Transaction Performance Monitoring

4.3.1 Basic Configuration of Transaction Performance Monitoring

4.3.2 Advanced Configuration of Transaction Performance Monitoring

4.3.3 Configuring Business Transaction Tracing

4.4 Configuring End-User Response Time Monitoring

4.4.1 Configuring End-User Response Time Monitoring Using Oracle Application Server Release 2 (9.0.4)

4.4.1.1 Configuring Oracle Application Server Web Cache 9.0.4 for End-User Response Time Monitoring

4.4.1.2 Starting and Stopping End-User Response Time Monitoring

4.4.2 Configuring End-User Response Time Monitoring Using Earlier Versions of Oracle Application Server Web Cache

4.4.2.1 About the chronos_setup Configuration Script

4.4.2.2 Configuring the Document Root for Each Web Server

4.4.2.3 Configuring Oracle Application Server Web Cache for End-User Response Time Monitoring

4.4.2.4 Starting End-User Response Time Monitoring

4.4.3 Configuring End-User Response Time Monitoring Using Standalone Oracle Application Server Web Cache

4.4.3.1 Installing Standalone Oracle Application Server Web Cache

4.4.3.2 Configuring Standalone Oracle Application Server Web Cache

4.4.3.3 Enabling End-User Response Time Monitoring for Standalone Oracle Application Server Web Cache

4.4.4 Confirming that End-User Response Time Monitoring is Enabled

4.5 Configuring OC4J for Middle-Tier URL Performance Monitoring

4.5.1 Configuring OC4J Tracing for Middle-Tier URL Monitoring

4.5.2 Additional Configuration for Monitoring UIX Applications

5 Locating and Configuring Enterprise Manager Log Files

5.1 Locating and Configuring Management Agent Log and Trace Files

5.1.1 About the Management Agent Log and Trace Files

5.1.2 Locating the Management Agent Log and Trace Files

5.1.3 About Management Agent Rollover Files

5.1.4 Controlling the Size and Number of Management Agent Log and Trace Files

5.1.5 Controlling the Contents of the Management Agent Trace File

5.1.6 Controlling the Size and Number of Fetchlet Log and Trace Files

5.1.7 Controlling the Contents of the Fetchlet Trace File

5.2 Locating and Configuring Management Service Log and Trace Files

5.2.1 About the Management Service Log and Trace Files

5.2.2 Locating the Management Service Log and Trace Files

5.2.3 Controlling the Size and Number of Management Service Log and Trace Files

5.2.4 Controlling the Contents of the Management Service Trace File

6 Maintaining and Troubleshooting the Repository

6.1 Management Repository Deployment Guidelines

6.2 Management Repository Data Retention Policies

6.2.1 Management Repository Default Aggregation and Purging Policies

6.2.2 Management Repository Default Aggregation and Purging Policies for Other Management Data

6.2.3 Modifying the Default Aggregation and Purging Policies

6.2.4 Modifying Data Retention Policies When Targets Are Deleted

6.3 Requirement to Manually Analyze Specific Management Repository Tables

6.4 Changing the SYSMAN Password

6.5 Dropping and Recreating the Management Repository

6.5.1 Dropping the Management Repository

6.5.2 Recreating the Management Repository

6.5.2.1 Using the RepManager Script to Create the Management Repository

6.5.2.2 Using a Connect Descriptor to Identify the Management Repository Database

6.6 Troubleshooting Management Repository Creation Errors

6.6.1 "Package Body Does Not Exist" Error While Creating the Repository

6.6.2 "Server Connection Hung" Error While Creating the Repository

6.6.3 General Troubleshooting Techniques for Creating the Repository

7 Reconfiguring the Management Agent and Management Service

7.1 Reconfiguring the Oracle Management Agent

7.1.1 Configuring the Management Agent to Use a New Management Service

7.1.2 Changing the Management Agent Port

7.1.3 Controlling the Amount of Disk Space Used by the Management Agent

7.1.4 About the Management Agent Watchdog Process

7.1.5 Setting the Management Agent Time Zone

7.1.5.1 Understanding How the Management Agent Obtains Time Zone Information

7.1.5.2 Troubleshooting Management Agent Time Zone Problems

7.1.5.3 Troubleshooting Oracle Management Service Time Zone Problems

7.2 Reconfiguring the Oracle Management Service

7.2.1 Configuring the Management Service to Use a New Repository

7.2.1.1 Changing the Repository Properties in the emoms.properties File

7.2.1.2 About Changing the Repository Password

7.2.2 Configuring the Management Service to Use a New Port

8 Migrating from Previous Versions of Enterprise Manager

8.1 Overview of the Enterprise Manager Migration Process

8.2 Requirements for Migrating from Previous Versions of Enterprise Manager

8.3 The Oracle Enterprise Manager 10g Migration Process

8.3.1 Deploying and Configuring Oracle Enterprise Manager 10g Management Agents

8.3.1.1 Deploying the Oracle Enterprise Manager 10g Management Agents Using the Release 2.2, Release 9.0.1, or Release 9.2 Job System

8.3.1.1.1 More About the Directory Type Parameter

8.3.1.2 Configuring the Oracle Enterprise Manager 10g Management Agents for Use with the Oracle Enterprise Manager 10g Job System (UNIX Systems Only)

8.3.2 Migrating Management Repository Data

8.4 Configuring Metric Thresholds

8.4.1 Copying Metric Thresholds to Multiple Targets

9 Configuring Notifications

9.1 Setting Up Notifications

9.2 Managing Notification Methods

9.2.1 Setting Up a Mail Server for Notifications

9.2.2 Custom Notification Methods using Scripts and SNMP Traps

9.2.2.1 Adding a Notification Method based on an OS Command

9.2.2.2 Adding a Notification Method Based on a PL/SQL Procedure

9.2.2.3 Adding a Notification Method Based on an SNMP Trap

9.2.3 Passing Metric Severity Information

9.2.3.1 Passing Information to an OS Script or Executable

9.2.3.2 Passing Information to a PL/SQL Procedure

9.3 Notification Rules

9.4 Default Notification Rules

9.5 Creating Your Own Notification Rules

9.6 Getting Email Notifications

9.6.1 Notification Schedules

9.6.2 Using Out-of-Box Notification Rules

9.6.3 Creating Your Own Notification Rules

9.7 Configuring Methods for Rules

9.8 Assigning Methods to Rules

9.9 Assigning Rules to Methods

9.10 Management Information Base (MIB)

9.10.1 About MIBs

9.10.2 Reading the MIB Variable Descriptions

9.10.2.1 Variable Name

9.10.3 MIB Definition

10 Additional Configuration Tasks

10.1 Understanding Default and Custom Data Collections

10.1.1 How Enterprise Manager Stores Default Collection Information

10.1.2 Restoring Default Collection Settings

10.2 Enabling Multi-Inventory Support for Configuration Management

10.3 Manually Configuring a Database Target for Complete Monitoring

10.4 Modifying the Default Login Timeout Value

Index