Commands For Upgrading The Access Control Switch

1.5 Commands for Switch Upgrade

1.5.1 copy?FTP?

Command: copy <source-url> <destination-url> [ascii | binary] Function: Download files to the FTP client.
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?

Command: copy <source-url> <destination-url> [ascii | binary] Function: Download files to the TFTP client.
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

Command: ftp-dir <ftp-server-url>
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

Command: 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

Command: ftp-server timeout <seconds>
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

Command: ip ftp username <username> password [0 | 7] <password>
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

Command: 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

Command: 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

Command: 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

Command: tftp-server retransmission-number <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

Command: tftp-server transmission-timeout <seconds>
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