Go to main content
Sun Network QDR InfiniBand Gateway Switch Product Notes for Firmware Version 2.1

Exit Print View

Updated: March 2017
 
 

Upgrade the Gateway Firmware (CLI)


Note -  Before upgrading or downgrading the gateway firmware, see Firmware Update Guidelines.

Note -  If you are going to downgrade the firmware to a version earlier than 2.1, you must disable secret M_Keys. Refer to the Sun Network QDR InfiniBand Gateway Switch Administration Guide for Firmware Version 2.1 for instructions on disabling secret M_Key functionality.

Note -  If you are going to downgrade the firmware to a version earlier than 2.0, you must remove user partitions and depopulate the Subnet Manager nodes list. Refer to the Sun Network QDR InfiniBand Gateway Switch Administration Guide for Firmware Version 2.1 for instructions on removing partitions for firmware downgrade.
  1. Consider your first step:
    • If you are upgrading or downgrading from firmware version 2.0 or newer, go to Step 2.

    • If you are upgrading or downgrading from a firmware version earlier than 2.0, go to Step 5.

  2. Open an SSH session as user ilom-admin and connect to the management controller by specifying the controller's host name.

    For example:

    % ssh -l ilom-admin gateway_name
    ilom-admin@gateway_name's password: password
    ->

    where gateway_name is the host name of the management controller. Initially, the password is ilom-admin.

  3. If the Subnet Manager is running on the management controller, disable the Subnet Manager.
    -> show /SYS/Fabric_Mgmt
    NOTE: show on Fabric_Mgmt will launch a restricted Linux shell.
       User can execute switch diagnosis, SM Configuration and IB
       monitoring commands in the shell. To view the list of commands,
       use "help" at rsh prompt.
    
       Use exit command at rsh prompt to revert back to
       ILOM shell.
    
    FabMan@gateway_name->disablesm
    Stopping partitiond-daemon.                                [  OK  ]
    Stopping IB Subnet Manager..                               [  OK  ]
    FabMan@gateway_name->exit
    exit
    ->
  4. Go to Step 12.
  5. Open an SSH session as user root and connect to the management controller by specifying the controller's host name.
    % ssh -l root gateway_name
    root@gateway_name's password: password
    #

    where gateway_name is the host name of the management controller. Initially, the password is changeme.

  6. If the Subnet Manager is running on the management controller, disable the Subnet Manager.
    # disablesm
    Stopping partitiond-exitdaemon.             [  OK  ]
    Stopping IB Subnet Manager..                [  OK  ]
    #
  7. Verify that there is at least 150 MB available in the /tmp directory.
    # df -h /tmp
    Filesystem            Size    Used   Avail  Use%  Mounted on
    tmpfs                 250M    240K   249M   1%    /tmp
    #

    In this example, there are 249 MB available. If not enough space is available, you must delete files from the /tmp directory.

  8. Verify that there is at least 1 MB available in the /config directory.
    # df -h /config
    Filesystem            Size   Used   Avail  Use%  Mounted on
    /dev/hda2              16M   3.6M   11M    25%   /config
    #

    In this example, there are 11 MB available. If not enough space is available, you must delete files from the /config directory.

  9. Verify that there is at least 1 MB available in the /var/log directory.
    # df -h /var/log
    Filesystem            Size   Used   Avail  Use%  Mounted on
    /dev/hda3              16M   3.6M   11M    25%   /var/log
    #

    In this example, there are 11 MB available. If not enough space is available, delete files from the /var/log directory.

  10. Verify that there is at least 150 MB free memory available.
    # free -m
                        total      used      free     shared    buffers    cached
    Mem:                498        104       393      0         12         47
    -/+ buffers/cache:   45        453
    Swap:                 0          0         0
    #

    In the -/+ buffers/cache: row of the free column, there should be at least 150 MB free memory. In this example, there are 453 MB available. If not enough memory is available, you must exit nonessential applications that are running.

  11. Start the Oracle ILOM shell.
    # spsh
    Oracle(R) Integrated Lights Out Manager
    Version ILOM 3.0 r47111
    Copyright (c) 2010, Oracle and/or its affiliates. All rights reserved.
    ->

    You are now in the Oracle ILOM shell.

    You can use the exit command to return to the Linux shell.

  12. Begin the upgrade process.
    -> load -source URI/pkgname

    where:

    • URI is the uniform resource indicator for the host where the gateway firmware package is located. The FTP and HTTP protocols are supported. If you are upgrading from firmware 2.1.2-2 or newer, the TFTP protocol is also supported.

    • pkgname is the name of the firmware package in the transfer directory.

    For example, using the HTTP protocol:

    -> load -source http://123.45.67.89/tmp/sundcs_gw_repository_2.1.9_1.pkg 
    Downloading firmware image. This will take a few minutes.

    Note -  If you are experiencing version number contention, you can use the –force option to disable version number checking, and force the upgrade.

    An error is displayed and the firmware upgrade process exits.

    Error: Exiting Firmware update. Please see file /tmp/fw_upgrade_pre_check.err for details.
    
    Firmware image update failed. 
    load: Command Failed 
    ->

    This is normal. An installer within the firmware package set prerequisite values.


    Note -  Do not restart or reboot the management controller or the gateway. Proceed to Step 13.
  13. Reload the firmware.

    Retype the command as you did in Step 12.

    The firmware is downloaded. The upgrade begins. A caution is displayed and you are asked to commit to the upgrade.

    NOTE: Firmware upgrade will upgrade firmware on SUN DCS gw Kontron module,
         I4 and BridgeX. Upgrade takes few minutes to complete.
    
         ILOM will enter a special mode to load new firmware. No other tasks
         should be performed in ILOM until the firmware upgrade is complete.
    
    Please make sure to upgrade in the order specified in the user documentation.
    Are you sure you want to load the specified file (y/n)?
  14. Answer y to the prompt to begin the upgrade.
    Setting up environment for firmware upgrade. This will take few minutes. 
    Starting SUN DCS gw FW update 
    
    ========================== 
    Performing operation: I4 A 
    ========================== 
    I4 A: I4 is already at the given version. 
    
    ========================== 
    Performing operation: BX A 
    ========================== 
    BX A: BX is already at the given version. 
    
    ========================== 
    Performing operation: BX B 
    ========================== 
    BX B: BX is already at the given version. 
    
    =========================== 
    Summary of Firmware update 
    =========================== 
    I4 status                :  FW UPDATE - SUCCESS 
    I4 update succeeded on   :  none 
    I4 already up-to-date on :  A 
    I4 update failed on      :  none 
    BX status                :  FW UPDATE - SUCCESS 
    BX update succeeded on   :  none 
    BX already up-to-date on :  A, B 
    BX update failed on      :  none 
    
    ========================================= 
    Performing operation: SUN DCS gw firmware update 
    ========================================= 
    SUN DCS gw Kontron module fw upgrade from 2.1.6-2 to 2.1.9-1: 
    Please reboot the system to enable firmware update of Kontron module. The download of the Kontron
    firmware image happens during reboot.
    
    After system reboot, Kontron FW update progress can be monitored in browser using URL
    [http://GWsystem] OR at OS command line prompt by using command [telnet GWsystem 1234] where
    GWsystem is the hostname or IP address of SUN DCS GW.
    
    Firmware update is complete.
    ->
  15. Restart the gateway to enable the new firmware.
    -> reset /SP
    Are you sure you want to reset /SP (y/n)? y
    Performing reset on /SP
    Broadcast message from root (Thu Mar 16 20:10:49 2017):
    The system is going down for reboot NOW!
    -> Connection to gateway_name closed by remote host.
    Connection to gateway_name closed.

    Note -  The restart process takes between 4 to 5 minutes to complete.

    You can monitor the update progress through:

    • Web browser – http://gateway_name

    • CLI – telnet gateway_name 1234

    where gateway_name is the host name or IP address of the management controller.


    Note -  The Oracle ILOM stack requires at least 2 minutes to become operational after a reboot.

    The next time you log in to the gateway, this message is displayed:

    Please run the "fwverify" CLI command to verify the new image.
    This message will be cleared on next reboot.
  16. Access the restricted Linux shell, and verify the firmware version.
    % ssh -l ilom-admin gateway_name
    ilom-admin@gateway_name's password: password
    -> show /SYS/Fabric_Mgmt
    NOTE: show on Fabric_Mgmt will launch a restricted Linux shell.
       User can execute switch diagnosis, SM Configuration and IB
       monitoring commands in the shell. To view the list of commands,
       use "help" at rsh prompt.
    
       Use exit command at rsh prompt to revert back to
       ILOM shell.
    FabMan@gateway_name->version
    SUN DCS gw version: 2.1.9-1
    Build time: Jan 12 2017 09:30:46
    FPGA version: 0x34
    SP board info:
    Manufacturing Date: 2012.01.10
    Serial Number: "NCD8F0072"
    Hardware Revision: 0x0007
    Firmware Revision: 0x0102
    BIOS version: SUN0R100
    BIOS date: 06/22/2010
    FabMan@gateway_name->

    In the first line of the output for the version command is SUN DCS gw version x.y.z-w, where x.y.z-w is the version of the firmware upgraded (or downgraded). For example, 2.1.9-1.

  17. Verify the firmware integrity.
    FabMan@gateway_name->fwverify
    Checking all present packages:
    ........................................................................... OK
    Checking if any packages are missing:
    ........................................................................... OK
    Verifying installed files:
    ........................................................................... OK
    Checking FW Coreswitch: 
      FW Version: 7.4.3002 OK 
      PSID: SUNX2826_I40_002 OK 
      Verifying image integrity OK 
    
    Checking FW Bridge-0: 
      FW Version: 8.6.2010 OK 
      PSID: SUNX2826_BX0_006 OK 
      Verifying image integrity OK 
    
    Checking FW Bridge-1: 
      FW Version: 8.6.2010 OK 
      PSID: SUNX2826_BX1_006 OK 
      Verifying image integrity OK 
    FabMan@gateway_name->