unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (HP-UX-11.11)
Page:
Section:
Apropos / Subsearch:
optional field



 vxdiskadm(1M)			  VxVM 3.5		       vxdiskadm(1M)
				 1 Jun 2002



 NAME
      vxdiskadm - menu-driven VERITAS Volume Manager disk administrator

 SYNOPSIS
      vxdiskadm

 DESCRIPTION
      vxdiskadm provides a menu-driven interface to perform common VERITAS
      Volume Manager (VxVM) disk administration tasks.

      The vxdiskadm script is interactive and prompts you for responses,
      supplying defaults where appropriate.  Help is available at every
      prompt by entering a question mark (?) to display a context-sensitive
      help message.

      To add disks, specify one or more disks with a disk-address-pattern-
      list.  The basic format for disk addresses is c#t#d# or enclosure-
      based names such as enc1_0.  You can specify just the controller and
      target to add all the disks at that SCSI address.	 For example, use
      c2t0 to specify all disks on controller two, target zero.	 You can
      specify more than one disk address or address pattern on the command
      line.  The word all specifies all disks on the system.  Disk address
      names relate directly to device node names in the /dev/dsk and
      /dev/rdsk directories.

      You can use the files /etc/vx/disks.exclude, /etc/vx/cntrls.exclude
      and /etc/vx/enclr.exclude to exclude disks, controllers and enclosures
      from use by vxdiskadm.  Each line of disks.exclude specifies a disk to
      exclude, for example, c0t3d0.  Each line of cntrls.exclude specifies
      the address of a controller to exclude, for example, c2.	Each line of
      enclr.exclude specifies an enclosure to be excluded, for example,
      enc1.

 OPERATIONS
      Add or initialize one or more disks
		Prompts for one or more disk device addresses.	Prompts for
		a disk group (which defaults to rootdg).  You are also given
		the alternative of initializing the disk but leaving it
		unallocated to a disk group.  If a disk group is specified,
		you must name the disk.	 A default disk name in the form
		disk## is chosen for the root disk group.  If you add a disk
		to a disk group other than rootdg, the name is in the form
		diskgroup##, such that the names are unique within all
		imported disk groups.  If a disk group is specified for the
		disks, you are prompted to specify whether to designate the
		disks as spares for the disk group.

      Remove a disk
		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



				    - 1 -	  Formatted:  August 2, 2006






 vxdiskadm(1M)			  VxVM 3.5		       vxdiskadm(1M)
				 1 Jun 2002



		first move all volumes off the disk.  If this disk is the
		last disk in a group, you are also prompted whether to
		remove the disk group from the system.

		The operation then calls vxdg rmdisk to remove the disk from
		its disk group.	 If this is the last disk in its disk group,
		vxdg deport is used instead.

      Remove a disk for replacement
		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, those volumes are listed
		and you are prompted whether to continue the operation.

		The operation calls vxdg -k rmdisk to dissociate the media
		record from the physical disk.	If there are formatted disks
		available that have disk headers but no disk group, you are
		prompted whether to use one of these disks as a replacement.

      Replace a failed or removed disk
		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 whether to reattach that disk.

		If a matching disk is not used, you are prompted for a new
		disk, by device address.  If the named replacement disk has
		a valid disk header, but is not allocated to a disk group,
		you are prompted whether to reinitialize the disk.  If the
		named replacement disk is listed as allocated to a disk
		group or to another host, you are prompted whether to
		continue the operation.

		If the device is initialized, vxdisksetup is called to set
		up public and private regions and to create the disk header.

		Given an initialized disk, the operation replaces the disk
		in a disk group with vxdg -k adddisk.

      Mirror volumes on a disk
		Prompts for a disk, by media name.  It then prompts for a
		destination disk within the same disk group, also by media
		name.  Specifying no destination disks indicates that any
		disk can be the destination.  The operation calls vxmirror
		to mirror the volumes.

      Move volumes from a disk
		Prompts for a disk, by 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



				    - 2 -	  Formatted:  August 2, 2006






 vxdiskadm(1M)			  VxVM 3.5		       vxdiskadm(1M)
				 1 Jun 2002



		suitable.  The operation calls vxevac to move subdisks off
		the disk.

      Enable access to (import) a disk group
		Prompts for a disk group name.	The operation calls vxdg
		import to import the disk group stored on that disk.

      Remove access to (deport) a disk group
		Prompts for a disk group name.	The prompt lists alternate
		disk groups and the disks (media name and access name) that
		they contain.  The operation calls vxdg deport.

      Enable (online) a disk device
		Prompts for a disk device.  The prompt lets you display the
		disks on the system.  The operation functions only for disks
		currently offline.  It then makes the disk accessible.

      Disable (offline) a disk device
		Prompts for a disk device.  The prompt lets you display the
		disks on the system.  The operation functions only for disks
		currently online, but not part of any disk group.  It then
		marks the disk as offline such that VxVM no longer tries to
		access the disk.

      Mark a disk as a spare for a disk group
		Sets up a disk 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
		Removes a disk from the list of spare disks, and returns its
		space to the general pool of available space.

      Remove (deport) and destroy a disk group
		Removes access to and destroys a disk group that is
		currently enabled (imported). A disk group may be destroyed
		if the disks are needed for some other purpose.

      Unrelocate subdisks back to a disk
		Moves subdisks which were hot-relocated following a disk
		failure back to the original disk, or to a disk with a
		different name, possibly with a different offset.

      Exclude a disk from hot-relocation use
		Sets up a disk to be excluded from use by hot-relocation.
		The disk is marked as nohotuse and it cannot be used by
		hot-relocation to replace a disk that has failed.  However,
		it remains available to be used as free space for its disk
		group.




				    - 3 -	  Formatted:  August 2, 2006






 vxdiskadm(1M)			  VxVM 3.5		       vxdiskadm(1M)
				 1 Jun 2002



      Make a disk available for hot-relocation use
		Turns off the nohotuse flag on a disk.	Use this option to
		make a disk available for hot-relocation use. This only
		applies to disks that were previously excluded from hot-
		relocation use.

      Prevent multipathing/Suppress devices from VxVM's view
		Excludes devices from VxVM's view, or prevents them from
		being multipathed by the dynamic multipathing (DMP) driver,
		vxdmp.

		There are three ways of specifying the devices on which
		these operations are to be performed:

		+    As a controller for all devices connected through the
		     controller.

		+    As a physical pathname for all devices under that path.

		+    As a combination of the Vendor ID and Product ID
		     (VID:PID) for all devices of that type.

		This option also provides a method to define pathgroups in
		case of disks which are not multipathed by VxVM. Only one
		path from a pathgroup will be made visible to VxVM. This is
		useful to avoid duplicate entries for devices that are not
		multipathed by vxdmp.

      Allow multipathing/Unsuppress devices from VxVM's view
		Makes devices visible to VxVM again or makes vxdmp multipath
		these devices again. This can be performed only on devices
		that have already been specified using the "Prevent
		multipathing/Suppress devices from VxVM's view" option.

      List currently suppressed/non-multipathed devices
		Lists all devices suppressed from VxVM's view and all
		devices prevented from being multipathed by vxdmp.

      Change the disk naming scheme
		Changes the disk naming scheme from the c#t#d# format to
		enclosure-based.  Alternatively, if the existing naming
		scheme is enclosure-based, it is changed to c#t#d# format.

      List disk information
		Displays a list of disks.  You can also choose to list
		detailed information about the disk at a specific disk
		device address.

 Hardware-Specific Note
      Some environments provide guidelines to optimize VxVM's interaction
      with intelligent storage systems. If these guidelines are present,



				    - 4 -	  Formatted:  August 2, 2006






 vxdiskadm(1M)			  VxVM 3.5		       vxdiskadm(1M)
				 1 Jun 2002



      VxVM follows the guidelines when adding disks to disk groups and when
      mirroring the volumes on a disk. If the operation fails due to these
      guideline(s), you are prompted to use the force option. The force
      option ignores any such storage-specific guidelines.

 FILES
      /etc/vx/cntrls.exclude	    Specifies the address of controllers to
				    exclude from vxdiskadm operations.

      /etc/vx/disks.exclude	    Specifies the address of disks to
				    exclude from vxdiskadm operations.

      /etc/vx/enclr.exclude	    Specifies the names of enclosures to
				    exclude from vxdiskadm operations.

 SEE ALSO
      vxdg(1M), vxdisk(1M), vxdiskadd(1M), vxdisksetup(1M), vxevac(1M),
      vxintro(1M)




































				    - 5 -	  Formatted:  August 2, 2006