vtc_snmp_files(4M)               DG/UX R4.11              vtc_snmp_files(4M)


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

SYNOPSIS
       /etc/tcload/vtc.snmp.config

       /etc/tcload/vtc.snmp.communities

       /etc/tcload/vtc.snmp.hosts

       /etc/tcload/vtc.snmp.traps

DESCRIPTION
       These files contain SNMP configuration information for VMEbus/PCI bus
       Terminal Controller (VTC/PTC) boards.  The information contained in
       these files is communicated to the board when tcload is run or when
       the board is reset.

       Note that if an entry is added or modified for a VTC/PTC that is part
       of a failover configuration involving a remote host, then the
       failover databases must be synchronized with that remote host after
       modifications are complete (see admfailovervtc(1M)). To use the
       remote failover functionality, you must have either the Failover
       package or the DG/UX Cluster Software product installed.

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

       sysContact=Unspecified
       sysLocation=Unspecified
       sysName=Unspecified

       Examples

                /dev/async/ctrl/syac(vme(0),0)
                sysLocation=v_lab
                sysName=VTC1
                /dev/async/ctrl/syac(vme(0),1)
                sysLocation=office 103


       Sets the sysLocation and sysName objects for VTC
       /dev/async/ctrl/syac(vme(0),0) to v_lab and VTC1 respectively.  And
       sets the sysLocation for VTC /dev/async/ctrl/syac(vme(0),1) to office
       103.

            /dev/async/ctrl/spac(pci(0),F,0)
            sysLocation=p_lab
            sysName=PTC1
            /dev/async/ctrl/spac(pci(0),12,0)
            sysLocation=office 106


       Sets the sysLocation and sysName objects for PTC
       /dev/async/ctrl/spac(pci(0),F,0) to p_lab and PTC1 respectively.
       And sets the sysLocation for PTC /dev/async/ctrl/spac(pci(0),12,0)
       to office 106.


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

       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
                      optional.  If no object ID is present then the
                      specified access will be associated with the entire
                      MIB.

       Examples

                /dev/async/ctrl/syac(vme(0),0)
                v_public none 1.3.6.1.2.1.1.1
                /dev/async/ctrl/syac(vme(0),1)
                v_test read


       Gives community v_public no-access to object ID 1.3.6.1.2.1.1.1 for
       VTC /dev/async/ctrl/syac(vme(0),0).  And defines community v_test
       with read-only access to all objects for VTC
       /dev/async/ctrl/syac(vme(0),1).

            /dev/async/ctrl/spac(pci(0),F,0)
            p_public none 1.3.6.1.2.1.1.1
            /dev/async/ctrl/spac(pci(0),12,0)
            p_test write


       Gives community p_public no-access to object ID 1.3.6.1.2.1.1.1 for
       PTC /dev/async/ctrl/spac(pci(0),F,0).  And defines community p_test
       with read-write access to all objects for PTC
       /dev/async/ctrl/spac(pci(0),12,0).

   vtc.snmp.hosts
       This file is used to define the IP address or hostname of the remote
       entities from which each VTC's/PTC's SNMP agent will accept queries
       for all communities.  Note that neither the VTC nor the PTC supports
       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/PTC's SNMP agent.
       The particular VTC/PTC device must be specified first.  All hostnames
       or IP addresses listed below a VTC/PTC pertain to that particular
       device.

       Examples

                /dev/async/ctrl/syac(vme(0),0)
                system1
                system2
                /dev/async/ctrl/syac(vme(0),1)
                128.222.3.24


       Gives the machines named system1 and system2 access to the SNMP agent
       for VTC /dev/async/ctrl/syac(vme(0),0).  And gives the machine with
       IP address 128.222.3.24 access to the SNMP agent for VTC
       /dev/async/ctrl/syac(vme(0),1).

            /dev/async/ctrl/spac(pci(0),F,0)
            system3
            system4
            /dev/async/ctrl/spac(pci(0),12,0)
            128.222.3.25


       Gives the machines named system3 and system4 access to the SNMP agent
       for PTC /dev/async/ctrl/spac(pci(0),F,0).  And gives the machine with
       IP address 128.222.3.25 access to the SNMP agent for PTC
       /dev/async/ctrl/spac(pci(0),12,0).


   vtc.snmp.traps
       This file is used to specify which traps are sent to which hosts for
       each VTC's/PTC's SNMP agent.  The particular VTC/PTC device must be
       specified first.  All traps listed below a VTC/PTC pertain to that
       particular device.  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
                      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.

                      SpecificTraps  Description

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

                      GenericTraps

                      coldStart
                      warmStart
                      linkDown
                      linkUp
                      authFail
                      egploss

                      Note: See RFC-1157 for Generic trap definitions.

       Examples

                /dev/async/ctrl/syac(vme(0),0)
                v_public 128.222.3.24 162 coldStart


       Sends a trap with community v_public to IP address 128.222.3.24 at
       port number 162 (snmp-trap) when the SNMP agent for VTC /dev/async/
       ctrl/syac(vme(0),0) experiences a coldStart.

            /dev/async/ctrl/spac(pci(0),F,0)
            p_public system3 162 linkDown


       Sends a trap with community p_public to the machine named system3 at
       port number 162 (snmp-trap) when the SNMP agent for PTC /dev/async/
       ctrl/spac(pci(0),F,0) experiences a linkDown.

SEE ALSO
       syac(7), vtc.addrs(4M), tcload(1M), vtcsnmpstart(1M),
       vtcsnmpstop(1M), admfailovervtc(1M).


Licensed material--property of copyright holder(s)