image image image image image

On This Page

To upgrade MLNX-GW, perform the following steps.

  1. Enter Config mode.

    gateway > enable
    gateway # configure terminal
    gateway (config) #

  2. Display the currently available image (.img file).

    gateway (config) # show images
    Installed images:
    
      Partition 1:
      <old_image>
    
      Partition 2:
      <old_image>
    
    Last boot partition: 1
    Next boot partition: 1
    
    Images available to be installed:
     webimage.tbz
      <old_image>
    
    Serve image files via HTTP/HTTPS: no
    
    No image install currently in progress.
    
    Boot manager password is set.
    
    Image signing: trusted signature always required
    Admin require signed images: yes
    
    Settings for next boot only:
       Fallback reboot on configuration failure: yes (default)

  3. Delete the image listed under “Images available to be installed” prior to fetching the new image. Use the command “image delete” for this purpose. 

    gateway (config) # image delete <old_image>

    When deleting an image, it is recommended to delete the file, but not the partition, so as to not overload system resources.

  4. Fetch the new software image.

    gateway (config) # image fetch scp://<username>:<password>@<ip-address>/var/www/html/<new_image>
    Password (if required): ****** 100.0%[##################################################################]


  5. Display the available images again and verify that the new image now appears under “Images available to be installed”.

    To recover from image corruption (e.g., due to power interruption), there are two installed images on the system. See the commands “image boot next” and “image boot location” for more information.

    gateway (config) # show images
    Installed images:
    
      Partition 1:
      <old_image>
    
      Partition 2:
      <old_image>
    
    Last boot partition: 1
    Next boot partition: 1
    
    Images available to be installed:
     webimage.tbz
      <new_image>
    
    Serve image files via HTTP/HTTPS: no
    
    No image install currently in progress.
    
    Boot manager password is set.
    
    Image signing: trusted signature always required
    Admin require signed images: yes
    
    Settings for next boot only:
       Fallback reboot on configuration failure: yes (default)

  6. Install the new image.

    gateway (config) # image install <new_image>
    Step 1 of 4: Verify Image
     100.0%  [#############################################################]
    Step 2 of 4: Uncompress Image
     100.0%  [#############################################################]
    Step 3 of 4: Create Filesystems
     100.0%  [#############################################################]
    Step 4 of 4: Extract Image
     100.0%  [#############################################################]

    CPU utilization may go up to 100% during image upgrade.

  7. Have the new image activate during the next boot.

    gateway (config) # image boot next

  8. Run “show images” to review your images.

    gateway (config) # show images
    Installed images:
    
      Partition 1:
      <new_image>
    
      Partition 2:
      <old_image>
    
    Last boot partition: 1
    Next boot partition: 1
    
    Images available to be installed:
     webimage.tbz
      <new_image>
    
    Serve image files via HTTP/HTTPS: no
    
    No image install currently in progress.
    
    Boot manager password is set.
    
    Image signing: trusted signature always required
    Admin require signed images: yes
    
    Settings for next boot only:
       Fallback reboot on configuration failure: yes (default)

  9. Save current configuration. 

    gateway (config) # configuration write

  10. Reboot to run the new image.

    gateway (config) # reload
    Configuration has been modified; save first? [yes] yes
    Configuration changes saved.
    Rebooting...
    gateway (config)#

    After software reboot, the software upgrade will also automatically upgrade the firmware version.