volmend - Mends simple problems in configuration records
/usr/sbin/volmend [-g diskgroup] [-U usetype] [-o useopt]
[-Vfrvps] clear field name...
/usr/sbin/volmend [-g diskgroup] [-U usetype] [-o useopt]
[-Vfrvp] fix how name [arg...]
/usr/sbin/volmend [-g diskgroup] [-U usetype] [-o useopt]
[-Vfrvp] off name...
/usr/sbin/volmend [-g diskgroup] [-U usetype] [-o useopt]
[-Vfrvp] on name...
Specifies the disk group for the operation, either by disk
group ID or by disk group name. By default, the disk group
is chosen based on the name operands. Limits the operation
to apply to the specified usage type. Attempts to
affect volumes with a different usage type will fail.
Passes in usage-type-specific options to the operation.
The fsgen, gen, and raid5 usage types support the
following useopt argument: Forces an operation that
internal consistency checks consider to be questionable.
This applies to attempts to use volmend
fix empty to uninitialize a volume that has plexes
in the ACTIVE state, and also to attempts to disable
the last plex, or the last complete (nonsparse)
plex, in a volume. This flag is the same
as -f.
The fsgen and gen usage types support the following
additional useopt arguments: Requires that any
named plex or subdisk record be associated,
directly or indirectly, with a volume named volume.
Several vol options can be specified to indicate a
list of allowed volume names. Requires that any
named subdisk record be associated with a plex
named plexname. Several plex options can be specified
to indicate a list of allowed plex names.
Displays a list of utilities that would be called
from volmend, along with the arguments that would
be passed. The -V option performs a "mock run" so
the utilities are not actually called. Forces an
operation that the Logical Storage Manager considers
potentially dangerous or unnecessary. This
enables a limited set of additional operations that
would normally not be allowed. Some operations may
be disallowed even with this flag. Operates recursively
on records associated with the named volume
or plex record. Operations applied to a volume will
apply to the associated plexes and subdisks. Likewise,
operations applied to a plex may be applied
to the associated subdisks. Restricts operations
to volume records that match the name operand.
Restricts operations to plex records that match the
name operand. Restricts operations to subdisk
records that match the name operand.
The volmend utility performs various Logical Storage Manager
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.
Each invocation applies to only one disk group at a time,
due to internal implementation constraints. Any name
operands will be used as record names to determine a
default disk group, according to the standard disk group
selection rules described in volintro(8). You can specify
a disk group with -g diskgroup.
These are the recognized operation keywords for volmend:
Clears specified utility fields for each named record in
the disk group. An option of -v, -p, or -s specifies that
the utility operates only on volumes, plexes, or subdisks,
respectively. If a record is a volume, or is associated
directly or indirectly with a volume, the clear operation
is performed according to rules used by the usage type
appropriate for that volume.
The field operand is a comma-separated list of keywords
specifying fields to be cleared. Valid keywords
for the field operand are: Clears all clearable
utility fields. Normally, this clears all of
the persistent and non-persistent utility fields. A
usage-type utility may choose a different set of
fields, as appropriate. Clears all persistent
utility fields. Clears all non-persistent (temporary)
utility fields. Clears a specific persistent
utility field. Clears a specific non-persistent
utility field.
For the fsgen and gen usage types, the number of
plexes currently being attached, either directly or
as part of a compound operation, is stored in the
tutil0 field of the volume record as a string in
the form ATTnumber. If the number drops to zero,
the tutil0 field is cleared. Some operations on a
volume require that the tutil0 field be cleared.
The fsgen and gen usage types support the following
additional field keyword: Removes locks on a volume
for a particular number of concurrent plex attach
operations.
You can use this operation to clear a volplex att
operation that fails to terminate cleanly. For
example, suppose that the following command was
issued and then abruptly terminated by pressing the
INTERRUPT key (or equivalent): volplex att v1 v1-01
The volplex command would respond to the interruption
by displaying a list of commands to run. For
this example, you would run the following commands
from the list: volmend clear tutil0 v1-01 volmend
clear att1 v1 volplex dis v1-01
Changes the state of a volume, plex, or subdisk
named by the name operand, in a manner specified by
the how string. The meaning of this operation is
entirely usage-type specific. This operation
applies to volumes, or to plexes associated with a
volume, or to subdisks of a raid5 volume. Usagetype
rules appropriate for the volume are used to
interpret the command. Additional arguments, after
name, are interpreted according to rules defined by
the usage type.
The fsgen, gen, and raid5 usage types support the
following volmend fix operations: Sets the state
for the named plex to CLEAN. The associated volume
must be disabled, the named plex must be in the
STALE state, and the volume must have no additional
plexes in the CLEAN state.
A volume is not startable if one plex is in the
CLEAN state and some plexes are in the ACTIVE
state. Thus, several volmend fix operations are
normally used in conjunction to set all plexes in a
volume to STALE and then to set one plex to CLEAN.
A volume start operation will then enable the CLEAN
plex and recover the STALE plexes by copying data
from the one CLEAN plex. Sets the state for the
named plex to ACTIVE. The state for the volume is
set to SYNC. The associated volume must be disabled,
and the named plex must be in the STALE
state.
When starting a volume in the SYNC state, all
ACTIVE plexes are enabled and are synchronized to
have the same contents using a special read/writeback
recovery mode. Any STALE plexes are then
recovered by copying data from the ACTIVE plexes.
Sets the state for the named plex to STALE. The
associated volume must be disabled, and the named
plex must be ACTIVE or CLEAN. This operation names
plexes that will be recovered by copying data from
other plexes by a volume start operation. Sets the
named volume and all of its associated plexes to
the EMPTY state. The volume can then be re-initialized
using volume start or any of the volume init
operations. This operation requires that the volume
be disabled.
The raid5 usage type supports the following additional
volmend fix operation: Clears any flags
indicating that a subdisk of a RAID 5 plex is
invalid. This will prevent the data on the subdisk
from being recovered when the volume is started.
Puts the named plexes or volumes into an offline
state. This operation applies only to volumes, or
to plexes associated with a volume. Usage type
rules appropriate for the volume are used to perform
the operation.
The fsgen and gen usage types allow volumes and
plexes to be specified as operands to volmend off.
A volume can be named only if -r is used to specify
recursion, and is applied to all plexes in the volume.
Offlining a plex disables the plex and sets
its state to OFFLINE.
Offlining the last enabled read-write plex in a
volume, or the last complete plex (if there are
additional sparse plexes) will normally fail unless
-f is specified. Applying this operation to a
volume also disables the volume, and does not
require use of -f.
If a volume is disabled, the checks for the last
plex or the last complete plex are performed on the
set of ACTIVE and CLEAN plexes, rather than on
enabled read-write plexes.
You can clear an offline state for a plex with volmend
on. Alternatively, you can reattach an
offline plex with volplex att. Takes the named
plexes or volumes out of the offline state. This
operation applies only to volumes, or to plexes
associated with a volume. Usage-type rules appropriate
for the volume are used to perform the operation.
The fsgen and gen usage types allow volumes and
plexes to be specified as operands to volmend on.
The volmend on operation applied to a plex will
change the OFFLINE state for a plex to STALE,
allowing the plex to be recovered by the next volume
start or volume startall. Applying volmend on
to a volume will change the state for all associated
OFFLINE plexes to STALE.
The volmend 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(8) for a list of standard
exit codes.
The utility that performs volmend operations for a particular
volume usage type.
volintro(8), volplex(8), volume(8)
volmend(8)
[ Back ] |
