This is a command line based utility for LSI. This utility configures the given MegaRAID adapter in a non-interactive mode. It configures a single MegaRAID adapter at a time, based on command line options given by the user. For some options, operation can be performed on all adapters present on the system.

Features

· Supports following series of cards

40LD: 471/475/493/489/488/518/520/533/531/ZCR

8LD: 466/467/428/438/434/762

IDE-1000 card, SATA 523 and 4523 and 8X controllers

· Supported raid levels are

R0, R1, R3 and R5 (with out span support)

R10, R30 and R50 (with span support)

R3 & R30 are disallowed on U320 mode adapters such as 518, 520 and 531

· Supported channels: up to 4 (channel no. 0,1,2 and 3)

· Supported drives: 16 for 8ld firmware, 256 for 40ld firmware

· Supports log file generation.

· Detects ongoing reconstruction (if any) on the adapter(s) and displays the message to the user.

-alladp option not supported for operations which can not be done while reconstruction is going on any adapter.

· Changes Cache Page settings

· Clear error history for the physical drive(s) on the adapter

· Display error history for the physical drive(s)

· Supports maximum of 40 arrays

· Random deletion of logical drives supported (LINUX)

· Allow user to configure free array space (if any) in already configured array.

· Display free array space information to the user.

· IDE support added

Objective of the utility is to:

· Configure a set of hard disks to the desired fresh configuration (span support also)

· Allow changes in existing configuration parameters such as

· Logical drive properties

· View logical/physical disk properties

· View Adapter Information: such as fw/bios ver, Dram size,#LogDrvs etc.

· View/Update Rebuild rate of adapter

· Enable/Disable/Silence/Display Alarm State

· Load/Save controller setup and parameters to file

· Display configuration and parameters from the file

· Load/Save controller setup to file

· Display configuration from the file

· Display configuration from the adapter

· Start rebuild, check rebuild status, stop rebuild

· Allow changes in physical disk properties (make online/offline/hotspare/fail)

· Change auto rebuild status of adapter (on/off)

· Set factory defaults on adapter

· Clear existing configuration of adapter

· Add configuration to the existing configuration of adapter

· Enable/Disable/Show bios status of adapter

· Perform check consistency on logical drives

· Initialize logical drives

· Change cluster state of adapter (When cluster is enabled, bios is disabled)

· Set Initiator id to given value

· Enable/Disable Fast initialization for an adapter

· Enable/Disable Flex Raid power fail for an adapter

· Set emulation mode to I2O/Mass storage

· Set disk spin up parameters for an adapter

· Displays physical drive info and board serial for given adapter

· Sets/Displays channel transfer rate for given adapter

· Appends the info to the existing log file.

· Displays disk spin up parameters for given adapter

· Set flush time interval for an adapter

· Abortion of ongoing Check consistency/Background Initialization.

· Display ongoing Initialization/Check consistency/Background Init progress %.

· Enable/Disable Background Initialization for given adapter

· View physical drive extended sense log information if applicable

· Enable/Disable Force Boot for an adapter

· Enable/Disable/View Pci multiple delay transition

· Enable/Disable/View coercion flag for an adapter

Usage:

megarc –help : gives help on all available command line options of the utility.

mgarc –option -help : gives detailed help on the option.

Restrictions:

Utility supports operations only on a single MegaRAID adapter specified on command line. Only for few

options, utility supports operation for all present adapters on the system.

User cannot specify the logical drive size parameter on command line for the new and add configuration

option with span support.

MEGARC :

Command line based utility under LINUX for LSI. This utility configures the given MegaRAID adapter in a non-interactive mode. It configures a single MegaRAID adapter at a time, based on command line options given by the user. For some options, operation can be performed on all adapters present on the system.

Purpose:

Objective of the utility is to:

a) Configure a set of hard disks to the desired fresh configuration

b) Allow changes in existing configuration parameters such as

logical drive properties

c) View logical/physical disk properties

d) View Adapter Information:such as fw/bios ver, Dram size,#LogDrvs etc.

e) View/Update Rebuild rate of adapter

f) Enable/Disable/Silence/Display Alarm State

g) Load/Save controller setup and parameters to file

h) Start rebuild, check rebuild status, stop rebuild

i) Allow changes in physical disk properties

