<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Transitional//EN">
<HTML>
<HEAD>
  <!--
    *************************************************************************************
    * Copyright (c) 2005 VERITAS Software Corporation. All rights reserved. *

      For third-party license citations, please see the bottom of this file.
    *************************************************************************************
  -->
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<meta name="TEMPLATEBASE" content="DocCD Manual Pages 1.4">
<meta name="LASTUPDATED" content="06/13/05 11:53:56">
<meta name="PRODUCTNAME" content="VERITAS Software Documentation">
<meta name="FILENAME" content="vxdiskadm.fm">
     
<title>vxdiskadm</title>

</HEAD>

<BODY bgcolor="#FFFFFF" link="#000066" vlink="#0000ff" marginheight="0" topmargin="0">
<basefont=1>

<a name="430557"></a>

<div align="left">
<table border="0" cellspacing="0" cellpadding="0" width="100%">
 <tr>
   <td height="2" border="0" cellspacing="0" cellpadding="0" colspan="2" bgcolor="#000000">
   </td>
 </tr>
 <tr>
   <td height="15" width="50%" border="0" cellspacing="0" cellpadding="0" bgcolor="#cccccc">
    <img src="images/vxsymbol.gif" height="20" width="31" border="0" cellspacing="0" cellpadding="0" align="left">
     
     
   </td>
   <td align="right" width="50%" bgcolor="#cccccc">

<!-- Header Breadcrumbs -->
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="-2">&lt;&nbsp;<a href="vxdiskadd_vxvm_manpages35_427929.html" title="Previous - vxdiskadd">Previous</a>&nbsp;&nbsp;|&nbsp;&nbsp;<a href="vxdisksetup_vxvm_manpages37_430296.html" title="Next - vxdisksetup">Next</a>
&nbsp;&gt;&nbsp;&nbsp;</font>
   </td>
 </tr>

 <tr>
  <td bgcolor="#CCCCCC" colspan="2" height="15" align="right">
  <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="1">Product:  
<a href="vxvm_manpages_splashpage_docCD_vxvm_manpages1_103036.vxhd" title="Volume Manager Manual Pages for Storage Foundation title page ">Volume Manager Manual Pages for Storage Foundation</a>
  &nbsp;&nbsp;
  </font>
  </td>
 </tr>
 <tr>
  <td bgcolor="#CCCCCC" colspan="2" height="15" align="right">
  <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="1">Manual:  
<a href="man1m_titlepage_docCD_vxvm_manpages2_73700.vxhd" title="Maintenance Commands (1m) title page ">Maintenance Commands (1m)</a>
  &nbsp;&nbsp;
  </font>
  </td>
 </tr>


</table>
</div>

<div align="left">
 <table border="0" width="100%" bgcolor="#FFFFFF">
  <tr>
   <td width="100%" valign="top" bgcolor="#FFFFFF">

<!-- Start Main Topic Content -->
        <a name="startcontent"></a>
	
<h2><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="3" color="#000000"><a name="428346"></a>vxdiskadm</font>
</h2>

        

<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="428369"></a> NAME</font>
</h3>
<p>
<a name="428374"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">vxdiskadm - menu-driven VERITAS Volume Manager disk administrator </font>
</p>

<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="428377"></a> SYNOPSIS</font>
</h3>
<br>
<font face="Courier, Courier New, sansserif, sans serif" size="2"><a name="428382"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxdiskadm </b></font>
</font>

