starlingx/docs
Code Issues Proposed changes
docs/doc/source/fault/configuring-snmp-trap-destinations.rst
Stone 10e4b9ac86 Fault Management guide 
Removed OSX and MS Visual Code metadata files and directories.

Change-Id: I4e6024767cc072fcb3fc8d88f0724f02819cebc8
Signed-off-by: Stone <ronald.stone@windriver.com>
2020-11-09 13:58:05 -05:00

3.3 KiB
Raw Blame History

Configure SNMP Trap Destinations

SNMP trap destinations are hosts configured in to receive unsolicited SNMP notifications.

Destination hosts are specified by IP address, or by host name if it can be properly resolved by . Notifications are sent to the hosts using a designated community string so that they can be validated.

  1. Configure IP address 10.10.10.1 to receive SNMP notifications using the community string commstr1.

    ~(keystone_admin)$ system snmp-trapdest-add -c commstr1 --ip_address 10.10.10.1
+------------+--------------------------------------+
| Property   | Value                                |
+------------+--------------------------------------+
| uuid       | c7b6774e-7f45-40f5-bcca-3668de2a186f |
| ip_address | 10.10.10.1                           |
| community  | commstr1                             |
| type       | snmpv2c_trap                         |
| port       | 162                                  |
| transport  | udp                                  |
+------------+--------------------------------------+

    The following are attributes associated with the new community string:

    uuid

    The UUID associated with the trap destination object.

    ip_address

    The trap destination IP address.

    community

    The community string value to be associated with the notifications.

    type

    snmpv2c_trap, the only supported message type for SNMP traps.

    port

    The destination UDP port that SNMP notifications are sent to.

    transport

    The transport protocol used to send notifications.

  2. List defined trap destinations.

    ~(keystone_admin)$ system snmp-trapdest-list
+------------+----------------+------+--------------+-----------+
| IP Address  | SNMP Community | Port | Type         | Transport |
+-------------+----------------+------+--------------+-----------+
| 10.10.10.1  | commstr1       | 162  | snmpv2c_trap | udp       |
+-------------+----------------+------+--------------+-----------+

  3. Query access details of a specific trap destination.

    ~(keystone_admin)$ system snmp-trapdest-show 10.10.10.1
+------------+--------------------------------------+
| Property   | Value                                |
+------------+--------------------------------------+
| uuid       | c7b6774e-7f45-40f5-bcca-3668de2a186f |
| ip_address | 10.10.10.1                           |
| community  | commstr1                             |
| type       | snmpv2c_trap                         |
| port       | 162                                  |
| transport  | udp                                  |
+------------+--------------------------------------+

  4. Disable the sending of SNMP notifications to a specific IP address.

    ~(keystone_admin)$ system snmp-trapdest-delete 10.10.10.1
Deleted ip 10.10.10.1