Actualización del software en servicio (ISSU) en el Catalyst 3850, Catalyst 9000 Series Switch

Introducción

El objetivo de este documento es ayudar a entender los pasos implicados en ISSU de ejecución en el Switches de las Catalyst 9000 y Catalyst 3850 Series.

Cuál es ISSU

La actualización del software en servicio (ISSU) es un proceso que actualiza una imagen a otra imagen en un dispositivo mientras que la red continúa remitiendo los paquetes. Los administradores de la red de las ayudas ISSU evitan una interrupción de la red al realizar una actualización del software. Las imágenes se actualizan adentro instalan el modo en donde cada paquete se actualiza individualmente.

ISSU se soporta en todo el soportar de las Catalyst 3850 y Catalyst 9000 Series StackWise-virtual y también en el Catalyst 9400/9600 chasis independientes con los Supervisores duales.

El StackWise virtual (SVL) comprende dos Switches que esté conectado junto para formar un switch virtual. SVL soporta las actualizaciones del software en servicio.

ISSU soporta las actualizaciones, los downgrades, y las restauraciones no actualizadas.

Plataformas admitidas y matriz de soporte de la versión

Antes de proceder con ISSU, control si la plataforma soporta realmente ISSU. También verifique si ISSU se soporta entre el código actual y el código de la blanco. Los detalles del modo en las plataformas admitidas y la matriz de compatibilidad ISSU pueden ser aquí encontrado - soporte ISSU entre las versiones

Requisitos previos antes de ISSU

Nota: El ejemplo en este documento se basa en los Cisco Catalyst 9500 Switch configurados como StackWise-virtuales. Los pasos son aplicables al chasis independiente Cat9400/Cat9600 con los motores de Supervisor dual y también para el configuerd de los dispositivos del Catalyst 3850/Catalyst 9000 como StackWise-virtuales.

1. Versión del código de la corriente del control

C9500#show version | in IOS XE 
Cisco IOS XE Software, Version 16.09.02

2. Marque al modo de arranque

Se soporta ISSU solamente si ambos que el Switches en Stackwise virtual se inicia adentro INSTALAN el modo.

C9500#show ver | in INSTALL
*    1 50    C9500-40X          16.9.2            CAT9K_IOSXE           INSTALL
     2 50    C9500-40X          16.9.2            CAT9K_IOSXE           INSTALL

On Catalyst 9400, the above output is not available. Check if the switch booted from packages.conf file 
C9400#show version | in System image
System image file is "flash:packages.conf"
 

Si el chasis se inicia en un modo del CONJUNTO, ISSU no se soporta. Usted verá los errores como abajo si usted intenta ejecutar ISSU cuando el Switches se está ejecutando en el modo del CONJUNTO.

*Nov 13 14:55:57.338: %INSTALL-5-INSTALL_START_INFO: Chassis 1 R1/0: install_engine: Started install one-shot ISSU flash:cat9k_iosxe.16.09.02.SPA.bininstall_add_activate_commit: Adding ISSU
ERROR: install_add_activate_commit: One-Shot ISSU operation is not supported in bundle boot mode
FAILED: install_add_activate_commit  exit(1) Tue Nov 13 14:56:03 UTC 2018

3. Marque si hay suficiente memoria disponible en el flash

C9500#dir flash: | in free
11353194496 bytes total (8565174272 bytes free)

C9500#dir stby-flash: | in free
11353980928 bytes total (8566865920 bytes free)

Asegúrese de que usted tenga por lo menos 1GB del espacio en el flash para ampliar una nueva imagen. Limpie los viejos archivos de instalación en caso del espacio insuficiente usando “instalan quitan” el comando inactivo.

4. Marque si el Switches está en el modo SSO

C9500#show redundancy 
Redundant System Information :
------------------------------
       Available system uptime = 4 minutes
Switchovers system experienced = 0
              Standby failures = 0
        Last switchover reason = none

                 Hardware Mode = Duplex
    Configured Redundancy Mode = sso
     Operating Redundancy Mode = sso
              Maintenance Mode = Disabled
                Communications = Up

Current Processor Information :
-------------------------------
               Active Location = slot 1
        Current Software state = ACTIVE
       Uptime in current state = 30 minutes
                 Image Version = Cisco IOS Software [Fuji], Catalyst L3 Switch Software (CAT9K_IOSXE), Version 16.9.2, RELEASE SOFTWARE (fc4)
