mellanox.onyx.onyx_snmp – Manages SNMP general configurations on Mellanox ONYX network devices
mellanox.onyx.onyx_snmp – Manages SNMP general configurations on Mellanox ONYX network devices
Note
This plugin is part of the mellanox.onyx collection (version 1.0.0).
To install it use: ansible-galaxy collection install mellanox.onyx
.
To use it in a playbook, specify: mellanox.onyx.onyx_snmp
.
New in version 0.2.0: of mellanox.onyx
Synopsis
- This module provides declarative management of SNMP on Mellanox ONYX network devices.
Parameters
Parameter | Choices/Defaults | Comments | |
---|---|---|---|
communities_enabled boolean |
|
Enables/Disables community-based authentication on the system. | |
contact_name string |
Sets the SNMP contact name. | ||
engine_id_reset boolean |
|
Sets SNMPv3 engineID to node unique value. | |
location string |
Sets the SNMP location. | ||
multi_communities_enabled boolean |
|
Enables/Disables multiple communities to be configured. | |
notify_community string |
Sets the default community for SNMP v1 and v2c notifications sent to hosts which do not have a community override set. | ||
notify_enabled boolean |
|
Enables/Disables sending of SNMP notifications (traps and informs) from thee system. | |
notify_event string |
|
Specifys which events will be sent as SNMP notifications. | |
notify_port string |
Sets the default port to which notifications are sent. | ||
notify_send_test string |
|
Sends a test notification. | |
snmp_communities list / elements=string |
List of snmp communities | ||
community_name string / required |
Configures snmp community name. | ||
community_type string |
|
Add this community as either a read-only or read-write community. | |
state string |
|
Used to decide if you want to delete the given snmp community or not | |
snmp_permissions list / elements=string |
Allow SNMPSET requests for items in a MIB. | ||
permission_type string |
|
Configures the request type. | |
state_enabled boolean / required |
|
Enables/Disables the request. | |
state_enabled boolean |
|
Enables/Disables the state of the SNMP configuration. |
Examples
- name: Configure SNMP
onyx_snmp:
state_enabled: yes
contact_name: sara
location: Nablus
communities_enabled: no
multi_communities_enabled: no
notify_enabled: yes
notify_port: 1
notify_community: community_1
notify_send_test: yes
notify_event: temperature-too-high
snmp_communities:
- community_name: public
community_type: read-only
state: absent
snmp_permissions:
- state_enabled: yes
permission_type: MELLANOX-CONFIG-DB-MIB
Return Values
Common return values are documented here, the following are the fields unique to this module:
Key | Returned | Description |
---|---|---|
commands list / elements=string |
always. |
The list of configuration mode commands to send to the device
Sample: ['snmp-server enable', 'no snmp-server enable', 'snmp-server location ', 'snmp-server contact ', 'snmp-server enable communities', 'no snmp-server enable communities', 'snmp-server enable mult-communities', 'no snmp-server enable mult-communities', 'snmp-server enable notify', 'snmp-server notify port ', 'snmp-server notify community ', 'snmp-server notify send-test', 'snmp-server notify event ', 'snmp-server enable set-permission ', 'no snmp-server enable set-permission ', 'snmp-server community ', 'no snmp-server community .', 'snmp-server engineID reset.'] |
Authors
- Sara-Touqan (@sarato)
© 2012–2018 Michael DeHaan
© 2018–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.11/collections/mellanox/onyx/onyx_snmp_module.html