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
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
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:
Configure a set of hard disks to the desired fresh configuration
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
Start rebuild, check rebuild status, stop rebuild
Allow changes in physical disk properties
Change auto rebuild status of adapter
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
Display configuration from the file
Display configuration from the adapter
Perform check consistency on logical drives
Initialize logical drives
Change cluster state of adapter
Allow/Disallow user from changing the cluster state
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
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 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.
Megarc -clrCfg -aN
Objective:
Clear configuration of the given adapter.
Parameters:
-aN : adapter number [must]
Description :
Clears configuration of the given adapter. Old configuration is erased.
Megarc -dispCfg -aN
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
Megarc -saveCfg -fFileName -aN
Objective:
Save configuration from adapter N onto given FileName.
Parameters:
-aN : adapter number [ must]
-fFilename : Filename [must]
Megarc -ScfgAndParm -fFileName -aN
Objective:
Save configuration and parameters from adapter N onto given FileName.
Apart from configuration, following parameters are saved in the file.
Bios Status
Cluster State
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]
Megarc -restoreCfg -fFileName -aN
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.
Megarc -RcfgAndParm -fFileName -aN
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.
Bios Status
Cluster State
Initiator Id
In case of IDE-1000 card, only BIOS status is restored.[since 10-15-2001]
Megarc -dispFileCfg -fFileName
Objective:
Display configuration from given FileName
Parameter :
-fFilename : Filename [must]
Megarc -DfcfgAndParm -fFileName
Objective :
Display configuration and parameters from given FileName
Apart from configuration, following parameters are displayed.
Bios status
Cluster State
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
Megarc -delLD -aN -Lx
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.
Megarc -FreeSpaceInfo -aN
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.
Megarc -ldInfo -aN -Lx1 { -Lx2 ..{Lxn}….}
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.
Megarc -ldInfo -aN -Lall
Objective:
Print logical drive information - for all logical drives on adapter N
Parameters:
Same as above
Description:
Same as above
Megarc -cldCfg [WritePolicy] [ ReadPolicy] [CachePolicy] -Lx|-Lall
-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
Megarc -initLd -aN -Lx1 [-Lx2 [ -Lx3 ….[ -Lxn ] … ] .. ]
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.
Megarc -initLd -aN -Lall
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.
Megarc -chkonLd -aN -Lx1 [-Lx2 [ -Lx3 ….[ -Lxn ] … ] .. ]
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
Megarc -chkonLd -aN -Lall
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
Megarc -abortCCBI -aN
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.
Megarc -ViewInitProg -aN
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.
Megarc -ViewBICCProg -aN
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.
Megarc -LogPhysInfo -aN|-alladp
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.
Megarc -physOn pd[c0:t0,c1:t1….] -aN
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.
Megarc -physOff pd[c0:t0,c1:t1….] -aN
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.
Megarc -physSetHsp pd[c0:t0,c1:t1….] -aN
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.
Megarc -physUnsetHsp pd[c0:t0,c1:t1….] -aN
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 ]
Megarc -doRbld -RbldArray[c0:t0,c1:t1,…] -aN { -ShowProg }
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.
Megarc -stopRbld -RbldArray[c0:t0,c1:t1,…] -aN
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.
Megarc -showRbld -aN
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.
Megarc -pdFailInfo -chX|-chAll -idY|-idAll -aN
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).
Megarc -clrErrHistory -aN
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.
Megarc -pSetCache -chX -idY -aN [-WCE0/-WCE1] [-RCD0/-RCD1]
[-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)
Megarc -pSetCache -chX -idY -aN -ViewCache
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)
Megarc -phys -chX|-chAll -idY|-idAll -aN
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).
Megarc - physdrvSerialInfo -chX|-chAll -idY|-idAll -aN
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.
Megarc -SetXFerRate {Fast|Ultra|Ultra2|160M|320M} -aX -chX
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.
Megarc -GetXFerRate -aX -chX
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.
Megarc -ViewExtSenseData -chX|-chAll -idY|-idAll -aN
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
Megarc -getRbldRate -aN
Objective:
Display current rebuild rate of adapter N
Parameters:
-aN : adapter number [must]
Megarc -setRbldRate Val -aN
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.
Megarc -EnCluster|-DisCluster -aN|-alladp
Objective:
Enable/Disable Cluster on the adapter.
When Cluster is disabled
User is advised to reboot the system
Initiator Id is set to 7.
When user wants to enable cluster
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.
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
Megarc -InitId val -aN
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
Megarc -ctlrInfo -aN
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 ]
Megarc -enableBI -aN
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.
Megarc -disableBI -aN
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.
Megarc -FastInitOn|-FastInitOff -aN
Objective:
Sets Fast Initialization to ON/OFF for the given adapter
Parameters:
-aN : adapter number [ must ]
Megarc -SetFrpOn|-SetFrpOFF -aN
Objective:
Sets Flex RAID Power Failure to ON/OFF for the given adapter
Parameters:
-aN : adapter number [ must ]
Megarc -EmulI2O|-EmulMass -aN
Objective:
Sets Emulation mode to I2O or Mass stogare for the given adapter
Parameters:
-aN : adapter number [ must ]
Megarc -ForceBootON|-ForceBootOFF -aN
Objective:
Sets Force Boot to ON/OFF for the given adapter
Parameters:
-aN : adapter number [ must ]
Megarc -enPciDelay|-dispciDelay|-vupciDelay -aN
Objective:
Enable/Disable/Shows Pci multiple delay transistion for the given adapter
Parameters:
-aN : adapter number [ must ]
Megarc -CoercionON|-CoercionOFF|-CoercionVu -aN
Objective:
Enable/Disable/Shows Coercion flag for the given adapter
Parameters:
-aN : adapter number [ must ]
Megarc -dskSpinUP -DsksY -aN
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
Megarc -setFlush -tY -aN
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
Megarc -ShowdskSpinUP -aN
Objective:
Shows disk spin up parameters
Parameters:
-aN : adapter number [ must ]
Alarm related options:
Megarc -enAlarm -aN:
Objective:
Enable alarm on adapter N
Parameters:
-aN : adapter number [ must ]
Megarc -disAlarm -aN :
Objective:
Disable alarm on adapter N
Parameters:
-aN : adapter number [ must ]
Megarc -silenceAlarm -aN :
Objective:
Silence alarm on adapter N
Parameters:
-aN : adapter number [ must ]
Description:
If alarm condition is absent, nothing happens.
Megarc -showAlarm -aN
Objective:
Shows current alarm state(Enabled or Disabled) on adapter N
Parameters:
-aN : adapter number [ must ]
BIOS related options:
Megarc -showBios -aN|-alladp
Objective:
Show current status(Enabled or Disabled) of bios on adapter N
OR all adapters.
Parameters:
-aN : adapter number
OR
-alladp : means all adapters
Megarc -disBios -aN|-alladp
Objective:
Disable the bios on adapter N
OR all adapters.
Parameters:
-aN : adapter number
OR
-alladp : means all adapters
Megarc -enableBios -aN|-alladp
Objective:
Enable the bios on adapter N
OR all adapters.
Parameters:
-aN : adapter number
OR
-alladp : means all adapters
Megarc -facDef -aN
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
Megarc -autoRbldOn -aN
Objective:
Enables auto rebuild on adapter N
Parameters:
-aN : adapter number [ must ]
Megarc -autoRbldOff -aN
Objective:
Disables auto rebuild on adapter N
Parameters:
-aN : adapter number [ must ]
Megarc -AllAdpInfo
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:
Megarc -onBIOS_echo|-offBIOS_echo -aN
Objective:
Allow/Disallow BIOS to echo messages during POST
Parameters:
-aN : adapter number [ must ]
Megarc -onBIOS_SOE|-offBIOS_SOE -aN
Objective:
Allow/Disallow BIOS to stop on error
Parameters:
-aN : adapter number [ must ]
Megarc -dskBIOScfgm -aN
Objective:
This allows BIOS to opt for DISK configuration in case
of configuration mismatch.
Parameters:
-aN : adapter number [ must ]
Megarc -nvBIOScfgm -aN
Objective:
This allows BIOS to opt for NVRAM configuration in case
of configuration mismatch.
Parameters:
-aN : adapter number [ must ]
Megarc -usrBIOScfgm -aN
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:
User can not supply multiple values for the same argument on command line. The utility will
flag error message and exit.
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.