C H A P T E R  2

Software Update Procedures

This chapter describes how to update your firmware. See the following sections:



caution icon Caution - Be sure that you apply only M2 updates to your M2 server. If your server is not an M2 server, be sure to get the correct downloads and documentation. For details on how to tell whether you have an M2 server or an earlier Sun Fire X4100/X4200 family server, refer to Methods to Differentiate Sun Fire X4100 and X4200 from Sun Fire X4100 M2 and X4200 M2 Servers, 820-0373.



Updating Your Server Firmware

The Integrated Lights Out Manager (ILOM) firmware and BIOS are tightly coupled and are always updated together. The LSI firmware is usually updated at the same time as the BIOS and ILOM; LSI firmware can be updated before or after the BIOS and ILOM firmware.

There are two major steps to updating your server firmware:



Note - The LSI firmware version and the BIOS version must be from the same software release.


Updating the BIOS and ILOM Firmware



caution icon Caution - To ensure a successful update, do notattempt to modify the ILOM configuration, or use other ILOM GUI, CLI, SNMP, or IPMI interfaces, during the flash update process. Wait until after the update succeeds before making further ILOM configuration changes. The update requires a system server, and takes about 20 minutes.


1. Determine the current version of the ILOM firmware. See Verifying the Firmware Version.

2. Review the section Software Release Special Considerations for known issues and considerations regarding the flash update.

3. Download the latest flash image from one of the following locations:

http://www.sun.com/servers/entry/x4100/downloads.jsp
http://www.sun.com/servers/entry/x4200/downloads.jsp

4. Use the ILOM GUI, the ILOM CLI load command, or N1 System Manager to perform the firmware update.



Note - Due to the increased memory use during web-based GUI operations, you might need to use N1 System Manager or the ILOM CLI load command to update the ILOM firmware. For details, refer to the N1 System Manager documentation or the Integrated Lights-Out Manager Administration Guide. Online documentation for Sun N1 System Manager can be found at: http://docs.sun.com/coll/1283.2


From the ILOM CLI, use the following command:

load -source tftp://tftpserver/ilom.firmware.ima

where tftpserver is the server that contains the update and ilom.firmware.ima is the image file.

For example:

ilom.x4100.2.0.2.5-r30859.ima
ilom.x4200.2.0.2.5-r30859.ima

For more details on performing the update, see Updating the LSI Firmware.



Note - On systems runing the Solaris OS, you will need to perform this step twice. For more information, see ILOM Upgrade Must Be Done Twice (6700194)




Note - If you have any problems with the flash update, refer to the sectionRecovering From a Failed Flash Update.


Updating the LSI Firmware



caution icon Caution - During an update, never power off the system.


Remote Method

1. Connect to the ILOM and open the ILOM GUI.

https://sp_ip_address

where sp_ip_address is the IP address of the service processor.

2. Select Remote Control -> Redirection.

3. Select 8-bit or 16-bit color.

4. Select Launch Redirection.

5. Respond to all prompts.

6. At the login prompt for the JavaRconsole window, type root, and then type the root password.

7. In the JavaRconsole window, select Devices.

8. Attach to the LSI firmware update image .iso file. At the pop-up screen, select the CD-ROM image.

A check mark is displayed on the drop-down menu selection.

9. Select Remote Control -> Remote Power Control in the ILOM GUI.

10. Select Power -> Action -> Reset.

11. When the system reboots, select “1” (Perform the Update) from the JavaRconsole window.

The update proceeds. When complete, the console responds with a new prompt.

12. In the JavaRConsole window select Devices -> CDROM Image to detach the LSI firmware update .iso file.

13. Select JavaRConsole Keyboard -> Control Alt Delete.

14. On system boot up, you will notice the new LSI firmware version.

Local Method

1. Download the LSI firmware .iso file from the Sun Fire X64 servers website and burn it to a bootable CD.



Note - The bootable CD appears blank when viewed using the operating system, but that is expected behavior (CR6554839).


2. Insert the bootable CD and reboot the server.

The firmware is upgraded.

3. Reboot the system.

More on Updating the LSI Firmware

For information about the LSI firmware and BIOS, see the documentation files that accompany the LSI download. For LSI firmware versions included in this release, see Component Versions By Release.


Verifying the Firmware Version

There are three alternate procedures in this section that you can use:

Verifying the Firmware Version Using the CLI Through the Management Ethernet Port

1. Connect an RJ-45 Ethernet cable to the NET MGT Ethernet port on the back panel.

2. Establish an SSH connection using the following command, then enter the default password (changeme) when you are prompted:

# ssh -l root sp_ip_address

