Running Storage Expert

Command Line Syntax

The rules are invoked using the following syntax:

Each of the rules performs a different function as listed in Rule Definitions and Attributes.

The following options may be specified:

-d defaults_file Specify an alternate defaults file.

-g diskgroup Specify the disk group to be examined.

-v Specify verbose output format.

One of the following keywords must be specified:

check List the default values used by the rule's attributes.

info Describe what the rule does.

list List the attributes of the rule that you can set.

run Run the rule.

A full list of the Storage Expert rules and their default values are listed in Rule Definitions and Attributes.

Discovering What a Rule Does

To obtain details about what a rule does, use the info keyword, as in the following example:

Displaying Rule Attributes and Their Default Values

To see the attributes that are available for a given rule, use the list keyword. In the following example, the single attribute, mirror_threshold, is shown for the rule vxse_drl1:

To see the default values of a specified rule's attributes, use the check keyword as shown here:

Storage Expert lists the default value of each of the rule's attributes.

A full list of rules and the default values of their attributes can be found in Rule Definitions and Attributes.

To alter the behavior of rules, you can change the value of their attributes as described in the section, Setting Rule Attributes.

Running a Rule

The run keyword invokes a default or reconfigured rule on a disk group or file name, for example:

This indicates that the specified disk group (mydg) met the conditions specified in the rule. See Rule Result Types for a list of the possible result types.

Rule Result Types

Running a rule generates output that shows the status of the objects that have been examined against the rule:

INFO Information about the specified object; for example "RAID-5 does not have a log."

PASS The object met the conditions of the rule.

VIOLATION The object did not meet the conditions of the rule.

Setting Rule Attributes

You can set attributes in the following ways:

• Enter an attribute on the command line, for example:

# vxse_drl2 -g mydg run large_mirror_size=30m
• Create your own defaults file, and specify that file on the command line:

# vxse_drl2 -d mydefaultsfile run

Lines in this file contain attribute values definitions for a rule in this format:


rule_name,attribute=value

For example, the following entry defines a value of 20 gigabytes for the attribute large_mirror_size of the rule vxse_drl2:


vxse_drl2,large_mirror_size=20g

You can specify values that are to be ignored by inserting a # character at the start of the line, for example:


#vxse_drl2,large_mirror_size=20g
• Edit the attribute values that are defined in the /etc/default/vxse file. If you do this, make a backup copy of the file in case you need to regress your changes.

Attributes are applied using the following order of precedence from highest to lowest:

1. A value specified on the command line.
2. A value specified in a user-defined defaults file.
3. A value in the /etc/default/vxse file that has not been commented out.
4. A built-in value defined at compile time.