Upgrade/Downgrade Commands

install

The install command copies the specified EOS image onto the switch if the source is external, configures the boot-config file to point to the specified EOS image, copies the image to the standby supervisor on dual-supervisor switches, and optionally reloads the switch to run the new EOS.

Command Mode

Privileged EXEC

Command Syntax

install source source_path [destination destination_path][now][reload]

Parameters
  • source_path - Specify the file path and name of EOS image. If no file path specified, the switch looks for the image on the flash drive of the primary supervisor.
  • destination destination_path - Specify the destination file path and name of the EOS image. If no destination or name specified, the EOS image stores on the flash drive with its original file name.
  • now - Specify to execute the command immediately without further prompts.
  • reload - Reload the supervisorafter installing the image and updated boot-config file. On dual-supervisor switches, reloads both supervisors, after which control returns to the primary supervisor.

Example

This command updates the boot-config file to point to the EOS.swi file on the primary supervisors flash drive, copies the image and boot-config file to the secondary supervisor, and reboots both.
switch(config)# install source EOS.swi reload
Preparing new boot-config... done.
Copying new software image to standby supervisor... done.
Copying new boot-config to standby supervisor... done.
Committing changes on standby supervisor... done.
Reloading standby supervisor... done.
Committing changes on this supervisor... done.
Reloading this supervisor...

reload fast-boot

Smart System Upgrade (SSU) allows critical switches to be upgraded with minimal downtime and packet loss by optimizing the reload procedure and leveraging protocols capable of graceful restart. The reload fast-boot command starts the SSU process using the EOS image specified by the boot-config file configured by the boot system command.

When entering the reload fast-boot command, the switch sends a message prompting the user to save the configuration if it contains unsaved modifications, then asks the user to confirm the reload request.

Command Mode

Privileged EXEC

Command Syntax

reload fast-boot

Guidelines
  • SSUsupports upgrades and not downgrades.
  • EOS does not support SSU if the EOS upgrade requires an FPGA upgrade.
  • Enough free space must be available on the flash drive to store two copies of the target EOS image. Arista also recommends that an additional 240MB be available to store diagnostic information.

Examples
  • Use the following command to start the Smart Software Upgrade process.
    switch# reload fast-boot
Proceed with reload? [confirm]

  • If the current switch configuration has issues that prevent SSU from performing, the switch lists the changes that must be made before SSU can begin..
    switch# reload fast-boot
switch#'reload fast-boot' cannot proceed due to the following:
Spanning-tree portfast is not enabled for one or more ports
Spanning-tree BPDU guard is not enabled for one or more ports

  • After entering the reload fast-boot command, the switch sends a message prompting the user to save the configuration if it contains unsaved modifications, then asks the user to confirm the reload request.
    switch# reload fast-boot
System configuration has been modified. Save? [yes/no/cancel/diff]:y
Copy completed successfully.
Proceed with reload? [confirm]y

reload hitless

The reload hitless command is a legacy command now identical to the reload fast-boot command. It starts the Smart System Upgrade (SSU) process using the EOS image specified by the boot-config file configured by the using the boot system command.

Command Mode

Privileged EXEC

Command Syntax

reload hitless

Examples
  • This command starts the SSU process.
    switch# reload hitless
Proceed with reload? [confirm]

  • If the current switch configuration has issues that prevent SSU from performing, the switch lists the changes that must be made before SSU can begin.
    switch# reload hitless
switch#'reload hitless' cannot proceed due to the following:
Spanning-tree portfast is not enabled for one or more ports
Spanning-tree BPDU guard is not enabled for one or more ports

  • When you enter the reload hitless command, the switch returns a message prompting to save the configuration if it contains unsaved modifications, then asks you to confirm the reload request.
    switch# reload hitless
System configuration has been modified. Save? [yes/no/cancel/diff]:y
Copy completed successfully.
Proceed with reload? [confirm]y