firmware download scp

Specifies Secure Copy ( SCP) as the protocol used to perform a firmware download.

Syntax

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

Command Default

A filename is optional. If no filename is specified, release.plist, is used.

Parameters

coldboot

Downloads the firmware to the system and reboots the device.

manual

Currently, this keyword has no effect.

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 device manually. If auto-commit mode was disabled, you must perform a manual firmware commit operation after the device comes back up.

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.

user username

Specifies the user login name for the host.

password password

Specifies the account password.

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.

noactivate

Performs a firmware download without activation on the local device.

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.

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 SCP 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 scp directory /buildsjc/sre/SQA/nos/slx17r.1.00/slx17r.1.00 host 10.31.2.27 user releaseuser password releaseuser