ex3500

Enables EX3500 switch firmware management. Use this command to perform the following operations: boot, copy, delete, and IP-related configurations.

The copy keyword provides multiple copy options. It allows you to upload or download code images or configuration files between the switch‘s flash memory and an FTP/TFTP server. When you save the system code or configuration settings to a file on an FTP/TFTP server, that file can later be downloaded to the switch to restore system operation. The success of the file transfer depends on the accessibility of the FTP/TFTP server and the quality of the network connection.

Supported in the following platforms:

  • Service Platforms — NX9500, NX9600, VX9000

Syntax

ex3500 [adoptd|boot|copy|delete|ip]
ex3500 adoptd upgrade <URL> on <EX3500-DEVICE-NAME>
ex3500 boot system <1-1> (config|opcode) <FILE-NAME> on <EX3500-DEVICE-NAME>
ex3500 copy [file|ftp|running-config|startup-config|tftp|unit]
ex3500 copy [file file <SOURCE-FILE-NAME> <DEST-FILE-NAME> on <EX3500-DEVICE-NAME>]
ex3500 copy [ftp|tftp] [add-to-running-config|file|https-certificate|public-key|running-config|startup-config]
ex3500 copy [ftp|tftp] add-to-running-config <FTP/TFTP-SERVER-IP> <USER-NAME> <PASSWORD> <SOURCE-FILE-NAME> on <EX3500-DEVICE-NAME>
ex3500 copy [ftp|tftp] file <FTP/TFTP-SERVER-IP> <USER-NAME> <PASSWORD> [1|2] <SOURCE-FILE-NAME> <DEST-FILE-NAME> on <EX3500-DEVICE-NAME>
ex3500 copy [ftp|tftp] https-certificate <FTP/TFTP-SERVER-IP> <USER-NAME> <PASSWORD> <SOURCE-CERT-FILE-NAME> <SOURCE-PVT-KEY-FILE-NAME> <PVT-PASS-WORD> on <EX3500-DEVICE-NAME>
ex3500 copy [ftp|tftp] public-key <FTP/TFTP-SERVER-IP> <USER-NAME> <PASSWORD> [1|2] <SOURCE-PUB-KEY-FILE-NAME> <USER-NAME> on <EX3500-DEVICE-NAME>
ex3500 copy [ftp|tftp] [running-config|startup-config] <FTP/TFTP-SERVER-IP> <USER-NAME> <PASSWORD> <SOURCE-CONFIG-FILE-NAME> on <EX3500-DEVICE-NAME>
ex3500 copy running-config [file <DEST-FILE-NAME>|ftp <FTP-SERVER-IP> <USER-NAME> <PASSWORD> <DEST-FILE-NAME>|startup-config|tftp <TFTP-SERVER-IP> <DEST-FILE-NAME>] on <EX3500-DEVICE-NAME>
ex3500 copy startup-config [file <DEST-FILE-NAME>|ftp <FTP-SERVER-IP> <USER-NAME> <PASSWORD> <DEST-FILE-NAME>|running-config|tftp <TFTP-SERVER-IP> <DEST-FILE-NAME>] on <EX3500-DEVICE-NAME>
ex3500 copy unit file <1-1> [1|2] <SOURCE-FILE-NAME> <DEST-FILE-NAME> on <EX3500-DEVICE-NAME>
ex3500 delete [file|public-key]
ex3500 delete file [name <FILE-NAME>|unit <1-1> name <FILE-NAME>] on <EX3500-DEVICE-NAME>
ex3500 delete public-key <USER-NAME> [dsa|rsa] on <EX3500-DEVICE-NAME>
ex3500 ip ssh [crypto|save]
ex3500 ip ssh crypto host-key generates [dsa|rsa] on <EX3500-DEVICE-NAME>
ex3500 ip ssh crypto zeroize [dsa|rsa] on <EX3500-DEVICE-NAME>
ex3500 ip ssh save host-key on <EX3500-DEVICE-NAME>

Parameters

