Sun Cluster Software Installation Guide for Solaris OS

How to Install and Configure Sun Cluster Software (SunPlex Installer)


Note –

To add a new node to an existing cluster, instead follow the procedures in How to Configure Sun Cluster Software on Additional Cluster Nodes (scinstall).


Perform this procedure to use SunPlex Installer to install and configure Sun Cluster software and patches on all nodes in the cluster in a single operation. In addition, you can use this procedure to install Solstice DiskSuite software and patches (Solaris 8) or to configure Solaris Volume Manager mirrored disk sets (Solaris 9).

If you use SunPlex Installer to install Solstice DiskSuite software or to configure Solaris Volume Manager disk sets, you can also install one or both of the following data services:

The installation process might take from 30 minutes to two or more hours. The actual length of time depends on the number of nodes that are in the cluster, your choice of data services to install, and the number of disks that are in your cluster configuration.

  1. Ensure that the cluster configuration meets the requirements to use SunPlex Installer to install software.

    See Using SunPlex Installer to Install Sun Cluster Software for installation requirements and restrictions.

  2. Ensure that the root password is the same on every node of the cluster.

    To use the root password to access SunPlex Installer or SunPlex Manager, the root password must be the same on all nodes in the cluster.

    If some nodes have a different root password than other nodes, set the root password to the same value on each node of the cluster. If necessary, also use the chkey command to update the RPC key pair. See the chkey(1) man page.


    # passwd
    Enter new password
    # chkey -p
    

  3. If you intend to install Sun Cluster HA for NFS or Sun Cluster HA for Apache, ensure that the cluster configuration meets all applicable requirements.

    See Using SunPlex Installer to Install Sun Cluster Software.

  4. Ensure that SunPlex Manager software is installed on each node of the cluster.

    See the installation procedures in How to Install SunPlex Manager Software.

  5. Prepare file-system paths to a CD-ROM image of each software product that you intend to install.

    Follow these guidelines to prepare the file-system paths:

    • Provide each CD-ROM image in a location that is available to each node.

    • Ensure that the CD-ROM images are accessible to all nodes of the cluster from the same file-system path. These paths can be one or more of the following locations:

      • CD-ROM drives that are exported to the network from machines outside the cluster.

      • Exported file systems on machines outside the cluster.

      • CD-ROM images that are copied to local file systems on each node of the cluster. The local file system must use the same name on each node.

  6. Install additional packages if you intend to use one or more 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. SunPlex Installer 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. If patches exist that are required to support Sun Cluster or Solstice DiskSuite software, determine how to install those patches.

    • To manually install patches, use the pkgadd command to install all patches before you use SunPlex Installer.

    • To use SunPlex Installer to install patches, copy patches into a single directory.

      Ensure that the patch directory meets the following requirements:

      • The patch directory resides on a file system that is available to each node.

      • Only one version of each patch is present in this patch directory.

        If the patch directory contains multiple versions of the same patch, SunPlex Installer cannot determine the correct patch dependency order.

      • The patches are uncompressed.

  8. Complete the following installation worksheet.

    Table 2–6 SunPlex Installer Installation and Configuration Worksheet

    Component 

    Description/Example 

    Enter Answers Here 

    Cluster Name 

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

     

    How many nodes are you installing in the cluster?  

     

    Node Names 

    What are the names of the cluster nodes? 

     

    Cluster-Transport Adapters and Cables 

    What are the names of the two transport adapters to use, two adapters per node? 

     

    Solstice DiskSuite or Solaris Volume Manager  

    • Solaris 8: Do you want to install Solstice DiskSuite?

    • Solaris 9: Do you want to configure Solaris Volume Manager?

    Yes  |  No 

    Sun Cluster HA for NFS 

    Requires Solstice DiskSuite or Solaris Volume Manager

    Do you want to install Sun Cluster HA for NFS? 

    If yes, also specify the following:  

    Yes  |  No 

    What is the logical hostname that the data service is to use? 

     

    What are the test IP addresses to use?  

    Supply one test IP address for each node in the cluster.

     

    Sun Cluster HA for Apache (scalable) 

    Requires Solstice DiskSuite or Solaris Volume Manager

    Do you want to install scalable Sun Cluster HA for Apache? 

    If yes, also specify the following:  

    Yes  |  No 

    What is the logical hostname that the data service is to use? 

     

    What are the test IP addresses to use?  

    Supply one test IP address for each node in the cluster.

     

    CD-ROM Paths 

    What is the path for each of the following components that you want to install? 

    The CD-ROM path must end with the directory that contains the .cdtoc file.

     

    Solstice DiskSuite: 

    Sun Cluster (framework): 

    Sun Cluster data services (agents): 

    Patches: 

    Validation Checks 

    Do you want to run the sccheck utility to validate the cluster?

    Yes  |  No 


    Note –

    SunPlex Installer installation automatically specifies the default private-network address (172.16.0.0) and netmask (255.255.0.0). If you need to use a different address, do not use SunPlex Installer to install Sun Cluster software. Instead, follow procedures in How to Install Sun Cluster Software Packages and in How to Configure Sun Cluster Software on All Nodes (scinstall) to install and configure the cluster.

    You cannot change the private-network address and netmask after scinstall processing has 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 repeat this procedure to reinstall and configure the node with the correct information.


    See Planning the Solaris OS and Planning the Sun Cluster Environment for planning guidelines. See the Sun Cluster Data Service Planning and Administration Guide for Solaris OS for data-service planning guidelines.

  9. Start SunPlex Installer.

    1. From the administrative console or any other machine outside the cluster, launch a browser.

    2. Disable the browser's Web proxy.

      SunPlex Installer installation functionality is incompatible with Web proxies.

    3. Ensure that disk caching and memory caching is enabled.

      The disk cache and memory cache size must be greater than 0.

    4. From the browser, connect to port 3000 on a node of the cluster.


      https://node:3000
      

      The Sun Cluster Installation screen is displayed in the browser window.


      Note –

      If SunPlex Installer displays the data services installation screen instead of the Sun Cluster Installation screen, Sun Cluster framework software is already installed and configured on that node. Check that the name of the node in the URL is the correct name of the cluster node to install.


    5. If the browser displays a New Site Certification window, follow the onscreen instructions to accept the certificate.

  10. Log in as superuser.

  11. In the Sun Cluster Installation screen, verify that the cluster meets the listed requirements for using SunPlex Installer.

    If you meet all listed requirements, click Next to continue to the next screen.

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

  13. Click Begin Installation to start the installation process.

    Follow these guidelines:

    • Do not close the browser window nor change the URL during the installation process.

    • If the browser displays a New Site Certification window, follow the onscreen instructions to accept the certificate.

    • If the browser prompts for login information, type the appropriate superuser ID and password for the node that you connect to.

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

    During installation, the screen displays brief messages about the status of the cluster installation process. When installation and configuration is complete, the browser displays the cluster monitoring and administration GUI.

    SunPlex Installer installation output is logged in the /var/cluster/spm/messages file. Sun Cluster installation output is logged in a /var/cluster/logs/install/scinstall.log.N file.

  14. Verify the quorum assignments and modify those assignments, if necessary.

    For clusters with three or more nodes, the use of shared quorum devices is optional. SunPlex Installer might or might not have assigned quorum votes to any quorum devices, depending on whether appropriate shared disks were available. You can use SunPlex Manager to designate quorum devices and to reassign quorum votes in the cluster. See “Administering Quorum” in Sun Cluster System Administration Guide for Solaris OS for more information.

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

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

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

    Go to How to Configure the Name-Service Switch.