Integrated
Multifunction Card with SR Optical 10GbE + 1GbE (CCIN 2B57)
Integrated
Multifunction Card with Copper
******* PLEASE
READ THIS ENTIRE NOTICE *********
DATE: November 09, 2016
Table of Contents
1.0 Microcode and Document Revision History:
6.0 Determine the Current Microcode Level:
7.0 Downloading the RPM Format File to the Target Server
8.0 Discovery Tool Microcode CD-ROM creation and download
instructions
9.0 Verifying microcode before download and notes
10.0 Microcode Download Procedure:
10.1.1 Setting up for Microcode download
10.1.2 Downloading Microcode to the Adapter
10.1.3 Verify and Re-configure adapters
10.2.1 Setting up for Microcode download
10.2.2 Downloading Microcode to the Adapter
10.2.3 Verify and Re-configure adapters
=====================================================================================
|
Firmware
Level |
Description |
|
0400003260001 |
Original
Release |
|
0400003260003 |
Includes fixes from the following RETAIN tips: H204004 - Ethernet card 1G ports UN-P2-C8 Ethernet Down
Errors |
|
Fixed link stability issues |
|
|
0400401800009 |
Scheduler
implemented to handle ioctl commands as a priority
to prevent mailbox timeouts. |
|
|
Description |
|
1.0 |
Initial release to drop code level 0400003260001 |
|
1.1 |
Added firmware
level0400003260003 |
|
1.2 |
Added firmware level
0400401800007 |
|
1.3 |
Added firmware level
0400401800009 |
This Readme file is intended to give
directions on how to update the microcode found on the Integrated Multifunction Card with SR Optical 10GbE + 1GbE (FC 1769,
CCIN 2B57 ) and the Integrated Multifunction Card with Copper
Device ID for FC 1769, CCIN 2B57: a219100714100904
Device ID for FC 1768, CCIN 2B56: a219100714100a04
3.0 Installation time
Approximately 20 minutes per adapter.
This adapter is supported in Power Systems 9117-
Basic card function is supported on:
AIX
61N technology level 6100-02 and later
AIX
71D technology level 7100-03 and later
Linux
RHEL 6.0
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
entx
ent0
U2C4E.001.DBJ1163-P2-C8-T1 Int Multifunction
Card w/ SR Optical 10GbE (a219100714100904)
Int Multifunction Card w/ SR Optical 10GbE:
Network Address.............E41F13C5E374
ROM Level.(alterable).......0400401800009
Hardware Location
Code......U2C4E.001.DBJ1163-P2-C8-T1
# lscfg -vl entx
entx
U78AA.001.WIH003H-P2-C8-T1 Int Multifunction Card w/ Copper
Int Multifunction Card w/
Copper
Network Address.............E41F13C5E374
ROM Level.(alterable).......0400401800009
Hardware Location
Code......U2C4E.001.DBJ1163-P2-C8-T1
# lscfg -vl entx
ent2
U2C4E.001.DBJ1163-P2-C8-T3 Int Multifunction Card w/ Base-TX 10/100/1000
1GbE (a21910071410d203)
Int Multifunction Card w/
Base-TX 10/100/1000 1GbE:
Network Address.............E41F13C5E375
ROM Level.(alterable).......0400401800009
Hardware Location Code......U2C4E.001.DBJ1163-P2-C8-T3
If
the ROM Level is less than 04 004 0180 0009 you should update the microcode.
6.2 Linux
1) Use this series of Linux commands to determine which of any
installed Network adapters are Integrated Multifunction Adapters:
Note: It is advisable to cut and paste these command strings into your
system console, to avoid typographical errors.
Note: All of the Ethernet adapters that are installed will be displayed. They
will be listed as ethX, where X is 0, 1, etc.
for i in `ls
/sys/class/net | grep eth` ; do echo -n "${i}:
"; ethtool -i ${i} | grep bus-info; done
Output will display the association between ethX
devices and PCI bus device numbers, nnnn:nn:nn.n
eth0: bus-info:
eth1: bus-info: 0001:01:00.4
eth2: bus-info: 0001:01:00.0
eth3: bus-info: 0001:01:00.1
eth4: bus-info: 0001:01:00.5
lspci | grep be3
Output will list PCI bus device numbers for the Integrated Multifunction
Adapter functions, nnnn:nn:nn.n
0001:01:00.0 Ethernet controller: Emulex Corporation OneConnect
10Gb NIC (be3) (rev 02)
0001:01:00.1 Ethernet controller: Emulex Corporation OneConnect
10Gb NIC (be3) (rev 02)
0001:01:00.4 Ethernet controller: Emulex Corporation OneConnect
10Gb NIC (be3) (rev 02)
0001:01:00.5 Ethernet controller: Emulex Corporation OneConnect
10Gb NIC (be3) (rev 02)
This example shows the four ports of one Integrated Multifunction Adapter.
Firmware need only be updated on the first port of each adapter,
eth1 in this case.
If more than 4 ports are shown, it is likely you have more than one adapter, so
you would need to also update firmware on first port of second
adapter.
2) Use ethtool –i ethX to find out which Ethernet interface is associated
with BE3 adapter. If driver name is “be2net” and the bus-info matches data from
the lspci command, that interface is for Integrated
Multifunction Card. For example:
#ethtool –i ethX
Where “x” is the instance of the adapter. The command will produce
output similar to:
#ethtool –i eth1
driver: be2net
version: 4.1.307r
firmware version: 4.4.180.9
bus-info: 0001:01:00.4
If driver name is “be2net” and the
bus-info matches the data from lspci, eth1 is one of
Integrated Multifunction Card interfaces.
Firmware-version is “4.4.180.9”.
If
firmware-version is less than 4.4.180.9 you should update the microcode.
7.0 Downloading the
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
Enter: "mkdir /tmp/microcode"
and then create this directory
Enter: "mkdir /tmp/microcode/
2) Transfer the
You'll see the filename for the
"rpm -ivh --ignoreos a21910071410d203.0400401800009.aix.rpm"
3) For AIX: The microcode files will be added to
/etc/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.
Use this method to download the new microcode to a Linux system:
NOTE: The instructions that follow are specific Linux commands. Linux commands
are CASE (lower and upper) SENSITIVE, and must be entered exactly
as shown, including filenames.
1) Transfer the
2) Install rpm on your linux system.
#rpm -ivh --ignoreos
a21910071410d203.0400401800009.Linux.rpm
3) The microcode file will be added to /lib/firmware directory. File names are:
a21910071410d203.0400401800009, a219100714100a04.0400401800009, and
a219100714100904.0400401800009. File
contents are identical and any can be used for firmware update on Linux.
To obtain information how to burn a CD-ROM and run the Discovery Tool
for an AIX or Linux System please go to: http://www14.software.ibm.com/webapp/set2/mds/
1) After running the Discovery Tool successfully the "/tmp/microcode/
2) Change to that directory, "cd /tmp/microcode/
3) Unpack the file by executing the instructions below:
Enter the command:
rpm -ihv --ignoreos a21910071410d203.0400401800009.aix.rpm
4) Three microcode files will be copied to
"/etc/microcode". The file size and checksum of the microcode
image will be verified in Section 9.0.
File Name:
/etc/microcode/a219100714100904.0400401800009
/etc/microcode/a219100714100a04.0400401800009
/etc/microcode/a21910071410d203.0400401800009
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.
Please verify the file size and checksum of the raw microcode files
matches what is listed below.
For AIX :
"ls -l /etc/microcode/a21910071410*.0400401800009" to verify file size is 16777392.
"sum /etc/microcode/a21910071410*.0400401800009" to verify Checksum is 58478.
"ls -l /lib/firmware/a21910071410*.0400401800009" to verify file size is 16777392.
"sum /lib/firmware/a21910071410*.0400401800009" to verify Checksum is 58478.
Microcode download must be performed separately for each Adapter under
each Logical Partitions (LPAR's).
Notes: You only need to update any one port of the dual ports adapter.
The FW update will take effect for both ports.
1) Stop all applications that use this interface/adapter
2) Detach the Adapter’s interface (not always needed, but it is a good practice
to do this step).
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.
1) At the command line type “diag”
2) Select the "Task Selection" from diagnostics menu.
3) Select "Microcode Tasks” then select “Download Microcode" from the
menu.
4) Select one entX for each of the Int Multifunction Cards 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 “/etc/microcode” or "/usr/lib/microcode".
6) A dialogue box may be displayed on screen. It will state that the
current microcode level on the adapter is not in the /etc/microcode
directory. This is acceptable because the adapter will reject any
incorrect code. Press "Enter" to continue.
7) Select 0400401800009 level and press "Enter" to flash the adapter.
8) The following message will appear on the screen when download is completed:
"Installation of the microcode has completed successfully ... "
9) If you selected more than one adapter to update, then steps 6-9 will repeat
until all adapters are updated.
10) Exit diagnostics.
1) Verify the code level is 0400401800009 by typing "lscfg -vl ent#" for each
Ethernet adapter updated. (Where # is the instance of the Ethernet adapter)
2) Re-configure/Verify the adapter’s interface ip
information through the “smit” menus.
1) Use this series of
Linux commands to determine which of any installed Network adapters are Integrated Multifunction
Adapters:
Note: It is advisable to cut and paste
these command strings into your system console, to avoid typographical errors.
for i in `ls
/sys/class/net | grep eth` ; do echo -n "${i}:
"; ethtool -i ${i} | grep bus-info; done
Output will display the association between ethX devices and PCI bus device numbers, nnnn:nn:nn.n
eth0: bus-info:
eth1: bus-info: 0001:01:00.4
eth2: bus-info: 0001:01:00.0
eth3: bus-info: 0001:01:00.1
eth4: bus-info: 0001:01:00.5
lspci
| grep be3
Output will list PCI bus
device numbers for the Integrated Multifunction Adapter functions, nnnn:nn:nn.n
0001:01:00.0 Ethernet controller: Emulex Corporation OneConnect
10Gb NIC (be3) (rev 02)
0001:01:00.1 Ethernet controller: Emulex Corporation OneConnect
10Gb NIC (be3) (rev 02)
0001:01:00.4 Ethernet controller: Emulex Corporation OneConnect
10Gb NIC (be3) (rev 02)
0001:01:00.5 Ethernet controller: Emulex Corporation OneConnect
10Gb NIC (be3) (rev 02)
This example shows the four ports of one Integrated Multifunction Adapter.
Firmware need only be updated on the first port of each adapter, eth1 in this case.
If more than 4 ports are shown, it is likely you have more than one adapter, so
you would need to also update firmware on first port of second adapter.
2) Stop all
applications that use the interface/adapter to be updated
3) Configure the
adapter’s interface, eth1 in this example.
ifconfig eth1 192.168.1.1/24
4) Check that no
errors were reported. If errors were reported verify proper interface was
configured and command was entered correctly.
Caution: If
adapter is installed in non hot-pluggable slot, you will have to reboot the
entire system for the update to take effect. Partition reboot is not sufficient.
1) Using the ethX configured in previous step, use ethtool –flash to update the firmware.
Note: RPM installed three images; the
images are identical in content and only different by name.
ethtool -f ethX a21910071410d203.0400401800009
2) If flashing is completed successfully, no
messages will appear on the screen. You can check messages in system log.
dmesg | grep be2net
For example, dmesg command will show the following
messages:
be2net 0001:01:00.4: firmware: requesting
a21910071410d203.0400401800009
be2net 0001:01:00.4: Flashing firmware file a21910071410d203.0400401800009
be2net 0001:01:00.4: Firmware flashed successfully
These messages show flashing is completed successfully.
3) Verify firmware has
been activated
Using same ethX interface used for ethtool –flash command, type:
ethtool -i ethX
driver: be2net
version: 4.1.307r
firmware-version: 4.4.180.7 [4.4.180.9]
bus-info: 0001:01:00.4
4) Firmware-version must show 4.4.180.9. If
firmware-version is not as expected, carefully retrace steps to confirm no
steps were omitted or performed incorrectly. If no errors or omissions were
found, contact IBM customer service for assistance.
5)
On a non hot-pluggable system/slot
where you install adapter, you have to reboot the entire system (not just LPAR
reboot or shutdown) for the update to take effect. On hot-pluggable
system/slot, LPAR reboot is sufficient for the new FW to load.
1) Verify the code level is 4.4.180.9 by typing "ethtool –i
ethX" for each Ethernet adapter updated (where X
is the instance of the Ethernet adapter).
2) Re-configure/Verify the adapter’s interface ip
by “ifconfig ethX” (where X
is the instance of the Ethernet adapter).