Adding a Node to a Cluster

This section describes how to add a node to a global cluster or a zone cluster. You can create a new zone-cluster node on a node of the global cluster that hosts the zone cluster, as long as that global-cluster node does not already host a node of that particular zone cluster.

Specifying an IP address and NIC for each zone cluster node is optional.

If the original zone cluster node did not have a IP address or NIC specified, then you do not need to specify that information for the new zone cluster node.

In this chapter, phys-schost# reflects a global-cluster prompt. The clzonecluster interactive shell prompt is clzc:schost>.

The following table lists the tasks to perform to add a node to an existing cluster. Perform the tasks in the order shown.

Table 8-1 Task Map: Adding a Node to an Existing Global or Zone Cluster

How to Add a Node to an Existing Cluster

Before adding an Oracle Solaris host or a virtual machine to an existing global cluster or a zone cluster, ensure that the node has all of the necessary hardware correctly installed and configured, including an operational physical connection to the private cluster interconnect.

For hardware installation information, refer to the Oracle Solaris Cluster 4.0 Hardware Administration Manual or the hardware documentation that shipped with your server.

This procedure enables a machine to install itself into a cluster by adding its node name to the list of authorized nodes for that cluster.

The phys-schost# prompt reflects a global-cluster prompt. Perform this procedure on a global cluster.

This procedure provides the long forms of the Oracle Solaris Cluster commands. Most commands also have short forms. Except for the long and short forms of the command names, the commands are identical.

1. On a current global-cluster member, become superuser on the current cluster member. Perform these steps from a node of a global cluster.
2. Ensure that you have correctly completed all prerequisite hardware installation and configuration tasks that are listed in the task map for Table 8-1.
3. Install and configure the software on the new cluster node.

   Use the scinstall utility to complete the installation and configuration of the new node, as described in the Oracle Solaris Cluster Software Installation Guide.

4. Use the scinstall utility on the new node to configure that node in the cluster.
5. To manually add a node to a zone cluster, you must specify the Oracle Solaris host and the virtual node name.

   You must also specify a network resource to be used for public network communication on each node. In the following example, the zone name is sczone, and sc_ipmp0 is the IPMP group name.

   clzc:sczone>add node
   clzc:sczone:node>set physical-host=phys-cluster-3
   clzc:sczone:node>set hostname=hostname3
   clzc:sczone:node>add net
   clzc:sczone:node:net>set address=hostname3
   clzc:sczone:node:net>set physical=sc_ipmp0
   clzc:sczone:node:net>end
   clzc:sczone:node>end
   clzc:sczone>exit

   For detailed instructions on configuring the node, see Configuring a Zone Cluster in Oracle Solaris Cluster Software Installation Guide.

6. After you configure the node, reboot the node into cluster mode and install the zone cluster on the node.

   # clzc install zone-cluster

7. To prevent any new machines from being added to the cluster, from the clsetup utility type the number for the option to instruct the cluster to ignore requests to add new machines.

   Press the Return key.

   Follow the clsetup prompts. This option tells the cluster to ignore all requests over the public network from any new machine that is trying to add itself to the cluster.

8. Quit the clsetup utility.

Example 8-1 Adding a Global-Cluster Node to the Authorized Node List

The following example shows how to add a node named phys-schost-3 to the authorized node list in an existing cluster.

[Become superuser and execute the clsetup utility.]
phys-schost# clsetup
[Select New nodes>Specify the name of a machine which may add itself.]
[Answer the questions when prompted.]
[Verify that the command completed successfully.]
 
claccess allow -h phys-schost-3
 
    Command completed successfully.
[Select Prevent any new machines from being added to the cluster.]
[Quit the clsetup New Nodes Menu and Main Menu.]
[Install the cluster software.]

See Also

clsetup(1CL)

For a complete list of tasks for adding a cluster node, see Table 8-1, “Task Map: Adding a Cluster Node.”

To add a node to an existing resource group, see the Oracle Solaris Cluster Data Services Planning and Administration Guide.