Technical Support: http://www.cisco.com/techsupport
Copyright (c) 1986-2018 by Cisco Systems, Inc.
Compiled Mon 05-Nov-18 19:32 by mcpre
                          BOOT = flash:packages.conf;
                   CONFIG_FILE = 
        Configuration register = 0x102

Peer Processor Information :
----------------------------
              Standby Location = slot 2
        Current Software state = STANDBY HOT 
       Uptime in current state = 26 minutes
                 Image Version = Cisco IOS Software [Fuji], Catalyst L3 Switch Software (CAT9K_IOSXE), Version 16.9.2, RELEASE SOFTWARE (fc4)
Technical Support: http://www.cisco.com/techsupport
Copyright (c) 1986-2018 by Cisco Systems, Inc.
Compiled Mon 05-Nov-18 19:32 by mcpre
                          BOOT = flash:packages.conf;
                   CONFIG_FILE = 
        Configuration register = 0x102
        

5. Marque si se habilita el Auto-inicio

C9500#show boot system 
---------------------------
Switch 1
---------------------------
Current Boot Variables:
BOOT variable = flash:packages.conf;

Boot Variables on next reload:
BOOT variable = flash:packages.conf;
Manual Boot = no <<<<< Manual Boot should be set to "no"   
Enable Break = no
Boot Mode = DEVICE
iPXE Timeout = 0
---------------------------
Switch 2
---------------------------
Current Boot Variables:
BOOT variable = flash:packages.conf;

Boot Variables on next reload:
BOOT variable = flash:packages.conf;
Manual Boot = no
Enable Break = no
Boot Mode = DEVICE
iPXE Timeout = 0 

Si el Auto-inicio no se habilita, esto se puede cambiar como abajo:

C9500(config)#no boot manual

6. Marque el ISSU actual y instale los estados.

     NOTA: ESTE PASO ES MUY IMPORTANTE

C9500#show issu state detail
--- Starting local lock acquisition on switch 1 ---
Finished local lock acquisition on switch 1

No ISSU operation is in progress <<<<<<<<< If see anything else, abort ISSU before proceeding. Check below on how to manually abort ISSU.



 C9500#show install summary
[ Switch 1 2 ] Installed Package(s) Information:
State (St): I - Inactive, U - Activated & Uncommitted,
            C - Activated & Committed, D - Deactivated & Uncommitted
--------------------------------------------------------------------------------
Type  St   Filename/Version    
--------------------------------------------------------------------------------
IMG   C    16.9.2.0.2433  <<<<<<<< State should be Activated & Committed for current version alone. If not clear install state before proceeding. Check below on how to clear install state. 
--------------------------------------------------------------------------------
Auto abort timer: inactive
--------------------------------------------------------------------------------

7. Copie la nueva imagen que se actualizará/retrocedida.

Es suficiente copiar la imagen solamente al chasis activo (en caso de Stackwise) o al supervisor activo (en caso de Cat9400 SUP dual).

C9500#copy tftp: bootflash:
Address or name of remote host []? X.X.X.X
Source filename []? cat9k_iosxe.16.09.02.SPA.bin
Destination filename [cat9k_iosxe.16.09.02.SPA.bin]? 
 

Flujos de trabajo ISSU - Actualización real

Una vez que se verifican todos los requisitos previos, usted puede proceeed con la actualización real usando uno de los métodos abajo:

•            flujo de trabajo 1-Step (solamente un paso y no soporta rueda detrás)
•            flujo de trabajo 3-Step (implica 3 pasos y soporta la restauración no actualizada en caso del error)

flujo de trabajo 1-Step

•    Este flujo de trabajo implica solamente un paso y las ayudas en la optimización.

NOTA: Usted no puede rodar detrás mientras que la actualización está confiada automáticamente. Proceda al flujo de trabajo 3-Step si mira para rodar detrás.

// Below example has SW-2 as Active and Sw-1 as Standby before starting ISSU


C9500#install add file flash:cat9k_iosxe.16.09.02.SPA.bin activate issu commit
install_add_activate_commit: START Fri Feb  8 10:07:51 jst 2019

