How to Install 1-Node Cluster at OpenSolaris.org

You are not signed in. or register.

Community: HA Clusters

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

How to Install a Single-Node Cluster

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 86 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 86 (registration required)
Solaris Cluster Express (registration required)

How to Install Solaris Express Software

This procedure installs Solaris Express Community Edition Build 86 software.

Note - If your system is already installed with Solaris Express Community Edition Build 86, 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 86 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:
- The RPC communication service, which is required for cluster communication
- The Sun Java Web Console service, which is required to use the Cluster Manager GUI
1. 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.
2. (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.
1. Open your user initialization file for editing.
  This file is usually the .cshrc or .profile file in your home directory.
2. Ensure that the PATH variable includes the following paths:
3. Verify that the umask is set to 22.
```
umask 022
```
  This entry sets the default permissions for newly created files.
4. 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.

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

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

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