<!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:55">
<meta name="PRODUCTNAME" content="VERITAS Software Documentation">
<meta name="FILENAME" content="vxdisk.fm">
     
<title>vxdisk</title>

</HEAD>

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

<a name="439794"></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="vxdg_vxvm_manpages33_443062.html" title="Previous - vxdg">Previous</a>&nbsp;&nbsp;|&nbsp;&nbsp;<a href="vxdiskadd_vxvm_manpages35_427929.html" title="Next - vxdiskadd">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="433127"></a>vxdisk</font>
</h2>

        

<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="433150"></a> NAME</font>
</h3>
<p>
<a name="433155"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">vxdisk - define and manage VERITAS Volume Manager disks </font>
</p>

<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="433158"></a> SYNOPSIS</font>
</h3>
<br>
<font face="Courier, Courier New, sansserif, sans serif" size="2"><a name="433163"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxdisk </b></font>[<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-g </b></font><em>diskgroup</em>] <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>addregion </b></font><em>region_type disk offset length </em>
</font>
<br>
<font face="Courier, Courier New, sansserif, sans serif" size="2"><a name="433184"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxdisk </b></font>[<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-g </b></font><em>diskgroup</em>] <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>check </b></font><em>disk</em> ... 
</font>
<br>
<font face="Courier, Courier New, sansserif, sans serif" size="2"><a name="433205"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxdisk </b></font>[<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-g </b></font><em>diskgroup</em>] [<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-o clearkey=</b></font><em>key</em>] <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>clearhost </b></font><em>disk</em> ... 
</font>
<br>
<font face="Courier, Courier New, sansserif, sans serif" size="2"><a name="433235"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxdisk clearimport </b></font><em>accessname</em> ... 
</font>
<br>
<font face="Courier, Courier New, sansserif, sans serif" size="2"><a name="433256"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxdisk </b></font>[<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-f</b></font>] <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>define </b></font><em>accessname </em>[<em>attribute</em> ...] 
</font>
<br>
<font face="Courier, Courier New, sansserif, sans serif" size="2"><a name="433295"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxdisk </b></font>[<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-f</b></font>] <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>define </b></font><em>accessname </em><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>type=simple </b></font>[<em>attribute</em> ...] 
</font>
<br>
<font face="Courier, Courier New, sansserif, sans serif" size="2"><a name="433343"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxdisk </b></font>[<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-f</b></font>] <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>define </b></font><em>accessname </em>[<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>type=auto</b></font>] <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>format=cdsdisk </b></font>[<em>attribute</em> ...] 
</font>
<br>
<font face="Courier, Courier New, sansserif, sans serif" size="2"><a name="433400"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxdisk </b></font>[<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-f</b></font>] <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>define </b></font><em>accessname </em>[<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>type=auto</b></font>] <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>format=hpdisk </b></font>[<em>attribute</em> ...] 
</font>
<br>
<font face="Courier, Courier New, sansserif, sans serif" size="2"><a name="433457"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxdisk </b></font>[<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-f</b></font>] <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>destroy </b></font><em>accessname </em>
</font>
<br>
<font face="Courier, Courier New, sansserif, sans serif" size="2"><a name="433487"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxdisk </b></font>[<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-f</b></font>] <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>flush </b></font><em>accessname </em>
</font>
<br>
<font face="Courier, Courier New, sansserif, sans serif" size="2"><a name="433517"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxdisk getctlr </b></font><em>accessname </em>
</font>
<br>
<font face="Courier, Courier New, sansserif, sans serif" size="2"><a name="433538"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxdisk </b></font>[<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-f</b></font>] <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>init </b></font><em>accessname </em>[<em>attribute</em> ...] 
</font>
<br>
<font face="Courier, Courier New, sansserif, sans serif" size="2"><a name="433577"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxdisk </b></font>[<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-f</b></font>] <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>init </b></font><em>accessname </em><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>type=simple </b></font>[<em>attribute</em> ...] 
</font>
<br>
<font face="Courier, Courier New, sansserif, sans serif" size="2"><a name="433625"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxdisk </b></font>[<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-f</b></font>] <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>init </b></font><em>accessname </em>[<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>type=auto</b></font>] <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>format=cdsdisk </b></font>[<em>attribute</em> ...] 
</font>
<br>
<font face="Courier, Courier New, sansserif, sans serif" size="2"><a name="433682"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxdisk </b></font>[<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-f</b></font>] <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>init </b></font><em>accessname </em>[<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>type=auto</b></font>] <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>format=hpdisk </b></font>[<em>attribute</em> ...] 
</font>
<br>
<font face="Courier, Courier New, sansserif, sans serif" size="2"><a name="433739"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxdisk </b></font>[<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-g </b></font><em>diskgroup</em>] [<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-o alldgs</b></font>] [<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-o listreserve</b></font>] [<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-bqs</b></font>] <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>list </b></font>[<em>disk</em> ...] 
</font>
<br>
<font face="Courier, Courier New, sansserif, sans serif" size="2"><a name="433796"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxdisk offline </b></font><em>accessname</em> ... 
</font>
<br>
<font face="Courier, Courier New, sansserif, sans serif" size="2"><a name="433817"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxdisk -a online </b></font>
</font>
<br>
<font face="Courier, Courier New, sansserif, sans serif" size="2"><a name="433820"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxdisk online </b></font><em>accessname</em> ... 
</font>
<br>
<font face="Courier, Courier New, sansserif, sans serif" size="2"><a name="433841"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxdisk </b></font>[<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-g </b></font><em>diskgroup</em>] <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>path </b></font>
</font>
<br>
<font face="Courier, Courier New, sansserif, sans serif" size="2"><a name="433862"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxdisk </b></font>[<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-f</b></font>] [<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-g </b></font><em>diskgroup</em>] <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>resize </b></font>{<em>accessname</em>|<em>medianame</em>} [<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>length=</b></font><em>value</em>] 
</font>
<br>
<font face="Courier, Courier New, sansserif, sans serif" size="2"><a name="433910"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxdisk rm </b></font><em>accessname</em> ... 
</font>
<br>
<font face="Courier, Courier New, sansserif, sans serif" size="2"><a name="433913"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxdisk </b></font>[<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-g </b></font><em>diskgroup</em>] <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>rmregion </b></font><em>region_type disk offset </em>[<em>length</em>] 
</font>
<br>
<font face="Courier, Courier New, sansserif, sans serif" size="2"><a name="433943"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxdisk </b></font>[<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-g </b></font><em>diskgroup</em>] <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>set </b></font><em>disk  </em>[<em>attribute</em> ...] 
</font>
<br>
<font face="Courier, Courier New, sansserif, sans serif" size="2"><a name="433973"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxdisk scandisks</b></font> [<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>new</b></font> | <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>fabric</b></font> | [<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>!</b></font>]<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>device</b></font>=<em>device_list</em> | <br>	[<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>!</b></font>]<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>ctlr</b></font>=<em>controller_list</em> | <br>	[<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>!</b></font>]<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>pctlr</b></font>=<em>physical_ controller_list</em>] 
</font>

