Oracle® Solaris Cluster Software Installation Guide

Exit Print View

Updated: September 2014, E39580-02

How to Install Oracle Solaris Cluster Software Packages

Follow this procedure to perform one or more of the following installation tasks:

  • To install the Oracle Solaris Cluster framework and data service software packages on each node in the global cluster. These nodes can be physical machines or (SPARC only) Oracle VM Server for SPARC I/O domains or guest domains, or a combination of any of these types of nodes.

    Note -  If your physically clustered machines are configured with Oracle VM Server for SPARC, install Oracle Solaris Cluster software only in I/O domains or guest domains.
  • To install data services.

Note -  You cannot add or remove individual packages that are part of the ha-cluster-minimal group package except by complete reinstallation or uninstallation. See How to Unconfigure Oracle Solaris Cluster Software to Correct Installation Problems and How to Uninstall Oracle Solaris Cluster Software From a Cluster Node in Oracle Solaris Cluster System Administration Guide for procedures to remove the cluster framework packages.

However, you can add or remove other, optional packages without removing the ha-cluster-minimal group package.

If you choose to install the ha-cluster-full package, the GUI will be installed automatically. If you choose to install another package, you can manually install the GUI later.

Before You Begin

Perform the following tasks:

  • Ensure that the Oracle Solaris OS is installed to support Oracle Solaris Cluster software.

    If the Oracle Solaris software is already installed on the node, you must ensure that the Oracle Solaris installation meets the requirements for the Oracle Solaris Cluster software and any other software that you intend to install on the cluster. See How to Install Oracle Solaris Software for more information about installing the Oracle Solaris software to meet Oracle Solaris Cluster software requirements.

  • Choose which Oracle Solaris Cluster software packages to install.

    The following table lists the primary group packages for the Oracle Solaris Cluster 4.2 software and the principal features that each group package contains. You must install at least the ha-cluster-framework-minimal group package.

    Framework man pages
    Data Service man pages
    Agent Builder
    Generic Data Service
    Graphical User Interface
    Geographic Edition
  1. If you are using a cluster administrative console, display a console screen for each node in the cluster.
    • If pconsole software is installed and configured on your administrative console, use the pconsole utility to display the individual console screens.

      As the root role, use the following command to start the pconsole utility:

      adminconsole# pconsole host[:port] […]  &

      The pconsole utility also opens a master window from which you can send your input to all individual console windows at the same time.

    • If you do not use the pconsole utility, connect to the consoles of each node individually.
  2. Restore external access to remote procedure call (RPC) communication.

    During the installation of the Oracle Solaris OS, a restricted network profile is used that disables external access for certain network services. The restricted services include the RPC communication service, which is required for cluster communication.

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

    # svccfg
    svc:> select network/rpc/bind
    svc:/network/rpc/bind> setprop config/local_only=false
    svc:/network/rpc/bind> quit
    # svcadm refresh network/rpc/bind:default
    # 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.

  3. Assume the root role on the cluster node to install.

    Alternatively, if your user account is assigned the System Administrator profile, issue commands as non-root through a profile shell, or prefix the command with the pfexec command.

  4. Disable Network Auto-Magic (NWAM).

    NWAM activates a single network interface and disables all others. For this reason, NWAM cannot coexist with the Oracle Solaris Cluster software and you must disable it before you configure or run your cluster. To disable NWAM, you enable the defaultfixed profile.

    # netadm enable -p ncp defaultfixed
    # netadm list -p ncp defaultfixed
  5. Set up the repository for the Oracle Solaris Cluster software packages.
    • If the cluster nodes have direct access or web proxy access to the Internet, perform the following steps.
      1. Go to
      2. Choose Oracle Solaris Cluster software.
      3. Accept the license.
      4. Request a new certificate by choosing Oracle Solaris Cluster software and submitting a request.

        The certification page is displayed with download buttons for the key and the certificate.

      5. Download the key and certificate files and install them as described in the returned certification page.
      6. Configure the ha-cluster publisher with the downloaded SSL keys and set the location of the Oracle Solaris Cluster 4.2 repository.

        In the following example the repository name is

        # pkg set-publisher \
        -k /var/pkg/ssl/Oracle_Solaris_Cluster_4.0.key.pem \
        -c /var/pkg/ssl/Oracle_Solaris_Cluster_4.0.certificate.pem \
        -O ha-cluster
        –k /var/pkg/ssl/Oracle_Solaris_Cluster_4.0.key.pem

        Specifies the full path to the downloaded SSL key file.

        –c /var/pkg/ssl/Oracle_Solaris_Cluster_4.0.certificate.pem

        Specifies the full path to the downloaded certificate file.


        Specifies the URL to the Oracle Solaris Cluster 4.2 package repository.

        For more information, see the pkg(1) man page.

    • If you are using an ISO image of the software, perform the following steps.
      1. Download the Oracle Solaris Cluster 4.2 ISO image from Oracle Software Delivery Cloud at

        Note - A valid Oracle license is required to access Oracle Software Delivery Cloud.

        Oracle Solaris Cluster software is part of the Oracle Solaris Product Pack. Follow online instructions to complete selection of the media pack and download the software.

      2. Make the Oracle Solaris Cluster 4.2 ISO image available.
        # lofiadm -a path-to-iso-image 
        # mount -F hsfs /dev/lofi/N /mnt
        –a path-to-iso-image

        Specifies the full path and file name of the ISO image.

      3. Set the location of the Oracle Solaris Cluster 4.2 package repository.
        # pkg set-publisher -g file:///mnt/repo ha-cluster
  6. Ensure that the data service package is available from the configured publisher and that the solaris and ha-cluster publishers are valid.
    # pkg list -a package-name
    # pkg publisher
    PUBLISHER                           TYPE     STATUS   P  LOCATION
    solaris                             origin   online   F  solaris-repository
    ha-cluster                          origin   online   F  ha-cluster-repository

    For information about setting the solaris publisher, see Adding, Modifying, or Removing Package Publishers in Adding and Updating Software in Oracle Solaris 11.2 .

    Tip  -  Use the –nv options whenever you install or update to see what changes will be made, such as which versions of which packages will be installed or updated and whether a new BE will be created.

    If you do not get any error messages when you use the –nv options, run the command again without the –n option to actually perform the installation or update. If you do get error messages, run the command again with more –v options (for example, –nvv) or more of the package FMRI pattern to get more information to help you diagnose and fix the problem. For troubleshooting information, see Appendix A, Troubleshooting Package Installation and Update, in Adding and Updating Software in Oracle Solaris 11.2 .

  7. Install the Oracle Solaris Cluster 4.2 software.
    # /usr/bin/pkg install ha-cluster-package
  8. Verify that the package installed successfully.
    $ pkg info -r ha-cluster-package

    Package installation succeeded if the state is Installed.

  9. Perform any necessary updates to the Oracle Solaris Cluster software.

    For instructions on updating your software, see Chapter 11, Updating Your Software, in Oracle Solaris Cluster System Administration Guide .

Next Steps

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

If you want to use the Availability Suite feature of Oracle Solaris software, install the Availability Suite software. Go to How to Install the Availability Suite Feature of the Oracle Solaris Software.

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