Installing, Connecting, and Testing the Host Bus Adapter

This guide describes how to install and configure your new Sun StorEdge Enterprisetrademark 2 Gb FC Single and Dual Port Host Bus Adapter (HBA) in three simple steps.



caution icon

Caution - Keep the Sun StorEdge Enterprise 2 Gb FC Single and Dual Port HBA in the antistatic bag until installation. The Sun StorEdge Enterprise 2 Gb FC Single and Dual Port HBA contains parts that can be damaged by electrostatic discharge (ESD). Before handling the HBA, use standard methods to discharge static electricity. Place the HBA on the bag when examining it. Retain the bag for future use.



This chapter contains the following topics:


System Requirements

Your system must have the following functionality to support the Sun StorEdge Enterprise 2 Gb FC Single and Dual Port HBA:


Installing the HBA

Follow these steps to install the Sun StorEdge Enterprise 2 Gb FC Single and Dual Port HBA in your system:


procedure icon  To Verify the Packaging Contents

single-step bulletVerify that the Sun StorEdge Enterprise 2 Gb FC Single and Dual Port HBA is shipped with the following items (see FIGURE 1):


FIGURE 1 HBA Packaging Contents



procedure icon  To Install the HBA Hardware

To install the Sun StorEdge Enterprise 2 Gb FC Single and Dual Port HBA, you need to open the computer and identify an empty PCI slot (32-bit or 64-bit). If necessary, consult your computer system manual for instructions to remove the computer cover.



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:

1. Record IEEE and serial numbers.

Each HBA is shipped with a unique 64-bit identifier called the IEEE address. The Fibre Channel industry uses a World Wide Name (WWN) derived from the IEEE address, and this number is needed for Fibre Channel connectivity. Because the
SG-XPCI2FC-EM2 HBA has two ports, it has two IEEE addresses. The IEEE address is used when configuring your system. The serial number is used when communicating with Sun. All numbers are clearly marked on the board. Record these numbers before installation.

2. Shut down, power off, and unplug the computer.

3. Remove the computer case.



Note - For best I/O performance, place the adapter into an empty PCI-X slot that is running at 133 MHz. Ensure that the PCI bus is not shared with another PCI card that can lower the PCI slot clock rate.



4. Remove the blank panel from an empty PCI or PCI-X bus slot.

5. Optionally, perform the following steps to replace the PCI bracket.



Note - The HBA comes with a standard PCI bracket installed. A low-profile mounting bracket is shorter than the standard bracket, approximately 3.11 in.
(7.9 cm) compared to 4.75 in. (12.06 cm) long, and is provided with each X-option.




a. Remove the mounting bracket screws from the HBA (see FIGURE 2). FIGURE 2 Removing the bracket

b. Remove the bracket and store it for future use.

c. Align the new mounting bracket tabs with the holes in the HBA.



Note - Be careful not to push the bracket past the transceiver housing's grounding tabs.
Make sure the LEDs are properly aligned with the holes in the bracket.



d. Replace the screws that attach the HBA to the bracket.

6. Insert the HBA into the empty 32-bit or 64-bit PCI or PCI-X bus slot. Press firmly until the adapter is seated.

7. Secure the HBA's mounting bracket to the case with the panel screw or clip.

8. Replace the computer case and tighten case screws.

The HBA is now installed in the computer and is ready for the optical cable attachment.


procedure icon  To Attach the Optical Cable



Note - The HBA will not allow normal data transmission on an optical link unless it is connected to another similar or compatible laser product (that is, multimode to multimode).



Use multimode fiber-optic cable, with short-wave lasers, that adheres to the following specifications:


TABLE 1 Optical Cable Specifications

Fiber-Optic Cable

Maximum Length

Minimum Length

Connector

62.5/125 mu symbolm (multimode)

300 meters at 1.0625 Gb/s

150 meters at 2.125 Gb/s

2 meters

LC

50/125 mu symbolm (multimode)

500 meters at 1.0625 Gb/s

300 meters at 2.125 Gb/s

2 meters

LC



1. Connect the fiber-optic cable to an LC connector on the HBA (see FIGURE 3). FIGURE 3 Attaching the Optical Cable

2. Connect the other end of the cable to the Fibre Channel device.

After the optical cable is connected to the HBA, you are ready to apply power to the computer.


procedure icon  To Apply Power

1. Verify that the HBA is securely installed in the computer.

2. Verify that the correct optical cable is attached.

3. Plug in and power on the computer.

4. Observe light-emitting diodes (LEDs) for Power-On-Self Test (POST) results.


Green and amber LEDs can be seen through openings in the HBA's mounting bracket. Green indicates power and amber signifies port activity. Each port has a corresponding set of green and amber LEDs (see FIGURE 4). FIGURE 4 POST LEDs

POST conditions and results are summarized in TABLE 2.


TABLE 2 POST Conditions

Yellow LED

Green LED

State

OFF

OFF

Wake-up failure (dead board). Check the 3.3V LED near the top edge of the HBA (component side). If this LED is lit, the slot is providing 3.3V power.

ON

OFF

POST failure (dead board)

Slow blink (1Hz)

OFF

Wake-up failure (dead board)

Fast blink (4Hz)

OFF

Failure in POST (dead board)

Flashing (irregular)

OFF

POST processing in progress

OFF

ON

Failure while functioning

ON

ON

Failure while functioning

Slow blink

ON

Normal operating condition - 1-GHz link rate

Fast blink

ON

Normal operating condition - 2-GHz link rate

OFF

Slow blink

Normal - link down or not yet started

Slow blink

Slow blink

Offline for download

Fast blink

Slow blink

Restricted offline mode (waiting for restart)

Flashing

Slow blink

Restricted offline mode, test active