<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="433991"></a> DESCRIPTION</font>
</h3>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="433996"></a>The <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxdisk</b></font> utility performs basic administrative operations on disks. Operations include initializing and replacing disks, as well as taking care of some book-keeping necessary for the disk model presented by VERITAS Volume Manager (VxVM). </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="434026"></a><em>accessname</em> refers to the disk access name, while <em>disk</em> represents the disk media name. <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxdisk</b></font> accesses disks based on disk access names, which are system-specific names that relate to disk addresses. Disk access names are in the form <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>c#t#d#</b></font>, which define a controller number (<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>c#</b></font>), a SCSI target ID (<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>t#</b></font>), and a SCSI logical unit number (<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>d#</b></font>). Disk access 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="434103"></a>VxVM 3.2 introduced enclosure-based naming as an alternative way of referring to disk access names. If enabled, this scheme maps disk access names relative to their enclosure. For example, disks in the enclosure <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>ENC0 </b></font>would be assigned access names <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>ENC0_0</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>ENC0_1</b></font> and so on. </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="434133"></a>Operations that take an <em>accessname</em> argument (see the SYNOPSIS section) accept only disk access names, as defined in the previous paragraph.  Operations that take a <em>disk</em> argument can take disk access names or disk media names (for example, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>disk01</b></font>).  For such operations, a disk group can be specified with <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-g</b></font> to disambiguate disk media names that are used in more than one disk group. </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="434190"></a>Physical disks in VxVM are assumed to be movable, and are usually identified by a unique disk ID stored on the physical disk, rather than by a disk device node. This allows disks to be moved to different SCSI target IDs or to different controllers without affecting correct operation. </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="434240"></a>VxVM maintains information about disk device addresses as disk access records. Disk access records are used to identify physical disks from disk IDs that are stored on the disks themselves. The name of a disk access record is based on the corresponding disk access name. </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="434279"></a>Physical disks contain public regions, which are used for allocating subdisks.  They can also contain private regions, which are used for storing private VERITAS Volume Manager information. Private regions are configured and maintained entirely by VxVM. </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="434309"></a>Private regions contain the following structures: </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="434313"></a><em>Disk Header</em></font>
</p>
<p>
<a name="440606"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Each private region contains exactly two copies of a disk header, which defines the unique disk ID, disk geometry information, and disk group association information.  Two copies are created so that one copy can be lost (due to I/O failures) without causing use of the disk to be lost. The primary copy of the disk header is stored in block zero of the private region.  The alternate copy is stored within the first 256 sectors.  If the primary copy is unreadable or unusable, VxVM searches the first 256 sectors of the private region for the alternate copy. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="434410"></a><em>Table of Contents</em></font>
</p>
<p>
<a name="440625"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A linked list of blocks, pointed to by the disk header, that define additional structures in the private and public regions.  The table of contents blocks define disk group configuration copy locations, log copy locations, and reserved regions carved from the public region. Each link block in the table of contents is replicated at the beginning and end of the private region.  If the primary copy of any one link block is unreadable or unusable, the alternate copy of that link is used. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="434486"></a><em>Configuration Copies</em></font>
</p>
<p>
<a name="440648"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A disk normally contains one disk group configuration copy, according to the number specified when the disk was initialized using the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxdisk init</b></font> operation (explained later).  When a disk is added to a disk group, the disk group's persistent configuration records are written to each copy.  For disks that are not associated with a disk group, the space allocated for configuration copies is unused.  Each disk group requires at least one usable configuration copy.  Preferably there should be at least four copies, allocated between at least two disks.  This allows one disk to be lost totally, while still preserving sufficient redundancy for recovering from simple read failures. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="434589"></a><em>Disk Group Log Copies</em></font>
</p>
<p>
<a name="440671"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A disk normally contains one disk group log copy. The number of log copies is set to the same as the number of configuration copies for the disk (as explained in the <em>Configuration </em>copies section above).  These logs are written by the kernel when certain types of actions are performed: transaction commits, plex detaches resulting from I/O failures, total dirty region log (DRL) failures, the first write to a volume, and volume close.  After a crash or a clean reboot, this log information is used to recover the state of a disk group just prior to the crash or reboot.  Each disk group requires at least one usable disk group log copy.  As with configuration copies, it is preferable to have at least four log copies, allocated between at least two disks. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="434700"></a>For a single disk, the disk header and the table of contents blocks are critical data structures.  At least one copy of the disk header, and at least one copy of each table of contents block, must be readable and usable, or else the disk itself is unusable and must be reinitialized. </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="434739"></a>Within disk groups, disk group configuration and log copies are critical data structures.  At least one complete configuration copy and log copy must be readable and usable, or the disk group is unusable and must be reinitialized. </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="434769"></a>All disk group association information is stored in the disk header within private regions.  This information consists of a disk group name, disk group unique ID, and a host ID.  When the system boots, VxVM scans for disks that are stamped with the system's host ID.  Each represented disk group is imported automatically.  Disks with a non-matching host ID are not imported automatically, and cannot be used until the host ID is cleared with the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>clearimport </b></font>operation. </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="434835"></a>The behavior of the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxdisk</b></font> utility depends upon the keyword specified as the first operand. </font>
</p>


