ࡱ                >  	                                                      	   
         
                                                             !   "   #   $   %   &   '   (   )   *   +   ,   -   .   /   0   1   2   3   R o o t   E n t r y                                                   	           F            p%fR4          W o r d D o c u m e n t                                                                                    a       C o m p O b j                                                                                           n                                                                                                                              l NICs. 

Note: The Agent binds to an ip address and uses that address, to listen for all incoming requests for executing EM jobs and events.

Also please note that similar options will apply to the Agent Data Gatherer.
The Agent will also have the capability of discovering services(listeners etc.) that are listening on an ip address/NIC that's different from the ip address/NIC being used by the Agent.

For configuration details, please refer to the Oracle Intelligent Agent User's Guide available as part of the EM documentation.


D. TRACING
----------
With 8.1.7 release, there will be two additional properties for tracing the Agent. These properties can be added to the configuration file snmp_rw.ora under the Agent's ORACLE_HOME/network/agent directory. 

The properties are:

nmi.trace_filecnt=<number of trace files>
nmi.trace_filesize=<size of individual trace files in kbytes>

These properties will control the number of trace files and the size of each file generated for the Agent. The trace code will cycle through the number of files specified for a specified file size and not expand beyond that.

The advantage of using these parameters is that they will prevent trace files from filling up disk space.


E. AGENT DATA GATHERER MIGRATION UTILITY FOR DATABASE COLLECTIONS
-----------------------------------------------------------------
A new utility called "nmumigrate" will allow the user to migrate existing database colllections being performed by an existing Agent Data Gatherer to the new format recognized by the DBA cartridge used by the 8.1.7 Agent Data Gatherer. This is the mn from the pre-8.1.7 ODB cartridge to the new DBA cartridge. The new DBA cartridge provides performance and collection enhancements. 

The user should complete these steps prior to migration:

1. Install the 8.1.7 Intelligent Agent.
2. Make sure that the ORACLE_HOME environment variable is set to the ORACLE_HOME of the 8.1.7 Intelligent Agent.
3. Make sure that no Data Gatherer is running.

Usage:

nmumigrate <old ORACLE_HOME>

This utility gets installed under the 8.1.7 ORACLE_HOME/bin directory and will migrate the database collections in the old ORACLE_HOME to the new format recognized by the 8.1.7 Agent Data Gatherer in the new ORACLE_HOME. It will create new collection state files in this new ORACLE_HOME. The utility will use the ORACLE_HOME environment variable to get the new ORACLE_HOME. If the user has upgraded to the 8.1.7 Agent and Data Gatherer within the old ORACLE_HOME, then the user need not specify the ORACLE_HOME when running this utility(Please refer to section H for guidelines on upgrading within the same ORACLE_HOME). For collection cartridges other than the database collection cartridge, the utility will check if the cartridge is installed in the 8.1.7 ORACLE_HOME and if so, it will copy corresponding collection files from the old ORACLE_HOME to the 8.1.7 ORACLE_HOME.

After migration:

The user can check the 8.1.7 ORACLE_HOME/odg/log/migration.log file for migration details.

Note:
This utility will not migrate collections for user defined scripts and will print the following message when trying to do so:
Warning: class not found in map
In this case, the user will have to manually migrate the collections for user defined scripts by going to Oracle Capacity Planner and re-starting these collections.

For details on the working of nmumigrate utility, please refer to the Oracle Intelligent Agent User's Guide, available as part of the Enterprise Manager documentation set.


F. REGISTRATION OF DUPLICATE EVENTS ALLOWED
-------------------------------------------
Prior to release 8.1.7, the Intelligent Agent did not support registration of duplicate EM events. This restriction has be removed in 8.1.7. Users will now have the flexibility to register multiple events against the same target using the same event test/s. 


G. MIGRATING EM JOBS/EVENTS FROM AN 8.1.5 or 8.1.6 AGENT TO AN 8.1.7 AGENT
-----------------------------------------------------------------------------
This note is intended for Enterprise Manager 2.2 users, who haܥe #	                  n6  a                  m3                                  ,`  l   ,`  l                                   `                                              `  
   
