friedkiwi/ibm-information-center
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
14ed2849c6
ibm-information-center/dist/eclipse/plugins/i5OS.ic.rzaie_5.4.0.1/rzaiemod_ha.htm

489 lines
30 KiB
HTML
Raw Blame History

<?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="topic" />
<meta name="DC.Title" content="Module mod_ha" />
<meta name="copyright" content="(C) Copyright IBM Corporation 2002,2006" />
<meta name="DC.Rights.Owner" content="(C) Copyright IBM Corporation 2002,2006" />
<meta name="DC.Format" content="XHTML" />
<meta name="DC.Identifier" content="rzaiemod_ha" />
<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>Module mod_ha</title>
</head>
<body id="rzaiemod_ha"><a name="rzaiemod_ha"><!-- --></a>
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
<!--Java sync-link--><h1 class="topictitle1">Module mod_ha</h1>
<div><div class="important"><span class="importanttitle">Important:</span> Information
for this topic supports the latest PTF levels for HTTP Server for i5/OS .
It is recommended that you install the latest PTFs to upgrade to the latest
level of the HTTP Server for i5/OS. Some of the topics documented here are
not available prior to this update. See <a href="http://www-03.ibm.com/servers/eserver/iseries/software/http/services/service.html" target="_blank">http://www.ibm.com/servers/eserver/iseries/software/http/services/service.htm</a> <img src="www.gif" alt="Link outside Information Center" /> for more information. </div>
<p><strong>Summary</strong></p>
<p>The module mod_ha contains directives that define support for the highly
available HTTP Server function.</p>
<p><strong>Directives</strong></p>
<ul><li><a href="#hacgi">HACGI</a></li>
<li><a href="#hamodel">HAModel</a></li>
<li><a href="#lmexitprogram">LmExitProgram</a></li>
<li><a href="#lmintervaltime">LmIntervalTime</a></li>
<li><a href="#lmmaxreactivation">LmMaxReactivation</a></li>
<li><a href="#lmresponsetime">LmResponseTime</a></li>
<li><a href="#lmurlcheck">LmUrlCheck</a></li>
<li><a href="#lmurlcheckbackup">LmUrlCheckBackup</a></li>
</ul>
</div>
<div class="hr" id="hacgi"><a name="hacgi"><!-- --></a><h2 class="topictitle2">HACGI</h2>
<div>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" frame="void" border="0" rules="none"><tbody><tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Module">Module</a></strong>: mod_ha</td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Syntax">Syntax</a></strong>: HACGI <em>on | off</em> </td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Default">Default</a></strong>: HACGI off</td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Context">Context</a></strong>: <span id="hacgi__hacgi_context"><a name="hacgi__hacgi_context"><!-- --></a>server config, virtual
host, directory, .htaccess</span></td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Override">Override</a></strong>: none</td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Origin">Origin</a></strong>: <span id="hacgi__hacgi_origin"><a name="hacgi__hacgi_origin"><!-- --></a>iSeries™</span></td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__UsageConsiderations">Usage Considerations</a></strong>: A LoadModule is required in
the configuration file prior to using the directive. The statement should
be as follows: LoadModule ha_module /QSYS.LIB/QHTTPSVR.LIB/QZSRCORE.SRVPGM </td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Example">Example</a></strong>: HACGI on</td>
</tr>
</tbody>
</table>
</div>
<p>The HACGI directive specifies if CGI programs in a directory can be highly
available. The CGI programs in the specified directory must use the highly
available HTTP Server APIs.</p>
<blockquote><dl><dt class="dlterm"><strong>Parameter</strong>: <em>on | off</em></dt>
<dd><ul><li>The <em>on</em> parameter value specifies CGI programs in a directory can
be highly available.</li>
<li>The <em>off</em> parameter value specifies CGI programs in a directory are
not high available.</li>
</ul>
</dd>
</dl>
</blockquote>
</div>
</div>
<div class="hr" id="hamodel"><a name="hamodel"><!-- --></a><h2 class="topictitle2">HAModel</h2>
<div>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" frame="void" border="0" rules="none"><tbody><tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Module">Module</a></strong>: mod_ha</td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Syntax">Syntax</a></strong>: HAModel <em>model</em></td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Default">Default</a></strong>: none</td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Context">Context</a></strong>: <span id="hamodel__hamodel_context"><a name="hamodel__hamodel_context"><!-- --></a>server config</span></td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Override">Override</a></strong>: none</td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Origin">Origin</a></strong>: <span id="hamodel__hamodel_origin"><a name="hamodel__hamodel_origin"><!-- --></a>iSeries</span></td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__UsageConsiderations">Usage Considerations</a></strong>: A LoadModule is required in
the configuration file prior to using the directive. The statement should
be as follows: LoadModule ha_module /QSYS.LIB/QHTTPSVR.LIB/QZSRCORE.SRVPGM </td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Example">Example</a></strong>: HAModel PrimaryBackupWithIpTakeover</td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Example">Example</a></strong>: HAModel PrimaryBackupWithDispatcher </td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Example">Example</a></strong>: HAModel PurePeer </td>
</tr>
</tbody>
</table>
</div>
<p>The HAModel directive establishes which highly available model is to be
used (PrimaryBackupWithIpTakeover, PrimaryBackupWithDispatcher, or PurePeer).</p>
<blockquote><dl><dt class="dlterm"><strong>Parameter</strong>: <em>model</em></dt>
<dd><ul><li>The <em>PrimaryBackupWithIpTakeover</em> parameter value specifies that
the highly available Web server runs on the primary and all backup nodes.
The backup node or nodes are in a idle state, ready to become the primary
Web server should the primary Web server fail (failover), or a switchover
takes place.</li>
<li>The <em>PrimaryBackupWithDispatcher</em> parameter value specifies that
the highly available Web server runs on the primary and all backup nodes.
The backup nodes are in an idle state and all client requests are served by
the primary node. A network dispatcher (for example the IBM<sup>®</sup> WebSphere<sup>®</sup> Edge
Server) sends client requests to the Web server.</li>
<li>The <em>PurePeer</em> parameter value specifies that all highly available
nodes are in an active state and serve client requests. A network dispatcher
(for example the IBM WebSphere Edge Server) evenly distributes requests to
different cluster nodes. This guarantees distribution of resources in case
of heavy load. Linear scalability is not guaranteed beyond a small number
of nodes. After some number of nodes are added, scalability can disappear,
and the cluster performance can deteriorate.</li>
</ul>
</dd>
</dl>
</blockquote>
<p>See <a href="rzaiehighavailability.htm">Highly available Web server cluster on HTTP Server</a> for more
information regarding highly available Web server models.</p>
<blockquote><dl><dt class="dlterm"><strong>Example</strong></dt>
<dd><pre>LoadModule ha_module /QSYS.LIB/QHTTPSVR.LIB/QZSRCORE.SRVPGM
<strong>HAModel PrimaryBackupWithIPTakeover</strong>
LmUrlCheck http://hostname/web/docs/spec/wscheck.html
LmIntervalTime 100
LmMaxReactivation 5
LmResponseTime 300</pre>
</dd>
</dl>
</blockquote>
<div class="note"><span class="notetitle">Note:</span> When a server is configured as highly available (HAModel directive is
specified), <a href="rzaiemod_core.htm#hotbackup">HotBackup</a> behaves
as if it is set to 'off' and can not be overwritten.</div>
</div>
</div>
<div class="hr" id="lmexitprogram"><a name="lmexitprogram"><!-- --></a><h2 class="topictitle2">LmExitProgram</h2>
<div>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" frame="void" border="0" rules="none"><tbody><tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Module">Module</a></strong>: mod_ha</td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Syntax">Syntax</a></strong>: LmExitProgram <em>libraryname programname</em></td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Default">Default</a></strong>: none</td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Context">Context</a></strong>: <span id="lmexitprogram__lmexitprogram_context"><a name="lmexitprogram__lmexitprogram_context"><!-- --></a>server config</span></td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Override">Override</a></strong>: none</td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Origin">Origin</a></strong>: <span id="lmexitprogram__lmexitprogram_origin"><a name="lmexitprogram__lmexitprogram_origin"><!-- --></a>iSeries</span></td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__UsageConsiderations">Usage Considerations</a></strong>: A LoadModule is required in
the configuration file prior to using the directive. The statement should
be as follows: LoadModule ha_module /QSYS.LIB/QHTTPSVR.LIB/QZSRCORE.SRVPGM </td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Example">Example</a></strong>: LmExitProgram httptest exitpgm</td>
</tr>
</tbody>
</table>
</div>
<p>The LmExitProgram directive configures a QSYS program that is started by
the Liveness monitor whenever it initiates a change in the HA model of a server
instance from the primary model or to the primary model. When the server
instance is going to become the primary HA server instance, then this program
is called with a parameter of '1'. When the current HA primary server instance
is no longer going to be the primary instance, then this program is called
with a parameter of '0'. For example a program can be created which will
start or end a job, depending on the function of the server.</p>
<blockquote><dl><dt class="dlterm"><strong>Parameter One</strong>: <em>libraryname</em></dt>
<dd><ul><li>The <em>libraryname</em> parameter value specifies the name of the library
to be used. The parameter value can be up to 10 characters and must follow
the rules for iSeries library names.</li>
</ul>
</dd>
</dl>
<dl><dt class="dlterm"><strong>Parameter Two</strong>: <em>programname</em></dt>
<dd><ul><li>The <em>programname</em> parameter value specifies the name of the program
to be used. The parameter value can be up to 10 characters and must also follow
the iSeries rules for program names in a library.</li>
</ul>
</dd>
</dl>
</blockquote>
<div class="note"><span class="notetitle">Note:</span> Only QSYS library/program can be used.</div>
</div>
</div>
<div class="hr" id="lmintervaltime"><a name="lmintervaltime"><!-- --></a><h2 class="topictitle2">LmIntervalTime</h2>
<div>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" frame="void" border="0" rules="none"><tbody><tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Module">Module</a></strong>: mod_ha</td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Syntax">Syntax</a></strong>: LmIntervalTime <em>interval</em></td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Default">Default</a></strong>: LmIntervalTime 15</td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Context">Context</a></strong>: <span id="lmintervaltime__lmintervaltime_context"><a name="lmintervaltime__lmintervaltime_context"><!-- --></a>server
config</span></td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Override">Override</a></strong>: none</td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Origin">Origin</a></strong>: <span id="lmintervaltime__lmintervaltime_origin"><a name="lmintervaltime__lmintervaltime_origin"><!-- --></a>iSeries</span></td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__UsageConsiderations">Usage Considerations</a></strong>: A LoadModule is required in
the configuration file prior to using the directive. The statement should
be as follows: LoadModule ha_module /QSYS.LIB/QHTTPSVR.LIB/QZSRCORE.SRVPGM</td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Example">Example</a></strong>: LmIntervalTime 30</td>
</tr>
</tbody>
</table>
</div>
<p>The LmIntervalTime directive is used by the Liveness Monitor to specify
how often (in seconds, between performing Web server Liveness checks (HEAD
or GET)) a liveness check should be performed on the server. The LmResponseTime
and LmIntervalTime directives are independent. One sends out checks (LmIntervalTime),
while the other tests for responses (LmResponseTime). The LmResponseTime value
should always be larger than the LmIntervalTime value. It is recommended that
LmResponseTime be at least 3 times larger than LmIntervalTime. </p>
<blockquote><dl><dt class="dlterm"><strong>Parameter</strong>: <em>integer </em></dt>
<dd><ul><li>The <em>interval</em> parameter value specifies how often (in seconds, between
performing Web server Liveness checks (HEAD or GET)) a liveness check should
be performed on the server. Valid values include integers between 0 and 4,294,967,295.</li>
</ul>
</dd>
</dl>
<dl><dt class="dlterm"><strong>Example</strong></dt>
<dd><pre>LoadModule ha_module /QSYS.LIB/QHTTPSVR.LIB/QZSRCORE.SRVPGM
HAModel PrimaryBackupWithIPTakeover
LmUrlCheck http://hostname/web/docs/spec/wscheck.html
<strong>LmIntervalTime 100</strong>
LmMaxReactivation 5
LmResponseTime 300</pre>
</dd>
</dl>
</blockquote>
</div>
</div>
<div class="hr" id="lmmaxreactivation"><a name="lmmaxreactivation"><!-- --></a><h2 class="topictitle2">LmMaxReactivation</h2>
<div>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" frame="void" border="0" rules="none"><tbody><tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Module">Module</a></strong>: mod_ha</td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Syntax">Syntax</a></strong>: LmMaxReactivation <em>integer</em></td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Default">Default</a></strong>: LmMaxReactivation 3 </td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Context">Context</a></strong>: <span id="lmmaxreactivation__lmmaxreactivation_context"><a name="lmmaxreactivation__lmmaxreactivation_context"><!-- --></a>server
config</span></td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Override">Override</a></strong>: none</td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Origin">Origin</a></strong>: <span id="lmmaxreactivation__lmmaxreactivation_origin"><a name="lmmaxreactivation__lmmaxreactivation_origin"><!-- --></a>iSeries</span></td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__UsageConsiderations">Usage Considerations</a></strong>: A LoadModule is required in
the configuration file prior to using the directive. The statement should
be as follows: LoadModule ha_module /QSYS.LIB/QHTTPSVR.LIB/QZSRCORE.SRVPGM</td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Example">Example</a></strong>: LmMaxReactivation 5</td>
</tr>
</tbody>
</table>
</div>
<p>The LmMaxReactivation directive specifies how many times the Liveness Monitor
should attempt to reactivate the Web server after a detected failure. </p>
<blockquote><dl><dt class="dlterm"><strong>Parameter</strong>: <em>integer</em></dt>
<dd><ul><li>The <em>integer</em> parameter value specifies how many times the Liveness
Monitor should attempt to reactivate the Web server after a detected failure.
Valid values include integers between 0 and 2,147,483,647</li>
</ul>
</dd>
</dl>
<dl><dt class="dlterm"><strong>Example</strong></dt>
<dd><pre>LoadModule ha_module /QSYS.LIB/QHTTPSVR.LIB/QZSRCORE.SRVPGM
HAModel PrimaryBackupWithIPTakeover
LmUrlCheck http://hostname/web/docs/spec/wscheck.html
LmIntervalTime 100
<strong>LmMaxReactivation 5</strong>
LmResponseTime 300</pre>
</dd>
</dl>
</blockquote>
</div>
</div>
<div class="hr" id="lmresponsetime"><a name="lmresponsetime"><!-- --></a><h2 class="topictitle2">LmResponseTime</h2>
<div>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" frame="void" border="0" rules="none"><tbody><tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Module">Module</a></strong>: mod_ha</td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Syntax">Syntax</a></strong>: LmResponseTime <em>interval</em></td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Default">Default</a></strong>: LmResponseTime 120</td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Context">Context</a></strong>: <span id="lmresponsetime__lmresponsetime_context"><a name="lmresponsetime__lmresponsetime_context"><!-- --></a>server
config</span></td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Override">Override</a></strong>: none</td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Origin">Origin</a></strong>: <span id="lmresponsetime__lmresponsetime_origin"><a name="lmresponsetime__lmresponsetime_origin"><!-- --></a>iSeries</span></td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__UsageConsiderations">Usage Considerations</a></strong>: A LoadModule is required in
the configuration file prior to using the directive. The statement should
be as follows: LoadModule ha_module /QSYS.LIB/QHTTPSVR.LIB/QZSRCORE.SRVPGM</td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Example">Example</a></strong>: LmResponseTime 60</td>
</tr>
</tbody>
</table>
</div>
<p>The LmResponseTime directive specifies how long the Liveness Monitor should
wait for a response from the Web server before taking appropriate action (based
on the other Liveness Monitor directive settings). The LmResponseTime and
LmIntervalTime directives are independent. One sends out checks (LmIntervalTime),
while the other tests for responses (LmResponseTime). The LmResponseTime value
should always be larger than the LmIntervalTime value. It is recommended that
LmResponseTime be at least 3 times larger than LmIntervalTime. </p>
<blockquote><dl><dt class="dlterm"><strong>Parameter</strong>: <em>interval</em></dt>
<dd><ul><li>The <em>interval</em> parameter value specifies how long the Liveness Monitor
should wait for a response from the Web server before taking appropriate action
(based on the other Liveness Monitor directive settings).</li>
</ul>
</dd>
</dl>
<dl><dt class="dlterm"><strong>Example</strong></dt>
<dd><pre>LoadModule ha_module /QSYS.LIB/QHTTPSVR.LIB/QZSRCORE.SRVPGM
HAModel PrimaryBackupWithIPTakeover
LmUrlCheck http://hostname/web/docs/spec/wscheck.html
LmIntervalTime 100
LmMaxReactivation 5
<strong>LmResponseTime 300</strong></pre>
</dd>
</dl>
</blockquote>
</div>
</div>
<div class="hr" id="lmurlcheck"><a name="lmurlcheck"><!-- --></a><h2 class="topictitle2">LmUrlCheck</h2>
<div>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" frame="void" border="0" rules="none"><tbody><tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Module">Module</a></strong>: mod_ha</td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Syntax">Syntax</a></strong>: LmUrlCheck <em>URL</em></td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Default">Default</a></strong>: LmUrlCheck http://</td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Context">Context</a></strong>: <span id="lmurlcheck__lmurlcheck_context"><a name="lmurlcheck__lmurlcheck_context"><!-- --></a>server config</span></td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Override">Override</a></strong>: none</td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Origin">Origin</a></strong>: <span id="lmurlcheck__lmurlcheck_origin"><a name="lmurlcheck__lmurlcheck_origin"><!-- --></a>iSeries</span></td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__UsageConsiderations">Usage Considerations</a></strong>: A LoadModule is required in
the configuration file prior to using the directive. The statement should
be as follows: LoadModule ha_module /QSYS.LIB/QHTTPSVR.LIB/QZSRCORE.SRVPGM</td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Example">Example</a></strong>: LmUrlCheck http://194.170.2.5:8000/web/docs/spec/wscheck.html</td>
</tr>
</tbody>
</table>
</div>
<p>The LmUrlCheck directive specifies a fully qualified URL that is used by
the Liveness Monitor to perform liveness checks on HTTP Server. Specifying
a domain name is not valid for this directive. Only one IP address can be
specified in a highly available HTTP Server configuration.</p>
<div class="note"><span class="notetitle">Note:</span> This is a required directive for highly available and must exist in
the global server configuration context and not in a container. See <a href="#hamodel">HAModel</a> and <a href="rzaiehighavailability.htm">Highly available Web server cluster on HTTP Server</a> for additional details.</div>
<blockquote><dl><dt class="dlterm"><strong>Parameter</strong>: <em>URL</em></dt>
<dd><ul><li>The <em>URL</em> parameter value specifies a fully qualified URL that is
used by the Liveness Monitor to perform liveness checks on the server. Only
one IP address can be specified in a highly available server configuration.
Specifying a domain name is not valid for this parameter. The IP Address must
be the same address as specified with the Listen directive. The default port
number is 80</li>
</ul>
</dd>
</dl>
<dl><dt class="dlterm"><strong>Example</strong></dt>
<dd><pre>LoadModule ha_module /QSYS.LIB/QHTTPSVR.LIB/QZSRCORE.SRVPGM
HAModel PrimaryBackupWithIPTakeover
<strong>LmUrlCheck http://194.170.2.5:8000/web/docs/spec/wscheck.html</strong>
LmIntervalTime 20
LmMaxReactivation 3
LmResponseTime 60</pre>
</dd>
</dl>
</blockquote>
<p>Specify <em>https</em> when the HTTP Server instance is configured to receive
client requests using only secure sockets. The IP address must be the same
as the IP address that was specified in the virtual host container for the
SSL application. The default port number for SSL is 443. </p>
<blockquote><dl><dt class="dlterm"><strong>Example</strong></dt>
<dd><pre>LoadModule ha_module /QSYS.LIB/QHTTPSVR.LIB/QZSRCORE.SRVPGM
HAModel PrimaryBackupWithIPTakeover
<strong>LmUrlCheck https://194.170.2.5:8008/web/docs/spec/wscheck.html</strong>
LmIntervalTime 20
LmMaxReactivation 3
LmResponseTime 60</pre>
</dd>
</dl>
</blockquote>
</div>
</div>
<div class="hr" id="lmurlcheckbackup"><a name="lmurlcheckbackup"><!-- --></a><h2 class="topictitle2">LmUrlCheckBackup</h2>
<div>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" frame="void" border="0" rules="none"><tbody><tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Module">Module</a></strong>: mod_ha</td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Syntax">Syntax</a></strong>: LmUrlCheckBackup <em>URL</em></td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Default">Default</a></strong>: none</td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Context">Context</a></strong>: <span id="lmurlcheckbackup__lmurlcheckbackup_context"><a name="lmurlcheckbackup__lmurlcheckbackup_context"><!-- --></a>server
config</span></td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Override">Override</a></strong>: none</td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Origin">Origin</a></strong>: <span id="lmurlcheckbackup__lmurlcheckbackup_origin"><a name="lmurlcheckbackup__lmurlcheckbackup_origin"><!-- --></a>iSeries</span></td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__UsageConsiderations">Usage Considerations</a></strong>: A LoadModule is required in
the configuration file prior to using the directive. The statement should
be as follows: LoadModule ha_module /QSYS.LIB/QHTTPSVR.LIB/QZSRCORE.SRVPGM</td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Example">Example</a></strong>: LmUrlCheckBackup http://194.170.2.5:8008/web/docs/spec/wscheck.html</td>
</tr>
</tbody>
</table>
</div>
<p>The LmUrlCheckBackup directive specifies a fully qualified URL that is
used by the Liveness Monitor to perform liveness checks on the HA backup server
instance. If this directive is not configured, then the URL passed is the
URL parameter value specified on the LmUrlCheck directive. </p>
<p>For example, if the server is configured to run Payment Manager, only one
instance of Payment Manager can be active in the cluster at any given time.
If the URL on the LmUrlCheck directive specifies a URL for the Payment Manager,
then this same URL will not work for the HA backup server instance, so the
LmUrlCheckBackup directive needs to be configured to use a non-Payment Manager
URL.</p>
<div class="note"><span class="notetitle">Note:</span> This directive is ignored when HAModel <em>PurePeer</em> is configured.</div>
<blockquote><dl><dt class="dlterm"><strong>Parameter</strong>: <em>URL</em></dt>
<dd><ul><li>The <em>URL</em> parameter value specifies a fully qualified URL that is
used by the Liveness Monitor to perform liveness checks on the HTTP Server
when the server is currently the HA backup server. The use of a domain name
is not a valid parameter with this directive. Only one IP address can be specified
in a High Availability server configuration (i.e. Listen 194.170.2.5:xxxxxx &lt;virtual
host 194.170.2.5:yyyyyy&gt;). The IP Address must be the same address as specified
with the Listen directive. The default port number is 80. </li>
</ul>
</dd>
</dl>
<dl><dt class="dlterm"><strong>Example</strong></dt>
<dd><pre>LoadModule ha_module /QSYS.LIB/QHTTPSVR.LIB/QZSRCORE.SRVPGM
HAModel Primary/BackupWithIPTakeover
LmUrlCheck http://194.170.2.5:8008/web/docs/spec/wscheck.html
<strong>LmUrlCheckBackup http://194.170.2.5:8008/web/docs/spec/wscheckbackup.html</strong>
LmIntervalTime 20
LmMaxReactivation 3
LmResponseTime 60</pre>
</dd>
</dl>
</blockquote>
<p>Specify <em>https</em> when the HTTP Server instance is configured to receive
client requests using only secure sockets. The IP address must be the same
as the IP address that was specified in the virtual host container for the
SSL application. The default port number for SSL is 443.</p>
<blockquote><dl><dt class="dlterm"><strong>Example</strong></dt>
<dd><pre>LoadModule ha_module /QSYS.LIB/QHTTPSVR.LIB/QZSRCORE.SRVPGM
HAModel Primary/BackupWithIPTakeover
LmUrlCheck http://194.170.2.5:8008/web/docs/spec/wscheck.html
<strong>LmUrlCheckBackup https://194.170.2.5:8008/web/docs/spec/wscheckbackup.html</strong>
LmIntervalTime 20
LmMaxReactivation 3
LmResponseTime 60</pre>
</dd>
</dl>
</blockquote>
<div class="note"><span class="notetitle">Note:</span> This directive is ignored when HAModel <em>PurePeer</em> is configured.</div>
</div>
</div>
</body>
</html>
Reference in New Issue View Git Blame Copy Permalink