<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="434847"></a> KEYWORDS</font>
</h3>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="434853"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>addregion</b></font></font>
</p>
<p>
<a name="440706"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Adds a new entry to the table of contents in a disk's private region. The new entry defines a region of disk that is relative to the public region, and that is reserved for a particular use.  The <em>offset</em> and <em>length</em> operations indicate the location and extent of the region.  Currently, the only region type that can be defined is: </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="434911"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>reserve</b></font></font>
</p>
<p>
<a name="440725"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Masks out a region of disk that should be reserved for purposes other than use by VxVM. This could be used, for example, to mask out a boot file system that cannot be used for subdisk allocation, or to mask out a region containing blocks that are used for bad-block or bad-track replacement. </font>
</p>
<blockquote>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="425267"></a>Adding a region fails if a subdisk or region is already allocated over the requested region. </font>
</blockquote>
<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="425270"></a><b>Note  &nbsp;&nbsp;</b>
</font>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2" color="#000000"> The <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>addregion</b></font> functionality is currently unimplemented for any of the existing disk types. 
</font>
<hr noshade size="2" width="100%" color="#000000">
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="435019"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>check</b></font></font>
</p>
<p>
<a name="440753"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Determines the usability of the specified disks. A disk is considered usable if VxVM can write and read back at least one of the disk headers that are stored on the disk. If a disk in a disk group is unusable, VxVM detaches it from its disk group, and all subdisks stored on the disk become invalid. The subdisks remain invalid until the unusable disk is replaced or the disk media record is reassigned to a different physical disk. </font>
</p>
<p>
<a name="425284"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">For shared disks, VxVM detaches an unusable disk only if the disk group's detach policy is set to <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>global</b></font>. If the disk group detach policy is <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>local</b></font>, the disk is not detached. However, if hosts in the cluster do not indicate that a disk is usable, the disk is detached from the entire cluster. See <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxedit</b></font>(1M) for more information on setting disk group detach policies. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="435186"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>clearhost</b></font> </font>
</p>
<p>
<a name="440791"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Clears the stale disk reservation key, as specified by the argument to the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-o clearkey</b></font> option, from a disk. </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="425298"></a><b>Note  &nbsp;&nbsp;</b>
</font>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2" color="#000000"> This key is slightly different from the I/O fencing key that is specified using the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-o groupreserve</b></font> option to the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxdg import </b></font>and <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>init</b></font> commands. The disk reservation key that is specified to <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>clearhost </b></font>also contains the node ID of the host encoded in the first byte. 
</font>
<hr noshade size="2" width="100%" color="#000000">
<p>
<a name="425304"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">See the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxdg</b></font>(1M) manual page for more information about I/O fencing. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="435285"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>clearimport</b></font> </font>
</p>
<p>
<a name="440841"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Clears the host-specific import information stored on the indicated disks, and in the configurations stored on those disks.  This command may be necessary in cases where import information stored for a disk group becomes unusable, due to host failures, or due to a disk group being moved from one machine to another. </font>
</p>
<p>
<a name="425314"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">This operation cannot be applied to disks that are in imported disk groups. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="435368"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>define</b></font></font>
</p>
<p>
<a name="440875"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Defines a disk access record, but do not initialize it.  In order for VxVM to scan a disk, a disk access record must be defined for it. Thus, if you want to see what is on a new disk or you want to move a disk with a valid disk group from one system to another, you must first make it accessible by using <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxdisk define</b></font>. You can use <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxdisk list</b></font> to see what is on the disk, or <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxdg\ import</b></font> to import a disk group that is on the disk. </font>
</p>
<p>
<a name="425326"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Attributes can be specified to define the access characteristics of the disk device. The following attributes define the disk type: </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="435469"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>type=</b></font><em>disk_type</em></font>
</p>
<p>
<a name="440909"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Specifies the access type for the disk device. See the description of the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>init</b></font> operation and the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>DISK TYPES</b></font> section for more details. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="435500"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>format=</b></font><em>format</em></font>
</p>
<p>
<a name="440940"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">For auto-configured disks (<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>type=auto</b></font>), specifies one of the supported formats that is to be used with the disk. See the section <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>Auto-Configured Disks</b></font> for details. </font>
</p>
<p>
<a name="425343"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The various disk types support additional attributes for the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>define</b></font> operation. See the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>DISK TYPES</b></font> and <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>ATTRIBUTES</b></font> sections for details. </font>
</p>
<p>
<a name="425347"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Normally, a <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>define</b></font> operation fails if the specified disk device is invalid, such as because no such disk currently exists.  The <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-f</b></font> option can be used to force definition of an unusable disk. This can be useful if, for example, the disk device could be used after a reboot.  For example, if you intend to add a new controller and intend to move some existing disks to the new controller, you may need to define the new disk device addresses, even though they are not usable until you shutdown and reconfigure your disks. </font>
</p>
<p>
<a name="425356"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">If specified, the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-B</b></font> option initializes the VERITAS Volume Manager private region to begin at block number 2144. This block is designated as the private region offset for a VERITAS Volume Manager root disk. Without this option, the private region is initialized to start at the default block number 128. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="435732"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>destroy</b></font></font>
</p>
<p>
<a name="440991"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Uninitializes a disk from VxVM by removing the private region and CDS disk labels, which were placed on the disk by an <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>init</b></font> operation. The <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-f</b></font> option forcibly uninitializes a disk. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="435772"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>flush</b></font></font>
</p>
<p>
<a name="441014"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Rewrite all Cross-Platform Data Sharing (CDS) ID information to the specified disk that has at least one valid VxVM ID block. Unlike the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxdg flush</b></font> command, the disk is brought online if required. </font>
</p>
<p>
<a name="425376"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-f</b></font> option may be specified to forcibly rewrite the AIX coexistence label and VxVM ID block. By default, these are not overwritten. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="435828"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>getctlr</b></font></font>
</p>
<p>
<a name="441040"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Returns the name of the controller associated with a given disk access name. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="435850"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>init</b></font></font>
</p>
<p>
<a name="441067"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Initializes regions of a disk used by VxVM. This involves installing a disk header and writing an empty configuration on the disk.  The <em>accessname</em> operand identifies the disk. Normally, this command fails if the disk already contains an apparently valid disk header.  The <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-f</b></font> option can be used to override this and to force initialization of the disk.  A disk that is a member of an imported disk group cannot be initialized. </font>
</p>
<p>
<a name="425392"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxdisk\ init</b></font> operation creates a disk access record for a disk (if one does not already exist), and sets its state to <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>online</b></font>.  Disks can be initialized when <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxconfigd</b></font> is in its disabled state, in which case the disk header is initialized, but the disk is not added to the list of known disks until <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxconfigd</b></font> is re-enabled. </font>
</p>
<p>
<a name="425399"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Any <em>attribute</em> operands override default values assigned for various disk attributes.  Some attributes that can be set are: </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="436003"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>type=</b></font><em>disk_type</em></font>
</p>
<p>
<a name="441116"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Specifies the access type for the disk device. This type identifies the class of strategies that can be used to access the disk, and to manage its private and public regions. </font>
</p>
<p>
<a name="425408"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">For example, a disk type can indicate a networked disk or a volatile RAM disk that does not require the storage of any private data. </font>
</p>
<p>
<a name="425412"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">See the description of the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>init</b></font> operation and the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>DISK TYPES</b></font> section for more details. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="436094"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>format=</b></font><em>format</em></font>
</p>
<p>
<a name="441161"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">For auto-configured disks (<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>type=auto</b></font>), specifies one of the supported formats that is to be used with the disk. See the section <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>Auto-Configured Disks</b></font> for details. </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="425421"></a><b>Note  &nbsp;&nbsp;</b>
</font>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2" color="#000000"> If a format is not specified, and the target disk already has a valid <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>auto</b></font> format, this is assumed to be the desired format. 
</font>
<hr noshade size="2" width="100%" color="#000000">
<blockquote>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="425426"></a>The various disk types support additional attributes for the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>init</b></font> operation. See the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>DISK TYPES</b></font> and <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>ATTRIBUTES</b></font> sections for details. </font>
</blockquote>
<blockquote>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="425430"></a>If specified, the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-B</b></font> option initializes the VERITAS Volume Manager private region to begin at block number 2144. This block is designated as the private region offset for a VERITAS Volume Manager root disk. Without this option, the private region is initialized to start at the default block number 128. </font>
</blockquote>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="436281"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>list</b></font></font>
</p>
<p>
<a name="441216"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Lists path type and states along with the detailed information on the specified disks. The state is listed as <em>enabled</em> or <em>disabled</em>. </font>
</p>
<p>
<a name="425444"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">If one or more <em>disk</em> arguments are specified, a full description of the contents of the disk header and of the table of contents for each named disk is displayed. </font>
</p>
<p>
<a name="425448"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">If no <em>disk</em> arguments are specified, a one-line summary for all disk access records known to the system is displayed. </font>
</p>
<p>
<a name="425451"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">If no <em>disk</em> arguments are specified, but a disk group is specified with <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-g</b></font>, information is displayed about only those disks that have been added to the specified disk group. </font>
</p>
<p>
<a name="425456"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-b</b></font> option can be used to display length and offset values in 512-byte units, regardless of platform. If this option is not specified, values are displayed in units of sectors, the size of which can vary between different platforms. </font>
</p>
<p>
<a name="425463"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">If the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-s</b></font> option is specified, important information from the disk header is displayed. With the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-s</b></font> option, the output format is the same whether or not <em>accessname</em> arguments are specified. The information printed with <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-s</b></font> includes the disk ID, the host ID (if the disk is or was imported), and the disk group ID and disk group name (if the disk is a member of a disk group). </font>
</p>
<p>
<a name="425471"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">If the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-q</b></font> option is specified, no header is printed that describes output fields. This option has no effect with the long formats that are generated for the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-s</b></font> option or for <em>accessname</em> arguments. </font>
</p>
<p>
<a name="425476"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">When <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-o alldgs</b></font> is specified without the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-s</b></font> and <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-g</b></font> options, a one line summary shows all associations between disks and disk groups. The disk <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>group</b></font> column shows imported disk groups as normal and shows all other disk groups in parentheses. </font>
</p>
<p>
<a name="425481"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Auto-configured disks are shown with their type (<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>auto</b></font>) qualified by their format. For example, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>auto:cdsdisk</b></font> indicates an auto-configured disk that is formatted as a CDS disk. See the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>Auto-Configured Disks</b></font> section for more details. </font>
</p>
<p>
<a name="425487"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">You can use the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-o listreserve</b></font> option to discover if I/O fencing has been enabled for a disk group. If I/O fencing is enabled, the command also displays the current reservations and registered keys for the disks in the disk group. See the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxdg</b></font>(1M) manual page for more information about I/O fencing. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="436735"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>offline</b></font></font>
</p>
<p>
<a name="441354"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Declares the disk devices named by the <em>accessname</em> arguments to be in the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>offline</b></font> state.  This disables checking of the disk in searching for particular disk IDs, or for the set of disks in a particular disk group.  This operation cannot be applied to disks that are members of an imported disk group. </font>
</p>
<p>
<a name="425500"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Take a disk offline if the disk is not currently accessible, and if accessing the disk has a negative impact on the system. For example, disk drivers on a some operating systems can cause system panics or hangs if an attempt is made to access disks that are not accessible.  In other operating systems, attempts to access inaccessible drives may take several seconds or minutes before returning a failure. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="436854"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>online</b></font></font>
</p>
<p>
<a name="441388"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Clears the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>offline</b></font> state for a disk device.  This re-enables checking of the disk when searching for disk IDs, or for members of a disk group.  This can be used for disks that are already in the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>online</b></font> state, provided that they are not in imported disk groups.  All internal information for an already <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>online </b></font>state disk is regenerated from the disk's private region. </font>
</p>
<p>
<a name="425516"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">If <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-a</b></font> is specified, re-online all online disks that are not currently in an imported disk group. This can be used to force VxVM to re-scan all disk headers. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="436956"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>path</b></font></font>
</p>
<p>
<a name="441418"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Lists the disk access name, disk media name, disk group and state that are associated with each subpath on the system. If a disk group is specified using the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-g</b></font> option, only subpaths that are associated with that disk group are listed. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="437006"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>resize</b></font></font>
</p>
<p>
<a name="441445"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Resizes a virtual disk device with a SCSI interface presented by a smart switch, smart array or RAID controller. Following a <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>resize</b></font> operation to increase the length that is defined for a device, additional disk space on the device is available for allocation. You can optionally specify the new size by using the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>length</b></font> attribute. </font>
</p>
<p>
<a name="425536"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">If a disk media name rather than a disk access name is specified, the disk group must also be specified using the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-g</b></font> option. </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="425539"></a><b>Note  &nbsp;&nbsp;</b>
</font>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2" color="#000000"> This facility is provided to support <em>dynamic LUN expansion</em> by updating disk headers and other VxVM structures to match a new LUN size. It does not resize the LUN itself. 
</font>
<hr noshade size="2" width="100%" color="#000000">
<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="425543"></a><b>Note  &nbsp;&nbsp;</b>
</font>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2" color="#000000"> Any volumes on the device should only be grown after the device itself has first been grown. Otherwise, storage other than the device may be used to grow the volumes, or the volume resize may fail if no free storage is available. 
</font>
<hr noshade size="2" width="100%" color="#000000">
<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="425548"></a><b>Note  &nbsp;&nbsp;</b>
</font>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2" color="#000000"> Resizing should only be performed on devices that preserve data. Consult the array documentation to verify that data preservation is supported and has been qualified. The operation also requires that only storage at the end of the LUN is affected. Data at the beginning of the LUN must not be altered. No attempt is made to verify the validity of pre-existing data on the LUN. 
</font>
<hr noshade size="2" width="100%" color="#000000">
<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="425555"></a><b>Note  &nbsp;&nbsp;</b>
</font>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2" color="#000000"> Although it is possible to resize LUNs that are online but not part of any disk group, this operation is primarily intended for use with devices that are in an imported disk group. The operation should be performed on the host where the disk group is imported (or on the master node for a cluster-shared disk group). It is not possible to resize LUNs that are in the boot disk group (aliased as <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>bootdg</b></font>), in a deported disk group, or that are offline, uninitialized, being reinitialized, or in an error state. 
</font>
<hr noshade size="2" width="100%" color="#000000">
<p>
<a name="425565"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Caution: Do not perform this operation when replacing a physical disk with a disk of a different size as data is not preserved. </font>
</p>
<p>
<a name="425568"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Caution: Before reducing the size of a device, any volumes on the device should first be reduced in size or moved off the device. By default, the resize fails if any subdisks would be disabled as a result of their being removed in whole or in part during a shrink operation. </font>
</p>
<p>
<a name="425573"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">If the device that is being resized has the only valid configuration copy for a disk group, the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-f</b></font> option may be specified to forcibly resize the device. </font>
</p>
<p>
<a name="425577"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Caution: Resizing a device that contains the only valid configuration copy for a disk group can result in data loss if a system crash occurs during the resize. </font>
</p>
<p>
<a name="425581"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Caution: Resizing a virtual disk device is a non-transactional operation outside the control of VxVM. This means that the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>resize </b></font>command may have to be re-issued following a system crash. In addition, a system crash may leave the private region on the device in an unusable state. If this occurs, the disk must be reinitialized, reattached to the disk group, and its data resynchronized or recovered from a backup. </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="425589"></a><b>Note  &nbsp;&nbsp;</b>
</font>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2" color="#000000"> A Storage Foundation license is required to use the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxdisk resize </b></font>command. 
</font>
<hr noshade size="2" width="100%" color="#000000">
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="437546"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>rm</b></font></font>
</p>
<p>
<a name="441546"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Removes the specified disk access records, by disk access name. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="437559"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>rmregion</b></font></font>
</p>
<p>
<a name="441577"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Frees a region of space that is allocated in the private or public region for a particular use.  Space that is freed from the public region becomes usable for subdisk creation.  The arguments to <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>rmregion</b></font> must match the arguments used when adding the region with <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxdisk addregion</b></font> except for the optional <em>length</em> argument which can be excluded for the remove. </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="425603"></a><b>Note  &nbsp;&nbsp;</b>
</font>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2" color="#000000"> The <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>rmregion</b></font> functionality is currently unimplemented for any of the existing disk types. 
</font>
<hr noshade size="2" width="100%" color="#000000">
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="437643"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>scandisks</b></font></font>
</p>
<p>
<a name="441608"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Initiates rescanning of devices in the OS device tree by VxVM. If necessary, DMP reconfiguration is triggered. This allows VxVM to configure and multipath disks dynamically. </font>
</p>
<p>
<a name="425611"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The following <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>scandisks</b></font> operations are also supported: </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="437690"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>scandisks new</b></font></font>
</p>
<p>
<a name="441634"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Discovers new disks (that is, disks not known to VxVM). </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="437703"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>scandisks fabric</b></font></font>
</p>
<p>
<a name="441653"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Discovers fabric devices. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="437716"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>scandisks</b></font> [<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>!</b></font>]<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>device</b></font>=<em>device_list</em></font>
</p>
<p>
<a name="441692"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Discovers and configures the devices that are specified as a comma-separated list. If a <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>!</b></font> is prepended to <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>device</b></font>, all devices except those listed are discovered. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="437756"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>scandisks</b></font> [<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>!</b></font>]<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>ctlr</b></font>=<em>controller_list</em></font>
</p>
<p>
<a name="441731"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Discovers devices that are connected to the logical controllers specified as a comma-separated list. If a <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>!</b></font> is prepended to <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>device</b></font>, all devices are discovered except those that are connected to the specified controllers. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="437805"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>scandisks [!</b></font>]<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>pctlr</b></font>=<em>physical_controller_list</em></font>
</p>
<p>
<a name="441772"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Discovers devices that are connected to the physical controllers specified as a list of items separated by <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>+</b></font> characters. If a <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>!</b></font> is prepended to <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>device</b></font>, all devices are discovered except those that are connected to the specified physical controllers. </font>
</p>
<p>
<a name="425640"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A list of physical controllers can be obtained by running the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxdmpadm listctlr all</b></font> command. </font>
</p>
<p>
<a name="425644"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Only one <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>scandisk</b></font> operation may be specified at a time. For example, a command such as <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxdisk scandisks new fabric </b></font>results in an error. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="437919"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>set</b></font> </font>
</p>
<p>
<a name="441814"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Changes some set of attributes for a disk.  The attributes are either simple names (used to turn on an on/off attribute), or can be of the form <em>attrname</em>=<em>value</em>, to indicate a value for a particular attribute. </font>
</p>

