Managing the SNMP agent

About the filer SNMP agent

The filer SNMP agent responds to queries and sends traps to network management stations. The filer SNMP agent does not have write privileges--that is, it cannot be used to take corrective action in response to a trap.

What SNMP agent management includes

To configure the SNMP agent on your filer, you must do all the following:

Verify that SNMP is enabled
SNMP is enabled by default in Data ONTAP.
Enable traps
Although SNMP is enabled by default, traps are disabled by default.
Specify one or more network management station host names
No traps are sent unless at least one SNMP management station is specified as a trap host. Trap notifications can be sent to a maximum of eight network management stations.

You can optionally do any or all of the following:

Provide courtesy information about filer location and contact personnel
Set SNMP access privileges
You can restrict SNMP access on a host or interface basis. See Setting SNMP access privileges.
Specify SNMP communities
Community strings function as group names to establish trust between SNMP managers and clients. Data ONTAP imposes the following limitations on SNMP communities:
- No more than eight communities are allowed.
- Only read-only communities are supported.
Enable query authentication
You can enable SNMP agent authentication failure traps, which are generated when the agent receives queries with the wrong community string. The traps are sent to all hosts specified as trap hosts.
Create and load user-defined traps
For more information, see Creating SNMP traps.

You can also view current SNMP and trap configuration.

The following sections explain how to perform these tasks.

Note
Filers in a cluster can have different SNMP configurations.

For more information, see the NetApp snmp(1) manual page.

About configuration tools

The following tools are available for filer SNMP configuration and management:

command line interface	graphical interface
`snmp` command For more information, see the NetApp snmp(1) manual page.	FilerView SNMP windows For more information, see FilerView Help.

command line interface

graphical interface

snmp command

For more information, see the NetApp snmp(1) manual page.

FilerView SNMP windows

For more information, see FilerView Help.

Note
SNMP commands entered at the command line or in FilerView are persistent across reboots.

Enabling SNMP at the command line

To enable SNMP, complete the following step.

Step	Action
1	Enter the following command at the filer command line: options snmp.enable {on\|off} Enables (with value `on`) or disables (with value `off`) SNMP in Data ONTAP. For more information about this option, see the NetApp options(1) manual page.

Setting SNMP access privileges

To set SNMP access privileges on a host or interface basis, complete the following step. (You cannot set SNMP access privileges in FilerView.)

Step	Action
1	Enter the following command at the filer command line: options snmp.access options For details about using this option, see the NetApp protocolaccess(8) manual page.

Viewing and modifying SNMP configuration values at the command line

To view or modify SNMP configuration values, complete the following step.

Step	Action
1	Enter the following command at the filer command line: *snmp {options values}* Examples of configuration values are listed in Example of typical SNMP commands. For more information about `snmp` parameters, see Command syntax for SNMP configuration parameters.

Viewing and modifying SNMP configuration values with FilerView

To view or modify SNMP configuration values with FilerView, complete the following steps.

Step	Action
1	In FilerView, click SNMP in the list on the left.
2	In the list under SNMP, click Configure.
3	If you want to....	Then...
	View SNMP configuration values	The current configuration is displayed.
	Set or modify SNMP configuration values	Enter configuration values in drop-down lists or text fields. Click Apply when finished. Examples of configuration values are listed in Example of typical SNMP commands.

Command syntax for SNMP configuration parameters

The following table lists the SNMP configuration commands and parameters available in Data ONTAP. If you specify one or more value for an option of the SNMP commands, the value of that option is set or changed. However, if no values are specified, the current value of that option is returned.

Command	Description
snmp	Displays the current values of all SNMP options, such as `init`, `community`, `contact`, and `traphost`.
snmp authtrap [0\|1]	With a value: Enables (with value 1) or disables (with value 0) SNMP agent authentication failure traps. Without a value: Displays the current value of `authtrap` set in Data ONTAP.
snmp community	Displays the current list of communities.
snmp community add ro community	Adds a community. Default value: The default community for the SNMP agent in Data ONTAP is public. The only access mode available on filers is the default ro (read-only).
snmp community delete {all \| ro community}	Deletes one or all communities.
snmp contact [contact]	With the option: Sets the contact name for the filer. You must enclose the contact string in single quotes (` ') if the string contains spaces. Without the option: Displays the current contact name set in Data ONTAP.
snmp init [0\|1]	With a value: Enables (with value 1) or disables (with value 0) built-in traps and the traps defined using the `snmp traps` command. Without a value: Displays the current value of `snmp init` in Data ONTAP. Default value: By default, SNMP traps are disabled in Data ONTAP; the system uses the equivalent of `snmp init 0`.
snmp location [location]	With the option: Sets the location of the filer. You must enclose the location string in single quotes (` ') if the string contains spaces. Without the option: Displays the current location set in Data ONTAP.
snmp traphost [{add\|delete} {hostname\|ipaddress}]	With the option: Adds or deletes SNMP hosts that receive traps from Data ONTAP. Without the option: Displays the current trap hosts set in Data ONTAP.
snmp traps [options]	See Command syntax for SNMP trap parameters.

Example of typical SNMP commands

The following example shows a typical set of commands to configure SNMP monitoring. It assumes that SNMP remains enabled by default.

snmp contact 'jdoe@abc.com 415-555-1212'

snmp location 'ABC corporation, engineering lab'

snmp community add ro private

snmp traphost add snmp-mgr1

snmp init 1