ex3500 adoptd upgrade <URL> on <EX3500-DEVICE-NAME>
ex3500 adoptd upgrade Upgrades an adopted EX3500 switch After an upgrade, reboot the EX3500 switch to initiate the new image.
Note: To view an EX3500‘s current image version, use the show > version > on <EX3500-DEVICE-NAME> command.
<URL> Specifies the location and image file name in the following format: tftp://<IP>[/path]/file
on <EX3500-DEVICE-NAME> Executes the command on a specified EX3500 switch
  • <EX3500-DEVICE-NAME> – Specify the EX3500 switch‘s hostname.
ex3500 boot system <1-1> (config|opcode) <FILE-NAME> on <EX3500-DEVICE-NAME>
ex3500 boot system Boots a EX3500 switch using a specified configuration file
<1-1> Identifies the EX3500 unit by its ID number. Specify the EX3500 ID from 1 - 1.
Note: As of now only one (1) EX3500 unit can be managed through a NOC controller.
(config|opcode) <FILE-NAME> The following keywords are recursive: Specifies the image file to use for booting. The options are:
  • config – Uses the configuration file to boot the switch
  • opcode – Uses the opcode (Operation Code), which is the runtime code, to boot the switch. The opcode is like an operating system that enables the WiNG software to communicate with the EX3500 device.

    The following parameter is common to the ‘config‘ and opcode‘ keywords:

    • <FILE-NAME> – Specify the configuration/runtime-code file name.
on <EX3500-DEVICE-NAME> Reloads a specified EX3500 switch
  • <EX3500-DEVICE-NAME> – Specify the EX3500 switch‘s hostname. You can also specify its MAC address.
ex3500 copy file file <SOURCE-FILE-NAME> <DEST-FILE-NAME> on <EX3500-DEVICE-NAME>
ex3500 copy Copies a configuration file to another file
file file <SOURCE-FILE-NAME> <DEST-FILE-NAME> Copies a specified file (this is the source configuration file)
  • file – Copies the specified source file to a specified file (this is the destination configuration file)
    • <SOURCE-FILE-NAME> – Specify the source configuration file‘s name
      • <DEST-FILE-NAME> – Specify the destination configuration file‘s name.

        When specifying the destination file name, keep in mind the following points:

        - It should not contain slashes (\ or /),

        - It should not exceed 32 characters for files on the switch, or 127 characters for files on the server.

on <EX3500-DEVICE-NAME> Copies the file to a specified EX3500 switch
  • <EX3500-DEVICE-NAME> – Specify the EX3500 switch‘s hostname. The specified source file is copied to specified destination file on the EX3500 identified here.
ex3500 copy [ftp|tftp] add-to-running-config <FTP/TFTP-SERVER-IP> <USER-NAME> <PASSWORD> <SOURCE-FILE-NAME> on <EX3500-DEVICE-NAME>
ex3500 copy [ftp|tftp] Copies files from a FTP or TFTP server. This command allows you to copy the following types of files: HTTPS certificate, running configuration, startup configuration, public key, etc.

This command also allows you to add a remote system‘s running configuration to the current system configuration.

add-to-running-config Adds a remote system‘s running configuration to the current system
<FTP/TFTP-SERVER-IP> <USER-NAME> <PASSWORD> Configures the FTP or TFTP server details (depending on the option selected in the previous step), such as IP address and user credentials. This is the device running the FTP/TFTP server.
  • <FTP/TFTP-SERVER-IP> – Specify the FTP or TFTP server‘s IP address in the A.B.C.D format.
    • <USER-NAME> – If using a FTP server, specify the FTP server‘s user name (should be an authorized user)
      • <PASSWORD> – Specify the password applicable for the above specified FTP server user name.
<SOURCE-FILE-NAME> After specifying the server details, specify the name of the running configuration file.
  • <SOURCE-FILE-NAME> – Specify the source file‘s name.
on <EX3500-DEVICE-NAME> Copies the file to a specified EX3500 switch
  • <EX3500-DEVICE-NAME> – Specify the EX3500 switch‘s hostname. The specified source file is copied to specified destination file on the EX3500 identified here.
