By default, downloads the firmware to the
system, reboots the system, and commits the firmware automatically. The user can
specify noactivatefirmware download
to download the firmware to the system without activating it (the node is not
rebooted). The user can run firmware activate later to activate the firmware.
Parameters
coldboot
Downloads the firmware to the system and
reboots the device.
directorydirectory
Specifies a fully qualified path to the directory where the firmware is located.
filefile_name
Specifies the firmware .plist file. This parameter is optional; if unspecified, the default file, release.plist, is used.
host
Specifies the host by DNS name or IP address.
hostname
Specifies an IPv4 DNS host name.
host_ip_address
Specifies the host IP address. IPv4 and IPv6 addresses are supported.
manual
Currently, this keyword has no effect.
noactivate
Performs a firmware download without activation on the local device.
nocommit
Disables auto-commit mode. When auto-commit mode is disabled, firmware is downloaded only to the primary partition. You must execute the firmware
commit command manually to propagate the new image to the secondary partition.
noreboot
Disables auto-reboot mode. When auto-reboot mode is disabled, you must reboot the device manually. If auto-commit mode was disabled, you must perform a manual firmware
commit operation after the device comes back up.
passwordpassword
Specifies the account password.
use-vrfvrf-name
Specifies a VRF.
userusername
Specifies the user login name for the host.
Modes
Privileged EXEC mode
Usage Guidelines
Use this command to download firmware from an external host.
Unless you specify
noactivate, the upgrade or downgrade involves system reboots
that disrupt traffic.
If the
firmware download command is interrupted because of an unexpected reboot, such as a result of a software error or power failure, the command automatically recovers the corrupted secondary partition. Wait for the recovery to complete before beginning another firmware download.
This command does not support pagination.
Examples
This example downloads firmware by means of FTP and specifies a path to the directory where the firmware is located. A user login name is specified for the host and an account password is specified.
