Skip Navigation Links | |
Exit Print View | |
Sun QFS and Sun Storage Archive Manager 5.3 Reference Manual Sun QFS and Sun Storage Archive Manager 5.3 Information Library |
1. User Commands (Man Pages Section 1)
2. Maintenance Commands (Man Pages Section 1M)
3. Library Functions (Man Pages Section 3)
4. Library Functions (Man Pages Section 3X)
5. File Formats (Man Pages Section 4)
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).