[SunHELP] HOWTO configure SUN Branded QLA2342 HBA's
Monique Marais
Monique.Marais at alindigo.com
Thu Jul 6 08:12:28 CDT 2006
Thanks to everyone who tried to help. I was forwarded a good document and
would like to share it with the rest of you.
*********************************************************************
Document Body: Top
Background (test case):
-----------------
In the test environment it was understood that the v880 and v480 have a
'Sun branded' qlogic 2200 onboard controller built-in to the system board.
Knowing this, there is the risk that driver conflicts could be experienced
by installing a 'non Sun branded' qlogic card of the same model.
I. Test Case with v480 :
------------------
-v480 running Solaris 8u2 with recommend patch cluster dated 3/04
-Qlogic qla2310F HBA (to be installed)
-Sun 2gb SanSwitch 16 port
Installation Notes:
-------------
Sun StorEdge drivers (SAN 4.0) was installed and running before the qlogic
card/drivers were installed - this is a requirement.
Qlogic 2310FC card was installed into the system
System was only able to see a generic 'fibre-card' from both the OS and
the OBP, labeled as a "fibre-card" when a "show-devs" was run at OBP.
Trying to traverse the card at OBP by doing a "cd
/devices/pci at 8,600000/fibre-channel" would work, however seeing anything
beyond this level was unsuccessful and a flogin to the SAN switch did not
occur.
OS was reconfiguration booted, card was seen - but generic:
# pwd
/devices/pci at 8,600000
# ls -l
total 0
crw-rw-rw- 1 root sys 267, 0 Mar 25 12:56 fibre-channel at 2:devctl
qla23xx drivers were downloaded from qlogic website and installed (pkgadd)
1 QLA2300 QLogic QLA2300 driver
(sparc) Solaris, Rev=4.13.01
## Installing part 1 of 1.
/kernel/drv/q3ip
/kernel/drv/q3ip.conf
/kernel/drv/q3ip_v9
/kernel/drv/qla2300
/kernel/drv/qla2300.conf
/kernel/drv/qla2300_v9
[ verifying class <none> ]
## Executing postinstall script.
Installation of <QLA2300> was successful.
Note: this is the only package installed (required)
2a. After the QLA driver has been installed, we need to modify the
entries in the /etc/driver_aliases file. We need to move all the lines
with 'qlc' signature in the end of the file, after the 'qla2300' entries,
so that both the drivers (qla2300 & qlc) can co-exist.
The system was reconfiguration rebooted - the card was seen during the
boot process and logged into the SAN switch.
Next the CLI interface was installed:
2. scli2-8 SANblade CLI
(sparc) 1.06.12 (Solaris 8-9)
## Installing part 1 of 1.
/opt/QLogic_Corporation/SANblade_CLI/adapters.properties
/opt/QLogic_Corporation/SANblade_CLI/menu.properties
/opt/QLogic_Corporation/SANblade_CLI/readme.txt
/opt/QLogic_Corporation/SANblade_CLI/scli
[ verifying class <none> ]
## Executing postinstall script.
Installation of <scli2-8> was successful.
Still the card was still seen as a generic fibre-card, however using the
utility provided with the qlogic install "scli" the card was more
accessible:
/opt/QLogic_Corporation/SANblade_CLI/scli
Adapter General Information Menu
1: Display Specific Adapter Information
2: Display All Adapter Information
3: Return to Main Menu
Enter Selection: 2
----------------------------------------------------------------------------
-
Host : ozzy1
Adapter Number : 0
Adapter Model : QLA2300/2310
Adapter Node Name : 20-00-00-E0-8B-10-C0-73
Adapter Port Name : 21-00-00-E0-8B-10-C0-73
Adapter Port ID : 64-02-00
Serial Number : K78208
Driver Version : 4.13.01
FCode Version : 0.0 <<<<<<<<<<<<--------Note the FCode was
0.0!!!
Firmware Version : 3.2.15 IP
Device Target Count : 0
PortType (Topology) : NPort
Adapter Status : Online
----------------------------------------------------------------------------
Next a loopback test was run:
--------------------------------------------------------------
QLogic Adapter 0 - QLA2300/2310 WWPN: 21-00-00-E0-8B-10-C0-73
------------------
Test Configuration
------------------
Data Pattern : Random
Data Size (Bytes) : 8
Number of test(s)(1-10,000): 500
Test Increment(1-10,000) : 1
On Error : Ignore
Test Continuous : OFF
--------------------------------------------------------------
Diagnostics - Loopback Test Result
----------------------------------
Note: Press <Enter> to stop the test any time
---------------------------------------------
HBA Test Data Pattern Status CRC Disparity FrameLength Active
--- ----------------------- ----------- ---- --------- ----------- ------
0 69-04-AD-CC-02-78-42-76 Success 0 0 0 /
Noticing that the FCode was 0.0 an FCode update was done to the card:
Select Adapter:
1: Adapter 0 - WWPN: 21-00-00-E0-8B-10-C0-73 QLA2300/2310
2: Return to Main Menu
Enter Selection: 1
QLogic SANblade CLI
Version 1.06.12
WARNING:
The option Rom update operation (BIOS/FCode) requires that
the adapter has no outstanding input and output operations.
Please make sure there is no active I/O before starting the
operation.
Also after the update operation, the adapter will be reset. This may
adversely affect your SAN.
Do you want to proceed with the operation?
1: Yes
2: No
Enter Selection: 1
Enter Filename: /var/tmp/qlogic/ifp2300.prom
Updating FCode to adapter 0 - QLA2300/2310. Please wait...
The download has completed
Please reboot the system for the changes to take effect.
Flash Update for Adapter 0 Complete.
Press <Enter> to continue:
KEYPOINT:
----------
A "reset-all" needs to take place on the system to reinitialize the qlogic
card, once POST was complete the card now could be traversed and it logged
into the SAN switch from the OBP level.
{2} ok " /pci at 8,600000/QLGC,qla at 2" select-dev
QLogic QLA2300 Fibre Channel Host Adapter fcode version 2.00.05 01/29/03
Firmware version 3.02.15
System was reconfiguration booted
SunOS Release 5.8 Version Generic_117000-01 64-bit
Copyright 1983-2003 Sun Microsystems, Inc. All rights reserved.
configuring IPv4 interfaces: ce0.
Hostname: ozzy1
Configuring /dev and /devices
QLogic qla2300 Fibre Channel Driver v4.13.01 Instance: 1 Firmware v3.2.15
qla2300(1): QLogic QLA2300 Fibre Channel Host Adapter fcode version 2.00.05
01/29/03
TSI: gfxp0 is GFX8P @ 1152x900
Configuring the /dev directory (compatibility devices)
The system is coming up. Please wait.
Now the card is seen by the OS a a true qlogic card and the device tree
also reflects this fact - the FCode was key to the installation success of
this card (qla2310FC):
----------------------------------------------------------------------------
Host : ozzy1
Adapter Number : 0
Adapter Model : QLA2300/2310
Adapter Node Name : 20-00-00-E0-8B-10-C0-73
Adapter Port Name : 21-00-00-E0-8B-10-C0-73
Adapter Port ID : 64-02-00
Serial Number : K78208
Driver Version : 4.13.01
FCode Version : 2.00.05
Firmware Version : 3.2.15 IP
Device Target Count : 0
PortType (Topology) : NPort
Adapter Status : Online
----------------------------------------------------------------------------
I. Test Case with v480 :
------------------
- E15K domain wit S9U5
- SAN6.4 patches installed
- Crystal+ and Amber HBAs installed anc connected with T3+ storage array
- Qlogic qla2342 HBA (to be installed and directly connected with storage
array)
Installation Notes:
-------------
1. Verify that existing T3 LUNs are visible after installing the SAN 6.4
patches.
2. Install the qla2300 driver which came with the HBA (or you can download
it from QLogic website, as pointed by the accompabies document.
3. Look for 'qlc' entries in '/etc/driver_aliases' file. Cut and paste them
in the end
of the file, after qla2300 entries.
4. Set the 'auto-boot?' to 'False' via 'eeprom' command.
5. Halt the domain and power off the board.
6. Install the HBA on empty slots on IO Boards.
7. If needed, set the 'auto-boot?' to 'True' .
8. Reconfigure reboot the box via 'boot -r'
You should see the LUNs in format o/p. Now, you can configure them as
needed.
Further expansion
--------------
If a card of the same "type" is to be installed into the system (i.e.
qla2200 and qlc2200), then the configuration will be more involved.
The way the cards present themselves to the OS makes the OS think they are
one and the same type, thus they must be separated by manual intervention
(this is untested and only here for reference):
NOTE: if someday Sun updates to the next generation of qlogic chip sets
then a conflict could occur on the newer 2310 card from qlogic, however at
this time only the 2200 card will conflict because that is the current chip
set Sun is using.
File to edit (this could be different for different card types):
1) Remove the following entries from /etc/driver_aliases file
qla2200 "pci1077,2200"
qlc "pci1077,2200"
2) Add the following entries into /etc/driver_aliases file
qlc "SUNW,qlc"
qla2200 "QLGC,qla"
(space between first word and first double quote (qla2200 and "))
3) Install other 3rd party drivers as required (Qlogic, EMC or IBM
versions)
4) install card, boot -r
More information about the SunHELP
mailing list