195 lines
7.8 KiB
HTML
195 lines
7.8 KiB
HTML
|
|
<!doctype html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
|
<html>
|
|
<head><META http-equiv="Content-Type" content="text/html; charset=utf-8">
|
|
<title>Add Cluster Node Entry (ADDCLUNODE)</title>
|
|
<link rel="stylesheet" type="text/css" href="../rzahg/ic.css">
|
|
</head>
|
|
<body bgcolor="white">
|
|
<script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
|
|
<a name="ADDCLUNODE.Top_Of_Page"></a>
|
|
<h2>Add Cluster Node Entry (ADDCLUNODE)</h2>
|
|
<table width="100%">
|
|
<tr>
|
|
<td valign="top" align="left"><b>Where allowed to run: </b>All environments (*ALL)<br>
|
|
<b>Threadsafe: </b>No
|
|
</td>
|
|
<td valign="top" align="right">
|
|
<a href="#ADDCLUNODE.PARAMETERS.TABLE">Parameters</a><br>
|
|
<a href="#ADDCLUNODE.COMMAND.EXAMPLES">Examples</a><br>
|
|
<a href="#ADDCLUNODE.ERROR.MESSAGES">Error messages</a></td>
|
|
</tr>
|
|
</table>
|
|
|
|
<div> <a name="ADDCLUNODE"></a>
|
|
<p>The Add Cluster Node Entry (ADDCLUNODE) command is used to add a node to the membership list of an existing cluster.
|
|
</p>
|
|
<p>If the START parameter is set to *NO, the node that is being added will have a status of New and Cluster Resource Services will not be started on that node. The Start Cluster Node (STRCLUNOD) command can be called from a program running on one of the active nodes in the cluster to start Cluster Resource Services on a node that does not have a status of Active.
|
|
</p>
|
|
<p>If the START parameter on this command is set to *YES, Cluster Resource Services will be started on the node that is being added. If Cluster Resource Services is successfully started, the status for the added node will be set to Active. Successful completion of this command results in Cluster Resource Services jobs (QCSTCTL, QCSTCRGM, and a job for each cluster resource group object in the cluster) started in the QSYSWRK subsystem. If the Cluster Resource Services cannot be started, the status of the added node will be set to New.
|
|
</p>
|
|
<p>During the activation of Cluster Resource Services, the allow add to cluster (ALWADDCLU) network attribute is checked to see whether the node being added should be part of the cluster and whether to validate the cluster request through the use of X.509 digital certificates. If validation is required, the requesting node and the node being added must have the following installed on the systems:
|
|
</p>
|
|
<ul>
|
|
<li>Operating System option 34 (Digital Certificate Manager)
|
|
</li>
|
|
<li>Cryptographic Access Provider Product (AC2 or AC3)
|
|
</li>
|
|
</ul>
|
|
<p><b>Restrictions:</b>
|
|
</p>
|
|
<ol>
|
|
<li>You must have input/output system configuration (*IOSYSCFG) special authority to run this command.
|
|
</li>
|
|
<li>This command cannot be called from a cluster resource group exit program.
|
|
</li>
|
|
<li>This command cannot be issued on the node being added. You must issue the command from a node in the cluster that has a status of Active. If Cluster Resource Services has not been started on any of the nodes in the cluster, you must issue this command from the node where the cluster was originally created, and the START parameter must be set to *NO.
|
|
</li>
|
|
<li>The node being added to the cluster must not already be a member of this or any other cluster. A node can be a member of only one cluster.
|
|
</li>
|
|
<li>If the START parameter is set to *YES, the node must be IP reachable (TCP/IP active and the INETD server started).
|
|
</li>
|
|
<li>The command will fail if any node in the cluster has a status of Partition.
|
|
</li>
|
|
<li>If the START parameter is set to *YES, the potential node version of the node being added must be equal to the current cluster version or up to one level higher than the current cluster version. The potential node version and the current cluster version can be retrieved by using the Display Cluster Information (DSPCLUINF) command.
|
|
</li>
|
|
</ol>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ADDCLUNODE.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
|
|
<div>
|
|
<h3><a name="ADDCLUNODE.PARAMETERS.TABLE">Parameters</a></h3>
|
|
<table border="1" cellpadding="4" cellspacing="0">
|
|
<!-- col1="10" col2="15" col3="30" col4="10" -->
|
|
<tr>
|
|
<th bgcolor="aqua" valign="bottom" align="left">Keyword</th>
|
|
<th bgcolor="aqua" valign="bottom" align="left">Description</th>
|
|
<th bgcolor="aqua" valign="bottom" align="left">Choices</th>
|
|
<th bgcolor="aqua" valign="bottom" align="left">Notes</th>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#ADDCLUNODE.CLUSTER"><b>CLUSTER</b></a></td>
|
|
<td valign="top">Cluster</td>
|
|
<td valign="top"><i>Name</i></td>
|
|
<td valign="top">Required, Positional 1</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" rowspan="3"><a href="#ADDCLUNODE.NODE"><b>NODE</b></a></td>
|
|
<td valign="top">Node list</td>
|
|
<td valign="top"><i>Element list</i></td>
|
|
<td valign="top" rowspan="3">Required, Positional 2</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 1: Node identifier</td>
|
|
<td valign="top">
|
|
<i>Name</i></td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 2: IP address</td>
|
|
<td valign="top">
|
|
Values (up to 2 repetitions): <i>Character value</i></td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#ADDCLUNODE.START"><b>START</b></a></td>
|
|
<td valign="top">Start indicator</td>
|
|
<td valign="top"><b><u>*YES</u></b>, *NO</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ADDCLUNODE.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</div>
|
|
<div> <a name="ADDCLUNODE.CLUSTER"></a>
|
|
<h3>Cluster (CLUSTER)</h3>
|
|
<p>Specifies the cluster to which the node is being added.
|
|
</p>
|
|
<p>This is a required parameter.
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>name</i></b></dt>
|
|
<dd>Specify the name of the cluster to which the node is being added.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ADDCLUNODE.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="ADDCLUNODE.NODE"></a>
|
|
<h3>Node identifier (NODE)</h3>
|
|
<p>Specifies information about the node which will be placed in the cluster membership list.
|
|
</p>
|
|
<p>This is a required parameter.
|
|
</p>
|
|
<p><b>Element 1: Node identifier</b>
|
|
</p>
|
|
<p>A name that uniquely identifies a node.
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>node-identifier</i></b></dt>
|
|
<dd>Specify a name for the system.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Element 2: IP address</b>
|
|
</p>
|
|
<p>The cluster interface address is an IP address that is used by Cluster Resource Services to communicate with other nodes in the cluster. A maximum of 2 interface addresses per node can be specified.
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>character-value</i></b></dt>
|
|
<dd>Specify an IP address to be used to communicate with other nodes in the cluster. The address is in dotted decimal format.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ADDCLUNODE.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="ADDCLUNODE.START"></a>
|
|
<h3>Start indicator (START)</h3>
|
|
<p>Specifies whether or not Cluster Resource Services is to be started on the node being added.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*YES</u></b></dt>
|
|
<dd>Cluster Resource Services will be started on the node.
|
|
</dd>
|
|
<dt><b>*NO</b></dt>
|
|
<dd>Cluster Resource Services will not be started on any node.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ADDCLUNODE.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="ADDCLUNODE.COMMAND.EXAMPLES">Examples</a> </h3>
|
|
<p>
|
|
<pre>
|
|
ADDCLUNODE CLUSTER(MYCLUSTER) NODE(NODE1 ('2.5.35.117'))
|
|
START(*YES)
|
|
</pre>
|
|
</p>
|
|
<p>This command adds node NODE1 to the cluster MYCLUSTER. Node NODE1 is added to the cluster membership list and Cluster Resource Services is started on NODE1. Interface address 2.5.35.117 will be used by Cluster Resource Services to communicate with the new node.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ADDCLUNODE.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="ADDCLUNODE.ERROR.MESSAGES">Error messages</a> </h3>
|
|
<p><b><u>*ESCAPE Messages</u></b>
|
|
</p>
|
|
<dl>
|
|
<dt><b>CPF1999</b></dt>
|
|
<dd>Errors occurred on command.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ADDCLUNODE.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</body>
|
|
</html>
|