update (update firmware) command

This command updates firmware using the uniform resource locator (URL) of a TFTP, FTP, HTTP, or HTTPS server and displays information about firmware installed in BladeCenter components.

Important:
  • Some cluster solutions require specific code levels or coordinated code updates. If the device is part of a cluster solution, verify that the latest level of code is supported for the cluster solution before you update the code.
  • Scalable complexes in a BladeCenter unit require a consistent firmware level on all blade servers in a complex. When scripting firmware updates for blade servers in a scalable complex, make sure that the update commands are included for each node in the complex.
Table 1. update (update firmware) command
Function What it does Command Valid targets
Display firmware attributes Displays attributes of the firmware installed in the command target. Return values are:
  • Firmware type
  • Build ID
  • Filename
  • Release date
  • Revision level
Notes:
  • When the command target is the primary management module, this command will return the values for the currently active firmware and for the pending firmware, that will become active after the next management module reboot.
  • For standby advanced management modules, the returned value will also indicate if a firmware update is in progress and the percentage that is complete.
  • For I/O modules that support it, this command will also display firmware image information.
update -a 
                           -T system:mm[x]
                        
                           -T system:blade[x]:sp
                        
                           -T system:switch[x]

where x is the primary management-module number, standby management-module number, blade server bay number, or I/O module bay number.
Update firmware using URL Update firmware for the command target using a uniform resource locator (URL).
Important: Command authority definitions might change between firmware versions. Make sure that the command authority level set for each user is correct after updating management-module firmware (see Commands and user authority).
Notes:
  • Updating to older firmware levels may cause loss of certain functionality
  • The JS22 or JS12 blade server firmware is too large to be updated using this command. See the User's Guide for your JS22 or JS12 blade server for information about updating firmware.
 update -u U_R_L

where U_R_L is fully qualified uniform resource locator of a tftp, ftp, http, or https server where the firmware update image is located.

This command can only be run by users who have one or more of the following command authorities:
  • Supervisor
  • Chassis administration (for management module)
  • Blade administration (for blade server)
  • I/O module administration (for I/O module)
See Commands and user authority for additional information.
 
                           -T system:mm[x]
                        
                           -T system:blade[x]:sp
                        
                           -T system:switch[x]

where x is the primary management-module, blade server bay number, or I/O-module bay number.
Update firmware and reboot Update firmware and reboot the advanced management module to use new firmware if the update succeeds.
Important: Command authority definitions might change between firmware versions. Make sure that the command authority level set for each user is correct after updating management-module firmware.
 update -u U_R_L -r

where U_R_L is fully qualified uniform resource locator of a tftp, ftp, http, or https server where the firmware update image is located.

This command can only be run by users who have one or more of the following command authorities:
  • Supervisor
  • Chassis administration
See Commands and user authority for additional information.
 
                           -T system:mm[x]

where x is the primary management-module.
Update firmware (verbose) Update firmware for the command target, showing details of the firmware download and flash operations. The detailed information is not shown until the update is complete, which might take several minutes.
Important: Command authority definitions might change between firmware versions. Make sure that the command authority level set for each user is correct after updating management-module firmware.
Notes:
  • Updating to older firmware levels may cause loss of certain functionality
  • The JS22 or JS12 blade server firmware is too large to be updated using this command. See the User's Guide for your JS22 or JS12 blade server for information about updating firmware.
 update -u U_R_L -v

where U_R_L is fully qualified uniform resource locator of a tftp, ftp, http, or https server where the firmware update image is located.

This command can only be run by users who have one or more of the following command authorities:
  • Supervisor
  • Chassis administration (for management module)
  • Blade administration (for blade server)
  • I/O module administration (for I/O module)
See Commands and user authority for additional information.
 
                           -T system:mm[x]
                        
                           -T system:blade[x]:sp
                        
                           -T system:switch[x]

where x is the primary management-module, blade server bay number, or I/O-module bay number.
Update I/O module firmware Directly update I/O module firmware image.
Note: Only some I/O modules have this capability.
 update -u U_R_L -img img_index

where:

  • U_R_L is fully qualified uniform resource locator of a tftp, ftp, http, or https server where the firmware update image is located.
  • img_index is the image index you are updating. Use the update -a command to list available images and their index numbers.
This command can only be run by users who have one or more of the following command authorities:
  • Supervisor
  • I/O module administration
See Commands and user authority for additional information.
 
                           -T system:switch[x]

