Perform this procedure to add a new node to an existing cluster. To use JumpStart to add a new node, instead follow procedures in How to Install Solaris and Sun Cluster Software (JumpStart).
Perform the following tasks:
Ensure that all necessary hardware is installed.
Ensure that the host adapter is installed on the new node. See the Sun Cluster 3.0-3.1 Hardware Administration Manual for Solaris OS.
Verify that any existing cluster interconnects can support the new node. See the Sun Cluster 3.0-3.1 Hardware Administration Manual for Solaris OS.
Ensure that any additional storage is installed. See the appropriate manual from the Sun Cluster 3.x Hardware Administration Collection.
Ensure that the Solaris OS is installed to support Sun Cluster software.
If Solaris software is already installed on the node, you must ensure that the Solaris installation meets the requirements for Sun Cluster software and any other software that you intend to install on the cluster. See How to Install Solaris Software for more information about installing Solaris software to meet Sun Cluster software requirements.
Ensure that Sun Cluster software packages are installed on the node. See How to Install Sun Cluster Framework and Data-Service Software Packages (Java ES installer).
Determine which mode of the scinstall utility you will use, Typical or Custom. For the Typical installation of Sun Cluster software, scinstall automatically specifies the following configuration defaults.
Component |
Default Value |
---|---|
Cluster-transport junctions |
switch1 and switch2 |
Global-devices file-system name |
/globaldevices |
Solaris and Sun Cluster patch directory |
/var/cluster/patches |
Complete one of the following configuration planning worksheets. See Planning the Solaris OS and Planning the Sun Cluster Environment for planning guidelines.
Typical Mode - If you will use Typical mode and accept all defaults, complete the following worksheet.
Custom Mode - If you will use Custom mode and customize the configuration data, complete the following worksheet.
Follow these guidelines to use the interactive scinstall utility in this procedure:
Interactive scinstall enables you to type ahead. Therefore, do not press the Return key more than once if the next menu screen does not appear immediately.
Unless otherwise noted, you can press Control-D to return to either the start of a series of related questions or to the Main Menu.
Default answers or answers to previous sessions are displayed in brackets ([ ]) at the end of a question. Press Return to enter the response that is in brackets without typing it.
If you are adding this node to a single-node cluster, ensure that two cluster interconnects already exist by displaying the interconnect configuration.
# scconf -p | grep cable # scconf -p | grep adapter |
You must have at least two cables or two adapters configured before you can add a node.
If the output shows configuration information for two cables or for two adapters, proceed to Step 2.
If the output shows no configuration information for either cables or adapters, or shows configuration information for only one cable or adapter, configure new cluster interconnects.
On the existing cluster node, start the scsetup(1M) utility.
# scsetup |
Choose the menu item, Cluster interconnect.
Choose the menu item, Add a transport cable.
Follow the instructions to specify the name of the node to add to the cluster, the name of a transport adapter, and whether to use a transport junction.
If necessary, repeat Step c to configure a second cluster interconnect.
When finished, quit the scsetup utility.
Verify that the cluster now has two cluster interconnects configured.
# scconf -p | grep cable # scconf -p | grep adapter |
The command output should show configuration information for at least two cluster interconnects.
If you are adding this node to an existing cluster, add the new node to the cluster authorized–nodes list.
On any active cluster member, start the scsetup(1M) utility.
# scsetup |
The Main Menu is displayed.
Choose the menu item, New nodes.
Choose the menu item, Specify the name of a machine which may add itself.
Follow the prompts to add the node's name to the list of recognized machines.
The scsetup utility prints the message Command completed successfully if the task is completed without error.
Quit the scsetup utility.
Become superuser on the cluster node to configure.
Start the scinstall utility.
# /usr/cluster/bin/scinstall |
From the Main Menu, choose the menu item, Install a cluster or cluster node.
*** Main Menu *** Please select from one of the following (*) options: * 1) Install a cluster or cluster node 2) Configure a cluster to be JumpStarted from this install server 3) Add support for new data services to this cluster node 4) Upgrade this cluster node * 5) Print release information for this cluster node * ?) Help with menu options * q) Quit Option: 1 |
From the Install Menu, choose the menu item, Add this machine as a node in an existing cluster.
Follow the menu prompts to supply your answers from the configuration planning worksheet.
The scinstall utility configures the node and boots the node into the cluster.
Change to a directory that does not reside on the CD-ROM and eject the CD-ROM.
# eject cdrom |
Install any necessary patches to support Sun Cluster software, if you have not already done so.
Repeat this procedure on any other node to add to the cluster until all additional nodes are fully configured.
For the Solaris 10 OS, verify on each node that multi-user services for the Service Management Facility (SMF) are online.
If services are not yet online for a node, wait until the state becomes online before you proceed to the next step.
# svcs multi-user-server STATE STIME FMRI online 17:52:55 svc:/milestone/multi-user-server:default |
From an active cluster member, prevent any other nodes from joining the cluster.
# /usr/cluster/bin/scconf -a -T node=. |
Specifies the add form of the command
Specifies authentication options
Specifies the node name of dot (.) to add to the authentication list, to prevent any other node from adding itself to the cluster
Alternately, you can use the scsetup(1M) utility. See How to Add a Node to the Authorized Node List in Sun Cluster System Administration Guide for Solaris OS for procedures.
From one node, verify that all nodes have joined the cluster.
Run the scstat(1M) command to display a list of the cluster nodes. You do not need to be logged in as superuser to run this command.
% scstat -n |
Output resembles the following.
-- Cluster Nodes -- Node name Status --------- ------ Cluster node: phys-schost-1 Online Cluster node: phys-schost-2 Online |
To re-enable the loopback file system (LOFS), delete the following entry from the /etc/system file on each node of the cluster.
exclude:lofs |
The re-enabling of LOFS becomes effective after the next system reboot.
You cannot have LOFS enabled if you use Sun Cluster HA for NFS on a highly available local file system and have automountd running. LOFS can cause switchover problems for Sun Cluster HA for NFS. If you enable LOFS and later choose to add Sun Cluster HA for NFS on a highly available local file system, you must do one of the following:
Restore the exclude:lofs entry to the /etc/system file on each node of the cluster and reboot each node. This change disables LOFS.
Disable the automountd daemon.
Exclude from the automounter map all files that are part of the highly available local file system that is exported by Sun Cluster HA for NFS. This choice enables you to keep both LOFS and the automountd daemon enabled.
See Types of File Systems in System Administration Guide, Volume 1 (Solaris 8) or The Loopback File System in System Administration Guide: Devices and File Systems (Solaris 9 or Solaris 10) for more information about loopback file systems.
The following example shows the node phys-schost-3 added to the cluster schost. The sponsoring node is phys-schost-1.
*** Adding a Node to an Existing Cluster *** Fri Feb 4 10:17:53 PST 2005 scinstall -ik -C schost -N phys-schost-1 -A trtype=dlpi,name=qfe2 -A trtype=dlpi,name=qfe3 -m endpoint=:qfe2,endpoint=switch1 -m endpoint=:qfe3,endpoint=switch2 Checking device to use for global devices file system ... done Adding node "phys-schost-3" to the cluster configuration ... done Adding adapter "qfe2" to the cluster configuration ... done Adding adapter "qfe3" to the cluster configuration ... done Adding cable to the cluster configuration ... done Adding cable to the cluster configuration ... done Copying the config from "phys-schost-1" ... done Copying the postconfig file from "phys-schost-1" if it exists ... done Copying the Common Agent Container keys from "phys-schost-1" ... done Setting the node ID for "phys-schost-3" ... done (id=1) Setting the major number for the "did" driver ... Obtaining the major number for the "did" driver from "phys-schost-1" ... done "did" driver major number set to 300 Checking for global devices global file system ... done Updating vfstab ... done Verifying that NTP is configured ... done Initializing NTP configuration ... done Updating nsswitch.conf ... done Adding clusternode entries to /etc/inet/hosts ... done Configuring IP Multipathing groups in "/etc/hostname.<adapter>" files Updating "/etc/hostname.hme0". Verifying that power management is NOT configured ... done Ensure that the EEPROM parameter "local-mac-address?" is set to "true" ... done The "local-mac-address?" parameter setting has been changed to "true". Ensure network routing is disabled ... done Updating file ("ntp.conf.cluster") on node phys-schost-1 ... done Updating file ("hosts") on node phys-schost-1 ... done Rebooting ... |
Determine your next step:
If you added a node to a two-node cluster, go to How to Update SCSI Reservations After Adding a Node.
If you intend to install data services, go to the appropriate procedure for the data service that you want to install and for your version of the Solaris OS:
Sun Cluster 2 of 2 CD-ROM (Sun Java System data services) |
Sun Cluster Agents CD (All other data services) |
|||
---|---|---|---|---|
Procedure |
Solaris 8 or 9 |
Solaris 10 |
Solaris 8 or 9 |
Solaris 10 |
How to Install Sun Cluster Framework and Data-Service Software Packages (Java ES installer) |
X | |||
X | ||||
X |
X |
|||
How to Install Data-Service Software Packages (Web Start installer) |
X |
Otherwise, go to How to Verify the Quorum Configuration and Installation Mode.
When you increase or decrease the number of node attachments to a quorum device, the cluster does not automatically recalculate the quorum vote count. To reestablish the correct quorum vote, use the scsetup utility to remove each quorum device and then add it back into the configuration. Do this on one quorum device at a time.
If the cluster has only one quorum device, configure a second quorum device before you remove and readd the original quorum device. Then remove the second quorum device to return the cluster to its original configuration.