<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="428385"></a> DESCRIPTION</font>
</h3>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="428390"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxdiskadm</b></font> provides a menu-driven interface to perform common VERITAS Volume Manager (VxVM) disk administration tasks. </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="428402"></a>The <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxdiskadm</b></font> script is interactive and prompts you for responses, supplying defaults where appropriate. Help is available at every prompt by entering a question mark (<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>?</b></font>) to display a context-sensitive help message. </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="428444"></a>To add disks, specify one or more disks with a <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>disk-address-pattern-list</b></font>. The basic format for disk addresses is <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>c</b></font><em>#</em><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>t</b></font><em>#</em><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>d</b></font><em>#</em> or enclosure-based names such as <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>enc1_0</b></font>. You can specify just the controller and target to add all the disks at that SCSI address. For example, use <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>c2t0</b></font> 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 <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>all</b></font> specifies all disks on the system. Disk address names relate directly to device node names in the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>/dev/dsk</b></font> and <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>/dev/rdsk</b></font> directories. </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="428576"></a>You can use the files <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>/etc/vx/disks.exclude</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>/etc/vx/cntrls.exclude </b></font>and <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>/etc/vx/enclr.exclude </b></font>to exclude disks, controllers and enclosures from use by <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxdiskadm</b></font>. Each line of <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>disks.exclude</b></font> specifies a disk to exclude, for example, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>c0t3d0</b></font>. Each line of <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>cntrls.exclude </b></font>specifies the address of a controller to exclude, for example, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>c2</b></font>. Each line of <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>enclr.exclude</b></font> specifies an enclosure to be excluded, for example, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>enc1</b></font>. </font>
</p>