where x is the I/O-module bay number.
Update I/O module firmware (verbose) Directly update I/O module firmware image, showing details of the firmware download and flash operations. The detailed information is not shown until the update is complete, which might take several minutes. update -u U_R_L -img img_index -v

where:

  • U_R_L is fully qualified uniform resource locator of a tftp, ftp, http, or https server where the firmware update image is located.
  • img_index is the image index to the I/O module firmware you are updating. Use the update -a command to list available images and their index numbers.
This command can only be run by users who have one or more of the following command authorities:
  • Supervisor
  • I/O module administration
See Commands and user authority for additional information.
 
                           -T system:switch[x]

where x is the I/O-module bay number.
Activate I/O module firmware Directly activate I/O module firmware image.
Note: Only some I/O modules have this capability.
 update -activate img_index

where img_index is the image index you are activating. Use the update -a command to list available images and their index numbers.

This command can only be run by users who have one or more of the following command authorities:
  • Supervisor
  • I/O module administration
See Commands and user authority for additional information.
 
                           -T system:switch[x]

where x is the I/O-module bay number.
Update and activate I/O module firmware Directly update I/O module and activate the firmware image.
Notes:
  • Only some I/O modules have this capability.
  • The activate option can be used with the other options. You can flash first, then activate the specified index.
  • The image index you activate can be different from the one you update.
 update -u U_R_L -img img_index -activate img_index

where:

  • U_R_L is fully qualified uniform resource locator of a tftp, ftp, http, or https server where the firmware update image is located.
  • img_index is the image index you are activating. Use the update -a command to list available images and their index numbers.
This command can only be run by users who have one or more of the following command authorities:
  • Supervisor
  • I/O module administration
See Commands and user authority for additional information.
 
                           -T system:switch[x]

where x is the I/O-module bay number.
Update firmware

(Obsolete command. See Note following table.)

Update firmware for the command target.
Important: Command authority definitions might change between firmware versions. Make sure that the command authority level set for each user is correct after updating management-module firmware.
Note: The P6 blade server firmware is too large to be updated using this command. See the User's Guide for your P6 blade server for information about updating firmware.
 update -i ip_address -l filelocation

where:

  • ip_address is the IPv4 or IPv6 IP address of the TFTP server.
  • filelocation is the location of the firmware update file.
This command can only be run by users who have one or more of the following command authorities:
  • Supervisor
  • Chassis administration (for management module)
  • Blade administration (for blade server)
  • I/O module administration (for I/O module)
See Commands and user authority for additional information.
 
                           -T system:mm[x]
                        
                           -T system:blade[x]:sp
                        
                           -T system:switch[x]

where x is the primary management-module, blade server bay number, or I/O (switch) module bay number.
Update firmware (verbose)

(Obsolete command. See Note following table.)

Update firmware for the command target, showing details of the firmware download and flash operations. The detailed information is not shown until the update is complete, which might take several minutes.
Important: Command authority definitions might change between firmware versions. Make sure that the command authority level set for each user is correct after updating management-module firmware.
Note: The P6 blade server firmware is too large to be updated using this command. See the User's Guide for your P6 blade server for information about updating firmware.
 update -i ip_address -l filelocation -v

where:

  • ip_address is the IPv4 or IPv6 IP address of the TFTP server.
  • filelocation is the location of the firmware update file.
This command can only be run by users who have one or more of the following command authorities:
  • Supervisor
  • Chassis administration (for management module)
  • Blade administration (for blade server)
  • I/O module administration (for I/O module)
See Commands and user authority for additional information.
 
                           -T system:mm[x]
                        
                           -T system:blade[x]:sp
                        
                           -T system:switch[x]

where x is the primary management-module, blade server bay number, or I/O (switch) module bay number.
Update I/O module firmware

(Obsolete command. See Note following table.)

Directly update I/O module firmware image.
Note: Only some I/O modules have this capability.
 update -i ip_address -l filelocation -img img_index

where:

  • ip_address is the IPv4 or IPv6 IP address of the TFTP server.
  • filelocation is the location of the firmware update file.
  • img_index is the image index you are updating. Use the update -a command to list available images and their index numbers.
This command can only be run by users who have one or more of the following command authorities:
  • Supervisor
  • I/O module administration
See Commands and user authority for additional information.
 
                           -T system:switch[x]

where x is the I/O (switch) module bay number.
Update I/O module firmware (verbose)

(Obsolete command. See Note following table.)

