Applies to: Machine Type 5198

This document describes the installation of Licensed Machine Code, which is sometimes referred to generically as microcode or firmware.

Contents

1. If the wrong diskette is inserted at any time, or if the diskette is left in the drive after it has been read, B1FD 001F is displayed, indicating that the wrong diskette is in the drive.
2. If B1FD 001A is displayed at any time during the process, the service processor must be reset by activating the pinhole reset switch on the operator panel.

To verify that the update was successful, the firmware level can be checked as described in section 6.2.

Firmware Update Installation Is Not Concurrent

Installation of the firmware will cause an unconditional reboot of the system. Therefore, all user operations should be gracefully terminated before firmware updates are to be applied.

Never Power Off the System During the Firmware Update Process

The update will fail, and the process must be repeated.

Replacement Parts May Require Updating

When a CEC backplane is replaced, the firmware must be checked to ensure it is at the latest level. Table 3.1 lists the released levels.

AIX Instructions are CASE SENSITIVE

In the instructions that follow are specific AIX and DOS commands. AIX commands are CASE (lower and upper) SENSITIVE, and must be entered exactly as shown, including the filenames. DOS commands are not case sensitive, and may be entered without regard to the cases shown.

How to Determine the Firmware Release Date

Level identifiers for the firmware use the 8-digit Gregorian date code method in terms of year, month, and day (such as 20040602 for 3R040602 level).

4.0 Determining Currently Installed Firmware Level on the System

Note:

This information may be superseded by the information that is available on the Web site listed below. Always check the Web site for the latest images and instructions for checking the firmware level. The Web address is: http://www.ibm.com/servers/storage/support/download.html.

DO NOT rely on the part number or firmware level marking/label on an EPROM/FLASH module because the content of the module may have been updated to a different level. To be safe, always check the firmware level electronically.

The firmware level can be checked in CLI or in the Service Processor Main Menu.

The firmware level is denoted by XXYYMMDD, where XX = model designation, YY = year, MM = month, and DD = day of the release.

• If using CLI, continue to section 4.1.
• If using Service Processor Main Menu skip to section 4.2.

4.1 Using CLI to Read Currently Installed Firmware Levels

Use the following CLI command for checking the firmware level.

Enter:
lscfg -vp | grep -p Platform

This command will produce a system configuration report similar to the following.

Platform Firmware:

ROM Level.(alterable).......3R031021

Version.....................RS6K

System Info Specific.(YL)...U1.18-P1-H2/Y2

Physical Location: U1.18-P1-H2/Y2

The ROM Level line lists the level of the currently installed firmware. In the above example, the current firmware level is 3R031021.

If the right-most six characters (date) of the current firmware level are earlier than 040602, you should consider installing the update.

If you find the firmware must be updated and have NAS Gateway 500 software release version 1.1.1 installed, proceed to section 6.0. In this case, update is needed but no download of the firmware is required as the update file image is already in /tmp/fwbackup subdirectory. If the firmware level is correct and no update is needed, installation is complete.

If you find the firmware must be updated and have NAS Gateway 500 software release versions earlier than 1.1.1 installed, proceed to section 5.0. If the firmware level is correct and no update is needed, installation is complete.

4.2 Using the Service Processor Main Menu

The second line of the title, Version: 3R031021 shows the currently installed firmware level.

If the right-most six characters (date) of firmware level is earlier than 040602, you should consider installing the update.

If you find the firmware must be updated and have NAS Gateway 500 software release version 1.1.1 installed, proceed to section 6.0. In this case, update is needed but no download of the firmware is required as the update file image is already in /tmp/fwbackup subdirectory. If the firmware level is correct and no update is needed, installation is complete.

If you find the firmware must be updated and have NAS Gateway 500 software release versions earlier than 1.1.1 installed, proceed to section 5.0. If the firmware level is correct and no update is needed, installation is complete.

5.0 Downloading and Unpacking the Firmware Update Package

Instructions for downloading and unpacking the firmware update package follow for NAS Gateway 500 with software versions earlier than release 1.1.1. If you have NAS Gateway 500 software version release 1.1.1 installed, proceed to section 6.0 as no download of the firmware is required and the update file is already in /tmp/fwupdate subdirectory.