<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="428697"></a> OPERATIONS</font>
</h3>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="428703"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>Add or initialize one or more disks</b></font></font>
</p>
<p>
<a name="430771"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Prompts for one or more disk device addresses, and a disk group to which these are to be added. </font>
</p>
<p>
<a name="425038"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">When initializing disks into a new disk group, you are prompted to choose whether this disk group should be compatible with the Cross-platform Data Sharing (CDS) feature. </font>
</p>
<p>
<a name="425042"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">You are also given the alternative of initializing the disk but leaving it unallocated to a disk group. A default disk name is assigned with the format, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>diskgroup</b></font><em>##</em>, such that the names are unique within all imported disk groups. You are  prompted to specify whether to designate the disks as spares for the disk group. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="428830"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>Remove a disk</b></font></font>
</p>
<p>
<a name="430804"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">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 group, you are also prompted whether to remove the disk group from the system. </font>
</p>
<p>
<a name="425061"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The operation then calls <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxdg rmdisk</b></font> to remove the disk from its disk group. If this is the last disk in its disk group, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxdg deport</b></font> is used instead. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="428962"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>Remove a disk for replacement</b></font></font>
</p>
<p>
<a name="430834"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">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. </font>
</p>
<p>
<a name="425073"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The operation calls <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxdg -k rmdisk</b></font> 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. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="429074"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>Replace a failed or removed disk</b></font></font>
</p>
<p>
<a name="430864"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Prompts for a disk media name. The named media record must be dissociated from a disk. If the media record is not in the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>removed</b></font> 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. </font>
</p>
<p>
<a name="425089"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">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. </font>
</p>
<p>
<a name="425100"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">If the device is initialized, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxdisksetup</b></font> is called to set up public and private regions and to create the disk header. </font>
</p>
<p>
<a name="425104"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Given an initialized disk, the operation replaces the disk in a disk group with <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxdg -k adddisk</b></font>. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="429307"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>Mirror volumes on a disk</b></font></font>
</p>
<p>
<a name="430904"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">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 <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxmirror</b></font> to mirror the volumes. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="429374"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>Move volumes from a disk</b></font></font>
</p>
<p>
<a name="430927"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">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 suitable. The operation calls <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxevac</b></font> to move subdisks off the disk. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="429432"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>Enable access to (import) a disk group</b></font></font>
</p>
<p>
<a name="430950"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Prompts for a disk group name. The operation calls <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxdg import</b></font> to import the disk group stored on that disk. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="429463"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>Remove access to (deport) a disk group</b></font></font>
</p>
<p>
<a name="430973"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">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 <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxdg </b></font>deport. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="429531"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>Enable (online) a disk device</b></font></font>
</p>
<p>
<a name="430992"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">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. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="429589"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>Disable (offline) a disk device</b></font></font>
</p>
<p>
<a name="431011"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">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. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="429667"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>Mark a disk as a spare for a disk group</b></font></font>
</p>
<p>
<a name="431030"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">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. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="429707"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>Turn off the spare flag for a disk</b></font></font>
</p>
<p>
<a name="431049"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Removes a disk from the list of spare disks, and returns its space to the general pool of available space. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="429729"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>Remove (deport) and destroy a disk group</b></font></font>
</p>
<p>
<a name="431068"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">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. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="429760"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>Unrelocate subdisks back to a disk</b></font></font>
</p>
<p>
<a name="431087"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">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. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="429791"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>Exclude a disk from hot-relocation use</b></font></font>
</p>
<p>
<a name="431106"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">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. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="429841"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>Make a disk available for hot-relocation use</b></font></font>
</p>
<p>
<a name="431125"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">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. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="429881"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>Prevent multipathing/Suppress devices from VxVM's view</b></font></font>
</p>
<p>
<a name="431148"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Excludes devices from VxVM's view, or prevents them from being multipathed by the dynamic multipathing (DMP) driver, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxdmp</b></font>. </font>
</p>
<p>
<a name="425194"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">There are three ways of specifying the devices on which these operations are to be performed: </font>
</p>
<p>
<ul type="disc"><p>
<ul type="disc"><p>
<ul type="disc"><li><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="425199"></a>As a controller for all devices connected through the controller. </font>
</li>
<li><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="425202"></a>As a physical pathname for all devices under that path. </font>
</li>
<li><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="425205"></a>As a combination of the Vendor ID and Product ID (<em>VID</em><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>:</b></font><em>PID</em>) for all devices of that type. </font>
</li>
<blockquote>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="425209"></a>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 <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxdmp</b></font>. </font>
</blockquote>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="430029"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>Allow multipathing/Unsuppress devices from VxVM's view</b></font></font>
</p>
<p>
<a name="431190"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Makes devices visible to VxVM again or makes <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxdmp</b></font> multipath these devices again. This can be performed only on devices that have already been specified using the &quot;Prevent multipathing/Suppress devices from VxVM's view&quot; option. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="430069"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>List currently suppressed/non-multipathed devices</b></font></font>
</p>
<p>
<a name="431213"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Lists all devices suppressed from VxVM's view and all devices prevented from being multipathed by <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxdmp</b></font>. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="430091"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>Change the disk naming scheme</b></font></font>
</p>
<p>
<a name="431280"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Changes the disk naming scheme from the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>c</b></font><em>#</em><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>t</b></font><em>#</em><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>d</b></font><em># </em>format to enclosure-based. Alternatively, if the existing naming scheme is enclosure-based, it is changed to <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>c</b></font><em>#</em><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>t</b></font><em>#</em><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>d</b></font><em># </em>format. </font>
</p>
<hr noshade size="2" width="100%" color="#000000">
<img src="images/note.gif" alt="Note " height="16" width="16">&nbsp;
<font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="425233"></a><b>Note  &nbsp;&nbsp;</b>
</font>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2" color="#000000"> Changing to enclosure-based naming may cause the failure of persistent disk access records for simple or nopriv disks. You can use the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxdarestore</b></font> utility to repair these records. See the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxdarestore</b></font>(1M) manual page for more information. 
</font>
<hr noshade size="2" width="100%" color="#000000">
<p>
<a name="425239"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">This option is equivalent to using the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxddladm set namingscheme=</b></font>{<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>ebn</b></font>|<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>osn</b></font>} command. </font>
</p>
<hr noshade size="2" width="100%" color="#000000">
<img src="images/note.gif" alt="Note " height="16" width="16">&nbsp;
<font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="425242"></a><b>Note  &nbsp;&nbsp;</b>
</font>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2" color="#000000"> Devices with very long device names (for example, Fibre Channel devices that include worldwide name (WWN) identifiers) are always represented by enclosure-based names. This operation has no effect on such devices. 
</font>
<hr noshade size="2" width="100%" color="#000000">
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="430278"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>Change/Display the default disk layouts</b></font></font>
</p>
<p>
<a name="431338"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Allows you to change or display the default disk format and private region length that are used when initializing disks. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="430309"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>Mark a disk as allocator-reserved for a disk group</b></font></font>
</p>
<p>
<a name="431357"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Reserves a disk for use with the Intelligent Storage Provisioning (ISP) feature when allocating storage space. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="430332"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>Turn off the allocator-reserved flag on a disk</b></font></font>
</p>
<p>
<a name="431376"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Allows space on a disk to be allocated by VxVM commands other those provided with the Intelligent Storage Provisioning feature. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="430354"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>List disk information</b></font></font>
</p>
<p>
<a name="431395"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Displays a list of disks.  You can also choose to list detailed information about the disk at a specific disk device address. </font>
</p>
</ul>
</p>
</ul>
</p>
</ul>
</p>

