<!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:41:40">
<meta name="PRODUCTNAME" content="VERITAS Software Documentation">
<meta name="FILENAME" content="04_configure_agent.fm">
     
<title>Configuring the Agent</title>

</HEAD>

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

<a name="115436"></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="04_configure_agent_vcs_agents19_115286.html" title="Previous - Informix Resource Type">Previous</a>&nbsp;&nbsp;|&nbsp;&nbsp;<a href="04_configure_agent_vcs_agents21_115503.html" title="Next - Configuring Informix Agent by Editing the Configuration Files">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="vcs_informix_install_titlepage_docCD_vcs_agents2_73700.vxhd" title="Cluster Server 4.1 Enterprise Agent for Informix Installation and Configuration Guide title page ">Cluster Server 4.1 Enterprise Agent for Informix 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="115436"></a>Configuring the Agent</font>
</h1>
 
  
  
  

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="115437"></a>You can configure the Informix agent using the following methods: </font>
</p>

<p>
<ul type="disc"><li><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="115438"></a>By using VCS Cluster Manager (the VCS graphical user interface) to edit a resource group template for the Informix agent. See <a href="04_configure_agent_vcs_agents20_115436.html#115448">Configuring the Agent Using Cluster Manager (Java Console)</a>, or,</font>
</li>
<li><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="115442"></a>By directly editing the sample <font face="Courier New, Courier, sansserif, sans serif" size="2">main.cf</font> file supplied with the Informix agent (see <a href="04_configure_agent_vcs_agents21_115503.html#115503">Configuring Informix Agent by Editing the Configuration Files</a>). This method requires that VCS be stopped and restarted before the configuration takes effect.</font>
</li>
</ul>
</p>



<h2><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="3" color="#000000"><a name="115448"></a>Configuring the Agent Using Cluster Manager (Java Console)</font>
</h2>
 
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="115449"></a>A template for the Informix resource groups is automatically installed when you install the Informix enterprise agent. Using the VCS Cluster Manager, you can view the template, which displays the Informix service group, its resources and their attributes. You can dynamically modify the attribute values as necessary for your configuration.</font>
</p>




<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000"><a name="115451"></a>Importing the InformixTypes.cf File</font>
</h3>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="115452"></a>To use the Informix template, import the <font face="Courier New, Courier, sansserif, sans serif" size="2">InformixTypes.cf</font> file to the VCS engine by using Cluster Manager:</font>
</p>

<ol>
<li value="1">
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="115453"></a>Start Cluster Manager.
</font>
<li value="2">
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="115454"></a>Click on the File menu and select Import Types.
</font>
<li value="3">
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="115455"></a>In the Import Types dialog box, select the file:
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="115456"></a>&nbsp;&nbsp;/etc/VRTSvcs/conf/sample_Informix/InformixTypes.cf
</font>
<li value="4">
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="115457"></a>Import the types file for Informix.
</font>
<li value="5">
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="115458"></a>Save the configuration.
</font>
</ol>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="115459"></a>At this point, the Informix types have been imported to the VCS engine. The Informix agent can be configured without interrupting or stopping VCS.</font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="115460"></a>For detailed information about using the VCS Cluster Manager, refer to the chapter on administering VCS from Cluster Manager (Java Console or Web Console) in the <em>VERITAS Cluster Server User's Guide</em>.</font>
</p>




<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000"><a name="115461"></a>Creating a New Service Group Using Cluster Manager (Java Console)</font>
</h3>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="115462"></a>To create a new service group, import the <font face="Courier New, Courier, sansserif, sans serif" size="2">InformixTypes.cf</font> file and then download the InformixGroup template by starting the Service Group Configuration Wizard from the Cluster Manager.</font>
</p>




