snmp_host

Configures the SNMP services that are available on the Oracle FS System. The Oracle FS System does not allow an SNMP host to write or change any configuration or setting on the system. Only SNMP queries defined in the Oracle FS System MIB are supported.

SYNOPSIS

snmp_host { [ ‑add | ‑delete | ‑list | ‑modify ] | [ ‑usage | ‑help ] }

DESCRIPTION

The snmp_host command defines a host as a trap host or a query host.

SNMP trap host: A host that receives SNMP traps that are asynchronously sent by the Oracle FS System when the severity of an event meets a specified threshold. Use the snmp_host command to specify how and where SNMP event traps are sent to one or more SNMP trap hosts. Any host that has a SNMP‑based management application installed on it can be an SNMP trap host. The Oracle FS System SNMP MIB must be installed or imported into the SNMP management application on the trap host in order to interpret the traps.
SNMP host: A host that queries the Oracle FS System by issuing SNMP requests. For a host to query the Oracle FS System, you must download the Oracle FS System MIB and then install it on that SNMP Host using the instructions of the SNMP management software vendor for importing or installing a MIB.

To configure an SNMP host to be able to query the Oracle FS System, perform the following tasks:

First, download the MIB for the Oracle FS System from the Oracle FS System Manager GUI. You can also download the MIB from the Oracle FS System home page using the hostname or IP address of the Oracle FS System.
Next, install or import the MIB on your host machine according to the instructions for the SNMP management software on your SNMP host. Use port 161 to issue SNMP queries to the Oracle FS System.
On the Oracle FS System, run the snmp_host command, perform the following tasks in any order:
- Identify the SNMP host by an IP address or a DNS name.
- Provide a unique name for the SNMP trap host on the Oracle FS System.
- Specify the community string that the host uses to query the Oracle FS System.
  Note: Do not use the community strings public or private.
- Specify the SNMP port number for the host to use to query the Oracle FS System. The standard port number is 161.
- Install or import the Oracle FS System MIB on the SNMP management application on that host.

To configure an SNMP trap host to receive SNMP event traps, perform the following tasks in any order:

Identify the SNMP trap host by an IP address or a DNS name.
Enter the IP address or DNS name for the SNMP trap host on the Oracle FS System.
Specify the community string that has been configured on the trap host that the Oracle FS System must use when sending traps to the trap host.
Note: Do not use the community strings public or private.
Specify the SNMP port number for the Oracle FS System to use to send the event traps. The standard port number is 162.
Specify a severity threshold to filter event traps.
Install or import the Oracle FS System MIB on the SNMP management application on that trap host.

The SNMP traps are asynchronous notifications of system events. The Oracle FS System filters system events based on the following severity levels:

Informational
Warning
Critical

When selecting an event severity threshold, use the most specific level in which you are interested.

SUBCOMMANDS

‑add: Creates a new SNMP query host or SNMP trap host entry on the Oracle FS System.
‑delete: Deletes an SNMP trap host entry from the Oracle FS System.
‑list: Displays information about the SNMP trap and query hosts.
‑modify: Modifies the settings of an existing SNMP trap or query 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