Go to main content

Oracle® Solaris Cluster 4.3 Software Installation Guide

Exit Print View

Updated: June 2019
 
 

How to Install and Configure Oracle Solaris Cluster Quorum Server Software

Perform this procedure to configure a host server as a quorum server.

Before You Begin

Perform the following tasks:

  • Ensure that the quorum server machine is connected to a public network that is accessible to the cluster nodes and on the same subnet that is used by 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.

  1. Assume the root role on the machine on which you want to install the Oracle Solaris Cluster Quorum Server software.
  2. Ensure that the data service package is available from the configured publisher and that the solaris and ha-cluster publishers are valid.
    # pkg list -a package-name
    # 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.3.


    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.

    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 pattern 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.3.

  3. Install the Quorum Server group package.
    quorumserver# pkg install ha-cluster-quorum-server-full
  4. (Optional) Add the Oracle Solaris Cluster Quorum Server binary location to your PATH environment variable.
    quorumserver# PATH=$PATH:/usr/cluster/bin
  5. Configure the quorum server by adding the following entry to the /etc/scqsd/scqsd.conf file to specify configuration information about the quorum server.

    Identify the quorum server by specifying the port number and optionally the instance name.

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

    The format for the entry is as follows:

    /usr/cluster/lib/sc/scqsd [-d quorum-directory] [-i instance-name] -p port
    –d quorum-directory

    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.

    –i instance-name

    A unique name that you choose for the quorum-server instance.

    –p port

    The port number on which the quorum server listens for requests from the cluster.

  6. (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.
  7. Save and close the /etc/scqsd/scqsd.conf file.
  8. Start the newly configured quorum server.
    quorumserver# /usr/cluster/bin/clquorumserver start quorum-server
    quorum-server

    Identifies the quorum server. You can use the port number on which the quorum server listens. If you provided an instance name in the configuration file, you can use that name instead.

    • To start a single quorum server, provide either the instance name or the port number.

    • To start all quorum servers when you have multiple quorum servers configured, use the + operand.

Troubleshooting

Oracle Solaris Cluster Quorum Server software consists of the following packages:

  • ha-cluster/service/quorum-server

  • ha-cluster/service/quorum-server/locale

  • ha-cluster/service/quorum-server/manual

  • ha-cluster/service/quorum-server/manual/locale

These packages are contained in the ha-cluster/group-package/ha-cluster-quorum-server-full and ha-cluster/group-package/ha-cluster-quorum-server-l10n group packages.

The installation of these packages adds software to the /usr/cluster and /etc/scqsd directories. You cannot modify the location of the Oracle Solaris Cluster Quorum Server software.

If you receive an installation error message regarding the Oracle Solaris Cluster Quorum Server software, verify that the packages were properly installed.

Next Steps

If your cluster nodes support the mirroring of internal hard drives and you want to configure internal disk mirroring, go to How to Configure Internal Disk Mirroring.

SPARC: If you want to install Oracle VM Server for SPARC, go to How to Install Oracle VM Server for SPARC Software and Create Domains.

Otherwise, install the Oracle Solaris Cluster software on the cluster nodes.