H3C S6300 Switch Series
ISSU Configuration Examples

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

Contents

Introduction· 1

Prerequisites· 1

General configuration restrictions and guidelines· 1

Example: Performing a compatible ISSU·· 3

Network requirements· 3

Software version used· 3

Configuration restrictions and guidelines· 3

Configuration procedures· 3

Verifying the configuration· 6

Configuration files· 6

Example: Performing an incompatible ISSU·· 7

Network requirements· 7

Software version used· 7

Configuration restrictions and guidelines· 7

Configuration procedures· 7

Verifying the configuration· 9

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 ·     ISSU Reboot ·     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.

General configuration restrictions and guidelines

Before performing an ISSU, you must complete the following preparation tasks:

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

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

·     Use the dir command to verify that the device has sufficient storage space for the upgrade images. If the storage space is not sufficient, delete unused files.

·     For service continuity during ISSU, verify that the following feature settings are configured:

 

Feature	Setting requirements
GR/NSR	Enable GR or NSR for protocols including LDP and FSPF.
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	Configure IRF bridge MAC persistence as follows: ·     Compatible upgrade—Configure the irf mac-address persistent timer or irf mac-address persistent always command. ·     Incompatible upgrade—Configure the irf mac-address persistent always command if the bridge MAC address is the MAC address of the device for which you want to execute the issu load command.

 

·     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.

During an ISSU, use the following guidelines:

·     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:

¡     Reboot, add, or remove cards.

¡     Execute commands that are not for ISSU.

¡     Modify, delete, or rename image files.

The following describes restrictions and guidelines for an ISSU.

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. Otherwise, upgrade failure or system exceptions might occur.

Upgrade restrictions

·     Read the software release notes to identify the following items:

¡     Support of the device for ISSU.

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

·     Use the dir command to verify that the device has sufficient storage space for the upgrade images. If the storage space is not sufficient, delete unused files by using the delete 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 and FSPF.
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	Configure IRF bridge MAC persistence as follows: ·     Compatible upgrade—Configure the irf mac-address persistent timer or irf mac-address persistent always command. ·     Incompatible upgrade—Configure the irf mac-address persistent always command if the bridge MAC address is the MAC address of the device for which you want to execute the issu load command.

 

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:

¡     Reboot, add, or remove cards.

¡     Execute commands that are irrelevant to the ISSU.

¡     Modify, delete, or rename image files.

Example: Performing a compatible ISSU

Network requirements

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 R2310 to R2311.

Figure 1 Network diagram

 

 

Software version used

This configuration example was created and verified on S6300-CMW710-R2310.

Configuration restrictions and guidelines

When you perform the compatible ISSU, follow these restrictions and guidelines:

·     The available storage space on each member device must be at least two times the size of the new image.

·     Do not execute commands that are irrelevant to the ISSU.

·     The automatic rollback timer starts after you execute the issu run switchover command. If no exception occurs, execute the issu accept or issu commit command to complete the upgrade before this timer expires. If an exception occurs, manually roll back or wait for the system to automatically roll back to the original software images, and then perform a new upgrade.

·     After you execute the issu accept or issu commit command, the system automatically deletes the rollback timer.

Configuration procedures

# Download the new image file R2311.IPE from the TFTP server to the master. The file includes a boot-R2311.bin image and a system-R2311.bin image.

<Sysname> tftp 2.2.2.2 get R2311.ipe

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

                                 Dload  Upload   Total   Spent    Left  Speed

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

# Display current software images.

<Sysname> display install active

Active packages on slot 1:

  flash:/boot-r2310.bin

  flash:/system-r2310.bin

Active packages on slot 2:

  flash:/boot-r2310.bin

  flash:/system-r2310.bin

# Display version compatibility information and identify the ISSU method.

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

Boot image: boot-r2311.bin

  Version:

  7.1.045P11

 

System image: system-r2311.bin

  Version:

  R2311

  Version compatibility list:

  E2306P02

  R2310

  R2311P01

  R2311

  Version dependency boot list:

  7.1.045P11

 

  Slot                        Upgrade Way

  1                           Reboot

  2                           Reboot

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

# Set the rollback timer to 120 minutes (the default is 45 minutes).

<Sysname> system-view

[Sysname] issu rollback-timer 120

<Sysname> quit

# Upgrade the subordinate.

<Sysname> issu load file ipe flash:/R2311.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

Successfully copied flash:/boot-r2311.bin to slot2#flash:/boot-r2311.bin.

Successfully copied flash:/system-r2311.bin to slot2#flash:/system-r2311.bin.

Upgrade summary according to following table:

 

flash:/boot-r2311.bin

  Running Version             New Version

  Release 2310                Release 2311

 

flash:/system-r2311.bin

  Running Version             New Version

  Release 2310                Release 2311

 

  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: None

Current upgrading slot:

  slot 2

Previous version list:

  boot: 7.1.045 Release 2310

  system: 7.1.045 Release 2310

Upgrade version list:

  boot: 7.1.045, Release 2311

  system: 7.1.045, Release 2311

# Perform a master/subordinate switchover.

<Sysname> issu run switchover

Upgrade summary according to following table:

 

flash:/boot-r2311.bin

  Running Version             New Version

  Release 2310                Release 2311

 