`  
             W   (`                                                             `                                                     `  T   `                                                & 
 
                                                                                                                                                                                                                                                                                         W      MS Sans Serif    Symbol 
0    Courier     Times New Roman      Helvetica 
Copyright (c) Oracle Corporation 2000. 
All rights reserved, worldwide.

=========================================
Oracle Intelligent Agent Readme
Version 8.1.7(Windows N.T) -- Production
=========================================

This document provides basic information on the Intelligent Agent and its Data Gatherer. It also provides information on the bugs fixed in release 8.1.7 and highlights new configuration parameters and enhancements. The bug fixes are listed at the end of the Readme.

A. Overview
-----------

The Oracle Enterprise Manager (EM) Intelligent Agent is an autonomous 
process running on remote nodes in the network. An Agent resides on the 
same node as the service it supports. However the agent can support more 
than one service on a particular node. For example if two databases are 
installed on one machine a single agent can support both databases. 

The Agent is autonomous so they can perform administrative tasks, monitor 
the system and correct problems, detect and react to events, all 
independently, at any time, without requiring the EM console be running, 
or any active participation by the administrator. The Agent queues any 
job or event messages destined for an administrator and delivers them 
when the administrator logs in to a console again. The Agent can run 
without the database being up and can shut down or start up the database.

The Intelligent Agent is responsible for:

. Accepting jobs or events from the EM Console or other                                                                                                                                          third-party applications

. Running jobs, collecting job results and output and queueing them for
  the EM console

. Canceling jobs

. Checking for events, and queueing the event reports

. Handling Simple Network Management Protocol (SNMP) requests, if SNMP 
  is supported.

Using TCL scripts submitted as EM jobs you can program an agent to perform 
a task or to detect problems. By submitting a 'fixit' job along with an 
event registration you can also program an agent to correct a problem 
when it is detected.

The Agent Data Gatherer collects database and operating system specific statistical data for clients like the Oracle Performance Manager and Oracle Capacity Planner.

For details, please consult the Intelligent Agent User's Guide available as part of the EM documentation.


B. DISCOVERY AND HOSTNAMES
--------------------------
The discovery mechanism used by the Intelligent Agent will discover services(databases, listeners etc.) on nodes that are identified by a non-fully qualified host name(E.g.: node1 is the host name instead of a fully qualified host name like node1.us.oracle.com), provided the non-fully qualified host name is in the machine's hosts file or in the name service entry for the host(i.e the hosts file or name service entry for 
node1.us.oracle.com contains node1 as an alias).

If such an alias does not exist in the hosts file or name service entry for the host, then the fully qualified hostname(E.g.:node1.us.oracle.com) must be used in the configuration files(listener.ora, tnsnames.ora). These files are used by the Agent to discover services like databases, listeners. In this case, if a fully qualified hostname is not used, the Agent will not discover the services.


C. SUPPORT FOR MULTIPLE NETWORK INTERFACE CARDS(NICs)
-----------------------------------------------------
Starting with 8.1.7, users will have three options to configure the Agent on a machine with multiple NICs. By default the Agent will bind to the primary NIC on its machine. The other two options are:
a) Ability to bind to a NIC specified by the user.
c) Ability to bind to all NICs on the machine. This option should not be used if it is not desirable to have the Agent listening on alve existing jobs/events submitted against an 8.1.x Agent and, would like to use the 8.1.7 Agent without having to re-submit these jobs or re-register these events.

Solution:

1. Install the 8.1.7 Agent in a seperate ORACLE_HOME.

2. Stop the older 8.1.x Agent(lsnrctl dbsnmp_stop).

3. Copy all the files(not the directories) under the older 8.1.x Agent's ORACLE_HOME/network/agent directory to the 8.1.7 Agent's ORACLE_HOME/network/agent directory(These are *.q files, *.inp files, tcl* files). These files should now be owned by the user who installed the 8.1.7 Agent(Please check the ownership of these files in the newer Agent's directory).

4. Start the 8.1.7 Agent(lsnrctl dbsnmp_start).

5. Make sure that the services(databases, listeners etc.) are discovered by the new Agent, in the same way as with the older Agent(A quick comparative check between service names and definitions in the older Agent's ORACLE_HOME/network/agent/services.ora file and the one under the newer Agent's directory, is recommended).

6. From the Enterprise Manager console, refresh the Agent's node.

Expected behavior: After migration, these jobs/events should continue to run as before.

H. UPGRADING WITHIN THE SAME ORACLE_HOME
----------------------------------------
Please note that users can also upgrade from Intelligent Agent 8.1.5 or 8.1.6 to Intelligent Agent 8.1.7 within the same ORACLE_HOME on Windows N.T(Assuming that the Intelligent Agent is the only product in the ORACLE_HOME OR every product within the ORACLE_HOME is being upgraded to version 8.1.7). This can be done as follows:

1. Shutdown the older 8.1.x Agent.(Shutdown the Agent and Data Gatherer services from Control Panel on Windows N.T).

2. Install the 8.1.7 Agent in the older Agent's ORACLE_HOME.

3. Start the 8.1.7 Agent and Data Gatherer.

4. Refresh the Agent's node from within the EM 2.2 console.

Expected behavior: After the upgrade, existing jobs and events should continue to run as before. 

The above is a special case of section G.


I. AUTOMATIC STARTUP
--------------------
With release 8.1.7, the Intelligent Agent and Data Gatherer services on Windows N.T will be automatically started after installation, subject to conditions. 

The following are the conditions:

a)If an existing Agent and/or Data Gatherer is running, then the 8.1.7 Agent and Data Gatherer will not be auto-started. 
b) If an existing Agent and Data Gatherer are not running, then the 8.1.7 Agent install process will change the existing Agent and Data Gatherer startup mode to manual(if its set to automatic) and automatically startup the 8.1.7 Agent and Data Gatherer, post installation.
c)If there is no existing Agent and Data Gatherer on the machine, then the 8.1.7 Agent and Data Gatherer will be auto-started after installation.


J. WINDOWS 2000 PROBLEM AND WORKAROUND
--------------------------------------
Problem: "Could not find c:\winnt\temp\21041345280.99" type of error when the Intelligent Agent executes jobs on a Windows 2000 system.

Reason: Windows 2000 allows different operating system level security settings. The above problem can result based on which security schema and subsystem you have chosen.  

Workaround: 

- Make sure that you have privileges to write, update and delete in the 
  C:\WINNT\TEMP directory
- If possible, set the TMP and TEMP environment variable to something
  like C:\TEMP, with that directory having full control for everyone.
- Then restart the Agent, and execute a job again.


K. EBUSINESS MANAGEMENT TOOL CARTRIDGE - WORKAROUND FOR BUG 1338342 
------------------------------------------------------------------- 

If the user restarts the agent when the web server is down, they may see a yellow flag (script failed error) for any existing web server events.  

Workaround is to ensure the web server is up before restarting the agent.

For configuration information, see the Diagnostics Pack Installation and Configuration Guide.


L. BUGS FIXED
-------------

1345319 - OEM_MONITOR ROLE DOES NOT WORK FOR THE CONTINUED ROW EVENT - Generic Bug
1342121 - PERMISSIONS REQUIRED BY CP REPOSITIORY OWNER ARE TOO STRICT - Generic Bug
1336996 - OEMEVENT CAN'T CONNECT ON NT IN NON-FAILSAFE CONFIGURATION
1332291 - JOB-OUTPUT FILE RENAMING DOESN'T SUPPORT NT FAILSAFE CONFIGURATION
1320228 - TBSPFULL.TCL PRODUCING WRONG RESULTS - Generic Bug
1306479 - JOBS AND EVENTS REGISTRATION FAILED IF AGENT IS IN AN ORACLE FAIL SAFE GROUP
1303496 - RECEIVED BAD DATA FROM WAITING SESSIONS- NUMBERFORMATEXCEPTION: 4294967295 - Generic Bug
1286432 - NLS:MULTIBYTE PARAMETER CAUSE INVALID CHARACTER ERR. IN SQL*PLUS SCRIPT JOB
1261843 - NO WAY TO SPECIFY A PARTICULAR MANAGER OR A PARTICULAR PROGRAM TO MONITOR
1260616 - IF OPEN OF ORATCL.TRC FAILS THEN ALL EVENTS WILL FAIL ON EVALUATION
1246714 - COUNT (*) OF TABLE IN PURGE LOOP SHOULD BE CHANGED (POOR PERFORMANCE)
1246022 - VPPCNTL EXITS WITH A -1 (LPM_FAIL)
1236954 - $OH\NETWORK\AGENT\TCL\NULL.TCL MISSING
1236372 - INTELLIGENT AGENT 8.1.5 FOR NT FAILS TO RETRIEVE ALERT.LOG LOCATION 
1231204 - JOBS HANGING AT STARTED
1197576 - STARTUPDB JOB STARTS UP THE DATABASE BUT RETURNS FAILED.
981382  - INTELLIGENT AGENT CANNOT DETECT SERVICES WHEN LISTENER NAME IS NUMERIC!







                                                                                                                                                                                                                                                                                                                                                                                                                      )  *  I  J  K  t  u                                   
  S  T          /  0  t  u  v      ¾~zvrnjf          ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  U] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c   &      L  M          !  "  k  l  m        q	  r	  s	  	  	  	  	  	  	  	  	  
  
  
  ]
  ^
  m
  n
  o
  
  
    ÿ{wsokg            ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c   &    J  K  _  `  a        q  r  s  t          
  
  R  S                      H  I  ~    F  G  y  ÿ|xtplhd      ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  U] c  ] c  U] c  ] c  ] c  ] c  ] c  ] c  U] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c   &y  z    	  
                          #  $  .  /              =  >  {  |  }  ]  ^  _          ÿ{wsokg            ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c   &    
  N  O            	  0  1                        d  e  f  v  w  x            W  X  w  x  ÿ{wsokg            ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c   &x                    #   $   &!  '!  (!  )!  s!  t!  !  !  "  "  "  "  "  "  "  "  "  #  #  #  $  $  $  $  $  $  %  ÿ{wsokg            ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c   &%  %  %  >&  ?&  @&  &  &  &  &  &  &  &  3(  4(  5(  (  (  (  (  (  (  )  )  )  Q)  R)  S)  )  )  )  )  )  )  )  )  )  *  *  ÿ{wsokg            ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c   &*  *  *  *  *  *  *  G+  H+  X,  Y,  ,  ,  ,  ,  -  -  :-  ;-  -  -  -  p.  q.  r.  ~.  .  .  .  .  .  .  (/  )/  n/  o/  /  /  /  ÿ{wsokg            ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c   &/  /  /  /  -0  .0  /0  0  0  0  1  
1  1  k1  l1  m1  n1  {1  |1  1  1  1  1  1  12  22  v2  w2  2  2   3  3  W3  X3  3  3  4  4  d4  ÿ{wsokg            ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c   &d4  e4  4  4  5  5  /5  05  `5  a5  5  5  5  5  6  6  f6  g6  h6  i6  j6  k6  l6  m6  n6  ÿ                                                                                                                                                                                                  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c  ] c       *  J  K  u                   
  T      0  u  v      M                                                                                                                                                                                                                                                                                                M      "  l  m      r	  s	  	  	  	  	  	  
  
  ^
  n
  o
  
    K  `  a                                                                                                                                                                                                                                                                                                     a      r  s  t      S            I    G  z  	  
                                                                                                                                                                                                                                                                                                                       $  /          >  |  }  ^  _        
  O        	  1                                                                                                                                                                                                                                                                                                     1                e  f  w  x        X  x              $   '!                                                                                                                                                                                                                                                                                                     '!  (!  )!  t!  !  "  "  "  "  "  "  #  #  $  $  $  $  %  %  ?&  @&  &  &  &  &                                                                                                                                                                                                                                                                                                     &  4(  5(  (  (  (  (  )  )  R)  S)  )  )  )  )  )  )  *  *  *  *  *  H+  Y,  ,                                                                                                                                                                                                                                                                                                     ,  ,  ,  -  ;-  -  -  q.  r.  .  .  .  .  )/  o/  /  /  /  /  .0  /0  0  0  
1  1                                                                                                                                                                                                                                                                                                     1  l1  m1  n1  |1  1  1  1  22  w2  2  3  X3  3  4  e4  4  5  05  a5  5  5  6  g6  h6                                                                                                                                                                                                                                                                                                     h6  i6  j6  k6  l6  m6  n6                                                                                                                                                                                                                                                                                                                                                                                                                                                                n6     n6  &     m3      ']      K        @  Normal     a	                   " A@ " Default Paragraph Font                                                                                              @                                                                                                                                                                                                                                                                                  
   	           F   Microsoft Word 6.0 Document 
   MSWordDoc    Word.Document.6 9q                                                                                                                                                                                                                                                                                                                                                                                                                              