<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000"><a name="115463"></a>Creating an Informix Service Group</font>
</h3>
<ol>
<li value="1">
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="115464"></a>Launch the cluster configuration wizard in one of the following ways:
</font>
<p>
<ul type="disc"><li><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="115465"></a>Select Tools&gt;Configuration wizard from the Cluster Explorer menu.</font>
</li>
<li><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="115466"></a>If no service groups exist on the system, the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>Cluster Explorer</b></font> prompts you to launch the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>Cluster Configuration wizard. </b></font>Click Yes when prompted. </font>
</li>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="115467"></a>The Loading Templates Information window appears and launches the wizard.</font>
</p>
</ul>
</p>
<li value="2">
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="115468"></a>Read the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>Welcome</b></font> screen and click <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>Next</b></font>.
</font>
<li value="3">
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="115469"></a>Specify the name of the service group and the target systems on which it is to be configured.
</font>
<ol type=a>
<li><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="115473"></a>Enter the name of the service group.</font>
</li>
<li><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="115474"></a>In the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>Available Systems</b></font> box, select the systems in the cluster on which you want to configure the service group.</font>
</li>
<li><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="115475"></a>Click the right arrow to move the selected systems to the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>Systems for Service Group</b></font> table. To remove a system from a table, select the system and click the left arrow.</font>
</li>
<li><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="115476"></a>Indicate whether you want the service group to become online automatically when VCS starts, by clicking on the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>Startup</b></font> checkbox beside the system name. Specify the order in which you want the systems to fail over by assigning priorities to the cluster systems.</font>
</li>
<li><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="115477"></a>Click <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>Next</b></font>.</font>
</li>
</ol>
<li value="4">
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="115478"></a>In the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>Would you like the service group to be based on a template?</b></font> window, click <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>Next</b></font>.
</font>
<li value="5">
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="115479"></a>In the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>Select Templates</b></font> dialog box, select the Informix template (InformixGroup) on which to base the service group.
</font>
<blockquote>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="115480"></a>If the names that you specified for some resources for the new service group are already in use, a window opens notifying you of this. This window also includes a list of alternative names. You can select an alternative name, or modify the name. Click Next after resolving the name clashes.</font>
</blockquote>
<li value="6">
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="115481"></a>Click <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>Next</b></font> to create the service group based on the selected template. A window opens indicating that the commands are being sent to the add group, its resources, and the attributes and dependencies specified in the template. A progress indicator displays the percentage of the commands fired. The actual commands are displayed at the top of the indicator. 
</font>
<li value="7">
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="115482"></a>Click <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>Next</b></font> when prompted that the service group has been successfully created.
</font>
<li value="8">
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="115483"></a>A window opens listing the service group's resources and their associated attributes. Click <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>Finish</b></font> to accept the default values and complete the configuration.
</font>
<blockquote>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="115484"></a>You can modify the default values of the resources according to your specific configuration requirements. For details see the following section.</font>
</blockquote>
</ol>



<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000"><a name="115488"></a>Editing the Resource attributes </font>
</h3>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="115489"></a>This section describes the procedure to edit attributes using the Cluster Manager. For <br>a list of attributes that must be configured for the Informix service group, refer to attribute definitions for the Informix resource type on <a href="04_configure_agent_vcs_agents19_115286.html#115300"> </a>. </font>
</p>

<ol>
<li value="1">
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="115493"></a>Select a resource from the list on the left. Its attributes appear in the right pane. 
</font>
<li value="2">
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="115494"></a>Select the attribute to be modified. 
</font>
<li value="3">
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="115495"></a>Click the edit icon in the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>Edit</b></font> column.
</font>
<li value="4">
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="115496"></a>Enter attribute values in the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>Edit Attribute</b></font> window. To modify the scope of the attributes, select either <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>Global</b></font> or <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>Local</b></font> option. For non-scalar values, use the + or the X buttons to add or delete values, respectively. 
</font>
<li value="5">
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="115497"></a>Click <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>OK</b></font>.
</font>
<li value="6">
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="115498"></a>Repeat the procedure for each resource and its attributes and click Finish. Edit the attributes for all the resources according to your configuration.
</font>
<li value="7">
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="115499"></a>Follow the wizard instructions to complete the configuration. Click <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>Finish</b></font> to quit the wizard.
</font>
</ol>

<!-- 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="04_configure_agent_vcs_agents20_115436.html" title="Configuring the Agent">Return to Top</a></font>

  </td>
  <td align="right"><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="-2">&lt;&nbsp;<a href="04_configure_agent_vcs_agents19_115286.html" title="Previous - Informix Resource Type">Previous</a>&nbsp;&nbsp;|&nbsp;&nbsp;<a href="04_configure_agent_vcs_agents21_115503.html" title="Next - Configuring Informix Agent by Editing the Configuration Files">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="vcs_informix_install_titlepage_docCD_vcs_agents2_73700.vxhd" title="Cluster Server 4.1 Enterprise Agent for Informix Installation and Configuration Guide title page ">Cluster Server 4.1 Enterprise Agent for Informix 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>