<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="437958"></a> HARDWARE-SPECIFIC NOTE</font>
</h3>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="437963"></a>Some environments provide guidelines to optimize VxVM's interaction with intelligent storage systems. If these guidelines are present, VxVM follows them when initializing disks, creating volumes or allocating space for volumes. These rules cannot be overridden. </font>
</p>


<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="437993"></a> DISK TYPES</font>
</h3>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="437998"></a>Three disk types are supported for use with VxVM: <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>simple</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>nopriv</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>auto</b></font> with format set to <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>hpdisk</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>cdsdisk</b></font> or <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>none</b></font>. </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="438028"></a>The default type is <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>auto</b></font> with format set to <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>cdsdisk </b></font>for disks other than EFI disks. If required, this default can be overridden in the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>/etc/default/vxdisk</b></font> file. If an EFI disk is initialized, the default format is <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>hpdisk</b></font>. </font>
</p>


<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="438067"></a> NOPRIV DISKS</font>
</h3>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="438072"></a>The simplest disk type is <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>nopriv</b></font>, which defines a disk that has no private region, and that consists only of space for allocating subdisks.  Configuration and log copies cannot be stored on such disks, and such disks do not support reserved regions defined with <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxdisk\ addregion</b></font>.  Because <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>nopriv</b></font> disks are not self identifying, VxVM cannot track the movement of such disks on a SCSI chain or between controllers. </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="438129"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>nopriv</b></font> devices are most useful for defining special devices (such as volatile RAM disks) that you wish to use with VxVM, but that cannot store private regions.  A RAM disk cannot store a meaningful private region, because data written to a RAM disk may not survive a reboot. </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="438168"></a>Initializing a <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>nopriv</b></font> device with <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxdisk\ init</b></font> creates a disk access record internally to VxVM's configuration, but no information is written to disk. The disk ID for <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>nopriv</b></font> devices is stored in the private structure of the disk access record. </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="438207"></a>Attributes that can be used with the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>define</b></font> operation for <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>nopriv</b></font> disks are <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>diskid</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>publen</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>puboffset</b></font> and <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>volatile</b></font>. </font>
</p>

