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

</HEAD>

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

<a name="452164"></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="vxinstall_vxvm_manpages46_427052.html" title="Previous - vxinstall">Previous</a>&nbsp;&nbsp;|&nbsp;&nbsp;<a href="vxiod_vxvm_manpages48_427282.html" title="Next - vxiod">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="439378"></a>vxintro</font>
</h2>

        

<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="439401"></a> NAME</font>
</h3>
<p>
<a name="439406"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">vxintro - introduction to the VERITAS Volume Manager utilities </font>
</p>

<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="439409"></a> DESCRIPTION</font>
</h3>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="439414"></a>The VERITAS Volume Manager (VxVM) utilities provide a shell-level interface for use by system administrators and high-level applications and scripts to query and manipulate objects managed through VxVM. </font>
</p>


<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="439444"></a> GLOSSARY</font>
</h3>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="439450"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>boot disk group</b></font></font>
</p>
<p>
<a name="453200"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">If the root disk is under VxVM control, this disk group contains the root disk and the volumes on it that are used to boot the system. By default, the name of the boot disk group is aliased to the reserved disk group name, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>bootdg</b></font>, when the root disk is put under VxVM control. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="439499"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>concatenated plex</b></font></font>
</p>
<p>
<a name="453219"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A plex whose subdisks are associated at specific offsets within the address range of the plex, and extend into the plex address range for the length of the subdisk.  This layout allows regions of one or more disks to create a plex, rather than a single big region. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="439548"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>data change map</b></font></font>
</p>
<p>
<a name="453238"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The data change map (DCM) is a bit-map which represents regions in the volume.  When a write to a region occurs, the corresponding bit in the DCM is turned on.  It is used by VVR for both log overflow protection and automatic secondary synchronization. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="439588"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>data volume</b></font></font>
</p>
<p>
<a name="453257"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A volume being used as a child of an RVG. For a primary RVG, a data volume contains the primary copy of that volume data. For a secondary RVG, a data volume contains a copy of the corresponding remote primary data volume data. Secondary data volumes are only writable with updates from the primary. The secondary RVG must contain a data volume corresponding to each primary data volume. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="439655"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>default disk group</b></font></font>
</p>
<p>
<a name="453284"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Each system may have one special disk group, aliased to the reserved name, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>defaultdg</b></font>, which is the default disk group for most utilities. See 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="439696"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>disk</b></font></font>
</p>
<p>
<a name="453303"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Disks exist as two entities.  One is the physical disk on which all data is ultimately stored and which exhibits all the behaviors of the underlying technology. The other is the VERITAS Volume Manager presentation of disks which, while mapping one-to-one with the physical disks, are just presentations of units from which allocations of storage are made.  As an example, a physical disk presents the image of a device with a definable geometry with a definable number of cylinders, heads, and so forth, whereas a VERITAS Volume Manager disk (VM disk) is simply a unit of allocation with a name and a size. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="439799"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>disk access record</b></font></font>
</p>
<p>
<a name="453322"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A configuration record that defines a pathway to a disk. The disk access records most commonly name a particular controller number, target ID, and logical unit number. The list of all disk access records stored in a system is used to find all disks attached to the system.  Disk access records do not identify particular physical disks. </font>
</p>
<p>
<a name="425054"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Disk access records are identified by their <em>disk access names </em>(also known as DA names). </font>
</p>
<p>
<a name="425057"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Through the use of disk IDs, VxVM allows disks to be moved between controllers, or to different locations on a controller. When a disk is moved, a different disk access record is used when accessing the disk, although the disk media record continues to track the actual physical disk. </font>
</p>
<p>
<a name="425063"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">On some systems, VxVM builds a list of disk access records automatically, based on the list of all devices attached to the system.  On these systems, it is not necessary to define disk access records explicitly.  On other systems, disk access records must be defined explicitly with the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxdisk define</b></font> operation. Specialty disks (such as RAM disks or floppy disks) are likely to require explicit <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxdisk define</b></font> operations on all systems. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="440017"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>disk group</b></font></font>
</p>
<p>
<a name="453362"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A group of disks that share a common configuration.  A configuration consists of a set of records describing objects (including disks, volumes, plexes, and subdisks) that are associated with one particular disk group.  Each disk group has an administrator-assigned name that can be used by the administrator to reference that disk group.  Each disk group has an internally defined unique disk group ID, which is used to differentiate two disk groups with the same administrator-assigned name. </font>
</p>
<p>
<a name="425081"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Disk groups provide a method to partition the configuration database, so that the database size is not too large and so that database modifications do not affect too many drives.  They also allow VxVM to operate with groups of physical disk media that can be moved between systems. </font>
</p>
<p>
<a name="425087"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Disks and disk groups have a circular relationship: disk groups are formed from disks, and disk group configurations are stored on disks. All disks in a disk group are stamped with a disk group ID, which is a unique identifier for naming disk groups.  Some or all disks in a disk group also store copies of the configuration database of the disk group. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="440208"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>disk group configuration</b></font></font>
</p>
<p>
<a name="453387"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A disk group configuration is a small database that contains all volume, plex, subdisk, and disk media records.  These configurations are replicated onto some or all disks in the disk group, usually with one copy on each disk.  Because these databases are stored within disk groups, record associations cannot span disk groups.  Thus, a subdisk defined on a disk in one disk group cannot be associated with a volume in another disk group. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="440275"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>disk header</b></font></font>
</p>
<p>
<a name="453406"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A block stored in a private region of a disk and that defines several properties of the disk.  The disk header defines the size of the private region, the location and size of the public region, the unique disk ID for the disk, the disk group ID and disk group name (if the disk is currently associated with a disk group), and the host ID for a host that has exclusive use of the disk. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="440333"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>disk ID</b></font></font>
</p>
<p>
<a name="453429"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A 64-byte universally unique identifier that is assigned to a physical disk when its private region is initialized with the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxdisk </b></font>init operation.  The disk ID is stored in the disk media record so that the physical disk can be related to the disk media record at system startup. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="440382"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>disk media record</b></font></font>
</p>
<p>
<a name="453452"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A reference to a physical disk This record can be thought of as a physical disk identifier for the disk Disk media records are configuration records that provide a name with up to 31 characters (known as the <em>disk media name</em> or DM name), which you can use to reference a particular disk, independent of its location on the system's various disk controllers.  Disk media records reference particular physical disks through a disk ID, which is a unique identifier that is assigned to a disk when it is initialized for use with VxVM. </font>
</p>
<p>
<a name="425132"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Operations are provided to set or remove the disk ID stored in a disk media record.  Such operations have the effect of removing or replacing disks, with any associated subdisks being removed or replaced along with the disk. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="440539"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>host ID</b></font></font>
</p>
<p>
<a name="453478"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A name, usually assigned by the administrator, that identifies a particular host.  Host IDs are used to assign ownership to particular physical disks.  When a disk is part of a disk group that is in active use by a particular host, the disk is stamped with that host's host ID.  If another system attempts to access the disk, it detects that the disk has a non-matching host ID and disallows access until the first system discontinues use of the disk.  To allow for system failures that do not clear the host ID, the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxdisk </b></font>clearimport operation can be used to clear the host ID stored on a disk. </font>
</p>
<p>
<a name="425149"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">If a disk is a member of a disk group and has a host ID that matches a particular host, then that host imports the disk group as part of system startup. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="440667"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>kernel log</b></font></font>
</p>
<p>
<a name="453504"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A log kept in the private region on the disk and that is written by the VERITAS Volume Manager kernel. The log contains records describing the state of volumes in the disk group.  This log provides a mechanism for the kernel to persistently register state changes so that <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxconfigd</b></font> can be guaranteed to detect the state changes even in the event of a system failure. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="440734"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>layered volume</b></font></font>
</p>
<p>
<a name="453523"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A virtual volume that is used and managed directly by VxVM, not by a user. Note that currently a layered volume provides storage for only one upper-level volume. </font>
</p>
<p>
<a name="425172"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Layered volumes allow VxVM to implement the following features: </font>
</p>
<p>
<ul type="disc"><p>
<ul type="disc"><p>
<ul type="disc"><li><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="425177"></a>Striped mirrors and concatenated mirrors are new types of volume layouts that are less likely to fail and that provide faster recovery times because there is less data to recover (one column or part of a column versus the whole volume). </font>
</li>
<li><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="425184"></a>Online relayout lets you change the volume layout while the volume is online. See the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxassist</b></font>(1M) and <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxrelayout</b></font>(1M) manual pages for more information. </font>
</li>
<li><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="425190"></a>RAID-5 subdisk moves and RAID-5 snapshots (see <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxassist</b></font>(1M)). </font>
</li>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="440914"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>plex</b></font></font>
</p>
<p>
<a name="453561"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A copy of a volume's logical data address space, also called a <em>mirror</em>.  A volume can have up to 32 plexes associated with it.  Each plex is, at least conceptually, a copy of the volume that is maintained consistently in the presence of volume I/O and reconfigurations.  Plexes represent the primary means of configuring storage for a volume.  Plexes can have a striped, concatenated, or RAID-5 organization (layout). </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="440981"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>plex consistency</b></font></font>
</p>
<p>
<a name="453580"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">If the plexes of a volume contain different data, then the plexes are said to be inconsistent.  This is only a problem if VxVM is unaware of the inconsistencies, as the volume can return differing results for consecutive reads.  Plex inconsistency is a serious compromise of data integrity.  This inconsistency can be caused by write operations that start around the time of a system failure, if parts of the write complete on one plex but not the other.  Plexes can also be inconsistent after creation of a mirrored volume, if the plexes are not first synchronized to contain the same data.  An important part of VERITAS Volume Manager operation is ensuring that consistent data is returned to any application that reads a volume.  This may require that plex consistency of a volume be ''recovered'' by copying data between plexes so that they have the same contents.  Alternatively, the volume can be put into a state such that reads from one plex are automatically written back to the other plexes, thus making the data consistent for that volume offset. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="441138"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>private region</b></font></font>
</p>
<p>
<a name="453599"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Disks used by VxVM contain two special regions: a private region and a public region. </font>
</p>
<p>
<a name="425225"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The private region of a disk contains various on-disk structures that are used by VxVM for various internal purposes.  Each private region begins with a disk header which identifies the disk and its disk group.  Private regions can also contain copies of a disk group's configuration, and copies of the disk group's kernel log. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="441214"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>public region</b></font></font>
</p>
<p>
<a name="453621"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The public region of a disk is the space reserved for allocating subdisks.  Subdisks are defined with offsets that are relative to the beginning of the public region of a particular disk.  Only one contiguous region of disk can form the public region for a particular disk. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="441263"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>RLINK</b></font></font>
</p>
<p>
<a name="453648"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">(remote link) A representation of a communications link to a RVG hierarchy at a remote replication site, which contains information about the link. An RLINK is a primary RLINK if its parent RVG is the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>primary</b></font> RVG containing writable primary data volumes. Alternatively, a RLINK is a secondary RLINK if its parent RVG contains read-only data volumes (one for each data volume that the primary RVG contains). The <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxrlink</b></font>(1M) command is used to replicate a volume or volumes to any number of remote sites. The primary RVG has one RLINK record associated with it for each secondary site. A secondary RVG has only one RLINK record associated with it, which represents and contains information about the connection with the corresponding primary RLINK. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="441384"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>RVG</b></font></font>
</p>
<p>
<a name="453667"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">(replicated volume group) A virtual device that hierarchically contains one or more data volume records, a log volume record called a Storage Replicator Log (SRL), and one (or more for primary RVGs) RLINK records. It must be associated as a parent of the data volume records in order for those data volumes to be replicated to other sites which may be located across a LAN or WAN. In order to actively replicate a data volume, an RVG must have at least one data volume child (the volume to be replicated), exactly one SRL volume child (a volume to SRL data volume writes before they are transmitted to RLINKs), and at least one RLINK child (which represents a connection to an RVG hierarchy at a remote replication site). An RVG can be either a primary or a secondary, depending on whether its data volumes are considered to contain the primary copies of data or whether the data volumes are considered to be read-only copies of the data. Secondary RVGs contain one SRL volume, one RLINK, and the same number of data volumes as the primary RVG contains. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="441541"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>SRL volume</b></font></font>
</p>
<p>
<a name="453686"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">(storage replicator log volume) A volume being used as a child of an RVG. The SRL volume contains temporary copies of data intended to be written from (primary) or to (secondary) sibling data volumes. The SRL volume also contains meta data, such as connection information, about the RVG and RLINK with which the SRL volume is associated. The primary SRL volume is used to log SRL data while either in asynchronous mode, or during network outages while in synchronous mode. A secondary RVG must also have an SRL volume associated with it. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="441626"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>striped plex</b></font></font>
</p>
<p>
<a name="453705"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A plex that scatters data evenly across each of its associated subdisks. A plex has a characteristic number of stripe columns (consisting of associated subdisks) and a characteristic stripe unit size. The stripe unit size defines how data with a particular address is allocated to one of the associated subdisks. Given a stripe unit size of 64 blocks and two stripe columns, the first group of 64 blocks is allocated to the first subdisk, the second group of 64 blocks is allocated to the second subdisk, the third group to the first subdisk, and so on. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="441721"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>subdisk</b></font></font>
</p>
<p>
<a name="453724"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A region of storage allocated on a disk for use with a volume. Subdisks are associated to volumes through plexes.  One or more subdisks are laid out to form plexes based on the plex layout (striped, concatenated, or RAID-5). Subdisks are defined relative to disk media records. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="441770"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>volboot file</b></font></font>
</p>
<p>
<a name="453755"></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>volboot</b></font> file is a special file (usually stored in <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>/etc/vx/volboot</b></font>) that is used to define a system's host ID and a system-wide default disk group. If the root disk is under VxVM control, the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>volboot</b></font> file is also used to define the name of the boot disk group for the system. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="441819"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>volume</b></font></font>
</p>
<p>
<a name="453774"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A virtual disk device that looks to applications and file systems like a regular disk device. Volumes present block and raw device interfaces that are compatible in their use with disk devices. However, a volume is a virtual device that can be mirrored, spanned across disk drives, moved to use different storage, and striped using administrative commands.  The configuration of a volume can be changed, using VERITAS Volume Manager utilities, without causing disruption to applications or file systems that are using the volume. </font>
</p>
</ul>
</p>
</ul>
</p>
</ul>
</p>

