HP StoreOnce Backup System CLI Reference Guide

snmp add trapsink
Description of Command Function
Defines a host to which the SNMP agent sends traps. Parameters for SNMP versions 1 and 2 differ
from those for SNMP version 3. This command is supported on all versions of SNMP.
Command Syntax
SNMP versions 1 and 2:
snmp add trapsink <FQDN|IP> [version {1|2}] [port <Number>]
[trap-community <”string”>] [events {alert|warn|info}]
SNMP version 3:
snmp add trapsink <FQDN | IP> version 3 user <”username”> [port <Number>]
[events {alert|warn|info}] [authentication-algo {MD5|SHA}]
[“authuthentication-pwd” <authentication-password>] [privacy-algo
{DES|AES}] [privacy-pwd <”privacy-password”>] [contextname
<”contextname”>]
Command Authority
Administrator
Command Object Requirements
Not applicable – no objects exist within this command.
Command Parameter Requirements
• FQDN or IP – This is a required parameter. The value is either the fully-qualified name or IP
address of the host to receive the SNMP traps (also known as the trap sink).
• user(v3 only) – This required parameter is an existing authorized SNMP user name.
• port – This is an optional parameter which consists of the text, port, followed by the port
number of the host. If this parameter is not included, a default port value of 162 is used.
NOTE: Only one port can be defined per trap host.
• trap-community – This optional parameter defines the community name (i.e., password string)
for the trap host. The parameter consists of the text, trap-community, followed by the
password string. The string is in quotation marks. If this parameter is not used; a default of
public is used.
• events – This optional parameter filters what traps are transmitted to the defined trap host. The
parameter consists of text, events, followed by a filter level of alert or warning or info.
The SNMP agent transmits to the trap host all events which are at or higher in severity than
the defined event level. If this parameter is not included in the command sequence, a default
value of info is used (all events are transmitted).
• authorization-algo(v3 only) – This optional parameter specifies the user authentication algorithm
used to authorize messages sent or received on behalf of this user (default is MD5).
• authentication-password(v3 only) – This optional parameter specifies the user authentication
password (default is no password set). Passwords must contain at least eight characters.
• privacy-algo(v3 only) – This optional parameter identifies the SNMP version 3 privacy algorithm
used to encrypt messages or received on behalf of this user (default is DES).
158 Alphabetical List of Commands and Details