<blockquote>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="425698"></a>Attributes that can be used with the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>init </b></font>operation for <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>nopriv</b></font> disks are <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>publen</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>puboffset</b></font> and <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>volatile</b></font>. </font>
</blockquote>

<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="438262"></a> SIMPLE DISKS</font>
</h3>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="438267"></a>The <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>simple</b></font> type presumes that the public and private regions are stored on the same disk, with the public region following the private region. </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="438288"></a>Attributes that can be defined with <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxdisk define</b></font> for simple disks are listed in the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>ATTRIBUTES</b></font> section. </font>
</p>


<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="438300"></a> AUTO-CONFIGURED DISKS</font>
</h3>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="438305"></a>On some systems, VxVM can ask the operating system for a list of known disk device addresses. On such systems, some device addresses are auto-configured when <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxconfigd</b></font> is started. </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="438335"></a>From release 4.0 of VxVM, auto-configured disks are of type <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>auto</b></font> that can take one of the following formats: </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="438357"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>cdsdisk</b></font></font>
</p>
<p>
<a name="441965"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The disk is formatted as a CDS disk that is suitable for moving between different operating systems. This is the default format for most disks, but it is not suitable for boot disks or EFI disks. </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="425728"></a><b>Note  &nbsp;&nbsp;</b>
</font>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2" color="#000000"> As the CDS format is applied to the entire disk and is unsuitable for boot disks, attributes that relate to slices or to booting are not applicable. 
</font>
<hr noshade size="2" width="100%" color="#000000">
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="438413"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>hpdisk</b></font></font>
</p>
<p>
<a name="441996"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The disk is formatted for use with VxVM on HP-UX. This format can be applied to disks that can be used to boot the system. If the disk is not initialized as a boot disk, space is reserved on the disk to allow it to be converted to <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>cdsdisk</b></font> format if required. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="438462"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>none</b></font></font>
</p>
<p>
<a name="442015"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The disk is an unformatted auto-configured disk. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="438474"></a>Auto-configured devices can be removed, if necessary, by using the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxdisk\ rm</b></font> command. When removed, explicitly defined devices can be defined to override any auto-configured devices.  When the system reboots, no auto-configured disk devices are added to the VxVM configuration if that meant that they would share a disk with an explicitly configured disk device. </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="438532"></a>Auto-configured devices can be disabled and re-enabled using the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>offline</b></font> and <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>online</b></font> operations.  However, the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>offline </b></font>state is not stored persistently.  If you need to persistently offline a device at a particular address, convert the address to use an explicit device record.  To do this, remove the auto-configured device, and use <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxdisk define</b></font> to create an explicitly configured device. </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="438589"></a>Attributes that may be defined for auto-configured disks are listed in the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>ATTRIBUTES</b></font> section. </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="438601"></a>The default format for auto-configured disks may be overridden by a suitable entry in the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>/etc/default/vxdisk</b></font> file. See the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>DEFAULTS FILE</b></font> section for details. A value specified on the command line takes precedence over both the value in the defaults file and the inbuilt value. </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="425766"></a><b>Note  &nbsp;&nbsp;</b>
</font>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2" color="#000000"> If a format is not specified, and the target disk already has a valid <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>auto</b></font> format, this is assumed to be the desired format. \&quot; 
</font>
<hr noshade size="2" width="100%" color="#000000">