*Feb  8 10:07:52.456 jst: %INSTALL-5-INSTALL_START_INFO: Switch 2 R0/0: install_engine: Started install one-shot ISSU flash:cat9k_iosxe.16.09.02.SPA.bininstall_add_activate_commit: Adding ISSU

--- Starting initial file syncing ---
[2]: Copying flash:cat9k_iosxe.16.09.02.SPA.bin from switch 2 to switch 1
[1]: Finished copying to switch 1  
Info: Finished copying flash:cat9k_iosxe.16.09.02.SPA.bin to the selected switch(es)
Finished initial file syncing

--- Starting Add ---
Performing Add on all members
  [1] Add package(s) on switch 1
  [1] Finished Add on switch 1
  [2] Add package(s) on switch 2
  [2] Finished Add on switch 2
Checking status of Add on [1 2]
Add: Passed on [1 2]
Finished Add

install_add_activate_commit: Activating ISSU

NOTE: Going to start Oneshot ISSU install process
 STAGE 0: Initial System Level Sanity Check before starting ISSU
===================================================
--- Verifying install_issu supported ---
--- Verifying standby is in Standby Hot state ---
--- Verifying booted from the valid media ---
--- Verifying AutoBoot mode is enabled ---
Finished Initial System Level Sanity Check


STAGE 1: Installing software on Standby
===================================================
--- Starting install_remote ---
Performing install_remote on Chassis remote
[1] install_remote package(s) on switch 1
[1] Finished install_remote on switch 1
install_remote: Passed on [1]
Finished install_remote

 STAGE 2: Restarting Standby
===================================================
--- Starting standby reload ---
Finished standby reload

--- Starting wait for Standby to reach terminal redundancy state ---     <<<<< Standby (Sw-1) reloads here!!!


<<<<<<<< After Standby (Sw-1) comes up >>>>>>>>>>>

*Feb  8 10:19:10.223 jst: %REDUNDANCY-3-IPC: IOS versions do not match.

*Feb  8 10:19:48.421 jst: %HA_CONFIG_SYNC-6-BULK_CFGSYNC_SUCCEED: Bulk Sync succeeded

*Feb  8 10:19:49.422 jst: %RF-5-RF_TERMINAL_STATE: Terminal state reached for (SSO) <<<<< Standby (Sw-1) comes up on new code and joins as Hot Standby..


*Feb  8 10:21:02.975 jst: %PLATFORM-6-HASTATUS_DETAIL: RP switchover, received chassis event became active. Switch to primary (count 1)  <<<<<< Switchover happens after this log and the previous active (Sw-2) reloads.

<<<<<<<< After new Standby (Sw-2) comes up >>>>>>>>

*Feb  8 10:27:09.715 jst: %HA_CONFIG_SYNC-6-BULK_CFGSYNC_SUCCEED: Bulk Sync succeeded

*Feb  8 10:27:10.717 jst: %RF-5-RF_TERMINAL_STATE: Terminal state reached for (SSO). <<<< ISSU commit starts after this automatically..


*Feb  8 10:28:27.302 jst: %INSTALL-5-INSTALL_START_INFO: Switch 2 R0/0: install_engine: Started install commit
%IOSXEBOOT-4-ISSU_ONE_SHOT: (rp/0): ISSU finished successfully

*Feb  8 10:29:32.127 jst: %INSTALL-5-INSTALL_COMPLETED_INFO: Switch 2 R0/0: install_engine: Completed install commit ISSU   

 Proceda a después de que se complete ISSU.

flujo de trabajo 3-Step

• Este flujo de trabajo implica tres pasos — agregue, active, y confíe. Después de la activación, todo el Switches se actualiza a la nueva versión de software salvo que el software no está confiado automáticamente sino se debe realizar manualmente vía el comando commit del instalar.
• La ventaja de este acercamiento es el sistema se puede rodar de nuevo a una versión del software anterior.
• El sistema rueda automáticamente detrás si el temporizador de la restauración no actualizada no se para usando la parada del auto-aborto-temporizador del instalar o el comando commit del instalar. Si se para el temporizador de la restauración no actualizada, la nueva versión de software se podría funcionar con en el dispositivo para cualquier duración y después rodar de nuevo a la versión anterior.

PASO 1: Install_add

 Este comando descarga la imagen en el bootflash y la amplía en ambo el Switches.

// Below example has SW-1 as Active and Sw-2 as Standby before starting ISSU

