STRCLUNOD (Start Cluster Node)

STRCLUNOD Command syntax diagram

 

Purpose

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. Cluster Resource Service jobs (QCSTCTL, QCSTCRGM, and a job for each cluster resource group object in the cluster) will be started in the QSYSWRK subsystem on the node just started.

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:

• OS/400 option 34 (Digital Certificate Manager)
• Cryptographic Access Provider Product (AC2 or AC3)

If the cluster is partitioned, this command may be used to start nodes in the partition running this command.

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.

If the node being started is in a device domain, then OS/400 option 41, HA Switchable Resources, must be installed and a valid license key must exist on that node.

Restrictions

1. To use this command have *IOSYSCFG authority.
2. This command cannot be called from a cluster resource group exit program.
3. The node being started must exist in the cluster membership list.
4. If all nodes have a status of New, this command must be invoked on the node on which the cluster was originally created.
5. The node to be started must be IP reachable (TCP/IP is active and the INETD server is started).
6. The first time a node is started, this command must be invoked on a node that is active.

 

Required Parameters

CLUSTER

Specifies the name of the cluster that contain the node being started.

cluster-name: Specify the name of the cluster.

NODE

Specifies the node identifier being started.

node-identifier: Specify the name of the node being started.

Example for STRCLUNOD

STRCLUNOD CLUSTER(MYCLUSTER) NODE(NODE01) 

This command starts Cluster Resource Services on node NODE01 for cluster MYCLUSTER.

Error messages for STRCLUNOD

*ESCAPE Messages

CPF0001

Error found on &1 command.