NAME

sendtrap - Oracle HSM Simple Network Management Protocol (SNMP) trap notification script

SYNOPSIS

∕etc∕opt∕SUNWsamfs∕scripts∕sendtrap

AVAILABILITY

SUNWsamfs

SUNWqfs

DESCRIPTION

The sendtrap script publishes Oracle HSM 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:

It is invoked with 7 arguments if it is an archiver, stager, releaser, recycler, or file system alert.
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:

Use vi (1) or another editor to open file ∕etc∕opt∕SUNWsamfs∕defaults.conf.
Edit the file so that the alerts=on directive appears.
Save and close the defaults.conf file.
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.