ex3500 copy [ftp|tftp] file <FTP/TFTP-SERVER-IP> <USER-NAME> <PASSWORD> [1|2] <SOURCE-FILE-NAME> <DEST-FILE-NAME> on <EX3500-DEVICE-NAME>
ex3500 copy [ftp|tftp] Copies files from a FTP or TFTP server. This command allows you to copy the following types of files: HTTPS certificate, running configuration, startup configuration, public key, etc.
file Copies to a specified file system
<FTP/TFTP-SERVER-IP> <USER-NAME> <PASS-WORD> Configures the FTP or TFTP server details (depending on the option selected in the previous step), such as IP address and user credentials. This is the device running the FTP/TFTP server.
  • <FTP/TFTP-SERVER-IP> – Specify the FTP or TFTP server‘s IP address in the A.B.C.D format.
    • <USER-NAME> – If using a FTP server, specify the FTP server‘s user name (should be an authorized user)
      • <PASSWORD> – Specify the password applicable for the above specified FTP server user name.
[1|2] <SOURCE-FILE-NAME> <DEST-FILE-NAME> After specifying the server details, select the file type and specify the name of the source and destination file names.
  • [1|2] – Select the file type from 1 - 2.
    • 1 – Copies the EX3500 configuration file.
    • 2 – Copies the opcode, which is the runtime code. The opcode is like an operating system that enables the EX3500 software to communicate with the EX3500 device.
      • <SOURCE-FILE-NAME> – Specify the source file‘s name.
        • <DEST-FILE-NAME> – Specify the destination file‘s name.
on <EX3500-DEVICE-NAME> Copies the file to a specified EX3500 device
  • <EX3500-DEVICE-NAME> – Specify the EX3500 device‘s hostname. The specified source file is copied to specified destination file on the EX3500 identified here.
ex3500 copy [ftp|tftp] https-certificate <FTP/TFTP-SERVER-IP> <USER-NAME> <PASSWORD> <SOURCE-CERT-FILE-NAME> <SOURCE-PVT-KEY-FILE-NAME> <PVT-PASS-WORD> on <EX3500-DEVICE-NAME>
ex3500 copy [ftp|tftp] Copies files from a FTP or TFTP server. This command allows you to copy the following types of files: HTTPS certificate, running configuration, startup configuration, public key, etc.
https-certificate Copies HTTPS secure site certificate from the FTP or TFTP server to the switch
<FTP/TFTP-SERVER-IP> <USER-NAME> <PASSWORD> Configures the FTP or TFTP server details (depending on the option selected in the previous step), such as IP address and user credentials. This is the device running the FTP/TFTP server.
  • <FTP/TFTP-SERVER-IP> – Specify the FTP or TFTP server‘s IP address in the A.B.C.D format.
    • <USER-NAME> – If using a FTP server, specify the FTP server‘s user name (should be an authorized user)
      • <PASSWORD> – Specify the password applicable for the above specified FTP server user name.
<SOURCE-CERT-FILE-NAME> <SOURCE-PVT-KEY-FILE-NAME> <PVT-PASS-WORD> After identifying the FTP or TFTP server, specify the following:
  • <SOURCE-CERT-FILE-NAME> – Specify the source HTTPS secure site certificate file name.
    • <SOURCE-PVT-KEY-FILE-NAME> – Specify the source private-key file name.
      • <PVT-PASS-WORD> – Specify the private password.
on <EX3500-DEVICE-NAME> Copies the file to a specified EX3500 device
  • <EX3500-DEVICE-NAME> – Specify the EX3500 device‘s hostname.
ex3500 copy [ftp|tftp] public-key <FTP/TFTP-SERVER-IP> <USER-NAME> <PASSWORD> [1|2] 
<SOURCE-PUB-KEY-FILE-NAME> <USER-NAME> on <EX3500-DEVICE-NAME>
ex3500 copy [ftp|tftp] Copies files from a FTP or TFTP server. This command allows you to copy the following types of files: HTTPS certificate, running configuration, startup configuration, public key, etc.
public-key Copies the SSH public key from the FTP or TFTP server to the switch
<FTP/TFTP-SERVER-IP> <USER-NAME> <PASSWORD> Configures the FTP or TFTP server details (depending on the option selected in the previous step), such as IP address and user credentials. This is the device running the FTP/TFTP server.
  • <FTP/TFTP-SERVER-IP> – Specify the FTP or TFTP server‘s IP address in the A.B.C.D format.
    • <USER-NAME> – If using a FTP server, specify the FTP server‘s user name (should be an authorized user)
      • <PASSWORD> – Specify the password applicable for the above specified FTP server user name.
