C H A P T E R  2

Installing, Connecting, and Testing the HBA

This chapter describes how to install the Sun StorageTek PCI-X SAS 8-Channel HBA, test the installation, and boot from a disk drive connected to the HBA.

This chapter contains the following sections:


Observing ESD and Handling Precautions



caution icon

Caution - Damage to the HBA can occur as the result of careless handling or electrostatic discharge (ESD). Always handle the HBA with care to avoid damage to electrostatic sensitive components.



To minimize the possibility of ESD-related damage, Sun strongly recommends using both a workstation antistatic mat and an ESD wrist strap. You can get an ESD wrist strap from any reputable electronics store or from Sun as part number #250-1007. Observe the following precautions to avoid ESD-related problems:


Installing the HBA

Before you start, read the instructions in this section, as well as the installation instructions for the storage devices to be connected to the HBA.


procedure icon  To Prepare for Hardware Installation

1. Read and observe the safety information for this product.

See Safety Agency Compliance Statements.

2. Install the required patch for your OS as described in Downloading and Installing the Solaris OS Patches.

3. Install the SunVTS software on the host.

The SunVTS software is shipped on the Supplemental Software CD-ROM along with the Solaris OS CD-ROM. Read the user's guide listed in Before You Read This Book for instructions about installing the SunVTS software.

4. Exit the operating environment.

To inform any mounted users that the system will be going down, use the shutdown command. Otherwise, use the init 0 command. See the man pages or the Solaris documentation for more information about these commands.


# shutdown
...
ok

5. Power off the system.

For instructions, refer to the system documentation that came with your system.


procedure icon  To Unpack and Install the HBA

1. Unpack the box containing the HBA and inspect it for damage.



Note - Leave the HBA in the protective bag until you are ready to install it.



2. Turn off the system's power and physically remove the power cord(s) from the system.

3. Remove the cover from the system's chassis.

4. Disconnect the system from any networks.

5. Locate an empty PCI-X slot.

6. If the server chassis requires a standard height bracket, replace the low-profile bracket that is attached to the board with the standard height bracket.

Refer to the system's hardware documentation for information about mounting details (mounting holes, standoff locking and unlocking, and screws to secure the card).



caution icon

Caution - Damage to the HBA can occur as the result of careless handling or electrostatic discharge (ESD). See Observing ESD and Handling Precautionsfor more information.



7. Align the HBA to a PCI-X slot, and press down gently but firmly to seat the HBA in the slot.

FIGURE 2-1 illustrates how to insert the HBA in a PCI-X slot.


FIGURE 2-1 Installing the HBA into a PCI-X Slot

Figure shows installing the host adapter board into a PCI-X slot .


8. Install the bracket screw, when present, or engage the system's retention mechanism to secure the HBA to the system's chassis.

9. Replace the system's cover, and reconnect the power cord(s) and any network cables.

10. Power on the system.

11. Connect the mini-SAS cables between the HBA and the external storage or switch.



Note - The HBA contains two mini-SAS connectors. Each connector contains four PHYs enabling eight SAS lanes to connect to storage.



FIGURE 2-1 shows the location of the connectors on the HBA.


FIGURE 2-2 Connecting the Mini-SAS Cable to the HBA Connector

Figure shows the mini-SAS cable being connected to the SAS connector on the host adapter..


The HBA hardware installation is complete.


Testing the HBA Installation

To test the HBA installation in a Solaris environment, refer to the following sections:


procedure icon  To Test the Installation Using the SPARC OBP probe-scsi-all Command



Note - This procedure is not valid in a Solaris 10 for x64/x86 environment. Instead, use the format command to verify the installation of the HBA before attempting to use it in a Solaris 10 for x64/x86 environment. See To Test the Installation Using the Solaris format Command.



1. If you have disconnected the power cable, reconnect it.

2. Power on the connected storage device, and then power on the host.

3. Bring the system down to the ok prompt at run level 0.



Note - If the host starts to reboot, interrupt the reboot process by pressing the Stop and A keys simultaneously.



4. At the ok prompt, type the probe-scsi-all command to verify that the system recognizes the HBA.

The probe-scsi-all command displays the SCSI devices that are connected to the host, as shown in the following screen example.


ok probe-scsi-all
/pci@7c0/pci@0/pci@1/pci@0,2/LSILogic,sas@2
MPT Version 1.05, Firmware Version 1.06.00.00
Target 0
  Unit 0   Disk     FUJITSU MAY2073RCSUN72G 0401    143374738 Blocks, 73 GB
  SASAddress 500000e0118dd3e2  PhyNum 0
