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 Volume Manager 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 the Volume
Manager 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.
- -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 following command lists all the subdisks that were
hot-relocated from
disk01 in the disk group rootdg. Note that
you must prefix the field name with "sd_" for the
command to work.
vxprint -g rootdg -se 'sd_orig_dmname="disk01"'
- 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 encountered,
but rather denotes the first condition
that prevented further execution of the utility.
See
vxintro(1M)
for a list of standard exit codes.
Printable version