<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="441923"></a> INTELLIGENT STORAGE PROVISIONING</font>
</h3>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="441928"></a>The VERITAS Intelligent Storage Provisioning (ISP) feature introduces rule-based allocation of storage to VERITAS Volume Manager. This feature is administered by using the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxpool</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxtemplate</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxusertemplate</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxvoladm</b></font> and <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxvoladmtask</b></font> commands, and the graphical user interface. For a description of the concepts and functionality of the VERITAS Intelligent Storage Provisioning feature, see the <em>VERITAS Storage Foundation Intelligent Storage Provisioning Administrator's </em>Guide and the manual pages relating to the ISP commands. </font>
</p>


<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="442030"></a> CONVENTIONS</font>
</h3>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="442035"></a>VxVM employs certain conventions to provide a degree of similarity between various operations. The conventions are used in the following areas: </font>
</p>

<p>
<ul type="disc"><li><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="425343"></a>Disk Group Selection </font>
</li>
<li><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="425347"></a>Standard Length Numbers </font>
</li>
<li><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="425351"></a>Command Syntax </font>
</li>
</ul>
</p>

<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="442117"></a> DISK GROUP SELECTION</font>
</h3>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="442122"></a>Most commands operate upon only one disk group per invocation.  Each disk group has a separate configuration from every other disk group and it is possible for two disk groups to contain two objects that have the same name.  This can happen, in particular, if a disk group is moved from one system to another.  However, most utilities make no attempt to ensure that names between disk groups are unique, so name collisions can occur. </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="442179"></a>System administrators who try to avoid name collisions should be able to use most of the utilities without having to specify disk groups except when creating objects.  Administrators cannot use single-command invocations that reference objects in more than one disk group, but disk groups are selected automatically, based on objects specified in the command. </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="442227"></a>The rules that commands use to select the disk group when this is not specified are described on the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxdg</b></font>(1M) manual page. </font>
</p>


<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="442239"></a> STANDARD LENGTH NUMBERS</font>
</h3>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="442244"></a>Many basic properties of objects that are managed by VxVM require specification of lengths, either as a pure object length or as an offset relative to some other object. </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="442265"></a>VxVM supports volume lengths up to 2&#94;63-1 disk sectors when using VERITAS-specific <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>ioctl</b></font> calls. However, system calls such as <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>seek</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>lseek</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>read</b></font> and <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>write</b></font> are limited to a maximum offset that is determined by the operating system. For a system that supports large files, this is usually 2&#94;63-1 bytes. Otherwise, the maximum offset value is usually 2&#94;31-1 bytes (1 byte less than 2 terabytes). </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="442322"></a>VxVM provides a uniform syntax for representing large numbers, and uses suffixes to provide convenient multipliers.  Numbers can be specified in decimal, octal, or hexadecimal. For convenience, numbers can be specified as a sum of several numbers. </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="442370"></a>A hexadecimal (base 16) number is introduced using a prefix of <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>0x</b></font>.  For example, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>0xfff</b></font> is the same as decimal 4095.  An octal (base 8) number is introduced using a prefix of <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>0</b></font>.  For example, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>0177777</b></font> is the same as decimal 65535. </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="442400"></a>A number can be followed by a single-character suffix to indicate a multiplier for the number. A length number with no suffix character represents a count of standard disk sectors. The length of a standard disk sector can vary between systems; it is typically 512 bytes or 1024 bytes. On systems where disks can have different sector sizes, one of the sector sizes is chosen as the ''standard'' size. Supported suffix characters are: </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="442479"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>b</b></font></font>
</p>
<p>
<a name="453857"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">(Blocks) Multiply the length by 1024 bytes. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="442492"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>g</b></font></font>
</p>
<p>
<a name="453876"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">(Gigabytes) Multiply the length by 1,073,741,824 (1024M) bytes. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="442505"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>k</b></font></font>
</p>
<p>
<a name="453895"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">(Kilobytes) Multiply the length by 1024 bytes. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="442518"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>m</b></font></font>
</p>
<p>
<a name="453914"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">(Megabytes) Multiply the length by 1,048,576 (1024K) bytes. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="442531"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>s</b></font></font>
</p>
<p>
<a name="453933"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">(Sectors) Multiply the length by the standard sector size. This is the default unit if no suffix is specified. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="442552"></a>Numbers are represented internally as an integer number of sectors. As a result, if the standard disk sector size is larger than 512 bytes, numbers can be specified that need to be rounded to a sector.  Rounding is always done to the next lowest, not the nearest, multiple of the sector size. </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="442591"></a>Because the letter <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>b</b></font> is a valid hexadecimal character, there is a special case for the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>b</b></font> suffix where a single blank character can separate a number from the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>b</b></font> suffix character.  Use of a blank within a number, when invoking commands from the shell, usually requires quoting the number.  For example: </font>
</p>

<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="442645"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">vxassist&nbsp;make&nbsp;vol01&nbsp;&quot;0x1000&nbsp;b&quot;</font>
</font>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="442655"></a>Numbers can be added or subtracted by separating two or more numbers by a plus or minus sign, respectively.  A plus sign is optional. The following is an example: </font>
</p>

<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="442691"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">1023g+1023m+1023k+1</font>
</font>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="442701"></a>In output, VxVM reports lengths in sectors, with no suffix character. </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="442713"></a>Case is ignored in length specification.  Hexadecimal numbers and suffix characters can be specified using any reasonable combination of uppercase and lowercase letters. </font>
</p>


