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

File Formats | env_installation.conf(4)

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

## NAME

> env_installation.conf - `nhinstall` configuration file defining the installation environment

## SYNOPSIS

> `env_installation.conf`

## DESCRIPTION

> Configure the `env_installation.conf` file to define the installation environment for the `nhinstall` tool.

> The templates for the configuration files are contained in the `/opt/SUNWcgha/config.standard` directory with `.template` extensions. Copy the configuration files to a local directory on the installation server as follows:

> >     # mkdir config-file-directory
> >     # export NHOME=/opt/SUNWcgha/config.standard
> >     # cd config-file-directory
> >     # cp $NHOME/env_installation.conf.template env_installation.conf

> Note – All the configuration files must be in the same local directory on the installation server.

> The `env_installation.conf` file format is ASCII. Comment lines begin with the comment mark (#). Parameters consist of a keyword followed by an equals (=) sign followed by the parameter value, of the form:

> >     Keyword=Value

> The following Keyword and Value parameters are supported:

## EXTENDED DESCRIPTION

> Modify variables in the `env_installation.conf` file as follows:

> `SERVER_INTERFACE`

>   The network interface of the installation server used to access the cluster when installing the product, for example:

>   `SERVER_INTERFACE=hme1`

> `SERVER_NODE`

>   The node ID of the installation server within the cluster. This must be a unique value between 3 and 254, for example:

>   `SERVER_NODE=253`

> `SERVER_IP`

>   The IP address of the installation server. This IP address is required only when a public network is used, that is, the `PUBLIC_MEN_INTERFACES` variable is defined in `cluster_definition.conf`. If you do not specify the `SERVER_IP` variable, an IP address is automatically created based on the cluster ID, `CLUSTER_ID`, and the node ID, `SERVER_NODE`. The `CLUSTER_ID` is specified in `cluster_definition.conf`.

>   `SERVER_IP=192.168.12.50`

>   Note – If you plan to configure external IP addresses for nodes in the cluster by configuring the `PUBLIC_NETWORK` parameter in the `cluster_definition.conf` file, make sure that the IP address specified in the `SERVER_IP` parameter is on the same subnet as the one specified in the `PUBLIC_NETWORK` parameter. The `PUBLIC_NETWORK` parameter configures the network interface of the installation server.
> `AUTO_REBOOT`

>   When launched, the `nhinstall` tool automatically reboots the nodes as required during the installation process.

>   Options are `YES` and `NO`. The default is `NO`.

> `SOLARIS_INSTALL`

>   Install the Solaris operating system. Options are `ALL`, `NONE`, and `DISKLESS_ONLY`. The default is `ALL`.

>   If you choose `NONE`, the Solaris operating system is not installed on the cluster nodes. In this case, make sure of the following before launching the `nhinstall` tool:

>   - The Solaris operating system is already installed on the nodes.

>   - Java Development Kit (JDK) is not already installed on the cluster nodes.

>   If you choose `DISKLESS_ONLY`, the Solaris operating system is not installed on the master-eligible nodes. You must make sure that the Solaris operating system is already installed on the nodes before running the `nhinstall` tool. When you launch the `nhinstall` tool, the Solaris services for the diskless nodes are installed.

>   If you are using Fibre Channel-Arbitrated Loop (FC-AL) disks on Netra 20 servers, see Configuring the nhinstall Tool in Netra High Availability Suite Foundation Services 2.1 6/03 Custom Installation Guide before setting this parameter.

> `NHAS2_PRODUCT_DIR`

>   The directory containing the Foundation Services distribution, for example:

>   `NHAS2_PRODUCT_DIR=/cdrom`

> `WORKING_DIR`

>   The directory on the installation server where temporary files are created during the installation process. This directory must be writable and shared. The progress indicator used for installation recovery is also stored in this directory. Do not specify the `/tmp` directory, which is deleted in the event of a reboot.

>   `WORKING_DIR=/export/nhtmp`

> `SOLARIS_DIR`

>   The location of the Solaris distribution, for example:

>   `SOLARIS_DIR=/export/su28u7fcs`

> `DISKLESS_SOLARIS_DIR`

>   The location of the Solaris distribution for diskless nodes, if this distritbution is not the same as that installed on the other nodes in the cluster. By default, the Solaris distribution installed on the master-eligible nodes is used for `DISKLESS_SOLARIS_DIR`.

>   >     DISKLESS_SOLARIS_DIR=$SOLARIS_DIR

## EXAMPLES

> Example 1. Sample `env_installation.conf` File

> > >     #
> > >     # Copyright 2003 Sun Microsystems, Inc. All rights reserved.
> > >     #
> > >     # The usage of shell variables is authorized.
> > >     # This file is sourced by the nhinstall script.
> > >     #----------------------------------------------------
> > >     #
> > >     #  This file enables you to define the installation
> > >     #  environment.
> > >     #
> > >     #----------------------------------------------------
> > >     #
> > >     # Installation server network interface used to access the cluster.
> > >     #
> > >     SERVER_INTERFACE=hme1

> > >     #
> > >     # The node id attributed to the installation server within the cluster.
> > >     #
> > >     SERVER_NODE=253

> > >     #
> > >     #  The public IP address used only when PUBLIC_MEN_INTERFACES is configured.
> > >     #
> > >     #  For example:
> > >     #      SERVER_IP=192.168.12.50
> > >     #

> > >     #
> > >     # Install Solaris on the master-eligible nodes.
> > >     # Options are ALL, NONE, or DISKLESS_ONLY. The default is ALL.
> > >     SOLARIS_INSTALL=ALL

> > >     #
> > >     # Automatically reboot the master-eligible nodes after:
> > >     #  . The Foundation Services are installed
> > >     #  . The diskless environment is configured
> > >     #
> > >     # Options are YES or NO. The default is NO.
> > >     #
> > >     AUTO_REBOOT=NO

> > >     #
> > >     # IMPORTANT:
> > >     #  All directories mentioned below will be exported (via the share command)
> > >     #  Please check that they can be exported. The directories must not be the
> > >     #  child or parent of a directory already exported.
> > >     #

> > >     #
> > >     # Location of the Foundation Services software distribution.
> > >     # (usually the CDROM reader)
> > >     #
> > >     NHAS2_PRODUCT_DIR=/cdrom

> > >     #
> > >     # Define the working directory where:
> > >     # . The progress indicator file is stored.
> > >     # . The JumpStart directory and files used for installing Solaris
> > >     #   on nodes are created.
> > >     # This directory must be writable.
> > >     #
> > >     WORKING_DIR=/export/nhtmp

> > >     #
> > >     # Location of the Solaris distribution on the installation server.
> > >     #
> > >     SOLARIS_DIR=/export/home/s9hwl3

## ATTRIBUTES

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

> ATTRIBUTE TYPE | ATTRIBUTE VALUE
> --- | ---
> Architecture | SPARC
> Availability | SUNWnhins

## SEE ALSO

> `nhinstall`(1M), `cluster_definition.conf`(4), `addon.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.