voldiskadm man page on DigitalUNIX

Man page or keyword search:  
man Server   12896 pages
apropos Keyword Search (all sections)
Output format
DigitalUNIX logo
[printable version]

voldiskadm(8)							 voldiskadm(8)

NAME
       voldiskadm - Menu interface for LSM disk administration

SYNOPSIS
       /usr/sbin/voldiskadm

DESCRIPTION
       The  voldiskadm	script is an interactive tool that presents you with a
       menu of possible operations. When you select an operation,  the	script
       guides  you 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  sup‐
       plied  when  possible.  Context-sensitive  help	is  available at every
       prompt by typing ?. Also, you can enter l or list to get information on
       available target disks for an operation.

       For  operations that require a device name, you can specify one or more
       names 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 numbered options: Add or
       initialize one or more disks

	      This option prompts for one or more disk device addresses, which
	      must  have valid disk labels. You can add the specified disks to
	      an existing disk group, add them to (create) a new  disk	group,
	      add  them	 to  a disk group as spares, or initialize them but do
	      not add them to a	 disk  group  (to  reserve  them  for  use  as
	      replacement disks).

	      After  specifying	 the  disks, you are 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  informa‐
	      tion  already  on them. If there is, you are given the option of
	      encapsulating the disks or proceeding with  the  initialization.
	      If you want to preserve the information on the disk, encapsulate
	      it.  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,  to  com‐
	      pletely  remove  from LSM. The disk is checked to ensure that no
	      subdisks reside on the disk.  If the disk is in use, the	opera‐
	      tion  fails  with a recommendation to first move all volumes off
	      the disk. If this disk is the last disk in a disk group, you are
	      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 you
	      are 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, you  are
	      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, you are
	      prompted for whether that disk should be reattached.

	      If a matching disk is not used, you are 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, you	 are  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,  you  are	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.   Make sure that the destination disk has
	      enough space for the mirror.  Specifying	no  destination	 disks
	      indicates	 that  any disk is suitable. The operation proceeds by
	      calling volmirror to mirror the volumes.	You  cannot  use  this
	      option  if the volume is already mirrored, or if the volume con‐
	      sists of more than one subdisk.

	      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. If the specified disk is large enough, or if
	      there is enough available space if you did not specify  a	 disk,
	      the  operation  proceeds by calling volevac to move subdisks off
	      the disk.

	      If the original disk remains under LSM control, future  move  or
	      mirror  operations  could put the volume back onto that disk. If
	      the disk is suspect, remove it (option 4) or  place  it  offline
	      (option 11).  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.

	      Use  this	 option	 to import a disk group that you deported from
	      another system. If two hosts share a SCSI	 bus,  make  sure  the
	      other  host  failed or deported the disk group before you import
	      it. If two hosts import a disk group at the same time, the  disk
	      group  will  become  corrupted  and  unusable.  Remove 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.

	      Use  this option to deport a disk group that you plan to move to
	      a different system, or to effectively remove the last disk  from
	      a	 disk  group. You cannot deport the rootdg disk group.	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.  LSM cannot use space 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 disk replacement

	      This  operation  performs plex attachment, RAID-5 subdisk recov‐
	      ery, 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).

       The voldiskadm menu also includes the following word and character menu
       choices: Displays a list of candidate disks for voldiskadm  operations.
       From  this  list,  you  can display detail information about a specific
       disk by entering the disk name at the prompt.  Displays detailed infor‐
       mation about each of the 14 menu operations, and a glossary of LSM ter‐
       minology.  Displays a list of inputs you can supply at any time:	 q  to
       quit the operation, x to exit from the voldiskadm menu interface, ?  to
       display help for the current operation, or ??  to display general  help
       for  the	 Logical Storage Manager administration menus.	Exits from the
       voldiskadm menu interface.

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 voldiskadm use.

SEE ALSO
       disklabel(8),  volintro(8),  voldg(8), voldisk(8), voldiskadd(8), vold‐
       isksetup(8), volrootmir(8)

								 voldiskadm(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