install install
NAME
install - install a product configuration
SYNOPSIS
install -s path1 [-efilmoprvx][-c file1][-C file2][-a|-u|] -n file3
install -s path1 [-efilmoprvx][-c file1][-C file2][-a|-u|] target [target] ...
install -s path1 [-efilmoprvx][-c file1][-C file2][-a|-u|] [-n file3] target [target] ...
DESCRIPTION
The install tool installs a product configuration defined in one or more
configuration files at one or more target pathnames. The override files
in the Authorized Area at AA take precedence over the configuration
defined on the command line for any products selected in the product con-
figuration.
Options
The -s option is required, as well as one of the following options: -a,
-c, -C, or -u.
-a Install on the target the latest default version of all available
products in the Authorized Area. Incompatible with -c, -C, or -u
options.
-c configuration_file
Install the product configuration defined in the configuration file
at the pathname configuration_file. You can use the -c option mul-
tiple times to specify multiple configuration files, which together
define a configuration. The -c option is incompatible with the -a
or -u options.
-C file_list
Install the product configuration defined by the configuration files
listed in the file at file_list. The file at file_list contains the
pathnames of configuration files- one pathname per line. You can
use the -C option multiple times to specify multiple configuration
file lists, which together define a configuration. The -C option is
incompatible with the -a or -u options.
-e Check that all files required for an installation are present in the
Authorized Area before beginning the installation. In a multiple
target installation, this test is done on a target-by-target basis.
-f Write out the new baseline file only after all products in the con-
figuration are installed to a target. The default is to update the
baseline file after each product is installed.
-i The -i option tells install to ignore size checking. By default,
the install tool checks that the product configuration is smaller
than the amount of free disk space on the target and, if it isn't,
prompts you about whether to proceed with the installation. This
option is most useful in unattended installations when you are
updating already installed products, since most of the space
required by the new product versions is available after deleting the
old versions.
-l When a target pathname is on the same node as the Authorized Area,
install by creating hard links at the target to the objects in the
product directories of the Authorized Area, rather than by copying
them from the Authorized Area. This saves disk space on the Author-
ized Area node by not duplicating objects.
-m With the -m option, install will replace any objects that were
deleted from a product subsequent to its installation on a target.
By default, install will not replace an object that was deleted from
a product when that product is re-installed or updated. The -m
option will also cause install to replace symbolic links on the tar-
get with file objects from the Authorized Area where called for in
the configuration.
-n target_list
The -n option specifies the pathname of a file containing a list of
target directories. The file at target_list must contain one target
pathname
-o The -o option forces the install tool to install to each target as
many times as it is specified on the command line. By default, the
install tool installs to each target only once for each invocation
of the tool. With this option, you can ensure successful installa-
tion of software during an unattended installation over a large,
heavily used network by naming each target multiple times.
-p The -p option causes install to purge all but the most recent previ-
ous baseline file for each target.
-r The -r option causes install to launch installations on remote nodes
that have the Server Process Manager (/sys/spm/spm) running. You
must also specify a configuration by using the -c or -C option if
you use the -r option.
-s authorized_area
The -s option specifies the pathname of the Authorized Area from
which the install tool will install the product configuration. The
-s option together with the AA argument is required. The Authorized
Area at AA must contain the products defined in the configuration
specified on the command line.
-u The -u option causes install to update the target with the latest
version available in the Authorized Area of each product specified
in the baseline file at the target. The -u option is incompatible
with the -c and -C options.
-v The -v option causes install to report more information while run-
ning.
-x The -x option forces install to continue even if it encounters an
error. An installation error can often be corrected without having
to rerun install.
EXAMPLES
The following is a common install1 command line:
install -vxp -s //color -c //myhome/myfile //myhome
This command installs software on the target node //myhome from the
Authorized Area at //color, according to the configuration file
//myhome/myfile.
FILES
AA/install/tools/install
The executable for Domain/OS systems.
AA/install/tools_sr9/install
The executable for pre-SR10 systems.
AA/install/help/install.hlp
The help file for install.
SEE ALSO
install++