vtc_snmp_files(4M)           DG/UX 5.4 Rel. 2.01          vtc_snmp_files(4M)


NAME
       vtc.snmp.config, vtc.snmp.communities, vtc.snmp.hosts, vtc.snmp.traps
       - SYAC VTC SNMP configuration files

DESCRIPTION
       These files contain SNMP configuration information for SYAC VTC
       boards.  The information contained in these files is communicated to
       the board when tcload is run or when the VTC board is reset.

   vtc.snmp.config
       Use this file to override the default values for some objects.  The
       particular VTC device must be specified first.  All objects listed
       below a VTC device pertain to that particular VTC.  The following is
       a list of objects which may be specified in the vtc.snmp.config file,
       and the default values used by the VTC SNMP agent otherwise:

       sysContact=Unspecified
       sysLocation=Unspecified
       sysName=Unspecified

       Example

           /dev/async/syac@60(60000000)
           sysLocation=lab
           sysName=VTC1
           /dev/async/syac@61(60020000)
           sysLocation=office 103

           Sets the sysLocation and sysName objects for VTC
           /dev/async/syac@60(60000000) to lab and VTC1 respectively.
           And sets the sysLocation for VTC /dev/async/syac@61(60020000)
           to office 103.

   vtc.snmp.communities
       This file is used to define community strings that are to be
       recognized by each VTC's SNMP agent.  The particular VTC device must
       be specified first.  All communities listed below a VTC device
       pertain to that particular VTC.  Each line consists of a community
       and access.  An object ID is a third optional parameter.  If there
       are no entries for a VTC in this file then by default the community
       public will have read access to that VTC's entire MIB.

       community access object

       where:

       community      is an ASCII string of up to 16 characters specifying a
                      community name to be recognized by the agent.

       access         is one of: read, for read-only access, write, for
                      read-write access, or none for no access.

       object         is the object ID of the MIB subtree (or leaf objects)
                      to associate with the specified access.  This field is



Licensed material--property of copyright holder(s)                         1

vtc_snmp_files(4M)           DG/UX 5.4 Rel. 2.01          vtc_snmp_files(4M)


                      optional.  If no object ID is present then the
                      specified access will be associated with the entire
                      MIB.

       Example

           /dev/async/syac@60(60000000)
           public none 1.3.6.1.2.1.1.1
           /dev/async/syac@61(60020000)
           test read

           Gives community public no-access to object ID 1.3.6.1.2.1.1.1
           for VTC /dev/async/syac@60(60000000).  And defines community
           test with read-only access for all objects for VTC
           /dev/async/syac@61(60020000).

   vtc.snmp.hosts
       This file is used to define the IP address or hostname of the remote
       entities from which each VTC's SNMP agent will accept queries for all
       communities.  Note that the VTC does not support a per community
       database of allowed IP addresses.  If an IP address is listed here it
       is allowed for all communities.  If no address is listed then any
       host may communicate with the VTC's SNMP agent.   The particular VTC
       device must be specified first.  All hostnames or IP addresses listed
       below a VTC device pertain to that particular VTC.

       Example

           /dev/async/syac@60(60000000)
           aviion1
           aviion2
           /dev/async/syac@61(60020000)
           128.222.3.24

           Gives the machines named aviion1 and aviion2 access to the SNMP
           agent for VTC /dev/async/syac@60(60000000).  And gives the
           machine with IP address 128.222.3.24 access to the SNMP agent
           for VTC /dev/async/syac@61(60020000).

   vtc.snmp.traps
       This file is used to specify which traps are sent to which hosts for
       each VTC's SNMP agent.  The particular VTC device must be specified
       first.  All traps listed below a VTC device pertain to that
       particular VTC.  Each line consist of four items delimited by a
       space:

       community host port trap

       where:

       community      is an ASCII string specifying a community name to send
                      with the trap message.

       host           is the internet address or hostname specifying which



Licensed material--property of copyright holder(s)                         2

vtc_snmp_files(4M)           DG/UX 5.4 Rel. 2.01          vtc_snmp_files(4M)


                      host to send the trap.

       port           is the UDP port number, which is usually set to 162.

       trap           is the trap type.  The allowable trap types are listed
                      below.

                      Specific_Traps  Description

                      hostRej         Session attempt rejected by host.
                      termRej         Session attempt rejected by terminal.
                      netErr          Session encountered network error.

                      Generic_Traps

                      coldStart
                      warmStart
                      linkDown
                      linkUp
                      authFail
                      egploss

                      Note: See RFC-1157 for Generic trap definitions.

       Example

           /dev/async/syac@60(60000000)
           public 128.222.3.24 162 coldStart

           Sends a trap with community public to IP address 128.222.3.24 at
           port number 162 (snmp-trap) when the SNMP agent for VTC /dev/async
           /syac@60(60000000) experiences a coldStart.

SEE ALSO
       syac(7), vtc.addrs(4M), tcload(1M), vtc_snmp_start(1M),
       vtc_snmp_stop(1M),





















Licensed material--property of copyright holder(s)                         3