sun.com | docs.sun.com |  | How To Buy | My Sun | Worldwide Sites |

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 Commands | nhinstall(1M)

- NAME
- SYNOPSIS
- DESCRIPTION
- OPTIONS
- EXAMPLES
- ATTRIBUTES
- SEE ALSO

## 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 TYPE | ATTRIBUTE VALUE
> --- | ---
> Architecture | SPARC
> Availability | SUNWnhins
> Interface Stability | Evolving

## SEE ALSO

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

Netra HAS FS 2.1 | Go To Top | Last Changed September 2004

Company Info | Contact | Copyright 2004 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms.