Sun Cluster Software Installation Guide for Solaris OS

ProcedureHow to Install Sun Cluster Framework and Data-Service Software Packages


Note –

You can alternatively deploy the Sun Cluster Plug-in for Sun N1TM Service Provisioning System to install Sun Cluster framework and data-service software. Follow instructions in the documentation that is provided with the plug-in. You can also access this information at http://wikis.sun.com/display/SunCluster/Sun+Cluster+Framework+Plug-in.


Follow this procedure to use the Sun JavaTM Enterprise System (Java ES) installer program to perform one or more of the following installation tasks:


Note –

This procedure uses the interactive form of the installer program. To use the noninteractive form of the installer program, such as when developing installation scripts, see Chapter 5, Installing in Silent Mode, in Sun Java Enterprise System 5 Update 1 Installation Guide for UNIX.


Before You Begin

Perform the following tasks:

  1. (Solaris 10 only) Restore external access to RPC communication and optionally to Sun Java Web Console.

    During the installation of the Solaris 10 OS, if you choose not to enable network services for remote clients, a restricted network profile is used that disables external access for certain network services. The restricted services include the following services that affect cluster functionality:

    • The RPC communication service, which is required for cluster communication

    • The Sun Java Web Console service, which is required to use the Sun Cluster Manager GUI

    The following steps restore Solaris functionality that is used by the Sun Cluster framework but which is prevented if a restricted network profile is used.

    1. Perform the following commands to restore external access to RPC communication.


      phys-schost# svccfg
      svc:> select network/rpc/bind
      svc:/network/rpc/bind> setprop config/local_only=false
      svc:/network/rpc/bind> quit
      phys-schost# svcadm refresh network/rpc/bind:default
      phys-schost# svcprop network/rpc/bind:default | grep local_only
      

      The output of the last command should show that the local_only property is now set to false.

    2. (Optional) Perform the following commands to restore external access to Sun Java Web Console.


      phys-schost# svccfg
      svc:> select system/webconsole
      svc:/system/webconsole> setprop options/tcp_listen=true
      svc:/system/webconsole> quit
      phys-schost# /usr/sbin/smcwebserver restart
      phys-schost# netstat -a | grep 6789
      

      The output of the last command should return an entry for 6789, which is the port number that is used to connect to Sun Java Web Console.

      For more information about what services the restricted network profile restricts to local connections, see Planning Network Security in Solaris 10 10/09 Installation Guide: Planning for Installation and Upgrade.

  2. (Optional) To use the installer program with a GUI, ensure that the display environment of the cluster node to install is set to display the GUI.


    % xhost +
    % setenv DISPLAY nodename:0.0
    

    If you do not make these settings, the installer program runs in text-based mode.

  3. Become superuser on the cluster node to install.


    Note –

    If your physically clustered machines are configured with Sun LDoms, install Sun Cluster software only in I/O domains or guest domains.


  4. Load the Sun Java Availability Suite DVD-ROM into the DVD-ROM drive.

    If the volume management daemon vold(1M) is running and is configured to manage CD-ROM or DVD devices, the daemon automatically mounts the media on the /cdrom/cdrom0/ directory.

  5. Change to the installation wizard directory of the DVD-ROM.

    • If you are installing the software packages on the SPARC platform, type the following command:


      phys-schost# cd /cdrom/cdrom0/Solaris_sparc
      
    • If you are installing the software packages on the x86 platform, type the following command:


      phys-schost# cd /cdrom/cdrom0/Solaris_x86
      
  6. Start the installation wizard program.


    phys-schost# ./installer
    

    See the Sun Java Enterprise System 5 Update 1 Installation Guide for UNIX for additional information about using the different forms and features of the Java ES installer program.

  7. Follow instructions on the screen to install Sun Cluster framework software and data services on the node.

    • If you do not want to install Sun Cluster Manager, formerly SunPlex Manager, deselect it.


      Note –

      You must install Sun Cluster Manager either on all nodes of the cluster or on none.


    • If you want to install Sun Cluster Geographic Edition software, select it.

      After the cluster is established, see Sun Cluster Geographic Edition Installation Guide for further installation procedures.

    • Choose Configure Later when prompted whether to configure Sun Cluster framework software.

    After installation is finished, you can view any available installation log.

  8. Install additional packages 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.2 11/09 packages that each feature requires, in the order in which you must install each group of packages. The Java ES installer program does not automatically install these packages.


      Note –

      Install packages in the order in which they are listed in the following table.


      Feature 

      Additional Sun Cluster 3.2 11/09 Packages to Install 

      RSMAPI 

      SUNWscrif

      SCI-PCI adapters 

      • Solaris 9: SUNWsci SUNWscid SUNWscidx

      • Solaris 10: SUNWscir SUNWsci SUNWscidr SUNWscid

      RSMRDT drivers 

      SUNWscrdt

    2. Change to the /cdrom/suncluster_3_0Packages/ directory, where arch is sparc or x86, and where ver is 10 for Solaris 10 .


      phys-schost# cd /cdrom/cdrom0//cdrom/suncluster_3_0Packages/
      
    3. Install the additional packages.

      • SPARC: For the Solaris 9 OS, use the following command:


        phys-schost# pkgadd -d . packages
        
      • For the Solaris 10 OS, use the following command:


        phys-schost# pkgadd -G -d . packages
        
  9. Unload the Sun Java Availability Suite DVD-ROM from the DVD-ROM drive.

    1. To ensure that the DVD-ROM is not being used, change to a directory that does not reside on the DVD-ROM.

    2. Eject the DVD-ROM.


      phys-schost# eject cdrom
      
  10. Apply any necessary patches to support Sun Cluster software.

    See Patches and Required Firmware Levels in Sun Cluster Release Notes for the location of patches and installation instructions.

  11. If you will use any of the following adapters for the cluster interconnect, uncomment the relevant entry in the /etc/system file on each node.

    Adapter 

    Entry 

    ce 

    set ce:ce_taskq_disable=1 

    ipge 

    set ipge:ipge_taskq_disable=1 

    ixge 

    set ixge:ixge_taskq_disable=1 

    This entry becomes effective after the next system reboot.

Next Steps

If you want to install Sun QFS file system software, follow the procedures for initial installation. See How to Install Sun QFS Software.

Otherwise, to set up the root user environment, go to How to Set Up the Root Environment.