3ware® SAS/SATA RAID

Software User Guide Addendum

for OpenSolaris™

Supports the 9690SA and 9650SE Models

PN 720-0190-00
February 2009
Copyright
©2004-2009 Applied Micro Circuits Corporation (AMCC). All rights
reserved. This publication may be copied or reproduced for reference
purposes only. All other purposes require the express written consent of
AMCC, 215 Moffett Park Drive, Sunnyvale, CA 94089. AMCC shall not be
responsible or liable for, and shall be held harmless against, any and all
damages, claims, and/or disputes that arise from the copying or reproduction
of this publication.

Trademarks
3ware®, Escalade®, 3DM®, and TwinStor® are all registered trademarks of
AMCC. The 3ware logo, 3BM, Multi-Lane, StorSave, StorSwitch,
StreamFusion, and R5 Fusion are all trademarks of AMCC. PowerPC and the
PowerPC logo are trademarks of International Business Machines
Corporation. Sun, Solaris and OpenSolaris are trademarks or registered
trademarks of Sun Microsystems, Inc. in the U.S. and other countries. Linux®
is a registered trademark of Linus Torvalds in the United States, other
countries, or both. Windows® is a registered trademark of Microsoft
Corporation in the United States and other countries. Firefox® is a registered
trademark of the Mozilla Foundation. PCI Express® is a registered trademark
of PCI-SIG®. All other trademarks herein are property of their respective
owners.

Disclaimer
While every attempt is made to make this document as accurate as possible,
AMCC assumes no responsibility for errors or omissions in this document,
nor does AMCC make any commitment to update the information contained
herein.
3ware® SAS/SATA RAID
Software User Guide
Addendum for OpenSolaris™

This document is an addendum to the 3ware SAS/SATA RAID Software User

Guide, Version 9.5.1. It provides information about support for the AMCC
3ware 9690SA and the 9650SE 3ware RAID controller models running under
OpenSolaris.
This document contains these sections:
• Creating RAID Units
• Driver and Software Installation
• Partitioning, Formatting and Mounting Units
• Updating the Firmware
• Uninstalling 3ware Software Under OpenSolaris

Note: The 9.5.1 release for OpenSolaris is a web-only release of the software,
driver, and firmware. To install the driver and disk management tools you will need
to download the complete codeset image file that supports OpenSolaris from
http://3ware.com/support/index.asp and burn it to a CD-ROM.

www.3ware.com 1
Creating RAID Units

Related Documentation
The following additional documentation is available:
• The installation guide that came with your 3ware RAID controller tells
you how to physically install a 9690SA or 9650SE controller and the
BBU (battery backup unit).
• 3ware SAS/SATA RAID Software User Guide provides general
information about using the 3ware RAID controller and the 3ware RAID
management software utilities 3BM (3ware BIOS Manager) and 3DM2
(3ware Disk Manager).

Notes:
3DM2 is not yet supported for OpenSolaris.
Primary storage is not yet supported for OpenSolaris.

• 3ware SAS/SATA RAID Controller CLI Guide provides information on

using the 3ware Command Line Interface (CLI).
These guides are available in PDF format in the /doc folder of the CD you
create from the downloaded CD image. They can also be downloaded
individually from the 3ware website at
http://www.3ware.com/support/userdocs.asp.
Additional support information is available in the 3ware Knowledgebase, at
this website: http://www.3ware.com/KB

Creating RAID Units

You can create one or more RAID units either before or after you install the
software.

To create a RAID unit or units

1 Install your 3ware RAID controller as described in the installation guide
for the controller. You can download an electronic version from
http://3ware.com/support/userdocs.asp.
2 Use 3BM (3ware BIOS Manager) to create one or more RAID units on
the 3ware RAID controller. You can access 3BM by pressing Alt-3 during
system startup.
Instructions for creating units using 3BM are available in Chapter 3,
“First-Time RAID Configuration Using 3BM” in the 3ware SAS/SATA
RAID Software User Guide.
You can also use the CLI to create RAID units. For details, see the 3ware
SAS/SATA RAID Controller CLI Guide.

2 3ware® SAS/SATA RAID Software User Guide Addendum for OpenSolaris

 Driver and Software Installation

Driver and Software Installation

This section provides detailed instructions for installing the 3ware driver and
the RAID management software. You can install all software components at
once, or you can choose to install specific software components. You can
install from a graphical window or from a console command line.

Installing the Driver and Software from a Graphical

User Interface (GUI)
The steps below describe how to install the 3ware driver and RAID
management software from a graphical window. You must be root to run the
installer.

To install the driver and software

1 Download the AMCC 3ware OpenSolaris installation image from

http://3ware.com/support/index.asp and burn it to a CD-ROM disc.
2 With your computer on, insert the CD you burned in step 1 and navigate
to the folder on the CD that contains the installer.
packages/installers/tools/solaris/opensolaris

3 Type:
./setupSolaris_x86.bin

and press Enter.

4 After you press Enter, the application starts in graphical mode. On the
Welcome screen, click Next.

Figure 1. Welcome Installation Screen

www.3ware.com 3
Driver and Software Installation

5 On the License Agreement page, accept the agreement and click Next.

Figure 2. License Agreement Screen

6 If you want to change where the components will be installed, you can
change the path and directory.
When you are ready, click Next.

Figure 3. Specify Directory Path Screen

