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 Installing the Intelligent Agent

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 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

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

Upgrading from 8.0.6/8.1.6/8.1.7 Intelligent Agents to 9.0

Intelligent Agent Upgrade Guidelines

3 New Agent Features for 9i

Blackouts

Defining Blackouts

Blackout Command Line Interface

Command Line Examples

New Control Utility

4 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?

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

Tracing TCL

Glossary

Index