boot-loader file

Use boot-loader file to specify startup software image files.

Syntax

In standalone mode:

boot-loader file boot boot-package system system-package [ feature feature-package&<1-30> ] { all | slot slot-number } { backup | main }

boot-loader file ipe-filename { all | slot slot-number } { backup | main }

In IRF mode:

boot-loader file boot boot-package system system-package [ feature feature-package&<1-30> ] { all | chassis chassis-number slot slot-number } { backup | main }

boot-loader file ipe-filename { all | chassis chassis-number slot slot-number } { backup | main }

Views

User view

Predefined user roles

network-admin

mdc-admin

Parameters

boot boot-package: Specifies a .bin boot image file. The file path specified for the boot-package argument uses the storage-medium:/filename.bin format. The file path is a string of up to 56 characters if the storage medium is flash memory. The file path is a string of up to 57 characters if the storage medium is a USB drive.

system system-package: Specifies a .bin system image file. The file path specified for the system-package argument uses the storage-medium:/filename.bin format. The file path is a string of up to 56 characters if the storage medium is flash memory. The file path is a string of up to 57 characters if the storage medium is a USB drive.

feature feature-package: Specifies a space-separated list of up to 30 .bin feature image files. Each file path uses the storage-medium:/filename.bin format. The file path is a string of up to 56 characters if the storage medium is flash memory. The file path is a string of up to 57 characters if the storage medium is a USB drive.

ipe-filename: Specifies an .ipe image file. The file path uses the storage-medium:/filename.ipe format. The file path is a string of up to 56 characters if the storage medium is flash memory. The file path is a string of up to 57 characters if the storage medium is a USB drive.

all: Specifies startup images for all cards. If you specify this keyword, the system copies the card-specific images automatically to the root directory of the storage medium on each card. For a successful upgrade, make sure the specified files include the upgrade images for all cards.

slot slot-number: Specifies the slot number of the MPU for which the startup images are specified. (In standalone mode.)

chassis chassis-number slot slot-number: Specifies the MPU for which the startup images are specified in the IRF fabric. The chassis-number argument represents the IRF member ID of the device that holds the card, and the slot-number argument represents the slot number of the card. (In IRF mode.)

backup: Specifies the files as backup startup files. Backup startup images are used only when main images are not available.

main: Specifies the files as main startup files. The device always first attempts to start up with main startup files.

Usage guidelines

Before specifying startup software images, you must save the upgrade file to the device.

In standalone mode, save the file to the root directory of a storage medium on the active MPU.
In IRF mode, save the file to the root directory of a storage medium on the global active MPU.

If the storage medium is partitioned, save the files to the root directory of the first partition.

If you specify a standby MPU, the system automatically copies the upgrade file to the flash memory on the specified MPU, and sets images in the file as startup images. If a file with the same name as the upgrade file already exists, you must choose whether to overwrite the existing file.

The boot-loader file command overwrites the entire startup software image list. To add new startup feature images, specify all feature image files, including feature image files in the old startup software image list. The new startup software image list will contain only the feature image files that are specified in the command.

Examples

# On an HPE 7910 or HPE 7910 TAA switch in standalone mode, specify flash:/all.ipe as the backup startup image file for the MPU in slot 10.

<Sysname> boot-loader file flash:/all.ipe slot 10 backup
Verifying image file......Done.
Images in IPE:
  boot.bin
  system.bin
ssh.bin
This command will set the backup startup software images. Continue? [Y/N]:Y
Add images to target slot.
  flash:/boot.bin already exists on slot 10.
  flash:/system.bin already exists on slot 10.
  flash:/ssh.bin already exists on slot 10.
Overwrite it? [Y/N]:y
Decompressing file boot.bin to flash:/boot.bin....................................Done.
Decompressing file system.bin to flash:/system.bin................................Done.
The images that have passed all examinations will be used as the backup startup software images at the next reboot on slot 10.

# On an HPE 7910 IRF fabric, specify flash:/all.ipe as the backup startup image file for the MPU in slot 10 of member device 1.

<Sysname> boot-loader file flash:/all.ipe chassis 1 slot 10 backup
Verifying image file......Done.
Images in IPE:
  boot.bin
  system.bin
  ssh.bin
This command will set the backup startup software images. Continue? [Y/N]:Y
Add images to target slot.
  flash:/boot.bin already exists on chassis 1 slot 10.
  flash:/system.bin already exists on chassis 1 slot 10.
  flash:/ssh.bin already exists on chassis 1 slot 10.
Overwrite it? [Y/N]:y
Decompressing file boot.bin to flash:/boot.bin....................................Done.
Decompressing file system.bin to flash:/system.bin................................Done.
The images that have passed all examinations will be used as the backup startup software images at the next reboot on chassis 1 slot 10.

Related commands

display boot-loader

prev	up	next
Software upgrade commands	home	boot-loader update