*An LED is located near the top edge of the board. This LED indicates 3.3V power. FIGURE 5 Power LED

procedure icon  To Verify Proper Installation in SPARC Platforms

1. Enter the show-devs command at the ok prompt to list the installed devices.

The HBA can be identified in the output containing "SUNW,emlxs@N"and "SUNW,emlxs@N,1" node names, where N is usually a single digit number from 1 to 9.

In the following output sample, there are two Dual Channel SG-XPCI2FCEM2 adapters installed.


{1} ok show-devs/pci@9,600000/pci@9,700000/pci@8,600000/pci@8,700000/memory-controller@3,400000/SUNW,UltraSPARC-III@3,0/memory-controller@2,400000/SUNW,UltraSPARC-III@2,0/memory-controller@1,400000/SUNW,UltraSPARC-III@1,0/memory-controller@0,400000/SUNW,UltraSPARC-III@0,0/virtual-memory/memory@m0,a0/aliases/options/openprom/chosen/packages/pci@9,600000/SUNW,jfca@2,1/pci@9,600000/SUNW,jfca@2/pci@9,600000/SUNW,emlxs@1,1/pci@9,600000/SUNW,emlxs@1 /pci@9,600000/SUNW,jfca@2,1/fp@0,0/pci@9,600000/SUNW,jfca@2,1/fp@0,0/disk/pci@9,600000/SUNW,jfca@2/fp@0,0/pci@9,600000/SUNW,jfca@2/fp@0,0/disk/pci@9,600000/SUNW,emlxs@1,1/fp@0,0/pci@9,600000/SUNW,emlxs@1,1/fp@0,0/disk/pci@9,600000/SUNW,emlxs@1/fp@0,0/pci@9,600000/SUNW,emlxs@1/fp@0,0/disk/pci@9,700000/SUNW,emlxs@4,1/pci@9,700000/SUNW,emlxs@4/pci@9,700000/usb@1,3/pci@9,700000/network@1,1/pci@9,700000/ebus@1/pci@9,700000/SUNW,emlxs@4,1/fp@0,0/pci@9,700000/SUNW,emlxs@4,1/fp@0,0/disk/pci@9,700000/SUNW,emlxs@4/fp@0,0/pci@9,700000/SUNW,emlxs@4/fp@0,0/disk/pci@9,700000/ebus@1/serial@1,400000


procedure icon  To Verify Attached Storage to the Installed HBA

If online storage is connected to the HBA, use the apply show-children command to list the storage attached.

In the following example, a storage array with two LUNs is attached to one port of the dual ported HBA.


{3} ok apply show-children /pci@9,600000/SUNW,emlxs@1
Target none  ALPA a7  WWPN 216000c0ff802294
LUN  0     Disk     SUN     StorEdge 3510   411GLUN  1     Disk     SUN     StorEdge 3510   411G
{3} ok 
 



Note - A reset-all command may be required before entering the apply show-children command.




procedure icon  To Verify Proper Installation in BIOS Based Systems

single-step bulletFollow the instructions in the BIOS documentation provided with your system.


Installing the HBA Driver

After you have completed the hardware installation and powered on the computer, follow the instructions listed for your operating system.

This section contains the following topics:

Sun Solaris Operating Systems for SPARC Platforms

This HBA is supported by the Solaris 8, Solaris 9, and Solaris 10 Operating Systems. The drivers for this HBA are delivered as unbundled packages and patches.

For Solaris 8 and Solaris 9, these packages and patches are bundled as a script posted in the Sun Download Center (SDLC).


procedure icon  To Download the Packages and Patches for Solaris 8 and Solaris 9

You have two choices to install packages and patches for Solaris 8 and Solaris 9. To use the install_it script, see install_it Script Installation. To install the packages and patches manually, see Manual Installation.

install_it Script Installation

The packages and patches are available in the Sun Download Center (SDLC).

1. Go to http://www.sun.com/storage/san.

The Storage Area Networks (SAN) page is displayed.

2. Scroll to the bottom of the page and under Get the Software, click the "Sun StorEdge SAN 4.4 release Software/Firmware Upgrades and Documentation" link.

If you are not already logged in, the Login page is displayed.

3. Enter your Username and Password and click Login.

If you have not already registered, click Register Now before proceeding.

4. Accept the License Agreement.

The Download page is now available.

5. Locate and click the download file:

Install_it Script, SAN 4.4.x, Readme, English, and print the instructions.

6. Locate and click the download file:

Install_it Script, SAN 4.4.7, English

You will be prompted for a download directory. It is suggested that you download the packages to your /tmp directory.

7. Unzip the downloaded file.

8. Locate the executable file "install_it" and run it.

The necessary packages and patches are now installed.

Consult the most recent revision of the Sun StorEdge Enterprise 2 Gb FC Single and Dual Port Host Bus Adapter Release Notes (part number 819-2541-11) for the latest updates.

9. Reboot the system after installing all patches.

This completes the driver installation.

Manual Installation

Optionally, For Solaris 8 and Solaris 9, if you do not want to use the install_it script, install the driver by adding the following packages and then patches.

Packages

The packages are available in the Sun Download Center (SDLC).

1. Go to http://www.sun.com/storage/san.

The Storage Area Networks (SAN) page is displayed.

2. Scroll to the bottom of the page and under Get the Software, click the "Sun StorEdge SAN 4.4 release Software/Firmware Upgrades and Documentation" link.

If you are not already logged in, the Login page is displayed.

3. Enter your Username and Password and click Login.

If you have not already registered, click Register Now before proceeding.

4. Accept the License Agreement.

The Download page is now available.

5. Locate and click the appropriate download file:

6. Provide the path to a directory location for the download file.

7. Follow the Readme instructions to install the packages.

