firmware download sftp

Specifies Secure FTP (SFTP) as the protocol used to perform a firmware download.

Syntax

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

Parameters

coldboot

Downloads the firmware to the system and reboots both the device.

directory directory

Specifies a fully qualified path to the directory where the firmware is located.

file filename

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

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. (Skips auto-commit after firmware download.)

noreboot

Disables auto-reboot mode. When auto-reboot mode is disabled, you must reboot the switch manually. If auto-commit mode was disabled, you must perform a manual firmware commit operation after the switch comes back up.

password password

Specifies the account password.

user username

Specifies the user login name for the host.

use-vrf vrf-id

Use this option to specify the name of the VRF where the host is located. If this option is not set, mgmt-vrf is used by default.

Modes

Privileged EXEC mode

Usage Guidelines

Use this command to download firmware from an external host or from an attached USB device. You can run this command interactively or provide the parameters on the command line.

Unless you specify noactivate, the upgrade or downgrade involves system reboots that disrupt traffic.

In addition, default-config causes the loss of configuration because it resets the configuration back to the default settings during the firmware upgrade process.

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.

If the firmware download is interrupted because of an unexpected reboot 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 starting another firmware download.

Examples

This example downloads firmware by means of SFTP 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.

switch# firmware download sftp directory /buildsjc/sre/SQA/sxlos/slx17r.1.00/slx17r.1.00 host 10.31.2.27 user releaseuser password releaseuser