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

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

</HEAD>

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

<a name="430807"></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="vxchg_rootid_vxvm_manpages20_431342.html" title="Previous - vxchg_rootid">Previous</a>&nbsp;&nbsp;|&nbsp;&nbsp;<a href="vxcmdlog_vxvm_manpages22_427988.html" title="Next - vxcmdlog">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="428885"></a>vxclustadm</font>
</h2>

        

<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="428908"></a> NAME</font>
</h3>
<p>
<a name="428913"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">vxclustadm - start, stop, and reconfigure a cluster </font>
</p>

<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="428916"></a> SYNOPSIS</font>
</h3>
<br>
<font face="Courier, Courier New, sansserif, sans serif" size="2"><a name="428921"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxclustadm abortnode </b></font>
</font>
<br>
<font face="Courier, Courier New, sansserif, sans serif" size="2"><a name="428924"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxclustadm nidmap </b></font>
</font>
<br>
<font face="Courier, Courier New, sansserif, sans serif" size="2"><a name="428927"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxclustadm</b></font> [<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-v</b></font>] <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>nodestate </b></font>
</font>
<br>
<font face="Courier, Courier New, sansserif, sans serif" size="2"><a name="428930"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxclustadm -m</b></font> {<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>hpsg</b></font>|<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vcs</b></font>} <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>reinit </b></font>
</font>
<br>
<font face="Courier, Courier New, sansserif, sans serif" size="2"><a name="428933"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxclustadm -m hpsg -C</b></font> <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>cluster_name -t</b></font> <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>hpsg <br></b></font>[<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-j</b></font> <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>join_timeout</b></font>] <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>startnode </b></font>
</font>
<br>
<font face="Courier, Courier New, sansserif, sans serif" size="2"><a name="428957"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxclustadm -m</b></font> <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vcs -t</b></font> <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>gab</b></font> <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>startnode </b></font>
</font>
<br>
<font face="Courier, Courier New, sansserif, sans serif" size="2"><a name="428969"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxclustadm -m</b></font> <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vcs -C</b></font> <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>cluster_name -t</b></font> <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>gab </b></font>[<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-j</b></font> <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>join_timeout</b></font>] <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>startnode </b></font>
</font>
<br>
<font face="Courier, Courier New, sansserif, sans serif" size="2"><a name="429008"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxclustadm stopnode </b></font>
</font>

<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="429011"></a> DESCRIPTION</font>
</h3>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="429016"></a>The <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxclustadm</b></font> utility activates and deactivates cluster functionality on a node in a cluster. </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="429038"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>Caution:</b></font> Use of the clustering functionality of VxVM without a cluster monitor is not supported. Cluster reconfiguration problems may occur if there is no cluster monitor or if GAB is used as the cluster monitor. Ensure that you completely understand the functionality of this command before using it. </font>
</p>


