<!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="vx_vxhelp_2005c">
<meta name="LASTUPDATED" content="06/17/05 09:52:26">
<meta name="PRODUCTNAME" content="VERITAS Software Documentation">
<meta name="FILENAME" content="07_cfs_admin.fm">
     
<title>CFS Administration</title>

</HEAD>

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

<a name="165397"></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="07_cfs_admin_sfcfs39_165304.html" title="Previous - CFS Overview">Previous</a>&nbsp;&nbsp;|&nbsp;&nbsp;<a href="07_cfs_admin_sfcfs41_165460.html" title="Next - Snapshots on CFS">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="sfcfs_splashpage_docCD_sfcfs1_103036.vxhd" title="Storage Foundation Cluster File System Guides title page ">Storage Foundation Cluster File System Guides</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="sfcfs_iag_titlepage_docCD_sfcfs2_73700.vxhd" title="Cluster File System 4.1 Installation and Administration Guide title page ">Cluster File System 4.1 Installation and Administration Guide</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>
	
<h1><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="+1" color="#000000"><a name="165397"></a> CFS Administration</font>
</h1>
         
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="165398"></a>This section describes some of the major aspects of cluster file system administration and the ways in which it differs from single-host VxFS administration.</font>
</p>




<h2><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="3" color="#000000"><a name="165400"></a>CFS Resource Management Commands</font>
</h2>
 
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="165402"></a>To make resources easier to manage, five CFS administrative commands were introduced in this release. The commands are:</font>
</p>

<p>
<ul type="disc"><li><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="165404"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">cfscluster</font>---cluster configuration command</font>
</li>
<li><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="165406"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">cfsmntadm</font>---adds, deletes, modifies, and sets policy on cluster mounted file systems</font>
</li>
<li><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="165408"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">cfsdgadm</font>---adds or deletes shared disk groups to/from a cluster configuration</font>
</li>
<li><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="165409"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">cfsmount</font>/<font face="Courier New, Courier, sansserif, sans serif" size="2">cfsumount</font>---mounts/unmounts a cluster file system on a shared volume</font>
</li>
</ul>
</p>



<h2><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="3" color="#000000"><a name="165414"></a>CFS Commands</font>
</h2>
 
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="165416"></a>The <font face="Courier New, Courier, sansserif, sans serif" size="2">mount</font> and <font face="Courier New, Courier, sansserif, sans serif" size="2">fsclustadm</font> commands are also important for configuring cluster file systems.</font>
</p>




<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000"><a name="165417"></a>mount</font>
</h3>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="165418"></a>The <font face="Courier New, Courier, sansserif, sans serif" size="2">mount</font> command with the <font face="Courier New, Courier, sansserif, sans serif" size="2">&#8211;o</font> <font face="Courier New, Courier, sansserif, sans serif" size="2">cluster</font> option lets you access shared file systems. See the <font face="Courier New, Courier, sansserif, sans serif" size="2">mount_vxfs</font>(1M) manual page for information on allowable mount options.</font>
</p>




<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000"><a name="165419"></a>fsclustadm</font>
</h3>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="165420"></a>The <font face="Courier New, Courier, sansserif, sans serif" size="2">fsclustadm</font> command reports various attributes of a cluster file system. Using <font face="Courier New, Courier, sansserif, sans serif" size="2">fsclustadm</font> you can show and set the primary node in a cluster, translate node IDs to host names and vice versa, list all nodes that currently have a cluster mount of the specified file system mount point, and determine whether a mount is a local or cluster mount. The <font face="Courier New, Courier, sansserif, sans serif" size="2">fsclustadm</font> command operates from any node in a cluster on which the file system is mounted, and can control the location of the primary for a specified mount point. See the <font face="Courier New, Courier, sansserif, sans serif" size="2">fsclustadm</font>(1M) manual page for information on usage.</font>
</p>




<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000"><a name="165421"></a>fsadm</font>
</h3>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="165422"></a>The <font face="Courier New, Courier, sansserif, sans serif" size="2">fsadm</font> command must be run from the primary node; it fails if invoked on secondaries. See the <font face="Courier New, Courier, sansserif, sans serif" size="2">fsadm</font>(1M) manual page for information on allowable mount options.</font>
</p>




<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000"><a name="165423"></a>Running Commands Safely in a Cluster Environment</font>
</h3>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="165424"></a>Any UNIX command that can write to a raw device must be used carefully in a shared environment to prevent data from being corrupted. For shared VxVM volumes, CFS provides protection by reserving the volumes in a cluster to prevent VxFS commands, such as <font face="Courier New, Courier, sansserif, sans serif" size="2">fsck</font> and <font face="Courier New, Courier, sansserif, sans serif" size="2">mkfs</font>, from inadvertently damaging a mounted file system from another node in a cluster. However, commands such as <font face="Courier New, Courier, sansserif, sans serif" size="2">dd</font> execute without any reservation, and can damage a file system mounted from another node. Before running this kind of command on a file system, be sure the file system is not mounted on a cluster. You can run the <font face="Courier New, Courier, sansserif, sans serif" size="2">mount</font> command to see if a file system is a shared or local mount.</font>
</p>




<h2><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="3" color="#000000"><a name="165425"></a>Time Synchronization for Cluster File Systems</font>
</h2>
 
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="165427"></a>CFS requires that the system clocks on all nodes are synchronized using some external component such as the Network Time Protocol (NTP) daemon. If the nodes are not in sync, timestamps for creation (<font face="Courier New, Courier, sansserif, sans serif" size="2">ctime</font>) and modification (<font face="Courier New, Courier, sansserif, sans serif" size="2">mtime</font>) may not be consistent with the sequence in which operations actually happened.</font>
</p>