C9500#install add file flash:cat9k-universalk9.SPA.16.09.03.BETA.E1.SSA.bin.bin    
install_add: START Fri Feb  8 09:22:00 jst 2019

*Feb  8 09:22:02.055 jst: %INSTALL-5-INSTALL_START_INFO: Switch 1 R0/0: install_engine: Started install add flash:cat9k-universalk9.SPA.16.09.03.BETA.E1.SSA.bin.bininstall_add: Adding PACKAGE

--- Starting initial file syncing ---
[1]: Copying flash:cat9k-universalk9.SPA.16.09.03.BETA.E1.SSA.bin.bin from switch 1 to switch 2
[2]: Finished copying to switch 2  
Info: Finished copying flash:cat9k-universalk9.SPA.16.09.03.BETA.E1.SSA.bin.bin to the selected switch(es)
Finished initial file syncing

--- Starting Add ---
Performing Add on all members
  [1] Add package(s) on switch 1
  [1] Finished Add on switch 1
  [2] Add package(s) on switch 2
  [2] Finished Add on switch 2
Checking status of Add on [1 2]
Add: Passed on [1 2]
Finished Add

SUCCESS: install_add  Fri Feb  8 09:26:26 jst 2019 <<<< Wait until install_add says SUCCESS. If fails, manually abort ISSU.

PASO 2: Install_activate

Al ejecutar este comando, la Secuencia de eventos siguiente ocurre:

    (i) Se comienza un temporizador de la restauración no actualizada. Si expira el temporizador de la restauración no actualizada, el sistema rueda de nuevo al mismo estado antes del inicio del ISSU. El temporizador de la restauración no actualizada se puede parar usando el comando stop del auto-aborto-temporizador del instalar. ISSU se puede rodar detrás usando instala el comando del issu del aborto.

    (ii) El Switch espera es aprovisionado con el nuevo software y recarga con la nueva versión de software. Después, el Switch activo es aprovisionado con el nuevo software y recarga. El Switch espera con la nueva imagen ahora se convierte en el Switch activo y el viejo Switch activo se convierte en el recurso seguro.

    En el final de este procedimiento, ambos el Switches funcionado con con la nueva imagen del software.

C9500#install activate issu
install_activate: START Fri Feb  8 09:28:27 jst 2019
install_activate: Activating ISSU

*Feb  8 09:28:28.905 jst: %INSTALL-5-INSTALL_START_INFO: Switch 1 R0/0: install_engine: Started install activate ISSU
NOTE: Going to start Activate ISSU install process

STAGE 0: Initial System Level Sanity Check before starting ISSU
===================================================
--- Verifying install_issu supported ---
--- Verifying standby is in Standby Hot state ---
--- Verifying booted from the valid media ---
--- Verifying AutoBoot mode is enabled ---
Finished Initial System Level Sanity Check

 STAGE 1: Installing software on Standby
===================================================
--- Starting install_remote ---
Performing install_remote on Chassis remote

*Feb  8 09:28:31.880 jst: %INSTALL-5-INSTALL_AUTO_ABORT_TIMER_PROGRESS: Switch 1 R0/0: rollback_timer: Install auto abort timer will expire in 7200 seconds


[2] install_remote package(s) on switch 2
[2] Finished install_remote on switch 2
install_remote: Passed on [2]
Finished install_remote


STAGE 2: Restarting Standby
===================================================
--- Starting standby reload ---
Finished standby reload

--- Starting wait for Standby to reach terminal redundancy state ---      <<<<<<<< Standby (Sw-2) reloads here!!!


*Feb 8 09:35:16.489 jst: %REDUNDANCY-3-IPC: IOS versions do not match.
 
*Feb  8 09:36:00.238 jst: %HA_CONFIG_SYNC-6-BULK_CFGSYNC_SUCCEED: Bulk Sync succeeded
*Feb  8 09:36:01.240 jst: %RF-5-RF_TERMINAL_STATE: Terminal state reached for (SSO)     <<<< At this point, Standby (Sw-2) comes up with new code and joins as Hot Standby  Finished wait for Standby to reach terminal redundancy state 
 STAGE 3: Installing software on Active
===================================================
--- Starting install_active ---
Performing install_active on Chassis 1


