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

</HEAD>

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

<a name="428773"></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="vxtunefs_vxfs_manpages38_435201.html" title="Previous - vxtunefs">Previous</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">Product:  
<a href="vxfs_manpages_splashpage_docCD_vxfs_manpages1_103036.vxhd" title="File System Manual Pages for Storage Foundation title page ">File System 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_vxfs_manpages8_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="427359"></a>vxupgrade</font>
</h2>

        

<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="427389"></a> NAME</font>
</h3>
<p>
<a name="427394"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">vxupgrade - upgrade the disk layout of a mounted VxFS file system </font>
</p>

<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="427397"></a> SYNOPSIS</font>
</h3>
<br>
<font face="Courier, Courier New, sansserif, sans serif" size="2"><a name="427402"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxupgrade</b></font> [ <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-n </b></font><em>new_version </em>] [ <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-r </b></font><em>rawdev </em>] <em>mount_point</em> 
</font>

<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="427456"></a> AVAILABILITY</font>
</h3>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="427461"></a>VRTSvxfs </font>
</p>


<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="427464"></a> DESCRIPTION</font>
</h3>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="427469"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxupgrade </b></font>prints the current disk layout version number for a VERITAS file system or upgrades the file system to a new disk layout. <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxupgrade </b></font>operates on file systems mounted for read/write access: <em>mount_point </em>must be a mounted VxFS file system. You cannot upgrade directly from the oldest disk layout version to the newest disk layout version; you must upgrade to the next level disk layout first. </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="427563"></a>Only a privileged user can query or upgrade a VxFS file system. </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="427566"></a>When invoked with the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-n </b></font>option, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxupgrade </b></font>upgrades the disk layout to the specified version. When invoked without the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-n </b></font>option, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxupgrade </b></font>prints the disk layout version number of the file system. To perform an upgrade, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxupgrade </b></font>freezes the file system, allocates and initializes the new structures, frees the space used by the old structures, then thaws the file system. </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="427705"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxupgrade </b></font>employs a lock file ( <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>lost+found/.fsadm </b></font>) on the file system to ensure that only one instance of <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxupgrade </b></font>is running at any time. <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxupgrade </b></font>and <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>fsadm </b></font>cannot run simultaneously, so the lock file also ensures that <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxupgrade </b></font>does not execute while a file system reorganization is in progress. When <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxupgrade </b></font>is invoked for an upgrade, it opens the lock file in the root of the file system specified by <em>mount_point</em>. If the lock file does not exist, it is created. The <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>fcntl</b></font>(2) system call is used to obtain a write lock on the file. If the write lock fails, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxupgrade </b></font>fails, assuming that another <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxupgrade </b></font>or <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>fsadm </b></font>is running. </font>
</p>


<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="428053"></a> NOTES</font>
</h3>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="428058"></a>Disk layout versions cannot be downgraded. </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="428061"></a>Upgrading to disk layout Version 6 changes all inodes in the file system. A file system with disk layout Version 5 can be mounted and upgraded to Version 6 disk layout. </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="428092"></a>To upgrade from Version 4 disk layout to Version 6, you must upgrade to Version 5 first. This requires two separate invocations of the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxupgrade </b></font>command. The upgrade may fail due to lack of free space at each step (see <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>Free Space Requirement </b></font>below). </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="428167"></a>Optionally, prior to upgrading a file system to disk layout Version 6, delete all existing Storage Checkpoints. A Storage Checkpoint created on a file system with a disk layout prior to Version 6 stores a complete copy of the inodes at the time it was taken. Thus, a file system with one Storage Checkpoint takes approximately twice as long to upgrade as a file system without Storage Checkpoints. Conversely, a Storage Checkpoint created on a file system with disk layout Version 6 or later stores only the inodes of files whose data blocks were modified. As a result, the time required to upgrade the disk layout Version in the future is less affected by the number of Storage Checkpoints on the file system. </font>
</p>


<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="428287"></a> CLUSTER FILE SYSTEM ISSUES</font>
</h3>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="428292"></a>Cluster mounted file systems can be upgraded only from the primary. </font>
</p>


