IBM Power Systems
SAS Enclosure Services for FC ESLL, ESLS, 5147-024 (CCIN 78D1)

Microcode Update

 

 DATE: November 6, 2023

 

Table of Contents

1.0 Microcode Change History

2.0 General Information
2.1 Installation Time
2.2 Machine's Affected
2.3 AIX Requirements
2.4 Linux Requirements

3.0 Determine the Current Microcode Level for AIX
3.1 Determine the Current Microcode Level for Linux

4.0 Downloading and Unpacking the Firmware Update Package from CORE
4.1 Downloading the RPM Format File to the Target Server
4.2 Discovery Tool Microcode CD-ROM creation and download instructions

5.0 Verifying microcode before download and notes
5.1 Microcode Download Procedure-SAS Enclosure Services for FC ESLL/ESLS/5147-024 for AIX
5.2 Microcode Download Procedure-SAS Enclosure Services for FC ESLL/ESLS/5147-024 for Linux

6.0 Microcode Readme Change History

=====================================================================================

1.0 Microcode Change History:  

4240

Release 4240

Impact: SVC            Severity: ATT

 

Add periodic validation of midplane VPDs

Watchdog exception GP registers and Mini Stack dumping

SES update vra046/057 soft device bus error

Midplane VPD in OSES format

Increased EMA thread stack size by 0x200

 

4200

Release 4200

Impact: SVC            Severity: ATT

 

Increase the Fan speed for 14W drives–the base fan speed is changed to 27% PWM (was 17%).

 

41E0

Release 41E0

Impact: SVC            Severity: ATT

 

Corrected the Standard Inquiry Page and SES Page 1 to present the Product ID data in the format needed by the ESS group (5147-024). Does not change ESLS, ESLL.

 

Fixed an issue for manufacturing zone mode changes.

                                     42

Fixed a stack overflow issue, although the stack overflow did not cause any issues in the POWER environment.

41A0

Release 41A0

Impact: SVC             Severity: ATT

 

Added support for the “Machine Type Model (MTM)” used by ESS (5147-024)

Fixed issue with FW reverting to old version

Fixed issue with Zone Mode changes failing intermittently

For ESLL only – Fixed issue with SAS Links not coming up

 

4170

GA 6.2 Level

Impact: SVC               Severity: ATT

 

Improved error handling during SES microcode updates to prevent possible errors reported against the drive resources.

 

Enhancements to connector Fault LED functionality

 

Diagnostic improvements for expander to power supply communication and failure detection.

 

Improved error handling and reporting for expander and/or fan failures

4110

GA level

 

2.0 General Information
This subject microcode is to be used on the following:

CCIN 78D1

12G SAS External DASD Enclosure (12 slot 3.5'' drawer):  FC ESLL

12G SAS External DASD Enclosure (24 slot 2.5'' drawer):  FC ESLS

12G SAS External DASD Enclosure (24 slot 2.5'' drawer):  FC 5147-024

 

 

2.1 Installation Time:
Approximately 30 minutes
 
2.2 Machine's Affected:
FC ESLL

FC ESLS

FC 5147-024

 

2.3 AIX Requirements:
TL refers to Technology Level

SP refers to Service Pack

 

For support:

7.2 TL01
7.1 TL04 SP3
6.1 TL09 SP8
7.1 TL03 SP8
7.2 TL00 SP3
VIOS 2.2.5

VIOS 2.2.4.30


2.4 Linux Requirements:

For support with updated iprutils provided via the IBM Linux on Power Tools Repository:

Red Hat Enterprise Linux 6.8 for POWER, or later

Red Hat Enterprise Linux 7.2 for POWER, or later
Novel SUSE Linux Enterprise 11 Service Pack 4, or later
Novel SUSE Linux Enterprise 12 Service Pack 2, or later

Ubuntu 16.04.2 or later

IBM PowerKVM 3.1.1, or later

 

 

3.0 Determine the Current Microcode Level for AIX:

Before you install the microcode, it is important to determine the microcode level of the Adapter installed in the target system. Use

the following instructions to read the ROM level stored in the Adapter's VPD.

1)  List the SES installed in the system by typing:

    lsdev -C | grep ses

Note: All of the SAS RAID initiators addresses that are installed will be displayed. The names will be sesX, where X is 0, 1, etc.

2) To check the current microcode level for the adapter or controller enter the following command

   lscfg -vl sesX

Where X is the number/s of the previous command. The Command will produce output similar to

 

DEVICE   LOCATION                                 DESCRIPTION