Target 1
  Unit 0   Disk     FUJITSU MAY2073RCSUN72G 0401    143374738 Blocks, 73 GB
  SASAddress 500000e0115c3ec2  PhyNum 1
 
/pci@780/pci@0/pci@8/LSILogic,sas@0
MPT Version 1.05, Firmware Version 1.18.00.00
Target 1
  Unit 0   Disk     SUN     LCSM100_S       9617    2048000 Blocks, 1048 MB
  Unit 1   Disk     SUN     LCSM100_S       9617    2457600 Blocks, 1258 MB
  SASAddress 500a0b82804a8008  PhyNum 0

This example shows two SAS controllers. The first (sas@2) is the SAS controller resident on the motherboard. The second SAS controller (sas@0) has one disk drive connected (Target 1). The disk consists of two logical unit numbers (LUNs), Unit 0 and Unit 1.


procedure icon  To Test the Installation Using the Solaris format Command

Use the following procedure to test the HBA installation using the format command on a Solaris 10 for x64/x86 platform.

1. Become a root user and type the format command.


# format
Searching for disks...done
AVAILABLE DISK SELECTIONS:
	0. c1t0d0 <DEFAULT cyl 24611 alt 2 hd 27 sec 107>
		/pci@0,0/pci1022,7450@a/pci17c2,10@4/sd@0,0
	1. c1t1d0 <DEFAULT cyl 24810 alt 2 hd 27 sec 107>
		/pci@0,0/pci1022,7450@a/pci17c2,10@4/sd@1,0
	2. c3t8d0 <DEFAULT cyl 24619 alt 2 hd 27 sec 107>
		/pci@0,0/pci1022,7450@b/pci1000,10c0@1,1/sd@8,0
	3. c3t9d0 <DEFAULT cyl 24619 alt 2 hd 27 sec 107>
		/pci@0,0/pci1022,7450@b/pci1000,10c0@1,1/sd@9,0
	4. c3t10d0 <DEFAULT cyl 24619 alt 2 hd 27 sec 107>
		/pci@0,0/pci1022,7450@b/pci1000,10c0@1,1/sd@a,0
	5. c3t11d0 <DEFAULT cyl 24619 alt 2 hd 27 sec 107>
		/pci@0,0/pci1022,7450@b/pci1000,10c0@1,1/sd@b,0
	6. c3t12d0 <DEFAULT cyl 24619 alt 2 hd 27 sec 107>
		/pci@0,0/pci1022,7450@b/pci1000,10c0@1,1/sd@c,0
	7. c3t13d0 <DEFAULT cyl 24619 alt 2 hd 27 sec 107>
		/pci@0,0/pci1022,7450@b/pci1000,10c0@1,1/sd@d,0
Specify disk (enter its number): 

2. When prompted, type the number of the disk drive that is attached to the HBA card you just installed and press Enter.


# format
Searching for disks...done
AVAILABLE DISK SELECTIONS:
	0. c1t0d0 <DEFAULT cyl 24611 alt 2 hd 27 sec 107>
		/pci@0,0/pci1022,7450@a/pci17c2,10@4/sd@0,0
	1. c1t1d0 <DEFAULT cyl 24810 alt 2 hd 27 sec 107>
		/pci@0,0/pci1022,7450@a/pci17c2,10@4/sd@1,0
	2. c3t8d0 <DEFAULT cyl 24619 alt 2 hd 27 sec 107>
		/pci@0,0/pci1022,7450@b/pci1000,10c0@1,1/sd@8,0
	3. c3t9d0 <DEFAULT cyl 24619 alt 2 hd 27 sec 107>
		/pci@0,0/pci1022,7450@b/pci1000,10c0@1,1/sd@9,0
	4. c3t10d0 <DEFAULT cyl 24619 alt 2 hd 27 sec 107>
		/pci@0,0/pci1022,7450@b/pci1000,10c0@1,1/sd@a,0
	5. c3t11d0 <DEFAULT cyl 24619 alt 2 hd 27 sec 107>
		/pci@0,0/pci1022,7450@b/pci1000,10c0@1,1/sd@b,0
	6. c3t12d0 <DEFAULT cyl 24619 alt 2 hd 27 sec 107>
		/pci@0,0/pci1022,7450@b/pci1000,10c0@1,1/sd@c,0
	7. c3t13d0 <DEFAULT cyl 24619 alt 2 hd 27 sec 107>
		/pci@0,0/pci1022,7450@b/pci1000,10c0@1,1/sd@d,0
Specify disk (enter its number): 2
selecting c3t8d0
[disk formatted]

The Format menu is displayed.

3. Type analyze to select the type of test.


