2-Port Gigabit Ethernet-SX PCI-Express (FC: 5768)

Firmware Level	Description
EP0110	Original level
EP0120	Corrects RDCTL settings to fix receive descriptor problems
EP0140	Disables PCI-e Completion Timeouts on I/O Adapters, corrects method of semaphore release and close OBP-TFTP package before adapter physical connection
EP0170	Enabling iSCSI boot support and fix bug with long spanning tree algorithms
EP0220	FCode data stack imbalance fixed Barrier Support: adds synchronization code in certain codes paths

Document Revision History	Description
01/28/2009	Updating Readme file with latest microcode for this adapter- EP0170
03/05/2009	Update Readme file with some html character conflicts.
09/29/2015	Update Readme file with latest microcode – EP0220
08/26/2016	Adding Section 11 Microcode Download Procedure for Systems without AIX installed.

2.0 General information

This Readme file is intended to give directions on how to update the microcode found on the 2-Port Gigabit Ethernet-SX PCI-Express (FC 5768).

4.0 Machine's Affected:

8203-E4A, 8204-E8A, 9117-MMA, 9125-F2A and any new system that supports PCI-Express slots

5.0 AIX Requirements:

Basic card function is supported on :

AIX 5L Version V5.3 technology level 5300-07 and later

AIX 6L Version V6.0 technology level 6100-00 and later

New Flash ROM microcode support needed for microcode download

For AIX 6100-00 run this command: instfix -ik IZ27512

For AIX 6100-01 run this command: instfix -ik IZ27599

For AIX 5300-06 run this command: instfix -ik IZ32296

For AIX 5300-07 run this command: instfix -ik IZ32180

For AIX 5300-08 run this command: instfix -ik IZ32204

Use this search page to find the appropriate APAR for your OS(http://www-933.ibm.com/eserver/support/fixes/fixcentral). To navigate this site, you will want to specify Product family -> System p, Product -> AIX, Version -> AIX level you need, and Fix type -> Fix search and then press Continue. The next web page, you will need to put the APAR level listed above for your OS level (for AIX 5300-07, you would input IZ32180).

If you are using another release of AIX, ensure that the adapter is supported on that release before you install the adapter. Contact service and support for assistance.

6.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 Ethernet adapters installed in the system by typing:

lsdev -C | grep ent

Note: All of the Ethernet adapters that are installed will be displayed. They will be listed as entX, where X is 0, 1, etc.

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

lscfg -vl entX

Where “x” is the instance of the adapter. The command will produce output similar to:

# lscfg -vl ent6

ent6 U789C.001.DQD4391-P1-C3-T4 2-Port Gigabit Ethernet-SX PCI-Express Adapter (14103f03)

2-P NIC-SX PCI-e:

EC Level....................D77283

Part Number.................00E0837

Manufacture ID..............YL1026

FRU Number..................00E0837

Network Address.............00145E78020C

ROM Level.(alterable).......EP0220

Hardware Location Code......U789C.001.DQD4391-P1-C3-T4

If the ROM Level is less than EP0220 you should update the microcode.

7.0 Downloading the RPM Format File to the Target Server for AIX
Use this method to download to an AIX system:

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

1) Make two directories on your AIX system to receive the RPM format file.
Enter: "mkdir /tmp/microcode"

and then create this directory

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 filename for the RPM file.
"rpm -ihv --ignoreos pciex.14103f03-EP0220-1.aix.noarch.rpm"

3) For AIX: The microcode files will be added to /usr/lib/microcode/.

NOTE:
- "/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.

8.0 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 or Linux 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 pciex.14103f03-EP0220-1.aix.noarch.rpm

4) One microcode file will be copied to "/etc/microcode". The file size and checksum of the microcode image will be verified in Section 9.0.
             File Name:
            14103f03.EP0220

9.0 Verifying microcode before download and notes for AIX

Please verify the file size and checksum of the raw microcode files matches what is listed below.

For AIX :
"ls -l /usr/lib/microcode/14103f03.EP0220" to verify file size is 131072.
"sum /usr/lib/microcode/14103f03.EP0220" to verify Checksum is 10343.

10.0 Microcode Download Procedure for AIX:

Microcode download must be performed separately for each Adapter under each Logical Partitions (LPAR's).

10.1 Setting up for Microcode download

1) Stop all applications that use this interface/adapter

