sendtrap(1M)

NAME
     sendtrap - SAM-QFS Simple Network Management Protocol (SNMP)
     trap notification script

SYNOPSIS
     /etc/opt/SUNWsamfs/scripts/sendtrap

AVAILABILITY
     SUNWsamfs

     SUNWqfs

DESCRIPTION
     The sendtrap script publishes SAM-QFS SNMP trap events. It
     is executed by the syseventd(1M) daemon when it encounters
     abnormal or exceptional events including tapealert(1M)
     events.  The SNMP version supported is SNMPv2c.

     As released, sendtrap is a script that sends a trap to the
     local host.

     The syseventd(1M) daemon executes sendtrap as follows:

     o It is invoked with 7 arguments if it is an archiver,
       stager, releaser, recycler, or file system alert.

     o It is invoked with 13 arguments if it is a tapealert(1M)
       event.

     The arguments used are as follows:

     Argument  Meaning

     1         A keyword identifying the category of the alert
               (archiver, stager, releaser, recycler, file
               system, tapeAlert(1M), and so on).

     2         The subcategory or specific type of alert.  For
               example, keywords such as CmdErr to express errors
               in the command files, ReadWarning to express tape
               drive read problems, and so on.)

     3         The error type.  This identifies the severity and
               syslog level of the event, as follows:

               Error Type     Values

               0              Emergency

               1              Alert

               2              Critical

               3              Error

               4              Warning

     4         The message number as found in the message
               catalog.  For tapealert(1M) events, this is a
               concatenation of the Manual type (SSC2/SMC2) and
               the parameter code as found in the ANSI SCSI-3
               SSC2 and SMC2 Manuals at www.t10.org.

     5         The system identifier.  That is, the host name of
               the machine upon which the event originated.

     6         The text  of  the  translated  message string.

     7         The date and time when the event occurred.

     8         The vendor name of the device.  From SCSI INQUIRY.
               Used only for tapealert(1M) events.

     9         The product identity of the device.  From SCSI
               INQUIRY.  Used only for tapealert(1M) events.

     10        The revision number of the device.  From SCSI
               INQUIRY.  Used only for tapealert(1M) events.

     11        The device name.  For example, /dev/rmt/3cbn.
               Used only for tapealert(1M) events.

     12        The Volume Serial Name (VSN) of the tape.  Used
               only for tapealert(1M) events.

     13        The probable cause of the tape alert.  Used only
               for tapealert(1M) events.

  Configuring SNMP
     To enable SNMP reporting, perform the following steps:

     1. Use vi(1) or another editor to open file
        /etc/opt/SUNWsamfs/defaults.conf.

     2. Edit the file so that the alerts=on directive appears.

     3. Save and close the defaults.conf file.

     4. Issue the samd(1M) config command to reconfigure the
        sam-fsd(1M) daemon.

  Modifying the Trap Destination Host
     By default, traps are sent to port 161 of the localhost.  To
     change the port number or the hostname of the trap
     destination, modify the TRAP_DESTINATION="hostname:port"
     variable in this script.

     This trap destination hostname must be declared in NIS on
     /etc/hosts.

     You can specify that traps be sent to multiple hosts.
     Separate multiple hostname:port specifications with a space
     character.  For example:

     TRAP_DESTINATION="localhost:161 doodle:163 mgmt_station:1162"

  Modifying the SNMP Community String
     To modify the SNMP community string, modify the value of the
     COMMUNITY variable in this script.  By default, the SNMP
     community string is set to public.

SEE ALSO
     sam-fsd(1M), samd(1M), syseventd(1M), tapealert(1M).