j) Change auto rebuild status of adapter

k) Set factory defaults on adapter

l) Clear existing configuration of adapter

m) Add configuration to the existing configuration of adapter

n) Enable/Disable/Show bios status of adapter

o) Display configuration from the file

p) Display configuration from the adapter

q) Perform check consistency on logical drives

r) Initialize logical drives

s) Change cluster state of adapter

t) Allow/Disallow user from changing the cluster state

u) Set Initiator id to given value

v) Enable/Disable Fast initialization for an adapter

w) Enable/Disable Flex Raid power fail for an adapter

x) Set emulation mode to I2O/Mass storage

y) Set disk spin up parameters for an adapter

z) Set flush time interval for an adapter

1) Enable/Disable Force Boot for an adapter

2) Enable/Disable/View Pci multiple delay transition

3) Enable/Disable/View coercion flag for an adapter

Help:

The utility offers help to the user in two modes.

1. megarc ?

Gives brief help on all available options of the utility.

2. megarc -option ?

Gives detailed help on the option specified.

For example:

megarc -ctlrInfo ?

Gives complete help on “-ctlrInfo” option of the utility.

Conventions Used:

{ xx } : means these are optional parameters

{ x | y | z } : means one of the optional parameters (x or y or z ) can be

specified

ZZ{ x | y | z } : means one of the optional parameters (x or y or z ) can be

specified after ZZ

(x | y | z ) : means one and only one of the parameters in side () must be

defined.

Command Line Parameters:

-aN :

denotes adapter number N. Where N can have a value from 0..11.

user must specify this on command line.

-alladp :

denotes that operation will be performed on all present adapters.

This option is supported for limited no of operations.

c0:t0.c1:t1.. :

denotes the channel and target numbers of the physical drives.

supported channels: 0,1,2,3

supported drives: 0 to 15 for 8ld firmware.

: 0 to 255 for 40ld firmware.

40ld firmware :

For channel 0, supported drives are 0 to 255

For remaining channels, supported drives are 0 to 15.

-R0,-R1,-R3,-R5 :

Denotes raidlevel 0,1,3,5 respectively for the new logical drive

user must specify this on command line for –addCfg and –newCfg

options.

-R10,-R30,-R50 :

Denotes raidlevel 1,3 and 5 respectively. User must specify one of these for new configuration or add configuration with span support.

i.e. these raid levels are excepted by the utility for –spanNewCfg &

-spanAddCfg options only.

-Hsp[c0:t0,c1:t1..] :

denotes the hot spare disk list where c0:t0…denote the

channel and target number

pd[c0:t0,c1:t1..] :

denotes the physical disk list where c0:t0,c1:t1…denote the

channel and target number

-szXXXXXXXX :

denotes the logical drive size in Mb where XXXXXXXX can be

maximum 8 digits

-strpszM :

denotes the stripe size in Kb where M can be 2,4,8,16,32,64,128

WT|WB :

denotes the write policy

RAA|RA|RAN :

denotes the read policy

CIO|DIO :

denotes the IO policy

-Lx :

denotes the logical drive number, x = 0….7 for 8ld firmware

x = 0….39 for 40ld firmware

-Lall :

denotes all the logical drives

-chX:

denotes the channel number, X=0,1,2,3

-idY:

denotes the target number, Y=0…15 for 8ld firware

-RbldArray[c0:t0,c1:t1….]:

denotes the rebuild array

c0:t0:

denotes the channel and target number

supported channel 0,1,2,3

supported drive 0 to 15 for 8ld firmware

0 to 255 for 40ld firmware (for channel 0)

0 to 15 for 40ld firmware (for remaining channels)

-log/-nolog Utility creates a log file “megarc.log” in the working directory.

If –nolog option is specified on command line, utility does not

Create the log file. If –log option is given, utility creates a log file.

Default is –log, i.e. log file is always generated if no option is specified.

-logAppend Utility appends to the existing log file in the working directory.

–nolog and –logAppend cannot be defined together.

-LogFileXXX Utility creates a log file with the name “XXX”. User can specify the path

of log file also in XXX. Utility tries to open the log file XXX, and if there

is any error, it displays the message to the user and exits.

Only one or none of –log/-nolog/-LogFileXXX should be specified on