ses0             UESLS.001.G5BP007-P1-C1  SAS Enclosure Services Device

 

 SAS Expander:

   FRU Number..................01DH720

   Serial Number...............YM1XBG5BB02C

   Customer Card ID Number.....78D1

   Product Specific.(ZM).......1

   Load ID.....................A1700DF5

   ROM Level.(alterable).......4240

   Hardware Location Code......UESLS.001.G5BP007-P1-C1


ses1             UESLS.001.G5BP007-P1-C2  SAS Enclosure Services Device

 

 SAS Expander:

   FRU Number..................01DH720

   Serial Number...............YM1XBG5BB02C

   Customer Card ID Number.....78D1

   Product Specific.(ZM).......1

   Load ID.....................A1700DF5

   ROM Level.(alterable).......4240

   Hardware Location Code......UESLS.001.G5BP007-P1-C2

 

If the ROM Level and ID is less than 4240 then you should update the microcode.

3.1 Determine the Current Microcode Level for Linux:
1) Type "iprconfig"
2) Select "Display hardware status"
3) Select SES by typing a "1" in front of it and pressing Enter.
4) The Command will produce output similar to
"Firmware Version . . . . . . . . . . . . : 4240"

If the Firmware Version is less than 4240 then you should update the microcode.

 

4.0 Downloading and Unpacking the Firmware Update Package from CORE

NOTE:  The CORE image will now be the RPM Format File.

1) After downloading the files from CORE on to your personal system find the following files in the CORE destination directory (c:\ibmdocs\DISKIMG):
    A) "SES.4240.aix7.2.rpm"
    B) "SES.4240.linux.rpm"

    C) "SES.4240.linux.rpm"

2) Log in to the Target Server
3) Create a directory, if not already existent (mkdir /tmp/microcode; mkdir /tmp/microcode/RPM)
4) Transfer the file to the Target Server "/tmp/microcode/RPM directory" using ftp or another method.  Change to that directory, "cd /tmp/microcode/RPM".
5a) For AIX:  Unpack the RPM file by using the following command:  "rpm -ihv --ignoreos --force SES.4240.aix7.2.rpm"
5b) For Linux:  Unpack the RPM file by using the following command:  "rpm -ihv --ignoreos --force SES.4240.linux.rpm"

5c) For Linux - Ubuntu: Un-tar the file by using the following command: rpm -ihv --ignoreos --force SES.4240.linux.rpm

6a) For AIX:  The microcode files will be added to /usr/lib/microcode/.
6b) For Linux:  The microcode files will be added to /lib/firmware/.

6c) For the Linux - Ubuntu file:  The microcode files will be added to /lib/firmware/.

 

4.1 Downloading the RPM Format File to the Target Server
Use this method to download to an AIX or Linux system:

 

1) Make a directory on an AIX/Linux system to receive the RPM format file.

    Enter: "mkdir /tmp/microcode"

    Enter: "mkdir /tmp/microcode/RPM"

2) Transfer the RPM format file to the /tmp/microcode/RPM directory (using "Save as ...").  Change to that directory, "cd /tmp/microcode/RPM".

You'll see the filenames for the RPM files.
    A) For AIX:  The filename is SES.4240.aix7.2.rpm
    B) For Linux:  The filename is SES.4240.linux.rpm

    C) For Linux - Ubuntu: The filename is SES.4240.linux.rpm
3) Unpack the file by executing the instructions below:
    A) For AIX:  Type "rpm -ihv --ignoreos --force SES.4240.aix7.2.rpm"
    B) For Linux:  Type "rpm -ihv --ignoreos --force SES.4240.linux.rpm"

    C) For Linux - Ubuntu: Un-tar the file by using the following command: rpm -ihv --ignoreos --force SES.4240.linux.rpm
4a) For AIX:  The microcode files will be added to /usr/lib/microcode/.
4b) For Linux:  The microcode files will be added to /lib/firmware/.

4c) For the Linux - Ubuntu file:  The microcode files will be added to /lib/firmware/.
 

4.2 Discovery Tool Microcode CD-ROM creation and download instructions

To obtain information how to burn a CD-ROM and run the Discovery Tool for an AIX System please go to: http://techsupport.services.ibm.com/server/mdownload/CDROMhelp.html
1) After running the Discovery Tool successfully the "/tmp/microcode/RPM" directory was created and your rpm files are copied from the CD-ROM.

2) Change to that directory, "cd /tmp/microcode/RPM".