Directly update I/O module firmware image, showing details of the firmware download and flash operations. The detailed information is not shown until the update is complete, which might take several minutes.
Note: Only some I/O modules have this capability.
 update -i ip_address -l filelocation -img img_index -v

where:

  • ip_address is the IPv4 or IPv6 IP address of the TFTP server.
  • filelocation is the location of the firmware update file.
  • img_index is the image index to the I/O module firmware you are updating. Use the update -a command to list available images and their index numbers.
This command can only be run by users who have one or more of the following command authorities:
  • Supervisor
  • I/O module administration
See Commands and user authority for additional information.
 
                           -T system:switch[x]

where x is the I/O (switch) module bay number.
Activate I/O module firmware

(Obsolete command. See Note following table.)

Directly activate I/O module firmware image.
Note: Only some I/O modules have this capability.
 update -activate img_index

where img_index is the image index you are activating. Use the update -a command to list available images and their index numbers.

This command can only be run by users who have one or more of the following command authorities:
  • Supervisor
  • I/O module administration
See Commands and user authority for additional information.
 
                           -T system:switch[x]

where x is the I/O (switch) module bay number.
Update and activate I/O module firmware

(Obsolete command. See Note following table.)

Directly update I/O module and activate the firmware image.
Notes:
  • Only some I/O modules have this capability.
  • The activate option can be used with the other options. You can flash first, then activate the specified index.
  • The image index you activate can be different from the one you update.
 update -i ip_address -l filelocation -img img_index -activate img_index

where:

  • ip_address is the IPv4 or IPv6 IP address of the TFTP server.
  • filelocation is the location of the firmware update file.
  • img_index is the image index you are activating. Use the update -a command to list available images and their index numbers.
This command can only be run by users who have one or more of the following command authorities:
  • Supervisor
  • I/O module administration
See Commands and user authority for additional information.
 
                           -T system:switch[x]

where x is the I/O (switch) module bay number.
Note: The -i and -l options for the update command have been replaced by the -u command option. While the -i and -l options will remain active for a few releases before being removed, users are encouraged to transition to the -u option as soon as possible.

To accomplish this transition, the IP address and file location of the firmware update file or image, specified by the arguments to the -i and -l options, must be replaced by the -u option followed by an argument that specifies the fully qualified uniform resource locator (URL) of a tftp, ftp, http, or https server where the firmware update file or image is located.

Example: To update the advanced management module firmware from a TFTP server and reboot the advanced management module in management-module bay 1 after a successful update, type the following command at the system:> prompt. For this example, the IP address of the TFTP server is 9.37.177.215 and the firmware file containing the update is named CNETMNUS.pkt. The verbose mode and reboot flag are also specified.
                  update -u tftp://9.37.177.215/temp/CNETMNUS.pkt -T mm[1] -v -r

The following example shows the information that is returned from the update command:

               system> update -u tftp://9.37.177.215/temp/CNETMNUS.pkt -T mm[1] -v -r
100% transferred (100/100)
transfer completed successfully
flashing firmware to target device
Starting flash packet preparation.
Flash preparation - packet percent complete 4.
Flash preparation - packet percent complete 8.
Flash preparation - packet percent complete 12.
Flash preparation - packet percent complete 16.
Flash preparation - packet percent complete 20.
Flash preparation - packet percent complete 24.
Flash preparation - packet percent complete 28.
Flash preparation - packet percent complete 32.
Flash preparation - packet percent complete 36.
Flash preparation - packet percent complete 40.
Flash preparation - packet percent complete 44.
Flash preparation - packet percent complete 50.
Flash preparation - packet percent complete 54.
Flash preparation - packet percent complete 58.
Flash preparation - packet percent complete 62.
Flash preparation - packet percent complete 66.
Flash preparation - packet percent complete 70.
Flash preparation - packet percent complete 74.
Flash preparation - packet percent complete 78.
Flash preparation - packet percent complete 82.
Flash preparation - packet percent complete 86.
Flash preparation - packet percent complete 90.
Flash preparation - packet percent complete 94.
Flash preparation - packet percent complete 98.
Flash operation phase starting.
Flashing - packet percent complete 34.
Flashing - packet percent complete 50.
Flashing - packet percent complete 50.
Flashing - packet percent complete 50.
Flashing - packet percent complete 50.
Flashing - packet percent complete 50.
Flashing - packet percent complete 50.
Flashing - packet percent complete 50.
Flashing - packet percent complete 82.
Update of AMM Main Application firmware was successful.

The new firmware will become active after the next reset of the MM.

Rebooting AMM...
Parent topic: Command syntax