<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="429095"></a> KEYWORDS</font>
</h3>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="429101"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>abortnode</b></font></font>
</p>
<p>
<a name="431058"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Stops clustering activity on a node and abandons all uncompleted I/O on shared volumes. This command is for emergency shutdown. </font>
</p>
<p>
<a name="425036"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>Note:</b></font> This operation is not allowed in the HP Serviceguard environment. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="429148"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>nidmap</b></font></font>
</p>
<p>
<a name="431084"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Prints a table showing the mapping between node IDs in VxVM's cluster-support subsystem and node IDs in the cluster monitor. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="429170"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>nodestate</b></font></font>
</p>
<p>
<a name="431103"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Displays the state of a node in the cluster and the reason for last abort of the node on the standard output. Valid states are: </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="429202"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">cluster&nbsp;aborting</font></font>
</p>
<p>
<a name="431122"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The node is being aborted from the cluster. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="429215"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">cluster&nbsp;member</font></font>
</p>
<p>
<a name="431141"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The node is a member of the cluster. All shared volumes in the cluster are accessible. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="429237"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">joining</font></font>
</p>
<p>
<a name="431168"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The node is in the process of joining a cluster. It has been initialized but is not yet completely in the cluster. The node goes into this state after <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxclustadm</b></font> is executed with the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>startnode</b></font> keyword. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="429277"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">out&nbsp;of&nbsp;cluster</font></font>
</p>
<p>
<a name="431187"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The node is not joined to the cluster. </font>
</p>
<blockquote>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="425065"></a>Refer to the <em>VERITAS Volume Manager Administrator's Guide </em>for more information about reasons why a node may leave a cluster. </font>
</blockquote>
<blockquote>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="425068"></a>For debugging purposes the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-v</b></font> option can be specified to display the node ID, master ID, neighbor ID, current state, and reason for a node leaving the cluster (if appropriate). </font>
</blockquote>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="429350"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>reinit</b></font></font>
</p>
<p>
<a name="431222"></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>reinit</b></font> keyword allows nodes to be added to or removed from a cluster dynamically without stopping the cluster. The command causes <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxclustadm</b></font> to re-read the cluster configuration file, and implement any required changes to the membership of the cluster. </font>
</p>
<p>
<a name="425079"></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>-m vcs</b></font> option specifies the VCS cluster monitor, which implies the existence of the cluster configuration file, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>/etc/VRTSvcs/conf/config/main.cf</b></font>. </font>
</p>
<p>
<a name="425083"></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>-m hpsg</b></font> option specifies the HP Serviceguard environment, which implies the existence of the cluster configuration file, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>/etc/llthosts</b></font>. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="429467"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>startnode</b></font></font>
</p>
<p>
<a name="431267"></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>startnode</b></font> keyword initiates cluster functionality on a node using the information supplied in the cluster configuration file. This is the first command that must be issued on a node to bring it into the cluster. </font>
</p>
<p>
<a name="425093"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The argument to the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-m</b></font> option specifies the cluster monitor, which implies the existence of a cluster configuration file: </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="429534"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>hpsg</b></font></font>
</p>
<p>
<a name="431297"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The cluster is running in the HP Serviceguard environment, and the cluster configuration file is <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>/etc/llthosts</b></font>. </font>
</p>
<p>
<a name="425101"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>Caution:</b></font> Use the HP Serviceguard administration commands to update the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>/etc/llthosts</b></font> file. Do not edit this file by hand. </font>
</p>
<p>
<a name="425105"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The argument to the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-C</b></font> option specifies the name of the cluster. </font>
</p>
<p>
<a name="425107"></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>-j</b></font> option is used to specify the cluster reconfiguration timeout in seconds. See the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>FILES</b></font> section for more information about this timeout. </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="425111"></a><b>Note  &nbsp;&nbsp;</b>
</font>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2" color="#000000">The <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-C</b></font> and <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-j</b></font> are only applicable to the HP Serviceguard environment. 
</font>
<hr noshade size="2" width="100%" color="#000000">
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="429666"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vcs</b></font></font>
</p>
<p>
<a name="431364"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The cluster is running in the VCS environment. The cluster configuration file is <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>/etc/VRTSvcs/conf/config/main.cf</b></font>. </font>
</p>
<p>
<a name="425118"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>Caution:</b></font> Use VCS commands to edit the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>main.cf</b></font> file. Do not edit this file by hand. </font>
</p>
<p>
<a name="425122"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>startnode </b></font>passes the information in the cluster configuration file to the VxVM kernel. In response to this command, the kernel and the VxVM configuration daemon, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxconfigd</b></font>, perform the initialization. </font>
</p>
<p>
<a name="425129"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The argument to the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-t</b></font> option specifies the protocol to be used for messaging: </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="429802"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>gab</b></font></font>
</p>
<p>
<a name="431406"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Use GAB as the transport agent for messaging in addition to using GAB as a cluster monitor. If you try to use GAB as a transport agent with a cluster monitor other than GAB (or outside the VCS or HP Serviceguard environment), the kernel issues a warning message and changes the transport agent to UDP. </font>
</p>
<p>
<a name="431888"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">When the cluster is running in the VCS or HP Serviceguard environment, the clustering functionality of VxVM should use GAB as the transport agent for messaging. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="429900"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>stopnode</b></font></font>
</p>
<p>
<a name="431425"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Stops cluster functionality on a node, and waits for all outstanding I/O to complete and for all applications to close shared volumes or devices. </font>
</p>

<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="429930"></a> EXIT CODES</font>
</h3>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="429935"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxclustadm</b></font> returns the following exit values: </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="429939"></a>2</font>
</p>
<p>
<a name="431444"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Invalid state. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="429952"></a>101</font>
</p>
<p>
<a name="431459"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Node is not in cluster. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="429965"></a>102</font>
</p>
<p>
<a name="431474"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Node is joining the cluster, or is involved in reconfiguration. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="429978"></a>103</font>
</p>
<p>
<a name="431489"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Node is a cluster member. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="429991"></a>104</font>
</p>
<p>
<a name="431504"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Node is aborting from cluster. </font>
</p>

<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="430003"></a> FILES</font>
</h3>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="430008"></a>For a cluster that is operating without a cluster monitor, or that is using GAB as the cluster monitor outside the VCS or HP Serviceguard environment, and which is using UDP as its transport agent for messaging, the cluster configuration file, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>/etc/vx/cvmtab</b></font>, contains the following fields: </font>
</p>

<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="430053"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">clustername&nbsp;</font><em>cluster_name</em>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="430061"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">port&nbsp;vxconfigd&nbsp;</font><em>port_number</em>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="430066"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">port&nbsp;vxkmsgd&nbsp;</font><em>port_number</em>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="430071"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">node</font>&nbsp;<em>node_ID</em>&nbsp;<em>name</em>&nbsp;<em>name_on_local_net</em>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="430076"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">timeout&nbsp;</font><em>timeout_value</em>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="430081"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>...</b></font>
</font>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="430086"></a>The recommended port numbers for the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxconfigd</b></font> and <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxkmsgd</b></font> daemons are 4500 and 4501, but any available port numbers greater than 1024 are also acceptable. </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="430108"></a><em>name_on_local_net</em> is the node's IP address or resolvable host name on the cluster's private network. </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="430120"></a><em>timeout_value</em> is the timeout value in seconds. The clustering functionality of VxVM uses this value during cluster reconfiguration. The appropriate value to use depends on the number of nodes in the cluster and on the size of the shared disk group configuration. In most cases the value of 200 seconds is sufficient but this may need to be increased for larger configurations. </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="430177"></a>Comment lines in the file start with a <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>#</b></font>. </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="430180"></a>If GAB is being used as the transport agent for messaging, fields relating to port numbers and local network names are not required: </font>
</p>