[1|2] <SOURCE-PUB-KEY-FILE-NAME> <USER-NAME> After identifying the FTP or TFTP server, specify the following:
  • [1|2] – Configures the SSH public key type as RS or DSA
    • 1 – Configures the public key type as RSA
    • 2 – Configures the public key type as DSA
      • <SOURCE-PUB-KEY-FILE-NAME> – Specifies the source public key file name
        • <USER-NAME> – Specifies the public key‘s user name
on <EX3500-DEVICE-NAME> Copies the public key to a specified EX3500 device
  • <EX3500-DEVICE-NAME> – Specify the EX3500 device‘s hostname.
ex3500 copy [ftp|tftp] [running-config|startup-config] <FTP/TFTP-SERVER-IP> <USER-NAME> <PASSWORD> <DEST-FILE-NAME> on <EX3500-DEVICE-NAME>
ex3500 copy [ftp|tftp] Copies files from a FTP or TFTP server. This command allows you to copy the following types of files: HTTPS certificate, running configuration, startup configuration, public key, etc.
[running-config| startup-config] Copies the running or startup configuration file to one of the following destinations: file system, FTP server, or TFTP server

The running configuration file can be copied to the startup configuration file and vice versa.

<FTP/TFTP-SERVER-IP> <USER-NAME> <PASSWORD> If copying to a FTP/TFTP server, configure the following parameters:
  • <FTP/TFTP-SERVER-IP> – Specify the FTP or TFTP server‘s IP address in the A.B.C.D format.
    • <USER-NAME> – If using a FTP server, specify the FTP server‘s user name (should be an authorized user)
      • <PASSWORD> – Specify the password applicable for the above specified FTP server user name.
<DEST-FILE-NAME> Configures the destination file name. The running or startup configuration file is copied to the specified destination file.
  • <DEST-FILE-NAME> – Specify the destination file name. You can also copy the running configuration file to the startup configuration file and vice versa.
on <EX3500-DEVICE-NAME> Copies the running or startup configuration file on to a specified EX3500 device
  • <EX3500-DEVICE-NAME> – Specify the EX3500 device‘s hostname.
ex3500 copy unit file <1-1> [1|2] <SOURCE-FILE-NAME> <DEST-FILE-NAME> on <EX3500-DEVICE-NAME>
ex3500 copy unit Copies from a EX3500 switch
file <1-1> [1|2] Copies the file system from the EX3500 switch identified by the unit number
  • <1-1> – Specify the unit number from 1 - 1.
    • [1|2] – Select the file type from 1 - 2. 1 – Copies the selected unit‘s configuration file.
    • 2 – Copies the selected unit‘s opcode, which is the runtime code. The opcode is like an operating system that enables the WiNG software to communicate with the EX3500 device.
<SOURCE-FILE-NAME> Configures the source file name
  • <SOURCE-FILE-NAME> – Specify the source file name. You can copy the running configuration file to the startup configuration file and vice versa.
<DEST-FILE-NAME> Configures the destination file name. The running or startup configuration file is copied to the specified file.
  • <DEST-FILE-NAME> – Specify the destination file name. You can copy the running configuration file to the startup configuration file and vice versa.
on <EX3500-DEVICE-NAME> Copies the running or startup configuration file on to a specified EX3500 device
  • <EX3500-DEVICE-NAME> – Specify the EX3500 device‘s hostname.
ex3500 delete file [name <FILE-NAME>|unit <1-1> name <FILE-NAME>] on <EX3500-DEVICE-NAME>
ex3500 delete file Deletes a file or image on a specified EX3500 device
name <FILE-NAME> Specifies the file to delete. The specified file is deleted.
  • <FILE-NAME> – Specify the file name.