The following package names are contained in both Solaris 8 and Solaris 9 downloads files and must be installed in the order given below.

Patches

Perform the following steps to download the Solaris 8 and 9 patches.

1. Go to http://sunsolve.sun.com.

The SunSolve Online license agreement page is displayed.

2. Accept the License Agreement.

The SunSolve Online page is displayed.

3. Under Patches and Updates, click PatchFinder.

4. Download the appropriate patches for your system from TABLE 3 by typing each patch ID (one at a time, and without the dash number) in the Enter Patch ID box and click Find Patch.


TABLE 3 SAN Foundation Software (SFS) Version 4.4.7 Patch IDs

Patch Type

Solaris 8 Patch Number

Solaris 9 Patch Number

fctl/fp/fcp

111095-25

113040-16

fcip

111096-13

113041-10

qlc

111097-20

113042-12

MPxIO

111412-18

113039-10

luxadm

111413-18

113043-12

cfgadm

111846-08

113044-05

FCSM driver

114475-05

114476-05

SUNWsan

111847-08

111847-08

FC HBA API Lib

113766-02

114477-01

SNIA FC HBA Lib

113767-08

114478-07

JNI FC HBA

114877-10

114878-10

Emulex FC HBA

119913-05

119914-05


5. Follow the instructions to install each patch.

6. Reboot your system after installing all the patches.


procedure icon  To Download the Packages and Patches for the Solaris 10 Operating System

There is no install_it script available to install the drivers for Solaris 10.



Note - The packages and patches must be installed in the order given.



Sun Solaris 10 Operating System for Sun Sparc Platforms

You must first install Sun Solaris 10 OS for x64/x86 platforms.

Packages

Perform the following steps to download the Solaris 10 packages.

1. Go to http://www.sun.com/download/products.xml?id=42c4317d

The Products Download page is displayed.

2. Under Platform, click Download.

The Login menu is displayed.

3. Type your Username and Password and click Login.

The Download page is displayed with two items available in the table.


Description

File Name

Solaris 10 Sun StorEdge Enterprise 2Gb FC Single and Dual Port HBA, English

s10_emlxs_pkgs.tar.Z

Sun StorEdge Enterprise 2Gb FC Single and Dual Port Host Adapter README file, English

README_s10_emlxs_pkgs.txt


4. Read the license agreement and accept or decline.

5. Click the first item and provide the path to a directory location.

The following packages are contained in the zipped file:

6. Click the second item and print these driver README installation instructions.

7. Follow the README instructions.

Patches

Perform the following steps to download the Solaris 10 patches.

1. Go to http://sunsolve.sun.com.

The SunSolve Online license agreement page is displayed.

2. Accept the License Agreement.

The SunSolve Online page is displayed.

3. Under Patches and Updates, click PatchFinder.

4. Download the following patches by typing each patch ID (one at a time, and without the dash number) in the Enter Patch ID box and click Find Patch.

5. Follow the instructions to install each patch.

6. Reboot your system after installing the patches.

Sun Solaris 10 Operating System for x64/x86 Platforms

Install the Sun Solaris 10 x64/x86 Operating System (patches) per the documentation that is included with your system.

1. Go to http://sunsolve.sun.com.

The SunSolve Online license agreement page is displayed.

2. Accept the License Agreement.

The SunSolve Online page is displayed.

3. Under Patches and Updates, click PatchFinder.

4. Download the following patches (drivers) by typing each patch ID (one at a time, and without the dash number) in the Enter Patch ID box and click Find Patch.

5. Follow the instructions to install each patch.

6. Reboot your system.

Known Issues

Booting from a disk attached to the Sun StorEdge Enterprise 2 Gb FC Single and Dual Port HBA is not supported in Solaris x64/x86 environments.

Diagnostic Support

Diagnostic support for the Sun StorEdge Enterprise 2 Gb FC Single and Dual Port HBA is available with SunVTS software, and the required patches listed in the following table.


TABLE 4 Required Patches

Patch Number

Operating System

SunVTS

120175-02

Solaris 8 SPARC

5.1

119837-03

Solaris 9 SPARC

5.1

119838-03

Solaris 10 SPARC

6.0

119839-03

Solaris 10 x64/x86

6.0


Install SunVTS 6.0 software per instructions from your Solaris distributor.

Red Hat Enterprise Linux 3 and 4, and SuSE Linux Enterprise Server 8 and 9

The Red Hat Enterprise Linux (RHEL) 3 and 4 and the SuSE Linux Enterprise Server (SLES) 8 and 9 operating systems are supported on the Sun StorEdge Enterprise 2 Gb FC Single and Dual Port HBA. Before installing the drivers for Linux, you must have the relevant Linux OS installed on your hard disk. The driver and utilities are available for download at the Emulex web page dedicated to Sun products, the driver as a .gz package and the utilities as a .tar file. The installation documentation is available from the same page as the driver and utilities.


procedure icon  To Download and Install the SuSE and Red Hat HBA Driver and Utilities

1. Go to http://www.emulex.com/ts/docoem/framsun/10k.htm.

The download page for SG-XPCI1FC-EM2 and SG-XPCI2FC-EM2 will appear.

2. Locate the Drivers for Linux section and click the link in the Download column for the driver for Linux.

3. Download the driver and applications kits to a local drive.

Click the Driver Kit Download button. After the driver is downloaded, click the Applications Kit Download button.

4. Open the Installation manual by clicking the link to it, and locate and follow the instructions for installing the driver and utilities.

To create a Linux boot disk, see Creating a Linux Boot Disk.

Diagnostic Support

Diagnostic support is provided by the Emulex lputil utility. It supports the following functions:

Details are provided in the View HBA Information using lputil section of the Emulex Driver manual.


