voldiskadm(8)						      System Manager's Manual						     voldiskadm(8)

NAME

       voldiskadm - Menu interface for LSM disk administration

SYNOPSIS

       /usr/sbin/voldiskadm

DESCRIPTION

       The  voldiskadm	script	is an interactive tool that presents a menu of possible operations to the user. When an operation is selected, the
       script guides the user through the necessary steps, and prompts for data needed to complete the operation.

       The voldiskadm interface is intended mainly for beginning users and for those who prefer a simple method for doing common operations.   The
       interface  uses	query-based  prompts  to  gather input, with defaults supplied when possible. Context-sensitive help is available at every
       prompt by typing ?. Also, a list option can be used to get information on available target disks for an operation.

       For operations that require a device name, one or more names can be specified using a space-separated list. Names in the list can have  the
       form  dskn  or rdskn (for an entire disk) or dsknp or rdsknp (for a specific disk partition). Disk names relate directly to device names in
       the /dev/disk and /dev/rdisk directories.

       The file, /etc/vol/disks.exclude, may be used to exclude disks from use by voldiskadm.  Each line of the file specifies the name of a  disk
       to exclude (for example, dsk5).

       The voldiskadm menu includes the following options: Add or initialize one or more disks

	      This  option  prompts  for one or more disk device addresses. The specified disks can be added to an existing disk group, added to a
	      new disk group, added to a disk group as spares, or initialized but not added to a disk  group  (reserved  for  use  as  replacement
	      disks).

	      After  specifying  the  disks, the user is prompted for a disk group (rootdg by default) and a disk name. If no name is specified, a
	      default disk name is assigned (diskn for disks in the rootdg disk group and diskgroupn for disks in other disk groups).

	      The disks are then checked to ensure that there is no information already on them. If there is, the user	is  given  the	option	of
	      encapsulating the disks.	Encapsulate one or more disks

	      This option prompts for one or more disk addresses.  It then calls volencap to encapsulate the specified partitions.  Remove a disk

	      This option prompts for a disk, by disk media name.  The disk is checked to ensure that no subdisks reside on the disk.  If the disk
	      is in use, the operation fails with a recommendation to first move all volumes off the disk.  If this disk is the  last  disk  in  a
	      disk group, the user is prompted for whether the disk group should be removed from the system, as well.

	      The  operation proceeds by calling voldg rmdisk to remove the disk from its disk group.  If this is the last disk in its disk group,
	      voldg deport is used, instead, to remove the disk group from use.  Remove a disk for replacement

	      This option prompts for a disk, by disk media name.  The disk is checked for volumes that would lose all mirrors as a result of  the
	      operation. If such volumes exist, they are listed and the user is prompted to ensure that the operation should proceed.

	      The  operation  proceeds	by calling voldg -k rmdisk to dissociate the media record from the physical disk.  If some formatted disks
	      are under LSM control but not assigned to a disk group, the user is prompted for whether one of these disks  should  be  used  as  a
	      replacement.  Replace a failed or removed disk

	      This  option  prompts for a disk media name.  The named media record must be dissociated from a disk.  If the media record is not in
	      the removed state, unused disks are scanned for matching disk IDs.  If a disk with a matching disk ID is found, the user is prompted
	      for whether that disk should be reattached.

	      If a matching disk is not used, the user is prompted for a new disk, by device name.  If the named replacement disk has a valid disk
	      header, but is not allocated to a disk group, the user is prompted for whether the disk  should  be  reinitialized.   If	the  named
	      replacement disk is listed as allocated to a disk group or to another host, the user is prompted to ensure that the operation should
	      proceed.

	      If the device is to be initialized, a new disk label is written to the disk to reflect its private and public regions.

	      Given an initialized disk, the operation proceeds by replacing the disk in a disk group with voldg -k adddisk.  Mirror volumes on  a
	      disk

	      This option prompts for a disk, by disk media name.  It then prompts for a destination disk within the same disk group, also by disk
	      media name.  Specifying no destination disks indicates that any disk is suitable. The operation proceeds	by  calling  volmirror	to
	      mirror the volumes.

	      Mirroring  volumes  from	the  boot disk will produce a disk that can be used as an alternate boot disk. This is done by calling the
	      volrootmir command.  Move volumes from a disk

	      This option prompts for a disk, by disk media name.  It then prompts for a possible list of destination disks, also  by  disk  media
	      name.  Specifying  no  destination disks indicates that any disk is suitable. The operation proceeds by calling volevac to move sub-
	      disks off the disk.  Enable access to (import) a disk group

	      This option prompts for a disk, by device address.  The operation proceeds by calling voldg import to import the disk  group  stored
	      on that disk.  Disable access to (deport) a disk group

	      This  option  prompts  for  a  disk group name.  The prompt display lists alternate disk groups and the disks (media name and access
	      name) that they contain.	The operation proceeds by calling voldg deport.  Enable (online) a disk device

	      This option prompts for a disk device.  The prompt display allows for a display of disks on the system.  The  operation  only  func-
	      tions for disks currently in an offline state.  It then proceeds to make the disk accessible.  Disable (offline) a disk device

	      This  option  prompts  for a disk device.  The prompt display allows for a display of disks on the system.  The operation only func-
	      tions for disks currently in an online state but not part of any disk group.  It then proceeds to mark the disk as offline such that
	      the Logical Storage Manager makes no further attempt at accessing the disk.  Mark a disk as a spare for a disk group

	      This option sets up a disk to be used as a spare device for its disk group. A spare disk can be used to automatically replace a disk
	      that has failed.	No space can be used on a disk that is marked as a spare.  Turn off the spare flag for a disk

	      This option removes a disk from those that can be used as a spare and returns its space to the  general  pool  of  available  space.
	      Recover plexes and volumes after replacement

	      This operation performs plex attachment, RAID-5 subdisk recovery, and resynchronize operations for the named volumes, or for volumes
	      residing on the named disks (media name). If no media name or volume operands are specified, the operation applies  to  all  volumes
	      (or to all volumes in the specified disk group).

ERRORS

       See the voldiskadd(8) reference page for a description of errors related to the initialization operation.

FILES

       A list of disks to exclude from use by voldiskadm.

SEE ALSO

       disklabel(8), volintro(8), voldg(8), voldisk(8), voldiskadd(8), voldisksetup(8), volrootmir(8)

																     voldiskadm(8)