Contents

Title and Copyright Information

Send Us Your Comments

Preface

1 Intelligent Agent Overview

Oracle Intelligent Agent: An Overview

Characteristics

Simple Network Management Protocol Support

2 Installation, Configuration and Usage

Installing the Intelligent Agent

Controlling Operations of the NT Agent

Starting the Intelligent Agent on Windows NT

Stopping the Intelligent Agent on Windows NT

Creating a Windows NT User Account for Running Jobs

Creating a New NT User Account

Assigning Privileges to an Existing NT User Account

Creating a New Windows 2000 User Account

Configuring a Domain User as the Agent User

Configuring SNMP on Windows NT and Windows 2000

Controlling Operations of the UNIX Agent

Running the root.sh Shell Script

Starting and Stopping the Agent on UNIX Platforms

Blackouts

Defining Blackouts

Blackout Command Line Interface

Command Line Examples

Configuring SNMP for UNIX

Configuring the 9i Agent for Use with Multiple Network Cards (NIC)

Agent Behavior when Using Multiple Network Cards

Oracle Intelligent Agent and Oracle Names

Roles and Users Required by the Intelligent Agent

Auto-Discovery

Pre-requisites for Auto-Discovery

Service Discovery Process

Agent Discovery Process for NT

Agent Discovery Process for UNIX

Real Application Cluster Environments

Upgrading from 8.0.6/8.1.6/8.1.7 Intelligent Agents to 9.x

Best Practices: Agent Installation and Configuration

Agent Installation

Agent Configuration

Agent Compatibility

General Agent-Enterprise Manager Upgrade Process

3 Job and Event Scripts

Scripting Language

Tcl Language Description

OraTcl Description

Server Message and Error Information

oramsg Elements

Event to Fixit Job Tcl Array

trigevent Element

Use of Tcl with the Intelligent Agent

NLS Issues and Error Messages

OraTcl Functions and Parameters

Common Parameters

convertin

convertout

msgtxt

msgtxt1

oraautocom

oracancel

oraclose

oracols

oracommit

oradbsnmp

orafail

orafetch

orainfo

orajobstat

oralogoff

oralogon

oralogon_unreached

oraopen

oraplexec

orareadlong

orareportevent

oraroll

orasleep

orasnmp

orasql

orastart

orastop

oratime

orawritelong

A Agent Configuration Files

Configuration Files

snmp_ro.ora

snmp_rw.ora

services.ora

User-configurable Parameters

Intelligent Agent Log Files

B Troubleshooting

Troubleshooting the Intelligent Agent

Quick Checks

Quick Checks for the Windows NT Agent

Quick Checks for UNIX Agents

Additional Checks

Is TCP/IP configured and running correctly?

Do the DNS Name and the Computer Name Match? (Windows NT)

Are the Oracle Net Configuration files correct?

Is Oracle Net functioning properly?

Pinging the Intelligent Agent

Testing the Connections to the Agent

Did the Agent startup successfully?

Did the Agent connect to ALL instances on its node?

Is the Agent running with the correct permissions? (UNIX)

Does the OS user exist and does it have the correct permissions? (Windows NT)

Are there errors?

Why doesn't the Agent send status notifications back to the Enterprise Manager Console even though the jobs have run?

Intelligent Agent Error Messages and Resolutions

Generic Agent

NT Agent

UNIX Agent

Tracing the 9i Agent

Interpreting Intelligent Agent Startup Errors on Windows NT/2000

Oracle Intelligent Agent - Windows Event Log Messages

Typical Intelligent Agent Configuration Issues on UNIX

Understanding and Troubleshooting the Data Gatherer

Data Gatherer Recovery Capabilities

Miscellaneous Data Gatherer Issues

Clean Starting the Intelligent Agent

Diagnosing Intelligent Agent Discovery Errors on UNIX

Files Used During Discovery on UNIX

Diagnosing the Discovery Problem on UNIX

Diagnosing Agent Discovery Errors on Windows NT

Files Used During Discovery

Diagnosing the Discovery Problem on NT

Glossary

Index