procedure icon  To Verify the Installation

Follow the instructions provided in the "View HBA Information using lputil" section of the Emulex Driver manual.

Windows 2000 or Windows Server 2003 Systems

The Windows® 2000 and Windows Server 2003 operating systems are supported on the Sun StorEdge Enterprise 2 Gb FC Single and Dual Port HBA. Before installing the drivers for Windows, you must have the relevant Windows OS installed on your hard disk. The driver kit, which includes utilities, is available for download as a self-extracting .exe file at the Emulex web page dedicated to Sun products. The installation documentation is available from the same page as the driver kit.

SCSIport Miniport driver supports the 32bit Windows 2000 and Windows Server 2003 only. The Storport Miniport driver can run on 32bit and 64bit Windows Server 2003.


procedure icon  To Download and Install the Windows HBA Driver Kit

1. Go to http://www.emulex.com/ts/docoem/framsun/10k.htm.

The download page for SG-XPCI1FC-EM2 and SG-XPCI2FC-EM2 will appear.

2. Locate the Drivers for Windows section, locate the driver you want to install, and click the link in the Download column for the appropriate driver.

3. Download the driver kit (including utilities) to a local drive.

Click the Download button.

4. Open the Installation manual by clicking the link to it, and locate and follow the instructions for installing the driver and utilities.

To create a Windows boot disk, see Creating a Windows Boot Disk.

Diagnostic Support

Diagnostic support is provided by the Emulex lputil utility. It supports the following functions:

Details are provided in the View HBA Information using lputil section of the Emulex Driver manual.


procedure icon  To Verify the Installation

Follow the instructions provided in the "View HBA Information using lputil" section of the Emulex Driver manual.


Booting through the Host Bus Adapter for a Solaris Operating System



Note - The procedures in this section only apply to SPARC® architectures, not to x64/x86 environments. These procedures are necessary if the HBA driver is not bundled with the Solaris OS on the boot server on the network. Check your Solaris OS to determine whether the driver is bundled with it.



Booting from the network adapter requires special procedures to enable detection of installation devices. To boot from the small kernel image on the host adapter, you must use a boot/install server or a temporary directly connected boot disk. The method using a boot/install server is the Net Install Patching method. The method using a directly-connected boot disk is the Dump and Restore method. Both procedures should be performed by a knowledgeable UNIX system administrator.



Note - The procedure is identical whether you are using a boot server or an install server.[1] Therefore, the convention used in this chapter is to refer to either type of server as the "boot/install server."



The two methods are explained in the following sections:

The Dump and Restore method is more difficult than the Net Install Patching method and you might experience complications in the loss of the boot. However, this method is available to anyone with existing systems, whether small or large configurations, and it provides a disk image when you have completed the process.

The Net Install Patching method requires a jump-start server and network connectivity, and it is more suitable for large system configurations than for small ones. This method is easier than the Dump and Restore method and mitigates the risk of data loss.

Net Install Patching Method

The topics in this section include:

The procedures in this section explain how to install the Solaris OS from a boot/install server onto the host with the host adapter. Any other host on the same subnet can be set up as a boot/install server.

Overview of the Net Install Method

Installing a client from a boot/install server uses two images of the Solaris OS:

This procedure assumes you know how to install Solaris software over the network as described in the Solaris installation manuals. For more information, see the man(1) pages for the commands that are used in this procedure.



Note - While you are setting up the boot/install server, you must either have the contents of the Solaris installation CD-ROM copied to a disk that is directly connected to the boot/install server or have the Solaris installation CD inserted and mounted from an attached CD-ROM device.



You need to enable booting using a boot/install server to make both images aware of the host adapter. At the start of the procedure, the system administrator downloads the driver and all required patches to an exported directory on the boot/install server.

The following steps explain the process. For the actual procedures, see To Set Up the Boot/Install Server.

1. The boot image is copied from a Solaris CD-ROM or from a network location onto a disk that is attached to a boot/install server.

2. The driver package is added to the boot image.

You add the driver package to the boot image so that the boot/install server can then send and receive data through the host adapter on the boot client.

3. The client boots from the boot/install server, the interactive suninstall(1M) starts, and the system administrator provides configuration information requested at the prompts.

4. After the system administrator provides all of the configuration information requested by the installation program, the installation of the Solaris OS begins.

5. The install image is copied to the client.

6. Before a reboot, while the client is still booted from the boot image miniroot, the driver and any needed patches are copied from the boot/install server and then installed in the install image.

You install the driver package and patch the install image so that the host can see the host adapter after a reboot.



Note - You cannot jump start until you modify the install image.



7. The host boots from the boot disk through the host adapter.


procedure icon  To Set Up the Boot/Install Server

1. Switch users to root on the host to be used as the boot/install server.


% su
Password:
#

2. Use the setup_install_server(1M) command from the Tools directory in the location where the Solaris software resides.

As shown in the following screen example, the setup_install_server command copies the boot image to a directory on the boot/install server. The boot directory is named /boot_dir /<original_OS_dir>/Boot in the example. The example shows the command being run from the Tools directory on a mounted Solaris 8 installation CD-ROM.


# cd /cdrom/cdrom0/s0/Solaris_8/Tools/Boot
# ./setup_install_server -t /<original_OS_dir>/Boot /<new_OS_copy_dir>

3. Download the driver packages and the accompanying README file from Sun's download center into the /<export_public> directory on the boot/install server.

a. Go to the download center URL specified in the instructions on how to download the network adapter driver in the product notes.

b. Download the README file.

c. Remove any previously installed packages for this network adapter as instructed in the README file.

d. Download the packages as described in the instructions in Installing the HBA Driver.

