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