<h2><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="3" color="#000000"><a name="165428"></a>Growing a Cluster File System</font>
</h2>
 
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="165429"></a>There is a master node for CVM as well as a primary for CFS. When growing a file system, you grow the volume from the CVM master, and then grow the file system from the CFS primary. The CVM master and the CFS primary can be two different nodes. To determine the primary file system in a cluster, enter:</font>
</p>

<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="165431"></a>&nbsp;#&nbsp;<font face="Courier New, Courier, sansserif, sans serif" size="2"><b>fsclustadm&nbsp;&#8211;v&nbsp;showprimary&nbsp;</b></font><font face="Courier New, Courier, sansserif, sans serif" size="2"><b>mount_point</b></font>
</font>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="165432"></a>To determine if the current node is the master CVM node, enter:</font>
</p>

<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="165433"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;</font><font face="Courier New, Courier, sansserif, sans serif" size="2"><b>vxdctl&nbsp;-c&nbsp;mode</b></font>
</font>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="165437"></a>To actually increase the size of the file system, run the following two commands. On the master CVM node, enter:</font>
</p>

<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="165438"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;</font><font face="Courier New, Courier, sansserif, sans serif" size="2"><b>vxassist&nbsp;&#8211;g&nbsp;</b></font><font face="Courier New, Courier, sansserif, sans serif" size="2"><b>shared_disk_group</b></font><font face="Courier New, Courier, sansserif, sans serif" size="2"><b>&nbsp;growto&nbsp;</b></font><font face="Courier New, Courier, sansserif, sans serif" size="2"><b>volume_name</b></font><font face="Courier New, Courier, sansserif, sans serif" size="2"><b>&nbsp;</b></font><font face="Courier New, Courier, sansserif, sans serif" size="2"><b>newlength</b></font>
</font>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="165439"></a>On the CFS primary, enter:</font>
</p>

<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="165440"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;</font><font face="Courier New, Courier, sansserif, sans serif" size="2"><b>fsadm&nbsp;&#8211;F&nbsp;vxfs&nbsp;&#8211;b&nbsp;</b></font><font face="Courier New, Courier, sansserif, sans serif" size="2"><b>newsize</b></font><font face="Courier New, Courier, sansserif, sans serif" size="2"><b>&nbsp;&#8211;r&nbsp;</b></font><font face="Courier New, Courier, sansserif, sans serif" size="2"><b>device_name&nbsp;mount_point</b></font>
</font>



<h2><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="3" color="#000000"><a name="165445"></a>The fstab File</font>
</h2>
 
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="165447"></a>In the <font face="Courier New, Courier, sansserif, sans serif" size="2">/etc/fstab</font> file, do not specify any cluster file systems to mount-at-boot because mounts initiated from <font face="Courier New, Courier, sansserif, sans serif" size="2">fstab</font> occur before cluster configuration begins. For cluster mounts, use the VCS configuration file to determine which file systems to enable following a reboot.</font>
</p>




<h2><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="3" color="#000000"><a name="165449"></a>Distributing the Load on a Cluster</font>
</h2>
 
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="165451"></a>Distributing the workload in a cluster provides performance and failover advantages. Because each cluster mounted file system can have a different node as its primary, CFS lets you easily distribute the load in a cluster.</font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="165452"></a>For example, if you have eight file systems and four nodes, designating two file systems per node as the primary would be beneficial. Primaryship is determined by which node first mounts the file system. You can also use the <font face="Courier New, Courier, sansserif, sans serif" size="2">fsclustadm</font> to designate a CFS primary. The <font face="Courier New, Courier, sansserif, sans serif" size="2">fsclustadm</font> <font face="Courier New, Courier, sansserif, sans serif" size="2">setprimary</font> command can also define the order in which primaryship is assumed if the current primary fails. After setup, the policy is in effect as long as one or more nodes in the cluster have the file system mounted.</font>
</p>




<h2><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="3" color="#000000"><a name="165454"></a>Using GUIs</font>
</h2>
 
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="165456"></a>Use the VERITAS Enterprise Administrator (VEA) for various VxFS functions such as making and mounting file systems, on both local and cluster file systems. </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="165457"></a>With SFCFS HA, you can use the VCS Cluster Manager GUI to configure and monitor CFS. The VCS GUI provides log files for debugging LLT and GAB events.</font>
</p>


<!-- 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="07_cfs_admin_sfcfs40_165397.html" title="CFS Administration">Return to Top</a></font>

  </td>
  <td align="right"><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="-2">&lt;&nbsp;<a href="07_cfs_admin_sfcfs39_165304.html" title="Previous - CFS Overview">Previous</a>&nbsp;&nbsp;|&nbsp;&nbsp;<a href="07_cfs_admin_sfcfs41_165460.html" title="Next - Snapshots on CFS">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="sfcfs_splashpage_docCD_sfcfs1_103036.vxhd" title="Storage Foundation Cluster File System Guides title page ">Storage Foundation Cluster File System Guides</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="sfcfs_iag_titlepage_docCD_sfcfs2_73700.vxhd" title="Cluster File System 4.1 Installation and Administration Guide title page ">Cluster File System 4.1 Installation and Administration Guide</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>