changeme

After you have successfully logged in, the SP displays its default command prompt:

->

3. Type the version command, which returns output similar to the following:

-> version
SP firmware version: 1.0
SP firmware build number: 10644
SP firmware date: Tue Sep 13 12:50:37 PDT 2006
SP filesystem version: 0.1.13

The ILOM firmware build is listed above.

Verifying the Firmware Version Using the CLI Through the Serial Port

1. Configure your terminal device or the terminal emulation software running on a laptop or PC to the following settings:

2. Connect a serial cable from the RJ-45 SER MGT port on your server’s back panel to your terminal device or PC.

3. Press Enter on the terminal device to establish a connection between that terminal device and the server’s SP.

The SP displays a login prompt.

SUNSP0003BA84D777 login:

In this example login prompt, 0003BA84D777 is the Ethernet MAC address of the SP. This will be different for each server.

4. Log in to the ILOM SP and type the default user name (root) with the default password (changeme).

After you have successfully logged in, the SP displays its default command prompt:

->

5. Type the version command, which returns output similar to the following:

-> version
SP firmware version: 1.0
SP firmware build number: 10644
SP firmware date: Tue Sep 13 12:50:37 PDT 2006
SP filesystem version: 0.1.13

The ILOM firmware build version is the build number listed above.

Verifying the Firmware Version Using the ILOM Web Interface

1. Connect to the ILOM web interface by typing the IP address of the server’s SP into your browser’s address field. For example:

https://129.146.53.150

2. Log in to the ILOM SP and type the default user name (root) with the default password (changeme).

The first web page presented is the System Information -> Versions page, which includes the Build Number.


Locating ILOM SP IP Addresses

There are several methods you can use to locate ILOM SPs and their IP addresses.

For example, the following command can be used to create a list of Sun Fire X4100/X4200 servers’ ILOM SP IP addresses:

n1sh show server | grep 'X4[12]00'
nmap -p 623 10.6.154.1/24


How to Reset the SP

To reset the ILOM SP:

reset /SP
ipmitool -U root -P password -H sp_ip_address bmc reset cold

For more on this topic, refer to the the ILOM User’s Guide for your ILOM version.


Recovering From a Failed Flash Update

Several issues have been identified with the firmware update, which could result in a failed or incomplete firmware update. This section describes how to recover from a failed ILOM firmware update.

Use the following procedure to recover from a failed firmware update. Note that in a small percentage of cases (such as when no output is displayed on the SP serial port), the Graphics Redirect and Service Processor (GRASP) board must be replaced.

Prerequisites



Note - Numbers printed are in hexadecimal unless otherwise noted.



procedure icon  To Recover From a Failed Flash Update

1. Determine whether the ILOM SP first-level booter (referred to in this procedure as U-Boot) is intact.

Refer to the Sun Fire X4100/X4100 M2 and X4200/X4200 M2 Servers Installation Guide, 819-1155, for details to do the following:

a. Connect to the SP serial port.

b. Apply power to the system.

c. Observe the initial ILOM boot messages.

If no screen output is displayed, stop here. The GRASP board must be replaced. Refer to the Sun Fire X4100/X4100 M2 and X4200/X4200 M2 Servers Service Manual, 819-1157, for instructions.

If screen output is displayed, continue to the next step.

2. Enter the ILOM SP U-Boot command interpreter with xyzzy.

When the message, Booting linux in 2 seconds... is displayed, during ILOM initial boot, type xyzzy to enter the U-Boot command interpreter.



Note - The characters typed will not echo. Cutting and pasting the characters improves the chance of success. You might need to try the process of applying power to the system and entering xyzzy several times.


3. Disable automatic reboot.

Set the U-Boot environment variable, bootretry, to -1 to temporarily disable automatic reboot:

set bootretry -1

4. Configure the network for TFTP access.

a. Copy the ILOM SP firmware image to a TFTP server that is accessible on the same IP subnet as the ILOM SP network port.

b. Set the IP address for the ILOM SP and the TFTP server IP address by setting the ethaddr and serverip U-Boot variables.

set ipaddr n.n.n.n
set serverip n.n.n.n

where n.n.n.n is the static address.

5. Use the U-Boot tftp command to download the ILOM firmware image.

tftp 100000 ilom.firmware.ima

where ilom.firmware.ima is the image file, for example, ilom.x4100.1.1.1-r15632.ima.



Note - If the TFTP server or filename is incorrect, you might need to enter ^C to halt the tftp command, then repeat this recovery procedure.


Be sure that the complete flash image is downloaded successfully before proceeding. You should see a message similar to:

