firmware download ftp

Specifies FTP as the protocol used to perform a firmware download.

Syntax

firmware download ftp [ coldboot ] [ manual ] [ noactivate ] [ nocommit ] [ noreboot ] host { hostname | host_ip_address } use-vrf vrf-name user username password password directory directory [ file file_name ]

Command Default

By default, downloads the firmware to the system, reboots the system, and commits the firmware automatically. The user can specify noactivate firmware 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.
directory directory
Specifies a fully qualified path to the directory where the firmware is located.
file file_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.
password password
Specifies the account password.
use-vrf vrf-name

Specifies a VRF.

user username
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.

device# firmware download ftp directory /buildsjc/sre/SQA/slxos/17r.1.00/17r.1.00 host 10.31.2.27 user releaseuser password releaseuser