Updating the SNMP agent

You might want to disable SNMP notifications, update community strings, or add or remove agent addresses, USM users, and trap destinations.

Before you begin

About this task

Whenever you update the SNMP agent configuration, be aware that you must click Save at the bottom on the SNMP Agent page to commit any changes you have made on each tab.

Procedure

  1. Select Configuration > Monitoring > SNMP Agent.
    The SNMP Agent page appears.
  2. If you want to disable the SNMP agent on all grid nodes, unselect the Enable SNMP check box, and click Save.
    The SNMP agent is disabled for all grid nodes. If you later re-enable the agent, any previous SNMP configuration settings are retained.
  3. Optionally, update the values you entered for System Contact and System Location.
  4. Optionally, unselect the Enable SNMP Agent Notifications check box if you no longer want the StorageGRID SNMP agent to send trap and inform notifications.
    When this check box is unselected, the SNMP agent supports read-only MIB access, but it does not send any SNMP notifications.
  5. Optionally, unselect the Enable Authentication Traps check box if you no longer want the StorageGRID SNMP agent to send an authentication trap when it receives an improperly authenticated protocol message.
  6. If you use SNMPv1 or SNMPv2c, optionally update the Community Strings section.
    The fields in this section are used for community-based authentication in SNMPv1 or SNMPv2c. These fields do not apply to SNMPv3.
    Note: If you want to remove the default community string, you must first ensure that all trap destinations use a custom community string.
  7. If you want to update agent addresses, select the Agent Addresses tab in the Other Configurations section.

    SNMP Other Configurations Agent Addresses Table

    Use this tab to specify one or more listening addresses. These are the StorageGRID addresses on which the SNMP agent can receive queries. Each agent address includes an internet protocol, a transport protocol, a StorageGRID network, and a port.

    1. To add an agent address, click Create. Then, refer to the step for agent addresses in the instructions for configuring the SNMP agent.
    2. To edit an agent address, select the radio button for the address, and click Edit. Then, refer to the step for agent addresses in the instructions for configuring the SNMP agent.
    3. To remove an agent address, select the radio button for the address, and click Remove. Then, click OK to confirm that you want to remove this address.
    4. To commit your changes, click Save at the bottom of the SNMP Agent page.
  8. If you want to update USM users, select the USM Users tab in the Other Configurations section.

    SNMP Other Config USM User Table
    Use this tab to define the USM users who are authorized to query the MIB or to receive traps and informs.
    1. To add a USM user, click Create. Then, refer to the step for USM users in the instructions for configuring the SNMP agent.
    2. To edit a USM user, select the radio button for the user, and click Edit. Then, refer to the step for USM users in the instructions for configuring the SNMP agent.
      The username for an existing USM user cannot be changed. If you need to change a username, you must remove the user and create a new one.
      Note: If you add or remove a user's authoritative engine ID and that user is currently selected for a destination, you must edit or remove the destination, as described in step 9. Otherwise, a validation error occurs when you save the SNMP agent configuration.
    3. To remove a USM user, select the radio button for the user, and click Remove. Then, click OK to confirm that you want to remove this user.
      Note: If the user you removed is currently selected for a trap destination, you must edit or remove the destination, as described in step 9. Otherwise, a validation error occurs when you save the SNMP agent configuration.

      SNMP USM User Remove Error
    4. To commit your changes, click Save at the bottom of the SNMP Agent page.
  9. If you want to update trap destinations, select the Trap Destinations tab in the Other Configurations section.

    SNMP Other Configurations Trap Dest Table
    The Trap Destinations tab allows you to define one or more destinations for StorageGRID trap or inform notifications. When you enable the SNMP agent and click Save, StorageGRID starts sending notifications to each defined destination. Notifications are sent when alerts and alarms are triggered. Standard notifications are also sent for the supported MIB-II entities (for example, ifDown and coldStart).
    1. To add a trap destination, click Create. Then, refer to the step for trap destinations in the instructions for configuring the SNMP agent.
    2. To edit a trap destination, select the radio button for the user, and click Edit. Then, refer to the step for trap destinations in the instructions for configuring the SNMP agent.
    3. To remove a trap destination, select the radio button for the destination, and click Remove. Then, click OK to confirm that you want to remove this destination.
    4. To commit your changes, click Save at the bottom of the SNMP Agent page.
  10. When you have updated the SNMP agent configuration, click Save.