<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="438683"></a> ATTRIBUTES</font>
</h3>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="438689"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>configlen=</b></font><em>length</em></font>
</p>
<p>
<a name="442079"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The size to reserve for each copy of the configuration stored on the disk. The default size is based on the size of the private area and the number of configuration copies requested, and leaves some space free for uses other than the configuration copies. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="438729"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>diskid=</b></font><em>newdiskid</em></font>
</p>
<p>
<a name="442110"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">For a <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>nopriv</b></font> disk, this defines the value <em>newdiskid</em> for the disk ID in the disk access record. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="438760"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>loglen=</b></font><em>length</em></font>
</p>
<p>
<a name="442133"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The size to reserve in the private region for each log region.  This size limits the number of kernel-initiated detach operations that can be logged against the disk group.  The default is about 15% of the size of the configuration copies.  It is advised that the log sizes be kept as 15% of the configuration copy size. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="438809"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>nconfig=</b></font><em>count</em></font>
</p>
<p>
<a name="442156"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The number of configuration copies to store on the disk. This defaults to 1. Setting this value to 0 indicates that no configurations are to be stored on the disk. </font>
</p>
<p>
<a name="425799"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">VxVM automatically enables and disables the configuration copy. It maintains a level of redundancy in configuration copies that allows the configuration to be recovered from the loss of multiple disks. </font>
</p>
<p>
<a name="425803"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">See the description of the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>nconfig</b></font> parameter on the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxdg</b></font>(1M) manual page for more information. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="438909"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>nlogs=</b></font><em>count</em></font>
</p>
<p>
<a name="442193"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The number of log regions to allocate on the disk. Log regions are used for storing any plex detaches that happen within the disk group. This number defaults to 1. </font>
</p>
<p>
<a name="425813"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">VxVM automatically enables and disables the configuration copy. It maintains a level of redundancy in configuration copies that allows the configuration to be recovered from the loss of multiple disks. </font>
</p>
<p>
<a name="425817"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">See the description of the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>nlog</b></font> parameter on the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxdg</b></font>(1M) manual page for more information. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="439010"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>offline</b></font></font>
</p>
<p>
<a name="442242"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">If specified, creates disk in the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>offline</b></font> state for the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>define </b></font>operation, or leaves the device in the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>offline</b></font> state initially for the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>init</b></font> operation. This attribute is used only if a new disk access record is being defined. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="439050"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>privlen=</b></font><em>length</em></font>
</p>
<p>
<a name="442273"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The length of the private region. If this is not specified, then a default is chosen. For the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>simple</b></font> and <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>cdsdisk</b></font> types, the default size is 2048 blocks. The maximum possible size of the private region is 524288 blocks. </font>
</p>
<p>
<a name="425835"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The default value of <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>privlen</b></font> may also be overridden by a suitable entry in the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>/etc/default/vxdisk</b></font> file. See the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>DEFAULTS FILE</b></font> section for details. A value specified on the command line takes precedence over both the value in the defaults file and the inbuilt value. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="439142"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>publen=</b></font><em>length</em> or <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>len=</b></font><em>length</em></font>
</p>
<p>
<a name="442323"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">For disk types other than <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>nopriv</b></font>, the length of the public region. If not specified, the length of the public region is computed from available system-specific disk size information. If no such information is available, a public region length must be specified in this command. The default public region length is adjusted to account for the private region, or for any specified public or private region offsets. </font>
</p>
<p>
<a name="425856"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">For <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>nopriv</b></font> disks, the usable length of the device. This is required if there is no system-defined procedure for determining the disk length; otherwise, a suitable default is computed. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="439282"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>puboffset=</b></font><em>offset</em> or <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>offset=</b></font><em>offset</em></font>
</p>
<p>
<a name="442365"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">For <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>nopriv</b></font> disks, the offset within the device for the start of the usable region. The default value of this offset defaults to 1. This can be changed if it is necessary to skip over some region that is reserved for use by the operating system. If an offset is specified, the default disk length is adjusted accordingly. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="439349"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>volatile</b></font></font>
</p>
<p>
<a name="442396"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">For a <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>nopriv</b></font> disk, this marks the contents of the disk as being volatile (that is, the disk contents are not expected to remain consistent across a system reboot). Subdisks and plexes defined on disks with the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>volatile</b></font> attribute inherit that attribute. The <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxvol\ start</b></font> operation interprets volatile plexes as requiring complete revival from other plexes in the same volume. </font>
</p>