flash:/system-r2310.bin

  Running Version             New Version

  Release 2310                Release 2311

 

  Slot                        Switchover Way

  1                           Master subordinate switchover

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

# Verify that the switchover has completed.

<Sysname> display issu state

ISSU state: switchover

Compatibility: Unknown

Work state: Normal

Upgrade method: card by card

Upgraded chassis: None

Current upgrading chassis: None

Current version list:

  boot: 7.1.045, Feature com

  system: 7.1.045, Feature com

Current software images:

  flash:/boot-r2310.bin

  flash:/system-r2310.bin

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

# Upgrade the original master.

<Sysname> issu commit slot 1

Upgrade summary according to following table:

 

flash: /boot-r2311.bin

  Running Version             New Version

  Release 2310                Release 2311

 

flash: /boot-r2311.bin

  Running Version             New Version

  Release 2310                Release 2311

 

  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: Unknown

Work state: Normal

Upgrade method: card by card

Upgraded chassis: None

Current upgrading chassis: None

Current version list:

  boot: 7.1.045, Feature com

  system: 7.1.045, Feature com

Current software images:

  flash:/boot-r2311.bin

  flash:/system-r2311.bin

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

Verifying the configuration

# Verify that startup images have been upgraded to R2311.

<Sysname> display install active

Active packages on slot 1:

  flash:/boot-r2311.bin

  flash:/system-r2311.bin

Active packages on slot 2:

  flash:/boot-r2311.bin

  flash:/system-r2311.bin

Configuration files

The system does not save the commands used in the configuration procedures to a configuration file.

Example: Performing an incompatible ISSU

Network requirements

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 R2310 to R2311.

Figure 2 Network diagram

 

 

Software version used

This configuration example was created and verified on S6300-CMW710-R2310.

Configuration restrictions and guidelines

When you perform the incompatible ISSU, follow these restrictions and guidelines:

·     The available storage space on each member device must be at least two times the size of the new image.

·     Do not execute commands that are irrelevant to the ISSU.

Configuration procedures

# Download the new image file R2311.IPE from the TFTP server to the master. The file includes a boot-R2311.bin image and a system-R2311.bin image.

<Sysname> tftp 2.2.2.2 get R2311.ipe

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

                                 Dload  Upload   Total   Spent    Left  Speed

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

# Display current software images.

<Sysname> display install active

Active packages on slot 1:

  flash:/boot-r2310.bin

  flash:/system-r2310.bin

Active packages on slot 2:

  flash:/boot-r2310.bin

  flash:/system-r2310.bin

# Display version compatibility information and identify the ISSU method.

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

Boot image: boot-r2311.bin

  Version:

  7.1.045P02

 

System image: system-r2311.bin

  Version:

  R2310

  Version compatibility list:

  R2311

  Version dependency boot list:

  7.1.045P02

Incompatible upgrade.

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

# Upgrade the subordinate.

<Sysname> issu load file ipe flash:/R2311.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

Successfully copied flash:/boot-r2311.bin to slot2#flash:/boot-r2311.bin.

Successfully copied flash:/system-r2311.bin to slot2#flash:/system-r2311.bin.

 

flash:/boot-r2311.bin

  Running Version             New Version

  Release 2310                Release 2311

 

flash:/system-r2311.bin

  Running Version             New Version

  Release 2310                Release 2311

 

  Slot                        Upgrade Way

  2                           Reboot

Upgrading software images to incompatible 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: None

Current upgrading slot:

  slot 2

Previous version list:

  boot: 7.1.045 Release 2310

  system: 7.1.045 Release 2310

Upgrade version list:

  boot: 7.1.045, Release 2311

  system: 7.1.045, Release 2311

# Perform a master/subordinate switchover to complete upgrade.

<Sysname> issu run switchover

Successfully copied flash:/boot-r2311.bin to slot2#flash:/boot-r2311.bin.

Successfully copied flash:/system-r2311.bin to slot2#flash:/system-r2311.bin.

 

flash:/boot-r2311.bin

  Running Version             New Version

  Release 2310                Release 2311

 

flash:/system-r2311.bin

  Running Version             New Version

  Release 2310                Release 2311

 

  Slot                        Upgrade Way

  2                           Reboot

  1                           Reboot

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

# View ISSU state.

<Sysname> display issu state

ISSU state: Init

Compatibility: Unknown

Work state: Normal

Upgrade method: card by card

Upgraded chassis: None

Current upgrading chassis: None

Current version list:

  boot: 7.1.045, Feature com

  system: 7.1.045, Feature com

Current software images:

  flash:/boot-r2311.bin

  flash:/system-r2311.bin

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

Verifying the configuration

# Verify that startup images have been upgraded to R2311.

<Sysname> display install active

Active packages on slot 1:

  flash:/boot-r2311.bin

  flash:/system-r2311.bin

Active packages on slot 2:

  flash:/boot-r2311.bin

  flash:/system-r2311.bin

Configuration files

The system does not save the commands used in the configuration procedures to a configuration file.

Related documentation

·     H3C S6300 Switch Series Fundamentals Configuration Guide-Release 23xx

·     H3C S6300 Switch Series Fundamentals Command Reference-Release 23xx