����JFIF���������
__ __ __ __ _____ _ _ _____ _ _ _ | \/ | \ \ / / | __ \ (_) | | / ____| | | | | | \ / |_ __\ V / | |__) | __ ___ ____ _| |_ ___ | (___ | |__ ___| | | | |\/| | '__|> < | ___/ '__| \ \ / / _` | __/ _ \ \___ \| '_ \ / _ \ | | | | | | |_ / . \ | | | | | |\ V / (_| | || __/ ____) | | | | __/ | | |_| |_|_(_)_/ \_\ |_| |_| |_| \_/ \__,_|\__\___| |_____/|_| |_|\___V 2.1 if you need WebShell for Seo everyday contact me on Telegram Telegram Address : @jackleetFor_More_Tools:
#
# 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_gir
extends_documentation_fragment:
- cisco.nxos.nxos
short_description: Trigger a graceful removal or insertion (GIR) of the switch.
description:
- Trigger a graceful removal or insertion (GIR) of the switch.
- GIR processing may take more than 2 minutes. Timeout settings are automatically
extended to 200s when user timeout settings are insufficient.
version_added: 1.0.0
author:
- Gabriele Gerbino (@GGabriele)
notes:
- Tested against NXOSv 7.3.(0)D1(1) on VIRL
- Unsupported for Cisco MDS
- C(state) has effect only in combination with C(system_mode_maintenance_timeout)
or C(system_mode_maintenance_on_reload_reset_reason).
- Using C(system_mode_maintenance) and C(system_mode_maintenance_dont_generate_profile)
would make the module fail, but the system mode will be triggered anyway.
options:
system_mode_maintenance:
description:
- When C(system_mode_maintenance=true) it puts all enabled protocols in maintenance
mode (using the isolate command). When C(system_mode_maintenance=false) it puts
all enabled protocols in normal mode (using the no isolate command).
type: bool
system_mode_maintenance_dont_generate_profile:
description:
- When C(system_mode_maintenance_dont_generate_profile=true) it prevents the dynamic
searching of enabled protocols and executes commands configured in a maintenance-mode
profile. Use this option if you want the system to use a maintenance-mode profile
that you have created. When C(system_mode_maintenance_dont_generate_profile=false)
it prevents the dynamic searching of enabled protocols and executes commands
configured in a normal-mode profile. Use this option if you want the system
to use a normal-mode profile that you have created.
type: bool
system_mode_maintenance_timeout:
description:
- Keeps the switch in maintenance mode for a specified number of minutes. Range
is 5-65535.
type: str
system_mode_maintenance_shutdown:
description:
- Shuts down all protocols, vPC domains, and interfaces except the management
interface (using the shutdown command). This option is disruptive while C(system_mode_maintenance)
(which uses the isolate command) is not.
type: bool
system_mode_maintenance_on_reload_reset_reason:
description:
- Boots the switch into maintenance mode automatically in the event of a specified
system crash. Note that not all reset reasons are applicable for all platforms.
Also if reset reason is set to match_any, it is not idempotent as it turns on
all reset reasons. If reset reason is match_any and state is absent, it turns
off all the reset reasons.
choices:
- hw_error
- svc_failure
- kern_failure
- wdog_timeout
- fatal_error
- lc_failure
- match_any
- manual_reload
- any_other
- maintenance
type: str
state:
description:
- Specify desired state of the resource.
default: present
choices:
- present
- absent
type: str
"""
EXAMPLES = """
# Trigger system maintenance mode
- cisco.nxos.nxos_gir:
system_mode_maintenance: true
host: '{{ inventory_hostname }}'
username: '{{ un }}'
password: '{{ pwd }}'
# Trigger system normal mode
- cisco.nxos.nxos_gir:
system_mode_maintenance: false
host: '{{ inventory_hostname }}'
username: '{{ un }}'
password: '{{ pwd }}'
# Configure on-reload reset-reason for maintenance mode
- cisco.nxos.nxos_gir:
system_mode_maintenance_on_reload_reset_reason: manual_reload
state: present
host: '{{ inventory_hostname }}'
username: '{{ un }}'
password: '{{ pwd }}'
# Add on-reload reset-reason for maintenance mode
- cisco.nxos.nxos_gir:
system_mode_maintenance_on_reload_reset_reason: hw_error
state: present
host: '{{ inventory_hostname }}'
username: '{{ un }}'
password: '{{ pwd }}'
# Remove on-reload reset-reason for maintenance mode
- cisco.nxos.nxos_gir:
system_mode_maintenance_on_reload_reset_reason: manual_reload
state: absent
host: '{{ inventory_hostname }}'
username: '{{ un }}'
password: '{{ pwd }}'
# Set timeout for maintenance mode
- cisco.nxos.nxos_gir:
system_mode_maintenance_timeout: 30
state: present
host: '{{ inventory_hostname }}'
username: '{{ un }}'
password: '{{ pwd }}'
# Remove timeout for maintenance mode
- cisco.nxos.nxos_gir:
system_mode_maintenance_timeout: 30
state: absent
host: '{{ inventory_hostname }}'
username: '{{ un }}'
password: '{{ pwd }}'
"""
RETURN = """
final_system_mode:
description: describe the last system mode
returned: verbose mode
type: str
sample: normal
updates:
description: commands sent to the device
returned: verbose mode
type: list
sample: ["terminal dont-ask", "system mode maintenance timeout 10"]
changed:
description: check to see if a change was made on the device
returned: always
type: bool
sample: true
"""
from ansible.module_utils.basic import AnsibleModule
from ansible_collections.cisco.nxos.plugins.module_utils.network.nxos.nxos import (
load_config,
run_commands,
)
def get_system_mode(module):
command = {"command": "show system mode", "output": "text"}
body = run_commands(module, [command])[0]
if body and "normal" in body.lower():
mode = "normal"
else:
mode = "maintenance"
return mode
def get_maintenance_timeout(module):
command = {"command": "show maintenance timeout", "output": "text"}
body = run_commands(module, [command])[0]
timeout = body.split()[4]
return timeout
def get_reset_reasons(module):
command = {
"command": "show maintenance on-reload reset-reasons",
"output": "text",
}
body = run_commands(module, [command])[0]
return body
def get_commands(module, state, mode):
commands = list()
if module.params["system_mode_maintenance"] is True and mode == "normal":
commands.append("system mode maintenance")
elif module.params["system_mode_maintenance"] is False and mode == "maintenance":
commands.append("no system mode maintenance")
elif (
module.params["system_mode_maintenance_dont_generate_profile"] is True and mode == "normal"
):
commands.append("system mode maintenance dont-generate-profile")
elif (
module.params["system_mode_maintenance_dont_generate_profile"] is False
and mode == "maintenance"
):
commands.append("no system mode maintenance dont-generate-profile")
elif module.params["system_mode_maintenance_timeout"]:
timeout = get_maintenance_timeout(module)
if state == "present" and timeout != module.params["system_mode_maintenance_timeout"]:
commands.append(
"system mode maintenance timeout {0}".format(
module.params["system_mode_maintenance_timeout"],
),
)
elif state == "absent" and timeout == module.params["system_mode_maintenance_timeout"]:
commands.append(
"no system mode maintenance timeout {0}".format(
module.params["system_mode_maintenance_timeout"],
),
)
elif module.params["system_mode_maintenance_shutdown"] and mode == "normal":
commands.append("system mode maintenance shutdown")
elif module.params["system_mode_maintenance_shutdown"] is False and mode == "maintenance":
commands.append("no system mode maintenance")
elif module.params["system_mode_maintenance_on_reload_reset_reason"]:
reset_reasons = get_reset_reasons(module)
if (
state == "present"
and module.params["system_mode_maintenance_on_reload_reset_reason"].lower()
not in reset_reasons.lower()
):
commands.append(
"system mode maintenance on-reload "
"reset-reason {0}".format(
module.params["system_mode_maintenance_on_reload_reset_reason"],
),
)
elif (
state == "absent"
and module.params["system_mode_maintenance_on_reload_reset_reason"].lower()
in reset_reasons.lower()
):
commands.append(
"no system mode maintenance on-reload "
"reset-reason {0}".format(
module.params["system_mode_maintenance_on_reload_reset_reason"],
),
)
if commands:
commands.insert(0, "terminal dont-ask")
return commands
def main():
argument_spec = dict(
system_mode_maintenance=dict(required=False, type="bool"),
system_mode_maintenance_dont_generate_profile=dict(required=False, type="bool"),
system_mode_maintenance_timeout=dict(required=False, type="str"),
system_mode_maintenance_shutdown=dict(required=False, type="bool"),
system_mode_maintenance_on_reload_reset_reason=dict(
required=False,
choices=[
"hw_error",
"svc_failure",
"kern_failure",
"wdog_timeout",
"fatal_error",
"lc_failure",
"match_any",
"manual_reload",
"any_other",
"maintenance",
],
),
state=dict(choices=["absent", "present"], default="present", required=False),
)
module = AnsibleModule(
argument_spec=argument_spec,
mutually_exclusive=[
[
"system_mode_maintenance",
"system_mode_maintenance_dont_generate_profile",
"system_mode_maintenance_timeout",
"system_mode_maintenance_shutdown",
"system_mode_maintenance_on_reload_reset_reason",
],
],
required_one_of=[
[
"system_mode_maintenance",
"system_mode_maintenance_dont_generate_profile",
"system_mode_maintenance_timeout",
"system_mode_maintenance_shutdown",
"system_mode_maintenance_on_reload_reset_reason",
],
],
supports_check_mode=True,
)
warnings = list()
state = module.params["state"]
mode = get_system_mode(module)
commands = get_commands(module, state, mode)
changed = False
if commands:
if module.check_mode:
module.exit_json(changed=True, commands=commands)
else:
load_config(module, commands)
changed = True
result = {}
result["changed"] = changed
if module._verbosity > 0:
final_system_mode = get_system_mode(module)
result["final_system_mode"] = final_system_mode
result["updates"] = commands
result["warnings"] = warnings
module.exit_json(**result)
if __name__ == "__main__":
main()
| Name | Type | Size | Permission | Actions |
|---|---|---|---|---|
| __pycache__ | Folder | 0755 |
|
|
| storage | Folder | 0755 |
|
|
| __init__.py | File | 0 B | 0644 |
|
| nxos_aaa_server.py | File | 10.19 KB | 0644 |
|
| nxos_aaa_server_host.py | File | 10.92 KB | 0644 |
|
| nxos_acl_interfaces.py | File | 10.21 KB | 0644 |
|
| nxos_acls.py | File | 28.71 KB | 0644 |
|
| nxos_banner.py | File | 6.44 KB | 0644 |
|
| nxos_bfd_global.py | File | 9.08 KB | 0644 |
|
| nxos_bfd_interfaces.py | File | 6.84 KB | 0644 |
|
| nxos_bgp.py | File | 25.3 KB | 0644 |
|
| nxos_bgp_address_family.py | File | 30.41 KB | 0644 |
|
| nxos_bgp_af.py | File | 31.01 KB | 0644 |
|
| nxos_bgp_global.py | File | 48.43 KB | 0644 |
|
| nxos_bgp_neighbor.py | File | 18.79 KB | 0644 |
|
| nxos_bgp_neighbor_address_family.py | File | 33.62 KB | 0644 |
|
| nxos_bgp_neighbor_af.py | File | 26.84 KB | 0644 |
|
| nxos_command.py | File | 7.41 KB | 0644 |
|
| nxos_config.py | File | 22.51 KB | 0644 |
|
| nxos_devicealias.py | File | 18.33 KB | 0644 |
|
| nxos_evpn_global.py | File | 2.62 KB | 0644 |
|
| nxos_evpn_vni.py | File | 9.44 KB | 0644 |
|
| nxos_facts.py | File | 8.52 KB | 0644 |
|
| nxos_feature.py | File | 9.21 KB | 0644 |
|
| nxos_file_copy.py | File | 17.39 KB | 0644 |
|
| nxos_gir.py | File | 11.5 KB | 0644 |
|
| nxos_gir_profile_management.py | File | 5.84 KB | 0644 |
|
| nxos_hostname.py | File | 5.63 KB | 0644 |
|
| nxos_hsrp.py | File | 15.02 KB | 0644 |
|
| nxos_hsrp_interfaces.py | File | 6.16 KB | 0644 |
|
| nxos_igmp.py | File | 4.49 KB | 0644 |
|
| nxos_igmp_interface.py | File | 21.88 KB | 0644 |
|
| nxos_igmp_snooping.py | File | 9.72 KB | 0644 |
|
| nxos_install_os.py | File | 21.07 KB | 0644 |
|
| nxos_interfaces.py | File | 13.69 KB | 0644 |
|
| nxos_l2_interfaces.py | File | 12.05 KB | 0644 |
|
| nxos_l3_interfaces.py | File | 15.12 KB | 0644 |
|
| nxos_lacp.py | File | 6.39 KB | 0644 |
|
| nxos_lacp_interfaces.py | File | 9.13 KB | 0644 |
|
| nxos_lag_interfaces.py | File | 8.66 KB | 0644 |
|
| nxos_lldp_global.py | File | 8.68 KB | 0644 |
|
| nxos_lldp_interfaces.py | File | 6.21 KB | 0644 |
|
| nxos_logging.py | File | 27.52 KB | 0644 |
|
| nxos_logging_global.py | File | 21.08 KB | 0644 |
|
| nxos_ntp.py | File | 12.98 KB | 0644 |
|
| nxos_ntp_auth.py | File | 9.17 KB | 0644 |
|
| nxos_ntp_global.py | File | 19.63 KB | 0644 |
|
| nxos_ntp_options.py | File | 4.53 KB | 0644 |
|
| nxos_nxapi.py | File | 14.01 KB | 0644 |
|
| nxos_ospf_interfaces.py | File | 43.32 KB | 0644 |
|
| nxos_ospfv2.py | File | 62.64 KB | 0644 |
|
| nxos_ospfv3.py | File | 53.01 KB | 0644 |
|
| nxos_overlay_global.py | File | 5.64 KB | 0644 |
|
| nxos_pim.py | File | 6.15 KB | 0644 |
|
| nxos_pim_interface.py | File | 19.74 KB | 0644 |
|
| nxos_pim_rp_address.py | File | 7.61 KB | 0644 |
|
| nxos_ping.py | File | 7.05 KB | 0644 |
|
| nxos_prefix_lists.py | File | 26.39 KB | 0644 |
|
| nxos_reboot.py | File | 2.24 KB | 0644 |
|
| nxos_rollback.py | File | 3.51 KB | 0644 |
|
| nxos_route_maps.py | File | 57.7 KB | 0644 |
|
| nxos_rpm.py | File | 12.29 KB | 0644 |
|
| nxos_snapshot.py | File | 12.17 KB | 0644 |
|
| nxos_snmp_community.py | File | 6.6 KB | 0644 |
|
| nxos_snmp_contact.py | File | 3.81 KB | 0644 |
|
| nxos_snmp_host.py | File | 15.1 KB | 0644 |
|
| nxos_snmp_location.py | File | 3.91 KB | 0644 |
|
| nxos_snmp_server.py | File | 50.27 KB | 0644 |
|
| nxos_snmp_traps.py | File | 7.97 KB | 0644 |
|
| nxos_snmp_user.py | File | 12.34 KB | 0644 |
|
| nxos_static_routes.py | File | 20.79 KB | 0644 |
|
| nxos_system.py | File | 12.77 KB | 0644 |
|
| nxos_telemetry.py | File | 8.98 KB | 0644 |
|
| nxos_udld.py | File | 7.09 KB | 0644 |
|
| nxos_udld_interface.py | File | 8.51 KB | 0644 |
|
| nxos_user.py | File | 15.37 KB | 0644 |
|
| nxos_vlans.py | File | 10.6 KB | 0644 |
|
| nxos_vpc.py | File | 15.59 KB | 0644 |
|
| nxos_vpc_interface.py | File | 9.92 KB | 0644 |
|
| nxos_vrf.py | File | 19.78 KB | 0644 |
|
| nxos_vrf_af.py | File | 7.71 KB | 0644 |
|
| nxos_vrf_interface.py | File | 7.37 KB | 0644 |
|
| nxos_vrrp.py | File | 12 KB | 0644 |
|
| nxos_vsan.py | File | 10.8 KB | 0644 |
|
| nxos_vtp_domain.py | File | 5.73 KB | 0644 |
|
| nxos_vtp_password.py | File | 7.8 KB | 0644 |
|
| nxos_vtp_version.py | File | 5.54 KB | 0644 |
|
| nxos_vxlan_vtep.py | File | 16.86 KB | 0644 |
|
| nxos_vxlan_vtep_vni.py | File | 15.7 KB | 0644 |
|
| nxos_zone_zoneset.py | File | 33.96 KB | 0644 |
|