Storage‎ > ‎Storage-disk‎ > ‎

arcconf command examples ( Adaptec ARRAY Controller )

Thank you for visiting this page, this page has been update in another link Arcconf command examples
ARCCONF is a command line tool for Adaptec RAID controller. It manages the RAID controller, which includes create,delete and get status functions etc.. Here are some mostly used functions of the tool on Linux

How to run

simple run arcconf, it will print out the usage for you.

Create array

Syntax

arcconf create controller-number logicaldrive [stripesize size] [legs number] [name name] [priority low | medium | high] [Method build | clear | quick] [ron | roff] [wt | tb | wbb]] [size | max] [RAID-number] [channel-number channel-ID-number] [noprompt]

Before you get started to create arrays, you may need to check physical disks

# arcconf getconfig 1 PD
Controllers found: 1
----------------------------------------------------------------------
Physical Device information
----------------------------------------------------------------------
      Device #0
         Device is a Hard drive
         State                              : Online
         Supported                          : Yes
         Transfer Speed                     : SAS 3.0 Gb/s
         Reported Channel,Device            : 0,0
         Reported Location                  : Enclosure 0, Slot 0
         Reported ESD                       : 2,0
         Vendor                             : IBM-ESXS
         Model                              : ST3300656SS
         Firmware                           : BA47
         Serial number                      : 3QP1AKHH
         World-wide name                    : 5000C5001266F7C0
         Size                               : 286102 MB
         Write Cache                        : Disabled (write-through)
         FRU                                : 43X0805
         PFA                                : No
Example:
arcconf create 1 logicaldrive STRIPESIZE 64 MAX 0 1 0 1 1 1 2 noprompt

Getconfig

Usage: GETCONFIG <Controller#> [AD | LD [LD#] | PD | [AL]]

    Option  AD  : Adapter information only
            LD  : Logical drive information only
            LD# : Optionally display information about the specified logical drive
            PD  : Physical drive information only
            AL  : All information (optional)

Example:

# arcconf getconfig 1 LD
Controllers found: 1
----------------------------------------------------------------------
Logical drive information
----------------------------------------------------------------------
Logical drive number 0
   Logical drive name                       : sys
   RAID level                               : 1
   Status of logical drive                  : Okay
   Size                                     : 285999 MB
   Read-cache mode                          : Enabled
   Write-cache mode                         : Enabled (write-back)
   Write-cache setting                      : Enabled (write-back) when protected by battery
   Partitioned                              : Yes
   Protected by Hot-Spare                   : No
   Bootable                                 : Yes
   Defunct stripes                          : No
   --------------------------------------------------------
   Logical drive segment information
   --------------------------------------------------------
   Segment 0                                : Present (0,0) 3QP1AKHH
   Segment 1                                : Present (0,1) 3QP1AJF9

Logical drive number 1
   Logical drive name                       : data1
   RAID level                               : 1
   Status of logical drive                  : Okay
   Size                                     : 285999 MB
   Read-cache mode                          : Enabled
   Write-cache mode                         : Enabled (write-back)
   Write-cache setting                      : Enabled (write-back) when protected by battery
   Partitioned                              : Yes
   Protected by Hot-Spare                   : No
   Bootable                                 : No
   Defunct stripes                          : No
   --------------------------------------------------------
   Logical drive segment information
   --------------------------------------------------------
   Segment 0                                : Present (0,2) 3LM524G6
   Segment 1                                : Present (0,3) 6SJ7ADAK

Getstatus

Usage: GETSTATUS <Controller#>
 ======================================================

 Displays the status of any background task that is currently running.

Example:

# arcconf getstatus 1
Controllers found: 1
Logical drive Task:
   Logical drive                  : 0
   Task ID                        : 101
   Current operation              : Rebuild
   Status                         : In Progress
   Priority                       : High
   Percentage complete            : 63

Command completed successfully.

Setname

 Usage: SETNAME <Controller#> LOGICALDRIVE <LogicalDrive#> <New Name>
 ======================================================

 Rename a logical drive.

    LogicalDrive# : Number of the logical drive to be renamed
    New Name      : New name of the logical drive.