5.1 Internet Package

The firmware, in AIX and DOS formats, is located at the web site

http://www.ibm.com/servers/storage/support/download.html.

Search for "5198-001" under "Compose a search query (*required) .. Enter search terms" field.
Select "NAS Gateway 500 Firmware Update..." from the found items list.

You must read and agree to the license agreement to obtain the firmware packages.

The download choices at that entry are:

• Installation Instruction (this document)
• AIX Format (For downloading to an AIX system)
• DOS Format (For downloading to a Windows workstation)

You need one of the format choices. You may transfer files to the target server in one of several ways.

• By downloading files to an intermediate AIX system and then using either ftp or diskettes for transferring to the target server.
• By downloading files to a Windows workstation and then using either ftp or diskettes for transferring to the target server.

Detailed download/unpacking instructions follow for each of the downloading preferences.

• If using the AIX format file for downloading, continue to section 5.1.1.
• If using the DOS format file for downloading, skip to section 5.1.2.

5.1.1 Downloading the AIX Format File

Use this method to download to an AIX system.

Note: In the instructions that follow are specific AIX commands.
AIX commands are CASE (lower and upper) SENSITIVE, and must
be entered exactly as shown, including the filenames.

a) Provide a directory on an AIX system to receive the AIX format file.

Enter:
mkdir /tmp/fwupdate

Note: If the directory /tmp/fwupdate already exists,
make sure it is empty before proceeding.

b) Transfer the AIX format file to the /tmp/fwupdate directory (using "Save as ...").
You'll see that the filename is 70286C4F.BIN

c) Unpack the file by executing the instructions below.

Enter the commands:

cd /tmp/fwupdate
chmod +x 70286C4F.BIN
./70286C4F.BIN

[Don't overlook the periods (.) in the above command.]

These files will be added to /tmp/fwupdate:

3R040602.img
ReadMe.TXT - Please ignore this ReadMe file.

If you used the above procedure to transfer the AIX format file directly to the target server, proceed to section 6.0, Updating the Firmware.

Otherwise, from the intermediate AIX system, choose one of the following methods for transferring files to the target server.

• To transfer files to the target server via the ftp method, continue to section 5.1.1.1.
• To transfer files to the target server via the diskettes method, skip to section 5.1.1.2.

5.1.1.1 The FTP Transfer Method

This method presumes you have ftp access to the target server.

On the intermediate AIX system,

Enter the commands:

ftp {name of target server}
{Login with a valid userid and password}

bin
lcd /tmp/fwupdate
mkdir /tmp/fwupdate
cd /tmp/fwupdate
put 3R040602.img
quit

Proceed to section 6.0, Updating the Firmware.

5.1.1.2 The Diskette Transfer Method

This method presumes a diskette drive is installed on the target server.

Four 2MB (HD) new diskettes are required.

With a diskette loaded in the drive,

Enter the commands (this process will request additional diskettes as each is filled):

cd /tmp/fwupdate
ls *.img | backup -i -v -f/dev/rfd0

This will produce AIX backup diskettes. Label these diskettes, respectively,

"Volume 1: Firmware (3R040602) for NAS Gateway 500, 5198-001"

"Volume 2: Firmware (3R040602) for NAS Gateway 500, 5198-001"

"Volume 3: Firmware (3R040602) for NAS Gateway 500, 5198-001"

"Volume 4: Firmware (3R040602) for NAS Gateway 500, 5198-001"

Proceed to section 6.0, Updating the Firmware.

5.1.2 Downloading the DOS Format File

Use this file to download to a Windows workstation.

a) Prepare a directory for receiving the DOS format file.
This directory can be in any partition with 12MB available space.
Executing in such a partition, called [path] in these instructions
(ex. c:\download),

Enter:
md [path]\fwupdate

Note: If the directory [path]\fwupdate already exists,
make sure it is empty before proceeding.

b) Transfer the DOS format file to the [path]\fwupdate directory (using "Save as ...").
You'll see the filename is 70286C4F.EXE

c) Unpack the file by executing the instructions below.

Enter the commands:

