Sun Cluster 3.1 10/03 Software Installation Guide

How to Install Sun Cluster Software on All Nodes (Typical)

Perform this procedure to install Sun Cluster software on all nodes of the cluster with the default cluster-configuration settings. To specify all cluster configuration settings, instead follow procedures in How to Install Sun Cluster Software on All Nodes (Custom).

The scinstall command checks for patches in the /var/cluster/patches directory or the /var/patches directory. If neither of the directories exist, then no patches are added. If both directories exist, then only the patches in the /var/cluster/patches directory are added.

A patch-list file may be included in the patch directory. The default patch-list file is patchlist. For information about creating a patch-list file, refer to the patchadd(1M) man page.

  1. Ensure that the Solaris operating environment 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.

  2. Did you preinstall Sun Cluster software?

    • If yes, proceed to Step 3.

    • If no, enable remote shell (rsh(1M)) or secure shell (ssh(1)) access for superuser . Doing this task enables the scinstall utility to install Sun Cluster software packages.

  3. Have available the following completed configuration planning worksheets:

    See Planning the Sun Cluster Environment for planning guidelines.

  4. Become superuser on the cluster node from which you intend to install the cluster.

  5. On one node of the cluster, start the scinstall utility.

    • If you preinstalled Sun Cluster software, type the following command:


      # /usr/cluster/bin/scinstall
      

    • If you did not preinstall Sun Cluster software, insert the Sun Cluster 3.1 10/03 CD-ROM and type the following commands, where ver is 8 (for Solaris 8) or 9 (for Solaris 9):


      # cd /cdrom/suncluster_3_1_u1/SunCluster_3.1/Sol_ver/Tools
      # ./scinstall
      

    Follow these guidelines to use 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, you can press Control-D to return to either the start of a series of related questions or to the Main Menu.

  6. From the Main Menu, type 1 (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) Print release information for this cluster node
    
          * ?) Help with menu options
          * q) Quit
    
        Option:  1
    

  7. From the Install Menu, type 1 (Install all nodes of a new cluster).


      *** Install Menu ***
    
        Please select from any one of the following options:
    
            1) Install all nodes of a new cluster
            2) Install just this machine as the first node of a new cluster
            3) Add this machine as a node in an existing cluster
    
            ?) Help with menu options
            q) Return to the Main Menu
    
        Option:  1
    …
      *** Installing all Nodes of a New Cluster ***
    …
        Do you want to continue (yes/no) [yes]?  y
    

  8. Type 1 to specify the Typical installation option.


      >>> Type of Installation <<<
    …
        Please select from one of the following options:
    
            1) Typical
            2) Custom
    
            ?) Help
            q) Return to the Main Menu
    
        Option [1]:  1
    

    For the Typical installation of Sun Cluster software, scinstall automatically specifies the following configuration defaults.

    Component 

    Default Value 

    Private network address 

    172.16.0.0

    Cluster transport junctions 

    switch1 and switch2

    Global-devices file-system name 

    /globaldevices

    Installation security (DES) 

    Limited 

    Solaris and Sun Cluster patch directory 

    /var/cluster/patches


    Note –

    You cannot change the private network address after cluster installation.


  9. Specify the cluster name.


      >>> Cluster Name <<<
    …
        What is the name of the cluster you want to establish?  clustername
    

  10. Specify the names of the other nodes to become part of this cluster.


      >>> Cluster Nodes <<<
    …
        Node name:  node2
        Node name (Ctrl-D to finish):  Control-D
    
        This is the complete list of nodes:
    …
        Is it correct (yes/no) [yes]?  

  11. Specify the first cluster-interconnect transport adapter.


      >>> Cluster Transport Adapters and Cables <<<
    
        Select the first cluster transport adapter for "node":
    
            1) adapter
            2) adapterN) Other
    
        Option:  N
    

    The scinstall utility lists all Ethernet adapters on the node. To configure adapters that are not listed, such as SCI-PCI adapters, type the number for the Other menu option. Then specify the adapter information that is requested in the subsequent prompts.


    Note –

    If your configuration uses SCI–PCI adapters, do not accept the default when you are prompted for the adapter connection (the port name). Instead, provide the port name (0, 1, 2, or 3) that is on the SCI Dolphin switch itself, to which the node is physically cabled. The following example shows the prompts and responses for declining the default port name and specifying the switch port name 0.


    …
        Use the default port name for the "adapter" connection (yes/no) [yes]? n
        What is the name of the port you want to use?  0
    


  12. Specify the second cluster-interconnect transport adapter.


      >>> Cluster Transport Adapters and Cables <<<
    
        Select the second cluster transport adapter for "node":
    
            1) adapter
            2) adapterN) Other
    
        Option:  N

    You configure two adapters by using the scinstall command. You can configure additional adapters after Sun Cluster software is installed by using the scsetup utility.

  13. Confirm that the scinstall utility should begin installation.


        Is it okay to begin the installation (yes/no) [yes]?  y
    
  14. Specify whether installation should stop if the sccheck utility detects errors.


        Interrupt the installation for sccheck errors (yes/no) [no]?

    If you choose to interrupt installation and the sccheck utility detects any problems, the utility displays information about the problems and prompts you for your next action. Log files are placed in the /var/cluster/logs/install/sccheck/ directory.

    If the sccheck utility quits with an error message because a version Sun Explorer software earlier than 3.5.1 is installed, remove the existing SUNWexplo package. Install the SUNWexplo package that is supplied on the Sun Cluster 3.1 10/03 CD-ROM. Then restart the scinstall utility.

    The scinstall utility continues installation of all cluster nodes and reboots the cluster. Sun Cluster installation output is logged in a /var/cluster/logs/install/scinstall.log.N file.

  15. Set up the name-service look-up order.

    Go to How to Configure the Name-Service Switch.

Example – Installing Sun Cluster Software on All Nodes (Typical)

The following example shows the scinstall progress messages that are logged as scinstall completes Typical installation tasks on a two-node cluster. The cluster node names are phys-schost-1 and phys-schost-2. The specified adapter names are qfe2 and hme2. The Sun Cluster software is already installed by the Web Start program.


  Installation and Configuration

    Log file - /var/cluster/logs/install/scinstall.log.834

    Testing for "/globaldevices" on "phys-schost-1" ... done
    Testing for "/globaldevices" on "phys-schost-2" ... done

    Checking installation status ... done

    The Sun Cluster software is already installed on "phys-schost-1".
    The Sun Cluster software is already installed on "phys-schost-2".

    Starting discovery of the cluster transport configuration.

    Probing ..

    The following connections were discovered:

        phys-schost-1:qfe2  switch1  phys-schost-2:qfe2
        phys-schost-1:hme2  switch2  phys-schost-2:hme2

    Completed discovery of the cluster transport configuration.

    Started sccheck on "phys-schost-1".
    Started sccheck on "phys-schost-2".

    sccheck completed with no errors or warnings for "phys-schost-1".
    sccheck completed with no errors or warnings for "phys-schost-2".

    Configuring "phys-schost-2" ... done
    Rebooting "phys-schost-2" ... done

    Configuring "phys-schost-1" ... done
    Rebooting "phys-schost-1" ... 

Log file - /var/cluster/logs/install/scinstall.log.834

Rebooting ...