Example

arcconf SETNAME 1 LOGICALDRIVE 1 drive2

Setcache

 Usage: SETCACHE <Controller#> LOGICALDRIVE <LogicalDrive#> <cache mode> [noprompt]
 Usage: SETCACHE <Controller#> DEVICE [sas wb|wt] [sata wb|wt]
 ======================================================

 Changes a logical drive's or a controller's cache mode.

  LOGICALDRIVE - Changes a logical drive's cache mode.
    LogicalDrive#  : Number of the logical drive whose cache will be altered
    Logical Modes  : ron     - read cache enabled
                     roff    - read cache disabled
                     wt      - write through
                     wb      - write back
                     wbb     - write back with battery

  DEVICE - Changes a controller's global physical drive cache policy
    Physical Modes : sas wb  - sets all Serial Attached SCSI drives to write back
                     sas wt  - sets all Serial Attached SCSI drives to write through
                     sata wb - sets all Serial ATA drives to write back
                     sata wt - sets all Serial ATA drives to write through

Example:

arcconf setcache 1 LOGICALDRIVE 1 wbb

Delete array

 Usage: DELETE <Controller#> LOGICALDRIVE <ld#> [ld#] ... [noprompt]
 Usage: DELETE <Controller#> LOGICALDRIVE ALL [noprompt]
 ======================================================

 Delete one or more logical drives from the controller.

    ld#      : Number of the logical drive to be deleted
    ALL      : Deletes all logical drives
    noprompt : Don't prompt for confirmation.

Deleting is easy, but with data on it, you need to pay extrem attention on it. I'd like to share a bit more here.

Assume you have 3 mirrored logical drives, you want remove one of them for other purpose. Question is that how to identify which physical disks you need to remove them out.

1. Identify the disk from OS level if it's not being used, for example /dev/sdc, use your own way.

2. figure out mapping between sdc to one of logical array

a. scsi_id tool , it prints out logical drive name and SN, if you don't have logical drive name, it will print out array type, I don't know where scsi_id gets SN, it's not in arcconf output.

# scsi_id --whitelist -p 0x80 --device=/dev/sdc
SServeRA data2          CB14A413

b. compare channel number from device scsi info, it's more complicated, I prefer you to use the solution a, b is for people has interest

cat /proc/scsi/scsi

...

Host: scsi2 Channel: 00 Id: 02 Lun: 00
  Vendor: ServeRA  Model: data2            Rev: V1.0
  Type:   Direct-Access                    ANSI  SCSI revision: 02
...

In the example above, it shows it's logical drive number is 2, more info about how to check luns attached to HBA 


for both a and b, In arcconf getconfig 1 AL output, find the right logical drive

Logical drive number 2
   Logical drive name                       : data2
   RAID level                               : 1
   Status of logical drive                  : Okay
   Size                                     : 285999 MB
   Read-cache mode                          : Enabled
   Write-cache mode                         : Enabled (write-back)
   Write-cache setting                      : Enabled (write-back) when protected by battery
   Partitioned                              : Yes
   Protected by Hot-Spare                   : No
   Bootable                                 : No
   Defunct stripes                          : No
   --------------------------------------------------------
   Logical drive segment information
   --------------------------------------------------------
   Segment 0                                : Present (0,4) 3QP1AJ7R
   Segment 1                                : Present (0,5) 3QP1AK9N