cd [path]\fwupdate
70286C4F

These files will be added to the fwupdate subdirectory:

3R040602.img
286C4_B1.EXE
286C4_B2.EXE
286C4_B3.EXE
286C4_B4.EXE
readme.txt - Please ignore this readme file.

• To transfer files to the target server via the ftp method, continue to section 5.1.2.1.
• To transfer files to the target server via the diskette method, skip to section 5.1.2.2.

5.1.2.1 The FTP Transfer Method

This method presumes you have ftp access to the target server.

On the Windows workstation,

Enter the commands:

ftp {name of target server}
{Login with a valid userid and password}

bin
lcd [path]\fwupdate
mkdir /tmp/fwupdate
cd /tmp/fwupdate
put 3R040602.img
quit

Proceed to section 6.0, Updating the Firmware.

5.1.2.2 Diskettes for Firmware Updates

This method presumes a diskette drive is installed on the target server.

Four 2MB (HD) new DOS diskettes are required.

Note: The diskettes produced below will be in a format that can be used
directly with a computer running AIX as it's operating system. These
diskettes, once made on a PC platform, cannot be read using normal PC
platform tools or command line operations.

a) With a diskette loaded in the drive,

Enter the commands:

cd [path]\fwupdate
286C4_B1

Label this diskette,

"Volume 1: Firmware (3R040602) for NAS Gateway 500, 5198-001"

b) With a second diskette loaded in the drive,

Enter:
286C4_B2

Label this diskette,

"Volume 2: Firmware (3R040602) for NAS Gateway 500, 5198-001"

c) With a third diskette loaded in the drive,

Enter:
286C4_B3

Label this diskette,

"Volume 3: Firmware (3R040602) for NAS Gateway 500, 5198-001"

c) With a fourth diskette loaded in the drive,

Enter:
286C4_B4

Label this diskette,

"Volume 4: Firmware (3R040602) for NAS Gateway 500, 5198-001"

Proceed to section 6.0, Updating the Firmware.

5.2 Remote Installation of Firmware

To install firmware on a remote system, login to the remote system as root. Copy (in binary format) the file, 3R040602.img to the /tmp/fwupdate directory on the remote system. Proceed to section 6.0, Updating the Firmware.

6.0 Updating the Firmware

Updating the firmware requires login as "root".

Once the System and Service Processor firmware had been updated,the NAS Gateway 500 will reboot. The System Power Control Network (SPCN) update will continue to run in the background.

NOTE: Make sure the 'write protect' tab of the diskettes are not set to write protect (there is no failure message if the write protect is enabled, however no data is backed up).

***
WARNING:

Do not power off the system at any time before the update process completes. Be sure that the system is NOT running any user applications when you begin the update process.

***

NOTE: Checksums should be used to verify files have not been corrupted or altered during transmission.

At the AIX command line, enter:
sum 3R040602.img

The output will look like this -----> 39743 4946 3R040602.img
The checksum is -----> 39743

Updating firmware must be initiated directly from any of the following methods:

• AIX Diagnostic Service Aids, section 6.1.1 or
• AIX command line, section 6.1.2 or
• Service Processor Menus section 6.1.3.

6.1.1 Using the AIX Diagnostic Service Aids Method

Before installing this level of firmware, see section 3.0 Cautions and Important Notes

You must have root authority on the target server to update its firmware.

Note: In the instructions that follow are specific AIX commands.
AIX commands are CASE (lower and upper) SENSITIVE, and must
be entered exactly as shown, including the filenames.

• If the file is loaded in the target server, skip to section 6.1.1.2.
• If the file is on diskettes continue to section 6.1.1.1.

6.1.1.1 File on Diskettes

Enter the commands:

mkdir /tmp/fwupdate

Note: If the directory /tmp/fwupdate already exists,
make sure it is empty before proceeding.

cd /tmp/fwupdate

Enter :
restore

You will be prompted to mount volume 1 on /dev/rfd0

In the drive of the target server, put the AIX backup diskette labeled:

"Volume 1: Firmware (3R040602) for NAS Gateway 500, 5198-001"

When prompted for volume 2,

