<!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/13/05 10:42:23">
<meta name="PRODUCTNAME" content="VERITAS Software Documentation">
<meta name="FILENAME" content="01intro.fm">
     
<title>Agent Operations</title>

</HEAD>

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

<a name="118127"></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="01intro_vcs_agents98_118612.html" title="Previous - Typical Setup">Previous</a>&nbsp;&nbsp;|&nbsp;&nbsp;<a href="02install_vcs_agents100_114400.html" title="Next - Installing the EMC SRDF Agent">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_agents_splashpage_docCD_vcs_agents1_103036.vxhd" title="Cluster Server Enterprise Agents Guides title page ">Cluster Server Enterprise Agents 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_srdf_titlepage_docCD_vcs_agents88_73700.vxhd" title="Cluster Server 4.1 Enterprise Agent for EMC SRDF Installation and Configuration Guide title page ">Cluster Server 4.1 Enterprise Agent for EMC SRDF Installation and Configuration 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="118127"></a>Agent Operations</font>
</h1>
 
  
  
  

<a name="no_figure_caption0"> </a>
<Table width="100%" border="1" cellpadding="2" cellspacing="0" >
<tr bgcolor="#CCCCCC"><th align="left"><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2" color="#000000"><b><a name="118487"></a>Operation (Entry Point)</b>
</font></th>

<th colspan=2 rowspan=1><font color="#000000"><b><a name="118489"></a>Description</b>
</font></th>
</tr>
<tr valign="top"><td><p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="118494"></a>online</font>
</p>
</td>
<td colspan=2 rowspan=1><p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="118496"></a>If the state of all local devices is read-write enabled (RW), the agent creates a lock file on the local host to indicate that the resource is online. This makes the devices writable for the application. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="118497"></a>If one or more devices are write-disabled (WD), the agent runs a <font face="Courier New, Courier, sansserif, sans serif" size="2">symrdf</font> command to enable read-write access to the devices.</font>
</p>
<ul compact><li><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="118498"></a>For R2 devices in the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="1">SYNCHRONIZED</font> state, the agent runs the symrdf failover command to make the devices writable.</font>
</li>
<li><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="118499"></a>For R1 devices in the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="1">FAILED OVER</font> or <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="1">R1 UPDATED</font> state, the agent runs the <font face="Courier New, Courier, sansserif, sans serif" size="2">symrdf failback</font> command to make the devices writable.</font>
</li>
<li><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="118500"></a>For all devices in the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="1">PARTITIONED</font> state, the agent runs the <font face="Courier New, Courier, sansserif, sans serif" size="2">symrdf rw_enable</font> command to make the devices writable. </font>
</li>
</ul><ul compact><li><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="118501"></a>The agent runs the command only if the AutoTakeover attribute is set to 1 and if there are no dirty tracks on the local device. Dirty tracks indicate that an out-of-order synchronization was in progress when the devices became partitioned, rendering them inconsistent and unusable. If dirty tracks exist, the online entry point faults on timeout.</font>
</li>
</ul><ul compact><li><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="118502"></a>For R1 devices in the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="1">UPDINPROG</font> state, the agents waits for the devices to transition to the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="1">R1</font> <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="1">UPDATED</font> state before running a <font face="Courier New, Courier, sansserif, sans serif" size="2">symrdf</font> command. </font>
</li>
<li><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="118503"></a>For R2 devices in the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="1">SYNCINPROG</font> state, the agent waits for the devices to transition to the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="1">SYNCHRONIZED</font> state before running a <font face="Courier New, Courier, sansserif, sans serif" size="2">symrdf</font> command.</font>
</li>
<br>
<hr>
<font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000"><a name="118504"></a><b>Note  &nbsp;&nbsp;&nbsp;</b>The agent does not run any commands if it detects that there is not enough time remaining for the entry point to complete the command. See <a href="03config_vcs_agents106_121109.html#129233">To set the OnlineTimeout attribute</a> for more information.
</font>
<hr>
</ul></td>
</tr>
<tr valign="top"><td><p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="118512"></a>offline</font>
</p>
</td>
<td colspan=2 rowspan=1><p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="118514"></a>Removes the lock file on the device. The agent does not run any SRDF commands because taking the resource offline is not indicative of the intention to give up the devices.</font>
</p>
</td>
</tr>
<tr valign="top"><td><p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="118518"></a>monitor</font>
</p>
</td>
<td colspan=2 rowspan=1><p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="118520"></a>Verifies that the lock file exists. If the lock file exists, the monitor entry point reports the status of the resource as online. If the lock file does not exist, the monitor entry point reports the status of the resource as offline. </font>
</p>
</td>
</tr>
<tr valign="top"><td><p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="118525"></a>open</font>
</p>
</td>
<td colspan=2 rowspan=1><p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="118527"></a>Removes the lock file on the host where the entry point is called. This prevents potential concurrency violation if the service group fails over to another node.</font>
</p>
<br>
<hr>
<font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000"><a name="118528"></a><b>Note  &nbsp;&nbsp;&nbsp;</b>The agent does not remove the lock file if the agent was started after an hastop -force command. 
</font>
<hr>
</td>
</tr>
<tr valign="top"><td><p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="118533"></a>clean</font>
</p>
</td>
<td colspan=2 rowspan=1><p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="118535"></a>Determines whether if it is safe to fault the resource if the online entry point fails or times out. The main consideration is whether a management operation was in progress when the online thread timed out and was killed, potentially leaving the devices in an unusable state. </font>
</p>
</td>
</tr>
<tr valign="top"><td><p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="118539"></a>info</font>
</p>
</td>
<td colspan=2 rowspan=1><p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="118541"></a>Reports the device state to the VCS interface. This entry point can be used to verify the device state and to monitor dirty track trends.</font>
</p>
</td>
</tr>
<tr valign="top"><td><p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="118546"></a>action</font>
</p>
</td>
<td colspan=2 rowspan=1><p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="118548"></a>Performs a <font face="Courier New, Courier, sansserif, sans serif" size="2">symrdf update</font> from the R2 side to merge any dirty tracks from the R2 to the R1. </font>
</p>
</td>
</tr>

</table>


<Table width="100%" border="0" cellpadding="1" cellspacing="0">
<tr><td>
</Table>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="118406"></a></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="01intro_vcs_agents99_118127.html" title="Agent Operations">Return to Top</a></font>

  </td>
  <td align="right"><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="-2">&lt;&nbsp;<a href="01intro_vcs_agents98_118612.html" title="Previous - Typical Setup">Previous</a>&nbsp;&nbsp;|&nbsp;&nbsp;<a href="02install_vcs_agents100_114400.html" title="Next - Installing the EMC SRDF Agent">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_agents_splashpage_docCD_vcs_agents1_103036.vxhd" title="Cluster Server Enterprise Agents Guides title page ">Cluster Server Enterprise Agents 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_srdf_titlepage_docCD_vcs_agents88_73700.vxhd" title="Cluster Server 4.1 Enterprise Agent for EMC SRDF Installation and Configuration Guide title page ">Cluster Server 4.1 Enterprise Agent for EMC SRDF Installation and Configuration 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>