Cmd line. Utility gives error and exits if multiple definitions of these are

Given. Default option is –log & it creates a log file “megarc.log” in the

Current working directory.

Following action will be taken by the utility if one of the above 3 is

Specified.

-log : megarc.log is created in the working directoy.

-nolog: no log file is created by the utility.

-LogFileXXX : File XXX( can contain the path name also) is created.

If utility is unable to generate the log file, it gives the

Message to the user and exit.

megarc :

Means name of the utility

Abbreviation Used:

WB: WriteBack write policy

WT: WriteThrough write policy

RAA: Read Adaptive read policy

RA: Read ahead read policy

RAN: Normal Read policy (No –read ahead).

DIO: Direct IO Cache policy

CIO: Cached IO cache policy.

Design of Work:

Different configuration options will be available as given below.

Each work will be done through only one functionality detection flag at ‘argv[1]’

Configuration of a logical drive:

· Megarc –EachDskRaid0 -aN {WT | WB } {RAA | RA | RAN} {DIO | CIO}

-strpszM -noinit/-init

Objective:

Configure each physical disk as one logical drive ( RAID 0)

Parameters:

-aN : adapter number [must]

{WT|WB} : Write policy [optional]

{RAA|RA|RAN} : Read Policy [optional]

{DIO|CIO} : Cache Policy [optional]

-strpszM : Stripe size [optional]

-noinit/-init : Initialize newly created logical drive(s) or not.[optional]

Default is –noinit.

Description:

Utility will configure each physical drive present on adapter as RAID 0. Old

Configuration is overwritten. User can specify the read, write or cache policy

& stripe size on cmd line. Else default values are used for configuring the logical

drive(s). -init option will initialize the newly created logical drive(s) and display the progress to the user. Default is –noinit.

Note: Default write policy for 518/520 controllers will be WB if the battery module is present.

· Megarc –newCfg -aN (-R0|-R1|-R5)[{c0:t0,c1:t1,…}]

{–Hsp[c0:t0,c1:t1,…] } {WT | WB } {RAA | RA | RAN} {DIO | CIO }

{-szXXXXXXXX {-szYYYYYYYY {……..}}} -strpszM

Objective:

It makes a new configuration from a set of hard disks.(with out span support)

Parameters:

-aN : adapter number [must]

-R0|-R1|-R5 : Raid Level [must]

[c0:t0…] : Raid Disk Array (optional)

If the user does not specify Raid disk array, then all available

drives are selected for non R1 raid level for configuration.

-Hsp[c0:t0….] : Hotspare disk array [optional]

If the user does not give hot spare disk array on cmd line

no drives are made hotspare.

{WT|WB} : Write policy [optional]

{RAA|RA|RAN} : Read Policy [optional]

-szXXXXXXXX : Size of logical drive [optional]

If user gives more than one size parameter at the command line,the

whole array is divided among multiple logical drives.

If user does not give any size parameter on cmd line, the whole

array is configured as a single logical drive.

-strpszM : Stripe size [optional]

Description:

The utility makes a new configuration from a set of hard disks.

Old configuration is over written.

If size parameter is specified then the new logical drive is created only of that much

size. If more than one size parameters are specified then it means the whole array is

to be divided among multiple logical drives.

Residue size will be automatically assigned to next logical drive, if possible. I.e. if an

array consists of 1000MB and ‘-sz100 –sz200’ are specified on command line, then

it will make 2logical drives of 100MB and 200MB and rest 700MB will be

automatically assigned to next numbered logical drive.

Without this, there will be trouble of compatibility issue among different utilities.

User is strongly advised to use the full array as the size of the logical disk.

If the user does not give the options on command line, following default values will

be taken:

Write policy: Write Thru

Cache IO policy: Direct IO

Read policy: Read Ahead Adaptive

Stripe size: 64Kb

Notes: If the adapter cluster mode is enabled, then -szXXXXX size option is

disallowed. That means the partial arrays are disallowed for –newcfg and –addcfg.

Note: Default write policy for 518/520 controllers will be WB if the battery module is present.

Example:

megarc -newcfg –R1[0:0,1:11] -strpsz32 -sz100 DIO WB RAA

it will configure a logical drive of size 100 Mb of Raid Level 1 with direct IO, write