<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="428295"></a> DIAGNOSTICS</font>
</h3>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="428300"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxupgrade </b></font>returns an exit value of 0 if the upgrade is successful. <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxupgrade </b></font>returns 1 if the upgrade fails due to insufficient free space, returns 32 if the specified mount point is not a VxFS file system, and returns 2 if the upgrade fails for another reason. </font>
</p>


<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="428348"></a> OPTIONS</font>
</h3>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="428354"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-n </b></font><em>&quot; </em><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>new_version&quot;</b></font></font>
</p>
<p>
<a name="428983"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Disk layout version number to which to upgrade. <em>new_version</em> can be 5 or 6. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="428389"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-r </b></font><em>&quot; </em><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>rawdev&quot;</b></font></font>
</p>
<p>
<a name="429006"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Path name of a raw device. This option can be used when <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxupgrade </b></font>cannot determine which raw device corresponds to the mount point (when <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>/etc/mnttab </b></font>is corrupted, for example). </font>
</p>

<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="428476"></a> FREE SPACE REQUIREMENT</font>
</h3>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="428481"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxupgrade </b></font>requires free space on the file system to perform the upgrade; the upgrade may fail if there is not enough free space. It is difficult to determine the exact amount of space required to upgrade a VxFS file system, but you can estimate the maximum space required. </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="428529"></a>Typically, upgrading a disk layout Version 4 file system to disk layout Version 5 does not require much extra disk space. </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="428550"></a>The space and time required to complete the upgrade increases with the number of extended attributes or hard links in the file system. Typical maximum space to convert to a Version 6 disk layout is at least two additional inodes with one block for every inode. The number of inodes is the sum total of inodes across all filesets in the file system (see the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>fsdb_vxfs</b></font>(1M) manual page for information on how to obtain the number of inodes in a fileset). Allow at least ten minutes to upgrade for every million inodes in the file system. </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="428652"></a><b>Note  &nbsp;&nbsp;</b>
</font>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2" color="#000000"> Upgrading requires free extents of 8K or greater in size. If a file system has sufficient free space, but no extents greater than or equal to 8K, the upgrade will fail. To ensure that there are 8K extents available, defragment the file system (see the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>fsadm_vxfs</b></font>(1M) manual page for information on how to obtain the number of free extents in a file system and how to defragment a file system). 
</font>
<hr noshade size="2" width="100%" color="#000000">

<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="428754"></a> FILES</font>
</h3>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="428760"></a><em>mount_point </em><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>/lost+found/.fsadm</b></font></font>
</p>
<p>
<a name="429038"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Lock file. </font>
</p>

<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="428773"></a> SEE ALSO</font>
</h3>
<blockquote>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="428778"></a><a href="fsadm_vxfs_vxfs_manpages12_440823.html#433586"><font color="#0000ff"><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>fsadm_vxfs </b></font></font></a>(1M), <a href="fsdb_vxfs_vxfs_manpages21_426511.html#426246"><font color="#0000ff"><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>fsdb_vxfs </b></font></font></a>(1M), <a href="mkfs_vxfs_vxfs_manpages28_430999.html#428444"><font color="#0000ff"><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>mkfs_vxfs </b></font></font></a>(1M), <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>quotaon</b></font>(1M), <a href="vxfsconvert_vxfs_manpages34_433690.html#429958"><font color="#0000ff"><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxfsconvert </b></font></font></a>(1M), <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>fcntl</b></font>(2), <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>fs</b></font>(4), <a href="vxfsio_vxfs_manpages98_436668.html#430964"><font color="#0000ff"><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxfsio </b></font></font></a>(7) </font>
</blockquote>
<blockquote>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="428871"></a><em>VERITAS File System Administrator's Guide </em></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="vxupgrade_vxfs_manpages39_428773.html" title="vxupgrade">Return to Top</a></font>

  </td>
  <td align="right"><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="-2">&lt;&nbsp;<a href="vxtunefs_vxfs_manpages38_435201.html" title="Previous - vxtunefs">Previous</a>&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="vxfs_manpages_splashpage_docCD_vxfs_manpages1_103036.vxhd" title="File System Manual Pages for Storage Foundation title page ">File System 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_vxfs_manpages8_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>
