H3C ISSU Examples

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

Software version: Release 7577P04

Document version: 6W100-20190330

 

 

Contents

Introduction· 1

Prerequisites· 1

Restrictions and guidelines· 1

Example: Performing a compatible ISSU· 2

Network configuration· 2

Procedures· 2

Verifying the configuration· 6

Configuration files· 6

Example: Performing an incompatible ISSU· 7

Network configuration· 7

Procedures· 7

Verifying the configuration· 10

Configuration files· 10

Related documentation· 10

 

Introduction

This document provides compatible and incompatible ISSU configuration examples.

Before performing an ISSU, use the display version comp-matirx command to view the ISSU method in the Upgrade Way field. Table 1 shows a matrix of ISSU types and ISSU methods.

Table 1 Matrix of ISSU types and ISSU methods

ISSU type	ISSU method displayed in Upgrade Way
Compatible	·         Service Upgrade ·         File Upgrade ·         Reboot
Incompatible	Incompatible upgrade

 

Prerequisites

The configuration examples in this document were created and verified in a lab environment, and all the devices were started with the factory default configuration. When you are working on a live network, make sure you understand the potential impact of every command on your network.

This document assumes that you have basic knowledge of ISSU.

Restrictions and guidelines

Hardware requirements

·          Log in to the device through the console port. If you use Telnet or SSH, you might be disconnected from the device before the ISSU is completed.

·          Do not perform an ISSU during hardware upgrade or failure.

Upgrade restrictions

·          Read the software release notes to identify support of the device for ISSU.

·          Use the display device command to verify that no member devices are in Fault state.

·          Use the dir command to verify that the available storage space on each member device is at least two times the size of the new image. If the storage space is not sufficient, delete unused files by using the delete /unreserved file-url command.

Feature restrictions

For service continuity during ISSU, configure the following feature settings:

 

Feature	Setting requirements
GR or NSR	Enable GR or NSR for protocols including LDP, RSVP, OSPF, ISIS, BGP, and FSPF.
BFD	Disable BFD for protocols including LDP, RSVP, OSPF, ISIS, RIP, BGP, VRRP, and NQA.
Ethernet link aggregation	Use the long LACP timeout interval (the lacp period short command is not configured) on all member ports in dynamic aggregation groups.
IRF	·         Use link-delay to set the physical state change suppression interval to 0 on Ethernet interfaces, so the interfaces report physical state changes to the CPU in time. ·         Enable link-aggregation traffic redirection to avoid link-aggregation traffic loss. ·         Configure the irf mac-address persistent always command. ·         To perform an incompatible upgrade for an IRF fabric, disable IRF MAD before the upgrade. After the upgrade, enable IRF MAD again.

 

Operation restrictions

·          In a multiuser environment, make sure no other administrators access the device while you are performing the ISSU.

·          Do not perform any of the following tasks during an ISSU:

¡  Execute commands that are irrelevant to the ISSU.

¡  Modify, delete, or rename image files.

Example: Performing a compatible ISSU

Network configuration

As shown in Figure 1, the two-chassis IRF fabric and the TFTP server can reach each other. Perform a compatible ISSU on the IRF to upgrade startup images from R7150 to R7577P01.

Figure 1 Network diagram

 

Procedures

# Download the new image file new.ipe from the TFTP server to the root directory of a file system on the master. The .ipe file includes boot image file boot-R7577P01.bin and system image file system-R7577P01.bin.

<Sysname> tftp 2.2.2.2 get new.ipe

  % Total    % Received % Xferd  Average Speed   Time    Time     Time  Current

                                 Dload  Upload   Total   Spent    Left  Speed

100   256  100  256     0     0    764      0 --:--:-- --:--:-- --:--:--   810

# Display current software images.

<Sysname> display boot-loader

Software images on slot 1:

Current software images:

  flash:/boot-R7150.bin

  flash:/system-R7150.bin

Main startup software images:

  flash:/boot-R7150.bin

  flash:/system-R7150.bin

Backup startup software images:

  flash:/boot-R7150.bin

  flash:/system-R7150.bin

Software images on slot 2:

