snmp_host ‑modify

Modifies the settings of an existing SNMP trap or query host.

SYNOPSIS

snmp_host ‑modify 
   ‑id snmp‑host‑id‑or‑fqn
   [‑name new‑snmp‑host‑name]
   [‑ip snmp‑host‑ip‑or‑dns]
   [‑community snmp‑community]
   [{ ‑newTrap ‑trapPort port‑number
      [‑trapEvent {informational | warning | critical}]
    | ‑removeTrap
    } ]

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

DESCRIPTION

To modify the settings for an existing SNMP trap host, identify the host by providing its name preceded by a forward slash ( / ) character, or its unique ID. Run the snmp_host ‑list command to display the names and IDs of all of the SNMP trap host entries.

To define a new event severity threshold, run the snmp_host ‑modify ‑newTrap command. If the SNMP trap host entry already has SNMP traps defined, the new trap definitions replace the previous definitions. For example, if you have previously set the event severity threshold to informational, your SNMP trap host currently receives informational, warning and critical events. If you now set the severity to critical, only the critical events are sent to the SNMP trap host.

To disable the SNMP service for a given host, run the snmp_host ‑modify ‑removeTrap command. This will still allow that host to send SNMP queries, but will no longer send traps to the specified host.

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

OPTIONS

‑community: Identifies the community string for the Oracle FS System to use when it sends an event trap to the SNMP 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.
‑id: Specifies the unique ID or the name of an existing SNMP trap host. Include a forward slash ( / ) character before the name.
‑ip: Specifies the IP address or name of a host 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 hostname. Use double quotation marks around names that contain spaces or dashes.
‑newTrap: Identifies a new trap setting for the SNMP trap host. The ‑newtrap option is followed by the ‑trapPort or the ‑trapEvent option.
‑removeTrap: Instructs the Oracle FS System to stop sending event traps to the SNMP trap host.
‑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

Set a new event trap for an SNMP trap host.

Parameters

The name of the SNMP trap host preceded by a forward slash ( / ): /⁠snmp_trap_agent_1
The new event trap category: critical

$ fscli snmp_host -modify ‑id /⁠snmp_trap_agent_1 ‑trapEvent critical