e. Use the uncompress(1M) and tar(1M) commands to uncompress and expand the packages in the driver tar file.



caution icon

Caution - Do not use the pkgadd(1M) command line that is given in the READMEto install the packages. See To Modify the Boot Imageto install relocatable versions of the packages.



4. Download the required patches and the accompanying README files from sunsolve.sun.com into the /<export_public> directory on the boot/install server.

a. Go to http://www.sunsolve.sun.com and locate the patches.

b. Download the README file.

c. Remove any related previously installed patches that may be specified in the README file.

d. Download the patches as described in the instructions.

e. Use the uncompress(1M) and tar(1M) commands to uncompress and expand the patches in the tar file, as instructed in the README.



caution icon

Caution - Do not use the patchadd(1M) command line that is given in the READMEfile to install the patches. See the following "To Modify the Boot Image" section to install relocatable versions of the patches.




procedure icon  To Modify the Boot Image

1. Install the driver packages into the boot image.

The following example installs all packages previously downloaded into the /<export_public> directory.



Note - Refer to the install_order file for the proper order in which to install the packages. You must follow this order for a successful installation so that the driver will run.




# cd /<export_public>
# pkgadd -R /<new_OS_copy_dir>/Tools/Boot -d .

2. Install any needed patches into the boot image.

The following example installs any patches that were previously downloaded into the /<export_public> directory. Repeat the patchadd command for each patch you need to add.


# cd /<export_public>
# patchadd -C /<new_OS_copy_dir>/Tools/Boot -M /<export_public> <patch_ID>

3. Make sure the host name, its IP address, and its Ethernet address have been added to the name service (/etc files, NIS, or NIS+).

4. Run the add_install_client(1M) command to add the host with the host adapter as a boot/install client.

The example shows the add_install_client command followed by the name of the host followed by its platform name.


# add_install_client <host_name> <platform_name>



Note - You can find the platform name by running the uname command with the -m option on the host that has the host adapter.



5. Log out of the boot/install server.


procedure icon  To Set Up the Client

1. Bring the client host with the host adapter down to the ok prompt at run level 0.

See the Solaris system administration documentation for the commands that can be used with different configurations. The following example uses the shutdown(1M) command.


# shutdown
...
ok



caution icon

Caution - Do not reboot the boot/install server.



2. Boot the host from the net.


ok boot net

The Solaris interactive installation program runs from the boot/install server.

3. Respond to the prompts according to your configuration, as instructed in the Solaris installation guide.

Make sure to specify the new boot disk as the destination for the operating environment installation.

4. When prompted to choose between automatic reboot or manual reboot, click the Manual Reboot button, complete the remaining question, and start the installation.

The question offering a choice between automatic and manual reboot is the last question before the installation starts. If you are using the suninstall program, choose boot manual.

5. Mount the /<export_public> directory which contains the driver packages and any needed patches onto the /mnt directory mount point.

Enter the mount command followed by the hostname of the boot/install server, followed by a colon (:), followed by /<export_public>, followed by /mnt. The following example uses boot_install_server as the name of the boot/install server.


# mount boot_install_server:/<export_public> /a/mnt

6. Install the driver packages into the install image.

The following example installs all packages previously downloaded into the
/<export_public> directory. When prompted, install the packages in the order of SUNWemlxs, SUNWemlxsx, SUNWemlxu, SUNWemlxux.


# cd /a/mnt
# pkgadd -R /a -d .

7. Install any needed patches into the boot image.

The following example installs all patches that were previously downloaded into the /<export_public> directory.



Note - Install the patches in their sequential numeric order to ensure the installation is successful.




# cd /a/mnt
# patchadd -R /a <patch_ID>

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


# halt

9. Reboot the host from the newly installed operating environment.


ok boot -r 

Dump and Restore Method

The topics in this section include:

Overview of the Dump and Restore Method

To enable booting using an active boot disk, a boot disk must be directly connected, at least temporarily, to the host. The disk must have the following installed:

See the Installing the HBA Driver for information on how to download and install the driver packages and any needed patches.



Note - The active boot disk can be removed if it is not needed after the new boot disk is enabled.





Note - The examples in this section show disk 2 as the active boot disk, and disk 3 as the designated new boot disk that is connected through the host adapter.



Partitioning the New Boot Disk the Same As the Active Boot Disk

There are several subprocedures required to complete the first phase of enabling booting from a temporarily connected boot disk. These subprocedures include:


procedure icon  To Prepare to Partition the New Disk

1. Switch users to root on the host with the host adapter.


% su
Password:
#

2. If the driver and any needed patches are not already installed, download the driver package from Sun's download center and install it on the host, following the instructions in the README file that comes with the driver.

To download the driver, follow the instructions in the Installing the HBA Driver.

3. Reboot using the reboot(1M) command with the -r option.


# reboot -- -r

4. Log into the host as root.


procedure icon  To Record the Partition Layout

After you log back into the host, you can record the layout of the partitions, or slices, on the system boot disk.

1. Enter the format(1M) command.

If needed, see the format man page and the instructions for adding a disk and using the format command in the Solaris administration documentation.



Note - These examples use disk 2 as the active boot disk (c1t2d0) and disk 3 (c3t0d0) as the new boot disk.




# format
Searching for disks...done
 
