HA Clusters Quick Links
- Download
- Download the latest Open High Availability Cluster source
- Participate
- Join the OpenSolaris HA Clusters discussions
- Contribute
- Contribute to Open High Availability Cluster
Translation for this page
EnglishDeutschEspañolFrançais??????PortugueseP??????????????
How to Install a Single-Node Cluster
| NOTE: Do not use these procedures with the Open HA Cluster 2009.06 release. Instead, follow procedures in the Open HA Cluster Installation Guide to configure a two-node cluster. The Open HA Cluster 2009.06 release does not support single-node clusters. Information posted here about Solaris Cluster Express will be retained for an undetermined period. |
Watch the movie Solaris Cluster Express Installation on a Single Node that shows you how to install Sun's Solaris High Availability (HA) Cluster software on a single node!
This procedure is a simplified set of instructions to create a cluster on a single machine, for use in developing and testing an Open HA Cluster agent. Additional information is available in the Sun™ Cluster 3.2 documentation set at http://docs.sun.com/app/docs/prod/sun.cluster32.
To create your single-node cluster, follow these procedures:
- Preinstallation Tasks
- How to Install Solaris Express Software
- How to Install Solaris Cluster Express Software
- How to Establish the Cluster
Preinstallation Tasks
Before you start to install the software, ensure the following requirements:
- Your hardware is listed in the Hardware Compatibility List at http://www.sun.com/bigadmin/hcl/data/sx/.
- You have chosen the public network IP addresses that you intend to use. You need one IP address for the cluster node and one for each data service that you configure.
- The Solaris Express Community Edition Build 101a and Solaris Cluster Express software are accessible for installation. Make the software available in one of the following ways:
- Download the software to an installation server or to a boot server.
- Burn the downloaded software onto a DVD.
The software and installation instructions are available from the following web sites:
- Solaris Express Community Edition Build 101a (registration required)
- Solaris Cluster Express 12/08 (registration required)
How to Install Solaris Express Software
This procedure installs Solaris Express Community Edition Build 101a software.
Note - If your system is already installed with Solaris Express Community Edition Build 101a, the partitioning scheme must meet Solaris Cluster Express requirements for cluster configuration to succeed.
- If the necessary partitions and allocations already exist, in particular the /globaldevices partition, you do not need to perform this procedure. Proceed to How to Install Solaris Cluster Express Software.
- If the necessary partitions and allocations do not already exist, either repartition the system disk or reinstall Solaris Express Community Edition Build 101a software by performing the steps in this procedure.
- Follow the instructions at the Solaris Express Community Edition download site http://opensolaris.org/os/downloads to install the OS on your system.
Observe these additional instructions during the installation.- Make the following installation choices.|=Prompt|=Value
| Solaris Software Group | Entire Plus OEM Support |
| Partitions | Manual formatting |
| Root password | (Specify the root password to use) |
| Automatic reboot | No |
- Set the following partition sizes and file system names, if not already set.|=Slice|=Size|=File System Name
| 0 | Half of remaining free space | / |
| 1 | 2 Gbytes | Swap |
| 4 | 512 Mbytes | /globaldevices |
| 5 | Half of remaining free space | (Unused, available for Live Upgrade alternate boot environment) |
| 7 | 32 Mbytes | (Optional) For volume manager use |
- After installation is complete and the system has rebooted, log in as superuser.
- Restore external access to remote procedure call (RPC) communication and optionally to the Sun Java™ Web Console.
During Solaris Express installation, a restricted network profile is used that restricts external access for certain network services, including the following which affect cluster functionality:
11* The RPC communication service, which is required for cluster communication
11* The Sun Java Web Console service, which is required to use the Cluster Manager GUI- Use the following commands to restore external access to RPC communication.
# **svccfg** svc:> **select network/rpc/bind** svc:/network/rpc/bind> **setprop config/local_only=false** svc:/network/rpc/bind> **quit** # **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.
- (Optional) Use the following commands to restore external access to the Sun Java Web Console.
# **svccfg** svc:> **select system/webconsole** svc:/system/webconsole> **setprop options/tcp_listen=true** svc:/system/webconsole> **quit** # **/usr/sbin/smcwebserver restart** # **netstat -a | grep 6789**
The output of the last command should return an entry for 6789, which is the port number used to connect to the Sun Java Web Console.
- Set values for the umask and the PATH in your user initialization file.
- Open your user initialization file for editing.
This file is usually the .cshrc or .profile file in your home directory. - Ensure that the PATH variable includes the following paths:/usr/bin
/usr/cluster/bin
/usr/sbin
/usr/ccs/bin - Verify that the umask is set to 22.
- Open your user initialization file for editing.
- Set values for the umask and the PATH in your user initialization file.
umask 022
This entry sets the default permissions for newly created files.
- Save and exit your user initialization file.
- Update the /etc/inet/hosts file with the public host name and logical addresses for the cluster.
Supply a public network IP address for each agent that you intend to configure.
127.0.0.1 localhost //###.###.##.#// //nodename// loghost //###.###.##.#// //agentname//
How to Install Solaris Cluster Express Software This procedure installs software packages for the Solaris Cluster Express framework.
- On the system you are installing, go to the Solaris_sparc or Solaris_x86 directory of the downloaded Solaris Cluster Express software.
- Start the installer program.
# **./installer**
- Follow the onscreen instructions to install the Solaris Cluster Express framework packages.
Supply the following information when prompted.
- Follow the onscreen instructions to install the Solaris Cluster Express framework packages.
| Screen Name | Instructions |
|---|---|
| Software License Agreement | Accept the license agreement. |
| Language Support | Choose any languages that you want to install in addition to English. |
| Installation Type | Answer no when asked if you want to install the full set of Java ES software. |
| Component Selection | Choose Sun Cluster. Confirm your selection when prompted. |
| Shared Component Upgrades Required | Accept upgrade of the list of shared components. |
| Configuration Type | Choose Configure Later. back to top |
How to Establish the Cluster
- Start the interactive scinstall utility.
# **/usr/cluster/bin/scinstall**
The scinstall Main Menu is displayed.
- Type the number for Create a New Cluster or New Cluster Node and press Return.
The New Cluster and Cluster Node Menu is displayed. - Type the number for Create a New Cluster and press Return.
The Typical or Custom Mode menu is displayed. - Type the number for Typical and press Return.
- Follow the menu prompts to supply the following information.|=Component|=Description|=Answer
- Type the number for Create a New Cluster or New Cluster Node and press Return.
| Cluster Name | What is the name of the cluster that you want to establish? | clustername |
| Cluster Nodes | List the names of the other nodes. | Press Control-d to specify that there are no other nodes in the cluster. |
| Check | Do you want to interrupt installation for sccheck errors? | No The cluster is established when the node has successfully booted into the cluster. Solaris Cluster Express installation output is logged in a /var/cluster/logs/install/scinstall.log.N file. |
- Verify that the cluster is established.
# **cluster status** === Cluster Nodes === ~--- Node Status ~--- Node Name Status ~--------- ~------ //nodename// Online