In the drive of the target server, put the AIX backup diskette labeled:

"Volume 2: Firmware (3R040602) for NAS Gateway 500, 5198-001"

When prompted for volume 3,

In the drive of the target server, put the AIX backup diskette labeled:

"Volume 3: Firmware (3R040602) for NAS Gateway 500, 5198-001"

When prompted for volume 4,

In the drive of the target server, put the AIX backup diskette labeled:

"Volume 4: Firmware (3R040602) for NAS Gateway 500, 5198-001"

The file is now located in the /tmp/fwupdate subdirectory. Continue to section 6.1.1.2.

6.1.1.2 Updating with the AIX Diagnostic Service Aids

a) Invoke the AIX Diagnostic Service Aids from on-line diagnostics using the command "smit":

• Select "Problem Determination"
• Select " Hardware Diagnostics"
• Read the information when prompted and press the "Enter" key to continue.
• Select "Current Shell Diagnostics Task Selection".

b) Choose Update System or Service Processor Flash from the list.

c) Select 'File System' as the source of the flash update image file.

• If NAS Gateway 500 version 1.1.1 software is installed:
  the fully qualified path name of the update file is /tmp/fwbackup/3R040602.img

• If NAS Gateway 500 software versions earlier than 1.1.1 installed:
  the fully qualified path name of the update file is /tmp/fwupdate/3R040602.img

d) If using an ASCII terminal press 'F7' key to 'Commit' the update.

e) Choose Yes to continue.

You will be asked for confirmation to proceed with the firmware update and the required reboot. If you confirm, the server automatically performs the update and reboots. The checkpoints 99FF and 99FD alternately appear while the update is in progress. This may take up to thirty minutes, depending on the configuration of the server. Since the update occurs during this shutdown/reboot sequence, it is important to protect the server from interruptions.

ATTENTION: You may get error codes 4B2E26FB, 4B2E26FD or 40640EAF depending on the type of processor card(s) installed in the system. You will be in the Service Processor Main Menu. To continue the firmware update process:
1) Press the white button on the operator panel.
2) Within a minute, the operator panel will display 9022.
3) Press the white button again.
4) Within a minute, the operator panel will display OK.
5) The second line of the title on the Service Processor Menu will match the firmware level you just installed.

Don't forget to retrieve and file any firmware update diskette that may still be in the server's diskette drive. A good time to do this is after the reboot has completed.

The update of the firmware is complete. You will want to verify this update as shown in section 6.2.

6.1.2 Using the AIX Command-Line, CLI, Method

Before installing this level of firmware, see section 3.0 Cautions and Important Notes

You must must login as "root" on the target server to update its firmware.

Note: In the instructions that follow are specific AIX commands.
AIX commands are CASE (lower and upper) SENSITIVE, and must
be entered exactly as shown, including the filenames.

This method allows updating either from files already loaded into the target server or from diskettes.

• If the file is loaded in the target server, skip to section 6.1.2.2.
• If the file is on diskettes continue to section 6.1.2.1.

6.1.2.1 File on Diskettes

On the target server,

Enter the commands:

mkdir /tmp/fwupdate

Note: If the directory /tmp/fwupdate already exists,
make sure it is empty before proceeding.

cd /tmp/fwupdate

Enter :
restore

You will be prompted to mount volume 1 on /dev/rfd0

In the drive of the target server, put the AIX backup diskette labeled:

"Volume 1: Firmware (3R040602) for NAS Gateway 500, 5198-001"

When prompted for volume 2,

In the drive of the target server, put the AIX backup diskette labeled:

"Volume 2: Firmware (3R040602) for NAS Gateway 500, 5198-001"

When prompted for volume 3,

In the drive of the target server, put the AIX backup diskette labeled:

"Volume 3: Firmware (3R040602) for NAS Gateway 500, 5198-001"

When prompted for volume 4,

In the drive of the target server, put the AIX backup diskette labeled:

"Volume 4: Firmware (3R040602) for NAS Gateway 500, 5198-001"

The file is now located in the /tmp/fwupdate subdirectory. Continue to section 6.1.2.2.

6.1.2.2 Updating With Files Already Loaded on the Target Server

