Specification Document for 40Ld MEGARC for LSI

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

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

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

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

Objective of the utility is to:

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:

  1. Configure a set of hard disks to the desired fresh configuration

  2. Allow changes in existing configuration parameters such as

logical drive properties

  1. View logical/physical disk properties

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

  3. View/Update Rebuild rate of adapter

  4. Enable/Disable/Silence/Display Alarm State

  5. Load/Save controller setup and parameters to file

  1. Start rebuild, check rebuild status, stop rebuild

  2. Allow changes in physical disk properties

  3. Change auto rebuild status of adapter

  4. Set factory defaults on adapter

  5. Clear existing configuration of adapter

  6. Add configuration to the existing configuration of adapter

  7. Enable/Disable/Show bios status of adapter

  8. Display configuration from the file

  9. Display configuration from the adapter

  10. Perform check consistency on logical drives

  11. Initialize logical drives

  12. Change cluster state of adapter

  13. Allow/Disallow user from changing the cluster state

  14. 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:

-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.

{-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.

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

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.

{ -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.

{- 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 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. For other controllers, it takes the prior logical drive's policy if there is more than one drive present.

megarc -spanAddCfg -R50 -array0[0:0,1:11,1:12] -array1[1:0,1:2,1:4] -hsp0[1:3]

-strpsz32 DIO WB RAA

This command will add a logical drive of RAID 5 with spanning.

Physical drive arrays -array0[0:0,1:11,1:12] and -array1[1:0,1:2,1:4] 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.

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

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

Suppose an adapter has [1:0,1:1,1:2] physical drives configured in an array with free

Space of 100MB, 200MB & 400MB, where 100MB is the first free array space.

Adapter has got [1:3,1:4,1:5] physical drives which are free and ready to be

Configured.

Cmd Line:

Megarc -spanaddcfg -a0 -r50 -array0[1:0,1:1,1:2] -array1[1:3,1:4,1:5]

Will add one logical drive with spanning where 100MB of [1:0,1:1,1:2] will form

span-1 and [1:3,1:4,1:5] will form span-2 of the logical drive.

200MB and 400MB of [1:0,1:1,1:2] remains unused after the configuration.

Suppose an adapter has [1:0,1:1,1:2] array-0 with free space of 100MB and 200MB

And [1:3,1:4,1:5] array-1 with 300MB and 400MB free space.

Cmd line:

Megarc -spanaddcfg -a0 -r50 -array0[1:0,1:1,1:2] -array1[1:3,1:4,1:5]

Will add one logical drive with spanning where 100MB of [1:0,1:1,1:2] and

300MB of [1:3,1:4,1:5] will form different spans of the logical drive.

200MB of array-0 and 400MB of array-1 will remain unused after the configuration is

done.

Objective:

Clear configuration of the given adapter.

Parameters:

-aN : adapter number [must]

Description :

Clears configuration of the given adapter. Old configuration is erased.

Objective:

Display brief information about existing configuration of adapter N

Parameters:

-aN : adapter number [ must]

Description:

The utility displays the adapter information.

It displays the following information about the adapter.

#Logical Drives

Ld#-x1 RaidLevel Span Size Stripes State

Ld#-x2 RaidLevel Span Size Stripes State

Ld#-x3 RaidLevel Span Size Stripes State

#HotSpare Drive

ch,id

File operations:

Load/Save/Display configuration information from/to some file

Objective:

Save configuration from adapter N onto given FileName.

Parameters:

-aN : adapter number [ must]

-fFilename : Filename [must]

Objective:

Save configuration and parameters from adapter N onto given FileName.

Apart from configuration, following parameters are saved in the file.

  1. Bios Status

  2. Cluster State

  3. Initiator ID

In case of IDE-1000 card, only BIOS status is relevant.[since 10-15-2001]

Parameters:

-aN : adapter number [ must]

-fFilename : Filename [must]

Objective:

Write configuration from given FileName onto given adapter N

Parameters:

-aN : adapter number [ must]

-fFilename : Filename [must]

Description :

The utility verifies (and rejects if necessary ) if the target adapter does not support the configuration in FileName before it writes the configuration from FileName to the adapter.

Objective:

Write configuration and parameters from given FileName onto given adapter N

Parameters:

-aN : adapter number [ must]

-fFilename : Filename [must]

Description :

The utility verifies (and rejects if necessary ) if the target adapter does not support the configuration in FileName before it writes the configuration from FileName to the adapter.

Apart from configuration utility restores the following parameters to the adapter.

  1. Bios Status

  2. Cluster State

  3. Initiator Id

In case of IDE-1000 card, only BIOS status is restored.[since 10-15-2001]

Objective:

Display configuration from given FileName

Parameter :

-fFilename : Filename [must]

Objective :

Display configuration and parameters from given FileName

Apart from configuration, following parameters are displayed.

  1. Bios status

  2. Cluster State

  3. Initiator Id

In case of IDE-1000 cards, only Cluster State and Initiator Id field is shown as

“None”.[since 10-15-2001]

Parameter:

-fFilename : Filename [must]

Logical drive operations

Objective:

Delete logical drive on the adapter.

[on random deletion supporting f/w only]

Parameters

-aN : adapter number [ must ]

-Lx: logical drive number [must]

Description:

This command will delete the specified logical drive on the adapter. This command allows deleting even if there is only one logical drive on the adapter. User is allowed to delete only one logical drive at a time.

Objective:

Display free array space information of all arrays present on the adapter.

[on random deletion supporting f/w only]

Parameters

-aN : adapter number [ must ]

Description:

This cmd will display the free array information on the adapter.

Displayed information includes total free size/per component, component physical drives and start block and no of blocks of free space in each component.

Objective :

Display logical drive information.

Parameters:

-aN : adapter number [ must ]

-Lx : logical drive number [ must ]

Note: The user must specify at least one logical drive.

User can specify more than one logical drive.

Description:

Print logical drive information -

Ld#-x1 ( Total #logical drives-YXY )

Capacity - XXXXMB

virtual size - on/off,

State - Optimal/Degraded/Failed

Stripes- X

RaidLevel - Y(raid 0,1,5)

SpanDepth- X

stripe size - YY KB

Rd policy - Adaptive/Normal/ReadAhead

Wrpolicy - WriteThru/WriteBack

Cache policy - CachedIo/DirectIo

member drives span state

User must specify at least one logical drive.

Objective:

Print logical drive information - for all logical drives on adapter N

Parameters:

Same as above

Description:

Same as above

-aN|-alladp

Objective:

Change one or more logical drive properties for the given logical drive.

Parameters:

WritePolicy : WT/WB Writethrough/WriteBack

ReadPolicy : RAN/RAA/RA Normal/ReadAdaptive/ReadAhead

CachePolicy : DIO/CIO DirectIo/CachedIo

-aN|-alladp : adapter number

User can specify one of the above.

-Lx|-Lall : logical drive number

User can specify one of the above.

One of the read/write/cache policy must be defined on command line

Objective:

Initialize given logical drives x1,x2….xn

Parameters:

-aN : adapter number [ must ]

-Lx : Logical drive number [ User must specify at least one logical drive ]

Description:

The utility initializes the given logical drives. If any of the specified logical drive can not be initialized, it will flag the message to the user and exit. It displays the progress to the user in terms of % completion.

Objective:

Initialize all logical drives present on the adapter

Parameters:

-aN : adapter number [ must ]

-Lall : All logical drives

Description:

The utility initializes the all logical drives.If any of the logical drive can not be initialized, it will flag the message to the user and exit. It displays the progress to the user in terms of % completion.

Objective :

Check consistency on given logical drives x1,x2….xn

Parameters:

-aN : adapter number [ must ]

-Lx : Logical drive number [ User must specify at least one logical drive ]

Description :

The utility performs the check consistency on the given logical drives. If check consistency can not be performed on any of the specified logical drive, it flags the message to the user and exits.

It displays the progress to the user in terms of % completion

Objective:

Check consistency on all logical drives on adapter N.

Parameters:

-aN : adapter number [ must ]

-Lall : All logical drives

Description :

The utility performs the check consistency on all logical drives. If check consistency can not be performed on any of the logical drive, it flags the message to the user and exits.

It displays the progress to the user in terms of % completion

Objective:

Detect the ongoing Check consistency/Background Initialization and abort it on all logical drives (if any) for adapter N.

Parameters:

-aN : adapter number [must]

Description:

The utility detects the ongoing the check consistency/Background Initialization on all logical drives and aborts it. In case of failure or absence of logical drives, it flags the relevant message to the user and exits.

Objective:

Detect the Initialization and display the ongoing progress (%) on all logical drives (if any) for adapter N.

Parameters:

-aN : adapter number [must]

Description:

The utility detects the initialization on all logical drives and displays the ongoing progress (%) for them. In case of failure or absence of logical drives, it flags the relevant message to the user and exits.

Objective:

Detect the Check consistency/Background Initialization on all logical drives (if any) and displays the ongoing progress (%) for adapter N.

Parameters:

-aN : adapter number [must]

Description:

The utility detects the check consistency/Background Initialization on all logical drives and displays the ongoing progress (%) for them. In case of failure or absence of logical drives, it flags the relevant message to the user and exits.

Physical disk related operations:

It performs the physical disk related operations like displaying the physical disk properties,

making the physical disk online, offline etc.

Objective:

Display logical & physical drive information on the adapter.

Parameters:

-aN : adapter number

-alladp : all adapters.

One of these two is a must.

Description:

It displays the logical drive and physical drive information on the given adapter.

Displayed information includes logical drive(s) with Raid Level, its span depth & physical drive(s) size and channel & SCSI id information.

Option also logs the information in log file if the user opts to generate a log file, else

It only displays the information on the screen.

Objective:

Make the designated drive(s) Online.

Parameters :

pd[c0:t0…] : the physical drives [must]

user must specify at least one physical drive.

-aN : adapter number [ must ]

Description:

If the physical drive does not exist or it is not in failed state, utility will flag error

And exit.

Objective:

Make the designated drive(s) Offline.

Parameters :

pd[c0:t0…] : the physical drives [must]

user must specify at least one physical drive.

-aN : adapter number [must]

Description:

If the physical drive is not present or it is not online or hsp, the utility will flag error

and exit.

If the drive is online: it will fail the drive.

If the drive is rebuild: it will fail the drive.

If the drive is hotspr: it will make it ready.

Objective:

Sets the designated drive(s) to HotSpare

Parameters :

pd[c0:t0…] : the physical drives

User must specify atleast one physical drive.

User can specify more than one physical drives.

-aN : adapter number [ must ]

Description:

If the physical drive is not present, it will flag error and exit.

Objective:

Makes the designated HotSpare drive(s) as READY

Parameters :

pd[c0:t0…] : the physical drives [must]

User must specify atleast one physical drive.

User can specify more than one physical drives.

-aN : adapter number [ must ]

Objective:

Start rebuild process on the given physical drive(s) if they are rebuildable

(i.e. if part of Redundant Array(non R0) and in failed state and only one

element in the array is in failed state.)

Parameters:

-RbldArray[c0:t0…] : rebuild array [ must]

user must specify at least one physical drive.

-aN : adapter number [must]

-ShowProg : displays the rebuild progress to the user [ optional ]

Description:

The utility starts rebuild process on designated physical drives if applicable.

If ShowProg is specified then it will display rebuild progress of all eligible specified

drives. If the drives are not rebuildable, it will flag the message to the user and exit.

Objective:

Stop rebuild process on the designated physical drive(s) if applicable.

Parameters:

-RbldArray[c0:t0…] : rebuild array [must]

user must specify atleast one physical drive.

-aN : adapter number [must]

Description:

Stops rebuild on designated physical drives. No error will be flagged if the designated Drives are not in rebuild state.

Objective:

Display rebuild progress of all drives under rebuild state.

Parameters:

-aN : adapter number [must]

Description:

Displays rebuild progress of all drives under rebuild process.

It will display the message if no drives were found in rebuild state.

Objective:

Display physical drive error history if applicable.

Parameters:

-aN : adapter number [must]

-chX|-chAll: Channel number[must]

-idY|-idAll: Target number[must]

Description:

This cmd displays the physical drive error history if applicable in a formatted form to

the user. Displayed information includes timeout, throttle, parity, SCSI information

along with other reasons if available for the specified drive(s).

Objective:

Clear physical drive error history on the adapter.

Parameters:

-aN : adapter number [must]

Description:

This cmd clears the error history for the physical drive(s) on the adapter.

[-SaveCacheSetting]

Objective:

Change Cache Page settings for the given physical drive

Parameters:

-aN : adapter number [must]

-chX: Channel number[must]

-idY: Target number[must]

-wce0/-wce1 OR -rcd0/-rcd1 [must]

Description:

This cmd changes the cache page settings as desired by the user on cmd line.

RCD0: means target may respond to READ cmd by accessing

either cache or media.

RCD1: means target shall respond to READ cmd by accessing

Data from the medium.

WCE0: means target shall return GOOD status for a WRITE

Cmd after writing all data successfully to the

Medium.

WCE1: means target may return GOOD status for a WRITE cmd

After successfully receiving the data prior to having

written it to the medium.

Either [WCE0/WCE1] or [RCD0/RCD1] must be defined. Both can be defined at the

Same time also.

SaveCacheSetting: IF defined then MODE-SELECT cmd is fired with option to

Save the mode-parameters onto SCSI drive's NVRAM so that they

Remain effective even after reset.

Option also supported for SATA-8X controllers (Only Write settings)

Objective:

Display WCE and RCD bit settings in Cache Page for the given drive.

Parameters:

-aN : adapter number [must]

-chX: Channel number[must]

-idY: Target number[must]

-viewcache :[must]

Description:

This cmd displays the settings of WCE and RCD bit in cache page for the given drive.

It also shows the bits are changeable or not.

Option also supported for SATA-8X controllers (Only Write settings)

Objective:

Display physical drive information.

Parameters:

-aN : adapter number [must]

-chX|-chAll: Channel number[must]

-idY|-idAll: Target number[must]

Description:

This cmd displays the physical drive information applicable in a formatted form to

the user. Displayed information includes product name, revision, SCSI Tag#

along with other info if available for the specified drive(s).

Objective:

Display physical drive serial number information.

Parameters:

-aN : adapter number [must]

-chX|-chAll: Channel number[must]

-idY|-idAll: Target number[must]

Description:

This cmd displays the physical drive serial number information in a formatted form to the user.

Objective:

Sets SCSI transfer rate for the channels on the adapter.

Parameters:

-aN : adapter number [must]

-chX: Channel number[must]

-Transfer rate parameters

Fast, Ultra, Ultra2, 160M and 320M

Description:

This cmd sets the transfer rate for the channels on an adapter to any of the above-mentioned values.

Objective:

Displays SCSI transfer rate for the channels on the adapter.

Parameters:

-aN : adapter number [must]

-chX: Channel number[must]

Description:

This cmd displays the transfer rate for the channels on an adapter.

Objective:

Displays Extended physical drive sense log information

Parameters:

-aN : adapter number [must]

-chX|-chAll: Channel number[must]

-idY|-idAll: Target number[must]

Description:

This cmd displays the physical drive extended sense log information if applicable in formatted form to the user. Displayed information includes Date & Time stamp (MM-DD-YY HR: MT: SS cdbLength cdbBytes(12) SenseDataBytes(18) if available for the specified drive(s).

Simple adapter related operation type functionalities

Objective:

Display current rebuild rate of adapter N

Parameters:

-aN : adapter number [must]

Objective:

Set the rebuild rate on the adpater to the given value.

Parameters:

-aN : adapter number [must]

Val : value of the rebuild rate [ must ]

Value should be in the range of 0 to 100

Description:

Sets rebuild rate to Val( 0..100 ). It also gives the previous rebuild rate of the

adapter.

e.g. Megarc -setrbldrate 50 -a5

Sets rebuild rate to 50 on adapter 5.

Objective:

Enable/Disable Cluster on the adapter.

When Cluster is disabled

  1. User is advised to reboot the system

  2. Initiator Id is set to 7.

When user wants to enable cluster

  1. Utility checks if any existing logical drive is in WB mode, if yes

It displays the message to the user and does not change the cluster

State.

  1. When cluster is ENABLED bios is DISABLED on the adapter.

Option is not supported for 471/ASPEN card.

Option not supported for IDE-1000 card[since 10-15-2001]

Parameters:

-aN : adapter number

OR

-alladp : means all adapters present

Objective:

Set the initiator id to given value on the adapter.

When cluster is disabled on the adapter and this option is run, user is

Informed that this is not an option item.

Option not supported for IDE-1000 card[since 10-15-2001]

Parameters:

-aN : adapter number

val : initiator id val can be 0….14

Objective:

Display information of the given adapter.

It displays the information such as bios version, f/w version

channel number and Serial number of the controller etc.

Displays BIOS NAS related features also

Parameters:

-aN : adapter number [ must ]

Objective:

Enable Background Initialization for the given adapter.

This option enables BI to kick-in if the f/w supports BI

Parameters:

-aN : adapter number [ must ]

Description:

This option enables BI for the given adapter so that the f/w supported

BI can kick-in once the new configuration is made.

Objective:

Disables Background Initialization for the given adapter.

This option disables BI to kick-in if the f/w supports BI

Parameters:

-aN : adapter number [ must ]

Description:

This option disables BI for the given adapter so that the f/w supported

BI can't kick-in when the new configuration is made.

Objective:

Sets Fast Initialization to ON/OFF for the given adapter

Parameters:

-aN : adapter number [ must ]

Objective:

Sets Flex RAID Power Failure to ON/OFF for the given adapter

Parameters:

-aN : adapter number [ must ]

Objective:

Sets Emulation mode to I2O or Mass stogare for the given adapter

Parameters:

-aN : adapter number [ must ]

Objective:

Sets Force Boot to ON/OFF for the given adapter

Parameters:

-aN : adapter number [ must ]

Objective:

Enable/Disable/Shows Pci multiple delay transistion for the given adapter

Parameters:

-aN : adapter number [ must ]

Objective:

Enable/Disable/Shows Coercion flag for the given adapter

Parameters:

-aN : adapter number [ must ]

Objective:

Sets disk spinup parameters for the given adapter.

Parameters:

-aN : adapter number [ must ]

-dsksY: No.of disks to be spinned up at a time

Valid values for Y are: 1, 2, 4 and 6

E.g megarc -dskSpinUP -Dsks2 -aX

Sets spinup of 2 disks every 6 sec on adp N

Objective:

Sets cache flush interval to Y sec for the given adapter

Parameters:

-aN : adapter number [ must ]

-tY: Cache flush time interval

Valid values for Y are: 2, 4, 6, 8 and 10

Objective:

Shows disk spin up parameters

Parameters:

-aN : adapter number [ must ]

Alarm related options:

Objective:

Enable alarm on adapter N

Parameters:

-aN : adapter number [ must ]

Objective:

Disable alarm on adapter N

Parameters:

-aN : adapter number [ must ]

Objective:

Silence alarm on adapter N

Parameters:

-aN : adapter number [ must ]

Description:

If alarm condition is absent, nothing happens.

Objective:

Shows current alarm state(Enabled or Disabled) on adapter N

Parameters:

-aN : adapter number [ must ]

BIOS related options:

Objective:

Show current status(Enabled or Disabled) of bios on adapter N

OR all adapters.

Parameters:

-aN : adapter number

OR

-alladp : means all adapters

Objective:

Disable the bios on adapter N

OR all adapters.

Parameters:

-aN : adapter number

OR

-alladp : means all adapters

Objective:

Enable the bios on adapter N

OR all adapters.

Parameters:

-aN : adapter number

OR

-alladp : means all adapters

Objective:

Sets the factory default parameters on adapter N

Parameters:

-aN : adapter number [ must ]

Description:

User is advised to reboot the system after this operation as many of the parameters

may not function properly till the system is rebooted.

The following factory parameters are also set based on the card type along with other defaults.

1) Forceboot is set to ON for 518/520 and OFF for other cards.

2) 466/438 controllers

- Bios as Enabled

- Emulation to Mass storage type

- Alarm as Enabled

3) 466/762 controllers

- Memory type as EDO

Three NAS related parameters are also set when this option is run.

[Since 10-30-2001]

BIOS stops on error : ON

BIOS echos messages: ON

BIOS picks up autoconfiguration: USER

Objective:

Enables auto rebuild on adapter N

Parameters:

-aN : adapter number [ must ]

Objective:

Disables auto rebuild on adapter N

Parameters:

-aN : adapter number [ must ]

Objective:

Displays information about all cards present on the system.

Displayed information includes bus no, device no, firmware type and card type along

With the card numbers.

Parameters:

None.

NAS settings related options:

Objective:

Allow/Disallow BIOS to echo messages during POST

Parameters:

-aN : adapter number [ must ]

Objective:

Allow/Disallow BIOS to stop on error

Parameters:

-aN : adapter number [ must ]

Objective:

This allows BIOS to opt for DISK configuration in case

of configuration mismatch.

Parameters:

-aN : adapter number [ must ]

Objective:

This allows BIOS to opt for NVRAM configuration in case

of configuration mismatch.

Parameters:

-aN : adapter number [ must ]

Objective:

This allows BIOS to leave it to the user to decide

through Control-m in case of configuration mismatch.

Parameters:

-aN : adapter number [ must ]

Restrictions:

  1. User can not supply multiple values for the same argument on command line. The utility will

flag error message and exit.

  1. User can not specify the logical drive size parameter on command line for the -spannewcfg

And -spanaddcfg options. Whole size of the specified array(s) will be used for the

configuration.