snmp_host ‑add

Creates a new SNMP query host or SNMP trap host entry on the Oracle FS System.

SYNOPSIS

snmp_host ‑add 
   ‑name snmp‑host‑name
   ‑ip snmp‑host‑ip‑or‑dns
   ‑community snmp‑community
   [ ‑trapPort port‑number
     [‑trapEvent {informational | warning | critical}]
   ]

   [{‑sessionKey | ‑u admin‑user ‑oracleFS oracle‑fs‑system}]
   [{‑outputformat | ‑o} { text | xml }]
   [{‑timeout timeout‑in‑seconds | ‑verify | ‑usage | ‑example | ‑help}]

DESCRIPTION

Use the snmp_host -add command to configure the following types of SNMP hosts:

SNMP trap host: A host that asynchronously receives event traps sent from the Oracle FS System.
SNMP query host: A host that uses the Oracle FS System MIB to issue SNMP queries to the Oracle FS System.

To create an SNMP trap host entry, run the snmp_host ‑add command. When you construct this command, provide all of the following information:

An IP address or a DNS name of the SNMP trap host.
A unique name for the Oracle FS System to use to identify the host.
The community string for the Oracle FS System to use when sending event traps to the host, or to authenticate SNMP queries from a query host.

Note: Do not use the community strings public or private. This community string must match the string configured on the query or trap host.
For SNMP trap hosts, the host port for the Oracle FS System to use for sending event traps. The standard port used by most SNMP trap hosts is 162.
For SNMP query hosts, the port the host uses to query the Oracle FS System. The standard port used by most SNMP trap hosts is 161.
The severity threshold of the desired event traps.

Note: To enable the SNMP service for a given host, you must provide an SNMP trap port number. If no port number is specified, no event traps are sent.

To set the severity threshold, specify the least severe level of events in which you are interested. For example, if you set a threshold of warning, the Oracle FS System sends warning and critical event traps, but it does not send event traps that are informational.

Note: Administrators with primary administrator or admin1 roles are authorized to run the snmp_host ‑add command.

OPTIONS

‑community: Identifies the community string for the Oracle FS System to use when it sends an event trap to the SNMP trap host. The default ispublic. Use a community string that is specific and unique to your data center.
‑ip: Specifies the IP address or domain name of a client to which the Oracle FS System sends SNMP trap information.
‑name: Specifies a unique name that you provide to identify the SNMP trap host. The name that you provide can be any name and does not need to be the DNS name. Use double quotation marks around names that contain spaces or dashes.
‑trapEvent: Identifies the severity threshold for events that are sent in event traps to the SNMP trap host. Event traps are sent when the specified and more severe level is reached.
‑trapPort: Identifies the SNMP trap host port number to use for sending an event trap. The default universally defined port (UDP) is port 162. Do not specify another value unless your host is configured to receive traps on another port. If you do not provide this option, no traps are sent to the SNMP trap host.

EXAMPLE

Task

Create an SNMP trap host entry and specify the SNMP trap event severity.

Parameters

The unique name of the SNMP trap host: snmp_trap_server_1
The IP address: 192.168.10.5
The community string: IT-storage
The trap port: 162
The trap event threshold: warning

$ fscli snmp_host ‑add ‑name snmp_trap_server_1 ‑ip 192.168.10.5 ‑community IT-storage ‑trapPort 162 ‑trapEvent warning

Task

Create an SNMP query host entry.

Parameters

The unique name of the SNMP query host: snmp_query_server_2
The IP address: 192.168.10.10
The community string: IT-storage
The query port: 161
The trap event threshold: warning

$ fscli snmp_host ‑add ‑name snmp_trap_server_2 ‑ip 192.168.10.10 ‑community IT-storage ‑trapPort 161