back and read ahead adaptive policy. The remaining available size will go to an

extra logical drive of Raid Level 1.

Megarc –newcfg –R1[0:0,1:11]

It will configure a single logical drive from the whole array with default write, read

and cache policy and stripe size.

· Megarc –addCfg -aN (-R0|-R1|-R5)[(c0:t0,c1:t1,…)] {–Hsp[c0:t0,c1:t1,…] } {WT | WB } {RAA | RA | RAN} {DIO | CIO } {-szXXXXXXXX {-szYYYYYYYY {……..}}} -strpszM

Objective :

Add logical drive(s) to the existing configuration.(without span support)

Parameters:

-aN : adapter number [must]

-R0|-R1|-R5[c0:t0..] : Raid disk array [must]

-Hsp[c0:t0….] : Hotspare disk array [optional]

If the user does not give hot spare disk array on cmd line

no drives are made hotspare.

{WT|WB} : Write policy [optional]

{RAA|RA|RAN} : Read Policy [optional]

-szXXXXXXXX : Size of logical drive [optional]

If user gives more than one size parameter at the command line,the

whole array is divided among multiple logical drives.

If user does not give any size parameter on cmd line, the whole

array is configured as a single logical drive.

-strpszM : Stripe size [optional]

Description:

The utility adds logical drive to the existing configuration.

None of the disks specified should be in used state. If any of the specified disks are in used state, the utility will flag error and exit.

If size parameter is specified then the new logical drive is created only of that much

size. If more than one size parameters are specified then it means the whole array is

to be divided among multiple logical drives.

Residue size will be automatically assigned to next logical drive, if possible. I.e. if an

array consists of 1000MB and ‘-sz100 –sz200’ are specified on command line, then

it will make 2logical drives of 100MB and 200MB and rest 700MB will be

automatically assigned to next numbered logical drive.

Without this, there will be trouble of compatibility issue among different utilities.

User is strongly advised to use the full array as the size of the logical disk.

If the user does not give the options on command line, following default values will

be taken:

Write policy: Write Thru

Cache IO policy: Direct IO

Read policy: Read Ahead Adaptive

Stripe size: 64Kb

Notes: If the adapter cluster mode is enabled, then -szXXXXX size option is

disallowed. That means the partial arrays are disallowed for –newcfg and –addcfg.

Note: Default write policy for 518/520 controllers will be WB if the battery module is present. For other controllers, it takes the prior logical drive’s policy if there is more than one drive present.

megarc -addcfg –R1[0:0,1:11] -strpsz32 -sz100 DIO WB RAA

it will configure a logical drive of size 100 Mb of Raid Level 1 with direct IO, write

back and read ahead adaptive policy. The remaining available size will go to an

extra logical drive of Raid Level 1. These logical drives will be added to the existing

configuration on adapter.

Megarc –addcfg –R1[0:0,1:11]

It will configure a single logical drive from the whole array with default write, read

and cache policy and stripe size and add this logical drive to the existing

configuration on adapter.

[Since 06-24-2003] [Only on Random deletion supporting f/w]

Utility also allows the user to use any free array space for configuration.

If the user does not specify already configured array at cmd line, then the utility

Will behave the same way as it used to do earlier. But if the user is using

already used array, then user has to specify the full array at cmd line. User can not

break the array by specifying some of the physical drive(s) in that array at cmd line.

First available free slot in that array is available for the user to configure. User can

Specify the size of logical drive at cmd line. But the sum of all specified logical drive

Size at cmd line OR the size of individual logical drive given at cmd line has to be

Lesser than or equal to the first free slot in that array.

Any residue size in the first free slot becomes a separate logical drive.

All other free slots available in that array become separate logical drives.

Suppose any array is configured on the adapter with physical drives[1:1,1:2,1:3]

And this array has got free slots of 100MB, 200MB and 400MB on that. Where the

First free slot in 100MB.

If the user wants to use the free array space available, then user has to specify

The full array at cmd line. User can’t use part of this array by specifying only some

Of the constituting physical drive(s) of this array.

Cmd line:

Megarc –addcfg –a0 –r5[1:1,1:2,1:3] –sz50

Following logical drives will be added to the configuration:

50MB

200MB

400MB