Current software images:

  flash:/boot-R7150.bin

  flash:/system-R7150.bin

Main startup software images:

  flash:/boot-R7150.bin

  flash:/system-R7150.bin

Backup startup software images:

  flash:/boot-R7150.bin

  flash:/system-R7150.bin

# Display the recommended ISSU method.

<Sysname> display version comp-matrix file ipe flash:/new.ipe

Verifying image file.......Done.

Verifying the file flash:/new.ipe on slot 1.....Done.

Identifying the upgrade methods...........Done.

 

  Slot              Upgrade Way

  1                 Reboot

The output shows the two versions are compatible and a reboot upgrade is recommended.

# Disable automatic rollback.

<Sysname> system-view

[Sysname] issu rollback-timer 0

# Enable link-aggregation traffic redirection.

[Sysname] link-aggregation lacp traffic-redirect-notification enable

# Enable the IRF bridge MAC address to be permanent.

[Sysname] irf mac-address persistent always

# Set the physical state change suppression interval to 0 on the Ethernet interfaces.

[Sysname] interface ten-gigabitethernet1/1/1

[Sysname-Ten-GigabitEthernet1/1/1] link-delay 0 mode updown

[Sysname-Ten-GigabitEthernet1/1/1] quit

[Sysname] interface ten-gigabitethernet1/1/1

[Sysname-Ten-GigabitEthernet1/1/1] link-delay 0 mode updown

[Sysname-Ten-GigabitEthernet1/1/1] quit

[Sysname] quit

# Upgrade the subordinate.

<Sysname> issu load file ipe flash:/new.ipe slot 2

This operation will delete the rollback point information for the previous upgrade and maybe get unsaved configuration lost. Continue? [Y/N]:y

Verifying the file flash:/boot-R7577P01.bin on slot 1...Done.

Verifying the file flash:/system-R7577P01.bin on slot 1...Done.

Copying file flash:/boot-R7577P01.bin to #slot2#flash:/boot-R7577P01.bin......Done.

Copying file flash:/system-R7577P01.bin to #slot2#flash:/system-R7577P01.bin......Done.

Verifying the file flash:/boot-R7577P01.bin on slot 2...Done.

Verifying the file flash:/system-R7577P01.bin on slot 2...Done.

Upgrade summary according to following table:

 

flash:/boot-R7577P01.bin

  Running Version             New Version

  Release 7150                Release 7577P01

 

flash:/system-R7577P01.bin

  Running Version             New Version

  Release 7150                Release 7577P01

 

  Slot              Upgrade Way

  2                 Reboot

Upgrading software images to compatible versions. Continue? [Y/N]: y

This operation might take several minutes, please wait...Done.

# Verify that the ISSU is finished on the subordinate.

<Sysname> display issu state

ISSU state: Loaded

Compatibility: Compatible

Work state: Normal

Upgrade method: Card by card

Upgraded slot:

  slot 2

Current upgrading slot: None

Current version list:

  boot: 7.1.070, Release 7577P01

  system: 7.1.070, Release 7577P01

Current software images:

  flash:/boot-R7577P01.bin

  flash:/system-R7577P01.bin

# Perform a master/subordinate switchover.

<Sysname> issu run switchover

Upgrade summary according to following table:

 

flash:/boot-R7577P01.bin

  Running Version             New Version

  Release 7150                Release 7577P01

 

flash:/system-R7577P01.bin

  Running Version             New Version

  Release 7150                Release 7577P01

 

  Slot              Switchover Way

  1                 Active standby process switchover

Upgrading software images to compatible versions. Continue? [Y/N]:y

This operation might take several minutes, please wait...Done..

# Verify that the switchover has completed.

<Sysname> display issu state

ISSU state: Switchover

Compatibility: Compatible

Work state: Normal

Upgrade method: Card by card

Upgraded slot:

  slot 1

Current upgrading slot: None

Current version list:

  boot: 7.1.070, Release 7577P01

  system: 7.1.070, Release 7577P01

Current software images:

  flash:/boot-R7577P01.bin

  flash:/system-R7577P01.bin