3) Unpack the file by executing the instructions below:
    Enter the commands:
        rpm -ihv --ignoreos --force SES.4240.aix7.2.rpm
4) Microcode files will be copied to "/etc/microcode".  The file size and checksum of the microcode image will be verified in Section 5.0

Notes:
 - "/etc/microcode" is a symbolic link to "/usr/lib/microcode".
 - If permission does not allow the copy to the above stated directory
                  or file then the user will be prompted for a new location.

5.0 Verifying microcode before download and notes

NOTE:  Microcode download must be performed separately for each "ses" under distinct Logical Partitions (LPAR's).
              Please save current and older versions of the microcode update files in case you need to restore your system.

 

Installation Time:  Approximately 30 min System Time.

Please verify the file size and checksum of the raw microcode files matches the below.
Filesize:  3707576

Checksum:  32387
For AIX:  "ls -l /usr/lib/microcode/A1700DF5.4240" to verify Filesize
                "sum /usr/lib/microcode/A1700DF5.4240" to verify Checksum.
For Linux:  "ls -l /lib/firmware/IBM-A1700DF5.4240" to verify Filesize.
                 "sum /lib/firmware/IBM-A1700DF5.4240" to verify Checksum.

For systems that have LPAR installed, the microcode file must be placed on all partitions that have a SES device in order to update the code.  Follow this procedure for each partition:

For AIX:
    A)  Log into the target partition.
    B)  Type: "cd /usr/lib/microcode"
    C)  FTP (for AIX) or SFTP (for Linux) to the partition that has the media bay assigned. (ie.  ftp/sftp partition1.ibm.com)
    D)  Type: "cd /usr/lib/microcode"
    E)  If using FTP then Type: "bin"
    F)  Type: "get A1700DF5.4240"
    G)  Type: "quit"

For Linux:
    A)  Log into the target partition.
    B)  Type: "cd /lib/firmware"
    C)  SFTP to the partition that has the media bay assigned. (ie.  "sftp partition1.ibm.com")
    D)  Type: "cd /lib/firmware"
    E)  Type: "get IBM- A1700DF5.4240"
    F)  Type: "quit"

5.1 Microcode Download Procedure-SAS Enclosure Services for FC ESLL/ESLS/5147-024 for AIX

Procedure:
1) It is advised, but not necessary to stop all applications.
2) Enter diag
3) Select the "Task Selection" from diagnostics menu.
4) Select "Download Microcode" or "Microcode Tasks -> Download Microcode" from "Task Selection" menu.
5) Select all of the SAS Enclosure Services for FC ESLL/ESLS,5147-024s that need to be updated from the list of devices by pressing "Enter".  The devices will be displayed as ses#, where # is the number of the device.  Press "F7".
6) A dialogue box will be displayed on screen.  Press "Enter" to continue.
7) Select "/usr/lib/microcode".
8) A dialogue box will may be displayed on screen.  It will state that the current microcode level on the adapter is not in the /usr/lib/microcode directory.  This is acceptable as you will be flashing new microcode onto the adapter.  Also, incorrect code will automatically be rejected.  Press "Enter" to continue.
9) An "M" will be displayed next to the latest level of microcode in the /usr/lib/microcode directory.  Select that level and press "Enter".
10) The following message will appear on the screen when download is completed: "Microcode download complete successfully.  The current microcode level for the device ses# is .....  Please run diagnostics on the adapter to ensure that it is functioning properly."  DO NOT run diagnostics on the device at this time.
11) Exit diagnostics.
12) Verify the code level is 4240 by typing "lscfg -vl ses#" for each SES device updated. <Where # is the number ses device>

5.2 Microcode Download Procedure-SAS Enclosure Services for FC ESLL/ESLS/5147-024 for Linux

Procedure:

1) Stop all applications.
2) Type “iprconfig” and press “Enter”.
3) Select “Download Microcode” and press “Enter”.
4) Select all of the SAS Enclosure Services for FC ESLL/ESLS/5147-024s that need to be updated from the list of devices by pressing “1”. Then press “Enter”.
5) Select the appropriate microcode image to flash by pressing “1”.  (The image will end in 4240).  Press Enter.  Press Enter again to confirm.
6) If multiple devices were selected in step 4, then repeat step 5 until finished.

 

6.0 Microcode Readme Change History
 

2016-11-14

- Initial Release

2017-03-16

-GA 6.2 Release

2017-06-30

-41A0 Release

2017-10-04

-41E0 Release

2018-01-17

-4200 Release

2023-11-06

-4240 Release