Go to main content

Installing and Configuring an Oracle® Solaris Cluster 4.4 Environment

Exit Print View

Updated: November 2019

How to Install Oracle Solaris Cluster Software (pkg)

This procedure uses the Oracle Solaris pkg command to install Oracle Solaris Cluster framework package groups and individual packages.

Note -  To use the interactive clinstall utility instead, go to How to Install Oracle Solaris Cluster Software Using Centralized Installer (clinstall).

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, control domains, or guest domains.
  • To install data services.

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.

    Note -  If you want to use the Oracle Solaris Cluster Manager browser interface to administer Oracle Solaris Cluster components, ensure that all cluster nodes have the same root password.
  • Choose which Oracle Solaris Cluster software packages to install.

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

    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 for a procedure 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.

    Framework man pages
    Data Service man pages
    Agent Builder
    Generic Data Service
    Graphical User Interface
    Disaster Recovery Framework
  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 -s svc:/network/rpc/bind setprop config/local_only = false
    # 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. 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 https://pkg-register.oracle.com.
      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.4 repository.

        In the following example the repository name is https://pkg.oracle.com/repository-location/.

        # pkg set-publisher -p \
        -k /var/pkg/ssl/Oracle_Solaris_Cluster_4.4.key.pem \
        -c /var/pkg/ssl/Oracle_Solaris_Cluster_4.4.certificate.pem 
        –k /var/pkg/ssl/Oracle_Solaris_Cluster_4.4.key.pem

        Specifies the full path to the downloaded SSL key file.

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

        Specifies the full path to the downloaded certificate file.

        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.4 ISO image from Oracle Software Delivery Cloud at https://edelivery.oracle.com/.

        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.4 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.4 package repository.
        # pkg set-publisher -p file:///mnt/repo

        Before installing the Oracle Solaris Cluster 4.4 software on a host upgraded from Oracle Solaris 11.3 to 11.4, ensure that consolidation/cacao/cacao-incorporation has been upgraded to Oracle Solaris 11.4 version. For example:

        # pkg list consolidation/cacao/cacao-incorporation
        NAME (PUBLISHER) VERSION                    IFO
        consolidation/cacao/cacao-incorporation 11.4-        i--

        If the package version is still from Oracle Solaris 11.3, upgrade the cacao package on all nodes.

        # pkg update consolidation/cacao/cacao-incorporation

        Use pkg list to confirm the package was updated.

        # pkg list consolidation/cacao/cacao-incorporation
  5. 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  ha-cluster-repository
    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 Updating Systems and Adding Software in Oracle Solaris 11.4.

    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 Updating Systems and Adding Software in Oracle Solaris 11.4.

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

    Package installation succeeded if the state is Installed.

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

    For instructions on updating your software, see Updating Your Oracle Solaris Cluster 4.4 Environment.

Next Steps

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

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