Cmd line:

Megarc –addcfg –a0 –r5[1:1,1:2,1:3]

Following logical drives will be added to the configuration.

100MB

200MB

400MB

Cmd line:

Megarc –addcfg –a0 –r5[1:1,1:2,1:3] –sz200

Utility will give the message to the user that the specified size of 200MB is more

Than first available free slot of 100MB.

Cmd line:

Megarc –addcfg –a0 –r1[1:1,1:3]

Utility will give the message to specify the full array at cmd line.

Cmd line:

Megarc –addcfg –a0 –r5[1:1,1:2,1:5]

Where [1:5] is not configured in any array

Utility will give the message to the user that [1:3] is part of that array and this was

Not given at cmd line.

Cmd line:

Megarc –addcfg –a0 –r5[1:1,1:2,1:6]

Where [1:6] is configured in some other array.

Utility will give the message to the user that specified physical drives are configured

In different arrays.

· Megarc –spanNewCfg -aN (-R10|-R50) –ArrayX[c0:t0,c1:t1,…] {– HspY[c0:t0,c1:t1,…] } {WT | WB } {RAA | RA | RAN} {DIO | CIO }

{ -strpszM }

Objective :

It makes a new configuration with spanning from a set of hard disks.

Parameters:

-aN : adapter number [must]

-R10 |-R50 : Raid level 1 and 5 respectively with span support [must]

-ArrayX[c0:t0,c1:t1…] : Physical drive array. Multiple arrays can be given.

X=0,1…..7

Multiple arrays means spanning in the same logical drive.

Maximum 8 arrays are accepted to allow up to span 8.

User must specify atleast 2 physical drives for raid level

–R10. If more than 2 drives are given, additional drives are

ignored for configuration of –R10. Same drives can not be

used in different arrays.

-HspY[c0:t0….] : Hotspare disk array [optional]

If the user does not give hot spare disk array on cmd line

no drives are made hotspare.

{WT|WB} : Write policy [optional]

{RAA|RA|RAN} : Read Policy [optional]

{DIO|CIO} : Cache policy [optional]

-strpszM : Stripe size [optional]

Description:

The utility creates new configuration with span support with the parameters

specified on cmd line.

If the user does not give the options on command line, following default values

will be taken:

Write policy: Write Thru

Cache IO policy: Direct IO

Read policy: Read Ahead Adaptive

Stripe size: 64Kb

Note: Default write policy for 518/520 controllers will be WB if the battery module is present.

megarc -spanNewCfg –R10 -array0[0:0,1:11] -array1[1:0,1:2] -hsp0[1:3] –strpsz32

DIO WB RAA

This command will configure a logical drive of RAID 1with spanning.

Physical drive arrays –array0[0:0,1:11] and –array1[1:0,1:2] will form two span levels

Of the logical drive. Physical drive [1:3] will be configured as hotspare.

Stripe size will be 32 Mb.

Specified Cache, Read and Write policies will be used in the logical drive.

· Megarc –spanAddCfg -aN (-R10|-R50) –ArrayX[c0:t0,c1:t1,…]

{– HspY[c0:t0,c1:t1,…] } {WT | WB } {RAA | RA | RAN} {DIO | CIO }

{ -strpszM }

Objective :

It adds to the existing configuration. User can add configuration with span support.

Parameters:

-aN : adapter number [must]

-R10 |-R50 : Raid level 1 and 5 respectively with span support [must]

-ArrayX[c0:t0,c1:t1…] : Physical drive array. Multiple arrays can be given.

X=0,1…..7

Multiple arrays means spanning in the same logical drive.

Maximum 8 arrays are accepted to allow up to span 8.

User must specify atleast 2 physical drives for raid level

–R10. If more than 2 drives are given, additional drives are

ignored for configuration of –R10. Same drives can not be

used in different arrays.

-HspY[c0:t0….] : Hotspare disk array [optional]

If the user does not give hot spare disk array on cmd line

no drives are made hotspare.

{WT|WB} : Write policy [optional]

{RAA|RA|RAN} : Read Policy [optional]

{DIO|CIO} : Cache policy [optional]

-strpszM : Stripe size [optional]

Description:

The utility adds configuration with span support with the parameters

specified on cmd line.

If the user does not giv