Go to main content

Reference for Oracle Solaris Cluster 4.4

Exit Print View

Updated: August 2018

clinstall (8CL)


clinstall - launch the centralized installer


/usr/cluster/bin/clinstall -v
/usr/cluster/bin/clinstall -?
/usr/cluster/bin/clinstall {–g | –t}


The clinstall command launches the cluster centralized installer in either graphical-user interface (GUI) mode or text-based mode. The centralized installer is used to install Oracle Solaris Cluster software on specific potential cluster nodes, for a new cluster or for added nodes to an established cluster. The installer is used to install the Oracle Solaris Cluster framework software as well as packages for other components, such as data services and the disaster-recovery framework. The installer ignores requests to install packages that are already installed on the system.

The clinstall command has no short form.

The ha-cluster/system/preinstall package that provides the installer and its utilities is integrated into the Oracle Solaris software repository. The utility is available after installation of Oracle Solaris software on a potential cluster node. The GUI mode of the utility requires installation of the Oracle Solaris solaris-desktop package group.

The installer is launched from one system, called the control node. Interactive screens prompt the user for information about the nodes to install, the source of the software, and any optional cluster components to include. The control node then issues the command to install the software on all specified systems. Unless the control node is one of the specified nodes, it does not automatically install software on itself.

The control node first requires secure access to all potential cluster nodes. To authorize acceptance of commands that are issued by the control node, you must first run the clauth command on each node to be installed with the cluster software. You do not need to run the clauth command on the control node, but doing so causes no problems for clauth operations or cluster installation operations. If the control node issues cluster installation commands to a non-cluster system that has not authorized that control node, the installation attempt fails.

After all the installer completes software installation on the specified systems, if the cluster is not yet configured, the systems are ready to establish as a cluster by using the scinstall command.

You can use this command only in the global zone.

The general form of the clinstall command is as follows:

clinstall [options]

There are no subcommands for this command.

Each option of this command has a long form and a short form. Both forms of each option are provided with the description of the option in the “OPTIONS” section of this man page.


The following options are supported:


Displays help information. When you use this option, no other processing is performed.


Specifies that the installer is launched in GUI mode.


Specifies that the installer is launched in text-based mode.


Displays the version of the command.

Do not specify this option with other options. The other options are ignored. The –v option displays only the version of the command. No other processing is performed.

Exit Status

The following exit values are returned:


Successful completion.


An error occurred.


See attributes(7) for descriptions of the following attributes:

Interface Stability

See Also

Intro(8CL), clauth(8CL), scinstall(8)

Installing and Configuring an Oracle Solaris Cluster 4.4 Environment, Administering an Oracle Solaris Cluster 4.4 Configuration