2) ***This step is for VIOS Users only*** – Detach and Remove the SEA (Shared Ethernet Adapter) interface

# lsdev -C |grep ent

ent6 Available 02-08 2-Port Gigabit SX PCI-Express Adapter (14103f03)

ent7 Available Shared Ethernet Adapter

a) Before detaching the interface, record the ip address and any other pertinent information that was configured on the Adapter. This information may be needed if the microcode update overwrites this section on the Adapter.

b) “ifconfig en”X” detach” – where “X” is the interface number for the Shared Ethernet Adapter.

c) “rmdev –l ent”X” – where “X” is the interface number for the Shared Ethernet Adapter.

3) Detach the Adapter’s interface (not always needed, but it is a good practice to do this step.

b) Under normal conditions, to detach the adapter from the network use the following command:

“ifconfig en”X” detach” – where “X” is the interface number for the adapter.

10.2 Downloading Microcode to the Adapter

1) At the command line type “diag”
2) Select the "Task Selection" from diagnostics menu.
3) Select "Download Microcode" or "Microcode Tasks” then select “Download Microcode" from the menu.
4) Select all of the 2-Port Gigabit Ethernet-SX PCI Express Adapters (14103f03) that need to be updated from the list of devices by using the arrow keys to highlight the entry and pressing "Enter" to mark it. The devices will be displayed as ent#, where # is the number of the device. Press "F7" when you are done mark all the adapters you want to flash.
5) Select "/usr/lib/microcode" or “/etc/microcode”.
6) A dialogue box may be displayed on screen. It will state that the current microcode level on the adapter could not be found on the selected source. This is acceptable because the adapter will reject any incorrect code. Press "Enter" to continue.
7) Select EP0220 level and press "Enter" to flash the adapter.
8) The following message will appear on the screen when download is completed: "Microcode download complete successfully. The current microcode level for the device ent# is ... Please run diagnostics on the adapter to ensure that it is functioning properly."
9) If you selected more than one adapter to update, then steps 6-9 will repeat until all adapters are updated.
10) Exit diagnostics.

10.3 Verify and Re-configure adapters

1) Verify the code level is EP0220 by typing "lscfg -vl ent#" for each Ethernet adapter updated. <Where # is the instance of the Ethernet adapter>

2) ***This step is for VIOS Users only*** Re-Configure the SEA adapter by executing the following command: “cfgmgr”

Any VIOS specific issues please contact IBM VIOS support team.

3) Re-configure/Verify the adapter’s interface ip information through the “smit” menus.

11.0 Microcode Download Procedure for Systems Without AIX Installed:

Use this procedure if the system has no OS installed or the installed OS (e.g., Linux) does not support microcode download for this device.

1) Boot the system via a Standalone Diagnostic's CD

a) To obtain a Standalone Diagnostic CD-ROM please go to the following webpage and follow the instructions
http://www-304.ibm.com/webapp/set2/sas/f/diags/home.html

b) After booting to Standalone Diagnostics, the Diagnostic's CD can be removed.

2) The Diagnostic's CD should be replaced by a CD containing the unpacked microcode image.

The CD containing the microcode images should be prepared prior. Create a CD-ROM with the firmware 14103f03.EP0220 mentioned in section 8.4 and burn the CD with Joliet CD file system.

3) From the Define a System Console menu either type or select vt320.

4) Select the "Task Selection" from diagnostics menu then select "Download Microcode".

5) Select resource 2-Port Gigabit Ethernet-SX PCI-Express (FC 5768) that microcode will be applied to and PRESS ENTER.

6) Press "F7" or "ESC+7" to commit.(The current microcode level of the resource you selected earlier will be displayed at the top of the screen).

7) Select Input Device (CD-ROM or DVD) then choose the Microcode level to download.

NOTE: A prompt will ask you to insert the microcode CD-ROM into the CD/DVD drive. Insert the CD-ROM which accompanies these instructions. If this level is already installed in the drive you've selected a message will let you know. A message also may come up to let you know that the CD_ROM does not have the previous level microcode file. This is true and is not required to complete the download. PRESS "F7" or "ESC+7" to commit.

8) You will receive a msg. "Current Microcode is...." and "Download has completed successfully"(this may take a few minutes).

9) Return to the Tasks Selection menu and repeat this procedure for each adapter that requires this microcode.

10) Exit diagnostic and reboot system in normal mode.