ibm-information-center/dist/eclipse/plugins/i5OS.ic.rzaig_5.4.0.1/rzaigmanagetunablecommparameters.htm

146 lines
9.7 KiB
HTML
Raw Normal View History

2024-04-02 14:02:31 +00:00
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html
PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html lang="en-us" xml:lang="en-us">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<meta name="security" content="public" />
<meta name="Robots" content="index,follow" />
<meta http-equiv="PICS-Label" content='(PICS-1.1 "http://www.icra.org/ratingsv02.html" l gen true r (cz 1 lz 1 nz 1 oz 1 vz 1) "http://www.rsac.org/ratingsv01.html" l gen true r (n 0 s 0 v 0 l 0) "http://www.classify.org/safesurf/" l gen true r (SS~~000 1))' />
<meta name="DC.Type" content="concept" />
<meta name="DC.Title" content="Tunable cluster communications parameters" />
<meta name="abstract" content="The Change Cluster Resource Services (QcstChgClusterResourceServices) API enables some of the cluster topology services and cluster communications performance and configuration parameters to be tuned to better suit the many unique application and networking environments in which clustering occurs. This API is available to any cluster that is running at cluster version 2 or later." />
<meta name="description" content="The Change Cluster Resource Services (QcstChgClusterResourceServices) API enables some of the cluster topology services and cluster communications performance and configuration parameters to be tuned to better suit the many unique application and networking environments in which clustering occurs. This API is available to any cluster that is running at cluster version 2 or later." />
<meta name="DC.Relation" scheme="URI" content="rzaigplan.htm" />
<meta name="DC.Relation" scheme="URI" content="rzaigmanagetune.htm" />
<meta name="copyright" content="(C) Copyright IBM Corporation 1998, 2006" />
<meta name="DC.Rights.Owner" content="(C) Copyright IBM Corporation 1998, 2006" />
<meta name="DC.Format" content="XHTML" />
<meta name="DC.Identifier" content="rzaigmanagetunablecommparameters" />
<meta name="DC.Language" content="en-us" />
<!-- All rights reserved. Licensed Materials Property of IBM -->
<!-- US Government Users Restricted Rights -->
<!-- Use, duplication or disclosure restricted by -->
<!-- GSA ADP Schedule Contract with IBM Corp. -->
<link rel="stylesheet" type="text/css" href="./ibmdita.css" />
<link rel="stylesheet" type="text/css" href="./ic.css" />
<title>Tunable cluster communications parameters</title>
</head>
<body id="rzaigmanagetunablecommparameters"><a name="rzaigmanagetunablecommparameters"><!-- --></a>
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
<h1 class="topictitle1">Tunable cluster communications parameters</h1>
<div><p>The <span class="apiname">Change Cluster Resource Services (QcstChgClusterResourceServices)</span> API
enables some of the cluster topology services and cluster communications performance
and configuration parameters to be tuned to better suit the many unique application
and networking environments in which clustering occurs. This API is available
to any cluster that is running at cluster version 2 or later.</p>
<p>The <a href="../cl/chgclucfg.htm"><span class="cmdname">Change
Cluster Configuration Tuning (CHGCLUCFG)</span> command</a> provides
a base level of tuning, while the <a href="../apis/clcntchgcrs.htm"><span class="apiname">QcstChgClusterResourceServices</span> API </a>provides
both base and advanced levels of tuning.</p>
<p>The <span class="apiname">QcstChgClusterResourceServices</span> API and <span class="cmdname">CHGCLUCFG</span> command
can be used to tune cluster performance and configuration. The API and command
provide a base level of tuning support where the cluster will adjust to a
predefined set of values identified for high, low, and normal timeout and
messaging interval values. If an advanced level of tuning is desired, usually
anticipated with the help of IBM<sup>®</sup> support personnel, then individual parameters may
be tuned through use of the API over a predefined value range. Inappropriate
changes to the individual parameters can easily lead to degraded cluster performance.</p>
<div class="section"><h4 class="sectiontitle">When and how to tune cluster parameters?</h4><p>The <span class="cmdname">CHGCLUCFG</span> command
and the <span class="apiname">QcstChgClusterResourceServices</span> API provide for
a fast path to setting cluster performance and configuration parameters without
your needing to understand details. This base level of tuning primarily affects
the heartbeating sensitivity and the cluster message timeout values. The valid
values for the base level of tuning support are:</p>
<p>1 (High Timeout Values/Less
Frequent Heartbeats)</p>
<dl><dt class="dlterm">2 (Default Values)</dt>
<dd>Normal default values are used for cluster communications performance
and configuration parameters. This setting may be used to return all parameters
to the original default values. </dd>
<dt class="dlterm">3 (Low Timeout Values / More Frequent Heartbeats)</dt>
<dd>Adjustments are made to cluster communications to decrease the heartbeating
interval and decrease the various message timeout values. With more frequent
heartbeats and shorter timeout values, the cluster is quicker to respond (more
sensitive) to communications failures.</dd>
</dl>
<p>Resultant example response times are shown in the following
table for a heartbeat failure leading to a node partition:</p>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" frame="border" border="1" rules="all"><thead align="left"><tr><th valign="top" id="d0e84">&nbsp;</th>
<th colspan="3" valign="top" id="d0e85">1 (Less sensitive)</th>
<th colspan="3" valign="top" id="d0e87">2 (Default)</th>
<th colspan="3" valign="top" id="d0e89">3 (More sensitive)</th>
</tr>
</thead>
<tbody><tr><td valign="top" headers="d0e84 ">&nbsp;</td>
<td valign="top" headers="d0e85 ">Detection of Heartbeat Problem</td>
<td valign="top" headers="d0e85 ">Analysis</td>
<td valign="top" headers="d0e85 ">Total</td>
<td valign="top" headers="d0e87 ">Detection of Heartbeat Problem</td>
<td valign="top" headers="d0e87 ">Analysis</td>
<td valign="top" headers="d0e87 ">Total</td>
<td valign="top" headers="d0e89 ">Detection of Heartbeat Problem</td>
<td valign="top" headers="d0e89 ">Analysis</td>
<td valign="top" headers="d0e89 ">Total</td>
</tr>
<tr><td valign="top" headers="d0e84 ">Single subnet</td>
<td valign="top" headers="d0e85 ">00:24</td>
<td valign="top" headers="d0e85 ">01:02</td>
<td valign="top" headers="d0e85 ">01:26</td>
<td valign="top" headers="d0e87 ">00:12</td>
<td valign="top" headers="d0e87 ">00:30</td>
<td valign="top" headers="d0e87 ">00:42</td>
<td valign="top" headers="d0e89 ">00:04</td>
<td valign="top" headers="d0e89 ">00:14</td>
<td valign="top" headers="d0e89 ">00:18</td>
</tr>
<tr><td valign="top" headers="d0e84 ">Multiple subnets</td>
<td valign="top" headers="d0e85 ">00:24</td>
<td valign="top" headers="d0e85 ">08:30</td>
<td valign="top" headers="d0e85 ">08:54</td>
<td valign="top" headers="d0e87 ">00:12</td>
<td valign="top" headers="d0e87 ">04:14</td>
<td valign="top" headers="d0e87 ">04:26</td>
<td valign="top" headers="d0e89 ">00:04</td>
<td valign="top" headers="d0e89 ">02:02</td>
<td valign="top" headers="d0e89 ">02:06</td>
</tr>
</tbody>
</table>
</div>
<div class="note"><span class="notetitle">Note:</span> <img src="./delta.gif" alt="Start of change" />Times are specified in minutes:seconds format.<img src="./deltaend.gif" alt="End of change" /></div>
<p>Depending
on typical network loads and specific physical media being used, a cluster
administrator might choose to adjust the heartbeating sensitivity and message
timeout levels. For example, with a high speed high-reliability transport,
such as OptiConnect with all systems in the cluster on a common OptiConnect
bus, one might desire to establish a more sensitive environment to ensure
quick detection leading to faster failover. Option 3 is chosen. If one were
running on a heavily loaded 10Mbs Ethernet bus and the default settings were
leading to occasional partitions just due to network peak loads, option 1
could be chosen to reduce clustering sensitivity to the peak loads.</p>
<p>The
Change Cluster Resource Services API also allows for tuning of specific individual
parameters where the network environmental requirements present unique situations.
For example, consider again a cluster with all nodes common on an OptiConnect
bus. Performance of cluster messages can be greatly enhanced by setting the
Message Fragment Size parameter to the maximum 32,500 bytes to better match
the OptiConnect Maximum Transmission Unit (MTU) size than does the default
1,464 bytes. This reduces the overhead of fragmentation and reassembly of
large messages. The benefit, of course, depends on the cluster applications
and usage of cluster messaging resulting from those applications. Other parameters
are defined in the API documentation and may be used to tune either the performance
of cluster messaging or change the sensitivity of the cluster to partitioning.</p>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="rzaigplan.htm" title="Find out what you need to do before you can set up clusters on your iSeries servers. Find out the prerequisites for clusters as well as hints on designing your cluster. Finally, read tips for setting up your network and some performance hints for clusters.">Plan for clusters</a></div>
</div>
<div class="relconcepts"><strong>Related concepts</strong><br />
<div><a href="rzaigmanagetune.htm" title="Since potentially significant differences exist in your communications environment, you have the capability to adjust variables that affect cluster communications to best match your environment.">Tune cluster performance</a></div>
</div>
</div>
</body>
</html>