ibm-information-center/dist/eclipse/plugins/i5OS.ic.cl_5.4.0.1/strclunod.htm

149 lines
5.2 KiB
HTML
Raw Normal View History

2024-04-02 14:02:31 +00:00
<!doctype html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head><META http-equiv="Content-Type" content="text/html; charset=utf-8">
<title>Start Cluster Node (STRCLUNOD)</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="STRCLUNOD.Top_Of_Page"></a>
<h2>Start Cluster Node (STRCLUNOD)</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="#STRCLUNOD.PARAMETERS.TABLE">Parameters</a><br>
<a href="#STRCLUNOD.COMMAND.EXAMPLES">Examples</a><br>
<a href="#STRCLUNOD.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="STRCLUNOD"></a>
<p>The Start Cluster Node (STRCLUNOD) command is used to start Cluster Resource Services on a node in the cluster. If Cluster Resource Services is successfully started on the node specified, the status of the node will be set to Active.
</p>
<p>As part of starting the node, Cluster Resource Services checks the allow add to cluster (ALWADDCLU) network attribute to see whether the node being started 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>
<ol>
<li>Operating System option 34 (Digital Certificate Manager)
</li>
<li>Cryptographic Access Provider Product (AC2 or AC3)
</li>
</ol>
<p>If the cluster is partitioned, this command may be used to start nodes in the partition running this command.
</p>
<p>The potential node version of the node being started 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.
</p>
<p>If the node being started is in a device domain, then Operating System option 41, HA Switchable Resources, must be installed and a valid license key must exist on that node.
</p>
<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>The node being started must exist in the cluster membership list.
</li>
<li>If all nodes have a status of New, this command must be invoked on the node on which the cluster was originally created.
</li>
<li>The node to be started must be IP reachable (TCP/IP is active and the INETD server is started).
</li>
<li>The first time a node is started, this command must be invoked on a node that is active.
</li>
</ol>
</div>
<table width="100%">
<tr><td align="right"><a href="#STRCLUNOD.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="STRCLUNOD.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="#STRCLUNOD.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"><a href="#STRCLUNOD.NODE"><b>NODE</b></a></td>
<td valign="top">Node identifier</td>
<td valign="top"><i>Name</i></td>
<td valign="top">Required, Positional 2</td>
</tr>
</table>
<table width="100%">
<tr><td align="right"><a href="#STRCLUNOD.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="STRCLUNOD.CLUSTER"></a>
<h3>Cluster (CLUSTER)</h3>
<p>Specifies the cluster that contains the node to be started.
</p>
<p>This is a required parameter.
</p>
<dl>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of the cluster.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#STRCLUNOD.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="STRCLUNOD.NODE"></a>
<h3>Node identifier (NODE)</h3>
<p>Specifies the node identifier to be started.
</p>
<p>This is a required parameter.
</p>
<dl>
<dt><b><i>name</i></b></dt>
<dd>Specify the node to be started.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#STRCLUNOD.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="STRCLUNOD.COMMAND.EXAMPLES">Examples</a> </h3>
<p>
<pre>
STRCLUNOD CLUSTER(MYCLUSTER) NODE(NODE01)
</pre>
</p>
<p>This command starts Cluster Resource Services on node NODE01 for cluster MYCLUSTER.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#STRCLUNOD.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="STRCLUNOD.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="#STRCLUNOD.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>