FORMAT MENU:
	disk	- select a disk
	type	- select (define) a disk type
	partition	- select (define) a partition table
	current	- describe the current disk
	format	- format and analyze the disk
	fdisk	- run the fdisk program
	repair	- repair a defective sector
	label	- write label to the disk
	analyze	- surface analysis
	defect	- defect list management
	backup	- search for backup labels
	verify	- read and display labels
	save	- save new disk/partition definitions
	inquiry	- show vendor, product and revision
	scsi	- independent SCSI mode selects
	cache	- enable, disable or query SCSI disk cache
	volname	- set 8-character volume name
	!<cmd>	- execute <cmd>, then return
	quit
format> analyze

4. Type read to further define the type of test, and then type y to continue.


ANALYZE MENU:
	read	- read only test (doesn't harm SunOS)
	refresh	- read then write (doesn't harm data)
	test	- pattern testing (doesn't harm data)
	write	- write then read (corrupts data)
	compare	- write, read, compare (corrupts data)
	purge	- write, read, write (corrupts data)
	verify	- write entire disk, then verify (corrupts data)
	print	- display data buffer
	setup	- set analysis parameters
	config	- show analysis parameters
	!<cmd>	- execute <cmd> , then return
	quit
analyze> read
Ready to analyze (won't harm SunOS). This takes a long time, 
but is interruptable with CTRL-C. Continue? y
pass 1
   
Total of 0 defective blocks repaired.
analyze>

5. Verify that no error occurred, as indicated by the output line Total of 0 defective blocks repaired.

Contact your service provider if an error occurs.

6. Type q twice to quit the test and the Format menu.


analyze> q
FORMAT MENU:
	 disk	 - select a disk
	 type	 - select (define) a disk type
	 partition	 - select (define) a partition table
	 current	 - describe the current disk
	 format	 - format and analyze the disk
	 fdisk	 - run the fdisk program
	 repair	 - repair a defective sector
	 label	 - write label to the disk
	 analyze	 - surface analysis
	 defect	 - defect list management
	 backup	 - search for backup labels
	 verify	 - read and display labels
	 save	 - save new disk/partition definitions
	 inquiry	 - show vendor, product and revision
	 scsi	 - independent SCSI mode selects
	 cache	 - enable, disable or query SCSI disk cache
	 volname	 - set 8-character volume name
	 !<cmd>	 - execute <cmd>, then return
	 quit
format> q
# 

Your Sun StorageTek PCI-X 8-Channel SAS HBA is ready for use.


procedure icon  To Test the Installation Using the SunVTS Software

Use the SunVTS software to test a disk on a newly attached disk array to verify that the HBA is properly installed.

For details about running the SunVTS software, refer to the SunVTS 6.X User's Guide and the SunVTS 6.X Test Reference Manual.



Note - Refer to the SunVTS documentation to determine whether the host platform is supported.



1. As superuser, open the SunVTS window.


# /opt/SUNWvts/bin/sunvts

2. From the System Map, select a disk drive that is in an array that is connected to the HBA.

3. Start the disk test.

4. Verify that no errors have occurred by checking the SunVTS status window.

If problems occur, contact your service provider for assistance.

5. If no problems occur, stop the SunVTS software.

Your HBA is now ready to run applications.


Booting Through the HBA

The Sun StorageTek PCI-X 8-Channel SAS HBA uses the Solaris mpt device driver, which is included in the Solaris 10 (SPARC or x64/x86) OS.

After booting, install any required patches for the mpt driver. Refer to Installing the HBA Software for instructions on downloading and installing mpt driver patches.


procedure icon  To Boot an x86 Server From an External Disk Drive

1. Initiate a system boot.

The BIOS initialization screen is displayed.

2. Immediately press Control-C.

The LSI Logic Config Utility menu is displayed.


In this example, the first line (SAS1064) is the SAS controller that is resident on the motherboard. The HBA (SAS1068) is installed in PCI-X slot 01.

3. To change the boot options, use the arrow keys to move the grey highlighted field to the Boot Order field and use the following keys.


Key

Function

Insert

Enable booting

Del

Disable booting

Plus (+)

Increase the numeric value to change the boot order

Minus (-)

Decrease the numeric value to change the boot order


4. To change other options, move the grey highlighted field to the appropriate HBA, and press Enter.

Details for the selected adapter are displayed, as shown in the following example.


5. To view the devices attached to this adapter, highlight SAS Topology and press Return.

The following screen is displayed.


In this example, a single SAS RAID array is attached to the adapter. The array has four bonded PHYs.

6. To exit this screen, press the Escape key.

7. Use the arrow key to highlight Exit the Configuration Utility and press Enter.


Saving global properties...
Global properties saved. Hit any key to reboot.

8. Press any key to reboot the system.