Before installing this level of firmware, see section 3.0 Cautions and Important Notes

You must login as "root" on the NAS Gateway 500 to update its firmware. This method allows updating from files already loaded onto the NAS Gateway 500. Update with the file located in the /tmp/fwupdate/ subdirectory.

• If NAS Gateway 500 version 1.1.1 software is installed, enter the following commands:

cd /usr/lpp/diagnostics/bin
./update_flash -f /tmp/fwbackup/3R040602.img

Note: [Don't overlook the periods (.) in the above command.]

• If NAS Gateway 500 software versions earlier than 1.1.1 installed, enter the following commands:

cd /usr/lpp/diagnostics/bin
./update_flash -f /tmp/fwupdate/3R040602.img

Note: [Don't overlook the periods (.) in the above command.]

You will be asked for confirmation to proceed with the firmware update and the required reboot. If you confirm, the NAS Gateway 500 automatically performs the update and reboots. The checkpoints 99FF and 99FD alternately appear while the update is in progress. This may take up to thirty minutes, depending on the configuration of the system. Because the update occurs during this shutdown/reboot sequence, it is important to protect the NAS Gateway 500 from interruptions.

ATTENTION: You may get error codes 4B2E26FB, 4B2E26FD or 40640EAF depending on the type of processor card(s) installed in the system. You will be in the Service Processor Main Menu. To continue the firmware update process:
1) Press the white button on the operator panel.
2) Within a minute, the operator panel will display 9022.
3) Press the white button again.
4) Within a minute, the operator panel will display OK.
5) The second line of the title on the Service Processor Menu will match the firmware level you just installed.

The update of the firmware is complete. To verify that the update was successful, the firmware level can be checked as described in section 6.2.

6.1.3 Using the Service Processor Menus Method

Before installing this level of firmware, see section 3.0 Cautions and Important Notes

Service Processor Menus allow updating from diskettes only.

You must have privileged user authority on the NAS Gateway 500 to update its firmware, and you must have console attached to serial port 1.

Note:   All firmware (System, Service Processor and SPCN) will be updated when using this method.

    a. Shutdown the NAS Gateway 500 from a tty terminal window connection.

    b. When the operator panel on the server says OK, press the <Enter> key to bring up the service processor menu..          

    c. Choose 1 for Service Processor Setup Menu.  <Enter>

    d. Choose 7 for Reprogram Flash EPROM Menu. <Enter>

    e. Type y to continue.  <Enter>

    f. Follow on-screen update steps as they are presented.

    g.  The 'Rebooting Service Processor ' message appears on the screen.

The NAS Gateway 500 will reboot.This can take up to thirty minutes, depending on the configuration of the target server. Because the update occurs during this shutdown/reboot sequence, it is important to protect the server from interruptions.

    h. Begin watching the operator panel.

    i.  When the panel says 'OK', press the Enter key.

          The Service Processor Menu appears on the screen.

         The second line of the title, Version: 3R040602, should match the firmware level you just
          installed.

Don't forget to retrieve and file any firmware update diskette that may still be in the system's diskette drive.  A good time to do this is after the reboot has completed.

The firmware update is complete.

6.2 Verifying the Update

To verify the update was successful, the firmware level can be checked in AIX CLI command or in the Service Processor Main Menu.

6.2.1 Using AIX CLI

Use the following CLI command for checking the firmware level.

Enter:
lscfg -vp | grep -p Platform

This command will produce a system configuration report containing sections similar to the following.

Platform Firmware:

ROM Level.(alterable).......3R040602

Version.....................RS6K

System Info Specific.(YL)...U1.18-P1-H2/Y2

Physical Location: U1.18-P1-H2/Y2

The ROM Level line should match the level you just installed, namely, 3R040602.

6.2.2 Using the Service Processor Main Menu

The second line of the title, Version: 3R040602, shows the currently installed firmware level.

6.3 Archiving the Update Files

In the event it becomes necessary to restore the server to a certain firmware level, it is suggested you identify and archive the materials for each update you install. If the download process produced diskettes, label and store them in a safe place. If the download process produced files, archive and identify the files for convenient retrieval.

End of Installation Instructions