223 lines
9.5 KiB
HTML
223 lines
9.5 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>Change Cluster Node Entry (CHGCLUNODE)</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="CHGCLUNODE.Top_Of_Page"></a>
|
|
<h2>Change Cluster Node Entry (CHGCLUNODE)</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="#CHGCLUNODE.PARAMETERS.TABLE">Parameters</a><br>
|
|
<a href="#CHGCLUNODE.COMMAND.EXAMPLES">Examples</a><br>
|
|
<a href="#CHGCLUNODE.ERROR.MESSAGES">Error messages</a></td>
|
|
</tr>
|
|
</table>
|
|
|
|
<div> <a name="CHGCLUNODE"></a>
|
|
<p>The Change Cluster Node Entry (CHGCLUNODE) command is used to change cluster membership information for a cluster node entry. The information that can be changed is the cluster interface addresses defined for the node and status of the node. The node entry which is being changed may or may not have Cluster Resource Services started.
|
|
</p>
|
|
<p>You can add, remove, or replace an interface address for the cluster node. The cluster interface address is an IP address that is used by Cluster Resource Services to communicate with other nodes in the cluster. The address is in dotted decimal format.
|
|
</p>
|
|
<p>You can also change the the status of a node to Failed. Using this command to change the status of a node to Failed provides a way to tell Cluster Resource Services that a node has really failed. There are certain failure conditions that Cluster Resource Services cannot detect as a node failure. Rather, the problem appears to be a communication problem and the cluster looks like it has become partitioned. By telling Cluster Resource Services that a node has failed, it makes recovery from the partition state simpler for primary-backup model cluster resource groups since a backup node from the remaining active cluster nodes can then be assigned as the primary node.
|
|
</p>
|
|
<p>For primary-backup model cluster resource groups:
|
|
</p>
|
|
<ul>
|
|
<li>When you change the status of a node to Failed, the role of nodes in the recovery domain for each cluster resource group in the partition may be reordered by assigning the specified node as the last backup. If an exit program is specified for the cluster resource group, it will be called with an action code of Change Node Status. If multiple nodes have failed and their status needs to be changed, the order in which the nodes are changed will affect the final order of the recovery domain's backup nodes in the cluster resource group.
|
|
</li>
|
|
<li>If the node status is changed to failed and the node was the primary node for a cluster resource group, the first active backup will be reassigned as the new primary node. When this occurs for a device cluster resource group, ownership of the hardware will be moved to the new primary node.
|
|
</li>
|
|
</ul>
|
|
<p>If a problem is detected and the command does not complete successfully, the command can be run again once the problem is corrected. Any cluster resource group that had already had the status of a node changed from Partition to Failed and the recovery domain order changed will not be affected by running this command again.
|
|
</p>
|
|
<p><b>Warning:</b> Changing the node status to failed when, in fact, the node is still active and a true partition has occurred should not be done. Doing so for primary-backup model cluster resource groups, allows a node in each partition to become the primary node for a cluster resource group. When two nodes think they are the primary node, data such as files or data bases could become corrupted if two different nodes are each making independent changes to copies of their files. In addition, the two partitions cannot be merged back together when a node in each partition has been assigned the primary role.
|
|
</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>This command must be called from a program running on a cluster node with a status of Active.
|
|
</li>
|
|
<li>If the cluster is in a partitioned state, this operation can only be performed within the partition running the command.
|
|
</li>
|
|
<li>Only one cluster interface address can be changed at a time. If the cluster is in partitioned state, the change cluster interface address is only allowed for a node within the same partition.
|
|
</li>
|
|
<li>To change the cluster node status, only a node that has a status of Partition or Failed can be changed and it can only be changed to Failed status.
|
|
</li>
|
|
</ol>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGCLUNODE.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
|
|
<div>
|
|
<h3><a name="CHGCLUNODE.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="#CHGCLUNODE.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="#CHGCLUNODE.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>
|
|
<tr>
|
|
<td valign="top"><a href="#CHGCLUNODE.OPTION"><b>OPTION</b></a></td>
|
|
<td valign="top">Option</td>
|
|
<td valign="top">*ADDIFC, *RMVIFC, *CHGIFC, *CHGSTS</td>
|
|
<td valign="top">Required, Positional 3</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CHGCLUNODE.OLDINTNETA"><b>OLDINTNETA</b></a></td>
|
|
<td valign="top">Old IP address</td>
|
|
<td valign="top"><i>Character value</i></td>
|
|
<td valign="top">Optional, Positional 4</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CHGCLUNODE.NEWINTNETA"><b>NEWINTNETA</b></a></td>
|
|
<td valign="top">New IP address</td>
|
|
<td valign="top"><i>Character value</i></td>
|
|
<td valign="top">Optional, Positional 5</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGCLUNODE.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</div>
|
|
<div> <a name="CHGCLUNODE.CLUSTER"></a>
|
|
<h3>Cluster (CLUSTER)</h3>
|
|
<p>Specifies the cluster that contains the node being changed.
|
|
</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="#CHGCLUNODE.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGCLUNODE.NODE"></a>
|
|
<h3>Node identifier (NODE)</h3>
|
|
<p>Specifies the node being changed.
|
|
</p>
|
|
<p>This is a required parameter.
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>name</i></b></dt>
|
|
<dd>Specify the name of the node being changed.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGCLUNODE.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGCLUNODE.OPTION"></a>
|
|
<h3>Option (OPTION)</h3>
|
|
<p>Indicates what is being changed.
|
|
</p>
|
|
<p>This is a required parameter.
|
|
</p>
|
|
<dl>
|
|
<dt><b>*ADDIFC</b></dt>
|
|
<dd>Add an internet address for the specified node.
|
|
</dd>
|
|
<dt><b>*RMVIFC</b></dt>
|
|
<dd>Remove an internet address for the specified node.
|
|
</dd>
|
|
<dt><b>*CHGIFC</b></dt>
|
|
<dd>Replace an internet address for the specified node with a different existing internet address.
|
|
</dd>
|
|
<dt><b>*CHGSTS</b></dt>
|
|
<dd>Change cluster node status from Partition or Failed to Failed.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGCLUNODE.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGCLUNODE.OLDINTNETA"></a>
|
|
<h3>Old IP address (OLDINTNETA)</h3>
|
|
<p>Specifies the cluster interface address which is being replaced or removed. The address is in dotted decimal format.
|
|
</p>
|
|
<p>This is a required parameter.
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>character-value</i></b></dt>
|
|
<dd>Specify the cluster interface address to be changed.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGCLUNODE.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGCLUNODE.NEWINTNETA"></a>
|
|
<h3>New IP address (NEWINTNETA)</h3>
|
|
<p>Specifies the cluster interface address which is being added to the node information or replacing an old cluster interface address. The address is in dotted decimal format.
|
|
</p>
|
|
<p>This is a required parameter.
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>character-value</i></b></dt>
|
|
<dd>Specify the cluster interface address which is to be used to communicate with the node.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGCLUNODE.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="CHGCLUNODE.COMMAND.EXAMPLES">Examples</a> </h3>
|
|
<p>
|
|
<pre>
|
|
CHGCLUNODE CLUSTER(MYCLUSTER) NODE(NODE01) OPTION(*CHGSTS)
|
|
</pre>
|
|
</p>
|
|
<p>This command changes the status of node NODE01 in cluster MYCLUSTER to Failed.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGCLUNODE.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="CHGCLUNODE.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="#CHGCLUNODE.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</body>
|
|
</html>
|