Vh.|ddlmZmZmZeZdZdZdZddl m Z ddl m Z m Z dZdZd Zd Zd Zed k(rey y ))absolute_importdivisionprint_functiona 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 a # 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 }}' a 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 ) AnsibleModule) load_config run_commandscdddd}t||gd}|rd|jvrd}|Sd}|S)Nzshow system modetextcommandoutputrnormal maintenance)rlower)moduler bodymodes g/home/dcms/DCMS/lib/python3.12/site-packages/ansible_collections/cisco/nxos/plugins/modules/nxos_gir.pyget_system_modersG,?G  *1 -D DJJL( K KcVddd}t||gd}|jd}|S)Nzshow maintenance timeoutr r r)rsplit)rr rtimeouts rget_maintenance_timeoutrs34GG  *1 -Djjl1oG Nrc0ddd}t||gd}|S)Nz(show maintenance on-reload reset-reasonsr r r)r)rr rs rget_reset_reasonsrs)=G  *1 -D Krc*t}|jddur|dk(r|jdnK|jddur|dk(r|jdn"|jddur|dk(r|jd n|jddur|dk(r|jd n|jd rt|}|d k(rA||jd k7r/|jd j |jd np|dk(rj||jd k(rW|jdj |jd n(|jdr|dk(r|jdn|jddur|dk(r|jdn|jdrt |}|d k(r[|jdj |j vr.|jdj |jdn_|dk(rZ|jdj |j vr-|jdj |jd|r|jdd|S)Nsystem_mode_maintenanceTrzsystem mode maintenanceFrzno system mode maintenance-system_mode_maintenance_dont_generate_profilez-system mode maintenance dont-generate-profilez0no system mode maintenance dont-generate-profilesystem_mode_maintenance_timeoutpresentz#system mode maintenance timeout {0}absentz&no system mode maintenance timeout {0} system_mode_maintenance_shutdownz system mode maintenance shutdown.system_mode_maintenance_on_reload_reset_reasonz2system mode maintenance on-reload reset-reason {0}z5no system mode maintenance on-reload reset-reason {0}rzterminal dont-ask)listparamsappendrformatrrinsert)rstatercommandsr reset_reasonss r get_commandsr.smvH }}./47DHrWsh$A@ J X0 d $5 @FEP zFr