Go to main content

Oracle® Solaris Cluster 4.3 Geographic Edition Installation and Configuration Guide

Exit Print View

Updated: February 2017

Installing the Geographic Edition Software

You must install the Geographic Edition software on every node of each cluster in your geographically separated cluster by using the pkg add command.

How to Install the Geographic Edition Software

This procedure explains how to install the Geographic Edition software. Perform the procedure in the global zone for each node of a global cluster or zone cluster that you are configuring in a partnership.

Before You Begin

The following manuals contain information that can help you plan your configuration and prepare your installation strategy:

Before you begin to install software, make the following preparations:

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

    If Oracle Solaris software is already installed on the node, you must ensure that the Oracle Solaris installation meets the requirements for Geographic Edition software and any other software that you intend to install on the cluster.

    Note -  If you want to use the Oracle Solaris Cluster Manager browser interface to administer Geographic Edition components, ensure that all cluster nodes have the same root password.
  • Read Planning the Geographic Edition Installation.

  1. Become the root role in the global zone of the node where you intend to run the Geographic Edition software.

    Note -  Geographic Edition software must be installed in the global zone for all nodes of each cluster in the partnership, regardless of whether the partner cluster is a global cluster or a zone cluster. For a zone cluster that will be configured in a partnership, Geographic Edition software must be installed in both the zone cluster nodes and on the underlying global cluster nodes.
  2. Set up the repository for the Oracle Solaris Cluster software packages.

    The repository setup process depends on whether the nodes have access to the Internet or whether you are using an ISO image of the software.

    • If the cluster nodes have direct access or web proxy access to the Internet:
      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.3 repository.

        In the following example, the repository name is https://pkg.oracle.com/solaris/cluster/.

        # pkg set-publisher \
        -k /var/pkg/ssl/Oracle_Solaris_Cluster_4.1.key.pem \
        -c /var/pkg/ssl/Oracle_Solaris_Cluster_4.1.certificate.pem \
        -O https://pkg.oracle.com/solaris/cluster/ ha-cluster
        –k /var/pkg/ssl/Oracle_Solaris_Cluster_4.1.key.pem

        Specifies the full path to the downloaded SSL key file.

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

        Specifies the full path to the downloaded certificate file.

        –O https://pkg.oracle.com/solaris/cluster/

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

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

    • If you are using an ISO image of the software:
      1. Download the Oracle Solaris Cluster 4.3 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, which includes Geographic Edition 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.3 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.3 package repository.
        # pkg set-publisher -g file:///mnt/repo ha-cluster
  3. Ensure that the solaris and ha-cluster publishers are valid.
    # 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.3.

    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. The –v option also shows any release notes that apply to this particular install or update operation.

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

  4. Install the Geographic Edition 4.3 software.
    # /usr/bin/pkg install ha-cluster-geo-full
  5. Verify that the package installed successfully.

    Output is similar to the following example, which checks the installation state of the ha-cluster-geo-full group package.

    % pkg info ha-cluster/group-package/ha-cluster-geo-full
    Name: ha-cluster/group-package/ha-cluster-geo-full
    Summary: Oracle Solaris Cluster Geographic Edition full group package
    Description: Oracle Solaris Cluster Geographic Edition full group package
    Category: Meta Packages/Group Packages
    State: Installed
    Publisher: ha-cluster
    Version: 4.1.0
    Build Release: 5.11
    Branch: 0.22
    Packaging Date: Sat Oct 22 07:28:36 2011
    Size: 77.00 B
    FMRI: pkg://ha-cluster/ha-cluster/group-package/ha-cluster-geo-full@version:dateTtimeZ
  6. If you installed from a DVD-ROM, unload the installation DVD-ROM from the DVD-ROM drive.
  7. Repeat this procedure on each node of each partner cluster.

Next Steps

If you need to install any required software updates, see Upgrading or Updating Geographic Edition Software.