=> tftp 100000 r10644.rom.ima
Using FCC1 ETHERNET device
TFTP from server 10.6.154.8; our IP address is 10.6.154.99
Filename ’r10644.rom.ima’.
Load address: 0x100000
Loading:
###########################################################
###########################################################
###########################################################
###########################################################
##########################
done
Bytes transferred = 13107200 (c80000 hex)

6. Confirm that the download succeeded:

a. Confirm that the tftp command output ends with

Bytes transferred = ByteCount 

b. Use the md command and confirm that its output displays strings from the beginning of the firmware image file. For example:

=> md 100000
00100000: 244d4f44 554c4524 01004000 00000200    $MODULE$..@.....
00100010: 00000000 000000f2 67726173 70000000    ........grasp...
00100020: 01000200 40000000 61000000 0000ffff    ....@...a.......
00100030: ffff0000 00000100 00000000 0000aa55    ...............U
00100040: 46575f56 45525349 4f4e3d31 2e302e31 FW_VERSION=1.0.1
00100050: 0a46575f 44415445 3d4d6172 20203320 .FW_DATE=Mar  3
00100060: 32303036 0a46575f 4255494c 4454494d    2006.FW_BUILDTIM
00100070: 453d3130 3a35363a 30370a46 575f4445    E=10:56:07.FW_DE
00100080: 53433d57 41524e49 4e47203a 20554e4f    SC=WARNING : UNO
00100090: 46464943 49414c20 4255494c 44212120    FFICIAL BUILD!!
001000a0: 0affffff ffffffff ffffffff ffffffff    ................

7. Erase the existing ILOM flash image:



caution icon Caution - Interrupting the flash recovery process from this point onwards, or entering an incorrect U-Boot command, might result in a disabled service processor, which will require replacement. DO NOT stop or remove power from the system from this point onward.


a. Erase the exiting flash image using the following commands:

erase ff380000 ffffffff
erase 0xfe200000 0xff37ffff
 

You will a series of dots showing progress, followed by a confirmation:

.................................................................................Erased 200/200 sectors

b. If a failure occurs, retry the erase command repeatedly until it succeeds.



Note - If a persistent failure occurs, the service processor is not flash-updatable, and must be replaced. Refer to the Sun Fire X4100/X4100 M2 and X4200/X4200 M2 Servers Service Manual, 819-1157, for details on replacing the GRASP board.


8. Program the new ILOM firmware image:

a. Use the U-Boot cp.b command to copy the new ILOM firmware image from the download location at 100000 to ff380000, until end address ffffffff.

For example:

=> cp.b 100000 ff380000 ffffffff
Copy to Flash .............................................................................................................................................done

b. Use the fmh command to verify the new ILOM firmware image.

Before resetting, make sure the copy succeeded, using the fmh command, which should display firmware sections. For example:

=> fmh
Listing FMH Modules
Flash Size : 32768 KB
Erase Size : 64 KB
Sector Count : 512
  
FMH Located at 0xff380000 of Size 0x00020000
Name    : grasp
Ver     : 1.0
Type    : 0x0002
Flags   : 0x0000
Size    : 0x00000061
Location: 0xff380040
LoadAddr: 0xffffffff
CheckSum: Not Computed
--------------------------------------------------
  
FMH Located at 0xff3a0000 of Size 0x00120000
Name    : sysbios
Ver     : 1.31
Type    : 0x0000
Flags   : 0x0100
Size    : 0x00100000
Location: 0xff3c0000
LoadAddr: 0xffffffff
CheckSum: Valid
--------------------------------------------------
  
FMH Located at 0xff4c0000 of Size 0x000c0000
Name    : osimage
Ver     : 1.0
Type    : 0x0006
Flags   : 0x0119
Size    : 0x000ac9c8
Location: 0xff4c0040
LoadAddr: 0x00c00000
CheckSum: Valid
...


Note - If the command output does not show anything, you may have entered an incorrect memory address. Repeat the tftp, erase and cp.b commands until the image is properly copied. Note that you must erase the existing firmware image before attempting to copy a new image.


9. Reset the ILOM service processor.

Once you are certain that the service processor firmware image has been recovered, you can restart the service processor with the reset command.

=> reset

10. Recover the system BIOS.



Note - This manual ILOM SP recovery process does not reflash the system BIOS. Repeat the firmware update process, using the ILOM GUI or CLI procedures as described in Updating Your Server Firmware and the refer to the Integrated Lights Out Manager (ILOM) Administration Guide for ILOM.


Be sure to reset your service processor and BIOS configuration settings as needed, because they might be lost during this recovery.