AVAILABLE DISK SELECTIONS:
       0. c1t0d0 <SUN36G cyl 24620 alt 2 hd 27 sec 107>
          /pci@1f,4000/scsi@3/sd@1,0
       1. c1t1d0 <SUN36G cyl 24620 alt 2 hd 27 sec 107>
          /pci@1f,4000/scsi@3/sd@2,0
       2. c1t2d0 <SUN36G cyl 24620 alt 2 hd 27 sec 107>  disk2
          /pci@1f,4000/scsi@3/sd@3,0
	3. c3t0d0 <SUN36G cyl 24620 alt 2 hd 27 sec 107>   disk 3
          /pci@8,700000/SUNW,emlxs@5/fp@0,0/ssd@w21000004cf8fe2e0,0
       4. c3t1d0 <SUN36G cyl 24620 alt 2 hd 27 sec 107>
          /pci@8,700000/SUNW,emlxs@5/fp@0,0/ssd@w21000004cf834579,0
       5. c3t2d0 <SUN36G cyl 24620 alt 2 hd 27 sec 107>    disk 59
          /pci@8,700000/SUNW,emlxs@5/fp@0,0/ssd@w21000004cf7f7b0d,0
       6. c3t3d0 <SUN36G cyl 24620 alt 2 hd 27 sec 107>
          /pci@8,700000/SUNW,emlxs@5/fp@0,0/ssd@w21000004cf64dc04,0 
Specify disk (enter its number):

2. Make a note of the device path name of the new boot disk.

For example, for disk 3, the new boot disk in this example, the device path name shown is /pci@8,700000/SUNW,emlxs@5/fp@0,0/ssd@w21000004cf8fe2e0,0. You use this information later in Step 4 in To Specify the New Boot Disk as the Boot Device.



Note - The SUNW,emlxs number changes, depending on the type of host and slot in use.



3. Specify the disk where the operating system is installed on the active boot disk.

The following screen example specifies disk 2.


Specify disk (enter its number): 2

4. Enter the partition command to bring up the PARTITION MENU.


format> partition 
PARTITION MENU:
        0      - change `0' partition
        1      - change `1' partition
        2      - change `2' partition
        3      - change `3' partition
        4      - change `4' partition
        5      - change `5' partition
        6      - change `6' partition
        7      - change `7' partition
        select - select a predefined table
        modify - modify a predefined partition table
        name   - name the current table
        print  - display the current table
        label  - write partition map and label to the disk
        !<cmd> - execute <cmd>, then return
        quit
partition> 

5. Enter the print command to display the partition table for the specified disk.


partition> print
Volume: disk1
Current partition table (original):
Total disk cylinders available: 24620 + 2 (reserved cylinders)
 
Part 			Tag    	Flag 												Cylinders									Size 								Blocks
  0 			root 					wm 					17531 - 24619 										9.77GB 							(7089/0/0) 20480121
  1 			swap 					wu     					0 - 2902        4.00GB 	(2903/0/0)  8386767
  2 			backup 					wm     					0 - 24619       33.92GB	(24620/0/0) 71127180
  3 unassigned wm       0               0         (0/0/0) 	0
  4 unassigned wm       0               0         (0/0/0) 	0
  5 unassigned wm       0               0         (0/0/0) 	0
  6 unassigned wm       0               0         (0/0/0) 	0
  7 			usr 					wm 					2903-9991 										9.77GB 						(7089/0/0) 20480121 

As shown in the example, the active boot disk has four slices defined: 0 (root),
1 (swap), 2 (backup), and 7(usr) with sizes 9.77Gb, 4.00Gb, 33.92Gb, and 9.77 Gb, respectively.

6. Record the layout (sizes and numbers) assigned to the slices on the active boot disk, and enter quit when done.


partition> quit
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
        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
        volname    - set 8-character volume name
        !<cmd>     - execute <cmd>, then return
        quit
format> 

As shown above, the quit command returns you to the FORMAT MENU.


procedure icon  To Change to the New Boot Disk

After you record the partition layout, change to the new boot disk.

1. At the format> prompt, type disk to change the current disk to the new boot disk.

2. After the disk command, enter the number of the disk to be formatted.

The following screen example uses disk 2. The FORMAT MENU appears.


format> disk 3
selecting c3t0d0
[disk formatted]
 
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
        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
        volname    - set 8-character volume name
        !<cmd>     - execute <cmd>, then return
        quit
format> 

3. Make a note of the device name of the disk.

The device name of the disk in the previous screen example is c3t0d0.


procedure icon  To Specify Slices on the New Boot Disk

After you change to the new boot disk, specify one slice on the new boot disk for every slice on the active boot disk. The following examples specify the root slice 0 on the new boot disk to match slice 0 on the active boot disk.

1. Enter the partition command to bring up the PARTITION MENU.


format> p
PARTITION MENU:
        0      - change `0' partition
        1      - change `1' partition
        2      - change `2' partition
        3      - change `3' partition
        4      - change `4' partition
        5      - change `5' partition
        6      - change `6' partition
        7      - change `7' partition
        select - select a predefined table
        modify - modify a predefined partition table
        name   - name the current table
        print  - display the current table
        label  - write partition map and label to the disk
        !<cmd> - execute <cmd>, then return
        quit
partition> 

2. Enter the number of the slice to be defined.

Slice 0 is specified in the following example. As shown, the partition table for the new boot disk is displayed.


partition> 0
Current partition table (original):
Total disk cylinders available: 24620 + 2 (reserved cylinders)
 
Part      Tag    Flag     Cylinders         Size            Blocks
  0       root    wm       0 -    90      128.37MB    (91/0/0)      262899
  1       swap    wu      91 -   181      128.37MB    (91/0/0)      262899
  2     backup    wu       0 - 24619       33.92GB    (24620/0/0) 71127180
  3 unassigned    wm       0                0         (0/0/0)            0
  4 unassigned    wm       0                0         (0/0/0)            0
  5 unassigned    wm       0                0         (0/0/0)            0
  6        usr    wm     182 - 24619       33.67GB    (24438/0/0) 70601382
  7 unassigned    wm       0                0         (0/0/0)            0
Enter partition id tag[root]:

3. Enter the partition ID tag.