// The Switchover ISSU state indicates the switchover has completed.

# Upgrade the original master.

<Sysname> issu commit slot 1

This operation will delete the rollback point information for the previous upgra

de and maybe get unsaved configuration lost. Continue? [Y/N]:y

Copying file flash:/boot-R7577P01.bin to slot1#flash:/boot-R7577P01.bin......Done.

Verifying the file flash:/boot-R7577P01.bin on slot 1...Done.

Copying file flash:/system-R7577P01.bin to slot1#flash:/system-R7577P01.bin......Done.

Verifying the file flash:/system-R7577P01.bin on slot 1...Done.

Upgrade summary according to following table:

 

flash:/boot-R7577P01.bin

  Running Version             New Version

  Release 7150                Release 7577P01

 

flash:/system-R7577P01.bin

  Running Version             New Version

  Release 7150                Release 7577P01

 

  Slot              Upgrade Way

  1                 Reboot

Upgrading software images to compatible versions. Continue? [Y/N]: y

# View ISSU state.

<Sysname> display issu state

ISSU state: Init

Compatibility: Compatible

Work state: Normal

Upgrade method: Card by card

Upgraded slot: None

Current upgrading slot: None

Current version list:

  boot: 7.1.070, Release 7577P01

  system: 7.1.070, Release 7577P01

Current software images:

  flash:/boot-R7577P01.bin

  flash:/system-R7577P01.bin

// The Init state indicates that the ISSU has completed.

Verifying the configuration

# Verify that startup images have been upgraded to R7577P01.

<Sysname> display install active

Active packages on slot 1:

  flash:/boot-R7577P01.bin

  flash:/system-R7577P01.bin

Active packages on slot 2:

  flash://boot-R7577P01.bin

  flash:/system-R7577P01.bin

Configuration files

#

 irf mac-address persistent always

 irf auto-update enable

 irf auto-merge enable

 undo irf link-delay

 irf member 1 priority 1

 irf mode normal

#

 issu rollback-timer 0

#

 link-aggregation lacp traffic-redirect-notification enable

#

interface Ten-GigabitEthernet1/1/1

 port link-mode bridge

 link-delay 0 mode updown

#

interface Ten-GigabitEthernet1/1/1

 port link-mode bridge

 link-delay 0 mode updown

#

Example: Performing an incompatible ISSU

Network configuration

As shown in Figure 2, the two-chassis IRF fabric and the TFTP server can reach each other. Perform an incompatible ISSU on the IRF to upgrade startup images from R7150 to R7577P01.

Figure 2 Network diagram

 

Procedures

# Download the new image file new.ipe from the TFTP server to the root directory of a file system on the master. The .ipe file includes boot image file boot-R7577P01.bin and system image file system-R7577P01.bin.

<Sysname> tftp 2.2.2.2 get new.ipe

  % Total    % Received % Xferd  Average Speed   Time    Time     Time  Current

                                 Dload  Upload   Total   Spent    Left  Speed

100 43.8M  100 42.8M    0     0   159k      0  0:04:34  0:04:34 --:--:--  165k

# Display current software images.

<Sysname> display boot-loader

Software images on slot 1:

Current software images:

  flash:/boot-R7150.bin

  flash:/system-R7150.bin

Main startup software images:

  flash:/boot-R7150.bin

  flash:/system-R7150.bin

Backup startup software images:

  flash:/boot-R7150.bin

  flash:/system-R7150.bin

Software images on slot 2:

Current software images:

  flash:/boot-R7150.bin

  flash:/system-R7150.bin

Main startup software images:

  flash:/boot-R7150.bin

  flash:/system-R7150.bin

Backup startup software images:

  flash:/boot-R7150.bin

  flash:/system-R7150.bin

# Display the recommended ISSU method.

<Sysname> display version comp-matrix file ipe flash:/new.ipe

 

Verifying image file flash:/new.ipe........Done.

Identifying the upgrade methods...........Done.

Incompatible upgrade.

The output shows the two versions are incompatible and a reboot is needed to complete upgrade.

# Enable link-aggregation traffic redirection.

