User Guide 3ware® Serial ATA RAID Controller Supports the 9000 Series PN 720-0104-00 April, 2004
Copyright ©2004 3ware, Inc. All rights reserved. No part of this publication may be reproduced, stored in a retrieval system, or transmitted in any form by any means, electronic, mechanical, photocopying, recording or otherwise, without the proper written consent of 3ware, Inc., 455 West Maude Ave., Sunnyvale, CA 94085. Trademarks 3ware, Escalade, and 3DM are all registered trademarks of 3ware, Inc. The 3ware logo, 3BM, StorSwitch, TwinStor, and R5 Fusion are all trademarks of 3ware, Inc.
ware Disk Manager (3DM 2) Note: 3DM 2 includes software developed by the OpenSSL Project for use in the OpenSSL Toolkit (http://www.openssl.org/). 3ware Disk Manager 2 (3DM 2), allows you to view the status of and manage 3ware RAID controllers and associated drives. 3DM runs as a service under Microsoft Windows, and as a daemon under Linux. When it is running, you can use your browser to view status and perform administrative tasks locally or remotely.
3ware Disk Manager (3DM 2) “3DM 2 Reference”contains information about the fields and settings on each page in 3DM. For additional information about doing particular tasks in 3DM, see the remaining sections in this guide. Browser Requirements for 3DM 3DM runs in most current web browsers. Tested and supported browsers include: ■ Mozilla 1.2 and above ■ Internet Explorer 5.
Installing 3DM Installing 3DM 3DM 2 can be installed from the main 3ware CD that came with your 3ware RAID controller. You can also download the current version from the website at http://www.3ware.com/support/download.asp. 3DM must be installed on the system in which the controller is installed. 3DM does not have to be installed on remote systems in order to remotely manage a 3ware controller. During installation, you will be asked to enter the following preferences for 3DM use.
3ware Disk Manager (3DM 2) When the second checkbox is checked, only localhost connections are allowed. Internet and Intranet connections are not allowed. (You can change this setting later in 3DM.) Figure 10. 3DM Remote Monitoring and Security Configuration Display 5 If the 3DM HTTP listening port setup screen appears, enter the HTTP port you want to use. This screen only appears when you check the first box on the 3DM Remote Monitoring and Security Configuration screen.
Installing 3DM ■ In the Sender field, enter the email address from which the email notifications will be sent. This is typically the local host name. (You can change these settings later within 3DM.) SCSI Figure 11. 3DM E-mail Notification Preferences 7 Continue with the installation as prompted, clicking Next to move to the next screen, and Finish when you reach the last screen. 3DM Installation gives you the option of starting 3DM and opening the browser window.
3ware Disk Manager (3DM 2) Notes: You can start 3DM later by choosing 3DM from the Start menu. If you change, add, or remove an IP address, or change the machine name of the machine on which you have installed 3DM 2, you will need to recreate the security certificate. You can do so by re-installing 3DM 2, or by deleting the file 3dm2.pem and restarting the 3DM 2 service. Under Windows, this file is located in the same directory in which you installed 3DM 2. Under Linux, the file resides in /etc/3dm2.
Installing 3DM To specify initial setup for 3DM 2 During installation, you will be prompted with a series of questions that determine initial 3DM settings. You can change these later, from within 3DM. (The first question appears for Linux, but not for FreeBSD.) 1 Was RPM used to install the Escalade driver and/or 3DM? The default answer is no.
3ware Disk Manager (3DM 2) Uninstalling 3DM under Linux or FreeBSD To uninstall 3DM for Linux or FreeBSD 1 Insert the 3ware software installation CD-ROM into the CD-ROM drive. 2 Mount the CD-ROM disk: mount /dev/cdrom /mnt 3 Change the directory and run the uninstall script: (For FreeBSD, replace “linux” with “freebsd” in the path shown in this step.) cd /mnt/packages/3dm2/linux/x86 ./install.
Starting 3DM and Logging In Starting 3DM and Logging In 3DM runs as a service under Windows, and as a daemon under Linux. It is a good idea to leave 3DM running on the system that contains your 3ware RAID controller. That way email alerts can be sent by 3DM, and administrators can manage the controller remotely, if remote administration is enabled. You can access the 3DM screens to check status information and manage your 3ware RAID controller by logging in to the 3DM screens in your browser.
3ware Disk Manager (3DM 2) Note: If you close your browser, 3DM continues to run in the background on the system. Viewing 3DM Remotely via a Standard Web Browser When remote administration is enabled, you can use 3DM to check status and administer your 3ware RAID controller from a browser on any computer, over an internet connection. You do not need to install the 3DM software on the remote computer. Remote connections can be enabled or disabled from the 3DM Settings page.
Working with the 3DM Screens Working with the 3DM Screens 3DM’s features are organized on a series of pages you view in your browser. After you log in to 3DM, the Summary page shows a list of controllers installed in the computer at the URL you specified. Note: If you expect to see a controller that is not listed, it may not be compatible with the driver that is loaded; a firmware flash upgrade may be required. Figure 13.
3ware Disk Manager (3DM 2) 3DM Menus The 3DM menu bar groups access to a number of 3DM pages on menus, and provides direct link access to others. Figure 14. 3DM Menu Bar Status information is available from the Information menu. You can view controller, unit, and drive information for a particular controller.
Working with the 3DM Screens Viewing Information About Different Controllers in 3DM If you have more than one controller in the system, you select the one you want to see details about from the drop-down list at the right of the menu bar. This drop-down is available on all pages that provide controller-specific features. Note: Throughout these instructions, current controller is used to refer to the controller which is currently selected in this drop-down list.
3ware Disk Manager (3DM 2) Table 5: List of 3DM Pages 40 3DM Page Description Unit Information Page Shows a list of the units on the current controller and provides summary information about each unit. To see this page, choose Information > Unit Information from the menu bar or click an ID number on the Controller Summary. Unit Details Page Shows details about a particular unit. To see this page, click an ID number on the Unit Information page.
Setting Up 3DM Preferences Setting Up 3DM Preferences The 3DM Settings page lets you define preference settings that affect the overall operation of 3DM. Most of these settings are specified initially during installation of 3DM.
3ware Disk Manager (3DM 2) Managing E-mail Event Notification 3DM can notify you when the 3ware RAID controller requires attention, such as when a disk unit becomes degraded and is no longer fault tolerant. Event notification can only occur while 3DM is running, so it is recommended that 3DM be left running on the system that contains the 3ware RAID controller. When events occur, notification can be e-mailed to one or more recipients.
Setting Up 3DM Preferences Enabling and Disabling Remote Access When remote access is enabled, a user can connect to 3DM over the internet or an intranet, to check status or administer the controller and associated drives. If remote access is disabled and a user attempts to connect to 3DM remotely, they will see the following error message: “Remote Access to 3DM has been disabled. Please connect using the local machine by entering “localhost” in the URL bar.
3ware Disk Manager (3DM 2) To set the frequency of page refreshes 1 Click 3DM Settings on the menu bar. 2 In the Page Refresh section of the 3DM Settings page, select how often you want the page to be refreshed in the Minutes Between Refresh field. Note: If you don’t want 3DM to refresh the screen automatically, select Never in the Minutes Between Refresh field. You can then refresh manually by clicking Refresh on your web browser.
3DM 2 Reference 3DM 2 Reference This section includes details about the fields and features available on the pages you work with throughout 3DM 2. It is organized by page, as the pages are organized on the 3DM menu bar.
3ware Disk Manager (3DM 2) The Summary page appears after you first logon to 3DM, and when you click the Summary link in the menu bar. The Summary page provides basic information about each 3ware RAID controller in your system. To see details about the units in a controller, click the link in the ID column. ID. The ID that the operating system assigns to the controller. Note: The controller ID you see in 3DM 2 may not match the number that you see for the same controller in 3DM version 1.x. Model.
3DM 2 Reference Controller Details Page Figure 16. Controller Details Page The Controller Details page appears when you choose Information > Controller Details from the menu bar. The Controller Details page provides detailed information about the controller specified in the drop-down list on the menu bar. You can also open or download an error log from this screen. Model. The model name of the controller. Serial #. The serial number of the controller. Firmware.
3ware Disk Manager (3DM 2) Unit Information Page Figure 17. Unit Information Page The Unit Information page appears when you choose Information > Unit Information from the menu bar, and when you click an ID number on the Controller Summary page. The Unit Information page shows a list of the units on the controller specified in the drop-down list on the menu bar and provides summary information about each unit. To see details about a particular unit, click the link in the Unit # column. Unit #.
3DM 2 Reference Note: 3DM 2 displays the capacity (in MBytes or GBytes) the same way that Microsoft Windows and Linux operating systems do: as 1KB = 1024 bytes. Previous versions of 3DM 1.x used the 1KB = 1000 bytes definition. Consequently capacities of units listed under 3DM v 1.x may appear to be larger than they do under 3DM 2. Status. The operational status of the unit: OK, Rebuilding, Initializing, Verifying, Degraded, or Inoperable (missing drives).
3ware Disk Manager (3DM 2) Figure 18. However, if the unit was a Single Disk, only information about one disk would be shown. Details on this page may include all or some of the following information described below. To see details about a particular drive, click the Port #. You’ll see a list of all drives, with the drive you selected highlighted. Status. The operational status of the unit or subunit: OK, Rebuilding, Initializing, Verifying, Degraded, or Inoperable (missing drives).
3DM 2 Reference Drive Information Page Figure 19. Drive Information Page The Drive Information page appears when you choose Information > Drive Information from the menu bar, or when you click a port # on the Unit Details page. If you arrive at this page from the port # hyperlink on the Unit Information page, the line showing the port # you clicked on is highlighted.
3ware Disk Manager (3DM 2) Status. The status of the drive: OK, Not Supported, Read Timeout, Read Failure, Orphan, DCB Data Check, Unsupp DCB, Unconv DCB, Offline JBOD, or Not Present. (In the event of a problem, the status shown for the drive can be useful to customer support.) Note: In most cases, the status of the drive will not correspond to the status of the unit, shown on the Unit Information page. SMART Details About Drive at Particular Port Page Figure 20. S.M.A.R.
3DM 2 Reference Controller Settings Page Figure 21. Controller Settings Page The Controller Settings page appears when you choose Management > Controller Settings from the menu bar. The Controller Settings page lets you view and change settings that affect the units on the controller specified in the drop-down list on the menu bar. Background Task Rate The Background Task Rate fields let you change the balance of background tasks (rebuild and verify) and I/O performed by the controller.
3ware Disk Manager (3DM 2) For additional information, see“Setting Background Task Rate” on page 113. Unit Write Cache You can enable or disable write cache for each unit.3DM lists each unit on the controller specified in the drop-down list on the menu bar, and shows you whether the write cache is currently enabled or disabled for it. Write cache is a combination of the physical hard drives’ write cache as well as the controller’s memory, depending on what type of unit you are using.
3DM 2 Reference Note: The policy Continue on Source Error During Rebuild is equivalent to the “Force continue on source errors” option in 3DM v 1.x and the “ignoreEcc” option in the CLI. Other Controller Settings For 9000-series controllers, the Other Controller settings displays information about additional settings that can only be changed in the BIOS (3BM). For more information see “Setting Policies for a Controller through 3BM” on page 74.
3ware Disk Manager (3DM 2) Scheduling Page Figure 22. Scheduling Page For 9000-series controllers, the Scheduling page appears when you choose Management > Scheduling from the menu bar. The Scheduling page is not available for 7000- and 8000- series controllers. If you want to schedule tasks for one of those controllers, use 3DM Version 1.x.
3DM 2 Reference The Scheduling page lets you view and change the schedule for tasks that affect all units on the controller specified in the drop-down list on the menu bar, including: ■ Rebuild tasks (also applies to initialization tasks) ■ Verify tasks (also applies to media scans) ■ Self-tests You can also enable or disable use of the schedule for Rebuild and Verify tasks by selecting either Follow Schedule or Ignore Schedule.
3ware Disk Manager (3DM 2) Two self-tests can be scheduled: Upgrade UDMA mode. This test checks the speed at which data transfer to drives is occurring, to see if the UDMA mode can be increased. (If you are already running at the fastest UDMA mode, then this self-test has no effect.) The UDMA mode can become downgraded in the event that cable CRC errors are encountered, requiring multiple retries to read sectors.
3DM 2 Reference Maintenance Page Figure 23. Maintenance Page The Maintenance page appears when you choose Management > Maintenance from the menu bar. The Maintenance page lets you perform maintenance tasks on existing units on the current controller (shown in the drop-down list on the menu bar), and lets you create new units by configuring available drives.
3ware Disk Manager (3DM 2) Warning: Removing or adding drives which are not in hotswap carriers can result in a system hang or may even damage the system and the drive. In 9000-series controllers, rescan checks empty ports for newly plugged in drives. If those drives were previously part of a 3ware RAID configuration and they still have valid DCB (Disk Configuration Block) information on them, the controller tries to piece them back together into a working unit.
3DM 2 Reference # Drives. Number of drives in the unit. Type of Unit. Type of unit specified during configuration: RAID 0, RAID 1, RAID 5, RAID 10, RAID 50, Single Disk, Spare, or JBOD. Capacity. The usable capacity (size) of the unit. Status. Operational status of the unit: Ok, Rebuilding, Initializing, Verifying, Degraded, or Inoperable (missing drives). When Rebuilding, Initializing, or Verifying, the percentage (%) complete is also shown. The % complete can be active or paused.
3ware Disk Manager (3DM 2) If the unit you selected to verify is a redundant unit, the redundancy of the unit will be verified. For example it will check parity for a RAID 5 or check data consistency for a RAID 1. If the unit you checked is not a redundant unit, verify will do a surface scan of the media. During verification, I/O continues normally. For RAID 0, single disks, JBODs, and spares, there is only a slight performance loss.
3DM 2 Reference Caution: Before you click Remove Unit, make sure the unit you are removing is unmounted and no I/Os are being issued. (For example, make sure you are not copying files to the unit, and make sure that there are no applications with open files on that unit.) If a unit is not unmounted and you remove it, it is the equivalent of physically yanking a hard drive out from under the operating system.
3ware Disk Manager (3DM 2) Caution: Before you click Delete Unit, make sure the unit you are removing is unmounted and no I/Os are being issued. If a unit is not unmounted and you delete it, it is the equivalent of physically yanking a hard drive out from under the operating system. Resulting behavior depends on which operating system you are using and what kind of I/O is being done, however you will typically see really bad results, bad errors, and most likely a reset of the controller or a system hang.
3DM 2 Reference Figure 24. Configuring a Unit in 3DM For more detailed instructions, see “Creating a Unit through 3DM” on page 82. Type. The drop-down list lists the possible RAID configurations for the drives selected in the list of Available Drives. Available configurations may include RAID 0, RAID 1, RAID 5, RAID 10, RAID 50, Single Disk, and Spare Disk. For information about these configurations, see “Available RAID Configurations” on page 9.
3ware Disk Manager (3DM 2) and writes. In general, the smaller the stripe size, the better the sequential I/O and the worse the random I/O. The larger the stripe size, the worse the sequential I/O and the better the random I/O. Write Cache, Auto-Verify, and Continue on Source Error during Rebuild. These check boxes let you set the policies for the unit. These policies can also be set and changed on the Controller Settings page. For details about these policies, see “Unit Policies” on page 54.
3DM 2 Reference This page displays a list of AENs (asynchronous event notifications) received from the controller displayed in the drop-down list in the menu bar. Up to 1000 alarms can be listed. After the 1000-limit is reached, the oldest alarms are deleted, as new ones occur. You can sort the alarms by severity or time. To do so, just click the column header. For 8000 and 9000-series controllers, alarms can be used by either 3DM or CLI, but not both.
3ware Disk Manager (3DM 2) 3DM Settings Page Figure 27. 3DM Settings Page The 3DM Settings page appears when you click 3DM Settings on the menu bar. Use this page to set preferences, including email notification for alarms, passwords, page refresh frequency, whether remote access is permitted, and the incoming port for 3DM to listen for requests. The initial settings for most of these preferences are specified during installation of 3DM.
3DM 2 Reference Send Severity and Above. Specifies the type of events for which notifications should be sent. A severity of Information will send e-mails for all alarms, a severity of Warning will send e-mail for alarms with severity of Warning and Error. A severity of Error will send e-mail for alarms with severity of Error. Sender. Enter the email address which will appear in the “From” field. Recipient. The e-mail address to which notifications should be sent.
3ware Disk Manager (3DM 2) Remote Access Allow Remote Connections. This field enables or disables the ability for users and administrators to access 3DM from a remote computer. Incoming Port # Listening Port. This field specifies the HTTP: port to be used by 3DM when listening for communications. The default port setting is 888. If you change this port, make sure the port you specify is not being used. Failure to do so will cause 3DM to stop responding and you will have to restart it by hand.