Installing Disaster Recovery Framework Software

Language:

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

How to Install Disaster Recovery Framework Software

This procedure explains how to install Disaster Recovery framework 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

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

Ensure that the Oracle Solaris OS is installed to support Disaster Recovery framework software.

If Oracle Solaris software is already installed on the node, you must ensure that the Oracle Solaris installation meets the requirements for Disaster Recovery framework 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 Disaster Recovery framework components, ensure that all cluster nodes have the same root password.
Read Planning the Disaster Recovery Framework Installation.
Read the following guides, which contain information that can help you plan your configuration and prepare your installation strategy:
- Oracle Solaris Cluster 4.4 Release Notes – Restrictions, bug workarounds, and other late-breaking information.
- Disaster Recovery Framework Concepts for Oracle Solaris Cluster 4.4.
- Documentation for all third-party software products.

Become the root role in the global zone of the node where you intend to run the Disaster Recovery framework.
Note - The Disaster Recovery framework software must be installed in the global zone for all nodes of each cluster in the partnership, whether the partner cluster is a global cluster or a zone cluster. For a zone cluster that will be configured in a partnership, Disaster Recovery framework software must be installed in both the zone cluster nodes and on the underlying global cluster nodes.
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/solaris/cluster/.
```
# 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, which includes Disaster Recovery framework 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 
/dev/lofi/N
# 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
```
Ensure that the solaris and ha-cluster publishers are valid.
```
# 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. 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 Updating Systems and Adding Software in Oracle Solaris 11.4.
Install the Disaster Recovery framework 4.4 software.
```
# /usr/bin/pkg install ha-cluster-geo-full
```

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 Disaster Recovery framework full group package
Description: Oracle Solaris Cluster Disaster Recovery framework full group package
Category: Meta Packages/Group Packages
State: Installed
Publisher: ha-cluster
Version: 4.4 (Oracle Solaris Cluster Disaster Recovery Framework 4.4.0.10.0)
Branch: 0.10.0 
Packaging Date: Fri Sep 23 10:44:06 2017 
Last Install Time: Mon Oct 24 21:25:53 2017  
Size: 77.00 B
FMRI: pkg://ha-cluster/ha-cluster/group-package/ha-cluster-geo-full@version:dateTtimeZ

Repeat this procedure on each node of each partner cluster.

Next Steps

Install any required software updates. Go to Updating Disaster Recovery Framework Software.

Configure the Disaster Recovery framework on the clusters. Go to Installing and Configuring the Disaster Recovery Framework Software.