Server IP : 85.214.239.14 / Your IP : 18.188.242.177 Web Server : Apache/2.4.62 (Debian) System : Linux h2886529.stratoserver.net 4.9.0 #1 SMP Tue Jan 9 19:45:01 MSK 2024 x86_64 User : www-data ( 33) PHP Version : 7.4.18 Disable Function : pcntl_alarm,pcntl_fork,pcntl_waitpid,pcntl_wait,pcntl_wifexited,pcntl_wifstopped,pcntl_wifsignaled,pcntl_wifcontinued,pcntl_wexitstatus,pcntl_wtermsig,pcntl_wstopsig,pcntl_signal,pcntl_signal_get_handler,pcntl_signal_dispatch,pcntl_get_last_error,pcntl_strerror,pcntl_sigprocmask,pcntl_sigwaitinfo,pcntl_sigtimedwait,pcntl_exec,pcntl_getpriority,pcntl_setpriority,pcntl_async_signals,pcntl_unshare, MySQL : OFF | cURL : OFF | WGET : ON | Perl : ON | Python : ON | Sudo : ON | Pkexec : OFF Directory : /usr/lib/python3/dist-packages/ansible_collections/cisco/nxos/plugins/modules/ |
Upload File : |
#!/usr/bin/python # # This file is part of Ansible # # Ansible is free software: you can redistribute it and/or modify # it under the terms of the GNU General Public License as published by # the Free Software Foundation, either version 3 of the License, or # (at your option) any later version. # # Ansible is distributed in the hope that it will be useful, # but WITHOUT ANY WARRANTY; without even the implied warranty of # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the # GNU General Public License for more details. # # You should have received a copy of the GNU General Public License # along with Ansible. If not, see <http://www.gnu.org/licenses/>. # from __future__ import absolute_import, division, print_function __metaclass__ = type DOCUMENTATION = """ module: nxos_igmp_snooping extends_documentation_fragment: - cisco.nxos.nxos short_description: Manages IGMP snooping global configuration. description: - Manages IGMP snooping global configuration. version_added: 1.0.0 author: - Jason Edelman (@jedelman8) - Gabriele Gerbino (@GGabriele) notes: - Tested against NXOSv 7.3.(0)D1(1) on VIRL - Unsupported for Cisco MDS - When C(state=default), params will be reset to a default state. - C(group_timeout) also accepts I(never) as an input. options: snooping: description: - Enables/disables IGMP snooping on the switch. type: bool group_timeout: description: - Group membership timeout value for all VLANs on the device. Accepted values are integer in range 1-10080, I(never) and I(default). type: str link_local_grp_supp: description: - Global link-local groups suppression. type: bool report_supp: description: - Global IGMPv1/IGMPv2 Report Suppression. type: bool v3_report_supp: description: - Global IGMPv3 Report Suppression and Proxy Reporting. type: bool state: description: - Manage the state of the resource. default: present choices: - present - default type: str """ EXAMPLES = """ # ensure igmp snooping params supported in this module are in there default state - cisco.nxos.nxos_igmp_snooping: state: default # ensure following igmp snooping params are in the desired state - cisco.nxos.nxos_igmp_snooping: group_timeout: never snooping: true link_local_grp_supp: false optimize_mcast_flood: false report_supp: true v3_report_supp: true """ RETURN = """ commands: description: command sent to the device returned: always type: list sample: ["ip igmp snooping link-local-groups-suppression", "ip igmp snooping group-timeout 50", "no ip igmp snooping report-suppression", "no ip igmp snooping v3-report-suppression", "no ip igmp snooping"] """ import re from ansible.module_utils.basic import AnsibleModule from ansible_collections.cisco.nxos.plugins.module_utils.network.nxos.nxos import ( load_config, run_commands, ) def execute_show_command(command, module, output="text"): command = {"command": command, "output": output} return run_commands(module, [command]) def flatten_list(command_lists): flat_command_list = [] for command in command_lists: if isinstance(command, list): flat_command_list.extend(command) else: flat_command_list.append(command) return flat_command_list def get_group_timeout(config): match = re.search(r" Group timeout configured: (\S+)", config, re.M) if match: value = match.group(1) else: value = "" return value def get_igmp_snooping(module): command = "show ip igmp snooping" existing = {} try: body = execute_show_command(command, module, output="json")[0] except IndexError: body = [] if body: snooping = str(body.get("enabled")).lower() if "none" in snooping: snooping = str(body.get("GlobalSnoopEnabled")).lower() if snooping == "true" or snooping == "enabled" or snooping == "yes": existing["snooping"] = True else: existing["snooping"] = False report_supp = str(body.get("grepsup")).lower() if "none" in report_supp: report_supp = str(body.get("GlobalReportSupression")).lower() if report_supp == "true" or report_supp == "enabled": existing["report_supp"] = True else: existing["report_supp"] = False link_local_grp_supp = str(body.get("glinklocalgrpsup")).lower() if "none" in link_local_grp_supp: link_local_grp_supp = str(body.get("GlobalLinkLocalGroupSupression")).lower() if link_local_grp_supp == "true" or link_local_grp_supp == "enabled": existing["link_local_grp_supp"] = True else: existing["link_local_grp_supp"] = False v3_report_supp = str(body.get("gv3repsup")).lower() if "none" in v3_report_supp: v3_report_supp = str(body.get("GlobalV3ReportSupression")).lower() if v3_report_supp == "true" or v3_report_supp == "enabled": existing["v3_report_supp"] = True else: existing["v3_report_supp"] = False command = "show ip igmp snooping" body = execute_show_command(command, module)[0] if body: existing["group_timeout"] = get_group_timeout(body) return existing def config_igmp_snooping(delta, existing, default=False): CMDS = { "snooping": "ip igmp snooping", "group_timeout": "ip igmp snooping group-timeout {}", "link_local_grp_supp": "ip igmp snooping link-local-groups-suppression", "v3_report_supp": "ip igmp snooping v3-report-suppression", "report_supp": "ip igmp snooping report-suppression", } commands = [] command = None gt_command = None for key, value in delta.items(): if value: if default and key == "group_timeout": if existing.get(key): gt_command = "no " + CMDS.get(key).format(existing.get(key)) elif value == "default" and key == "group_timeout": if existing.get(key): command = "no " + CMDS.get(key).format(existing.get(key)) else: command = CMDS.get(key).format(value) else: command = "no " + CMDS.get(key).format(value) if command: commands.append(command) command = None if gt_command: # ensure that group-timeout command is configured last commands.append(gt_command) return commands def get_igmp_snooping_defaults(): group_timeout = "dummy" report_supp = True link_local_grp_supp = True v3_report_supp = False snooping = True args = dict( snooping=snooping, link_local_grp_supp=link_local_grp_supp, report_supp=report_supp, v3_report_supp=v3_report_supp, group_timeout=group_timeout, ) default = dict((param, value) for (param, value) in args.items() if value is not None) return default def igmp_snooping_gt_dependency(command, existing, module): # group-timeout will fail if igmp snooping is disabled gt = [i for i in command if i.startswith("ip igmp snooping group-timeout")] if gt: if "no ip igmp snooping" in command or ( existing["snooping"] is False and "ip igmp snooping" not in command ): msg = "group-timeout cannot be enabled or changed when ip igmp snooping is disabled" module.fail_json(msg=msg) else: # ensure that group-timeout command is configured last command.remove(gt[0]) command.append(gt[0]) def main(): argument_spec = dict( snooping=dict(required=False, type="bool"), group_timeout=dict(required=False, type="str"), link_local_grp_supp=dict(required=False, type="bool"), report_supp=dict(required=False, type="bool"), v3_report_supp=dict(required=False, type="bool"), state=dict(choices=["present", "default"], default="present"), ) module = AnsibleModule(argument_spec=argument_spec, supports_check_mode=True) warnings = list() results = {"changed": False, "commands": [], "warnings": warnings} snooping = module.params["snooping"] link_local_grp_supp = module.params["link_local_grp_supp"] report_supp = module.params["report_supp"] v3_report_supp = module.params["v3_report_supp"] group_timeout = module.params["group_timeout"] state = module.params["state"] args = dict( snooping=snooping, link_local_grp_supp=link_local_grp_supp, report_supp=report_supp, v3_report_supp=v3_report_supp, group_timeout=group_timeout, ) proposed = dict((param, value) for (param, value) in args.items() if value is not None) existing = get_igmp_snooping(module) commands = [] if state == "present": delta = dict(set(proposed.items()).difference(existing.items())) if delta: command = config_igmp_snooping(delta, existing) if command: if group_timeout: igmp_snooping_gt_dependency(command, existing, module) commands.append(command) elif state == "default": proposed = get_igmp_snooping_defaults() delta = dict(set(proposed.items()).difference(existing.items())) if delta: command = config_igmp_snooping(delta, existing, default=True) if command: commands.append(command) cmds = flatten_list(commands) if cmds: results["changed"] = True if not module.check_mode: load_config(module, cmds) if "configure" in cmds: cmds.pop(0) results["commands"] = cmds module.exit_json(**results) if __name__ == "__main__": main()