1] install_active package(s) on switch 1
[1] Finished install_active on switch 1
install_active: Passed on [1]
Finished install_active



Chassis 1 reloading, reason - Non participant detected
STAGE 4: Restarting Active (switchover to standby)         <<<<<<<< At this point, there is a switchover and then the previous Active (Sw-1) reloads. ===================================================
--- Starting active reload ---
 New software will load after reboot process is completed
SUCCESS: install_activate  Fri Feb  8 09:37:14 jst 2019

En el extremo del estado Activate, marque los estados ISSU.

C9500#show issu state detail
--- Starting local lock acquisition on switch 2 ---
Finished local lock acquisition on switch 2

Operation type: Step-by-step ISSU
Install type  : Image installation using ISSU
Current state : Activated state
Last operation: Switchover
 Completed operations: Operation Start time ------------------------------------------------------- Activate location standby Chassis 2 2019-02-08:09:28:32 Activate location active Chassis 1 2019-02-08:09:36:03 Switchover 2019-02-08:09:37:16

State transition: Added -> Standby activated -> Active switched-over 

Auto abort timer: automatic, remaining time before rollback: 01:43:55
Running image: flash:packages.conf
Operating mode: sso, terminal state reached                 <<<<< Wait until SSO terminal state before proceeding to commit.

PASO 3: Install_commit

El comando commit realiza el necesario limpia, habilita el nuevo software como permanente (que quita la versión anterior del software) y para el temporizador de la restauración no actualizada. Cualquier reinicialización después del cometer iniciará con el nuevo software.

C9500#install commit 
install_commit: START Fri Feb  8 09:45:22 jst 2019
install_commit: Committing ISSU

*Feb  8 09:45:23.533 jst: %INSTALL-5-INSTALL_START_INFO: Switch 2 R0/0: install_engine: Started install commit

NOTE: Going to start Commit ISSU install process

STAGE 0: Initial System Level Sanity Check before starting ISSU
===================================================
--- Verifying install_issu supported ---
--- Verifying standby is in Standby Hot state ---
--- Verifying booted from the valid media ---
--- Verifying AutoBoot mode is enabled ---
Finished Initial System Level Sanity Check

--- Starting install_commit_2 ---
Performing install_commit_2 on Chassis 2
[2] install_commit_2 package(s) on switch 2
[2] Finished install_commit_2 on switch 2
install_commit_2: Passed on [2]
Finished install_commit_2


STAGE 1: Dispatching the commit command to remote
===================================================
--- Starting install_commit_remote ---
Performing install_commit_remote on Chassis 1
Feb  8 09:48:33.364: %INSTALL-5-INSTALL_START_INFO: R0/0: install_engine: Started install commit

*Feb  8 09:48:33.352 jst: %INSTALL-5-INSTALL_START_INFO: Switch 1 R0/0: install_engine: Started install commit


Feb  8 09:51:27.505: %INSTALL-5-INSTALL_COMPLETED_INFO: R0/0: install_engine: Completed install commit ISSU
[1] install_commit_remote package(s) on switch 1
[1] Finished install_commit_remote on switch 1
install_commit_remote: Passed on [1]
Finished install_commit_remote

SUCCESS: install_commit  Fri Feb  8 09:51:27 jst 2019     <<<<< ISSU is completed here!!!!! 

Lista de verificación del poste ISSU

Una vez que ISSU se completa con éxito,

• Marque si ambo Switches se está ejecutando en el nuevo software.
• Marque “el detalle del estado del issu de la demostración” hecho salir para ser limpio y que no muestra ningún ISSU en curso.
• El control “demostración instala el historial del issu” hecho salir para asegurar la operación acertada ISSU (NOTA: Comando disponible solamente encendiendo la versión 16.10.1)
• Se recomienda para dar bastantes remoja el tiempo en el nuevo software antes de habilitar cualquier nueva función.

Acción en el error ISSU

• Si ISSU falla, se espera que el auto-aborto recupere el sistema de nuevo al estado inicial (una más vieja imagen). Sin embargo, si ésta falla también, la recuperación manual del chasis se espera.
• Durante la recuperación manual, control si el active y el recurso seguro están funcionando con la más vieja imagen (si no - recupere el chasis individual)
• Después de asegurar ambos chasis están funcionando con la imagen anterior, se ejecutan “instalan quitan inactivo” para quitar cualquier paquete inusitado de la imagen.
• Una vez que ambos chasis están funcionando con el viejo software, limpie manualmente a todos los estados internos de operación ISSU. (Refiérase abajo en cómo limpiar los estados internos ISSU)