<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="442734"></a> UTILITY SYNTAX</font>
</h3>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="442739"></a>Most utilities in VxVM provide more than one operation, with operations grouped into utilities primarily by object type. Utilities that provide multiple operations are typically invoked with the following form: </font>
</p>

<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="442784"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">utility_name&nbsp;[&nbsp;options&nbsp;]&nbsp;keyword&nbsp;[&nbsp;operands&nbsp;]</font>
</font>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="442794"></a><em>utility_name</em> is the name of the VERITAS Volume Manager command and <em>keyword </em>specifies the specific operation to perform. Any options that are introduced in the standard <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-</b></font><em>letter</em> form precede the operation keyword.  This is in keeping with standard System V UNIX utility syntax, which provides for a set of options as the first arguments to a command, followed by any non-option operands.  The <em>keyword</em> is considered an operand under standard System V syntax. </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="442869"></a>All VM utilities provide an extended usage message that lists all the options and operation keywords supported by the utility. Most VM utilities also display a usage message if you enter an invalid option. For utilities that are keyword-based, you can display this extended usage message the keyword <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>help </b></font>or a question mark (<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>?</b></font>). Utilities that use operands for something other than operation selection provide a reserved option of <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-H </b></font>to display the extended usage information. </font>
</p>


<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="442982"></a> RECORD TYPES</font>
</h3>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="442987"></a>Disk group configurations contain eight types of records: </font>
</p>

<p>
<ul type="disc"><li><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="425505"></a>Disk Access Records </font>
</li>
<li><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="425509"></a>Disk Group Records </font>
</li>
<li><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="425513"></a>Disk Media Records </font>
</li>
<li><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="425517"></a>Plex Records </font>
</li>
<li><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="425521"></a>RLINK Records </font>
</li>
<li><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="425525"></a>RVG Records </font>
</li>
<li><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="425529"></a>Subdisk Records </font>
</li>
<li><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="425533"></a>Volume Records </font>
</li>
</ul>
</p>

<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="443160"></a> DISK ACCESS RECORDS</font>
</h3>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="443165"></a>Disk access records define an address, or access path, that can be used to access a disk.  The list of all disk access records defines the list of all disk addresses that VxVM can use to locate physical disks.  Disk access records do not define specific physical disks, since physical disks can be moved on a system.  When a physical disk is moved, a different disk access record may be necessary to locate it. </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="443222"></a>Usually VxVM can use the information provided by the operating system to configure most, if not all, disk access records automatically. Such auto-configured disk access records are not stored persistently on disk, but are instead regenerated every time that VxVM starts up. </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="443252"></a>Disk access records that cannot be configured by scanning the disks are stored in an ordinary file, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>/etc/vx/darecs</b></font>, which is located in the root file system. (In releases prior to VxVM 4.0, such records were stored in the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>volboot</b></font> file.) </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="443291"></a>Unlike all other record types, the names of disk access records can conflict with the names of other records.  For example, a specialty disk (such as a RAM disk) can use the same name for both the disk access record and the disk media record that points to it.  It is typically advisable to use different names for the access and media records, to avoid additional confusion if disks are moved. </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="443348"></a>Disk access records have the following fundamental attributes: </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="443352"></a><em>disk access name</em></font>
</p>
<p>
<a name="454070"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The name of the disk access record is typically a disk address. Disk access names are usually of the form <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>c</b></font><em>#</em><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>t</b></font><em>#</em><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>d</b></font><em>#</em>, indicating use of the entire disk on controller <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>c</b></font><em>#</em>, with SCSI target ID <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>t#</b></font>, and logical unit <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>d</b></font><em>#</em>. </font>
</p>
<p>
<a name="425575"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">VxVM 3.2 introduced an alternative enclosure-based naming scheme, which uses disk access names of the form <em>enclosurename</em><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>_</b></font><em>disk# </em>where <em>enclosurename</em> is the logical enclosure name, and <em>disk#</em> is the number of the disk in the enclosure. For example, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>enc0_0</b></font> refers to the first disk in the enclosure <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>enc0</b></font>. </font>
</p>
<p>
<a name="425581"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Other systems are likely to have different conventions for disk access name. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="443496"></a><em>type</em></font>
</p>
<p>
<a name="454163"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Each disk access record has a type, which identifies key characteristics of VxVM's interaction with the disk. The available types are <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>auto</b></font>, <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>nopriv</b></font>. Typically, most disks are configured with the type <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>auto</b></font> and format <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>cdsdisk</b></font> (<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>auto:cdsdisk</b></font>) to support the Cross-platform Data Sharing (CDS) feature. However, disks that are used to boot the system typically have the disk type <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>auto</b></font> and format <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>auto:hpdisk</b></font>). See the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxdisk</b></font>(1M) manual page for more information on disk types. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="443589"></a>If the physical disk represented by the disk access record is associated with a disk media record, then the following fields are defined: </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="443611"></a><em>disk group name</em></font>
</p>
<p>
<a name="454182"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The name of the disk group containing the disk media record. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="443624"></a><em>disk media name</em></font>
</p>
<p>
<a name="454201"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The name of the disk media record that points to the physical disk. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="443636"></a>Additional attributes can be added, arbitrarily, by disk types.  See <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxdisk</b></font>(1M) for a list of additional attributes defined by the standard disk types. </font>
</p>


<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="443657"></a> DISK GROUP RECORDS</font>
</h3>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="443662"></a>Disk group records define several different types of names for a disk group.  The different types of names are: </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="443675"></a><em>alias name</em></font>
</p>
<p>
<a name="454224"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">This is the standard name that the system uses when referencing the disk group. References to the disk group name usually mean the alias name. Volume directories are structured into subdirectories based on the disk group alias name. Typically, the disk group's alias name and real name are identical. A local alias can be useful for gaining access to a disk group with a name that conflicts with other disk groups in the system. </font>
</p>
<p>
<a name="425625"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The names <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>bootdg</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>defaultdg</b></font> and <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>nodg</b></font> are reserved. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="443785"></a><em>disk group ID</em></font>
</p>
<p>
<a name="454258"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A 64-byte identifier that represents the unique ID of the disk group. All disk groups on all systems should have a different disk group ID, even if they have the same real name.  This identifier is stored in the disk headers of all disks in the disk group.  It is used to ensure that VxVM does not confuse two disk groups which were created with the same name. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="443843"></a><em>real name</em></font>
</p>
<p>
<a name="454277"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">This is the name of the disk group, as defined on disk. This name is stored in the disk group configuration, and is also stored in the disk headers of all disks in the disk group. </font>
</p>

<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="443873"></a> DISK MEDIA RECORDS</font>
</h3>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="443878"></a>Disk media records define a specific disk within a disk group.  The name of a disk media record (the disk media name) is assigned when a disk is first added to a disk group (using the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxdg adddisk</b></font> operation).  Disk media records can be assigned to specific physical disks by associating the disk media record with the current disk access record for the physical disk. </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="443935"></a>Disk media records have the following fundamental attributes: </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="443939"></a><em>disk access name</em></font>
</p>
<p>
<a name="454308"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The disk access name that is currently used to access the physical disk referenced by the disk ID.  If the disk ID is defined, but no physical disk with that ID could be found, the disk access name is clear.  A disk where the physical disk could not be found is considered to be in the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>NODAREC</b></font>, or <em>inaccessible</em>, state. A disk can become inaccessible either because the indicated disk is not currently attached to the system, or because I/O failures on the physical disk prevented VxVM from identifying or using the physical disk. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="444033"></a><em>disk ID</em></font>
</p>
<p>
<a name="454331"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A 64-byte unique identifier representing the physical disk to which the media record is associated.  This can be cleared to indicate that the disk is considered in the <em>removed</em> state.  A removed disk has no current association with any physical disk. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="444072"></a>A disk media record that has an active association with a physical disk (both the disk ID and the disk access name attributes are defined), inherits several properties from the underlying physical disk.  These attributes are taken from the disk header, which is stored in the private region of the disk.  These inherited attributes are: </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="444121"></a><em>atomic I/O size</em></font>
</p>
<p>
<a name="454354"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">This is the fundamental I/O size for the disk, in bytes, also known as the <em>sector size</em>. All I/O operations to this disk must be multiples of this size. VxVM requires that all disks have the same sector size. On most systems, this size is 1024 bytes. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="444179"></a><em>private length</em></font>
</p>
<p>
<a name="454373"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The length of the region of the physical disk that is reserved for storing private VERITAS Volume Manager information. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="444201"></a><em>public length</em></font>
</p>
<p>
<a name="454392"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The length of the region of the physical disk that is available for subdisk allocations. </font>
</p>

