volmend(1M) Volume Manager Utilities volmend(1M)
NAME
volmend - Mends simple problems in configuration records
SYNOPSIS
volmend [ -U usetype ] [ -o useopt ] [ -Vrvps ] clear what object ...
volmend [ -U usetype ] [ -o useopt ] [ -Vvps ] fix what object arg ...
volmend [ -U usetype ] [ -o useopt ] [ -Vrvp ] off object ...
volmend [ -U usetype ] [ -o useopt ] [ -Vrvp ] on object ...
DESCRIPTION
The volmend utility performs various Volume Manager
miscellaneous usage-type-specific operations on subdisk,
plex, and volume records. The first operand is a keyword
that determines the specific operation to perform. The
remaining operands specify the configuration objects to
which the operation is applied.
These are the recognized operation keywords:
clear
Clear specified utility fields for each object from the
volume configuration database. An option of -v, -p, or
-s specifies that the utility operates only on volume,
plex, or subdisk objects, respectively. If an object
is a volume, or is associated directly or indirectly
with a volume, then the clear operation is performed by
a usage-type utility appropriate for that volume.
Otherwise, the utility for the gen volume usage-type is
called.
The what operand is a comma-separated list of keywords
specifying fields to be cleared. Each keyword in the
what operand is one of the following:
all Clear all clearable utility fields. Normally,
this clears all of the temporary and permanent
utility fields. A usage-type utility may choose a
different set of fields, as appropriate.
putil
Clear all permanent utility fields.
tutil
Clear all temporary utility fields.
tutil0, tutil1, or tutil2
Clear a specific temporary utility field.
putil0, putil1, or putil2
Clear a specific permanent utility field.
Usage-types may implement additional what keywords. A
Page 1 (printed 1/21/92)
volmend(1M) Volume Manager Utilities volmend(1M)
usage-type may also limit the set of clear operations
that can be performed.
fix Change the state of a volume or plex in a manner
specified by the what string. The meaning of this
operation is entirely usage-type specific. The object
operand is used to determine the usage-type for the
operation. If this is a volume, then the usage-type is
taken from that volume. For a plex, the usage-type is
taken from the volume with which the plex is
associated. It is an error for the first object
operand to be a subdisk or an unassociated plex. The
additional arg options are passed to the usage-type
without modification.
off Put the specified plex or volume objects into an
offline state. The meaning and operation of this
action is usage-type-specific. This operation can be
applied only to volumes or plexes associated with a
volume. If more than one usage-type is represented by
the object operands, more than one usage-type utility
is invoked.
on Put the specified plex or volume objects into an online
state. The meaning and operation of this action is
usage-type specific. This operation can be applied
only to volumes or to plexes associated with a volume.
If more than one usage-type is represented by the
object operands, more than one usage-type utility will
be invoked.
OPTIONS
The following options are recognized:
-U usetype
Force the operation to be performed by the usage-type
utility for this usage-type.
-o useopt
Give usage-type-specific options to the usage-type-
specific form of the utility.
-V Write a list of utilities that would be called from
volmend, along with the arguments that would be passed.
The -V performs a ``mock run'' of the utilities; the
utilities are not actually called, and no changes are
made to the volume configuration database.
-r Operate recursively on objects that are associated with
a named object. If the clear operation is performed
directly by the volmend utility, then the operation
applies to all plex or subdisk structures that are
Page 2 (printed 1/21/92)
volmend(1M) Volume Manager Utilities volmend(1M)
associated with the named object. The operation will
not apply to objects with which the named objects are
associated; that is, the recursion is downward in the
hierarchy, not upward.
-v Restrict the set of object operands to volumes.
-p Restrict the set of object operands to plexes.
-s Restrict the set of object operands to subdisks.
USAGE-TYPE INTERFACE
The usage-type-specific volmend utilities perform the
actions that were requested by the user. Usage-type
utilities are called with the same options and keyword given
to the volmend switchout utility. However, the object
operands given to a specific usage-type are restricted to
those operands associated with that usage-type. An
associated plex is associated with the usage-type of its
volume. A subdisk associated with an associated plex is
associated with the usage-type of the plex's volume. An
unassociated plex or subdisk, or a subdisk associated with
an unassociated plex, are associated with the gen usage-
type.
However, if a usage-type is specified with the -U option
letter, then the volmend utility for that usage-type is
given all object operands, regardless of whether the
specified usage-type is appropriate.
The what operands for the clear and fix operations and the
arg operands for the fix operation are passed through to the
usage-type utility without modification or reordering. No
interpretation of these operands is performed by the
switchout volmend utility.
SYNOPSIS FOR FSGEN AND GEN USAGE-TYPES
volmend [ -U usetype ] [ -o useopt ] [ -rvps ] clear what object ...
volmend [ -U usetype ] [ -o useopt ] [ -vps ] fix what object ...
volmend [ -U usetype ] [ -o useopt ] [ -rvp ] off object ...
volmend [ -U usetype ] [ -o useopt ] [ -vp ] on object ...
FSGEN AND GEN DESCRIPTION
The volmend utility for the fsgen and gen usage-types
performs various Volume Manager error-recovery operations.
The first operand is a keyword that determines the specific
operation to perform. The remaining operands specify the
configuration objects to which the operation is to be
applied.
The recognized operation keywords are
Page 3 (printed 1/21/92)
volmend(1M) Volume Manager Utilities volmend(1M)
clear
Clear specified utility fields for each object from the
volume configuration database. The options -v, -p, and
-s cause the utility to operate on volume, plex, or
subdisk objects, respectively. If an object is a
volume, or is associated directly or indirectly with a
volume, then the clear operation is performed by a
usage-type utility appropriate for that volume.
Otherwise, the utility for the gen volume usage-type is
called. The what operand is a list of keywords,
separated by commas, specifying fields to be cleared.
Each keyword in the what operand is one of the
following:
all Clear all temporary and permanent utility fields.
putil
Clear all permanent utility fields.
tutil
Clear all temporary utility fields.
tutil0, tutil1 or tutil2
Clear a specific temporary utility field.
putil0, putil1 or putil2
Clear a specific permanent utility field.
att[number]
Reduce the plex attach count for a volume by
number. If the optional number is not specified,
then the count is decreased by 1. Number must be
a non-negative decimal integer that is not
preceded or followed by white space. This can
only be applied to volumes. The plex attach count
is stored in the volume's tutil[0] field in the
form ATTnumber. If the number in this field drops
to zero, the field is cleared.
fix Change the state of a volume or plex in a manner
specified by the what string. The meaning of this
operation is entirely usage-type specific. The object
operand is used to determine the usage-type for the
operation. If this is a volume, then the usage-type is
taken from that volume. For a plex, the usage-type is
taken from the volume with which the plex is
associated. It is an error for the first object
operand to be a subdisk or an unassociated plex. The
additional arg options are passed to the usage-type
without modification. These are the recognized usages
for the fix operation:
Page 4 (printed 1/21/92)
volmend(1M) Volume Manager Utilities volmend(1M)
clean plex
Set the utility state for the named STALE plex to
CLEAN . This action allows an administrator to
specify a plex from which other plexes will be
revived. This is normally done when all plexes in
a volume have been marked as STALE. For the
operation to succeed the following conditions must
be met:
1. The plex for an fsgen usage-type must be
associated to a volume with a usage-type of
fsgen. The plex for a gen usage-type must be
associated to a volume with a usage-type of
gen.
2. The associated volume must be DISABLED.
3. The utility state for the plex must be STALE.
4. No other plex associated with the volume can
have a utility state of CLEAN. If volmend is
used to set the state for one plex in a volume
to ACTIVE, and to set the state for another
plex in the same volume to CLEAN, then the
volume is not startable until the CLEAN plex
state is changed.
active plex
Set the utility state for the specified STALE plex
to ACTIVE. The plex must be associated with a
DISABLED volume that has a usage-type which
matches the usage-type name - either fsgen or gen
- given with the -U option (gen by default). If
one or more other plexes in a volume are already
ACTIVE, then the start operation for the volume
utility starts the volume from one of these ACTIVE
plexes and then revives the other ACTIVE plexes,
along with any STALE plexes. See the fsgen and
gen sections of volume(1M) for a more detailed
discussion of the start procedure.
stale plex
Set the state for the specified CLEAN or ACTIVE
plex to STALE. The plex must be associated with a
DISABLED volume that has a usage-type which
matches the usage-type name - either fsgen or gen
- given with the -U option (gen by default).
STALE plexes are revived by the start operation
for the volume utility. See the fsgen and gen
sections of volume(1M) for more information.
empty volume
Page 5 (printed 1/21/92)
volmend(1M) Volume Manager Utilities volmend(1M)
Set the state for all plexes in the volume to
EMPTY to allow init operations to be performed on
the volume with the volume utility. The force
option must be specified, through the -o useopt
string, to operate on a volume that contains
plexes in the ACTIVE state. The volume must be in
the kernel DISABLED state.
off Put the specified plexes into the OFFLINE utility
state. If a volume is specified, and the -r option is
given, then all plexes associated with the volume are
put into the OFFLINE state, and the volume is put in
the kernel DISABLED state. The kernel state for each
OFFLINE plex is set to DISABLED. Without -r the off
operation cannot be applied to volumes. Use -o force
to offline the last complete, enabled plex, or the last
CLEAN or ACTIVE plex associated with a volume. This
option is not required when offlining a volume.
on Put the specified plexes into the STALE utility state.
This can only be applied to plexes that are in the
OFFLINE state. If a volume object is specified, then
the operation is applied to all plexes associated with
the volume that are in the OFFLINE state. The volplex
att command must be used to update the plexes and to
put the STALE plexes into the ACTIVE state.
FSGEN AND GEN OPTIONS
The following options are recognized:
-U usetype
For fsgen:
A usage-type name passed in from the switchout volmend
utility. If this option is specified, the value for
usetype must be fsgen.
For gen:
The gen usage-type volmend utility can be used by
another usage-type that has similar characteristics as
long as the name of the other usage-type is specified
with this option.
-o useopt
A list of options separated by commas and white space.
These options can be either a name, or a name and a
value separated by an equal sign. The recognized
usage-type options are
force
Force the empty operation to work with a volume
even if the volume contains plexes in the ACTIVE
state.
Page 6 (printed 1/21/92)
volmend(1M) Volume Manager Utilities volmend(1M)
vol=volname
Require that a named plex be associated with a
volume named volname. If an operation is applied
to a subdisk, then the subdisk must be associated
with a plex that is associated with this volume.
Multiple vol options can be given to specify a set
of allowed volumes.
plex=plexname
Require that a subdisk operand specify a subdisk
that is associated with the plex named plexname.
Subdisks can be specified as operands only to the
clear operation. Multiple plex options can be
given to specify a set of allowed plexes.
-r Operate recursively on objects that are associated with
a named object. This option causes the clear operation
to operate on plexes or subdisks that are associated
with a named volume or on subdisks that are associated
with a named plex.
-v Restrict the set of object operands to volumes.
-p Restrict the set of object operands to plexes.
-s Restrict the set of object operands to subdisks.
FILES
usr/lib/VxVM/type/usetype/volmend
Usage-type-specific utility for performing mending
operations.
EXIT CODES
The utility exits with a nonzero status if the attempted
operation fails. A nonzero 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 volintro(1M) for a list of standard exit
codes.
SEE ALSO
volintro(1M) and volume(1M).
Page 7 (printed 1/21/92)