How to Install Geographic Edition Software

Language:

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

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

Ensure that the Oracle Solaris OS is installed to support 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 GUI to administer Geographic Edition components, ensure that all cluster nodes have the same root password.
Read Chapter 1, Planning the Geographic Edition Installation.
Read the following manuals, which contain information that can help you plan your configuration and prepare your installation strategy:
- Oracle Solaris Cluster 4.2 Release Notes – Restrictions, bug workarounds, and other late-breaking information.
- Oracle Solaris Cluster Geographic Edition Overview .
- Documentation for all third-party software products.

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, 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.
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.2 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, perform the following steps.
  1. Download the Oracle Solaris Cluster 4.2 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.2 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.2 package repository.
```
# pkg set-publisher -g file:///mnt/repo ha-cluster
```
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.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. 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.2 .
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.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. 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.2 .
Install the Geographic Edition 4.2 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 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

If you installed from a DVD-ROM, unload the installation DVD-ROM from the DVD-ROM drive.
Repeat this procedure on each node of each partner cluster.

Next Steps

Install any required software updates. Go to Chapter 3, Updating Geographic Edition Software.

Configure Geographic Edition software on the clusters. Go to Chapter 2, Installing and Configuring the Geographic Edition Software.