As you can see you get the logical drive info, then you can move on find the physical one. disks in slot 4 and 5 are disks you want to remove, before you put hands on it, you may want to make the disks blinking when you remove them, see the section below
      Device #4
         Device is a Hard drive
         State                              : Online
         Supported                          : Yes
         Transfer Speed                     : SAS 3.0 Gb/s
         Reported Channel,Device            : 0,4
         Reported Location                  : Enclosure 0, Slot 4

         Reported ESD                       : 2,0
         Vendor                             : IBM-ESXS
         Model                              : ST3300656SS
         Firmware                           : BA47
         Serial number                      : 3QP1AJ7R
         World-wide name                    : 5000C50012674BA8
         Size                               : 286102 MB
         Write Cache                        : Disabled (write-through)
         FRU                                : 43X0805
         PFA                                : No
      Device #5
         Device is a Hard drive
         State                              : Online
         Supported                          : Yes
         Transfer Speed                     : SAS 3.0 Gb/s
         Reported Channel,Device            : 0,5
         Reported Location                  : Enclosure 0, Slot 5

         Reported ESD                       : 2,0
         Vendor                             : IBM-ESXS
         Model                              : ST3300656SS
         Firmware                           : BA47
         Serial number                      : 3QP1AK9N
         World-wide name                    : 5000C5001266E584
         Size                               : 286102 MB
         Write Cache                        : Disabled (write-through)
         FRU                                : 43X0805
         PFA                                : No

Identify

 Usage: IDENTIFY <Controller#> LOGICALDRIVE <LogicalDrive#>
 Usage: IDENTIFY <Controller#> DEVICE <Channel# ID#>
 ======================================================

 Identifies a logical drive or a physical device.

    LogicalDrive# : Number of the logical drive to be identified
    Channel# ID#  : The Channel and ID of the physical device to be identified

you can find channel# id# in bold font output in above section

Example:

arcconf identify 1 device 0 4

Controllers found: 1
Only devices managed by an enclosure processor may be identified
The specified device is blinking.
Press any key to stop the blinking.

Rescan

In case you need to rescan the controller

ARCCONF RESCAN <Controller#>

Example:

arcconf rescan 1

The controller will re-discover all physical disks

Getlogs

 Usage: GETLOGS <Controller#> <Type> [clear|tabular]
 ======================================================

 Obtains controller log information.

    Type    : DEVICE,  drive error log
              DEAD,    dead (defunct) drive log
              EVENT,   controller event log
              PPI,     can only be cleared
    clear   : Clears the specified log.
    tabular : Displays the specified log in tabular (vs XML) format.
Example:
# arcconf getlogs 1 event tabular
Controllers found: 1

   ControllerLog                 
      controllerID ..................... 0
      type ............................. 6
      time ............................. 1388710063
      eventlog                   

         event                   
            Date ............................. 1388710063
            eventType ........................ FSA_EM_ENHANCED_BATTERY_CHANGE
            eventCode ........................ 0x8000000
            capabilities_bits ................ 0
            event_bits ....................... 32768
            status_bits ...................... 0
            temperature ...................... 0
            current .......................... 0
            designCapacity ................... 0
            fullCapacity ..................... 0
            remainingCapacity ................ 0
            DramCurrentDraw .................. 0
            nextReconDate .................... 0
            lastReconDate .................... 0
            tabStatusRegisterBits ............ 0
            tabControlRegisterBits ........... 0
            rombStatusRegisterBits ........... 0
            rombControlRegisterBits .......... 0
            max_temperature .................. 0
            voltage .......................... 4040
            batSubSysColdStartedDays ......... 0
            batSubSysColdStartedHours ........ 0
            batSubSysColdStartedMinutes ...... 0
            batSubSysColdStartedSeconds ...... 0
            controllerID ..................... 0
Or
# arcconf getlogs 1 dead tabular
Controllers found: 1

   ControllerLog                 
      controllerID ..................... 0
      type ............................. 5
      time ............................. 1388710146
      version .......................... 0

      deadDriveEntry             
         adapterID ........................ 0
         channelID ........................ 0
         deviceID ......................... 5
         entryType ........................ 0
         rtcSeconds ....................... 43
         rtcMinutes ....................... 48
         rtcHours ......................... 21
         rtcDay ........................... 30
         rtcMonth ......................... 3
         rtcYear .......................... 2013
         serialNumber ..................... 3QP1AK9N
         vendorProductID .................. 3QP1AK9NIBM-ESXS
         failureReasonCode ................ 0
         majorReasonCode .................. 0
         deviceAddress .................... 9576172410181582928



Comments