Document ID:        45300.1
Subject:            Setting up the Intellegent Agent under OpenVMS (Server)
Modified:           16 Apr 97 
Author:             ASHRIVES


Setting up the Agent under OpenVMS (Server Side) 
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

The minimum configuration files needed to get the Intelligent Agent files
under VMS are:

  In TNS_ADMIN:
           - LISTENER.ORA
           - SNMP.ORA
           - SQLNET.ORA
  In ORA_AGENT:
           - DBSNMPCA_NETV2.COM     
           - AGENT_START.COM

Without these files you won't get it to work.

What goes in the files
~~~~~~~~~~~~~~~~~~~~~~

The examples assume you have a local repository on your console.

Listener.ora
~~~~~~~~~~~~

This should be a standard listener.ora as set up for SQL*Net 2. Nothing
specific for intelligent agents needs to go in this file. The listener
must be able to connect to the database that needs to be administered 

To test this listener, use server manager to connect from server manager
on your console to the database to be administered.

Sqlnet.ora
~~~~~~~~~~

This should be the standard sqlnet.ora as set up for basic SQL*Net 2.
Again nothing specific for intelligent agents needs to go into this file.

Snmp.ora
~~~~~~~~
 
Here is a sample snmp.ora. In the example below:
  o V7323 is the SID of the database to be administered.
  o ukaa34 is the host this database is on.
  o 1538 and 1539 are two new FREE ports on the host the agent is running
    as.  
  o The numbers 4, 5 and 6 are arbitrary index numbers. As long as you
    put different numbers on these lines, you'll be okay. 

# SNMP.ORA
# 
#
NMI.TRACE_LEVEL = OFF
NMI.TRACE_MASK = (106)
NMI.TRACE_DIRECTORY = DISK$SUPPORT1:[ORACLE73.V7323.NETWORK.AGENT]
DBSNMP.ADDRESS = (DESCRIPTION=(ADDRESS=(PROTOCOL=TCP)(Host=ukaa34)(Port=1538)))
DBSNMP.SPAWNADDRESS = (DESCRIPTION=(ADDRESS=(PROTOCOL=TCP)(Host=ukaa34)(Port=
1539)))
SNMP.VISIBLESERVICES = (LISTENER,LISTENER_ukaa34,V7323)
SNMP.INDEX.LISTENER = 6
SNMP.INDEX.LISTENER_ukaa34 = 4
SNMP.INDEX.V7323 = 5
SNMP.SID.V7323 = V7323
snmp.oraclehome.V7323.uk.oracle.com = DISK$SUPPORT1:[ORACLE73.DB_V7323]

The snmp.oraclehome line should be set to the ora_db directory for the sid.

If your agent is connecting to more than one database, then you
need to do the following:
  o Add the new SID into the VISIBLESERVICES line
  o Add a new SNMP.INDEX.SID line
  o Add a new SNMP.SID line
  o Add a new SNMP.oraclehome line
  
tnsnames.ora
~~~~~~~~~~~~
A extra tnsnames.ora entry is required only if you have the repository 
stored on the same node (in a different database) as the database you want
to administer. The entry connects the repository to the database being 
administered.  

The entry you would need to add to the tnsnames.ora on the server to correspond
to this is:

   ukaa34_V7323.uk.oracle.com =
     (DESCRIPTION =
       (ADDRESS_LIST =
           (ADDRESS =
             (PROTOCOL = TCP)
             (Host = ukaa34.uk.oracle.com)
             (Port = 1521)
           )
       )
       (CONNECT_DATA =
           (SID = V7323)
       )
   )

It is important this alias is qualified with the same domain name as in
the tnsnames.ora on the console, regardless of any domain settings on the
sqlnet.ora on the server.
   

DBSNMPCA_NETV2.COM
~~~~~~~~~~~~~~~~~~
This file should be derived from the sample file supplied. If you do
no have this file (DBSNMPCA_NETV2_COM.SAMPLE), then you will need an Oracle 
Patch.
Please contact Oracle Worldwide Support for patch 408709.

From the sample file, all you need to change is to insert the correct values for
ora_db, sid and dbname.

AGENT_START.COM
~~~~~~~~~~~~~~~
This file should be derived from the sample file supplied. If you do
no have this file (AGENT_START_COM.SAMPLE), then you will need an Oracle Patch.
Please contact Oracle Worldwide Support for patch 408709.

From the sample file, all you need to change is to insert the correct values for
ora_db, sid and dbname.