<!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 10:15:28">
<meta name="PRODUCTNAME" content="VERITAS Software Documentation">
<meta name="FILENAME" content="16admin_gco_cli.fm">
     
<title>Querying Clusters</title>

</HEAD>

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

<a name="244980"></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="16admin_gco_cli_vcs552_147247.html" title="Previous - Querying Systems">Previous</a>&nbsp;&nbsp;|&nbsp;&nbsp;<a href="16admin_gco_cli_vcs554_241054.html" title="Next - Administering Service Groups">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="vcs_splashpage_docCD_vcs1_103036.vxhd" title="Cluster Server Guides title page ">Cluster Server 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="vcshp_ug_titlepage_docCD_vcs258_73700.vxhd" title="Cluster Server 4.1 User's Guide title page ">Cluster Server 4.1 User's 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>
	
<h2><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="3" color="#000000"><a name="244980"></a> Querying Clusters</font>
</h2>

        
</ol>
<p><img src="images/stepintro.gif" height="16" width="16">
<font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000"><a name="245048"></a>&nbsp;&nbsp;<b>For the value of a specific cluster attribute on a specific cluster</b></font>
</p>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="245050"></a>#&nbsp;<font face="Courier New, Courier, sansserif, sans serif" size="2"><b>haclus&nbsp;-value</b></font>&nbsp;<font face="Courier New, Courier, sansserif, sans serif" size="2"><b>attribute&nbsp;</b></font><font face="Courier New, Courier, sansserif, sans serif" size="2"><b>[</b></font><font face="Courier New, Courier, sansserif, sans serif" size="2"><b>cluster</b></font><font face="Courier New, Courier, sansserif, sans serif" size="2"><b>]&nbsp;[-localclus]&nbsp;</b></font>
</font>
<blockquote>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="245051"></a>The attribute must be specified in this command. If you do not specify the cluster name, the command displays the attribute value on the local cluster. </font>
</blockquote>
</ol>
<p><img src="images/stepintro.gif" height="16" width="16">
<font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000"><a name="237359"></a>&nbsp;&nbsp;<b>To display the state of a local or remote cluster as seen from the local cluster</b></font>
</p>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="237361"></a>#&nbsp;<font face="Courier New, Courier, sansserif, sans serif" size="2"><b>haclus&nbsp;-state</b></font>&nbsp;<font face="Courier New, Courier, sansserif, sans serif" size="2"><b>[</b></font><font face="Courier New, Courier, sansserif, sans serif" size="2"><b>cluster</b></font><font face="Courier New, Courier, sansserif, sans serif" size="2"><b>]&nbsp;[-localclus]&nbsp;</b></font>
</font>
<blockquote>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="237362"></a>The variable <em>cluster</em> represents the cluster. If a cluster is not specified, the state of the local cluster and the state of all remote cluster objects as seen by the local cluster are displayed.</font>
</blockquote>
</ol>
<p><img src="images/stepintro.gif" height="16" width="16">
<font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000"><a name="231901"></a>&nbsp;&nbsp;<b>For information on the state of a local or remote cluster as seen from the local cluster</b></font>
</p>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="231961"></a>#&nbsp;<font face="Courier New, Courier, sansserif, sans serif" size="2"><b>haclus&nbsp;-display</b></font>&nbsp;<font face="Courier New, Courier, sansserif, sans serif" size="2"><b>[</b></font><font face="Courier New, Courier, sansserif, sans serif" size="2"><b>cluster</b></font><font face="Courier New, Courier, sansserif, sans serif" size="2"><b>]&nbsp;[-localclus]&nbsp;</b></font>
</font>
<blockquote>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="231904"></a>If a cluster is not specified, information on the local cluster is displayed.</font>
</blockquote>
</ol>
<p><img src="images/stepintro.gif" height="16" width="16">
<font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000"><a name="232106"></a>&nbsp;&nbsp;<b>For a list of local and remote clusters</b></font>
</p>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="232108"></a>#&nbsp;<font face="Courier New, Courier, sansserif, sans serif" size="2"><b>haclus&nbsp;-list&nbsp;[</b></font><font face="Courier New, Courier, sansserif, sans serif" size="2"><b>conditionals</b></font><font face="Courier New, Courier, sansserif, sans serif" size="2"><b>]</b></font>
</font>
<blockquote>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="247815"></a>Lists the clusters that meet the specified conditions, beginning with the local cluster. </font>
</blockquote>
</ol>
<p><img src="images/stepintro.gif" height="16" width="16">
<font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000"><a name="234046"></a>&nbsp;&nbsp;<b>To display usage for the cluster command</b></font>
</p>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="237404"></a>#&nbsp;<font face="Courier New, Courier, sansserif, sans serif" size="2"><b>haclus&nbsp;[-help&nbsp;[-modify]]</b></font>
</font>
</ol>
<p><img src="images/stepintro.gif" height="16" width="16">
<font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000"><a name="249023"></a>&nbsp;&nbsp;<b>To display the status of a faulted cluster</b></font>
</p>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="249082"></a>#&nbsp;<font face="Courier New, Courier, sansserif, sans serif" size="2"><b>haclus&nbsp;-status&nbsp;</b></font><em>cluster</em>
</font>
<blockquote>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="249124"></a>Displays the status on the specified faulted cluster. If no cluster is specified, the command displays the status on all faulted clusters. It lists the service groups that were not in the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="1">OFFLINE</font> or the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="1">FAULTED</font> state before the fault occurred. It also suggests corrective action for the listed clusters and service groups. </font>
</blockquote>