4 3ware® SAS/SATA RAID Software User Guide Addendum for OpenSolaris

 Driver and Software Installation

7 Select the components you want to install and click Next.

Figure 4. Select Components to Install Screen

• The AMCC 3ware OpenSolaris driver is required for the operating

system to be able to interact with the 3ware RAID controller.
(Installing the driver may require that you restart your computer.)
• CLI lets you set up and manage RAID units through a command line
interface.
• The 3ware Documentation option installs the 3ware HTML
Bookshelf on your computer. This is a combined HTML version of
the User Guide and CLI Guide.

8 On the summary screen, review the installation that is about to occur.

If you want to make changes, use the Back button to move back through
the screens. When you are ready, click Install to continue.

www.3ware.com 5
Driver and Software Installation

Figure 5. Installation Summary Screen

9 When the final installation screen lets you know that installation is
complete, click Finish.

Figure 6. Final Installation Screen

10 If you are prompted, restart your computer to load the driver.

You can now use 3BM (the 3ware BIOS Manager) or the 3ware CLI to
create and manage RAID units. Instructions for using 3BM are available
in the 3ware SAS/SATA RAID Software User Guide. Instructions for using
the CLI are available in 3ware SAS/SATA RAID Controller CLI Guide.

6 3ware® SAS/SATA RAID Software User Guide Addendum for OpenSolaris

 Driver and Software Installation

Installing the Driver and Software from the

Command Line
The following steps describe how to install software on OpenSolaris at a
command line, using a console application. You must be root to run the
installer.

To install the driver and software on OpenSolaris from the

command line

1 Download the AMCC 3ware OpenSolaris installation image from

http://3ware.com/support/index.asp and mount the image or burn it to a
CD-ROM disc.

2 Navigate to the folder on the mounted image or CD that contains the

installer.
packages/installers/tools/solaris/opensolaris

3 Type:
./setupSolaris_x86.bin -console

and press Enter.

The application starts in text mode.
4 Respond to each screen as it walks you through the installation process.
The Console installation screens mirror those that display using the GUI
installer. For specific information about the screens, see the previous
section in this document.
To navigate in text mode, type:
1 for Next
2 for Previous
3 to Cancel
5 to Redisplay
0 to Continue Installing

5 After the installation is complete, check that the driver has loaded
correctly.
# modinfo | grep 3ware

Tip: If you installed it, you can now access the documentation through the 3ware
HTML Bookshelf. Open your browser and enter /opt/AMCC/Documentation/
index.html

www.3ware.com 7
Managing RAID Units Under OpenSolaris

Managing RAID Units Under OpenSolaris

Under OpenSolaris many unit management tasks require administrative
privileges and manual configuration.

Partitioning, Formatting and Mounting Units

After you create a RAID unit through 3BM or the 3ware CLI, you will then be
able to format and partition the unit, create a file system, and mount it.
These types of system administration tasks are beyond the scope of this
document. For information and procedures, see the OpenSolaris system
documentation at
http://opensolaris.org/os/community/documentation/doc_index/sysadmin/

RAID Unit Management Tasks

Some configuration changes made to a unit through CLI or 3BM will not be
recognized by OpenSolaris until the system is made aware of the changes
through system administration commands.

Enabling Multi-LUN Support

By default, an OpenSolaris host is configured for one LUN per SCSI target. If
you use Auto-Carving to create a unit with multiple LUNs, or if you create a
boot unit, you will need to manually enable multiple LUN support in
OpenSolaris before it can see more than the first LUN. See section D.2
Editing the sd.conf File in the OpenSolaris system documentation at:
http://docs.sun.com/source/819-1274-13/appd_solaris.html#66564

Removing a Unit
If you remove a unit through CLI, OpenSolaris will keep a record of the unit
in the system cache until it is unconfigured through the devfsadm or
cfgadm command.
See the devfsadm documentation at:
http://docs.sun.com/app/docs/doc/816-5166/devfsadm-1m?a=view
See the cfgadm documentation at:
http://docs.sun.com/app/docs/doc/816-5166/cfgadm-
1m?l=en&a=view&q=cfgadm

8 3ware® SAS/SATA RAID Software User Guide Addendum for OpenSolaris

 Updating the Firmware

Updating the Firmware

Firmware updates to the 3ware RAID controller can be done from CLI or by
using the bootable CD image.
For details on updating the firmware using the CLI, see the discussion of the
command /cx update in the 3ware SAS/SATA RAID Controller CLI
Guide.
For details on using the bootable CD image, see “Updating the Firmware
Through DOS Using the 3ware Bootable CD,” in Chapter 10 of the 3ware
SAS/SATA RAID Software User Guide.
Electronic versions of these documents are available at
http://www.3ware.com/support/userdocs.asp.

Note: After updating the firmware, a complete system shutdown and reboot is
required.

Uninstalling 3ware Software Under

OpenSolaris
The following steps describe how to uninstall software on OpenSolaris from
the command line. If you do not use the -console option, the installer will
assume you want GUI mode. You must be root to run the uninstaller.

To uninstall software under OpenSolaris

1 Navigate to the directory where you installed the software. The default
directory is /opt/AMCC.

2 Change to the subdirectory “_uninst”.

3 To uninstall in text mode, type:

./uninstall.bin -console and press Enter.
To uninstall in graphical mode, type:
./uninstall.bin and press Enter.

Follow the prompts to remove the installed components.

www.3ware.com 9