苹果阵列Serv安装文档(原文)

Apple Fibre Channel PCI Card, Xserve RAID on Sun Solaris

Friday, August 29 2003 @ 12:31 PM CDT

Contributed by: das

Using the Apple Fibre Channel PCI Card (HBA) in Sun SPARC hardware and setup under Solaris for use with Xserve RAID

Quick setup
(see Detailed Instructions if this is not enough)

1. Get latest drivers from LSI Logic (ITImpt and LSIutils)

2. Ensure that SUNWssad and SUNWssadx are installed as part of OS (The are SSA drivers, Solaris 2.6 only need one package: SUNWssadv) (not documented by LSI Logic)

3. Install ITImpt. If driver didn抰 attach properly, may need to reboot (see messages from pkgadd for clues, reboot if unsure).

4. Solaris 8 + use devfsadm to rebuid device links. Solaris 2.6 and 7 use drvconfig ; disks, however the driver may not attach without a reboot, so "reboot -- -r" for Solaris 2.7 and 7...

5. Should be able to label the new volume using format utility and start using it. Volumes larger than 1TB in size need to be labeled manually by entering required information into format utility. Solaris 9 4/03 addresses this issue with patch 114389-01. Earlier versions of Solaris 9 can be patched with this patch.

Detailed instructions

1. Download drivers from the LSI Logic Download Center:

Select product as "LSIFC929 ?[2Ghz/2CH]"

Select "All files types" and click on "Next >"

In the green table click on "Solaris SPARC" (at time of writing, the current version is 5.04.00 2/24/2003)

Download file is itmpt-5.04.00.zip and is about 359KB.

You may also download the file from alienraid.org.


2. Prepare the system for driver installation

Install the HBA as directed in the supplied documentation. The documentation uses show-devs command to determine if the card is installed correctly. You may follow these instructions, but I found that E250 with OBP 3.26 did not show the card with show-devs, so don't fully trust this method if the card doesn't show there.

I suggest to boot the system and run the following command:

/usr/platform/`uname -i `/sbin/prtdiag

(note that `uname 杋` is expanded by shell as something like "sun4u", so don't look for "`uname 杋`" directory in /usr/platform)

This will output some text. Look at the section which is titiled "IO Cards". You should see "LSI,929" in the "Model" column. If it is not there, you really have a problem with the card installation.

Once the card is there and can be seen by Solaris, check is SUNWssadv package is installed:

pkginfo SUNWssadv (Solaris 2.6)

or

pkginfo SUNWssad SUNWssadx (Solaris 9)

The output should suggest whether the packages are installed.

These packages are installed automatically by Solaris installation program is "Full Distribution" or "Full Distribution + OEM Support" software clusters are selected at install time. If any other software cluster was chosen at install time, then these packages have to be installed manually. Locate them on the Solaris CD Disk 1 of 1 in the s0/Solaris_X/Product directory and change your current directory to it, e.g:

cd /cdrom/cdrom0/s0/Solaris_9/Product

Install the packages by executing

pkgadd 杁 . SUNWssad SUNWssadx

This command returns a verbose output and will possibly ask to say "yes" to installation to go ahead. Once completed, it should return a message that the package(s) were installed successfully. Note that this package dependency is not mentioned in the driver documentation.


3. Install driver and LSI utilities programs

Unzip everything that was shipped in the itmpt-5.04.00.zip file. If you want to install LSI utilities (recommended), uncompress lsiutils_v40.tar.Z file. Change to "install" directory.

cd install

Amongst other files, you will see ITImpt and LSIutils directories. Execute command

pkgadd -d . ITImpt LSIutils

(don't need to install LSIutils if LSI utilities are not required). This will install the HBA driver and configure it for up to 15 targets. See documentation for the driver to customize driver configuration. Don't change the defaults unless necessary.


4. Finally...

We need Solaris to start seeing the devices behind the controller. To do this wee need to rebuild device trees in /devices and /dev directories. The simplest way to do it on any version of Solaris is to reboot the system with "reconfigure" option, e.g.

reboot -- -r

(this is equivalent to "boot 杛" at OBP or "touch /reconfigure ; reboot" or...)

Solaris 9 (and may be 8) can get away without the reboot by executing "defvsadm". Solaris 2.6 almost always need to be rebooted because I noticed that the LSI driver loads, but fails to attach, so reboot is required. So if unsure... reboot.

At this stage you should see the Xserve RAID within the "format" command, which is identified as . Note, that format will see the LUNs, not the individual disks. It cannot see the individual disks because they are hidden behind the RAID controller.

If the Xserve RAID does not have defined LUN(s), it (they) need to be created using RAID Admin utility. The utility can be run from any computer, which can see the network interface of the Xserve RAID. On Solaris the utility can be launched by executing

java 杍ar RAID_Admin.jar

from a terminal window when you are in the graphical session (CDE, Gnome, Open Windows). The "jar" can be found inside the "RAID Admin.app" package for Mac OS X. See RAID Admin on Alternate Platforms for details.

If the volume needs to be over 1TB in size (e.g. the default fully populated Xserve RAID configuration), versions of Solaris prior to Solaris 9 4/03 will not recognize disk label format. In this case the choices are:

• Install patch 114389-01 (for Solaris 9 only)
• Manually label the volume by entering required information in the Solaris' format utility
• Use volumes less than 1TB in size
  At time of writing the required Solaris 9 patch is only available to Sun customers who have service support contracts. It can be obtained by logging a support call with Sun.