unit <1-1> name <FILE-NAME> Identifies the unit in the stackable system on which the file is located
  • <1-1> – Select the unit from 1 - 1.
    • name – After identifying the unit, specify the file to delete. The specified file is deleted.
      • <FILE-NAME> – Specify the file name.
on <EX3500-DEVICE-NAME> Executes the command on a specified EX3500 device
  • <EX3500-DEVICE-NAME> – Specify the EX3500 device‘s hostname.
ex3500 delete public-key <USER-NAME> [dsa|rsa] on <EX3500-DEVICE-NAME>
ex3500 delete public-key <USER-NAME> [dsa|rsa] Deletes a specified user‘s public key
  • <USER-NAME> – Specify the SSH user‘s name.
    • dsa – Deletes the specified user‘s DSA (version 2) key
    • rsa – Deletes the specified user‘s RSA (version 1) key
on <EX3500-DEVICE-NAME> Executes the command on a specified EX3500 device
  • <EX3500-DEVICE-NAME> – Specify the EX3500 device‘s hostname.
ex3500 ip ssh crypto host-key generates [dsa|rsa] on <EX3500-DEVICE-NAME>
ex3500 ip ssh crypto host-key generates [dsa|rsa] Generates the host-key pair (public and private). This host key is used by the SSH server to negotiate a session key and encryption method with the client trying to connect to it.
  • dsa – Generates DSA (version 2) key type
  • rsa – Generates RSA (version 1) key type
Note: The RSA Version 1 is used only for SSHv1.5 clients, whereas DSA Version 2 is used only for SSHv2 clients.
Note: This generated host-key pair is stored in the volatile memory (i.e RAM). To save the host-key pair in the flash memory, use the ex3500 > ip > ssh > save > host-key command.
on <EX3500-DEVICE-NAME> Executes the command on a specified EX3500 device
  • <EX3500-DEVICE-NAME> – Specify the EX3500 device‘s hostname.
ex3500 ip ssh zeroize [dsa|rsa] <EX3500-DEVICE-NAME>
ex3500 ip ssh zeroize [dsa|rsa] Removes the host-key (DSA and RSA) from the volatile memory (i.e. RAM)
on <EX3500-DEVICE-NAME> Executes the command on a specified EX3500 device
  • <EX3500-DEVICE-NAME> – Specify the EX3500 device‘s hostname.
ex3500 ip ssh save host-key on <EX3500-DEVICE-NAME>
ex3500 ip ssh save host-key Saves the host-key (DSA and RSA) to the flash memory
on <EX3500-DEVICE-NAME> Executes the command on a specified EX3500 device
  • <EX3500-DEVICE-NAME> – Specify the EX3500 device‘s hostname.

Usage Guidelines

When using the ex3500 command and its parameters, keep in mind the following:

  • Destination file names should not:
    • Contain slashes (\ or /),
    • Exceed 32 characters for files on the switch, or 127 characters for files on the server.
  • The FTP server‘s default user name is set as “anonymous”.
  • The Boot ROM and Loader cannot be uploaded or downloaded from the FTP/TFTP server. Follow instructions provided in the release notes for new firmware, or contact your distributor for help.
  • The “Factory_Default_Configure” can be used as the source to copy from, but cannot be used as the destination.
  • Although the switch supports only two operation code files, the maximum number of user-defined configuration files supported is 16.

Example

nx9500-6C8809#ex3500 adopted upgrade tftp://192.168.0.99/ex3500-adopted-5.8.5.0.img on 
ex3524-ED5EAC
Flash programming started
Flash programming completed
Successful
nx9500-6C8809#
nx9500-6C8809#ex3500 copy tftp file 10.2.0.100 1 m360.bix m360.bix on ex3524-ED5EAC
\Write to FLASH Programming.
-Write to FLASH finish.
Success.
nx9500-6C8809#
nx9500-6C8809#ex3500 copy tftp startup-config 10.2.0.99 startup.01 startup on ex3524-ED5EAC
TFTP server ip address: 10.1.0.99
Flash programming started.
Flash programming completed.
Success.
nx9500-6C8809#