<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="439415"></a> DEFAULTS FILE</font>
</h3>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="439420"></a>The <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>/etc/default/vxdisk</b></font> file can be used to set the default values of the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>format</b></font> and <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>privlen</b></font> attributes for the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxdisk</b></font> and <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxdisksetup</b></font> commands. Values in this file override inbuilt values, and may themselves be overridden by values specified on the command line. </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="439469"></a>The following attributes may be specified in the defaults file: </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="439482"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>format=</b></font><em>format</em></font>
</p>
<p>
<a name="442463"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Defines the default format for <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>auto</b></font> type disks. Supported values of <em>format</em> are <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>hpdisk</b></font> and <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>cdsdisk</b></font>. The setting of this attribute is considered for the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>define </b></font>and <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>init</b></font> operations. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="439540"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>privlen=</b></font><em>length</em></font>
</p>
<p>
<a name="442494"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Defines the default length for the private region. See the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>ATTRIBUTES</b></font> section for a full definition. The setting of this attribute is considered for the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>init</b></font> operation only. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="439579"></a>The attributes and their values may be defined in any order in the file, the attribute keyword must start in the first column, and no white-space characters are allowed around the = character. If an attribute is defined multiple times, only the final occurrence in the file is used. Commands silently ignore any definition line that has an invalid format. </font>
</p>