<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="430384"></a> HARDWARE-SPECIFIC NOTE</font>
</h3>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="430389"></a>Some environments provide guidelines to optimize VxVM's interaction with intelligent storage systems. If these guidelines are present, 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. </font>
</p>


<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="430437"></a> FILES</font>
</h3>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="430443"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>/etc/vx/cntrls.exclude</b></font> </font>
</p>
<p>
<a name="431418"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Specifies the address of controllers to exclude from <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxdiskadm</b></font> operations. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="430466"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>/etc/vx/disks.exclude</b></font> </font>
</p>
<p>
<a name="431441"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Specifies the address of disks to exclude from <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxdiskadm</b></font> operations. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="430489"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>/etc/vx/enclr.exclude</b></font></font>
</p>
<p>
<a name="431464"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Specifies the names of enclosures to exclude from <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxdiskadm </b></font>operations. </font>
</p>

<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="430510"></a> NOTES</font>
</h3>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="430515"></a>EFI disks cannot be added to a disk group that is compatible with the Cross-platform Data Sharing (CDS) feature, nor can they be formatted as CDS disks. </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="430536"></a>See the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxddladm</b></font>(1M) manual page for information on using the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxddladm</b></font> command to include or exclude specific array libraries from device discovery. </font>
</p>


<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="430557"></a> SEE ALSO</font>
</h3>
<blockquote>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="430562"></a><a href="vxdarestore_vxvm_manpages28_427703.html#426946"><font color="#0000ff"><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxdarestore </b></font></font></a>(1M), <a href="vxddladm_vxvm_manpages31_429772.html#428311"><font color="#0000ff"><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxddladm </b></font></font></a>(1M), <a href="vxdg_vxvm_manpages33_443062.html#434590"><font color="#0000ff"><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxdg </b></font></font></a>(1M), <a href="vxdisk_vxvm_manpages34_439794.html#433127"><font color="#0000ff"><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxdisk </b></font></font></a>(1M), <a href="vxdiskadd_vxvm_manpages35_427929.html#426960"><font color="#0000ff"><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxdiskadd </b></font></font></a>(1M), <a href="vxdisksetup_vxvm_manpages37_430296.html#428388"><font color="#0000ff"><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxdisksetup </b></font></font></a>(1M), <a href="vxevac_vxvm_manpages42_426831.html#426470"><font color="#0000ff"><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxevac </b></font></font></a>(1M), <a href="vxintro_vxvm_manpages47_452164.html#439378"><font color="#0000ff"><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxintro </b></font></font></a>(1M) </font>
</blockquote>

<!-- End Main Topic Content -->

   </td>
  </tr>
 </table>
</div>

<div>
<table border="0" cellspacing="0" cellpadding="0" width="100%">
 <tr>
  <td height="18" border="0" cellspacing="0" cellpadding="0" colspan="2" bgcolor="#FFFFFF">
  </td>
 </tr>
  <td align="left"><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="-2">&nbsp;&#94;&nbsp;<a href="vxdiskadm_vxvm_manpages36_430557.html" title="vxdiskadm">Return to Top</a></font>

  </td>
  <td align="right"><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="-2">&lt;&nbsp;<a href="vxdiskadd_vxvm_manpages35_427929.html" title="Previous - vxdiskadd">Previous</a>&nbsp;&nbsp;|&nbsp;&nbsp;<a href="vxdisksetup_vxvm_manpages37_430296.html" title="Next - vxdisksetup">Next</a>
