Contents

Title and Copyright Information

Send Us Your Comments

Preface

1 Intelligent Agent Overview

Oracle Intelligent Agent: An Overview

Characteristics

Job and Event Support

Simple Network Management Protocol Support

Description of the Data Gathering Service

How the Data Gathering Service is Installed

Understanding Where to Configure the Oracle Data Gatherer to Collect Database and Operating System Data

Running the Oracle Data Gatherer on an Intermediate Host

2 Installation and Configuration

Installing the Intelligent Agent on Windows NT

Creating a Windows NT User Account for Running Jobs

Configuring a Domain User as Your Agent User

Controlling Operations of the NT Agent

Installing the Oracle Intelligent Agent on UNIX

Running the root.sh Shell Script

Controlling Operations of the UNIX Agent

Configuring SNMP for UNIX or Windows NT

Configuring the Version 8.1.7 Agent for Use with Multiple Network Cards

Agent Behavior when Using Multiple Network Cards

Oracle Intelligent Agent and Oracle Names

Roles and Users Required by the Agent

Auto-Discovery

Pre-requisites for Auto-Discovery

Service Discovery Process

Agent Discovery Process for NT

Agent Discovery Process for UNIX

Upgrading the Intelligent Agent

Agent Upgrade Guidelines for Enterprise Manager Version 2

Migrating Enterprise Manager Jobs/Events from an 8.1.5 or 8.1.6 Agent to an 8.1.7 Agent

Configuring the Data Gatherer

Upgrading From a Previous Version of the Data Gatherer when You Install the New Data Gatherer into a Different Oracle Home

Migrating Collection Data to Agent Data Gatherer Version 8.1.7

How the NMUMIGRATE Utility Works

Controlling Operations of the NT and UNIX Data Gathering Service

Additional Methods for Controlling Operations on Windows NT

Verify Data Gathering Service is Running

Obtaining Trace Information on the Oracle Data Gatherer

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

oraopen

oraplexec

orareadlong

orareportevent

oraroll

orasleep

orasnmp

orasql

orastart

orastop

oratime

orawritelong

A Configuration Files

Configuration Files

snmp_ro.ora

snmp_rw.ora

services.ora

User-configurable Parameters

B Troubleshooting

Troubleshooting the Intelligent Agent

Quick Checks

Quick Checks for the Windows NT Agent

Quick Checks for UNIX Agents

Questions and Answers

Is TCP/IP configured and running correctly?

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

Are the Net8 configuration files correct?

Is Net8 functioning properly?

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 you still using a 7.3.3 or earlier Agent?

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 Startup Problems and Solutions

Generic Agent

NT Agent

Unix Agent

Intelligent Agent Error Messages and Resolutions

Generic Agent

NT Agent

UNIX Agent

Tracing the Agent

Tracing TCL

Troubleshooting the Configuration of the Oracle Data Gatherer

C Keyboard Shortcuts

Glossary

Index