<!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:16:09">
<meta name="PRODUCTNAME" content="VERITAS Software Documentation">
<meta name="FILENAME" content="21trouble_vcs.fm">
     
<title>Troubleshooting Service Groups</title>

</HEAD>

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

<a name="231194"></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="21trouble_vcs_vcs617_231167.html" title="Previous - Troubleshooting VCS Startup">Previous</a>&nbsp;&nbsp;|&nbsp;&nbsp;<a href="21trouble_vcs_vcs619_231240.html" title="Next - Troubleshooting Resources">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>
	
<h1><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="+1" color="#000000"><a name="231194"></a> Troubleshooting Service Groups</font>
</h1>
         
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="231196"></a>This section cites the most common problems associated with bringing service groups online and taking them offline. Bold text provides a description of the problem. Recommended action is also included, where applicable.</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="231199"></a>&nbsp;&nbsp;<b>System is not in RUNNING state.</b></font>
</p>
<blockquote>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="243928"></a><em>Recommended Action: </em>Type <font face="Courier New, Courier, sansserif, sans serif" size="2">hasys</font> <font face="Courier New, Courier, sansserif, sans serif" size="2">-display</font> <em>system</em> to verify the system is running. See <a href="append_states_vcs636_92386.html#92386">System States</a> for more information on system states.</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="243932"></a>&nbsp;&nbsp;<b>Service group not configured to run on the system.</b></font>
</p>
<blockquote>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="231205"></a>The SystemList attribute of the group may not contain the name of the system.</font>
</blockquote>
<blockquote>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="231206"></a><em>Recommended Action: </em>Use the output of the command <font face="Courier New, Courier, sansserif, sans serif" size="2">hagrp</font> <font face="Courier New, Courier, sansserif, sans serif" size="2">-display</font> <em>service_group</em> to&nbsp;verify the system name.</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="231207"></a>&nbsp;&nbsp;<b>Service group not configured to autostart.</b></font>
</p>
<blockquote>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="231208"></a>If the service group is not starting automatically on the system, the group may not be configured to AutoStart, or may not be configured to AutoStart on that particular system.</font>
</blockquote>
<blockquote>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="231209"></a><em>Recommended Action: </em>Use the output of the command <font face="Courier New, Courier, sansserif, sans serif" size="2">hagrp</font> <font face="Courier New, Courier, sansserif, sans serif" size="2">-display</font> <em>service_group</em> to verify the values of the AutoStart and AutoStartList attributes.</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="231210"></a>&nbsp;&nbsp;<b>Service group is frozen.</b></font>
</p>
<blockquote>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="231211"></a><em>Recommended Action: </em>Use the output of the command <font face="Courier New, Courier, sansserif, sans serif" size="2">hagrp</font> <font face="Courier New, Courier, sansserif, sans serif" size="2">-display</font> <em>service_group</em> to verify the value of the Frozen and TFrozen attributes. Use the command <font face="Courier New, Courier, sansserif, sans serif" size="2">hagrp</font> <font face="Courier New, Courier, sansserif, sans serif" size="2">-unfreeze</font> to thaw the group. Note that VCS will not take a frozen service group offline.</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="249075"></a>&nbsp;&nbsp;<b>Failover service group is online on another system.</b></font>
</p>
<blockquote>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="249076"></a>The group is a failover group and is online or partially online on another system.</font>
</blockquote>
<blockquote>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="249077"></a><em>Recommended Action: </em>Use the output of the command <font face="Courier New, Courier, sansserif, sans serif" size="2">hagrp</font> <font face="Courier New, Courier, sansserif, sans serif" size="2">-display</font> <em>service_group</em> to verify the value of the State attribute. Use the command<br><font face="Courier New, Courier, sansserif, sans serif" size="2">hagrp</font> <font face="Courier New, Courier, sansserif, sans serif" size="2">-offline</font> to offline the group on another system.</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="249086"></a>&nbsp;&nbsp;<b>A critical resource faulted.</b></font>
</p>
<blockquote>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="249087"></a>Output of the command <font face="Courier New, Courier, sansserif, sans serif" size="2">hagrp</font> <font face="Courier New, Courier, sansserif, sans serif" size="2">-display</font> <em>service_group</em> indicates that the service group has faulted.</font>
</blockquote>
<blockquote>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="249088"></a><em>Recommended Action: </em>Use the command <font face="Courier New, Courier, sansserif, sans serif" size="2">hares</font> <font face="Courier New, Courier, sansserif, sans serif" size="2">-clear</font> to clear the fault.</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="231214"></a>&nbsp;&nbsp;<b>Service group autodisabled.</b></font>
</p>
<blockquote>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="231215"></a>When VCS does not know the status of a service group on a particular system, it autodisables the service group on that system. Autodisabling occurs under the following conditions:</font>
</blockquote>
<p>
<ul type="disc"><p>
<ul type="disc"><li><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="231216"></a>When the VCS engine, HAD, is not running on the system.</font>
</li>
<li><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="231217"></a>When all resources within the service group are not probed on the system.</font>
</li>
<li><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="231218"></a>When a particular system is visible through disk heartbeat only.</font>
</li>
<blockquote>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="231219"></a>Under these conditions, all service groups that include the system in their SystemList attribute are autodisabled. <em>This does not apply to systems that are powered off.</em></font>
</blockquote>
<blockquote>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="231220"></a><em>Recommended Action: </em>Use the output of the command <font face="Courier New, Courier, sansserif, sans serif" size="2">hagrp</font> <font face="Courier New, Courier, sansserif, sans serif" size="2">-display</font> <em>service_group</em> to verify the value of the AutoDisabled attribute.</font>
</blockquote>
<blockquote>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="231221"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>Caution:</b></font> To bring a group online manually after VCS has autodisabled the group, make sure that the group is not fully or partially active on any system that has the AutoDisabled attribute set to 1 by VCS. Specifically, verify that all resources that may be corrupted by being active on multiple systems are brought down on the designated systems. Then, clear the AutoDisabled attribute for each system:</font>
</blockquote>
<blockquote>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="231223"></a><font face="Courier New, Courier, sansserif, sans serif" size="2"># </font><font face="Courier New, Courier, sansserif, sans serif" size="2"><b>hagrp -autoenable </b></font><em>service_group</em><font face="Courier New, Courier, sansserif, sans serif" size="2"><b> -sys </b></font><em>system</em></font>
</blockquote>
</ul>
</p>
</ul>
</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="231227"></a>&nbsp;&nbsp;<b>Service group is waiting for the resource to be brought online/taken offline.</b></font>
</p>
<blockquote>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="231228"></a><em>Recommended Action: </em>Review the IState attribute of all resources in the service group to locate which resource is waiting to go online (or which is waiting to be taken offline). Use the <font face="Courier New, Courier, sansserif, sans serif" size="2">hastatus</font> command to help identify the resource. See the engine and agent logs in <font face="Courier New, Courier, sansserif, sans serif" size="2">/var/VRTSvcs/log</font> for information on why the resource is unable to be brought online or be taken offline.</font>
</blockquote>
<blockquote>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="231229"></a>To clear this state, make sure all resources waiting to go online/offline do not bring themselves online/offline. Use the command <font face="Courier New, Courier, sansserif, sans serif" size="2">hagrp</font> <font face="Courier New, Courier, sansserif, sans serif" size="2">-flush</font> to clear the internal state of VCS. You can now bring the service group online or take it offline on another system.</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="231234"></a>&nbsp;&nbsp;<b>Service group is waiting for a dependency to be met.</b></font>
</p>
<blockquote>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="231235"></a><em>Recommended Action:</em> To see which dependencies have not been met, type<br><font face="Courier New, Courier, sansserif, sans serif" size="2">hagrp</font> <font face="Courier New, Courier, sansserif, sans serif" size="2">-dep</font> <em>service_group</em> to view service group dependencies, or <font face="Courier New, Courier, sansserif, sans serif" size="2">hares</font> <font face="Courier New, Courier, sansserif, sans serif" size="2">-dep</font> <em>resource</em> to view resource dependencies.</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="231236"></a>&nbsp;&nbsp;<b>Service group not fully probed.</b></font>
</p>
<blockquote>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="231237"></a>This occurs if the agent processes have not monitored each resource in the service group. When the VCS engine, HAD, starts, it immediately &quot;probes&quot; to find the initial state of all of resources. (It cannot probe if the agent is not returning a value.) A service group must be probed on all systems included in the SystemList attribute before VCS attempts to bring the group online as part of AutoStart. This ensures that even if the service group was online prior to VCS being brought up, VCS will not inadvertently bring the service group online on another system.</font>
</blockquote>
<blockquote>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="231238"></a><em>Recommended Action:</em> Use the output of <font face="Courier New, Courier, sansserif, sans serif" size="2">hagrp</font> <font face="Courier New, Courier, sansserif, sans serif" size="2">-display</font> <em>service_group</em> to see the value of the ProbesPending attribute for the system's service group. (It should be zero.) To determine which resources are not probed, verify the local Probed attribute for each resource on the specified system. Zero means waiting for probe result, 1 means probed, and 2 means VCS not booted. See the engine and agent logs for information.</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="21trouble_vcs_vcs618_231194.html" title="Troubleshooting Service Groups">Return to Top</a></font>

  </td>
  <td align="right"><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="-2">&lt;&nbsp;<a href="21trouble_vcs_vcs617_231167.html" title="Previous - Troubleshooting VCS Startup">Previous</a>&nbsp;&nbsp;|&nbsp;&nbsp;<a href="21trouble_vcs_vcs619_231240.html" title="Next - Troubleshooting Resources">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>
