. Adaptec RAID Controller Command Line Utility User's Guide CDP-00276-01-A Rev.
Adaptec RAID Controller Command Line Utility User's Guide Copyright © PMC-Sierra, Inc. All rights reserved. The information in this document is proprietary and confidential to PMC-Sierra, Inc. In any event, no part of this document may be reproduced or redistributed in any form without the express written consent of PMC-Sierra, Inc. CDP-00276-01-A Rev. A, IssueNumber None of the information contained in this document constitutes an express or implied warranty by PMC-Sierra, Inc.
Adaptec RAID Controller Command Line Utility User's Guide Revision History Issue Issue Date Details of Change 1.0 September 17, Adaptec Firmware/BIOS/Drivers/Utilities Version 8.0 2012 Proprietary and Confidential to PMC-Sierra, Inc. Document No.: CDP-00276-01-A Rev.
Adaptec RAID Controller Command Line Utility User's Guide Contents Adaptec by PMC Product Support..............................................................................................................................6 Software License Agreement......................................................................................................................................7 1 Getting Started with the Command Line Utility.............................................................................
Adaptec RAID Controller Command Line Utility User's Guide List of Tables Table 1: ARCCONF Batch Environments .............................................................................................................15 Table 2: ARCCONF Commands ...........................................................................................................................15 Proprietary and Confidential to PMC-Sierra, Inc. Document No.: CDP-00276-01-A Rev.
Adaptec RAID Controller Command Line Utility User's Guide Adaptec by PMC Product Support If you have questions about installing or using your Adaptec by PMC product, check this document first—you will find answers to most of your questions. If you need further assistance, use the support options listed below. To expedite your service, have your computer in front of you. Technical Support Identification (TSID) Number • Before contacting Technical Support, you need your product unique TSID number.
Adaptec RAID Controller Command Line Utility User's Guide Software License Agreement PLEASE READ CAREFULLY: THE USE OF THIS SOFTWARE IS SUBJECT TO THE SOFTWARE LICENSE TERMS OF PMC-SIERRA, INC. AND OTHER LICENSORS WHOSE SOFTWARE MAY BE BUNDLED WITH THIS PRODUCT. BY YOUR USE OF THE SOFTWARE INCLUDED WITH THIS PRODUCT YOU AGREE TO THE LICENSE TERMS REQUIRED BY THE LICENSOR OF THAT SOFTWARE, AS SET FORTH DURING THE INSTALLATION PROCESS.
Adaptec RAID Controller Command Line Utility User's Guide 7. Limited Warranty. PMC-Sierra and its Licensor warrant only that the media upon which the Software is furnished will be free from defects in material or workmanship under normal use and service for a period of thirty (30) days from the date of delivery to you. PMC-SIERRA AND ITS LICENSORS DO NOT AND CANNOT WARRANT THE PERFORMANCE OR RESULTS YOU MAY OBTAIN BY USING THE SOFTWARE OR DOCUMENTATION.
Adaptec RAID Controller Command Line Utility User's Guide Sunnyvale, CA 94089 (408) 239-8000 Proprietary and Confidential to PMC-Sierra, Inc. Document No.: CDP-00276-01-A Rev.
Adaptec RAID Controller Command Line Utility User's Guide 1 Getting Started with the Command Line Utility This chapter explains how your Adaptec® by PMC™ RAID controllers support the use of the ARCCONF command line utility.
Adaptec RAID Controller Command Line Utility User's Guide Installing on Red Hat, Cent OS, SuSE, or Fedora Linux To install ARCCONF on Red Hat, Cent OS, SuSE, or Fedora Linux: 1. Insert the Adaptec Installation DVD. The Installation DVD mounts automatically. If it doesn't, mount it manually. 2. Change to the Linux manager directory: cd /media/cdrom/maxview/linux/manager 3. Install the .bin file: Options Description 32-bit ./StorMan-9.00.i386.bin 64-bit ./StorMan-9.00.x86_64.bin 4.
Adaptec RAID Controller Command Line Utility User's Guide mount -F hsfs -o ro/dev/dsk/c1t0d0s2/mnt 2. Install the maxView Storage Manager package: pkgadd -d//maxview/solaris_x86/manager/StorMan.pkg 3. At the prompt to continue, select y, then press Enter. 4. Enter the following configuration details: Enter your username [default: root]. Enter your operating system password. Enter the CIM Server HTTP Port: [default:5988]. When the installation completes a confirmation message is displayed. 5.
Adaptec RAID Controller Command Line Utility User's Guide When the package is removed, you receive the message "The update completed successfully, but the system needs to be rebooted for the changes to be effective." 8. Reboot the system. 9. Stop operations. /etc/init.d/./sfcbd-watchdog stop 10. Install the arcconf package. esxupdate -b /tmp/vmware-esx-provider-arcconf.
Adaptec RAID Controller Command Line Utility User's Guide 10. Reboot the system. 11. Continue the installation with Installing on a VMware Guest OS on page 14. Installing on a VMware Guest OS Note: You must complete the steps in Installing on VMware ESX 4.1 on page 12 or Installing on VMware ESXi 5.0 on page 13 before continuing. To install ARCCONF on a VMware guest operating system: 1. Insert the Adaptec Installation DVD. 2.
Adaptec RAID Controller Command Line Utility User's Guide 2 Using the Command Line Utility This chapter explains how to use the command line utility interactively or in batch mode. With interactive mode, enter commands at the prompt. In batch mode, create scripts and run the script in the appropriate shell, as described in the table below. Table 1: ARCCONF Batch Environments Environment Batch File Run Script Windows .bat CMD.EXE Linux/Unix .
Adaptec RAID Controller Command Line Utility User's Guide arcconf atapassword Description Sets or clears the Secure Erase password for SATA drives. See arcconf task for more information about Secure Erase. Syntax ARCCONF ATAPASSWORD SET ... ARCCONF ATAPASSWORD CLEAR ...
Adaptec RAID Controller Command Line Utility User's Guide On redundant logical drives, ARCCONF performs autosynchronization. ARCCONF presents JBODs as physical devices, not logical drives. Syntax ARCCONF CREATE [CHANNEL# ARCCONF CREATE [noprompt] [nologs] ARCCONF CREATE [noprompt] [nologs] [Options] DRIVE#] ... [noprompt] [nologs] LOGICALDRIVE RVOLUME [LD#] ...
Adaptec RAID Controller Command Line Utility User's Guide Logical Drive Logical Drive indicates the logical drive stripe size with the following options: • Stripesize —Allows the logical drive stripe size to be built. Optional parameters for specifying a stripe size. STRIPE is specified in kilobytes 16, 32, 64, 128, 256, 512 and 1024 are supported. The default is 256KB. • Legs —Optional parameters for specifying number of legs. Value is an integer. • LEG—Number of legs for RAID level 50 or 60.
Adaptec RAID Controller Command Line Utility User's Guide LD# Logical drive numbers for two or more logical drives to be concatenated into the RAID volume. Noprompt No prompt for confirmation Examples ARCCONF CREATE 1 LOGICALDRIVE STRIPESIZE 64 MAX 0 1 0 2 0 3 2 NOPROMPT ARCCONF CREATE 1 JBOD 0 1 NOPROMPT arcconf datascrub Description Toggles the background consistency check modes of the controller.
Adaptec RAID Controller Command Line Utility User's Guide Parameters Controller# Controller# is the controller number LogicalDrive# LogicalDrive# is the number of the logical drive to be deleted. LogicalDrive|JBOD ALL Deletes all logical drives or JBODs. MAXCACHE Deletes the maxCache Container. Noprompt Optional parameter that suppresses alert messages. Examples ARCCONF DELETE 1 LOGICALDRIVE 1 2 3 ARCCONF DELETE 1 JBOD ALL arcconf driverupdate Description Updates Windows device drivers.
Adaptec RAID Controller Command Line Utility User's Guide Examples ARCCONF DRIVERUPDATE C:\WINDOWSALL arcconf failover Description Turns automatic failover on and off. Syntax ARCCONF FAILOVER Parameters Controller# The controller number. On Turns the controller failover mode on. Off Turns the controller failover mode off.
Adaptec RAID Controller Command Line Utility User's Guide AD/LD/PD/AL • • • • • AD—Adapter information only LD—Logical drive information only PD—Physical device information only MC—maxCache information only AL—All information (optional) Examples ARCCONF GETCONFIG 1 AD arcconf getlogs Description Provides access to controller status and event logs and usage statistics, including: • DEVICE—A log of device errors that the controller encountered. • DEAD—A log that records any occurrences of defunct devices.
Adaptec RAID Controller Command Line Utility User's Guide Examples ARCCONF GETLOGS 1 DEVICE ARCCONF GETLOGS 1 STATS Tabular arcconf getperform Description Fetches the parameters that define a logical drive performance mode. Default is the current mode. Syntax ARCCONF GETPERFORM [Performance Mode] [Save [Filename]] [Nologs] Parameters Controller# Controller number.
Adaptec RAID Controller Command Line Utility User's Guide Parameters Controller# Controller number. Tabular Creates output in tabular format. Examples ARCCONF GETSMARTSTATS 1 ARCCONF GETSMARTSTATS 1 TABULAR arcconf getstatus Description The GETSTATUS function displays the status of any background command that is currently running. Including information about the most recent rebuild, synchronization, logical-drive migration, and compaction/expansion.
Adaptec RAID Controller Command Line Utility User's Guide Parameters Controller# Controller# is the controller number Examples ARCCONF GETVERSION arcconf identify Description Identifies a physical or logical device by blinking its LEDs.
Adaptec RAID Controller Command Line Utility User's Guide Channel# Channel number of the device to be updated. ID# Device number of the device to be updated. ChunkSize# Chunk size, in bytes, to be used to update the firmware. For enclosures, the default value is 65536 bytes. Note: For SATA drives, the chunk size must be a multiple of 512. Filename Name of the firmware update file. Mode# Firmware update mode.
Adaptec RAID Controller Command Line Utility User's Guide Examples ARCCONF IMAGEUPDATE 1 DEVICE 0 83 16384 ados.lod 3 arcconf key Description Loads a feature key onto an Adaptec controller. Syntax ARCCONF KEY SET Parameters Controller# The controller number. Key# The key number provided by PMC. Examples ARCCONF KEY 1 SET ABCD EFGH IJKL MNOP QRST UVWX arcconf modify Description Morphs a logical device from one raid level to another (RAID Level Migration).
Adaptec RAID Controller Command Line Utility User's Guide TO Indicates that the modifications will follow Options: • Stripesize—indicates the stripe size in KB. Options are 16, 32, 64, 128, 256, 512, and 1024. the default is 256KB. • init_priority—is the priority level of the modification. Options are low, med, and high. • Legs— is the number of subarrays for a RAID level-50 or RAID level 60 array. Possible values are 2-16 legs and 3-16 drives/leg (to 48 drives maximum).
Adaptec RAID Controller Command Line Utility User's Guide Parameters Input XML File The pathname of the server template file. The default server template file is available at C:\PMCS\Logs\saveconfig.xml. LogFile Sets the pathname of the error log file. By default, the error log is available at C:\PMCS\Logs\playconfig.log. FORCE Forces deployment of the server even if the controller does not support all features, or the drive capacity does not match the configuration in the input XML file.
Adaptec RAID Controller Command Line Utility User's Guide Examples ARCCONF PLAYCONFIG server1_config.xml playconfig.log FORCE ALL arcconf rescan Description Enables the controller to check for the removal of any disk drives in the ready state and to check for the connection of any new disk drives to the controller. The command returns when the rescan is complete.
Adaptec RAID Controller Command Line Utility User's Guide 2. Be sure to copy the *.UFI update files from the DVD and not from the BIOS/Firmware update diskettes. Syntax ARCCONF ROMUPDATE [Newversion [Force]] [noprompt] Parameters Controller# The controller number BaseName The name of the ROM image basename or the fully qualified name if you have a set of controller ROM images. Note: All UFI files must be in the same directory prior to invoking ARCCONF.
Adaptec RAID Controller Command Line Utility User's Guide Parameters Input XML File The pathname of the server template file. The default name (if you omit this parameter) is C:\PMCS\Logs\saveconfig.xml. LogFile The pathname of the error log file. By default, the error log is available at C:\PMCS\Logs\saveconfig.log. Examples ARCCONF SAVECONFIG server1_config.xml C:\LOGS\SERVER1.
Adaptec RAID Controller Command Line Utility User's Guide Off Disables the alarm Silence Quiets the currently sounding alarm Test Triggers the alarm Examples ARCCONF SETALARM 1 TEST ARCCONF SETALARM 1 SILENCE arcconf setcache Description Changes a logical drive’s cache mode.
Adaptec RAID Controller Command Line Utility User's Guide Examples ARCCONF SETCACHE LOGICALDRIVE 1 RON ARCCONF SETCACHE DEVICE 0 0 WB arcconf setconfig Description Resets the controller's configuration. Logical drives are deleted, hard disks are reset to the READY state, and any controller settings are reset to default values. Syntax ARCCONF SETCONFIG DEFAULT [noprompt] Parameters Controller# The controller number Default Restores the controller's default configuration.
Adaptec RAID Controller Command Line Utility User's Guide You must reboot the controller after you change the controller mode. Syntax: ARCCONF SETCONTROLLERMODE [nologs] Parameters Controller# Controller number. Controller Mode One of the following values: • 0 - Default/RAID Mode • 1 - Auto Volume Mode • 2 - HBA Mode nologs Suppresses log output for the command.
Adaptec RAID Controller Command Line Utility User's Guide Parameters Controller# The controller number. LogicalDrive# The number of the logical drive. You can specify one or more logical drives. Channel# The channel number for the SSD. Device# The device number for the SSD. Read#/Write# The read/write ratio for invalidating data on the SSD. When the ratio is reached, the page is removed from the cache. Values range from 1-10 for each parameter.
Adaptec RAID Controller Command Line Utility User's Guide Examples ARCCONF ARCCONF ARCCONF ARCCONF ARCCONF ARCCONF ARCCONF ARCCONF SETMAXCACHE SETMAXCACHE SETMAXCACHE SETMAXCACHE SETMAXCACHE SETMAXCACHE SETMAXCACHE SETMAXCACHE 1 1 1 1 1 1 1 1 LOGICALDRIVE 1 READCACHE ENABLE LOGICALDRIVE 1 WRITECACHE ENABLE WRITEPOLICY WT DIRTYPAGETHRESHOLD 50 ADDTOPOOL 0 1 REMOVEFROMPOOL 0 1 0 2 RWBALANCE 4 1 FLUSHANDFETCHRATE 200 CLEAR arcconf setname Description Renames a logical drive.
Adaptec RAID Controller Command Line Utility User's Guide Examples ARCCONF SETNAME 1 LOGICALDRIVE 1 BACKUP_A arcconf setncq Description Changes the controller’s Native Command Queuing (NCQ) setting to enabled or disabled. This setting affects the SATA disk drives on the controller. It takes effect when the SATA drives are restarted.
Adaptec RAID Controller Command Line Utility User's Guide Examples ARCCONF SETPERFORM 1 2 ARCCONF SETPERFORM 1 3 arcconf setpower Description Changes power management settings for disk drives on a controller or logical drive. Syntax ARCCONF SETPOWER Stayawake DISABLE| ARCCONF SETPOWER Spinup Parameters Controller# The controller number Stayawake Sets the stayawake period for the disk drives on the controller.
Adaptec RAID Controller Command Line Utility User's Guide Note: For the Slowdown, Poweroff, and Verify timers, st# must be less than pt#, and pt# must be less than vt#. You can set one or more timers, in any order, in a single command. Keep in mind that the Verify timer, vt#, is specified in hours; the other two timers are specified in minutes.
Adaptec RAID Controller Command Line Utility User's Guide Parameters Controller# The controller number Channel# The channel number for the drive. Device# Device number for the device. LD# Logical drive number. State • HSP—Create a hot spare from a ready drive • RDY—Remove a hot spare designation • DDD—Force a drive offline (to Failed) MAXCACHE Optional keyword for maxCache devices only. Include if State is HSP or RDY, and the hot spare is for a maxCache device.
Adaptec RAID Controller Command Line Utility User's Guide Examples ARCCONF SETSTATSDATACOLLECTION 1 ENABLE arcconf setvmcredential Description Resets the Hypervisor login credentials for VMware Guest OSs. Syntax SETVMCREDENTIAL [noprompt] Parameters Esxip Hypervisor IP address. Esxcimomport Hypervisor CiMOM port number. Esxuserid Hypervisor user name. Esxpassword Hypervisor password. Examples ARCCONF SETVMCREDENTIAL 172.18.46.
Adaptec RAID Controller Command Line Utility User's Guide LogicalDrive# Number of the logical drive in which the task is to be performed • Logical drive options: ∘ verify_fix (Verify with fix)—verifies the logical drive redundancy and repairs the drive if bad data is found. ∘ verify—verifies the logical drive redundancy without repairing bad data. ∘ clear—removes all data from the drive. • Physical device options: ∘ verify_fix—verifies the disk media and repairs the disk if bad data is found.
Adaptec RAID Controller Command Line Utility User's Guide ALL Uninitializes all physical devices in the Raw or Ready state. nologs Suppresses log output for the command. Examples ARCCONF UNINIT 1 0 12 0 13 ARCCONF 1 ALL Proprietary and Confidential to PMC-Sierra, Inc. Document No.: CDP-00276-01-A Rev.
PMC-Sierra, Inc. 1380 Bordeaux Drive Sunnyvale, CA 94089 USA © Copyright PMC-Sierra, Inc. 2012 All rights reserved. Adaptec and the Adaptec by PMC logo are trademarks of PMC-Sierra, Inc.