Sun Microsystems Logo
Products and Services
 
Support and Training
 
 

A  B  C  D  E  F  G  H  I  J  K  L  M  N  O  P  Q  R  S  T  U  V  W  X  Y  Z  
 
Maintenance Commandsnhinstall(1M)


NAME

 nhinstall - Foundation Services installation and configuration tool

SYNOPSIS

 /opt/SUNWcgha/sbin/nhinstall -h
 /opt/SUNWcgha/sbin/nhinstall -r directory [ -l logfile ] [ stage ]

DESCRIPTION

The nhinstall tool enables you to install and configure the Solaris operating system and the Foundation Services on all the nodes of your cluster.

Before running the nhinstall tool, configure it using the following configuration files:

  • The env_installation.conf file to define the installation environment. See env_installation.conf(4).

  • The cluster_definition.conf file to define the cluster environment. See cluster_definition.conf(4).

  • (Optional) The addon.conf file specifying additional patches and packages that you want to install. This file is useful for upgrading Foundation Services at a later stage. See addon.conf(4).

  • (Optional) The nodeprof.conf file permits the customization of Solaris installation. See nodeprof.conf(4).

  • (Optional) The diskless_nodeprof.conf file permits the customization of Solaris installation on diskless nodes. See diskless_nodeprof.conf(4).

To install the Solaris operating system and the Foundation Services on the cluster, type the following command as a superuser on the installation server:

# /opt/SUNWcgha/sbin/nhinstall -r config-file-directory

where config-file-directory is the directory containing the configuration files.

The nhinstall tool also supports a recovery mechanism based on a progress indicator. In case of a failure during installation, you can restart the installation at the point where the failure occurred by running the same command.

OPTIONS

-h

Help.

-r directory

Path to the directory containing the configuration files.

-l logfile

Name of a log file. If you specify a log file, the output is recorded in the file in addition to being displayed in the console. In case of an error, the logfile helps to trace the error and to identify the point at which the installation will restart.

stages

Specify the action you require:

reset

Reset the progress indicator to force the next installation to restart from the beginning.

clear

Unshare all the exported directories and remove all temporary files before the next installation. The progress indicator is also removed so that the next time you run the nhinstall command, the installation starts from the beginning.

add nodeID nodeID ...

Add new diskless nodes to a cluster that is already running. nodeID is the ID of the new diskless node as defined in the cluster_definition.conf file. Before you run the add stage:

  • Define the new diskless nodes in the cluster_definition.conf file by using the NODE parameter. For more information, see the cluster_definition.conf(4) man page.

    Define only the new diskless nodes that are to be added to the cluster. Do not define nodes that do not exist and that you may want to add to the cluster in the future. If you do so, the nhinstall tool will fail during installation.

  • Execute the nhinstall command with the reset or clear stage.

EXAMPLES

In the following examples, the configuration files are located in the /home/nhasconf directory on the installation server.

Example 1. To Run the nhinstall Command to Start an Installation
# /opt/SUNWcgha/sbin/nhinstall -r /home/nhasconf
Example 2. To Reset the Progress Indicator to Restart an Installation From the Beginning
# /opt/SUNWcgha/sbin/nhinstall -r /home/nhasconf reset
Example 3. To Clear the Installation Environment by Removing Temporary Files and Unsharing Exported Directories
# /opt/SUNWcgha/sbin/nhinstall -r /home/nhasconf clear
Example 4. To Add a New Diskless Node to An Existing Cluster
# /opt/SUNWcgha/sbin/nhinstall -r /home/nhasconf reset
# /opt/SUNWcgha/sbin/nhinstall -r /home/nhasconf add 40

Where 40 is the nodeID of the new diskless node.

ATTRIBUTES

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

ATTRIBUTE TYPEATTRIBUTE VALUE
ArchitectureSPARC
AvailabilitySUNWnhins
Interface StabilityEvolving

SEE ALSO

addon.conf(4), cluster_definition.conf(4), diskless_nodeprof.conf(4), env_installation.conf(4), nodeprof.conf(4)


Netra HAS FS 2.1Go To TopLast Changed September 2004