<h2><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="3" color="#000000"><a name="157080"></a>Querying Status</font>
</h2>
 
</ol>
<p><img src="images/stepintro.gif" height="16" width="16">
<font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000"><a name="157082"></a>&nbsp;&nbsp;<b>For the status of local and remote clusters</b></font>
</p>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="157083"></a>#&nbsp;<font face="Courier New, Courier, sansserif, sans serif" size="2"><b>hastatus</b></font>
</font>



<h2><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="3" color="#000000"><a name="238729"></a>Querying Heartbeats</font>
</h2>
 
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="238730"></a>The <font face="Courier New, Courier, sansserif, sans serif" size="2">hahb</font> command is used to manage WAN heartbeats that emanate from the local cluster. Administrators can monitor the &quot;health&quot; of the remote cluster via heartbeat commands and mechanisms such as Internet, satellites, or storage replication technologies. Heartbeat commands are applicable only on the cluster from which they are issued.</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="238731"></a><b>Note  &nbsp;&nbsp;</b>
</font>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2" color="#000000">You must have Cluster Administrator privileges to add, delete, and modify heartbeats.
</font>
<hr noshade size="2" width="100%" color="#000000">
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="238738"></a>The following commands are issued from the command line. </font>
</p>

</ol>
<p><img src="images/stepintro.gif" height="16" width="16">
<font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000"><a name="238739"></a>&nbsp;&nbsp;<b>For a list of heartbeats configured on the local cluster</b></font>
</p>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="238741"></a>#&nbsp;<font face="Courier New, Courier, sansserif, sans serif" size="2"><b>hahb&nbsp;-list&nbsp;[</b></font><em>conditionals</em><font face="Courier New, Courier, sansserif, sans serif" size="2"><b>]</b></font>
</font>
<blockquote>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="238742"></a>The variable <em>conditionals</em> represents the conditions that must be met for the heartbeat to be listed.</font>
</blockquote>
</ol>
<p><img src="images/stepintro.gif" height="16" width="16">
<font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000"><a name="238744"></a>&nbsp;&nbsp;<b>To display information on heartbeats configured in the local cluster</b></font>
</p>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="238746"></a>#&nbsp;<font face="Courier New, Courier, sansserif, sans serif" size="2"><b>hahb&nbsp;-display&nbsp;[</b></font><font face="Courier New, Courier, sansserif, sans serif" size="2"><b>heartbeat&nbsp;...</b></font><font face="Courier New, Courier, sansserif, sans serif" size="2"><b>]</b></font>
</font>
<blockquote>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="238747"></a>If <em>heartbeat </em>is not specified, information regarding all heartbeats configured on the local cluster is displayed.</font>
</blockquote>
</ol>
<p><img src="images/stepintro.gif" height="16" width="16">
<font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000"><a name="238748"></a>&nbsp;&nbsp;<b>To display the state of the heartbeats in remote clusters</b></font>
</p>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="238749"></a>#&nbsp;<font face="Courier New, Courier, sansserif, sans serif" size="2"><b>hahb&nbsp;-state&nbsp;[</b></font><font face="Courier New, Courier, sansserif, sans serif" size="2"><b>heartbeat</b></font><font face="Courier New, Courier, sansserif, sans serif" size="2"><b>]&nbsp;[-clus</b></font><font face="Courier New, Courier, sansserif, sans serif" size="2"><b>&nbsp;cluster</b></font><font face="Courier New, Courier, sansserif, sans serif" size="2"><b>]</b></font>
</font>
<blockquote>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="238750"></a>For example, to get the state of heartbeat ICMP from the local cluster to the remote cluster phoenix:</font>
</blockquote>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="238751"></a>&nbsp;&nbsp;#&nbsp;<font face="Courier New, Courier, sansserif, sans serif" size="2"><b>hahb&nbsp;-state&nbsp;ICMP&nbsp;-clus&nbsp;phoenix</b></font>
</font>
</ol>
<p><img src="images/stepintro.gif" height="16" width="16">
<font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000"><a name="238753"></a>&nbsp;&nbsp;<b>To display an attribute value of a configured heartbeat</b></font>
</p>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="238754"></a>#&nbsp;<font face="Courier New, Courier, sansserif, sans serif" size="2"><b>hahb&nbsp;-value&nbsp;</b></font><font face="Courier New, Courier, sansserif, sans serif" size="2"><b>heartbeat&nbsp;attribute&nbsp;</b></font><font face="Courier New, Courier, sansserif, sans serif" size="2"><b>[-clus</b></font><font face="Courier New, Courier, sansserif, sans serif" size="2"><b>&nbsp;cluster</b></font><font face="Courier New, Courier, sansserif, sans serif" size="2"><b>]</b></font>
</font>
<blockquote>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="238755"></a>The <font face="Courier New, Courier, sansserif, sans serif" size="2">-value</font> option provides the value of a single attribute for a specific heartbeat. The cluster name must be specified for cluster-specific attribute values, but not for global.</font>
</blockquote>
<blockquote>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="238756"></a>For example, to display the value of the ClusterList attribute for heartbeat ICMP:</font>
</blockquote>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="238757"></a>&nbsp;&nbsp;#&nbsp;<font face="Courier New, Courier, sansserif, sans serif" size="2"><b>hahb&nbsp;-value&nbsp;ICMP&nbsp;ClusterList</b></font>
</font>
<blockquote>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="238758"></a>Note that ClusterList is a global attribute.</font>
</blockquote>
</ol>
<p><img src="images/stepintro.gif" height="16" width="16">
<font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000"><a name="238760"></a>&nbsp;&nbsp;<b>To display usage for the command <font face="Courier New, Courier, sansserif, sans serif" size="2">hahb</font></b></font>
</p>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="238762"></a>#&nbsp;<font face="Courier New, Courier, sansserif, sans serif" size="2"><b>hahb&nbsp;[-help&nbsp;[-modify]]</b></font>
</font>
<blockquote>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="238764"></a>If the -modify option is specified, the usage for the <font face="Courier New, Courier, sansserif, sans serif" size="2">hahb</font> <font face="Courier New, Courier, sansserif, sans serif" size="2">-modify</font> option is displayed.</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="16admin_gco_cli_vcs553_244980.html" title="Querying Clusters">Return to Top</a></font>

  </td>
  <td align="right"><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="-2">&lt;&nbsp;<a href="16admin_gco_cli_vcs552_147247.html" title="Previous - Querying Systems">Previous</a>&nbsp;&nbsp;|&nbsp;&nbsp;<a href="16admin_gco_cli_vcs554_241054.html" title="Next - Administering Service Groups">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="vcs_splashpage_docCD_vcs1_103036.vxhd" title="Cluster Server Guides title page ">Cluster Server 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="vcshp_ug_titlepage_docCD_vcs258_73700.vxhd" title="Cluster Server 4.1 User's Guide title page ">Cluster Server 4.1 User's 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>