The following example shows a question mark (?) entered after the prompt. The list of accepted partition ID tags displays. The example then shows the default partition ID tag of root accepted by pressing the Return key.


Enter partition id tag[root]: ?
Expecting one of the following: (abbreviations ok):
        unassigned    boot          root          swap
        usr           backup        stand         var
Enter partition id tag[root]: 
Enter partition permission flags[wm]:

4. Enter the partition permission flags.

The following example shows the default permission flags wm accepted by pressing the Return key.


Enter partition permission flags[wm]:
Enter new starting cyl[0]:

5. Enter the new starting cylinder.

The following example shows the default new starting cylinder of 0 accepted by pressing the Return key.


Enter new starting cyl[0]: 
Enter partition size[262899b, 91c, 128.37mb, 0.13gb]: 

6. Enter the partition size.

The following example shows the partition size of 9.77gb entered.


Enter partition size[262899b, 91c, 128.37mb, 0.13gb]: 9.77gb
partition> 

7. Enter the print command to display the updated partition table.

The following example shows that the root tag, the wm permissions flag, and the partition size of 9.77GB are assigned to slice 0.


partition> print
Current partition table (unnamed):
Total disk cylinders available: 14068 + 2 (reserved cylinders)
 
Part 			Tag    Flag     Cylinders 																				Size            Blocks
  0 			root    wm 										3282-11298 										9.77GB 			(8017/0/0)										20491452
  1 			swap    wu 										0 - 3281 										4.00GB					(3282/0/0)								8388792
  2 			backup 					wu 					0 - 24619										33.92GB (24020/0/0)													71127130
  3 unassigned wm 													0                0 															(0/0/0) 										0
  4 unassigned wm 													0                0 															(0/0/0) 										0
  5 unassigned wm 													0                0 															(0/0/0) 										0
  6 unassigned wm 													0                0 															(0/0/0) 										0
  7 			usr 					wm 					11299-19315 										9.77GB					(8017/0/0)								20491452

8. Repeat Step 2 through Step 7 as needed until all slices are defined as they are in the active boot disk.

9. Enter the quit command to return to the FORMAT MENU.


partition> quit
 
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
        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
        volname    - set 8-character volume name
        !<cmd>     - execute <cmd>, then return
        quit
format> 


procedure icon  To Label the New Boot Disk

After you specify the slices on the new boot disk, label the new boot disk with the new partition table.

1. Enter the label command.


format> label

2. Enter yes to continue.


Ready to label disk, continue? y

3. After the labeling is complete, enter quit to quit the format program.


format> q
#

To Create File Systems on the New Boot Disk

Create a file system on each slice on the disk using the newfs(1M) command.

Enter the newfs command followed by the device name of the slice. In this example, the device name for slice 0 of disk c3t0d0 is /dev/rdsk/c3t0d0s0.


# newfs /dev/rdsk/c3t0d0s0
newfs: construct a new file system /dev/rdsk/c3t0d0s0: (y/n)? y
/dev/rdsk/c3t0d0s0:      20491452 sectors in 8017 cylinders of 6 tracks, 426 sectors
        10005.6MB in 201 cyl groups (40 c/g, 49.92MB/g, 6272 i/g)
