This section provides information and procedures to install software on the cluster nodes.
Perform this procedure to install OpenSolaris 2009.06 software on each cluster node.
Connect to a machine that you will install as a cluster node.
Become superuser.
Install the OpenSolaris 2009.06 software.
Follow instructions in OpenSolaris Automated Installer Guide. For x86 based platforms, you can alternatively follow instructions in Installing OpenSolaris From the Live CD.
If you will use COMSTAR, install iSCSI packages.
phys-schost# pkg install SUNWstmf SUNWiscsi SUNWiscsit |
Go to How to Prepare to Download Open HA Cluster Software.
Perform this procedure on each machine that you intend to install as a cluster node. In addition, if you intend to use a quorum server as a quorum device, perform this procedure on the machine that you intend to install as the quorum server.
Ensure that OpenSolaris 2009.06 software is installed. See How to Install OpenSolaris Software on the Cluster Nodes.
Become superuser on a machine to which you want to download software.
Alternatively, if your user account is assigned the Primary Administrator profile, execute commands as non-root through a profile shell, or prefix the command with the pfexec command.
Open a web browser.
Register with pkg.sun.com and obtain the necessary key and certificate for the Open HA Cluster repository, pkg.sun.com/opensolaris/ha-cluster/.
The following commands show the creation of the directory /var/pkg/sslto contain the downloaded key file and certificate file for the Open HA Cluster repository.
phys-schost# mkdir -m 0755 -p /var/pkg/ssl phys-schost# cp -i ~/Download/Open_HA_Cluster_2009.06.key.pem /var/pkg/ssl phys-schost# cp -i ~/Download/Open_HA_Cluster_2009.06.certificate.pem /var/pkg/ssl |
For more information, see Using Keys and Certificates for Repositories.
Set the location of the Open HA Cluster 2009.06 package repository.
Specify the location of the key file and the certificate file that you obtained in the previous step.
phys-schost# /usr/bin/pkg set-publisher \ -k /var/pkg/ssl/Open_HA_Cluster_2009.06.key.pem \ -c /var/pkg/ssl/Open_HA_Cluster_2009.06.certificate.pem \ -O https://pkg.sun.com/opensolaris/ha-cluster/ ha-cluster |
Verify the ha-cluster publisher and repository location.
phys-schost# /usr/bin/pkg publisher PUBLISHER URL opensolaris.org http://pkg.opensolaris.org/release ha-cluster https://pkg.sun.com/opensolaris/ha-cluster/ |
If you want to install a machine as a quorum server to use as the quorum device in your cluster, go next to How to Install and Configure Quorum Server Software.
Otherwise, if you will use virtual network interfaces (VNICs) in the cluster private interconnect and want to preconfigure the VNICs, go to How to Create a Virtual Network Interface (VNIC). You can alternatively create VNICs during cluster configuration by running the scinstall utility in Custom Mode.
Otherwise, go to How to Install Open HA Cluster 2009.06 Software.
Perform this procedure to configure a host server as a quorum server.
Perform the following tasks:
Ensure that you are registered with pkg.sun.com and that the machine to install has the necessary setup to download packages. See How to Prepare to Download Open HA Cluster Software.
Ensure that the machine that you choose for the quorum server has at least 1 Mbyte of disk space available for Quorum Server software installation.
Ensure that the quorum-server machine is connected to a public network that is accessible to the cluster nodes.
Disable the spanning tree algorithm on the Ethernet switches for the ports that are connected to the cluster public network where the quorum server will run.
Become superuser on the machine to install with Quorum Server software.
Alternatively, if your user account is assigned the Primary Administrator profile, execute commands as non-root through a profile shell, or prefix the command with the pfexec command.
Install the Quorum Server package.
quorumserver# /usr/bin/pkg install ha-cluster-quorum-server-full |
(Optional) Add the Quorum Server binary location to your PATH environment variable.
quorumserver# PATH=$PATH:/usr/cluster/bin |
(Optional) Add the Quorum Server man-page location to your MANPATH environment variable.
quorumserver# MANPATH=$MANPATH:/usr/cluster/man |
Add the following entry to the /etc/scqsd/scqsd.conf file to specify configuration information about the quorum server.
Identify the quorum server by using at least one of either an instance name or a port number. You must provide the port number, but the instance name is optional.
If you provide an instance name, that name must be unique among your quorum servers.
If you do not provide an instance name, always refer to this quorum server by the port on which it listens.
/usr/cluster/lib/sc/scqsd [-d quorumdirectory] [-i instancename] -p port |
The path to the directory where the quorum server can store quorum data.
The quorum-server process creates one file per cluster in this directory to store cluster-specific quorum information.
By default, the value of this option is /var/scqsd. This directory must be unique for each quorum server that you configure.
A unique name that you choose for the quorum-server instance.
The port number on which the quorum server listens for requests from the cluster.
(Optional) To serve more than one cluster but use a different port number or instance, configure an additional entry for each additional instance of the quorum server that you need.
Start the newly configured quorum server and its SMF service.
quorumserver# svcadm enable svc:/system/cluster/quorumserver:default |
If you will use virtual network interfaces (VNICs) in the cluster private interconnect and want to preconfigure the VNICs, go to How to Create a Virtual Network Interface (VNIC). You can alternatively create VNICs during cluster configuration by running the scinstall utility in Custom Mode.
Otherwise, go to How to Install Open HA Cluster 2009.06 Software.
Perform this optional procedure to create virtual network interfaces (VNICs) to configure in the cluster interconnect.
If you intend to run the scinstall utility in Typical mode to establish the cluster, use this procedure to preconfigure the VNICs that you will use in the private interconnect.
You can alternatively use the scinstall utility in Custom mode to configure VNICs for you during initial cluster configuration.
Create a VNIC.
Follow procedures in How to Create a Virtual Network Interface in System Administration Guide: Network Interfaces and Network Virtualization.
To configure additional VNICs after you establish the cluster, use the clsetup utility.
Install Open HA Cluster 2009.06 software on the cluster nodes. Go to How to Install Open HA Cluster 2009.06 Software.
Perform each step in this procedure as superuser on each cluster node.
Alternatively, if your user account is assigned the Primary Administrator profile, execute commands as non-root through a profile shell, or prefix the command with the pfexec command.
You cannot add or remove individual packages that are part of the ha-cluster-minimal framework software packages except by complete reinstallation or uninstallation. See How to Uninstall Open HA Cluster Software for procedures to remove the cluster framework packages.
However, you can add or remove other, optional packages without removing the ha-cluster-minimal cluster framework packages.
Ensure on each node that OpenSolaris 2009.06 software is installed and that NWAM is disabled. See How to Install OpenSolaris Software on the Cluster Nodes for instructions.
Connect to a machine to install as a cluster node.
Install the Open HA Cluster 2009.06 software.
phys-schost# /usr/bin/pkg install package |
The following table lists the primary group packages for Open HA Cluster 2009.06 software and the principal features that each group package contains. You must install at least the ha-cluster-minimal group package.
Feature |
ha-cluster-full |
ha-cluster-framework-full |
ha-cluster-data-services-full |
ha-cluster-minimal |
---|---|---|---|---|
Framework |
X |
X |
X |
X |
Agents |
X |
X | ||
Localization |
X |
X |
X | |
Framework Man Pages |
X |
X | ||
Data Service Man Pages |
X |
X | ||
Agent Builder |
X |
X |
X |
|
Generic Data Service |
X |
X |
X |
Verify that the package installed successfully.
Output is similar to the following example, which checks the installation state of the ha-cluster-full group package.
$ /usr/bin/pkg info -r ha-cluster-full Name: ha-cluster-full Summary: Sun Cluster full installation group package Category: System/HA Cluster State: Installed Publisher: ha-cluster Version: 2009.6 … |
(Optional) Add the Open HA Cluster binary location to your PATH environment variable.
phys-schost# PATH=$PATH:/usr/cluster/bin |
(Optional) Add the Open HA Cluster man-page location to your MANPATH environment variable.
phys-schos# MANPATH=$MANPATH:/usr/cluster/man |
Establish the new cluster. Go to How to Configure Open HA Cluster Software on All Nodes (scinstall).