Table of Contents
1.5 Commands for Switch Upgrade
1.5.1 copy?FTP?
Parameters:
-
<source-url>: the location of the source files or directories to be copied. The form will vary depending on the location of the files or directories.
-
<destination-url>: destination address to which the files or directories are to be copied. The form will vary depending on the location of the files or directories.
-
ascii: indicates that ASCII will be used
-
binary: indicates that the binary system will be used for file transmission. This is also the default transmission method.
-
When the URL represents a FTP address, the form should be: ftp://<username>:<password>@{<ipaddress>|<ipv6address>|<hostname> }/<filename>
-
<username>: FTP user name.
-
<password>: FTP user password.
-
<ipaddress>|<ipv6address>: IPv4 or IPv6 address of the FTP server/client.
-
<hostname>: name of the host mapping to the IPv6 address. (Note: Host mapping to IPv4 addresses is not supported.)
-
<filename>: name of the FTP upload/download file.
-
-
Special keywords of the filename:
-
running-config: Running configuration files
-
startup-config: Reboot configuration files when using ?copy running-config startup-config? command
-
nos.img: System files
-
boot.rom: System startup files
-
stacking/nos.img: As a destination address, executes a system file upgrade for the Slave in stacking mode
-
stacking/nos.rom: As a destination address, executes a system startup file upgrade for the Slave in stacking mode
-
Command mode: Admin Mode.
Default: None.
Usage guide: This command supports command line hints. If the user enters commands in the following form: “copy <filename> ftp://” or “copy ftp:// <filename>” and presses Enter, the following hints will be provided by the system requesting FTP server address, user name, password and filename:
ftp server ip/ipv6 address [x.x.x.x]/[x:x::x:x] >
ftp username>
ftp password>
ftp filename>
Examples:
Save images in the FLASH to the FTP server of 10.1.1.1, FTP server username is Switch, password is superuser.
active500EM#copy nos.img ftp://Switch:superuser@10.1.1.1/nos.img
Obtain system file nos.img from the FTP server 10.1.1.1, the username is Switch, password is superuser.
active500EM#copy ftp://Switch:superuser@10.1.1.1/nos.img nos.img
Save images in the FLASH to the FTP server of 2004:1:2:3::6.
active500EM#copy nos.img ftp://username:password@2004:1:2:3::6/ nos.img
Obtain system file nos.img from the FTP server 2004:1:2:3::6.
active500EM#copy ftp://username:password@2004:1:2:3::6/nos.img nos.img
Save the running configuration files.
active500EM#copy running-config startup-config
Related Command: write
1.5.2 copy?TFTP?
Parameters:
-
<source-url>: location of the source files or directories to be copied. The form varies depending on the locations of the files or directories.
-
<destination-url>: destination address to which the files or directories are copied. The form varies depending on the locations of the files or directories.
-
ascii: indicates that ASCII standard will be used.
-
binary: indicates that the binary system will be used in the file transmission. This is the default transmission method.
-
When the URL represents a TFTP address, the form should be: tftp://<ipaddress>|<ipv6address>|<hostname>}/<filename>.
-
<ipaddress>| <ipv6address>: IPv4 or IPv6 address of the TFTP server/client.
-
<hostname>: name of the host mapping with the IPv6 address. (Note: Host mapping to IPv4 addresses is not supported.)
-
<filename>: name of the TFTP upload/download file.
-
-
Special keywords of the filename
-
running-config: Running configuration files
-
startup-config: Reboot configuration files when using ?copy running-config startup-config? command
-
nos.img: System files
-
boot.rom: System startup files
-
Command mode: Admin Mode.
Default: None.
Usage guide: This command supports command line hints. If the user enters commands in the following forms: copy <filename> tftp:// or copy tftp:// <filename> and presses Enter, the following hints will be provided by the system requesting the TFTP server address and file name.:
tftp server ip/ipv6 address[x.x.x.x]/[x:x::x:x]>
tftp filename>
Examples:
Save images in the FLASH to the TFTP server of 10.1.1.1.
active500EM#copy nos.img tftp://10.1.1.1/nos.img
Obtain system file nos.img from the TFTP server 10.1.1.1.
active500EM#copy tftp://10.1.1.1/nos.img nos.img
Save images in the FLASH to the TFTP server of 2004:1:2:3::6.
active500EM#copy nos.img tftp://2004:1:2:3::6/nos.img
Obtain system file nos.img from the TFTP server 2004:1:2:3::6.
active500EM#copy tftp://2004:1:2:3::6/nos.img nos.img
Save the running configuration files.
active500EM#copy running-config startup-config
Related Command: write
1.5.3 ftp-dir
Function: Browse the file list on the FTP server.
Parameters:
-
The form of <ftp-server-url> is?ftp://<username>:<password>@{ <ipv4address> | <ipv6address> }
-
<username>: FTP user name.
-
<password>: FTP user password.
-
{ <ipv4address> | <ipv6address> }: IPv4 or IPv6 address of the FTP server.
-
Command mode: Admin Mode
Default: None.
Usage guide: Browse the file list on the FTP server.
Example: Browse the list of the files on the server with the FTP client. The username is ?Switch?, the password is ?superuser?.
active500EM#ftp-dir ftp://Switch:superuser@10.1.1.1.
1.5.4 ftp-server enable
no ftp-server enable
Function: Start the FTP server. The no command shuts down the FTP server and prevents the FTP user from logging in.
Parameters: None.
Command mode: Global Mode
Default: FTP server is not started.
Usage guide: When the FTP server function is enabled, the switch can still perform FTP client functions.
Example: Enable FTP server service.
active500EM#config active500EM(config)#ftp-server enable
Related command: ip ftp
1.5.5 ftp-server timeout
Function: Set the data connection idle time.
Parameter:
-
<seconds>: idle time threshold (in seconds) for the FTP connection. The valid range is 5 to 3600.
Command mode: Global Mode
Default: 600 seconds.
Usage guide: When the FTP data connection idle time exceeds this limit, the FTP management connection will be disconnected.
Example: Modify the idle threshold to 100 seconds.
active500EM#config active500EM(config)#ftp-server timeout 100
1.5.6 ip ftp
no ip ftp username <username>
Function: Configure the username and password for logging in to the FTP site. The no command deletes the configured username and password.
Parameters:
-
<username>: username of the FTP link. The range should not exceed 32 characters.
-
<password>: password of the FTP link. If 0 is used, the password is not encrypted. If 7 is entered, the password is encrypted.
Command mode: Global Configuration Mode.
Default Settings: The system uses anonymous FTP links.
Usage guide: Configures the username and password for logging in to the FTP site.
Examples: Configure the username as ?Switch? and the password as ?superuser?.
active500EM#config active500EM(config)#ip ftp username Switch password 0 superuser
1.5.7 show ftp
Function: Display the parameter settings for the FTP server.
Parameters: None.
Command mode: Admin and Configuration Mode
Default: Do not display.
Usage guide: Displays the parameter settings for the FTP server.
Example: Display the parameter settings for the FTP server.
active500EM#show ftp Timeout : 600
Displayed Information | Explanation |
Timeout | Timeout time |
1.5.8 show tftp
Function: Display the parameter settings for the TFTP server.
Parameters: None.
Command mode: Admin and Configuration Mode.
Default: Do not display.
Usage guide: Displays the parameter settings for the TFTP server.
Example: Display the parameter settings for the TFTP server.
active500EM#show tftp timeout : 60 Retry Times : 10
Displayed Information | Explanation |
timeout | Timeout time |
Retry Times | Retransmission times |
1.5.9 tftp-server enable
no tftp-server enable
Function: Start the TFTP server. The no command shuts down the TFTP server and prevents the TFTP user from logging in.
Parameters: None.
Command mode: Global Mode
Default: Disable the TFTP Server.
Usage guide: When the TFTP server function is enabled, the switch can still perform TFTP client functions.
Example: Enable TFTP server service.
active500EM#config active500EM(config)#tftp-server enable
Related Command: tftp-server timeout
1.5.10 tftp-server retransmission-number
Function: Set the retransmission time for the TFTP server.
Parameter:
-
<number>: time to re-transfer. The valid range is 1 to 20.
Command mode: Global Mode
Default: Retransmit 5 times.
Usage guide: Set the retransmission time for the TFTP server.
Example: Modify the retransmission to 10 times.
active500EM#config active500EM(config)#tftp-server retransmission-number 10
1.5.11 tftp-server transmission-timeout
Function: Set the transmission timeout value for the TFTP server.
Parameter:
-
<seconds>: timeout value. The valid range is 5 to 3600s.
Command mode: Global Mode
Default: 600 seconds.
Usage guide: Sets the transmission timeout value for the TFTP server.
Example: Modify the timeout value to 60 seconds.
active500EM#config active500EM(config)#tftp-server transmission-timeout 60
Return to Controller Wired CLI Table of Contents