super-block backups (for fsck -F ufs -o b=#) at:
 32, 102704, 205376, 308048, 410720, 513392, 616064, 718736, 817952, 920624,
 19530896, 19630112, 19732784, 19835456, 19938128, 20040800, 20143472,
 20246144, 20348816, 20448032,

For more information, see the section on how to create file systems in the Solaris system administration documentation.

Repeat this step to create a file system on the new boot disk for every slice on the temporary boot disk. When you are finished, go to To Copy the Contents of Nonroot File Systems onto the New Boot Disk.

To Create the New Boot Files

This section includes the following several subprocedures:


procedure icon  To Copy the Boot Block and Root File System Contents to the New Boot Disk

1. Install the boot block on the root (/) file system of the new disk.

The following example uses the installboot(1M) command to install the boot block. The boot block resides in the /usr/platform/platform_name/lib/fs/ufs/bootblk directory. The example shows invoking the uname command with the -i option between the left single quotes on the command line to specify the platform name.


# /usr/sbin/installboot /usr/platform/`uname -i`/lib/fs/ufs/bootblk \
/dev/rdsk/c3t0d0s0 

2. Mount the root file system from slice 0 of the new boot disk onto the /mnt mount point.


# mount /dev/dsk/c3t0d0s0 /mnt

3. Use the ufsdump(1M) and ufsrestore(1M) commands to copy the contents of the root file system from the active boot disk to the root slice of the new boot disk (on the /mnt mount point).


# ufsdump 0f - /dev/rdsk/c1t2d0s0 | ( cd /mnt; ufsrestore rf -)
  DUMP: Date of this level 0 dump: Thu Apr 21 16:31:28 2005
  DUMP: Date of last level 0 dump: the epoch
  DUMP: Dumping /dev/rdsk/c1t2d0s0 (v880:/) to standard output.
  DUMP: Mapping (Pass I) [regular files]
  DUMP: Mapping (Pass II) [directories]
  DUMP: Writing 32 Kilobyte records
  DUMP: Estimated 7487228 blocks (3655.87MB).
  DUMP: Dumping (Pass III) [directories]
  DUMP: Dumping (Pass IV) [regular files]
Warning: ./lost+found: File exists
./.gconf/apps/panel/profiles/default/applets/volume_control/prefs/%gconf.xml: (inode 192684) not found on volume
 
  DUMP: 50.44% done, finished in 0:09
  DUMP: 7487166 blocks (3655.84MB) on 1 volume at 4126 KB/sec
  DUMP: DUMP IS DONE


procedure icon  To Update the vfstab File

After you copy the boot block and root files, update the vfstab file.

1. Change directories to /mnt/etc and open the vfstab(4) file for editing.

The following example shows the file systems defined.


# cd /mnt/etc
# vi vfstab
...
/dev/dsk/c1t2d0s1       -       -       swap    -       no      -
/dev/dsk/c1t2d0s0       /dev/rdsk/c1t2d0s0      /       ufs     1       no -

2. Replace the name of the temporary boot disk with the name of the new boot disk, and then save and quit the file.

The following example shows the disk name c1t2 changed to c3t0 in the mount table entries for slices 0 and 1.


/dev/dsk/c3t0d0s1       -       -       swap    -       no      -
/dev/dsk/c3t0d0s0	 													/dev/rdsk/c3t0d0s0 															/       ufs     1 no      -


procedure icon  To Copy the Contents of Nonroot File Systems onto the New Boot Disk

1. Mount the file system onto the /mnt mount point.

This example shows the copying of the /home file system from slice 7 to the new boot disk.


# mount /dev/dsk/c3t0d0s7 /mnt

2. Use the ufsdump(1M) and ufsrestore(1M) commands to copy the contents of the file system from the active boot disk to the new boot disk.


# ufsdump 0f - /dev/rdsk/c1t2d0s7 | ( cd /mnt; ufsrestore rf -)
  DUMP: Date of this level 0 dump: Thu Apr 21 16:31:28 2005
  DUMP: Date of last level 0 dump: the epoch
  DUMP: Dumping /dev/rdsk/c1t2d0s0 (v880:/) to standard output.
  DUMP: Mapping (Pass I) [regular files]
  DUMP: Mapping (Pass II) [directories]
  DUMP: Writing 32 Kilobyte records
  DUMP: Estimated 7487228 blocks (3655.87MB).
  DUMP: Dumping (Pass III) [directories]
  DUMP: Dumping (Pass IV) [regular files]
Warning: ./lost+found: File exists
./.gconf/apps/panel/profiles/default/applets/volume_control/prefs/%gconf.xml: (inode 192684) not found on volume
 
  DUMP: 50.44% done, finished in 0:09
  DUMP: 7487166 blocks (3655.84MB) on 1 volume at 4126 KB/sec
  DUMP: DUMP IS DONE

3. Unmount the file system from the /mnt mount point.


# umount /mnt

4. Repeat Step 1 through Step 3 as needed until you have copied all the file systems' contents to the new boot disk. When finished, go to To Update the vfstab File.

5. Before the system is rebooted, configure the system crash dump facility.

In this example, the dump device is still pointing to the active boot disk.


# dumpadm
    Dump content: kernel pages
      Dump device: /dev/dsk/c1t2d0s1 (dedicated)
Savecore directory: /var/crash/v880
  Savecore enabled: yes

6. Optionally, use the dumpadm -d command to change crash dump facility.


# dumpadm -d /dev/dsk/c3t0d0s1
    Dump content: kernel pages
      Dump device: /dev/dsk/c3t0d0s1 (swap)
Savecore directory: /var/crash/v880
  Savecore enabled: yes

7. If you used the dumpadm -d command, verify that the change took place.


# dumpadm
    Dump content: kernel pages
      Dump device: /dev/dsk/c3t0d0s1 (swap)
Savecore directory: /var/crash/v880
  Savecore enabled: yes


procedure icon  To Specify the New Boot Disk as the Boot Device

1. Bring the host with the host adapter down to the ok prompt at run level 0.

See the Solaris system administration documentation on shutting down a host for the commands that can be used with different configurations. The following screen example uses the shutdown(1M) command.


# shutdown
...
ok

2. Use the nvalias command to create a short alias name for the device name of the disk.

The following example uses /pci@8,700000/SUNW,emlxs@5/fp@0,0/ssd@w21000004cf8fe2e0,0, which was the device path name for disk 3 in To Record the Partition Layout.


ok nvalias disk3 /pci@8,700000/SUNW,emlxs@5/fp@0,0/disk@w21000004cf8fe2e0,0

3. Use the nvstore command to store the new alias followed by the reset all command.


ok nvstore
ok reset-all

4. Define the new boot disk as the default boot-device parameter.

Use the data gathered in Step 2 on "Invalid Cross-Reference Format".

a. Enter the setenv command followed by the boot-device parameter followed by the name of the new disk.


ok setenv boot-device disk3

b. Enter the reset command.


ok reset

5. Enter the boot command with the -r option so that the Solaris OS can recognize the adapter.


ok boot -r


Creating a Linux Boot Disk

Emulex adapters enable you to load and boot the Linux operating system from a SAN-attached drive. You can use either the Emulex driver for Linux provided on your Linux distribution CD or, if you are using a different Linux driver, by creating a driver disk (DD).

To boot from SAN directly from your distribution CD, follow the directions included with that CD. Emulex currently supports booting from SAN on SLES8 SP3 and RHEL3u3 releases.

To boot from SAN using a driver that is not included on the distribution CD, create a DD with that driver. If you do not know how to create a DD, follow the instructions available from the following links:


Creating a Windows Boot Disk

1. Go to http://www.emulex.com/ts/docoem/framsun/10k.htm.

2. Click either the SG-XPCI1FC-EM2 or the SG-XPCI2FC-EM2 link.

The download page for SG-XPCI1FC-EM2 and SG-XPCI2FC-EM2S will appear.

3. Locate the Universal Boot section, and click the link in the Download column.

4. Download the Universal Boot kit to a local drive.

Click the Download button.

5. Click the Universal Boot Manual link.

Follow the instructions in the manual for creating a Windows boot disk.


1 (Footnote) For the distinction between these two types of server, see the Solaris system administration documentation.