13.2.5 setagtsnmp (SNMP Settings Command of Agent)

NAME

setagtsnmp - SNMP settings of Storage Cruiser's agent

SYNOPSIS

For Windows environments

powershell -ExecutionPolicy Unrestricted $INS_DIR\ESC\Agent\bin\setagtsnmp.ps1 -l

powershell -ExecutionPolicy Unrestricted $INS_DIR\ESC\Agent\bin\setagtsnmp.ps1 -t 1

powershell -ExecutionPolicy Unrestricted $INS_DIR\ESC\Agent\bin\setagtsnmp.ps1 -t 3 parameterFile

($INS_DIR means "Program Directory" specified at the Storage Cruiser's agent installation.)

For Solaris or Linux environments

/opt/FJSVssage/bin/setagtsnmp -l

/opt/FJSVssage/bin/setagtsnmp -t 1

/opt/FJSVssage/bin/setagtsnmp -t 3 parameterFile

DESCRIPTION

Set the SNMP Traps to be sent from Storage Cruiser's agent or display the set status.

OPERANDS

parameterFile

Specify the file that describes the SNMPv3 user setting information.
Specify a text file described in "name=value" format.
Lines where the first column starts with "#" are seen as comments.
The user information set in this file can be used for sending SNMPv3 Traps. You must match the user information that is set on the ETERNUS SF Manager side to receive traps.

Table 13.3 File Specification Format
Name	Value
user.name	Specify the user name for SNMP communication. The character string can be specified with up to 32 alphanumeric characters and symbols. However, this excludes double quotation (") and single quotation ('). The character string is case sensitive. This parameter must be specified.
authentication.protocol	Specify the authentication algorithm. Either of the following can be specified: MD5 SHA This parameter is optional. Specify this parameter when performing an authentication.
authentication.password	Specify the password to be used for authentication. The character string can be specified with eight to 64 alphanumeric characters and symbols. However, this excludes double quotation (") and single quotation ('). The character string is case sensitive. This parameter must be specified when specifying the [authentication.protocol].
privacy.protocol	Specify the encryption algorithm. Any of the following can be specified: DES 3DES AES AES192 AES256 This parameter is optional. Specify this parameter when specifying the [authentication.protocol] and when performing an encryption.
privacy.password	Specify the encryption password. The character string can be specified with eight to 64 alphanumeric characters and symbols. However, this excludes double quotation (") and single quotation ('). The character string is case sensitive. This parameter must be specified when specifying the [privacy protocol].

When using the default trap receiving user (esfagent) on the ETERNUS SF Manager side, you do not need to specify an authentication algorithm and encryption algorithm.

OPTIONS

-l: Displays the current settings in CSV format.

-t 1: Outputs traps in SNMPv1 format.

-t 3: Outputs traps in SNMPv3 format. The setting information follows the information specified by the parameterFile operand.

EXAMPLES

Displays the current SNMP settings.

> setagtsnmp -l
version,user.name,authentication.protocol, privacy.protocol
"3","esfagent","MD5","DES"

> setagtsnmp -l
version,user.name,authentication.protocol, privacy.protocol
"1",,,

Sets the SNMP Traps that are output by the agent to the SNMPv3 format (when the user name is "esfuser", the authentication algorithm is "SHA", and the authentication password is "abcd@123").
```
> setagtsnmp -t 3 parameter_file
```
```
#Parameter_file content:
user.name=esfuser
authentication.protocol=SHA
authentication.password=abcd@123
```