<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="444222"></a> PLEX RECORDS</font>
</h3>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="444227"></a>Plex records define the characteristics of a particular plex of a volume.  A plex can be in either an associated state or a dissociated state.  In the dissociated state, the plex is not a part of a volume. A dissociated plex cannot be accessed in any way.  An associated plex can be accessed through the volume. </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="444266"></a>Plexes have the following fundamental attributes: </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="444270"></a><em>comment</em></font>
</p>
<p>
<a name="454415"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">An administrator-assigned string of up to 40 characters that can be set and changed using the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxedit</b></font> utility. VxVM does not interpret the comment field. The comment cannot contain newline characters. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="444310"></a><em>condition flags</em></font>
</p>
<p>
<a name="454434"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Various condition flags are defined for the plex that define state which is recognized automatically, rather than managed by the volume usage type.  Defined flags are: </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="444341"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>IOFAIL</b></font></font>
</p>
<p>
<a name="454453"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The plex was detached as a result of an I/O failure detected during normal volume I/O.  The plex is out-of-date with respect to the volume, and in need of complete recovery.  However, this condition also indicates a likelihood that one of the disks in the system should be replaced. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="444390"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>NODAREC</b></font></font>
</p>
<p>
<a name="454472"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">No physical disk was found for one of the subdisks in the plex.  This implies either that the physical disk failed, making it unrecognizable, or that the physical disk is no longer attached through a known access path. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="444430"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>NODEVICE</b></font></font>
</p>
<p>
<a name="454491"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A physical device could not be found corresponding to the disk ID in the disk media record for one of the subdisks associated with the plex. The plex cannot be used until this condition is fixed, or the affected subdisk is dissociated. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="444479"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>RECOVER</b></font></font>
</p>
<p>
<a name="454510"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A disk for one of the disk media records was replaced or was reattached too late to prevent the plex from becoming out-of-date with respect to the volume.  The plex requires complete recovery from another plex in the volume to synchronize the plex with the correct contents of the volume. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="444528"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>REMOVED</b></font></font>
</p>
<p>
<a name="454529"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">One of the disk media records was put into the removed state through explicit administrative action.  The plex cannot be used until the disk is replaced or the affected subdisk is dissociated. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="444559"></a><em>contiguous length</em></font>
</p>
<p>
<a name="454552"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The offset of the first block in the plex address space that is <em>not</em> backed by a subdisk.  If the plex has no holes, the contiguous length matches the plex length.  If the contiguous length is equal to or greater than the length of the associated volume, the plex is considered complete, otherwise it is sparse. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="444608"></a><em>I/O mode</em></font>
</p>
<p>
<a name="454571"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Each plex is in read-write, read-only, or write-only mode.  This mode affects read and write operations directed to the volume, if the plex is enabled.  For read-write and read-only modes, volume read operations can be directed to the plex.  For read-write and write-only modes, volume write operations are directed to the plex. </font>
</p>
<p>
<a name="425759"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Plexes are normally in read-write mode.  Write-only mode is used to recover a plex that failed, and whose contents have thus become out-of-date with respect to the volume.  It is also used when attaching a new plex to a volume.  In write-only mode, writes to the volume update the plex, causing written regions to be up-to-date. Typically, a set of special copy operations is used to update the remainder of the plex. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="444727"></a><em>layout</em></font>
</p>
<p>
<a name="454593"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The organization of associated subdisks with respect to the plex address space.  The layout is striped, concatenated, or RAID-5. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="444749"></a><em>length</em></font>
</p>
<p>
<a name="454612"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The length of a plex is the offset of the last subdisk in the plex plus the length of that subdisk.  In other words, the length of the plex is defined by the last block in the plex address space that is backed by a subdisk.  This value may or may not relate to the length of the volume, depending on whether the plex is completely contiguously allocated. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="444807"></a><em>log subdisk</em></font>
</p>
<p>
<a name="454631"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Each plex can have at most one associated log subdisk.  A log subdisk is used with the dirty region logging feature to improve the time required to recover consistency of a volume after a system failure. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="444847"></a><em>plex kernel state</em></font>
</p>
<p>
<a name="454650"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Each plex is either enabled, disabled, or detached.  When enabled, normal read and write operations from the volume can be directed to the plex.  When disabled, no I/O operations are applied to the plex.  When detached, normal volume I/O are not directed to the plex. </font>
</p>
<p>
<a name="425792"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">I/O failures encountered during normal volume I/O may move the enabled state for a plex directly from enabled to detached.  See the description of volume exception policies (earlier in this manual page) for more information. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="444941"></a><em>subdisks</em></font>
</p>
<p>
<a name="454676"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Each plex has zero or more associated subdisks.  Subdisks are associated at offsets relative to the beginning of the plex address space.  Subdisks for concatenated plexes may not cover the entire length of the plex, in which case they leave holes in the plex.  A plex that is not as long as the volume to which it is associated is considered to have a hole extending from the end of the plex to the end of the volume.  A plex with a hole is considered incomplete, and is sometimes called <em>sparse</em>. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="445038"></a><em>usage-type state</em></font>
</p>
<p>
<a name="454695"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Volume usage types maintain a private state field related to the the operations that have been performed on the plex, or to failure conditions that have been encountered.  This state field contains a string of up to 14 characters. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="445078"></a><em>volatile state</em></font>
</p>
<p>
<a name="454714"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A plex is considered to have ''volatile'' contents if the disk for any of the plex's subdisks is considered to be volatile.  The contents of a volatile disk are not presumed to survive a system reboot.  The contents of a volatile plex are always considered out-of-date after a recovery and in need of complete recovery from another plex. </font>
</p>

<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="445126"></a> RLINK RECORDS</font>
</h3>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="445131"></a>RLINK records define the characteristics of a particular RLINK of an RVG. An RLINK can be in either an associated or dissociated state. In the dissociated state, the RLINK is not part of any RVG. An associated RLINK can be accessed through the RVG. </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="445161"></a>RLINK have the following fundamental attributes: </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="445165"></a><em>usage type</em></font>
</p>
<p>
<a name="454733"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">RLINK are treated internally as if they have a usage-type of gen, but this distinction is largely irrelevant and exists merely to be compatible with pre-existing VERITAS Volume Manager code. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="445196"></a><em>rlink kernel state</em></font>
</p>
<p>
<a name="454752"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Each primary RLINK is either enabled, disabled or detached. When enabled, normal write operations are forwarded to the remote RLINK. When disabled, no I/O operations on the RLINK are allowed. When detached, normal RVG I/O are not directed to the RLINK, but certain ioctls can be issued against the RLINK. An enabled RLINK can also be either connected or disconnected, depending on whether the network connection between the RLINKs on the primary and secondary nodes is currently open or not. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="445263"></a><em>usage-type state</em></font>
</p>
<p>
<a name="454771"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">RLINKs are treated as having a gen usage-type, and its usage-type state is a private state field indicating the state of operations that have been performed on the RLINK, or failure conditions that have been encountered. This state field contains a string of up to 14 characters. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="445303"></a><em>synchronous</em></font>
</p>
<p>
<a name="454790"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A field that indicates whether the RLINK should operate in synchronous or asynchronous mode. In synchronous mode, a write request to a replicated volume does not complete until the data has been recorded on the SRL and reached the secondary node. In asynchronous mode, a write request completes as soon as the data is recorded on the SRL. The field may have one of three values: </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="445361"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>off</b></font></font>
</p>
<p>
<a name="454809"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">mode is asynchronous </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="445374"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>override</b></font></font>
</p>
<p>
<a name="454828"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">mode is synchronous, but automatically switches to asynchronous if the rlink becomes inactive due to a disconnection or administrative action </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="445405"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>fail</b></font></font>
</p>
<p>
<a name="454847"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">mode is synchronous. If synchronous=fail is set and an administrator detaches the Primary RLINK, writes to the RVG are not failed. However, if an RLINK becomes inactive for any other reason, including an administrative detach of the Secondary RLINK, subsequent write requests are failed with an EIO error. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="445454"></a><em>local_host</em></font>
</p>
<p>
<a name="454866"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">RLINKs have a host_name attribute that contains the name of the local host machine. Needed to support private networks. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="445476"></a><em>remote_host</em></font>
</p>
<p>
<a name="454885"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">RLINKs have a remote_host attribute that contains the name of the remote host machine from (primary) or to (secondary) which replication takes place. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="445498"></a><em>remote_dg</em></font>
</p>
<p>
<a name="454904"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">RLINKs have a remote_rlink attribute that contains the name of the diskgroup on the remote machine. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="445520"></a><em>remote_rlink</em></font>
</p>
<p>
<a name="454923"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">RLINKs have a remote_rlink attribute that contains the name of the RLINK counterpart on the remote machine. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="445542"></a><em>comment</em></font>
</p>
<p>
<a name="454942"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">An administrator-assigned string of up to 40 characters that can be set and changed using the vxedit utility. VxVM does not interpret the comment field. The comment cannot contain newline characters. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="445573"></a><em>latencyprot</em></font>
</p>
<p>
<a name="454961"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A field that indicates whether latency protection is enabled for the RLINK. Latency protection prevents a RLINK from having more than a preset number of outstanding requests. All requests which have not been written to the remote data volume are counted as outstanding. If latency protection is enabled, then when the number of outstanding requests reaches latency_high_mark, throttling is enabled. This causes all new write requests to stall until throttling is disabled. Throttling is not disabled until the number of outstanding requests is reduced to latency_low_mark. The field may have one of three values: </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="445667"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>off</b></font></font>
</p>
<p>
<a name="454980"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">latency protection is disabled </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="445680"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>override</b></font></font>
</p>
<p>
<a name="454999"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">latency protection is enabled, but is automatically disabled if the RLINK becomes inactive due to a disconnection or administrative action </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="445711"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>fail</b></font></font>
</p>
<p>
<a name="455018"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">latency protection is enabled. If the RLINK becomes inactive for any reason, and the latency_high_mark is reached, subsequent write requests are failed with an EIO error. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="445742"></a><em>srlprot</em></font>
</p>
<p>
<a name="455037"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A field that indicates whether SRL protection is enabled for the RLINK. SRL protection prevents an RLINK from overflowing the SRL, which causes the RLINK to disconnect. If the RLINK has SRL protection enabled, and the next write request would cause the RLINK to overflow the SRL, then throttling is enabled. This causes all new write requests to stall until throttling is disabled. Throttling is not disabled until a predetermined amount of space is available on the SRL. The exception to this is when the autodcm mode is set, in which case, DCM protection is enabled as soon as the SRL overflows and incoming write requests are not stalled. The field may have one of five values: </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="445849"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>off</b></font></font>
</p>
<p>
<a name="455056"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">SRL protection is disabled </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="445862"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>override</b></font></font>
</p>
<p>
<a name="455075"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">SRL protection is enabled, but will automatically be disabled if the RLINK becomes inactive due to a disconnection or administrative action </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="445893"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>fail</b></font></font>
</p>
<p>
<a name="455094"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">SRL protection is enabled. If the RLINK becomes inactive for any reason, and SRL overflow is imminent, subsequent write requests are failed with an EIO error. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="445924"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>autodcm</b></font></font>
</p>
<p>
<a name="455113"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">SRL protection is enabled. This is the default option for srlprot. If an RLINK begins to overflow the SRL, DCM protection is activated. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="445947"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>dcm</b></font></font>
</p>
<p>
<a name="455132"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">SRL protection is enabled. This differs from the &quot;autodcm&quot; protection in that the DCM protection is activated only when the RLINKs disconnect. When the RLINKs are connected, incoming writes are throttled as described above. </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="445994"></a><b>Note  &nbsp;&nbsp;</b>
</font>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2" color="#000000"> When DCM protection is activated, the DCMs are used to record the regions that change on the data volumes. The <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxrvg</b></font> command can be used to resynchronize the images when the RLINKs are connected. It should be noted that using DCM to resynchronize an image makes the image inconsistent until the resynchronization completes. 
</font>
<hr noshade size="2" width="100%" color="#000000">
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="446036"></a><em>latency_high_mark</em></font>
</p>
<p>
<a name="455163"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Maximum number of outstanding requests when latency protection is enabled. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="446058"></a><em>latency_low_mark</em></font>
</p>
<p>
<a name="455182"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">After latency throttling is enabled, the number of outstanding requests must drop to this before it is disabled. </font>
</p>

