Oracle Intelligent Agent. User’s Guide

This manual provides configuration information and answers to crucial troubleshooting questions pertaining to the Oracle Intelligent Agent The Intelligent Agent User’s Guide is directed towards users of Oracle Enterprise Manager VersionI and Version 2. as well as other supported system management frameworks that communicate with the Oracle database through the Intelligent Agent.This manual is intended for anyone installing, configuring, or troubleshooting the Oracle Intelligent Agent on UNIX or Windows NT platforms. Under most circumstances, the Agent requires little in the way of configuration and maintenance. For this reason, the Oracle Intelligent Agent User’s Guide should be used as a reference, rather than read sequentially.

---

Table of contents :
Send Us Your Comments……Page 7
Preface……Page 9
1 Intelligent Agent Overview……Page 13
Characteristics……Page 14
Simple Network Management Protocol Support……Page 15
2 Installing the Intelligent Agent……Page 17
Stopping the Intelligent Agent on Windows NT……Page 18
Creating a Windows NT User Account for Running Jobs……Page 19
Assigning Privileges to an Existing NT User Account……Page 20
Configuring a Domain User as the Agent User……Page 21
Configuring SNMP Windows NT and Windows 2000……Page 22
Running the root.sh Shell Script……Page 23
DBSNMPWD……Page 24
Configuring SNMP for UNIX……Page 25
Configuring the Version 9.0.1 Agent for Use with Multiple Network Cards (NIC)……Page 26
Agent Behavior when Using Multiple Network Cards……Page 27
Oracle Intelligent Agent and Oracle Names……Page 28
Roles and Users Required by the Intelligent Agent……Page 29
Auto-Discovery……Page 30
Pre-requisites for Auto-Discovery……Page 31
Agent Discovery Process for NT……Page 32
Agent Discovery Process for UNIX……Page 33
Intelligent Agent Upgrade Guidelines……Page 34
3 New Agent Features for 9i……Page 37
Blackout Command Line Interface……Page 38
Command Line Examples……Page 39
New Control Utility……Page 40
4 Job and Event Scripts……Page 41
Tcl Language Description……Page 42
Example: OraTcl Script……Page 44
oramsg Elements……Page 46
Example……Page 49
Use of Tcl with the Intelligent Agent……Page 52
NLS Issues and Error Messages……Page 53
Common Parameters……Page 54
convertin……Page 55
msgtxt……Page 57
msgtxt1……Page 58
oracancel……Page 59
oracommit……Page 60
orafail……Page 61
orafetch……Page 62
orainfo……Page 63
oralogoff……Page 65
oraopen……Page 66
oraplexec……Page 67
orareportevent……Page 68
orasleep……Page 70
orasnmp……Page 71
orasql……Page 72
orastop……Page 73
orawritelong……Page 74
A Agent Configuration Files……Page 75
User-configurable Parameters……Page 76
Intelligent Agent Log Files……Page 82
B Troubleshooting……Page 83
Quick Checks for the Windows NT Agent……Page 84
Quick Checks for UNIX Agents……Page 86
Is TCP/IP configured and running correctly?……Page 88
Correcting TCP/IP configuration problems……Page 89
Do the DNS Name and the Computer Name Match? (Windows NT)……Page 90
(Windows NT)……Page 91
Is Oracle Net functioning properly?……Page 92
Did the Agent startup successfully?……Page 93
Are there errors?……Page 95
Why doesn’t the Agent send status notifications back to the Enterprise Manager Console even thoug………Page 96
TNS-12542: ’TNS:address already in use’……Page 97
’Failed to authenticate user’ error when running a job……Page 98
Not all services are discovered…….Page 99
’Oralogin failed in orlon’……Page 100
In order to debug the Agent after you have received an OS error, follow the following steps:……Page 101
Agent finds no services after discovery……Page 102
NMS-0308 : ’Failed to listen on address : another Agent may be running’…….Page 103
NMS-351 while starting the Agent……Page 104
Tracing the 9i Agent……Page 105
Tracing TCL……Page 106
C Keyboard Shortcuts……Page 107
Glossary……Page 111
Index……Page 113