volmend man page on DigitalUNIX

Printed from http://www.polarhome.com/service/man/?qf=volmend&af=0&tf=2&of=DigitalUNIX

volmend(8)							    volmend(8)

NAME
       volmend - Mends simple problems in configuration records

SYNOPSIS
       /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...

OPTIONS
       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 (non-sparse) 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 vol‐
	      ume. 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 poten‐
	      tially 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 associ‐
	      ated 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 opera‐
	      tions to plex records that match the  name  operand.   Restricts
	      operations to subdisk records that match the name operand.

DESCRIPTION
       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 inter‐
       nal implementation constraints. Any  name  operands  will  be  used  as
       record  names to determine a default disk group, according to the stan‐
       dard disk group selection rules described in volintro(8). You can spec‐
       ify a disk group with -g diskgroup.

       These  are the recognized operation keywords for volmend: Clears speci‐
       fied 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 asso‐
       ciated  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 specify‐
	      ing 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 cur‐
	      rently 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 fol‐
	      lowing command was issued and then abruptly terminated by press‐
	      ing the INTERRUPT key (or equivalent): volplex att v1 v1-01

	      The  volplex  command  would respond to the interruption by dis‐
	      playing 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 mean‐
	      ing 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.  Usage-type	 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 vol‐
	      mend 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/write-back 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 oper‐
	      ation  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 vol‐
	      ume 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  sub‐
	      disk  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.

EXIT CODES
       The volmend utility exits with a nonzero status if the attempted opera‐
       tion fails. A nonzero exit code is not  a  complete  indicator  of  the
       problems	 encountered  but rather denotes the first condition that pre‐
       vented further execution of the utility. See volintro(8) for a list  of
       standard exit codes.

FILES
       The  utility  that  performs volmend operations for a particular volume
       usage type.

SEE ALSO
       volintro(8), volplex(8), volume(8)

								    volmend(8)
[top]

List of man pages available for DigitalUNIX

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net