<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="446079"></a> RVG RECORDS</font>
</h3>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="446084"></a>RVG records define the characteristics of particular RVG devices. The name of an RVG record defines the node name used for files in the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>/dev/vx/dsk</b></font> and <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>/dev/vx/rdsk</b></font> directories. The block device for a particular RVG (which is unused in the current implementation) has the path: </font>
</p>

<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="446138"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">/dev/vx/dsk/groupname/rvg</font>
</font>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="446148"></a>where groupname is the name assigned by the administrator to the disk group containing the RVG. Note that the block device for a child data volume, not the RVG itself, can be used as an argument to the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>mount</b></font> command (see <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>mount</b></font>(2)). The raw device for an RVG, typically used for issuing I/O control operations (see <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>ioctl</b></font>(2)), has the path: </font>
</p>

<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="446220"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">/dev/vx/rdsk/groupname/rvg</font>
</font>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="446233"></a>Accesses to a data volume associated with a primary RVG device are internally directed to the RVG so that replication can take place. The RVG device nodes do not support the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>read</b></font>(2) and <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>write</b></font>(2) system calls. </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="446263"></a>RVGs have the following fundamental attributes: </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="446270"></a><em>usage type</em></font>
</p>
<p>
<a name="455241"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">RVGs are treated internally as if they have a usage-type of gen, but this distinction is largely irrelevant and exists merely to be compatible with pre-existing VERITAS Volume Manager code. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="446325"></a><em>rvg kernel state</em></font>
</p>
<p>
<a name="455260"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Each primary RVG is either enabled, disabled or detached. When enabled, normal read and write operations are allowed on the child data volumes (assuming the underlying data volumes themselves are enabled) and those accesses are reflected to the data volumes as well as to any active RLINKs. When disabled, no access to the data volumes or any of its associated RLINKs is allowed. When detached, some ioctls can be used by utilities to operate on the RVG. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="446428"></a><em>usage-type state</em></font>
</p>
<p>
<a name="455279"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">RVGs are treated as having a gen usage-type, and its usage-type state is a private state field indicating the state of operations that have been performed on the RVG, or failure conditions that have been encountered. This state field contains a string of up to 14 characters. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="446495"></a><em>datavols</em></font>
</p>
<p>
<a name="455298"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">List of data volumes associated with the RVG. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="446514"></a><em>srl</em></font>
</p>
<p>
<a name="455317"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Each RVG has one associated SRL volume. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="446533"></a><em>rlink</em></font>
</p>
<p>
<a name="455336"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Each primary RVG has between zero and thirty-two associated RLINK. Each secondary RVG can have no more than one associated RLINK. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="446564"></a><em>comment</em></font>
</p>
<p>
<a name="455355"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">An administrator-assigned string of up to 40 characters that can be set and changed using the vxedit utility. VxVM does not interpret the comment field. The comment cannot contain newline characters. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="446607"></a><em>user</em>|<em>group</em>|<em>mode</em></font>
</p>
<p>
<a name="455382"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">These attributes are the user, group and file permission modes used for the RVG device nodes. The user and group are normally root. The mode usually allows read and write permission to the owner, and no access by other users. </font>
</p>

<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="446661"></a> SUBDISK RECORDS</font>
</h3>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="446666"></a>Subdisk records define a region of disk, allocated from a disk's public region.  Subdisks have very little state associated with them, other than the configuration state that defines which region of disk the subdisk occupies.  Subdisks cannot overlap each other, either in their associations with plexes, or in their arrangement on disk public regions. </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="446732"></a>Subdisks have the following fundamental attributes: </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="446739"></a><em>comment</em></font>
</p>
<p>
<a name="455405"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">An administrator-assigned string of up to 40 characters that can be set and changed using the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxedit</b></font> utility. VxVM does not interpret the comment field. The comment cannot contain newline characters. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="446794"></a><em>disk media name</em></font>
</p>
<p>
<a name="455424"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The name of the disk media record that the subdisk is defined on. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="446813"></a><em>disk offset</em></font>
</p>
<p>
<a name="455443"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The offset, from the beginning of the disk's public region, to the start of the subdisk. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="446844"></a><em>length</em></font>
</p>
<p>
<a name="455462"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The length of the subdisk. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="446863"></a><em>plex offset</em></font>
</p>
<p>
<a name="455481"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">For associated subdisks, this is the offset (from the beginning of the plex) of the subdisk association.  For subdisks associated with striped plexes, the plex offset defines relative ordering of subdisks in the plex, rather than actual offsets within the plex address space. </font>
</p>

