Adaptec CDP-00276-01-A User Manual

Raid controller command line utility

Advertisement

Quick Links

.
Adaptec RAID Controller
Command Line Utility
User's Guide
CDP-00276-01-A Rev. A
Issue: September 17, 2012

Advertisement

Table of Contents
loading

Summary of Contents for Adaptec CDP-00276-01-A

  • Page 1 Adaptec RAID Controller Command Line Utility User's Guide CDP-00276-01-A Rev. A Issue: September 17, 2012...
  • Page 2 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.
  • Page 3 Adaptec RAID Controller Command Line Utility User's Guide Revision History Issue Issue Date Details of Change 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. A, Issue:...
  • Page 4: Table Of Contents

    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....................10 Installing the Command Line Utility......................10 Installing on Windows........................10 Installing on Red Hat, Cent OS, SuSE, or Fedora Linux..............11 Installing on Debian or Ubuntu Linux....................11...
  • Page 5: List Of Tables

    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. A, Issue:...
  • Page 6: Adaptec By Pmc Product Support

    • Visit our Web site at www.adaptec-europe.com. • German: Call +49 89 43 66 55 22. For support via e-mail, submit your question at ask-de.adaptec.com. • French: Call +49 89 43 66 55 33. For support via e-mail, submit your question at ask-fr.adaptec.com.
  • Page 7: Software License Agreement

    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.
  • Page 8 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.
  • Page 9 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. A, Issue:...
  • Page 10: Getting Started With The Command Line Utility

    Adaptec RAID Controller Command Line Utility User's Guide 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. This utility allows you to: • Create and delete logical drives •...
  • Page 11: Installing On Red Hat, Cent Os, Suse, Or Fedora Linux

    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.
  • Page 12: Installing On Freebsd

    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/<mount point>/maxview/solaris_x86/manager/StorMan.pkg 3. At the prompt to continue, select , then press Enter 4. Enter the following configuration details: Enter your username [default: root].
  • Page 13: Installing On Vmware Esxi 5.0

    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.
  • Page 14: Installing On A Vmware Guest Os

    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...
  • Page 15: Using The Command Line Utility

    Adaptec RAID Controller Command Line Utility User's Guide 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.
  • Page 16: Arcconf Atapassword

    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 <Controller#> SET <new password> <Channel# ID#> ...
  • Page 17 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 <Controller#> <LOGICALDRIVE|MAXCACHE> [Options] <Size> <RAID#> <CHANNEL# DRIVE#> [CHANNEL# DRIVE#] ... [noprompt] [nologs] ARCCONF CREATE <Controller#> LOGICALDRIVE RVOLUME <LD#> <LD#> [LD#] ...
  • Page 18: Logical Drive

    Adaptec RAID Controller Command Line Utility User's Guide Logical Drive Logical Drive indicates the logical drive stripe size with the following options: • Stripesize <STRIPE>—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.
  • Page 19: Arcconf Datascrub

    Adaptec RAID Controller Command Line Utility User's Guide 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...
  • Page 20: Arcconf Driverupdate

    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.
  • Page 21: Arcconf Failover

    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 <Controller#> <on|off> Parameters Controller# The controller number. Turns the controller failover mode on. Turns the controller failover mode off.
  • Page 22: Arcconf Getlogs

    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: •...
  • Page 23: Arcconf Getperform

    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 <Controller#> [Performance Mode] [Save [Filename]] [Nologs]...
  • Page 24: Arcconf Getstatus

    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.
  • Page 25: Arcconf Identify

    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. Syntax ARCCONF IDENTIFY <Controller#> LOGICALDRIVE <LogicalDrive#> ARCCONF IDENTIFY <Controller#> DEVICE <Channel#> <ID>...
  • Page 26 Adaptec RAID Controller Command Line Utility User's Guide Channel# Channel number of the device to be updated. 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.
  • Page 27: Arcconf Key

    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 <Controller#> SET <Key#> Parameters Controller# The controller number.
  • Page 28: Arcconf Playconfig

    Adaptec RAID Controller Command Line Utility User's Guide 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.
  • Page 29 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.
  • Page 30: Arcconf Rescan

    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.
  • Page 31: Arcconf Saveconfig

    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 <Controller#> <BaseName> [Newversion <build#> [Force]] [noprompt] Parameters Controller# The controller number...
  • Page 32: Arcconf Savesupportarchive

    Description Saves configuration and status information to help Adaptec Customer Support diagnose a problem with your system. Saved information includes (but is not limited to) device logs, drive logs, event logs, error logs, controller logs, and SSD SMART statistics. (For more information about SMART statistics, see...
  • Page 33: Arcconf Setcache

    Adaptec RAID Controller Command Line Utility User's Guide 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. Syntax ARCCONF SETCACHE <Controller#>...
  • Page 34: Arcconf Setconfig

    • Auto Volume Mode—All RAID functions of the controller are enabled. Attached drives without Adaptec meta-data, but with an OS partition, are surfaced to the host operating system as Pass Through devices, where the RAID layer of the controller firmware is bypassed when the host issues commands to the device.
  • Page 35: Arcconf Setmaxcache

    Adaptec RAID Controller Command Line Utility User's Guide You must reboot the controller after you change the controller mode. Syntax: ARCCONF SETCONTROLLERMODE <Controller#> <Controller Mode> [nologs] Parameters Controller# Controller number. Controller Mode One of the following values: • 0 - Default/RAID Mode •...
  • Page 36 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.
  • Page 37: Arcconf Setname

    Adaptec RAID Controller Command Line Utility User's Guide Examples ARCCONF SETMAXCACHE 1 LOGICALDRIVE 1 READCACHE ENABLE ARCCONF SETMAXCACHE 1 LOGICALDRIVE 1 WRITECACHE ENABLE WRITEPOLICY WT ARCCONF SETMAXCACHE 1 DIRTYPAGETHRESHOLD 50 ARCCONF SETMAXCACHE 1 ADDTOPOOL 0 1 ARCCONF SETMAXCACHE 1 REMOVEFROMPOOL 0 1 0 2...
  • Page 38: Arcconf Setncq

    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.
  • Page 39: Arcconf Setpower

    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 <Controller#> Stayawake DISABLE| <startime> <endtime>...
  • Page 40: Arcconf Setpriority

    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.
  • Page 41: Arcconf Setstatsdatacollection

    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. Logical drive number. State • HSP—Create a hot spare from a ready drive • RDY—Remove a hot spare designation •...
  • Page 42: Arcconf Setvmcredential

    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 <Esxip> <Esxcimomport> <Esxuserid> <Esxpassword> [noprompt] Parameters Esxip Hypervisor IP address. Esxcimomport Hypervisor CiMOM port number.
  • Page 43: Arcconf Uninit

    Adaptec meta-data and any OS partitions from a drive. Drives can uninitialized only if they are in the Raw or Ready state (that is, not part of any logical drive). A drive in the Raw state has no Adaptec meta-data but may or may not have an OS partition.
  • Page 44 Adaptec RAID Controller Command Line Utility User's Guide 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.
  • Page 45 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. Part Number: CDP-00276-01-A Rev A JPB 03/11...

Table of Contents