�
�Udac @ s i d d 6d g d 6d d 6Z d Z d Z d Z d d
l Z d d l m Z d d l m Z m Z d d
l m
Z
m Z d d l m
Z
d d � Z d � Z d � Z d � Z e d � Z d � Z d
d � Z d
d � Z d � Z d
d � Z d
d � Z d � Z e d k r e � n d
S( s 1.1t metadata_versiont previewt statust networkt supported_bys4
---
module: nxos_install_os
extends_documentation_fragment: nxos
short_description: Set boot options like boot, kickstart image and issu.
description:
- Install an operating system by setting the boot options like boot
image and kickstart image and optionally select to install using
ISSU (In Server Software Upgrade).
notes:
- Tested against the following platforms and images
- N9k 7.0(3)I4(6), 7.0(3)I5(3), 7.0(3)I6(1), 7.0(3)I7(1), 7.0(3)F2(2), 7.0(3)F3(2)
- N3k 6.0(2)A8(6), 6.0(2)A8(8), 7.0(3)I6(1), 7.0(3)I7(1)
- N7k 7.3(0)D1(1), 8.0(1), 8.1(1), 8.2(1)
- This module requires both the ANSIBLE_PERSISTENT_CONNECT_TIMEOUT and
ANSIBLE_PERSISTENT_COMMAND_TIMEOUT timers to be set to 600 seconds or higher.
The module will exit if the timers are not set properly.
- When using connection local, ANSIBLE_PERSISTENT_CONNECT_TIMEOUT and
ANSIBLE_PERSISTENT_COMMAND_TIMEOUT can only be set using ENV variables or
the ansible.cfg file.
- Do not include full file paths, just the name of the file(s) stored on
the top level flash directory.
- This module attempts to install the software immediately,
which may trigger a reboot.
- In check mode, the module will indicate if an upgrade is needed and
whether or not the upgrade is disruptive or non-disruptive(ISSU).
author:
- Jason Edelman (@jedelman8)
- Gabriele Gerbibo (@GGabriele)
version_added: 2.2
options:
system_image_file:
description:
- Name of the system (or combined) image file on flash.
required: true
kickstart_image_file:
description:
- Name of the kickstart image file on flash.
(Not required on all Nexus platforms)
issu:
version_added: "2.5"
description:
- Upgrade using In Service Software Upgrade (ISSU).
(Supported on N5k, N7k, N9k platforms)
- Selecting 'required' or 'yes' means that upgrades will only
proceed if the switch is capable of ISSU.
- Selecting 'desired' means that upgrades will use ISSU if possible
but will fall back to disruptive upgrade if needed.
- Selecting 'no' means do not use ISSU. Forced disruptive.
choices: ['required','desired', 'yes', 'no']
default: 'no'
s
- name: Install OS on N9k
check_mode: no
nxos_install_os:
system_image_file: nxos.7.0.3.I6.1.bin
issu: desired
- name: Wait for device to come back up with new image
wait_for:
port: 22
state: started
timeout: 500
delay: 60
host: "{{ inventory_hostname }}"
- name: Check installed OS for newly installed version
nxos_command:
commands: ['show version | json']
provider: "{{ connection }}"
register: output
- assert:
that:
- output['stdout'][0]['kickstart_ver_str'] == '7.0(3)I6(1)'
sm
install_state:
description: Boot and install information.
returned: always
type: dict
sample: {
"install_state": [
"Compatibility check is done:",
"Module bootable Impact Install-type Reason",
"------ -------- -------------- ------------ ------",
" 1 yes non-disruptive reset ",
"Images will be upgraded according to following table:",
"Module Image Running-Version(pri:alt) New-Version Upg-Required",
"------ ---------- ---------------------------------------- -------------------- ------------",
" 1 nxos 7.0(3)I6(1) 7.0(3)I7(1) yes",
" 1 bios v4.4.0(07/12/2017) v4.4.0(07/12/2017) no"
],
}
i����N( t sleep( t load_configt run_commands( t nxos_argument_spect
check_args( t
AnsibleModulet textc C s$ i | d 6| d 6g } t | | � S( Nt commandt output( R ( t moduleR R
t cmds( ( sP /usr/lib/python2.7/site-packages/ansible/modules/network/nxos/nxos_install_os.pyt execute_show_command� s
c C s� t | d d � } | d d d d d } t j d | � rG d } nr t j d | � rb d } nW t j d | � r} d } n< t j d
| � r� d
} n! t j d | � r� d } n d } | S(
s Determine platform types show inventoryt jsoni t TABLE_invt ROW_invt productidt N3Kt N5Kt N6Kt N7Kt N9Kt unknown( R t ret search( R t datat pidt type( ( sP /usr/lib/python2.7/site-packages/ansible/modules/network/nxos/nxos_install_os.pyt get_platform� s c C sm t | � d k r! t | � } n i | d 6} g | d <t | d <t | d <t | d <t | d <t | d <t | d <t | d
<t | d <t | t � r� | d k r� t | d <nK | d
k r� t | d <n2 | d k r� t | d <n | d k r� t | d <n | S| j d � | d <xT| d D]H} t j d | � rCt | d <Pn t j d | � rmt | d <t | d <Pn t j d | � r�t | d <Pn t j d | � r�t | d <Pn t j d | � r�t | d <Pn t j d | � r�t | d <Pn t j d | � r
t | d <Pn t j d | � r-t | d
<Pn t j d | � rMt | d
<Pn t j d | � rmt | d
<Pn t j d | � r�t | d
<t | d <Pn t j d | � r�t | d
<t | d <Pn t j d | � r�| d j | � q n d } t j | | � } | r�| d j | � d | j
d � } d } | j
d! � d" k r[i t | 6| | <n t | | <i t | 6| | <d# } | j
d$ � d% k r�| | j i t | 6� q | | j i t | 6� q n t j d& | � } | r | d j | � d' | j
d � | j
d$ � f } d } | j
d( � d% k rNt | | <i t | 6| | <q i t | 6| | <q q q W| S() sh Helper method to parse the output of the 'show install all impact' or
'install all' commands.
Sample Output:
Installer will perform impact only check. Please wait.
Verifying image bootflash:/nxos.7.0.3.F2.2.bin for boot variable "nxos".
[####################] 100% -- SUCCESS
Verifying image type.
[####################] 100% -- SUCCESS
Preparing "bios" version info using image bootflash:/nxos.7.0.3.F2.2.bin.
[####################] 100% -- SUCCESS
Preparing "nxos" version info using image bootflash:/nxos.7.0.3.F2.2.bin.
[####################] 100% -- SUCCESS
Performing module support checks.
[####################] 100% -- SUCCESS
Notifying services about system upgrade.
[####################] 100% -- SUCCESS
Compatibility check is done:
Module bootable Impact Install-type Reason
------ -------- -------------- ------------ ------
8 yes disruptive reset Incompatible image for ISSU
21 yes disruptive reset Incompatible image for ISSU
Images will be upgraded according to following table:
Module Image Running-Version(pri:alt) New-Version Upg-Required
------ ---------- ---------------------------------------- ------------
8 lcn9k 7.0(3)F3(2) 7.0(3)F2(2) yes
8 bios v01.17 v01.17 no
21 lcn9k 7.0(3)F3(2) 7.0(3)F2(2) yes
21 bios v01.70 v01.70 no
i t rawt processedt
disruptivet upgrade_neededt errort invalid_commandt install_in_progresst server_errort upgrade_succeededt use_impact_datai����i� i����i s
t list_datas Pre-upgrade check faileds [I|i]nvalid commands No install all data founds. Another install procedure may\s*be in progresss Backend processing errors timed outs ^(-1|5\d\d)$s Finishing the upgrades Install has been successfuls Switching over onto standbys) timeout .*trying to send command: installs! [C|c]onnection failure: timed outs% ----|Module|Images will|Compatibilitys3 (\d+)\s+(\S+)\s+(disruptive|non-disruptive)\s+(\S+)s m%si s non-disruptivet bootablei t yess( (\d+)\s+(\S+)\s+(\S+)\s+(\S+)\s+(yes|no)s m%s_%si ( t lent massage_install_datat Falset
isinstancet intt Truet splitR R t appendt groupt update( R t udt xt rdt mot keyt field( ( sP /usr/lib/python2.7/site-packages/ansible/modules/network/nxos/nxos_install_os.pyt parse_show_install� s� +
"
c C s� d } t | � d k r% | d } n% t | � d k rD | d } n | } t | � d k r� t | d t � r� d | d j � k r� | d d } q� d | d j � k r� | d d d k r� | d d } q� | } n | S( Ns No install all data foundi i i t clierrort codet 500t msg( R. R1 t dictt keys( R t default_error_msgt result_data( ( sP /usr/lib/python2.7/site-packages/ansible/modules/network/nxos/nxos_install_os.pyR/ L s
%* c C s� d g } t j d | � r9 | d k r0 d } q` d } n' | d k rN d } n | rZ d n d } | d k r� d } | r� d } q� n d } | d k r� | j d | | | f � n | j d
| | | | f � | S( Ns terminal dont-asks required|desired|yess non-disruptivet t forcet impacts show install all impacts install alls
%s nxos %s %ss %s %s system %s kickstart %s( R R t NoneR5 ( t issut imaget kickR RH t commandst issu_cmdt rootcmd( ( sP /usr/lib/python2.7/site-packages/ansible/modules/network/nxos/nxos_install_os.pyt build_install_cmd_setd s& c C s� i | d j d � d 6} d | d <t | d <xC | d D]7 } t j d | � } | r9 | j d � | d <q9 q9 q9 W| d d k r� t | d <n | S( Ni s
R! RG t versionR% s* (kickstart|system|NXOS):\s+version\s+(\S+)i ( R4 R0 R R R6 R3 ( R t version_dataR9 R; ( ( sP /usr/lib/python2.7/site-packages/ansible/modules/network/nxos/nxos_install_os.pyt parse_show_version� s
c C s� t | d d � d } t d � } d } t | d <d | } | g | d <t t | | � � } | d r� t | d <| d | d <n | d
| d k r� | d r� t | d <t | d
<d | } n | d k rv| d rvd | } | d j | � t t | | � � }
|
d r/t | d <|
d | d <n | d
|
d k rv| d rvt | d <t | d
<| d | } qvn | d | d <| | d <| S( s} Some platforms/images/transports don't support the 'install all impact'
command so we need to use a different method.s show versionR i RG s No upgrade requiredR% s show version image bootflash:%st upgrade_cmdR! t kickstart_ver_strRR R$ R# s Switch upgraded: system: %ss kickstart: %sR+ R" N( R R> R0 RT R3 RJ R5 ( R RK RL RM t currentR t upgrade_msgt tsvert target_imaget tkvert target_kick( ( sP /usr/lib/python2.7/site-packages/ansible/modules/network/nxos/nxos_install_os.pyt check_mode_legacy� s8
c C s� i t d 6} t | | | d � } t t | | t | � � } | d r� | d k r� d } t | | | d � } t | | | � } n | d r� t | d <n | | d <| S( s3 Use the 'install all impact' command for check_modet ignore_timeoutRI R% t desiredt noR( RU ( R3 RQ R> R t check_install_in_progress( R RK RL RM t optsRN R ( ( sP /usr/lib/python2.7/site-packages/ansible/modules/network/nxos/nxos_install_os.pyt check_mode_nextgen� s
c C sQ xJ t d � D]< } t t | | t | � � } | d rH t d � q
n Pq
W| S( Ni R' i ( t rangeR> R R3 R ( R RN Rb t attemptR ( ( sP /usr/lib/python2.7/site-packages/ansible/modules/network/nxos/nxos_install_os.pyRa � s
c C s] t | | | | � } | d r7 t | | | | � } n | d rY t | | | | � } n | S( sC Check switch upgrade impact using 'show install all impact' commandR( R& ( Rc R] ( R RK RL RM R ( ( sP /usr/lib/python2.7/site-packages/ansible/modules/network/nxos/nxos_install_os.pyt
check_mode� s
c C s� t | | | | � } | j r9 d } | d j | � | S| d rG | S| d sU | S| d r� | d k r� d } | j d | d | d
� q� d } n t | | | d � } i t d
6} t | | | � } | d rd | d k rt | | | d t � } t | | | � } n | | d <| d r=t | d <t | d <n | d rw| d rd| } t | d <qw| } t | d <n | d s�t | d <n | S( s: Perform the switch upgrade using the 'install all' commands1 *** SWITCH WAS NOT UPGRADED: IMPACT DATA ONLY ***R" R% R$ R# R- sG ISSU/ISSD requested but impact data indicates ISSU/ISSD is not possibleRB t raw_dataR+ R` t installR^ R& RH i RU R( R) R* ( Rf R5 t fail_jsonRQ R3 Ra R0 ( R RK RL RM t impact_dataRB RN Rb t upgrade( ( sP /usr/lib/python2.7/site-packages/ansible/modules/network/nxos/nxos_install_os.pyt do_install_all� sB
c C sj t d t d t � d t d t � d t d d d d d g d d � � } | j t � t d
| d t � } t � } t | | � | j d } | j d } | j d } t j
d | � r� d } n | d
k s� | d k r� d } n t | | | d | �} | d r6| d } d | } | j
d | d | d � n | d } | d }
| j d |
d | d | � d S( Nt system_image_filet requiredt kickstart_image_fileRK t choicesR_ R` R- t defaultt
argument_spect supports_check_modes (yes|required)t nullRG RM R% RU s* Failed to upgrade device using command: %sRB Rg R+ R" R$ t changedt
install_statet warnings( RC R3 R0 R7 R R
t listR t paramsR R RJ Rl Ri t exit_json( Rr R Rw t sift kifRK t install_resultt cmdRB t stateRu ( ( sP /usr/lib/python2.7/site-packages/ansible/modules/network/nxos/nxos_install_os.pyt main. s0 $
t __main__( t ANSIBLE_METADATAt
DOCUMENTATIONt EXAMPLESt RETURNR t timeR t& ansible.module_utils.network.nxos.nxosR R R R t ansible.module_utils.basicR
R R R> R/ R3 RQ RT RJ R] Rc Ra Rf Rl R� t __name__( ( ( sP /usr/lib/python2.7/site-packages/ansible/modules/network/nxos/nxos_install_os.pyt <module> s0
6 � ) (
< &
Anons79 File Manager Version 1.0, Coded By Anons79
Email: [email protected]
Anons79 Mini Shell