Sun Cluster Software Installation Guide for Solaris OS

How to Configure Sun Cluster Software on All Nodes (scinstall)

Perform this procedure from one node of the cluster to configure Sun Cluster software on all nodes of the cluster.

  1. 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.

  2. If you disabled remote configuration during Sun Cluster software installation, re-enable remote configuration.

    Enable remote shell (rsh(1M)) or secure shell (ssh(1)) access for superuser to all cluster nodes.

  3. (Optional) To use the scinstall(1M) utility to install patches, download patches to a patch directory.

    If you use Typical mode to install the cluster, use a directory named either /var/cluster/patches/ or /var/patches/ to contain the patches to install. In Typical mode, the scinstall command checks both those directories for patches.

    • If neither of those directories exist, then no patches are added.

    • If both directories exist, then only the patches in the /var/cluster/patches/ directory are added.

    If you use Custom mode to install the cluster, you specify the path to the patch directory, so there is no requirement to use the patch directories that scinstall checks for in Typical mode.

    You can include a patch-list file in the patch directory. The default patch-list file name is patchlist. For information about creating a patch-list file, refer to the patchadd(1M) man page.

  4. Complete one of the following configuration worksheets:

    See Planning the Sun Cluster Environment for planning guidelines.

    Table 2–2 Interactive scinstall Configuration Worksheet (Typical)

    Component 

    Description/Example 

    Enter Answers Here 

    Cluster Name 

    What is the name of the cluster that you want to establish? 

     

    Cluster Nodes 

    What are the names of the other cluster nodes planned for the initial cluster configuration? 

     

    Cluster-Transport Adapters and Cables 

    What are the names of the two cluster-transport adapters that attach the node to the private interconnect? 

    First

      

    Second

      

    Check 

    Do you want to interrupt installation for sccheck errors? (sccheck verifies that preconfiguration requirements are met)

    Yes  |  No 

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

    Component 

    Default Value 

    Private-network address 

    172.16.0.0

    Private-network netmask 

    255.255.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/

    Table 2–3 Interactive scinstall Configuration Worksheet (Custom)

    Component 

    Description/Example 

    Enter Answers Here 

    Cluster Name 

    What is the name of the cluster that you want to establish? 

     

    Cluster Nodes 

    What are the names of the other cluster nodes planned for the initial cluster configuration? 

     

    DES Authentication 

    Do you need to use DES authentication? 

    No  |  Yes  

    Network Address for the Cluster Transport 

    Do you want to accept the default network address (172.16.0.0)?

    Yes   |  No  

    If no, supply your own network address: 

    _____ . _____.0.0

    Do you want to accept the default netmask (255.255.0.0)?

    Yes   |  No  

    If no, supply your own netmask: 

    255.255. ___ . ___

    Point-to-Point Cables 

    If this is a two-node cluster, does this cluster use transport junctions? 

    Yes  |  No 

    Cluster-Transport Junctions 

    If used, what are the names of the two transport junctions? 

      Defaults: switch1 and switch2


    First

      

    Second

      

    Cluster-Transport Adapters and Cables 

    Node name (the node from which you run scinstall):

     

    Transport adapters: 

    First

      

    Second

      

    Where does each transport adapter connect to (a transport junction or another adapter)?

      Junction defaults: switch1 and switch2


      

    For transport junctions, do you want to use the default port name?  

    Yes | No 

    Yes | No 

    If no, what is the name of the port that you want to use? 

      

    Do you want to use autodiscovery to list the available adapters for the other nodes? 

    If no, supply the following information for each additional node: 

    Yes  |  No 

    Specify for each additional node

    Node name: 

     

    Transport adapters: 

    First

      

    Second

      

    Where does each transport adapter connect to (a transport junction or another adapter)?

      Defaults: switch1 and switch2


      

    For transport junctions, do you want to use the default port name? 

    Yes | No 

    Yes | No 

    If no, what is the name of the port that you want to use? 

      

    Software Patch Installation 

    Do you want scinstall to install patches for you?

    Yes  |  No 

    If yes, what is the name of the patch directory? 

     

    Do you want to use a patch list? 

    Yes  |  No 

    Global-Devices File System 

    (specify for each node)

    Do you want to use the default name of the global-devices file system (/globaldevices)?

    Yes  |  No 

    If no, do you want to use an already-existing file system? 

    Yes  |  No 

    What is the name of the file system that you want to use? 

     

    Check 

    Do you want to interrupt installation for sccheck errors? (sccheck verifies that preconfiguration requirements are met)

    Yes  |  No 


    Note –

    You cannot change the private-network address and netmask after scinstall processing is finished. If you need to use a different private-network address or netmask and the node is still in installation mode, follow the procedures in How to Uninstall Sun Cluster Software to Correct Installation Problems. Then perform the procedures in How to Install Sun Cluster Software Packages and in this procedure to reinstall the software and configure the node with the correct information.


  5. Become superuser on the cluster node from which you intend to configure the cluster.

  6. Install additional packages if you intend to use any of the following features.

    • Remote Shared Memory Application Programming Interface (RSMAPI)

    • SCI-PCI adapters for the interconnect transport

    • RSMRDT drivers


    Note –

    Use of the RSMRDT driver is restricted to clusters that run an Oracle9i release 2 SCI configuration with RSM enabled. Refer to Oracle9i release 2 user documentation for detailed installation and configuration instructions.


    1. Determine which packages you must install.

      The following table lists the Sun Cluster 3.1 9/04 packages that each feature requires and the order in which you must install each group of packages. The installer program does not automatically install these packages.

      Feature 

      Additional Sun Cluster 3.1 9/04 Packages to Install  

      RSMAPI 

      SUNWscrif

      SCI-PCI adapters 

      SUNWsci SUNWscid SUNWscidx

      RSMRDT drivers 

      SUNWscrdt

    2. Ensure that any dependency Solaris packages are already installed.

      See Step 8 in How to Install Solaris Software.

    3. Insert the Sun Cluster 3.1 9/04 CD-ROM into the CD-ROM drive of a node.

    4. Change to the Solaris_arch/Product/sun_cluster/Solaris_ver/Packages/ directory, where arch is sparc or x86, and where ver is 8 (for Solaris 8) or 9 (for Solaris 9) .


      # cd /cdrom/cdrom0/Solaris_arch/Product/sun_cluster/Solaris_ver/Packages/
      

    5. Install the additional packages.


      # pkgadd -d . packages
      

    6. Change to a directory that does not reside on the CD-ROM and eject the CD-ROM.


      # eject cdrom
      

    7. Repeat for each additional node in the cluster.

  7. On one node, start the scinstall utility.


    # /usr/cluster/bin/scinstall
    

  8. Follow these guidelines to use the interactive scinstall utility:

    • 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.

  9. 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) Print release information for this cluster node
          * ?) Help with menu options
          * q) Quit
    
        Option:  1
    

  10. From the Install Menu, choose the menu item, Install all nodes of a new cluster.

  11. From the Type of Installation menu, choose either Typical or Custom.

  12. Follow the menu prompts to supply your answers from the worksheet that you completed in Step 4.

    The scinstall utility installs and configures all cluster nodes and reboots the cluster. The cluster is established when all nodes have successfully booted into the cluster. Sun Cluster installation output is logged in a /var/cluster/logs/install/scinstall.log.N file.

  13. Install Sun StorEdge QFS file system software.

    Follow the procedures for initial installation in the Sun StorEdge QFS and Sun StorEdge SAM-FS Software Installation and Configuration Guide.

  14. (Optional) SPARC: To install VERITAS File System, go to SPARC: How to Install VERITAS File System Software.

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

    Go to How to Configure the Name-Service Switch.

Example – Configuring Sun Cluster Software on All Nodes

The following example shows the scinstall progress messages that are logged as scinstall completes configuration 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.


  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 ...