Upgrade the Gateway Firmware (CLI)

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. See Gateway Administration, removing partitions for firmware downgrade.

Open an SSH session as user root and connect to the management controller by specifying the controller’s host name.
For example:
```
% 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.

If the Subnet Manager is running on the management controller, disable it with the disablesm command.

# disablesm
Stopping partitiond daemon.                                [  OK  ]
Stopping IB Subnet Manager..                               [  OK  ]
#

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.
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.
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, you must delete files from the /var/log directory.
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 non-essential applications that are running.

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.

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.
pkgname is the name of the firmware package in the transfer directory.

For example, using the FTP protocol:

-> load -source ftp://root:changeme@123.45.67.99//tmp/sundcs_gw_repository_2.0.5_1.pkg
Downloading firmware image. This will take a few minutes.

Note - If you are upgrading from firmware version 2.0.X, you can use the -force option to disable version number checking, and force the upgrade.

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. 
 
Are you sure you want to load the specified file (y/n)?

Answer y to the prompt to commit to the upgrade.

The upgrade begins.

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 fw upgrade from 8.3.3166(INI:4) to 8.4.2740(INI:5):
Upgrade started...
Upgrade completed.
INFO: BX fw upgrade from 8.3.3166(INI:4) to 8.4.2740(INI:5) succeeded
 
==========================
Performing operation: BX B
==========================
BX fw upgrade from 8.3.3166(INI:4) to 8.4.2740(INI:5):
Upgrade started...
Upgrade completed.
INFO: BX fw upgrade from 8.3.3166(INI:4) to 8.4.2740(INI:5) succeeded
 
===========================
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 :  A, B
BX already up-to-date on :  none
BX update failed on :  none
 
=========================================
Performing operation: SUN DCS gw firmware update
=========================================
SUN DCS gw Kontron module fw upgrade from 1.3.2-1 to 2.0.5-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.
->

Exit the Oracle ILOM CLI shell.
```
-> exit
exit
#
```
Reboot the gateway to enable the new firmware.
See Gateway Administration, restarting the entire gateway.

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 login to the gateway, this message is displayed:
```
FW upgrade completed successfully on Mon Oct 17 18:36:14 IST 2011.
Please run the "fwverify" CLI command to verify the new image.
This message will be cleared on next reboot.
```

If the Subnet Manager was previously disabled, log in as the root user and enable the Subnet Manager.

% ssh -l root gateway_name
root@gateway_name’s password: password
# enablesm
Starting IB Subnet Manager.                                [  OK  ]
Starting partitiond daemon.                                [  OK  ]
#

Verify the firmware version.

# version
SUN DCS gw version: 2.0.5-1
Build time: Nov 25 2011 12:56:05
FPGA version: 0x33
SP board info:
Manufacturing Date: 2009.06.23
Serial Number: "NCD3R0527"
Hardware Revision: 0x0006
Firmware Revision: 0x0102
BIOS version: NOW1R112 
BIOS date: 04/24/2009
#

In the first line of the output 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.0.5-1.

Verify the firmware integrity.
See Verify Firmware Integrity (CLI).

Related Information

Upgrade the Gateway Firmware (Web)

Skip Navigation Links
Exit Print View
	Sun Network QDR InfiniBand Gateway Switch HTML Document Collection for Firmware Version 2.0