1. Aborte ISSU

• En el flujo de trabajo 3-Step, durante el proceso del activar ISSU, si expira el aborto-temporizador, el sistema auto-aborto a una más vieja imagen.

Nota: Si el recurso seguro no alcanza el SSO durante el aborto, se requiere el aborto manual. También, si por cualquier motivo usted desea abortar el ISSU mientras tanto, se requiere el aborto manual.

EXAMPLE : During install add, we notice the below errors:

C9400#install add file flash:cat9k_iosxe.16.09.02.SPA.bin
install_add: START Tue Nov 13 20:47:53 UTC 2018

*Nov 13 20:47:54.787: %INSTALL-5-INSTALL_START_INFO: Chassis 1 R1/0: install_engine: Started install add flash:cat9k_iosxe.16.09.02.SPA.bininstall_add: Adding PACKAGE

--- Starting initial file syncing ---
[1]: Copying flash:cat9k_iosxe.16.09.02.SPA.bin from chassis 1 to chassis 2
[2]: Finished copying to chassis 2  
Info: Finished copying flash:cat9k_iosxe.16.09.02.SPA.bin to the selected chassis
Finished initial file syncing

--- Starting Add ---
Performing Add on all members
  [1] Add package(s) on chassis 1
  [1] Finished Add on chassis 1
  [2] Add package(s) on chassis 2
    cp: cannot stat '/tmp/packages.conf': No such file or directory
  [2] Finished Add on chassis 2
Checking status of Add on [1 2]
Add: Passed on [1]. Failed on [2]
Finished Add

FAILED: install_add exit(1) Tue Nov 13 20:51:58 UTC 2018 <<<<<< install_add failed. If see any such error, first do a manual abort before proceeding further. 

C9400#install abort issu 
install_abort: START Tue Nov 13 20:57:40 UTC 2018
install_abort: Abort type ISSU subtype NONE smutype NONE

*Nov 13 20:57:41.759: %INSTALL-5-INSTALL_START_INFO: Chassis 1 R1/0: install_engine: Started install abort ISSU
NOTE: Going to start Abort ISSU install process

STAGE 0: Initial System Level Sanity Check before starting ISSU
===================================================
--- Verifying install_issu supported ---
--- Verifying booted from the valid media ---
--- Verifying AutoBoot mode is enabled ---
Finished Initial System Level Sanity Check

FAILED: ABORT operation is not allowed in ADDED state
ERROR: install_abort  exit(2 ) Tue Nov 13 20:57:49 UTC 2018

*Nov 13 20:57:49.756: %INSTALL-5-INSTALL_COMPLETED_INFO: Chassis 1 R1/0: install_engine: Completed install abort ISSU 

estado 2.Cleaning ISSU

Si la actualización/el downgrade/el aborto/el auto-aborto ISSU no es acertados, se requiere el manual limpia de los estados internos ISSU.

C9400#sh issu state detail
--- Starting local lock acquisition on chassis 1 ---
Finished local lock acquisition on chassis 1

Operation type: One-shot ISSU
Install type  : Image installation using ISSU
Current state : Added state Last operation: Activate location standby Chassis 2   <<<< Previous Add is still pending. This needs to be cleared before starting ISSU 
Completed operations:

Operation                           Start time
-------------------------------------------------------
Activate location standby Chassis 2 2018-11-13:16:26:34   

State transition: Added 

Auto abort timer: inactive
Running image: flash:packages.conf
Operating mode: sso, terminal state not reached

NOTE: Enable Service Internal before run the below command

C9400#clear install state 
clear_install_state: START Tue Nov 13 17:05:47 UTC 2018
--- Starting clear_install_state ---
Performing clear_install_state on all members
  [1] clear_install_state package(s) on chassis 1
  [1] Finished clear_install_state on chassis 1
Checking status of clear_install_state on [1]
clear_install_state: Passed on [1]
Finished clear_install_state 
 C9400#sh issu state detail 
--- Starting local lock acquisition on chassis 1 ---
Finished local lock acquisition on chassis 1

No ISSU operation is in progress