File Formats                                        addon.conf(4)


NAME
     addon.conf - nhinstall  configuration  file  for  additional
     patches and Solaris packages

SYNOPSIS
     addon.conf

DESCRIPTION
     You can configure the nhinstall(1M) tool  to  install  additional 
     patches  and  Solaris  packages  by  modifying  the addon.conf file.

     It is not mandatory to configure this file.  If  it  is  not
     configured,  the  nhinstall  tool assumes there are no addi-
     tional patches or packages to be installed.

     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  direc-
     tory on the installation server as follows:

     # mkdir <config_dir>
     # export NHOME=/opt/SUNWcgha/config.standard
     # cd <config_dir>
     # cp $NHOME/env_installation.conf.template env_installation.conf
     # cp $NHOME/cluster_definition.conf.template cluster_definition.conf
     # cp $NHOME/addon.conf.template addon.conf

          Note:

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

EXTENDED DESCRIPTION
  Installing Additional Patches
     Each additional patch to be installed must be  specified  in
     addon.conf in the following format:

     PATCH=<patch_dir> <export_dir> <sub_dir> <phase> <location> <men> <nmen>

     The variables are:

     <patch_dir>
           The path to the patch directory.

     <export_dir>
           The name of the directory to export from the installa-
           tion server and mount on cluster nodes.

     <sub_dir>
           The name of the subdirectory-relative to the  exported
           directory-containing  the  patches  but  excluding the
           patch directory itself.

     <phase>
           Indicates the phase when the patch  must  be  applied.
           The phases are:

              S

                 The phase after the installation of  Solaris  on
                 the   master-eligible   nodes  and  the  Solaris
                 environment for diskless nodes.

              F

                 The phase after the installation of the  Founda-
                 tions Services (for all nodes).

              D

                 The phase after the installation of the  Founda-
                 tions  Services for diskless nodes if a diskless
                 environment is required. Specify this phase  for
                 patches  related  to services that are installed
                 expressly for the diskless nodes.  For  example,
                 Reliable Boot Server (RBS).

              A

                 The phase after the installation of the Applica-
                 tion Services.

     <location>
           Indicates where the patch will be installed.

              LOCAL
                Install on the root partition of nodes

              SHARED
                Install on the shared  environment, that
                is, /SUNWcgha/local/export/services.

     <men>   Indicates if  a  local  patch  is  needed  on  master-
           eligible nodes.

           Options are Y or N. Specify  N  only  if  <location>  is
           LOCAL.

     <nmen>  Indicates if a local patch is needed on diskless node.

           Options are Y or N. Specify  N  only  if  <location>  is
           LOCAL.

  Installing Additional Solaris Packages
     Each additional Solaris package  to  be  installed  must  be
     specified in addon.conf in the following format:

     PACKAGE=<package_name> <export_dir> <sub_dir> <phase> <location> <men> <nmen>

     The variables are:

     <package_name>
           The name of the package.

     <export_dir>
           The name of the directory to export from the installa-
           tion server and mount on cluster nodes.

           If you specify "-", the default location  for  Solaris
           packages  is  used,  that  is, value of SOLARIS_DIR in
           env_installation.conf(4).

     <sub_dir>
           The  name  of  the  subdirectory  (relatively  to  the
           exported directory) containing the package but exclud-
           ing the patch directory itself.

           If you specify "-", the default location  for  Solaris
           package  is  used,  that  is,  value of SOLARIS_DIR in
           env_installation.conf(4).

     <phase>
           Indicates the phase when the package must be  applied.
           The phase is:

           S

           The phase after the installation  of  Solaris  on  the
           master-eligible  nodes and Solaris environment for the
           diskless nodes.

      <location> 
           Indicate where the  package  will  be  installed.  The
           options are:

              LOCAL
                Install on the root partition of nodes

              USR_SPECIFIC
                Install  on  the  platform-specific directory.
                Specify this option only for diskless nodes.

                Note:

                For  master-eligible  nodes,   the   package   is
                installed  on  the  root partition of nodes, that
                is, in LOCAL, by default.

     <men> 
           Indicates if a package is  needed  on  master-eligible
           nodes.

           Options are Y or N.
           N is valid only when <location> is LOCAL.

     <nmen>
           Indicates if a package is needed on diskless node.
           N is valid only when <location> is LOCAL.

EXAMPLES
     # Patch for local packages of Foundation Services
     PATCH=112506-01   /export/patches  Nhas_patches F LOCAL Y Y

     # Patch for shared packages of the Foundation Services
     PATCH=112507-01   /export/patches  Nhas_patches F SHARED

     # Patch for RBS (only installed if diskless environment is requested)
     # (only on MEN nodes)
     PATCH=112508-01   /export/patches  Nhas_patches D LOCAL Y N

     # Patch for local packages of Foundation Services
     PATCH=112509-01   /export/patches  Nhas_patches A LOCAL Y Y

     # Packages to be installed on platform-specific directory (diskless only)
     PACKAGE=SUNWdriveru - - S USR_SPECIFIC N Y

     # Package to be installed on root partition (diskless only)
     PACKAGE=SUNWabc.u - - S LOCAL N Y

  Configuring the export_dir and the sub_dir
  
     Assume   that   the   patch   123456-01   is   located    at
     /export/patches/Nhas/123456-01.  In  this  case,  /export is
     already  shared  and  to  re-use  this  directory.  However,
     exporting a subdirectory of /export will cause an error.

     Therefore, the PATCH entry must be defined as follows:

     PATCH=123456-01 /export patches/Nhas_patches A LOCAL Y Y

     The installation tool will execute the following commands:

        - On the installation server:

           # share -F nfs /export


        - On remote nodes:

           # mount <server_ip>:/export /mnt
           # patchadd -r /mnt/patches/Nhas 123456-01 ...
 
     To export /export/patches/Nhas, the entry will be:

     PATCH=123456-01 /export/patches/Nhas - ...

     Where "-" means that the mount  point  is  where  the  patch
     directory  is located and there is no intermediate subdirec-
     tory.

ATTRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:

     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Architecture                | SPARC                       |
    |_____________________________|_____________________________|
    | Availability                | Patch 112511-02             |
    |_____________________________|_____________________________|


SEE ALSO
     cluster_definition.conf(4), addon.conf(4), nhinstall(1M)


Netra HA Suite 2.0  Last change: May 31, 2002                   