[Sysname] link-aggregation lacp traffic-redirect-notification enable

# Enable the IRF bridge MAC address to be permanent.

[Sysname] irf mac-address persistent always

# Set the physical state change suppression interval to 0 on the Ethernet interfaces.

[Sysname] interface ten-gigabitethernet1/1/1

[Sysname-Ten-GigabitEthernet1/1/1] link-delay 0 mode updown

[Sysname-Ten-GigabitEthernet1/1/1] quit

[Sysname] interface ten-gigabitethernet1/1/1

[Sysname-Ten-GigabitEthernet1/1/1] link-delay 0 mode updown

[Sysname-Ten-GigabitEthernet1/1/1] quit

[Sysname] quit

# Upgrade the subordinate.

<Sysname> issu load file ipe flash:/new.ipe slot 2

Verifying the file flash:/boot-R7577P01.bin on slot 1...Done.

Verifying the file flash:/system-R7577P01.bin on slot 1...Done.

Copying file flash:/boot-R7577P01.bin to slot2#flash:/boot-R7577P01.bin......Done.

Copying file flash:/system-R7577P01.bin to slot2#flash:/system-R7577P01.bin......Done.

Verifying the file flash:/boot-R7577P01.bin on slot 2...Done.

Verifying the file flash:/system-R7577P01.bin on slot 2...Done.

Upgrade summary according to following table:

 

flash:/boot-R7577P01.bin

  Running Version             New Version

  Release 7150                Release 7577P01

 

flash:/system-R7577P01.bin

  Running Version             New Version

  Release 7150                Release 7577P01

 

  Slot              Upgrade Way

  2                 Reboot

Upgrading software images to compatible versions. Continue? [Y/N]: y

# Verify that the ISSU is finished on the subordinate.

<Sysname> display issu state

ISSU state: Loaded

Compatibility: Incompatible

Work state: Normal

Upgrade method: Card by card

Upgraded slot:

  slot 2

Current upgrading slot: None

Current version list:

  boot: 7.1.070, Release 7577P01

  system: 7.1.070, Release 7577P01

Current software images:

  flash:/boot-R7577P01.bin

  flash:/system-R7577P01.bin

# Perform a master/subordinate switchover to complete upgrade.

<Sysname> issu run switchover

Upgrade summary according to following table:

 

flash:/boot-R7577P01.bin

  Running Version             New Version

  Release 7150                Release 7577P01

 

flash:/system-R7577P01.bin

  Running Version             New Version

  Release 7150                Release 7577P01

 

  Slot              Switchover Way

  2                 Active standby process switchover

Upgrading software images to compatible versions. Continue? [Y/N]:y

# View ISSU state.

<Sysname> display issu state

ISSU state: Init

Compatibility: Incompatible

Work state: Normal

Upgrade method: Card by card

Upgraded slot: None

Current upgrading slot: None

Current version list:

  boot: 7.1.070, Release 7577P01

  system: 7.1.070, Release 7577P01

Current software images:

  flash:/boot-R7577P01.bin

  flash:/system-R7577P01.bin

// The Init state indicates that the ISSU has completed.

Verifying the configuration

# Verify that startup images have been upgraded to R7577P01.

<Sysname> display install active

Active packages on slot 1:

  flash:/boot-R7577P01.bin

  flash:/system-R7577P01.bin

Active packages on slot 2:

  flash:/boot-R7577P01.bin

  flash:/system-R7577P01.bin

Configuration files

#

 irf mac-address persistent always

 irf auto-update enable

 irf auto-merge enable

 undo irf link-delay

 irf member 1 priority 1

 irf mode normal

#

 issu rollback-timer 0

#

 link-aggregation lacp traffic-redirect-notification enable

#

interface Ten-GigabitEthernet1/1/1

 port link-mode bridge

 link-delay 0 mode updown

#

interface Ten-GigabitEthernet1/1/1

 port link-mode bridge

 link-delay 0 mode updown

#

Related documentation

·          H3C S7500E-XS Switch Series Fundamentals Command Reference-R757X

·          H3C S7500E-XS Switch Series Fundamentals Configuration Guide-R757X