<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="446917"></a> VOLUME RECORDS</font>
</h3>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="446922"></a>Volume records define the characteristics of particular volume devices.  The name of a volume record defines the node name used for files in the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>/dev/vx/dsk</b></font> and <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>/dev/vx/rdsk</b></font> directories.  The block device for a particular volume (which can be used as an argument to the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>mount</b></font> command (see <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>mount</b></font>(1M)) has the path: </font>
</p>

<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="446991"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">/dev/vx/dsk/</font><em>groupname</em>/<font face="Courier New, Courier, sansserif, sans serif" size="2">volume</font>
</font>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="447007"></a>where <em>groupname</em> is the name assigned by the administrator to the disk group containing the volume.  The raw device for a volume, typically used for application I/O and for issuing I/O control operations (see <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>ioctl</b></font>(2)), has the path: </font>
</p>

<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="447064"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">/dev/vx/rdsk/</font><em>groupname</em>/<font face="Courier New, Courier, sansserif, sans serif" size="2">volume</font>
</font>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="447080"></a>Reads to a volume device are directed to one of the read-write or read-only plexes associated with the volume.  Writes to the volume are directed to all of the enabled read-write and write-only plexes associated with the volume. </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="447122"></a>During a write operation, two plexes of a volume may become out of sync with each other, due to the fact that writes directed to two disks can complete at different times.  This is not normally a problem.  However, if the system were to crash or lose power during a write operation, the two plexes could have different contents. </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="447176"></a>Most applications and file systems are not written with the presumption that two separate reads of a device can return different contents without an intervening write operation.  Since plexes with different contents could cause such a situation where two read operations of a block return different contents, VxVM expends considerable effort to ensure that this is avoided. </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="447242"></a>Volumes have the following fundamental attributes: </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="447249"></a><em>comment</em></font>
</p>
<p>
<a name="455556"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">An administrator-assigned string of up to 40 characters that can be set and changed using the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxedit</b></font> utility. VxVM does not interpret the comment field. The comment cannot contain newline characters. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="447304"></a><em>exception policy</em></font>
</p>
<p>
<a name="455579"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">There are several modes that can be set on the volume, by utilities according to the usage type of the volume.  These modes affect operation of a volume in the presence of I/O failures. Currently only one of these policies, called <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>GEN_DET_SPARSE</b></font> is ever used.  This policy tracks complete and incomplete plexes in a volume (an incomplete plex does not have a backing subdisk for all blocks in the volume).  If an unrecoverable error occurs on an incomplete plex, the plex is detached (disabled from receiving regular volume I/O requests).  If an unrecoverable error occurs on a complete plex, the plex is detached unless it is the last complete plex.  If the plex is the last complete read-write plex, any incomplete plexes that overlap with the error are detached but the plex with the error remains attached. </font>
</p>
<p>
<a name="426157"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">This default policy is chosen to ensure that an I/O that fails on one plex is not directed to that plex again unless that plex is the last complete plex remaining attached to the volume. In that case, the policy ensures that the volume returns the error consistently, even in the presence of incomplete plexes. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="447534"></a><em>length</em></font>
</p>
<p>
<a name="455601"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Each volume has a length, which defines the limiting offset of read and write operations.  The length is assigned by the administrator, and may or may not match the lengths of the associated plexes. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="447577"></a><em>log type</em></font>
</p>
<p>
<a name="455620"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A policy to use for logging changes to the volume, which can be assigned by the administrator.  Policies that can be specified are: </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="447608"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>none</b></font></font>
</p>
<p>
<a name="455639"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Do not perform any special actions when writing to the volume.  Just write the requested data to all read-write or write-only plexes. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="447639"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>dirty-region-log</b></font></font>
</p>
<p>
<a name="455658"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A volume is divided into regions. A bitmap where each bit corresponds to a region is maintained. When a write to a particular region occurs, the respective bit is set to on. When the system is restarted after a crash, this region bitmap is used to limit the amount of data copying that is required to recover plex consistency for the volume.  The region changes are logged to special log subdisks associated with each of the plexes associated with the volume.  Use of dirty region logging can greatly speed recovery of a volume, but it also degrades performance of the volume under normal operation. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="447768"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>dcm</b></font></font>
</p>
<p>
<a name="455677"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A bit-map representing regions of a volume that is used to track changes to that volume. it is used by VVR for srl overflow protection and automatic secondary synchronization. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="447811"></a><em>plexes</em></font>
</p>
<p>
<a name="455696"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Each volume has between zero and 32 associated plexes. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="447830"></a><em>primary_datavol</em></font>
</p>
<p>
<a name="455715"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A name field. This field is only used with secondary volumes. The value indicates the name of the data volume on the primary to which this data volume corresponds. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="447873"></a><em>read policy</em></font>
</p>
<p>
<a name="455734"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A configurable policy for switching between plexes for volume reads. When a volume has more than one enabled associated plex, VxVM can distribute reads between the plexes to distribute the I/O load and thus increase total possible bandwidth of reads through the volume. The read policy can be set by the administrator.  Possible policies are: </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="447952"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>preferred plex</b></font></font>
</p>
<p>
<a name="455753"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">This read policy specifies a particular named plex that is used to satisfy read requests.  In the event that a read request cannot be satisfied by the preferred plex, this policy changes to round-robin. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="447995"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>round-robin</b></font></font>
</p>
<p>
<a name="455772"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">For every other read operation, distribute the operation across all of the available plexes.  Given three plexes, this switches between each of the three plexes, so each plex gets one third of the read requests. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="448053"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>select</b></font></font>
</p>
<p>
<a name="455791"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">This read policy is the default policy, and adjusts to use an appropriate read policy based on the set of plexes associated with the volume.  If exactly one enabled read-write striped plex is associated with the volume, then that plex is chosen automatically as the preferred plex; otherwise, the round-robin policy is used.  If a volume has one striped plex and one non-striped plex, preferring the striped plex often yields better throughput. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="448144"></a><em>read/write-back recover mode</em></font>
</p>
<p>
<a name="455810"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">This is a mode that applies to the volume, which is managed by utilities as part of plex consistency recovery.  When this mode is enabled, each read operation recovers plex consistency for the region covered by the read.  Plex consistency is recovered by reading data from blocks of one plex and writing that data to all other writable plexes.  This ensures that a future read operation covering the same range of blocks reads the same data. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="448235"></a><em>start options</em></font>
</p>
<p>
<a name="455833"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">This is a string that is organized as a set of usage-type options to apply when starting (enabling) a volume.  See <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxvol</b></font>(1M) for details. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="448278"></a><em>usage type</em></font>
</p>
<p>
<a name="455872"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Each volume has a usage type that defines a particular class of rules for operating on the volume. The usage type is typically based on the expected content of the volume. Several VERITAS Volume Manager utilities can apply extensions or limitations that apply to volumes with a particular usage type. Several basic usage types are included with VxVM: <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>fsgen</b></font>, for use with volumes that contain file systems; <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>gen</b></font>, for use with volumes that are used as swap devices or for other applications that do not use file systems; <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>raid5</b></font>, for use with RAID-5 volumes; and special <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>root</b></font> and <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>swap </b></font>usage types, which are specifically for use with the root file system volume and the primary swap device. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="448441"></a><em>usage-type state</em></font>
</p>
<p>
<a name="455891"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Usage types maintain a private state field related to the volume that relate to operations that have been performed on the volume, or to failure conditions that have been encountered.  This state field contains a string of up to 14 characters. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="448496"></a><em>user</em>|<em>group</em>|<em>mode</em></font>
</p>
<p>
<a name="455922"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">These attributes are the user, group, and file permission modes used for the volume device nodes. The user and group are normally <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>root</b></font>.  The mode usually allows read and write permission to the owner, and no access by other users. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="448563"></a><em>volume kernel state</em></font>
</p>
<p>
<a name="455941"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Each volume is either enabled, disabled, or detached.  When enabled, normal read and write operations are allowed on the volume, and any file system residing on the volume can be mounted, or used in the usual way.  When disabled, no access to the volume or any of its associated plexes is allowed. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="448644"></a><em>write-back-on-read-failure mode</em></font>
</p>
<p>
<a name="455964"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">This is a mode that applies to the volume, which can be enabled or disabled by the administrator using <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxedit</b></font>.  If this mode is enabled, then a read failure for a plex causes data to be read from an alternate plex and then written back to the plex that got the read failure.  This usually fixes the error.  Only if the writeback fails is the plex detached for having an unrecoverable I/O failure. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="448735"></a><em>writecopy mode</em></font>
</p>
<p>
<a name="455987"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">This is a mode that applies to the volume, which can be enabled or disabled by the administrator using <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxedit</b></font>.  This mode takes affect only if dirty region logging or RAID-5 logging is in effect.  When the operating system hands off a write request to the volume driver, the operating system may continue to change the memory that is being written to disk. VxVM cannot detect that the memory is changing, so it can inadvertently leave plexes with inconsistent contents. This is not normally a problem, because the operating system ensures that any such modified memory is rewritten to the volume before the volume is closed (such as by a clean system shutdown).  However, if the system crashes, plexes may be inconsistent.  Since the logging feature prevents recovery of the entire volume, it may not ensure that plexes are entirely consistent. </font>
</p>
<p>
<a name="426308"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Turning on the writecopy mode (which is normally set by default) often causes VxVM to copy the data for a write request to a new section of memory before writing it to disk.  Because the write is done from the copied memory, it cannot change and so the data written to each plex is guaranteed to be the same if the write completes. </font>
</p>
<p>
<a name="426315"></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>vxedit</b></font>(1M) manual page for more information. </font>
</p>

<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="449007"></a> VOLUME USAGE TYPES</font>
</h3>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="449012"></a>The usage type of a volume represents a class of rules for operating on a volume.  Each usage type is defined by a set of executables under the directory <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>/etc/vx/type/</b></font><em>usage_type</em>, where <em>usage_type</em> is the name given to the usage type.  The required executables are: <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxinfo</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxmake</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxmend</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxplex</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxsd</b></font>, and <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxvol</b></font>.  These executables are invoked by VERITAS Volume Manager administrative utilities with the same names.  The executables under <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>/etc/vx/type</b></font> should not, normally, be executed directly. </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="449114"></a>Five usage types are provided with VxVM: <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>gen</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>fsgen</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>root</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>swap</b></font>, and <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>raid5</b></font>. It is possible for third-party products to install additional usage types. </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="449168"></a>The usage types provided with VxVM store state information in the RVG, RLINK, volume, and plex usage-type state fields. </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="449186"></a>The state fields defined for RVGs are: </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="449193"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>EMPTY</b></font></font>
</p>
<p>
<a name="456076"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The RVG is not yet initialized. This is the initial state for RVGs created by vxmake. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="449224"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>CLEAN</b></font></font>
</p>
<p>
<a name="456095"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The RVG has been stopped and contains consistent data. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="449243"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>ACTIVE</b></font></font>
</p>
<p>
<a name="456114"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The RVG has been started and is running normally, or was running when the system was stopped. If the system stops in this state, then the RVG may require RLINK recovery. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="449298"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>FAIL</b></font></font>
</p>
<p>
<a name="456133"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Some problem has been detected with the RVG. It is disabled. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="449316"></a>The state fields defined for RLINKs are: </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="449323"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>UNASSOC</b></font></font>
</p>
<p>
<a name="456152"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The RLINK is not fully initialized. This is the initial state for RLINKs created by vxmake, or which are not currently associated with an RVG. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="449354"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>STALE</b></font></font>
</p>
<p>
<a name="456175"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The RLINK is associated with an RVG, but it is not actively taking part in replication. RLINK requires a full resync before it is up to date, unless the RVG is <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>EMPTY</b></font>. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="449409"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>ACTIVE</b></font></font>
</p>
<p>
<a name="456194"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The RLINK is associated and actively replicating normally, or was when the system was stopped. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="449440"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>PAUSING</b></font></font>
</p>
<p>
<a name="456221"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The RLINK is transitioning to the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>PAUSE</b></font> state, or was doing so when the system was stopped. If the system stops in this state, then the RLINK must be reattached to put it back into the proper <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>PAUSE</b></font> state. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="449507"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>PAUSE</b></font></font>
</p>
<p>
<a name="456256"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The RLINK is paused. If it is a primary (secondary) RLINK and was paused by the pause command, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxrlink pause</b></font>, then it is said to be <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>primary-paused </b></font>(<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>secondary-paused</b></font>). A secondary RLINK can also enter the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>secondary-paused</b></font> state if an error is detected with a secondary log or data volume. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="449586"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>RESTORING</b></font></font>
</p>
<p>
<a name="456279"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Temporary state while RLINK is being restored (see <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxrlink</b></font>(1M) restore sub-command). </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="449617"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>RECOVER</b></font></font>
</p>
<p>
<a name="456306"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Temporary state while RLINK is being recovered with the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxrecover </b></font>utility, which calls <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxrlink recover</b></font>. This state indicates that recovery is still needed. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="449672"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>FAIL</b></font></font>
</p>
<p>
<a name="456325"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Some problem has been detected with the RLINK. It is disabled. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="449690"></a>The state fields defined for volumes are: </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="449697"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>ACTIVE</b></font></font>
</p>
<p>
<a name="456344"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The volume has been started and is running normally, or was running normally when the system was stopped.  If the system crashes in this state, then the volume may require plex consistency recovery. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="449740"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>CLEAN</b></font></font>
</p>
<p>
<a name="456363"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The volume has been stopped and the contents for all plexes are consistent. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="449771"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>EMPTY</b></font></font>
</p>
<p>
<a name="456386"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The volume is not yet initialized.  This is the initial state for volumes created by <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxmake</b></font>. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="449802"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>INVALID</b></font></font>
</p>
<p>
<a name="456405"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The contents of an instant snapshot volume no longer represent a true point-in-time image of the original volume. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="449833"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>NEEDSYNC</b></font></font>
</p>
<p>
<a name="456432"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The volume requires recovery.  This is typically set after a system failure to indicate that the plexes in the volume may be inconsistent, so that they require recovery (see the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>resync</b></font> operation in <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxvol</b></font>(1M)). </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="449888"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>SYNC</b></font></font>
</p>
<p>
<a name="456459"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Plex consistency recovery is currently being done on the volume. <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxvol resync</b></font> sets this state when it starts to recovery plex consistency on a volume that was in the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>NEEDSYNC</b></font> state. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="449930"></a>The state fields defined for plexes are: </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="449937"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>ACTIVE</b></font></font>
</p>
<p>
<a name="456494"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The plex is running normally on a started volume.  The plex condition flags (<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>NODAREC</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>REMOVED</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>RECOVER</b></font>, and <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>IOFAIL</b></font>) may apply if the system is rebooted and the volume restarted. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="449980"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>CLEAN</b></font></font>
</p>
<p>
<a name="456513"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The plex was running normally when the volume was stopped.  The plex is enabled without requiring recovery when the volume is started. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="450011"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>DCOSNP</b></font></font>
</p>
<p>
<a name="456532"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">This state indicates that a data change object (DCO) plex attached to a volume can be used by a snapshot plex to create a DCO volume during a snapshot operation. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="450054"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>EMPTY</b></font></font>
</p>
<p>
<a name="456555"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The plex is not yet initialized.  This state is set when the volume state is also <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>EMPTY</b></font>. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="450085"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>LOG</b></font></font>
</p>
<p>
<a name="456574"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A dirty region logging (DRL) or RAID-5 log plex. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="450104"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>OFFLINE</b></font></font>
</p>
<p>
<a name="456601"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The plex was disabled by the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxmend off</b></font> operation.  See <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxmend</b></font>(1M) for more information. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="450135"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>SNAPATT</b></font></font>
</p>
<p>
<a name="456628"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">This is a snapshot plex that is being attached by the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxassist </b></font>snapstart operation.  When the attach is complete, the state for the plex is changed to <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>SNAPDONE</b></font>.  If the system fails before the attach completes, the plex and all of its subdisks are removed. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="450190"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>SNAPDIS</b></font></font>
</p>
<p>
<a name="456659"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">This is a snapshot plex created by <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxplex snapstart</b></font> that is fully attached.  A plex in this state can be turned into a snapshot volume with <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxplex snapshot</b></font>.  See <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxplex</b></font>(1M) for more information.  If the system fails before the attach completes, the plex is dissociated from the volume. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="450257"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>SNAPDONE</b></font></font>
</p>
<p>
<a name="456690"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">This is a snapshot plex created by <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxassist snapstart</b></font> that is fully attached.  A plex in this state can be turned into a snapshot volume with <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxassist snapshot</b></font>.  See <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxassist</b></font>(1M) for more information.  If the system fails before the attach completes, the plex and all of its subdisks are removed. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="450324"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>SNAPTMP</b></font></font>
</p>
<p>
<a name="456717"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">This is a snapshot plex being attached by the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxplex snapstart </b></font>operation.  When the attach is complete, the state for the plex is changed to <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>SNAPDIS</b></font>.  If the system fails before the attach completes, the plex is dissociated from the volume. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="450379"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>STALE</b></font></font>
</p>
<p>
<a name="456756"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The plex was detached, either by <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxplex det</b></font> or by an I/O failure.  <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxvol start</b></font> changes the state for a plex to <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>STALE</b></font> if any of the plex condition flags are set.  <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>STALE </b></font>plexes are reattached automatically, when starting a volume, by calling <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxplex att</b></font>. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="450446"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>TEMP</b></font></font>
</p>
<p>
<a name="456779"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">This is a plex that is being associated and attached to a volume with <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxplex att</b></font>.  If the system fails before the attach completes, the plex is dissociated from the volume. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="450489"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>TEMPRM</b></font></font>
</p>
<p>
<a name="456802"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">This is a plex that is being associated and attached to a volume with <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxplex att</b></font>.  If the system fails before the attach completes, the plex is dissociated from the volume and removed.  Any subdisks in the plex are kept. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="450544"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>TEMPRMSD</b></font></font>
</p>
<p>
<a name="456825"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">This is a plex that is being associated and attached to a volume with <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxplex att</b></font>.  If the system fails before the attach completes, the plex and its subdisks are dissociated from the volume and removed. </font>
</p>

<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="450586"></a> EXIT CODES</font>
</h3>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="450591"></a>The majority of VERITAS Volume Manager utilities use a common set of exit codes, which can be used by shell scripts or other types of programs to react to specific problems detected by the utilities. The number for each distinct exit code is described below. </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="450658"></a>0</font>
</p>
<p>
<a name="456840"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The utility is not reporting any error through the exit code. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="450677"></a>1</font>
</p>
<p>
<a name="456855"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Some command line arguments to the utility were invalid. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="450696"></a>2</font>
</p>
<p>
<a name="456870"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A syntax error occurred in a command or description, or a specified record name is too long or contains invalid characters.  This code is returned only by utilities that implement a command or description language.  This code may also be returned for errors in search patterns. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="450763"></a>3</font>
</p>
<p>
<a name="456885"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The volume daemon does not appear to be running. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="450782"></a>4</font>
</p>
<p>
<a name="456900"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">An unexpected error was encountered while communicating with the volume daemon. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="450813"></a>5</font>
</p>
<p>
<a name="456915"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">An unexpected error was returned by a system call or by the C library. This can also indicate that the utility ran out of memory. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="450844"></a>6</font>
</p>
<p>
<a name="456930"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The status for a commit was lost because the volume daemon was killed and restarted during the commit of a transaction, but after restart the volume daemon did not know whether the commit succeeded or failed. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="450887"></a>7</font>
</p>
<p>
<a name="456945"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The utility encountered an error that it should not have encountered. This generally implies a condition that the utility should have tested for but did not, or a condition that results from the volume daemon returning a value that did not make sense. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="450942"></a>8</font>
</p>
<p>
<a name="456960"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The time required to complete a transaction exceeded 60 seconds, causing the transaction locks to be lost.  As most utilities reattempt the transaction at least once if a timeout occurs, this usually implies that a transaction timed out two or more times. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="450997"></a>9</font>
</p>
<p>
<a name="456975"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">No disk group could be identified for an operation.  This results either from naming a disk group that does not exist, or from supplying names on a command line that are in different disk groups or in multiple disk groups. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="451052"></a>10</font>
</p>
<p>
<a name="456990"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A change made to the database by another process caused the utility to stop.  This code is also returned by a usage-type-dependent utility if it is given a record that is associated with a different usage type. If this situation occurs when the usage-type-dependent utility is called from a switchout utility, then the database was changed after the switchout utility determined the proper usage type to invoke. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="451131"></a>11</font>
</p>
<p>
<a name="457005"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A requested subdisk, plex, or volume record was not found in the configuration database.  This may also mean that a record was an inappropriate type. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="451174"></a>12</font>
</p>
<p>
<a name="457020"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A name used to create a new configuration record matches the name of an existing record. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="451205"></a>13</font>
</p>
<p>
<a name="457039"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A subdisk, plex, or volume is locked against concurrent access.  This code is used for inter-transaction locks associated with usage type utilities.  The code is also used for the dissociated plex or subdisk lock convention, which writes a non-blank string to the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>tutil[0] </b></font>field in a plex or subdisk structure to indicate that the record is being used. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="451284"></a>14</font>
</p>
<p>
<a name="457054"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">No usage type could be determined for a utility that requires a usage type. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="451315"></a>15</font>
</p>
<p>
<a name="457069"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">An unknown or invalid usage type was specified. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="451334"></a>16</font>
</p>
<p>
<a name="457084"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A plex or subdisk is associated, but the operation requires a dissociated record. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="451365"></a>17</font>
</p>
<p>
<a name="457099"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A plex or subdisk is dissociated, but the operation requires an associated record.  This code can also be used to indicate that a subdisk or plex is not associated with a specific plex or volume. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="451408"></a>18</font>
</p>
<p>
<a name="457114"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A plex or subdisk was not dissociated because it was the last record associated with a volume or plex. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="451439"></a>19</font>
</p>
<p>
<a name="457129"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Association of a plex or subdisk would surpass the maximum number that can be associated to a volume or plex. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="451470"></a>20</font>
</p>
<p>
<a name="457144"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A specified operation is invalid within the parameters specified. For example, this code is returned when an attempt is made to split a subdisk on a striped plex, or to use a split size that is greater than the size of the plex. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="451537"></a>21</font>
</p>
<p>
<a name="457159"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">An I/O error was encountered that caused the utility to abort an operation. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="451568"></a>22</font>
</p>
<p>
<a name="457174"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A volume involved in an operation did not have any associated plexes, although at least one was required. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="451599"></a>23</font>
</p>
<p>
<a name="457189"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A plex involved in an operation did not have any associated subdisks, although at least one was required. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="451630"></a>24</font>
</p>
<p>
<a name="457208"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A volume could not be started by the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxvol start</b></font> operation, because the configuration of the volume and its plexes prevented the operation. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="451673"></a>25</font>
</p>
<p>
<a name="457223"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A specified volume was already started. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="451692"></a>26</font>
</p>
<p>
<a name="457242"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A specified volume was not started.  For example, this code is returned by the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxvol stop</b></font> operation if the operation is given a volume that is not started. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="451735"></a>27</font>
</p>
<p>
<a name="457257"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A volume or plex involved in an operation is in the detached state, thus preventing a successful operation. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="451766"></a>28</font>
</p>
<p>
<a name="457272"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A volume or plex involved in an operation is in the disabled state, thus preventing a successful operation. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="451797"></a>29</font>
</p>
<p>
<a name="457287"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A volume or plex involved in an operation is in the enabled state, thus preventing a successful operation. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="451828"></a>30</font>
</p>
<p>
<a name="457302"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">An unknown error condition was encountered. This code may be used, for example, when the volume daemon returns an unrecognized error number. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="451871"></a>31</font>
</p>
<p>
<a name="457317"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">An operation failed because a volume device was open or mounted, or because a subdisk was associated with an open or mounted volume or plex. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="451914"></a>32</font>
</p>
<p>
<a name="457332"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A problem occurred with multipath coordination. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="451933"></a>33</font>
</p>
<p>
<a name="457347"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">An object was already reserved for use by the operating system. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="451952"></a>35</font>
</p>
<p>
<a name="457362"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">An error occurred while communicating with a remote host. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="451971"></a>39</font>
</p>
<p>
<a name="457377"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">An error occurred because the offset or length of a VxVM object is not an integral multiple of the alignment value for the disk group. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="452002"></a>65</font>
</p>
<p>
<a name="457392"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">An array-related API failed. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="452021"></a>66</font>
</p>
<p>
<a name="457407"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">An array-specific guideline was violated. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="452040"></a>67</font>
</p>
<p>
<a name="457422"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Inconsistent configuration copies are present in a disk group. This may indicate a serial split brain condition. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="452071"></a>68</font>
</p>
<p>
<a name="457437"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">FastResync is not enabled on a volume. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="452090"></a>69</font>
</p>
<p>
<a name="457452"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A volume has a bad Data Change Object (DCO). </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="452109"></a>70</font>
</p>
<p>
<a name="457467"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A snapshot volume is invalid. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="452128"></a>71</font>
</p>
<p>
<a name="457482"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A Replicated Volume Group (RVG) has not been started. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="452146"></a>Exit codes greater than 32 are reserved for use by usage types. Codes greater than 64 are reserved for use by specific utilities. </font>
</p>


<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="452164"></a> SEE ALSO</font>
</h3>
<blockquote>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="452169"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>mount</b></font>(1M), <a href="vxassist_vxvm_manpages14_458378.html#441128"><font color="#0000ff"><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxassist </b></font></font></a>(1M), <a href="vxcache_vxvm_manpages17_429232.html#427933"><font color="#0000ff"><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxcache </b></font></font></a>(1M), <a href="vxcached_vxvm_manpages18_427367.html#426743"><font color="#0000ff"><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxcached </b></font></font></a>(1M), <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="vxclustadm_vxvm_manpages21_430807.html#428885"><font color="#0000ff"><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxclustadm </b></font></font></a>(1M), <a href="vxcmdlog_vxvm_manpages22_427988.html#427205"><font color="#0000ff"><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxcmdlog </b></font></font></a>(1M), <a href="vxconfigbackup_vxvm_manpages23_426890.html#426512"><font color="#0000ff"><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxconfigbackup </b></font></font></a>(1M), <a href="vxconfigbackupd_vxvm_manpages24_426704.html#426407"><font color="#0000ff"><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxconfigbackupd </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="vxconfigrestore_vxvm_manpages26_427919.html#427114"><font color="#0000ff"><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxconfigrestore </b></font></font></a>(1M), <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxconvert</b></font>(1M), <a href="vxdctl_vxvm_manpages30_431266.html#429207"><font color="#0000ff"><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxdctl </b></font></font></a>(1M), <a href="vxdco_vxvm_manpages29_427826.html#427002"><font color="#0000ff"><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxdco </b></font></font></a>(1M), <a href="vxddladm_vxvm_manpages31_429772.html#428311"><font color="#0000ff"><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxddladm </b></font></font></a>(1M), <a href="vxdg_vxvm_manpages33_443062.html#434590"><font color="#0000ff"><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxdg </b></font></font></a>(1M), <a href="vxdisk_vxvm_manpages34_439794.html#433127"><font color="#0000ff"><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxdisk </b></font></font></a>(1M), <a href="vxdiskadd_vxvm_manpages35_427929.html#426960"><font color="#0000ff"><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxdiskadd </b></font></font></a>(1M), <a href="vxdiskadm_vxvm_manpages36_430557.html#428346"><font color="#0000ff"><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxdiskadm </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), <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxdiskunsetup</b></font>(1M), <a href="vxdmpadm_vxvm_manpages39_437119.html#432119"><font color="#0000ff"><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxdmpadm </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="vxevac_vxvm_manpages42_426831.html#426470"><font color="#0000ff"><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxevac </b></font></font></a>(1M), <a href="vxinfo_vxvm_manpages45_429919.html#428227"><font color="#0000ff"><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxinfo </b></font></font></a>(1M), <a href="vxinstall_vxvm_manpages46_427052.html#426596"><font color="#0000ff"><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxinstall </b></font></font></a>(1M), <a href="vxiod_vxvm_manpages48_427282.html#426722"><font color="#0000ff"><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxiod </b></font></font></a>(1M), <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxlicinst</b></font>(1), <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxlicrep</b></font>(1), <a href="vxmake_vxvm_manpages50_437196.html#431699"><font color="#0000ff"><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxmake </b></font></font></a>(1M), <a href="vxmend_vxvm_manpages52_430893.html#428626"><font color="#0000ff"><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxmend </b></font></font></a>(1M), <a href="vxmirror_vxvm_manpages53_427987.html#427135"><font color="#0000ff"><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxmirror </b></font></font></a>(1M), <a href="vxnotify_vxvm_manpages54_430651.html#428549"><font color="#0000ff"><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxnotify </b></font></font></a>(1M), <a href="vxplex_vxvm_manpages56_438209.html#431636"><font color="#0000ff"><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxplex </b></font></font></a>(1M), <a href="vxpool_vxvm_manpages57_430997.html#428913"><font color="#0000ff"><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxpool </b></font></font></a>(1M), <a href="vxprint_vxvm_manpages58_439087.html#433463"><font color="#0000ff"><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxprint </b></font></font></a>(1M), <a href="vxr5check_vxvm_manpages59_427269.html#426694"><font color="#0000ff"><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxr5check </b></font></font></a>(1M), <a href="vxreattach_vxvm_manpages60_427381.html#426799"><font color="#0000ff"><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxreattach </b></font></font></a>(1M), <a href="vxrecover_vxvm_manpages61_429816.html#428010"><font color="#0000ff"><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxrecover </b></font></font></a>(1M), <a href="vxrelayout_vxvm_manpages62_430115.html#428262"><font color="#0000ff"><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxrelayout </b></font></font></a>(1M), <a href="vxrelocd_vxvm_manpages63_431606.html#429130"><font color="#0000ff"><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxrelocd </b></font></font></a>(1M), <a href="vxresize_vxvm_manpages65_428209.html#427289"><font color="#0000ff"><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxresize </b></font></font></a>(1M), <a href="vxrlink_vxvm_manpages66_433229.html#429788"><font color="#0000ff"><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxrlink </b></font></font></a>(1M), <a href="vxrvg_vxvm_manpages68_434599.html#430474"><font color="#0000ff"><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxrvg </b></font></font></a>(1M), <a href="vxsd_vxvm_manpages69_433542.html#429949"><font color="#0000ff"><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxsd </b></font></font></a>(1M), <a href="vxsparecheck_vxvm_manpages73_429800.html#428311"><font color="#0000ff"><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxsparecheck </b></font></font></a>(1M), <a href="vxsnap_vxvm_manpages72_441468.html#434380"><font color="#0000ff"><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxsnap </b></font></font></a>(1M), <a href="vxsplitlines_vxvm_manpages74_427039.html#426631"><font color="#0000ff"><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxsplitlines </b></font></font></a>(1M), <a href="vxstat_vxvm_manpages75_430625.html#428584"><font color="#0000ff"><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxstat </b></font></font></a>(1M), <a href="vxtask_vxvm_manpages76_430825.html#428703"><font color="#0000ff"><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxtask </b></font></font></a>(1M), <a href="vxtemplate_vxvm_manpages77_430919.html#429032"><font color="#0000ff"><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxtemplate </b></font></font></a>(1M), <a href="vxtrace_vxvm_manpages78_430557.html#428493"><font color="#0000ff"><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxtrace </b></font></font></a>(1M), <a href="vxtranslog_vxvm_manpages79_428018.html#427205"><font color="#0000ff"><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxtranslog </b></font></font></a>(1M), <a href="vxusertemplate_vxvm_manpages82_427350.html#426876"><font color="#0000ff"><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxusertemplate </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), <a href="vxvoladm_vxvm_manpages86_449788.html#438699"><font color="#0000ff"><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxvoladm </b></font></font></a>(1M), <a href="vxvoladmtask_vxvm_manpages87_427222.html#426778"><font color="#0000ff"><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxvoladmtask </b></font></font></a>(1M), <a href="vxvset_vxvm_manpages88_429763.html#428038"><font color="#0000ff"><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxvset </b></font></font></a>(1M) </font>
</blockquote>
<blockquote>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="453036"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>ioctl</b></font>(2) </font>
</blockquote>
<blockquote>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="453048"></a><a href="vol_pattern_vxvm_manpages90_440877.html#434282"><font color="#0000ff"><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vol_pattern </b></font></font></a>(4), <a href="vxmake_vxvm_manpages91_450355.html#437313"><font color="#0000ff"><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxmake </b></font></font></a>(4) </font>
</blockquote>
<blockquote>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="453075"></a><a href="vxio_vxvm_manpages97_432321.html#429109"><font color="#0000ff"><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxio </b></font></font></a>(7), <a href="vxinfo_vxvm_manpages45_429919.html#428227"><font color="#0000ff"><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxinfo </b></font></font></a>(7) </font>
</blockquote>
<blockquote>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="453103"></a>For information about new features of VxVM, see the <em>Release Notes</em>. </font>
</blockquote>
<blockquote>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="453130"></a>For information about VxVM features and administering VxVM, see the <em>VERITAS Volume Manager Administrator's Guide</em> and the <em>VERITAS Storage Foundation Intelligent Storage Provisioning </em>Administrator's Guide. </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="vxintro_vxvm_manpages47_452164.html" title="vxintro">Return to Top</a></font>

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