Sun Cluster 3.0 Installation Guide

How to Install Sun Cluster Software and Establish New Cluster Nodes

After installing the Solaris operating environment, perform this task on each node of the cluster.


Note -

If you used the scinstall(1M) custom JumpStart method to install software, the Sun Cluster software is already installed. Proceed to "How to Configure the Name Service Switch".


  1. Have available the following completed configuration planning worksheets from Sun Cluster 3.0 Release Notes.

    • "Cluster and Node Names Worksheet"

    • "Cluster Interconnect Worksheet"

    See Chapter 1, Planning the Sun Cluster Configuration for planning guidelines.

  2. Become superuser on the cluster node.

  3. If you are installing from the CD-ROM, insert the Sun Cluster 3.0 CD-ROM into the CD-ROM drive of the node you want to install and configure.

    If the Volume Management daemon vold(1M) is running and configured to manage CD-ROM devices, it automatically mounts the CD-ROM on the /cdrom/suncluster_3_0 directory.

  4. Change to the /cdrom_image/suncluster_3_0/SunCluster_3.0/Tools directory.


    # cd /cdrom_image/suncluster_3_0/SunCluster_3.0/Tools
    
  5. Start the scinstall(1M) utility.


    ./scinstall
    

    Follow these guidelines while using the interactive scinstall utility.

    • Interactive scinstall enables you to type ahead. Therefore, do not press Return more than once if the next menu screen does not appear immediately.

    • Unless otherwise noted, pressing Control-D will return you either to the start of a series of related questions or to the Main Menu.

    • Your session answers are stored as defaults for the next time you run this menu option.

    • Until the node has successfully booted in cluster mode, you can rerun scinstall and change the configuration information as needed. However, if bad configuration data for the node has been pushed over to the established portion of the cluster, you might first need to remove the bad information. To do this, log in to one of the active cluster nodes, then use the scsetup(1M) utility to remove the bad adapter, junction, or cable information.

  6. To install the first node and establish the new cluster, type 1 (Establish a new cluster).

    Follow the prompts to install Sun Cluster software, using the information from your configuration planning worksheets. You will be asked for the following information.

    • Cluster name

    • Names of the other nodes that will become part of this cluster

    • Node authentication

    • Private network address and netmask--You cannot change the private network address after the cluster has successfully formed

    • Cluster interconnect (transport adapters and transport junctions)--You can configure no more than two adapters by using the scinstall command, but you can configure more adapters later by using the scsetup utility

    • Global devices file-system name

    • Automatic reboot--Do not choose automatic reboot if you have Sun Cluster software patches to install

    When you finish answering the prompts, the scinstall command generated from your input is displayed for confirmation. If you choose not to accept the command, the scinstall utility returns you to the Main Menu. From there you can rerun menu option 1 and provide different answers. Your previous entries are displayed as the defaults.


    Note -

    Unless you have installed your own /etc/inet/ntp.conf file, the scinstall command installs a default ntp.conf file for you. Because the default file is shipped with references to eight nodes, the xntpd(1M) daemon might issue error messages regarding some of these references at boot time. You can safely ignore these messages. See "How to Update Network Time Protocol (NTP)" for information on how to suppress these messages under otherwise normal cluster conditions.


  7. To install the second node of the cluster, type 2 (Add this machine as a node).

    You can start this step while the first node is still being installed.

    Follow the prompts to install Sun Cluster software, using the information from your configuration planning worksheets. You will be asked for the following information.

    • Name of an existing cluster node, referred to as the sponsor node

    • Cluster name

    • Cluster interconnect (transport adapters and transport junctions)

    • Global devices file-system name

    • Automatic reboot--Do not choose automatic reboot if you have Sun Cluster software patches to install

    When you finish answering the prompts, the scinstall command generated from your input is displayed for confirmation. If you choose not to accept the command, the scinstall utility returns you to the Main Menu. From there you can rerun menu option 2 and provide different answers. Your previous answers are displayed as the defaults.

    If you choose to continue installation and the sponsor node is not yet established, scinstall waits for the sponsor node to become available.

  8. Repeat Step 7 on each additional node until all nodes are fully configured.

    You do not need to wait for the second node to complete installation before beginning installation on additional nodes.

  9. Install any Sun Cluster software patches.

    Refer to Sun Cluster 3.0 Release Notes for the location of patches and installation instructions.

  10. If you installed Sun Cluster software patches, shut down the cluster, then reboot each node in the cluster.

    Before rebooting the first node of the cluster, shut down the cluster by using the scshutdown command. Until the cluster nodes are removed from install mode, only the first node, which establishes the cluster (the sponsor node), has a quorum vote. In an established cluster which is still in install mode, if the cluster is not shut down before the first node is rebooted, the remaining cluster nodes cannot obtain quorum and the entire cluster shuts down.

    Cluster nodes remain in install mode until the first time you run the scsetup(1M) command, during the procedure "How to Perform Post-Installation Setup".

Example--Installing Sun Cluster Software

The following example shows the progress messages displayed as scinstall installation tasks are completed on the node phys-schost-1, which is the first node to be installed in the cluster.


** Installing SunCluster 3.0 **
        SUNWscr.....done.
        SUNWscdev...done.
        SUNWscu.....done.
        SUNWscman...done.
        SUNWscsal...done.
        SUNWscsam...done.
        SUNWscrsmop.done.
        SUNWsci.....done.
        SUNWscid....done.
        SUNWscidx...done.
        SUNWscvm....done.
        SUNWmdm.....done.
 
Initializing cluster name to "sccluster" ... done
Initializing authentication options ... done
Initializing configuration for adapter "hme2" ... done
Initializing configuration for adapter "hme4" ... done
Initializing configuration for junction "switch1" ... done
Initializing configuration for junction "switch2" ... done
Initializing configuration for cable ... done
Initializing configuration for cable ... done
Setting the node ID for "phys-schost-1" ... done (id=1)
 
Checking for global devices global file system ... done
Checking device to use for global devices file system ... done
Updating vfstab ... done
 
Verifying that NTP is configured ... done
Installing a default NTP configuration ... done
Please complete the NTP configuration after scinstall has finished.
 
Verifying that "cluster" is set for "hosts" in nsswitch.conf ... done
Adding the "cluster" switch to "hosts" in nsswitch.conf ... done
 
Verifying that "cluster" is set for "netmasks" in nsswitch.conf ... done
Adding the "cluster" switch to "netmasks" in nsswitch.conf ... done
 
Verifying that power management is NOT configured ... done
Unconfiguring power management ... done
/etc/power.conf has been renamed to /etc/power.conf.060199105132
Power management is incompatible with the HA goals of the cluster.
Please do not attempt to re-configure power management.
 
Ensure routing is disabled ... done
Network routing has been disabled on this node by creating /etc/notrouter.
Having a cluster node act as a router is not supported by Sun Cluster.
Please do not re-enable network routing.
 
Log file - /var/cluster/logs/install/scinstall.log.276
 
Rebooting ... 

Where to Go From Here

To set up the name service look-up order, go to "How to Configure the Name Service Switch".