<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="430198"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">clustername&nbsp;</font><em>cluster_name</em>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="430206"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">node</font>&nbsp;<em>node_ID</em>&nbsp;<em>name</em>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="430211"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">timeout&nbsp;</font><em>timeout_value</em>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="430216"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>...</b></font>
</font>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="430221"></a>For a cluster running in the VCS environment, VxVM obtains information about the cluster from the VCS cluster configuration file (<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>/etc/VRTSvcs/conf/config/main.cf</b></font>). Cluster-specific information may be appended to this file by running the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxcvmconfig</b></font> command. For more information refer to the <em>VERITAS Cluster File System Installation and Configuration Guide</em>. </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="430298"></a>For a cluster running in the HP Serviceguard environment, VxVM obtains information about the cluster from the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>/etc/llthosts</b></font> file. Cluster-specific information may be appended to this file by running the HP Serviceguard administrative command, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>cfscluster config</b></font>. </font>
</p>


<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="430328"></a> EXAMPLES</font>
</h3>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="430333"></a>A cluster consisting of four nodes, named <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>node0</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>node1</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>node2 </b></font>and <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>node3</b></font>, operates without a cluster monitor, and has the following <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>cvmtab</b></font> file when UDP is used as the transport agent for messaging: </font>
</p>

<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="430437"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">#&nbsp;ClusterName</font>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="430442"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">clustername&nbsp;CVM1</font>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="430447"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">#&nbsp;Daemon&nbsp;port&nbsp;numbers</font>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="430452"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">port&nbsp;vxconfigd&nbsp;4500</font>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="430457"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">port&nbsp;vxkmsgd&nbsp;4501</font>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="430462"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">#&nbsp;NodeID&nbsp;Nodename&nbsp;Localname</font>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="430467"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">node&nbsp;0&nbsp;node0&nbsp;node0_p</font>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="430472"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">node&nbsp;1&nbsp;node1&nbsp;node1_p</font>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="430477"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">node&nbsp;2&nbsp;node2&nbsp;node2_p</font>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="430482"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">node&nbsp;3&nbsp;node3&nbsp;node3_p</font>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="430487"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">#&nbsp;Timeout&nbsp;value</font>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="430492"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">timeout&nbsp;200</font>
</font>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="430502"></a>If GAB is used as the transport agent for messaging, the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>cvmtab</b></font> file only needs to contain the following information: </font>
</p>

<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="430529"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">#&nbsp;ClusterName</font>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="430534"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">clustername&nbsp;CVM1</font>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="430539"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">#&nbsp;NodeID&nbsp;Nodename</font>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="430544"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">node&nbsp;0&nbsp;node0</font>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="430549"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">node&nbsp;1&nbsp;node1</font>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="430554"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">node&nbsp;2&nbsp;node2</font>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="430559"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">node&nbsp;3&nbsp;node3</font>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="430564"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">#&nbsp;Timeout&nbsp;value</font>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="430569"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">timeout&nbsp;200</font>
</font>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="430579"></a>If <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>node1</b></font> is the first node to join the cluster, it becomes the master node. The following command confirms that <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>node1</b></font> is the master node: </font>
</p>

<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="430615"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">vxdctl&nbsp;-c&nbsp;mode</font>
</font>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="430625"></a>To determine if reconfiguration of <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>node3</b></font> is complete, examine the value returned from running the following command on <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>node3</b></font>: </font>
</p>

<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="430655"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">vxclustadm&nbsp;-v&nbsp;nodestate</font>
</font>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="430671"></a>To confirm that <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>node3</b></font> is a slave node, the following command is run on <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>node3</b></font>: </font>
</p>

<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="430704"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">vxdctl&nbsp;-c&nbsp;mode</font>
</font>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="430720"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>node1</b></font> remains as the master node for its lifetime in the cluster. To remove <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>node1</b></font> from the cluster, the following command is run on <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>node1</b></font>: </font>
</p>

<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="430768"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">vxclustadm&nbsp;stopnode</font>
</font>

<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="430784"></a> NOTES</font>
</h3>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="430789"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxclustadm</b></font> does not ensure the consistency of cluster membership information. </font>
</p>


<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="430807"></a> SEE ALSO</font>
</h3>
<blockquote>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="430812"></a><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="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="vxintro_vxvm_manpages47_452164.html#439378"><font color="#0000ff"><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxintro </b></font></font></a>(1M) </font>
</blockquote>
<blockquote>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="430854"></a><em>VERITAS Volume Manager Administrator's Guide <br>VERITAS Cluster File System Installation and Configuration 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="vxclustadm_vxvm_manpages21_430807.html" title="vxclustadm">Return to Top</a></font>

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