<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="439627"></a> EXAMPLES</font>
</h3>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="439632"></a>This example sets the powerfail timeout on disk01. </font>
</p>

<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="439650"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">vxdisk&nbsp;set&nbsp;disk01&nbsp;pfto=seconds</font>
</font>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="439660"></a>The <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>set</b></font> functionality is currently unimplemented for any of the existing disk types. </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="439674"></a>Use the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>getctlr</b></font> keyword to return the controller associated with a disk that is specified by its enclosure-based disk access name. </font>
</p>

<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="439710"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">vxdisk&nbsp;getctlr&nbsp;JBOD0_5</font>
</font>

<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="439720"></a> FILES</font>
</h3>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="439726"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>/etc/default/vxdisk</b></font></font>
</p>
<p>
<a name="442541"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Defaults file used by the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxdisk</b></font> and <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxdisksetup</b></font> utilities. </font>
</p>

<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="439738"></a> NOTES</font>
</h3>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="439743"></a>Auto-configured disks of type <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>auto</b></font> with the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>cdsdisk</b></font> format cannot be used as boot, root, or swap disks. Such disks can also only be created and used in a disk group that has a version number greater than or equal to 110. </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="439773"></a>To ensure that the VTOC and disk format are in agreement, it is recommended that you use the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxdisksetup -i</b></font> command to initialize disks in preference to the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxdisk init</b></font> command. </font>
</p>


<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="439794"></a> SEE ALSO</font>
</h3>
<blockquote>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="439799"></a><a href="pfto_vxvm_manpages93_427048.html#426526"><font color="#0000ff"><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>pfto </b></font></font></a>(7), <a href="vxcdsconvert_vxvm_manpages19_429531.html#427996"><font color="#0000ff"><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxcdsconvert </b></font></font></a>(1M), <a href="vxconfigd_vxvm_manpages25_433964.html#430068"><font color="#0000ff"><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxconfigd </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="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="vxedit_vxvm_manpages41_434625.html#430530"><font color="#0000ff"><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxedit </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), <a href="vxvol_vxvm_manpages85_441003.html#433596"><font color="#0000ff"><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxvol </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="vxdisk_vxvm_manpages34_439794.html" title="vxdisk">Return to Top</a></font>

  </td>
  <td align="right"><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="-2">&lt;&nbsp;<a href="vxdg_vxvm_manpages33_443062.html" title="Previous - vxdg">Previous</a>&nbsp;&nbsp;|&nbsp;&nbsp;<a href="vxdiskadd_vxvm_manpages35_427929.html" title="Next - vxdiskadd">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>
