ATTO Utilities Installation and Operation Manual ATTO ConfigTool for Windows®, Linux® and Mac OS® X ATTO BIOS Utilities ATTO Utilities for Windows
ATTO Technology, Inc. 155 CrossPoint Parkway Amherst, New York 14068 USA www.attotech.com Tel Fax (716) 691-1999 (716) 691-9353 Sales support: sls@attotech.com Technical support: Monday -- Friday, 8am-6pm EST techsupp@attotech.com (716) 691-1999 x242 © 2012 ATTO Technology, Inc. All rights reserved. All brand or product names are trademarks of their respective holders. No part of this manual may be reproduced in any form or by any means without the express written permission of ATTO Technology, Inc.
Contents 1.0 ATTO ConfigTool ...........................................................................................1 Pre-Installation Installation Using the ATTO ConfigTool Navigating the ConfigTool Driver update System Reboot 1.1 Celerity and ThunderLink FC NVRAM Settings ................................10 1.2 FastFrame NVRAM Settings ...............................................................12 1.3 ExpressPCI NVRAM Settings .............................................................13 1.
1.4.2 SNMP Configuration ........................................................................56 Definitions Details Configuration Options Control Buttons Troubleshooting 1.5 Virtual Port Management .....................................................................63 The NPIV Panel Creating a Virtual Port Deleting a Virtual Port Troubleshooting 1.6 Troubleshoot the ATTO ConfigTool ..................................................70 2.0 BIOS Configuration Utility ....................................
Appendix A CLI provides an ASCII-based interface........................................... i CLI error messages CLI summary CLI command explanations Appendix B Glossary.............................................................................................
1.0 ATTO ConfigTool The ATTO ConfigTool is a utility program that displays information about installed storage controllers, drivers and devices and provides a mechanism to configure installed storage controllers in local and remote hosts. The ATTO ConfigTool is used to manage all ATTO host based products including HBAs, RAID adpaters and Desklink Devices. The ATTO ConfigTool provides a central interface for managing local and remote hosts with ATTO storage controllers installed.
Installation The ATTO ConfigTool includes two components: a GUI Application and a system service. Either, or both, of these components can be installed on a host, depending on the functionality desired. This creates several different use cases, described below: • A host with both the GUI Application and the system service installed will be able to discover and manage local and remote hosts. This is the most comprehensive management capability.
To install the Full Application or Application Only: 3 Run the ConfigTool_xxx.bin installer executable as root or superuser. 4 Select Full Installation or Application Only as desired 5 Follow the on-screen instructions To install the System Service only: 3 Navigate to the “Service” directory located inside the lnx_app_configtool_xxx directory 4 Run the “attocfgd.sei” installer executable as root or superuser using the following command line: ./attocfgd.
Using the ATTO ConfigTool To use the ATTO ConfigTool, locate and double-click the application icon. The main page has three windows: Device Listing, Configuration Options and Status. See Exhibit 1.0-1. The Device Listing window at the left of the display page lists local and remote hosts found on the network, as well as currently connected devices. You are required to login to manage any host. Once you login, the device tree will expand to reveal additional details on connected storage controllers.
Navigating the ConfigTool CAUTION Save system data prior to installing or changing hardware configurations. Host Discovery The ATTO ConfigTool is able to discover hosts automatically, as well as manually. A host will be discovered and displayed in the Device Listing only if the system service is installed and running on the host. A host that only has the GUI Application installed will not be displayed in the Device Listing.
Select a Storage Controller The following tabs display in the Configuration Options window when you select a specific storage controller in the Device Listing window. • The Basic Info tab provides basic information about the device currently highlighted in the device listing. See Exhibit 1.0-3 on page 8. • The Flash tab provides information about the current revision of flash loaded on the highlighted storage controller. See Exhibit 1.0-4 on page 9.
Driver update A storage controller driver can be installed or upgraded on a host by going to the Basic Info tab for that host, choosing a driver package in the driver update section and clicking update. The driver package is the .exe (Windows), .tgz (Linux) or .dmg (Mac OS X) file available on the ATTO product CD or downloaded from the ATTO website. If a reboot is required, the GUI will prompt once the install completes.
Exhibit 1.0-2 The Basic Info tab when you choose a Host from the Device Listing. Exhibit 1.0-3 The Basic Info tab when a storage controller is chosen from the Device Listing.
Exhibit 1.0-4 The Flash tab. Exhibit 1.0-5 The NVRAM information page. 9 ATTO Technology Inc.
1.1 Celerity and ThunderLink FC NVRAM Settings The settings in the NVRAM tab vary depending upon the selected Celerity or ThunderLink Fibre Channel storage controller and the operating system. Settings unsupported by that OS are not displayed. ATTO storage controllers are designed to operate properly using factory settings. Entering invalid or incorrect settings when using an NVRAM configuration utility such as the ATTO ConfigTool may cause your storage controller to function incorrectly.
Connection Mode Options Link Down Timeout Choices: AL, PTP, AL Preferred, PTP Preferred Default: PTP Preferred Choices: 0-255 Default: 0 • The number of seconds the driver waits for a link that is down to come up before reporting it to the operating system. • • • Arbitrated Loop (AL): Connects to either an Arbitrated Loop or a Fabric Loop Port (FL Port) on a switch. Point-to-Point (PTP): Connects to a direct Fabric connection, such as an F port on a switch.
1.2 FastFrame NVRAM Settings The settings in the NVRAM tab vary depending upon the selected adapter and the operating system. Settings unsupported by that OS are not displayed. ATTO storage controllers are designed to operate properly using factory settings. Entering invalid or incorrect settings when using an NVRAM configuration utility such as the ATTO ConfigTool may cause your storage controller to function incorrectly. CAUTION Back up system data when installing or changing hardware configurations.
1.3 ExpressPCI NVRAM Settings The settings in the NVRAM tab vary depending upon the selected storage controller and the operating system. ATTO storage controllers are designed to operate properly using factory settings. Entering invalid or incorrect settings when using an NVRAM configuration utility such as the ATTO ConfigTool may cause your storage controller to function incorrectly. CAUTION Back up system data when installing or changing hardware configurations.
Specified Target Sync Offset Choices: 0 to 15 or 0 to 7 if Wide ID is disabled Default: 0 Choices: 0-127 Default: 127 Specifies the target ID to which settings are applied. LUNs The defaults offer the best performance possible. The value should not be changed unless instructed by an ATTO Technical Support representative. Choices: Disable ID, 0, 0-7, 0-63 Default: 0-7 Sync Enabled for this ID Specifies the number of LUNs which the driver addresses when scanning for devices, determined as follows.
1.4 ExpressSAS, ThunderLink SH and ThunderStream SC NVRAM Settings The settings in the NVRAM tab vary depending upon the selected storage controller and the operating system. ATTO storage controllers are designed to operate properly using factory settings. Entering invalid or incorrect settings when using an NVRAM configuration utility such as the ATTO ConfigTool may cause your storage controller to function incorrectly. CAUTION Back up system data when installing or changing hardware configurations.
Spinup Delay Multiplexing (6Gb RAID storage controllers only) Choices: 0-20 seconds Default: 0 Choices: enabled, disabled Default: disabled Specifies the number of seconds each SAS PHY waits for disk drives to spin up. When enabled, it allows multiple 3Gb devices to aggregate 6Gb SAS bandwidth. In order to utlilize this feature, devices must support Multiplexing and conform to SAS 2.0 compliancy.
1.4.1 RAID Configuration ExpressSAS RAID and ThunderStream SC storage controllers provides the capability to configure disk storage into RAID groups or Hot Spare drives.
Preliminary Steps 1 2 3 4 5 Locate the ConfigTool icon in the folder you created during installation (Refer to ATTO ConfigTool on page 1). Double-click on the icon to start the application. The Welcome screen appears. From the left-hand panel Device Listing, expand all the elements of the selected hosts in the Network tree. Click on ExpressSAS R6XX or ThunderStream SC 3808. 6 A new set of tabs appears in the right panel. Click on the RAID tab. 7 The application scans for drives.
Exhibit 1.4.1--2 The DVRAID wizard automatically sets up the number of RAID groups based on the number of available drives. Each RAID group uses one drive as a parity drive. Available drives RAID groups created Drives in each group 6 7 8 12 14 16 24 1 1 1 2 2 2 4 6 7 8 6 7 8 6 If you do not have 6, 7, 8, 12, 14, 16 or 24 drives, you cannot use the DVRAID wizard. If you do not want all storage set up in DVRAID or you do not have the correct number of drives, use Customizing a RAID setup.
• 6 SpeedRead, Auto-Rebuild and Rebuild Priority: refer to Change RAID group properties on page 23 for specific information on these parameters. • Sector Size: specifies the sector size that each partition (virtual disk) within the RAID group presents to the host system. The sector size can be set to 512 bytes (default) or 4096 bytes. This parameter can only be set during RAID group creation. The available size is determined by the sector sizes of the physical disks selected for the RAID group.
Exhibit 1.4.1--3 Selecting the options to configure the new RAID group. Exhibit 1.4.1--4 Selecting drives for a new RAID group. 21 ATTO Technology Inc.
Creating a Hot Spare Pool If a member of a RAID group becomes degraded or fails, you lose some redundancy in your RAID group until a new member is rebuilt into the RAID group. You can set up a Hot Spare Pool with drives of different sizes which are designated as replacements for faulted devices at any time, either before or after creating RAID groups. A degraded RAID group is automatically rebuilt if a suitable disk is available in the Hot Spare Pool.
Change RAID group properties A RAID group has properties that are specific to the RAID group. The value of each property remains with the RAID group when it is moved from one computer to another. Some of the properties can only be specified during RAID group creation whereas others may be changed at any time during the life of the RAID group. 1 2 3 Select a RAID group in the Groups panel. Click on Properties in the RAID Management menu. View or change the current properties.
Enable Auto-Rebuild Manually replace a drive A faulted drive is automatically replaced if AutoRebuild is enabled and a suitable unallocated disk is available. Suitable unallocated drives are initialized, large enough to replace the degraded drive, and cannot contain any RAID group information. The unallocated drive may be a pre-existing drive or a newly-seated drive. If a Hot Spare Pool exists, the SAS/SATA RAID storage controller chooses a suitable Hot Spare drive before selecting an unallocated drive.
Logging The ATTO ConfigTool Service outputs RAID events and other useful informational messages to the system event log. The level of RAID events inserted into the system event log may be controlled by the System Log drop-down box in the Basic Alerts section of the Notifications tab. See Exhibit 1.5.1--5 The ConfigTool also generates a log on a per-adapter basis, as well as one for the SNMP functionality and the daemon itself. These are collected with the onebutton diagnostics menu item.
Exhibit 1.4.1--7 The Notifications tab in the ATTO ConfigTool. Exhibit 1.4.1--8 Mute Audible Alert (Windows) Exhibit 1.4.
Using SCSI Enclosure Services (SES) SAS/SATA drive enclosures may provide a SCSI Enclosure Processor which indicates enclosure health status, drive identification and drive fault identification. The ATTO ConfigTool recognizes drive enclosures that provide SCSI Enclosure Services (SES). You may use SES to identify individual drives, all the drives in the same enclosure, all the drives in a single RAID group, or faulted drives. You may also select drives and monitor the status of the enclosure.
Monitoring Health The ATTO SAS/SATA RAID storage controller performs Enclosure Health Monitoring automatically when an SES device is present. The RAID storage controller monitors the status of the enclosure’s power supplies, fans and temperatures. If the status of any of these sub-systems indicates a failure, the storage controller reports the problem. The ConfigTool shows the status of selected SES devices and reports the specific health of each subsystem.
Monitoring S.M.A.R.T. Data Self-Monitoring, Analysis and Reporting Technology, or S.M.A.R.T., is a system built into SATA drives to detect and report on various indicators of drive health. The S.M.A.R.T. (Self-Monitoring, Analysis and Reporting Technology) monitoring feature monitors and reports the status of SATA drives using certain parameters recorded by the drives. Notifications are sent when the values exceed certain pre-determined values.
• Use the Refresh button to query the drive for the latest values. If any values are different from the most recent record, a new record is created and displays. Note If you click on the Refresh button when monitoring is disabled, a pop-up box displays. You can enable monitoring from the pop-up box to complete the refresh request. Exhibit 1.4.1--11 S.M.A.R.T. status for a selected drive. Filtering S.M.A.R.T. Attributes Each of the S.M.A.R.T.
Exhibit 1.4.1--12 S.M.A.R.T. Status box with classification types. S.M.A.R.T. Notifications S.M.A.R.T. status is collected from each SATA drive at 60 minute intervals and, if the data is different than the previous status, a S.M.A.R.T. status record is added to the S.M.A.R.T. status file for that drive. A notification of the S.M.A.R.T. status difference is generated based upon the current settings in the Notifications tab. Refer to Setup RAID Notification on page 24. The notification level of S.M.A.R.T.
Test Drive Performance The performance testing feature in the ATTO ConfigTool records the performance level of a drive in a RAID group under an I/O (input/output) load generated by a host application. The information can be used to compare the performance of each drive relative to others. The performance feature of the ATTO ConfigTool counts the Megabytes per second (MB/sec.) which elapses from the time a start button is clicked until a stop button is clicked.
Exhibit 1.4.1--13 Detail of the Attached Drives window and the Performance dialog box with performance results for the selected drives before a test has been run. 33 ATTO Technology Inc.
RAID Media Scan Feature The Media Scan feature scans disk drives for media errors and parity errors. All media errors are counted and fixed. All parity errors are reported in the event log. The two options are described below: Media Scan - Media Scan works with parity RAID group members, Hot Spare drives and unallocated drives. Media Scan reads the selected drives and, if a Media Error is found, Media Scan re-writes the disk with the media error.
Starting a Media Scan 1 2 3 Select the ExpressSAS RAID or ThunderStream SC storage controller from the Device Listing panel. Select the RAID tab in the right panel. Select the RAID group, Hot Spare drive(s) or unallocated drive(s) which will have a Media Scan. One RAID group can be selected or multiple Hot Spare and unallocated drives can be selected. 4 5 6 7 Select the RAID Management menu item at the top of the screen. Select the Scanning menu item.
Media Scan Status The Media Scan starts as soon as the menu item is selected. The Attached Drives panel displays a rotating icon next to each drive being scanned. The RAID Group panel displays the type of scan being performed and a status for percent complete.
Viewing the Scan Report 1 2 3 Select the ExpressSAS RAID or ThunderStream SC storage controller from the Device Listing panel. Select the RAID tab in the right panel. Select the RAID group, Hot Spare drive(s) or unallocated drive(s) whose scan report should be displayed. One RAID group can be selected or multiple Hot Spare and unallocated drives can be selected. The Scan Report includes the counts for the most recent scan and the total results for all Media Scan operations.
Pausing or Resuming Media Scan Media Scan for a parity RAID group can be paused, resumed and cancelled. The Configuration Tool provides menu items to pause and resume and CLI provides a command to cancel the Media Scan. The results of the Media Scan up to the time of the pause or cancel are saved persistently. Media Scan for Hot Spare and unallocated drives can be cancelled and cannot be paused. Media Scan of Hot Plug and unallocated drives are run immediately and they are not scheduled.
Scheduling Media Scan Media Scan for a parity RAID group can be scheduled to occur at a specified time for a specified frequency. The scheduling mechanism provides the means to specify the following: • • • • Day of the week and the time of day to run a Media Scan once a week Day of the week and the time of day to run a media Scan once Time of day to run a media Scan every day of week A media Scan is scheduled using the following procedure. 7 Select Once, Daily or Weekly as the frequency of the task.
Viewing Scheduled Tasks The Configuration Tool contains a Task tab for each RAID storage controller present in the system. The tab contains a table that displays information for all of the currently scheduled tasks for the associated storage controller. The table only contains an entry for items that have not occurred to date. It does not show any information for completed tasks. The table provides the capability to cancel a task or to change the schedule for the task.
Data Recovery for OFFLINE RAID Groups ATTO SAS/SATA RAID storage controllers use DriveAssure™ to maintain error-free operation of RAID Group member drives. This includes features like Drive Initialization, Media Scan, Parity Verify, Performance Monitoring, and algorithms for latency and response management. Occasionally, a drive will suffer a mechanical or fatal media error that makes it unusable.
Exhibit 1.4.
Failure Scenario Table RAID Groups cannot be accessed normally when their member disks fail, and the RAID Group is marked OFFLINE. RAID Groups of different RAID levels are marked OFFLINE for different reasons, as follows: Exhibit 1.4.1--17 Failure Scenarios and Recovery Methods RAID Level Reason(s) for being marked OFFLINE Recovery Method JBOD and RAID 1 Any drive failure.
Identifying Failed Drives If a failed drive is in an enclosure that supports SES (SCSI Enclosure Services), the drive's Fault LED should be blinking. In that case, it is clear which drive should be replaced. If multiple drives are blinking, power cycling the array and/or the drives, and reseating the drives can sometimes correct intermittent conditions. ATTO supplies other facilities to aid in failed drive identification.
By double-clicking the RAID Group line, each RAID Member and its status is displayed. In Exhibit 1.5.1-19, below, RAID Member 1 indicates DEGRADED. If the drive is in an enclosure that supports SES (SCSI Enclosure Services), the drive's Fault LED should be blinking. Exhibit 1.4.1--19 Member List for Degraded RAID Group 45 ATTO Technology Inc.
The member drive can be physically identified, in its enclosure, by right-clicking in the Attached Drives list and selecting Locate (See Exhibit 1.5.1--20 below). The drive's Identify LED (or activity LED, in a non-SES enclosure) should blink. Sometimes the activity LED won't blink because of a failure in the drive or enclosure electronics. One possible action is to blink all the other LEDs, and find the failed drive by process of elimination. Exhibit 1.4.
Recovery Mode Sometimes, despite careful operation and maintenance, drives will coincidentally fail in such a way that the RAID Group integrity is compromised. After a RAID Group has been marked OFFLINE because of problems with member drives, there is a way to possibly recover some of the data. The following guidelines and commands can help recover data from an OFFLINE RAID Group. The following descriptions refer to RAID 5 specifically, but the principles extend to other RAID types.
Exhibit 1.4.1--28 Enable Rebuild Recovery The RAID Group status will change from Offline to Degraded. The Rebuild status will change from Rebuilding (Faulted) to Recovery Rebuilding (n%), where n% is the completion percentage of the rebuild process. At the end of the Rebuild Recovery, barring major problems, the RAID Group will be put back online. However, at the location corresponding to the Media Error, the data may be invalid! Anytime a RAID Group goes OFFLINE, data integrity has been compromised.
Serious Disk Failure During Rebuild - Using “Extreme” Mode Exhibit 1.4.1--30 RAID 5 Group with 4 Operational Drives 1 2 3 4 Faults on Critical Number of Drives Exhibit 1.4.1--31 A drive Fails; RAID Group goes DEGRADED 1 2 3 2 3 1 2 3 1 1 2 3 4A 1 4 When a serious disk failure occurs during a rebuild, the rebuild cannot be forced to continue, but the Extreme recovery mode may be viable.
Exhibit 1.4.1--38 Enable Basic Recovery Mode The RAID Group status will change from Offline to Recovery (Basic). Once you enter Recovery Mode, use a host application to read the data (whatever you can) off of the drives and back it up to another location. The RAID Group will stay in recovery mode. If you use the CLI command RGRecover Disable to disable this mode, the RAID Group will return to the OFFLINE state. There is no mechanism to put this RAID Group back online.
File System Repair Tools When a RAID array has been made accessible by setting the drive states appropriately, the host's file system may still have integrity problems. Most operating systems have utilities that try to detect and repair file access issues. Windows: CHKDSK Chkdsk (Chkdsk.exe) is a Windows command-line tool that checks formatted disks for problems. Chkdsk then tries to repair any problems that it finds.
RGdisplay This is the RAID Group display command. Use this command to display all RAID Groups and their statuses. rgdisplay 3 ;GroupName Type Interleave Capacity Partitions Members Status ;---------------------------------------------------------------------r5 RAID5 64 KB 447.0GB 1 4 DEGRADED Ready. Note If rgdisplay shows a RAID Group is OFFLINE, then data recovery methods should be initiated; skip this section and go directly to the Section, Recovering from Failed Drives on page 46.
BlockDevIdentify Use this command to blink the activity LED for the drive (if the drive is working enough so the activity LED can operate). The ID from the blockdevscan command must be used, and not the member ID shown in the rmstatus command. Match the S/N of the FAULTED drive (9SF076NJ) from rmstatus to the blockdevscan drive IDs, and use that number to select the correct drive to blink. Sometimes, when blockdevidentify must be used, the activity LED won't blink because the drive has failed so badly.
Display the RAID Group to see the results: rgdisplay 3 ;GroupName Type Interleave Capacity Partitions Members Status ;---------------------------------------------------------------------r5 RAID5 64 KB 447.0GB 1 4 RECOVER Ready.
CacheAssure™ CacheAssure is available on ATTO’s ExpressSAS 6Gb/s RAID storage controllers and FastStream™ RAID Storage Controllers. CacheAssure is an innovative, data protection module that provides the security and confidence that your cached data will remain intact in the event of an unexpected power loss or system failure, within an environmentally friendly solution.
1.4.2 SNMP Configuration SNMP is a standard network protocol that provides the ability to monitor SNMP enabled systems from anywhere on the network. Once configured, 3rd party MIB browsers on a Management Station can be used to retrieve the current configuration and receive TRAP messages when significant events occur via the Configuration Tool, SNMP is supported only for ATTO's ExpressSAS R644, R680, R608, R60F and R6F0 devices. The ATTO SNMP agent has two modes, depending on your configuration.
SubAgent Mode This mode of operation relies on the operating system's SNMP service being installed as a Master Agent and running. All Management Station requests must be directed to this Master Agent, not the ATTO agent. It is expected that only experienced SNMP administrators will use this mode, as installing and configuring the operating system services are beyond the scope of this document. Examples are Windows SNMP services, or the open-source Net-SNMP package.
Disabled Mode This mode disables the operation of the ATTO SNMP agent. Any network ports it has open to support SNMP are closed, making it inaccessible to any Management Station. The system service will not forward requests to it, and no TRAPs are sent out when events occur. Basic Setup The ATTO SNMP agent can be configured through the SNMP tab on the localhost node. When you first enter the SNMP tab, and until you commit a new mode, the SNMP mode will be Disabled.
Send Authentication TRAP When checked, the agent will send a TRAP to the configured TRAP destinations indicating that a Management Station attempted to contact the agent and used a community string that is not in the community list. Note In subagent mode, this may only be useful for debugging. The system service will perform Management Station authentication based on its configuration, and only forward the request to the ATTO agent once the Management Station is authenticated.
Test Save MIBs This button will validate the settings displayed on screen, and then send a warm Start trap to each of the displayed trap destinations as if the displayed settings had been committed. Selecting disabled mode, unchecking the enable traps option or removing all trap destinations will prevent the test trap from being sent. Once an acceptable configuration is entered, a commit is needed for it to take effect.
Exhibit 1.4.2--1 Panel Image Exhibit 1.4.2--2 Community Image 61 ATTO Technology Inc.
Exhibit 1.4.
1.5 Virtual Port Management The ConfigTool provides the ability to manage virtual ports on 8Gb and 16Gb Celerity HBAs installed on Windows platforms. Virtual port functionality is implemented by the Celerity driver according to the N_Port ID Virtualization (NPIV) extension to the Fibre Channel standard. The ConfigTool NPIV interface can be used to create, delete and monitor virtual ports on either a local or remote Windows host.
Status Virtual Port Count The NPIV status of the selected channel. This will be one of: • OK: Virtual ports can be created on this channel. • Disabled: NPIV is currently disabled on this channel. Refer to the Celerity Installation and Operation Manual for details on enabling NPIV. • Link Down: The physical link is down. • Unsupported Topology: The FC topology of the physical link does not support the creation of virtual ports.
Exhibit 1.5-2 The “Create Virtual Ports” window If the create operation fails, the ConfigTool will display the NPIV Error window, illustrated in Exhibit 1.5-3. Refer to the NPIV Troubleshooting section for a complete list of the errors that can occur during port creation and recommendations for correcting common problems. Exhibit 1.5-3 The “NPIV Error Message” window. The displayed message varies depending on the error.
Exhibit 1.5-4 The “Delete Confirmation” window • If the delete operation fails, the ConfigTool will display the NPIV Error window, illustrated in Exhibit 1.5-3. Refer to the NPIV Troubleshooting section for a complete list of the errors that can occur during port deletion and recommendations for correcting common problems. Click Yes in the Delete Confirmation window to delete the port.
NPIV Status Explanation Corrective Action • Refer to the Celerity Installation and The NPIV feature is disabled on the Operation Manual for details on enabling adapter. NPIV on the adapter. • Verify that a working SFP is installed in the selected channel and the Fibre Channel cables are properly connected. Disabled Link Down • Verify that the Data Rate NVRAM setting for the selected channel is either Auto or set to a speed that the switch supports.
Error Message Occurs On...
Error Message Occurs On... Explanation Recommended Action • Verify that a working SFP is installed in the selected channel and the Fibre Channel cables are properly connected. • Verify that the Data Rate NVRAM setting for the selected channel is either Auto or set to The physical link is a speed that the switch supports.a “The FC link is Create down on the selected • Verify that the Connection Mode NVRAM down” channel. setting for the selected channel is either PTP or PTP Preferred.
1.6 Troubleshoot the ATTO ConfigTool You may see an error message informing you about an unexpected event or incorrect information discovered by the application. Using the help text presented with the error message, correct the issue before proceeding. Warnings and error messages are posted in the Status area of the configuration utility. Messages from NVRAM tab actions An error occurred loading NVRAM data. The first time a channel is highlighted, the application tries to read NVRAM from the card.
2.0 BIOS Configuration Utility The BIOS driver for all ATTO storage controllers has a built-in BIOS Configuration Utility which manages the storage controller and the devices connected to the storage controller. The BIOS Configuration Utility for ATTO storage controllers uses a standard menu/choice model. The Main Menu presents the functions available from the utility. Selecting an item on the menu may bring up a secondary menu or a dialog box. The dialog box displays the items managed by that dialog box.
Common BIOS Configuration Utility functions Selectable Boot Device Format disk drives Allows you to select a disk drive or stripe group from which the system BIOS loads the operating system. Select the primary drive from any stripe set or any nonstriped drive. Changing from No to Yes displays candidate disk drives. 1 2 3 Select drives to format by checking boxes for each drive. Press the Enter key. A confirmation message displays. Confirm the selected drives to be formatted.
2.1 FC BIOS Configuration Utility Default NVRAM settings work for most applications, but your particular hardware configuration may require some changes. Fibre Channel storage controller NVRAM settings may be changed from the BIOS Configuration Utility. The Configure Adapter Channels menu selection displays a dialogue which contains the parameters for a specific adapter. Adapter Node Name The Node WWN assigned to this channel of the adapter.
Boot Driver PCI Latency Timer Choices: enabled, scan only, disabled Default: disabled If enabled and disk drives or a bootable CD are detected during the bus scan, the BIOS driver remains resident. If disabled, the BIOS starts, resets the adapter chip and unloads the driver. If Scan Only selected, the BIOS driver scans the bus and displays the devices attached, then unloads itself after a brief delay.
2.2 SCSI BIOS Configuration Utility The default NVRAM settings work for most applications, but your particular hardware configuration may require some changes. SCSI storage controller NVRAM settings may be changed from the BIOS Configuration Utility. The default NVRAM settings work for most applications, but your particular hardware configuration may require some changes.
Quick Arbitrate & Select (Ultra320 only) Selection Timeout Choices: disabled, enabled Default: enabled Choices: 1ms-1 sec Default: 250ms Reduces the time required to gain control of the SCSI bus if all target settings are set to Sync DT-IU and all devices on the bus support QAS. Specifies the amount of time a device has to respond to being selected. Lower the setting to speed up the boot process. If the value is lower than the recommended 250 ms, it may be too fast for some devices to respond.
Sync Offset Sync Rate Choices: 1-127 Default: 127 Choices: varies by adapter, see Exhibit 2.2-1 Default: varies by adapter, see Exhibit 2.2-1 CAUTION The default values offer the best performance possible. Do not change this setting unless instructed by an ATTO technical support representative. If synchronous transfers are enabled, sets the maximum rate at which the ExpressPCI storage controller negotiates with each device attached to it.
2.3 ExpressSAS BIOS Utility The BIOS driver for the ATTO ExpressSAS storage controllers has a built-in BIOS Utility which manages the adapter and the devices connected to the adapter. The ExpressSAS BIOS Utility uses a standard menu/choice model. The Main Menu presents the functions available from the utility. Selecting an item on the menu may bring up a secondary menu or a dialog box. The dialog box displays the items managed by that dialog box.
Heartbeat Port Configuration (R348 only) Choices: enabled, disabled Default: enabled When enabled, requires the firmware to respond to periodic activity. If the firmware does not respond, the system driver resets the firmware on the adapter. Choices: 8 Internal or 4 Intrn, 4 Extrn Default: 8 Internal Indicates the active port configuration for the ExpressSAS R348 adapter. The 8Internal parameter indicates the two internal SAS connectors are active and the external connector is not active.
View Selected RAID Group Create a RAID group Type Enter to display more information about the highlighted RAID group. If a RAID group is rebuilding, the command displays the completion percentage of the rebuild. Selecting Create RAID Group starts a wizard. 1 Type a RAID group name. 2 Select a RAID level: 0, 1, 4, 5, 6, 10 or JBOD. 3 Select an Interleave: 8KB, 16KB, 32KB, 64KB, 128KB, 256KB, 512KB or 1MB. 4 Type Insert to add drives into the RAID group. 5 A drive list box of available drives is displayed.
2.4 EFI Configuration Utility The EFI drivers for ATTO Celerity 8Gb and ExpressSAS storage controllers have a built-in EFI Configuration Utility which manages the adapter and the devices connected to the adapter The EFI Configuration Utility for ATTO storage controllers uses a standard menu/choice model. The Main Menu presents the functions available from the utility. Selecting an item on the menu may bring up a secondary menu or a dialog box. The dialog box displays the items managed by the dialog box.
ExpressSAS EFI Utility The EFI driver for ATTO ExpressSAS storage controllers has a built-in EFI Utility which manages the adapter and the devices connected to the adapter. The ExpressSAS EFI Utility uses a standard menu/choice model. The Main Menu presents functions available from the utility. Selecting an item on the menu may bring up a secondary menu or a dialog box. The dialog box displays the items managed by that dialog box. See Exhibit 2.4-2.
Configuring Adapter Settings The Configure Adapter Settings menu displays information about the ExpressSAS adapter, including: Channel Number Device Wait Time Allows you to select a specific ExpressSAS adapter from a list of installed ExpressSAS adapters. Firmware Version Choices: 1-255 seconds Default: 3 seconds This field specifies the number of seconds which the driver waits for devices to appear. Displays the firmware version of the selected ExpressSAS adapter.
Exhibit 2.4-3 The Display Drive List Menu Displaying the Drive List (ExpressSAS RAID adapter only) Selecting the Display Drive List menu item displays a list of all disks which are connected to the adapter with the following information for each: Chan Capacity Indicates the adapter number for the ExpressSAS RAID adapter to which the drive is connected. Displays the drive's byte capacity. ID Displays the drive ID number within the adapter. Vendor ID Displays the drive manufacturer's vendor name.
Exhibit 2.4-4 The Display Drive List Menu The Display Drive List menu highlights the first drive in the list. Use the up and down arrows to highlight other disks. Select the following functions from this menu: Select Drive Hot Spare Type Space Bar to allow multiple drives to be selected. The selected is removed by typing Space Bar a second time. Type H to assign the selected drives to the Hot Spare pool. Drives must be selected by typing Space Bar or E.
Exhibit 2.4-5 The Drive Details Window Configuring RAID groups (ExpressSAS RAID adapter only) Selecting the Configure RAID Groups menu displays a list of all detected RAID groups with the following information for each: Chan Drives Indicates the adapter number for the ExpressSAS RAID adapter to which the group belongs. Number of drives in the RAID group. ID Capacity The RAID group's total capacity. Displays the group ID number within the adapter. Group Name Status The RAID group's current status.
Exhibit 2.4-6 The Configure RAID Groups Menu The Configure RAID Groups menu highlights the first RAID group in the list. Use the up and down arrows to highlight other RAID groups. Select the following functions: Scan Automap Type S to clear and refresh the group list. Type M to automatically map all unmapped partitions on each adapter in the system. Create Type Insert to build a new RAID group. Delete Type Delete to delete the highlighted RAID group. A confirmation prompt must be answered.
Exhibit 2.4-7 The Group Details Window Create a RAID Group Selecting Create RAID Group starts a wizard. See Exhibit 2.4-8. Exhibit 2.
1 2 3 4 5 Type a RAID group name. The name must be unique and no more than 14 characters. Select a RAID Level: 0,1,4,5,6,10 or JBOD. Select an Interleave: 8KB, 16KB, 32KB, 64KB, 128KB, 256KB, 512KB, or 1MB Select a Sector Size: 512 B or 4KB. Select an Initialize type: Express or Advanced 6 7 8 Select a Partitioning Scheme: Single, By Count or By Size. Select a Mirror Count, a copy of the original data stored on a separate disk, for RAID groups that have mirrors.
Exhibit 2.4-10 After adding drives to a new RAID Group 10 Type Enter to create the RAID group. See Exhibit 2.4-11 on page 91.
Exhibit 2.4-11 Group creation finished CAUTION A rebuild occurs after creating a RAID Level 4, RAID Level 5, or RAID Level 6 group. The length of time required for the rebuild depends upon the size of the RAID group. Do not reboot the adapter until the rebuild process is complete. 91 ATTO Technology Inc. ATTO Utilities Installation and Operation Manual Note A RAID group is created with default properties which may be changed using the ConfigTool. Refer to ATTO ConfigTool on page 1.
3.0 ATTO Utilities for Windows The ATTO Utilities for Windows is a collection of programs which provide adapter management, device management and SAN management. These utilities execute on the Windows Server 2012, 2008, 2003, 2000; 8, 7, Vista and XP operating systems for x86 and x64 platforms. The ATTO Utilities for Windows are included in the CD which was delivered with your adapter. The suite content varies according to the adapter purchased.
3.1 Configure Mode Pages: Alamode Utility Alamode is a Windows utility to optimize disk drive performance by configuring mode pages without requiring specific knowledge of mode page parameters. A mode page or mode parameter page is a group of related settings or parameters which govern certain aspects of how a disk drive operates. Most drives come from the factory set for maximum compatibility to work safely and reliably with the widest range of hosts and systems.
3.2 ATTO Disk Benchmark The ATTO Utilities for Windows suite includes a utility to measure peak and sustained throughput for disk reads and disk writes. The ATTO Disk Benchmark measures peak and sustained throughput for disk reads and writes. 1 Launch the application. 2 Select the drive letter for the disk to benchmark. 3 Select the transfer sizes to test. 4 Select the I/O option. 5 Click the Start button. 6 Wait for benchmark to run through the desired transfer sizes.
• • • Stripe Group: If the test drive is a stripe group, select its name from the list box. The names and quantities of drives in the stripe group are printed to the Description box. Select Clear to clear the contents of the Description box. Controlled by displays all ATTO storage controllers on the system. Description: Enter additional information about the test which can be saved or printed.
3.3 FC LUN Masking Utility ATTO storage controller drivers allow you to select which devices and Logical Unit Numbers (LUNs) on a SAN are visible to Windows operating systems. Many devices, including RAID controllers and SCSIto-Fibre Channel bridges, use LUNs to allow access to multiple drive units through a single World Wide Name (WWN). However, you may not want to allow all users connected to one device to have access to all devices.
Saving and applying your changes 1 Click the Save Changes button on the bottom of the windows. Note You must have Write Access to the registry key and all its sub-keys to save changes. Consult your system administrator if you cannot save changes. Exhibit 3.3-1 2 If you want the changes to take effect immediately, click the Apply Changes button before exiting but after saving. This causes the driver to reread the registry settings and alter its internal device database. ATTO LUN Masking Utility page.
3.4 SNIA FC Storage Controller API API, or Application Programming Interface, is a set of commands used by an application directing the operating system to perform certain tasks. ATTO storage controllers use API Version 1.0 as defined by the Storage Network Industry Association (SNIA) Fibre Channel Work Group. The Common storage controller API Version 1.0, released in October 2000, is a vendor-neutral format for reporting information about storage controllers to upper level software applications.
3.5 Domain Validation Testing Domain Validation tests the physical connection between storage controller and devices to ensure the desired data transfer speeds can be achieved. Domain Validation verifies the connection between the storage controller and storage devices (i.e. cables, connectors, targets, etc.) is capable of handling highspeed data transfers. The ATTO SCSIDV utility performs Domain Validation on your storage connection. The three DV tests can be selected in the SCSIDV Main page.
Exhibit 3.5-1 The Domain Validation Utility page.
3.6 ExpressPCI SCSI Setup Utility The ExpressPCI Setup Utility changes the same NVRAM parameters as described for the ATTO ConfigTool earlier in this manual. Modifying NVRAM settings 1 2 3 Locate the ExpressPCI Setup Utility application icon on your hard drive. Double-click the icon to start the application. Make the desired changed to the IDs. Multiple IDs can be modified simultaneously using the buttons at the bottom of the Main Menu.
3.7 Troubleshoot ATTO Utilities for Windows The following suggestions may help if you are having problems. • • • • • Using the Device Manager, ensure all drives are visible to the operating system. If drives are not visible, check all cable connections and terminations on each device. Make sure each device is powered up and has completed its self check before booting your machine. Reboot your system any time you make changes to a stripe group.
Appendix A CLI provides an ASCII-based interface The RAID CLI tab in the ATTO ConfigTool allows experienced users to enter RAID Command Line Interface (CLI) commands to the SAS RAID adapter.The CLI uses ASCII commands typed while in CLI mode. CAUTION Do not use the CLI unless you are directed to by an ATTO technician. Changing parameters may cause loss of data and/or disruption to performance and reliability of the ExpressSAS storage controller.
Exhibit A-1 Symbols, typefaces and abbreviations used to indicate functions and elements of the command line interface used in this manual. Symbol Indicates [ ] < > | n-n BlockDevID GroupName MemberIndex PartIndex SASIndex TID Required entry Optional entry Pick one of A range (6 – 9 = 6, 7, 8, 9) Index designation of a block device not assigned to any other RAID group; the index of a block device provided by the BlockDevScan (Immediate, Disabled on Error) command.
ERROR Invalid number of Partitions specified ERROR Invalid Span Depth specified ERROR Cannot perform operation on mapped Partition ERROR Cannot perform operation. RAID Group has mapped Partitions ERROR Cannot perform operation.
Command ClearEventLog Date DeleteScheduledTasks DisplayScheduledTasks DriveAssureReport DriveHealth DriveHealthDisplay DriveHealthStatus DriveTest DriveTestClearList DriveTestConfig DriveTestList DriveTestStatus DumpConfiguration DumpEventLog EventLog EventLogFilter FUAWrites Help HSAdd HSDisplay HSRemove IdentifyBridge Info IsReserved MediaScanErrorReport Metrics MirrorIdentify MirrorIdentifyStop OEMConfigFile Partition PartitionDisplay PartitionMerge PartitionSplit PartitionWriteCache PassThroughMode Pass
Command RGCancelAddStorage RGCancelMediaScan RGCommit RGCreate RGDiskWriteCache RGDisplay RGErase RGHaltConversion RGHaltErase RGHaltInitialization RGHaltMediaScan RGHaltRebuild RGMediaScan RGMediaScanErrorReport RGMemberAdd RGMemberRemove RGPrefetch RGReadDirect RGRebuild RGRecover RGRecoverWithWrites RGResumeConversion RGResumeErase RGResumeInitialization RGResumeMediaScan RGResumeRebuild RGSectorSize RGSpanDepth RGSpeedRead RGUnmap RGWaitTimeout RMStatus Route RouteDisplay SasPortList SASTargets SaveConf
Command Default Example SESPoll SESStartingSlot SESStatus Temperature Time TimeZone VerboseMode VirtualDriveInfo 30 1 set sespoll 0 EST enabled get temperature set time 03:32:30 set timezone pst set verbosemode disabled virtualdriveinfo CLI command explanations Command Line Interface commands are listed alphabetically with explanations of what they are used for, their defaults and syntax.
BlockDevScan (Immediate, Disabled on Error) BlockDevScan lists all currently connected physical block devices along with any potential RAID Group association. Each block device listed is assigned a unique index at the time of the scan. This index is used to identify block devices for other CLI operations. Usage: BlockDevScan BuzzerOnError (OEM Configurable) (6Gb RAID Adapter w/CacheAssure) When enabled, the audible alarm will sound under error conditions. When disabled, the audible alarm is muted.
DriveHealthDisplay (Immediate, Disabled on Error) DriveTestStatus Retrieves and displays S.M.A.R.T. data from SATA disk drives, and MEDIUM DEFECT and INFORMATION EXCEPTIONS counts from other drives. Issuing this command during I/O operations may adversely affect performance. S.M.A.R.T data may be optionally filtered by attribute type: Performance, Error Rate, Event Count, Critical, or All. If filtering is used, only data for SATA drives is shown. Displays the status of the currently running drive test.
HSAdd (Immediate) MirrorIdentifyStop(Immediate) Assigns a Block Device to the Hot Spare pool. MirrorIdentifyStop stops identifying the specified set of RAID Group drives. GroupName with no mirror number stops identifying all drives in the RAID Group. Usage: HSAdd [BlockDevID] HSDisplay (Immediate) Usage: HSDisplay outputs a list of all of the devices in the Hot Spare pool. OEMConfigFile (Disabled on Error) Usage: HSDisplay HSRemove (Immediate) Removes a Block Device from the Hot Spare pool.
PartitionWriteCache Enable RAID internal Write Cache for higher write performance with a small risk of data loss after a system failure. Disable RAID internal Write Cache for a higher level of data integrity with lower write performance. Usage: set PartitionWriteCache [GroupName] [PartIdx] [enabled | disabled] get PartitionWriteCache [GroupName] [PartIdx] | all] RAIDSpeedWriteLimit (OEM Configurable, Disabled on Error) Set or get the limit on the coalescing factor.
RGAutoRebuild RGDisplay (Immediate) RGAutoRebuild enables and disables Auto-Rebuild functionality for one or more RAID Groups. Auto-Rebuild uses drives assigned as Hot Spares, followed by available drives, as automatic replacements for any member that fails. Auto-Rebuild is disabled by default. RGDisplay displays RAID Group status information. GroupName is an ASCII name for an existing RAID Group. Usage: RGErase erases the data from the specified existing RAID Group.
RGMediaScanErrorReport (Immediate, Disabled on Error) Displays error statistics for either a single RAID Group or all RAID Groups in the system. Usage: RGMediaScanErrorReport [GroupName | all] RGMemberAdd (Immediate) RGMemberAdd adds available block devices to a NEW RAID Group or as part of an RGAddStorage operation. GroupName is the ASCII name of the RAID Group to receive the RAID Member. BlockDevID is the index of an available block device provided by the BlockDevScan CLI command.
RGSectorSize RMStatus (Immediate) Set or get the sector size of the specified RAID Group. The desired RAID Group sector size must be evenly divisible by the sector size of any member disk. 512 bytes is the default size for most operating systems. Use 4 KB sectors to enable large volume support (greater than 2 TB) in Windows XP (32-bit). RMStatus displays the status of all RAID Members within the specified RAID Group or a specific RAID member (if specified) within the specified RAID Group.
SES (OEM Configurable, Disabled on Error) SESIdentifyStop (Immediate, Disabled on Error) SES enables support for SES enclosures that have been discovered by the system. SESIdentifyStop commands the appropriate SES enclosure to stop identifying the specified element(s). “ALL” stops identifying all enclosures' drive slots. “RAID” and RAID Group name stops identifying disks in a RAID Group. “ENC” and enclosure index stops identifying all slots in the specified enclosure.
Time (Disabled on Error) VerboseMode (OEM Configurable) Time sets/displays the current time in 24 hour format. VerboseMode controls the level of detail in CLI 'Help' output and command response output for the current CLI session. Usage: set Time [HH:MM:SS] get Time TimeZone (OEM Configurable, Disabled on Error) Timezone sets/displays the time zone or an offset from GMT.
Appendix B Glossary Some terms used in the Fibre Channel industry are defined below. More information is available through the ATTO Technology website (www.attotech.com), the Fibre Channel Industry Association, Cern, the Storage Area Networking Industry Association (www.snia.org), and the Fibre Channel Consortium. Term ANSI arbitrate Definition American National Standards Institute. The process of selecting one L_Port from a collection of ports which ask for use of the arbitrated loop at the same time.
Term L_port LED Definition A port in an arbitrated loop, either a NL_port or a FL_port. Light-Emitting Diode: a type of diode which emits light when current passes through it. Visible LEDs are used as indicator lights on all sorts of electronic devices. LUN Logical Unit Number: an identifier for a logical unit (0-7). multi-mode fiber An optical fiber which can carry several beams of light at once. N_port A port attached to a node used with Point-to-Point or fabric configurations.