&nbsp;&gt;&nbsp;&nbsp;</font>
  </td>
 <tr>
   <td height="9" border="0" cellspacing="0" cellpadding="0" colspan="2" bgcolor="#FFFFFF">
   </td>
 </tr>

<!-- Footer Breadcrumbs -->
<tr>
<td bgcolor="#FFFFFF" colspan="2" height="15" align="right">
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="1">Product:  
<a href="vxvm_manpages_splashpage_docCD_vxvm_manpages1_103036.vxhd" title="Volume Manager Manual Pages for Storage Foundation title page ">Volume Manager Manual Pages for Storage Foundation</a>&nbsp;&nbsp;</font></td>
</tr>

<tr>
<td bgcolor="#FFFFFF" colspan="2" height="15" align="right">
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="1">Manual:  
<a href="man1m_titlepage_docCD_vxvm_manpages2_73700.vxhd" title="Maintenance Commands (1m) title page ">Maintenance Commands (1m)</a>&nbsp;&nbsp;</font></td>
</tr>


 <tr>
  <td colspan="2" align="left"><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" color="#000000" align="right" size="-2">
<em>VERITAS Software Corporation
</em></font><br>

<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="-2">www.veritas.com</font><br>
  </td>
 </tr>
</table>
</div>

</BODY>
  <!--
    *************************************************************************************
    * Copyright (c) 2005 VERITAS Software Corporation. All rights reserved. *

    VERITAS, VERITAS SOFTWARE, the VERITAS Logo, and VERITAS Software Documentation 
    are trademarks or registered trademarks of VERITAS Software Corporation 
    or its affiliates in the U.S. and other countries. Other names may be 
    trademarks of their respective owners. 

    Apache Jakarta Lucene:
    Apache Software License
    Version 1.1

    Copyright (c) 2000 The Apache Software Foundation. All rights reserved.

    Redistribution and use in source and binary forms, with or without modification, 
    are permitted provided that the following conditions are met:

    1. Redistributions of source code must retain the above copyright notice, this 
    list of conditions and the following disclaimer.

    2. Redistributions in binary form must reproduce the above copyright notice, this 
    list of conditions and the following disclaimer in the documentation and/or other 
    materials provided with the distribution.

    3. The end-user documentation included with the redistribution, if any, must include 
    the following acknowledgment: "This product includes software developed by the Apache 
    Software Foundation (http://www.apache.org/)." Alternately, this acknowledgment may 
    appear in the software itself, if and wherever such third-party acknowledgments 
    normally appear.

    4. The names "Apache" and "Apache Software Foundation" must not be used to endorse or 
    promote products derived from this software without prior written permission. For 
    written permission, please contact apache@apache.org.

    5. Products derived from this software may not be called "Apache", nor may "Apache" 
    appear in their name, without prior written permission of the Apache Software Foundation.

    THIS SOFTWARE IS PROVIDED "AS IS" AND ANY EXPRESSED OR IMPLIED WARRANTIES, INCLUDING, 
    BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A 
    PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE APACHE SOFTWARE FOUNDATION 
    OR ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, 
    OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 
    OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND 
    ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING 
    NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF 
    ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

    This software consists of voluntary contributions made by many individuals on behalf 
    of the Apache Software Foundation. For more information on the Apache Software Foundation, 
    please see <http://www.apache.org/>. Portions of this software are based upon public domain 
    software originally written at the National Center for Supercomputing Applications, University 
    of Illinois, Urbana-Champaign.
    
    This product includes WebWindow Software developed by Horst Heistermann.
    *************************************************************************************
  -->
</HTML>
