vxse(1M)vxse(1M)NAME
vxse - Storage Expert rules
SYNOPSIS
/opt/VRTS/vxse/vxvm/vxse_rule [-g diskgroup] [-d defaults_file] [-v] check
/opt/VRTS/vxse/vxvm/vxse_rule [-g diskgroup] [-d defaults_file] [-v] info
/opt/VRTS/vxse/vxvm/vxse_rule [-g diskgroup] [-d defaults_file] [-v] list
/opt/VRTS/vxse/vxvm/vxse_rule [-g diskgroup] [-d defaults_file] [-v] run [attribute=value...]
DESCRIPTION
Storage Expert consists of a set of simple commands that collects VxVM configuration data and compares it with "best practice." Storage
Expert then produces a summary report that shows which objects do not meet these criteria and makes recommendations for VxVM configuration
improvements.
These user-configurable tools help you as an administrator to verify and validate systems and non-optimal configurations in both small and
large VxVM installations.
Storage Expert components include a set of rule scripts and a rules engine. The rules engine runs the scripts and produces ASCII output,
which is organized and archived by Storage Expert's report generator. This output contains information about areas of VxVM configuration
that do not meet the set criteria. By default, output is sent to the screen, but you can redirect it to a file using standard UNIX redi-
rection.
KEYWORDS
check Lists the default values used by a rule's attributes.
info Describes what a rule does.
list Lists the attributes of a rule that can be set.
run Runs a rule. If one or more attribute-value pairs are specified, these override the values set in the defaults file.
OPTIONS -d defaults_file
Specifies an alternate default attribute-values file to the standard file, /etc/default/vxse.
-g diskgroup
Specifies the disk group to be examined instead of the default disk group (see vxdg(1M)).
-v Specifies verbose output format.
EXAMPLES
Note: The executable rule files are located in the directory, /opt/VRTS/vxse/vxvm. These examples assume that this directory has been
added to the PATH variable.
Discover what the vxse_stripes2 rule does:
vxse_stripes2 info
Display the attributes that are available for the vxse_drl1 rule:
vxse_drl1 list
Display the default values of the attributes for the vxse_stripes2 rule:
vxse_stripes2 check
Run the vxse_volplex rule on the mydg disk group:
vxse_volplex -g mydg run
Run the vxse_drl2 rule on the mydg disk group with the value of the large_mirror_size attribute set to 30MB:
vxse_drl2 -g mydg run large_mirror_size=30m
Run the vxse_srl2 rule using the default attribute values that are set in the file mydefaultsfile:
vxse_drl2 -d mydefaultsfile -g mydg run
FILES
/etc/default/vxse Standard attribute values file for vxse rules.
/opt/VRTS/vxse/vxvm Directory containing executable rules.
NOTES
See the "Using Veritas Storage Expert" chapter in the Veritas Volume Manager Administrator's Guide for a description of the rules and their
attributes.
SEE ALSO vxdg(1M), vxintro(1M)
Veritas Volume Manager Administrator's Guide
VxVM 5.0.31.1 24 Mar 2008 vxse(1M)
Check Out this Related Man Page
vxunreloc(1M)vxunreloc(1M)NAME
vxunreloc - move a hot-relocated subdisk back to its original disk
SYNOPSIS
/etc/vx/bin/vxunreloc [-f] [-g diskgroup] [-n dm_name] [-t tasktag] dm_name
DESCRIPTION
The Veritas Volume Manager (VxVM) hot-relocation feature can detect an I/O failure in a subdisk, relocate the subdisk, and recover the plex
associated with the subdisk. vxunreloc lets you reverse the process and move the hot-relocated subdisks back onto a disk that was replaced
after a disk failure.
dm_name specifies the disk where the hot-relocated subdisks originally resided. The -n option moves the subdisks to a different disk from
where VxVM originally relocated them. For example, when disk03 fails, all the subdisks residing on it are hot-relocated to other disks.
After the disk is repaired, it is added back to the disk group using a different name, for example, disk05. If you wanted to move all the
hot-relocated subdisks back to the repaired disk, you would enter:
/etc/vx/bin/vxunreloc -n disk05 disk03
When vxunreloc moves the hot-relocated subdisks, it moves them to their original offsets. However, if there was a subdisk that occupied
part or all of the area on the destination disk, vxunreloc prints an error message and exits. In this situation, you can use the -f option
to unrelocate the subdisks to a specified disk, but not to their original offsets.
OPTIONS -f Unrelocates a subdisk to a different offset if unrelocating to the original offset is not possible.
-g diskgroup
Unrelocates a subdisk from the specified disk group. If this option is not specified, the default disk group is determined using
the rules given in the vxdg(1M) manual page.
-n dm_name
Specifies a new disk name to relocate to a disk with a different name.
-t tasktag
Specifies a tag to pass to the underlying utility.
SUBDISK RECORD FIELDS
orig_dmname
When a subdisk is hot-relocated, its original disk media name is stored in the orig_dmname field. When you run the vxunreloc
command to move the subdisk back to the original disk (or to a new disk), this field is cleared. Before you run the vxunreloc
command, you can do a search on this field to determine the subdisks that originated from a failed disk. For example, the fol-
lowing command lists all the subdisks that were hot-relocated from mydg01 in the disk group mydg. Note that you must prefix the
field name with "sd_" for the command to work.
vxprint -g mydg -se 'sd_orig_dmname="mydg01"'
orig_dmoffset
When a subdisk is hot-relocated, its offset into the original disk is stored in the orig_dmoffset field. When you run vxunreloc
to move the subdisk to the original disk, or to a new disk, this field is zeroed. The following command lists a hot-relocated
subdisk which originally resided at disk10 at offset 1000. Again note that you must prefix the field names with "sd_" for the
command to work.
vxprint -g dg01 -se 'sd_orig_dmname="disk10"
&& sd_orig_dmoffset=1000'
EXIT CODES
If the operation fails, vxunreloc exits with a non-zero status. A non-zero exit code is not a complete indicator of the problems encoun-
tered, but rather denotes the first condition that prevented further execution of the utility.
See vxintro(1M) for a list of standard exit codes.
SEE ALSO vxassist(1M), vxintro(1M), vxmake(1M), vxprint(1M), vxrelocd(1M), vxsd(1M), vxsparecheck(1M)VxVM 5.0.31.1 24 Mar 2008 vxunreloc(1M)