15.3 Running pse-remote-install

The pse-remote-install utility is located in the /var/adm/PSE/pse-remote-install directory, after the PSEWSF120 subset has been installed locally. You must set your current directory to be this directory before running pse-remote-install , and since most root's PATH environment variable do not have the current directory (.), you might have to specify ./pse-remote-install as the command. The following sections describe the command line options and parameters of pse-remote-install and how to run pse-remote-install .

15.3.1 pse-remote-install Command Line Options

The command line syntax for pse-remote-install is as follows:

# pse-remote-install [-h]
# pse-remote-install [-k kitpath] [-m message] -l systems_file subset  . . .

# pse-remote-install [-k kitpath] [-m message] -c systems_file subset  . . .

                     [-k kitpath]  -d systems_file subset  . . .

                     [-k kitpath]  -v systems_file subset  . . .

                      -i systems_file subset  . . .

Table 15-1 describes the command options.

Table 15-1 pse-remote-install Options

Arguments	Description
`-k kitpath`	Specifies the path to the kit. By default, the facility looks in the directory `/var/adm/PSE/pse-remote-install/ALPHA` . If you copy the kit into that directory, you do not have to specify the kitpath.
`-m message`	Specifies a configuration message to the subset control program. The PSE System Software subset control program uses this message to specify the PSE cluster domain to configure.
`systems_ file`	Specifies the name of the file that contains the cluster member machine names on which to install the software.
`subset`	Specifies the name of the subset to install. You can use a wildcard representation of a subset (such as PSE\*0) to specify multiple subsets. You must use the escape sequence (\) to prevent the shell from expanding the wildcard character.
`-c systems_file subset`	Configure the specified subsets at the hosts listed in the systems_file.
`- d systems_file subset`	Delete the specified subsets to the hosts listed in the systems_ file.
`-h`	Prints the `pse-remote-install` usage.
`-i systems_file subset`	List the installation status of subsets on the hosts listed in the systems_file.
`-l systems_file subset`	Install the specified subsets to the hosts listed in the systems_file.
`-v systems_file subset`	Run the installation verification procedure for the subsets at the hosts listed in the systems_file.

Note: The PSE Database editor creates the systems_file and updates it every time the PSE cluster member list is changed. If you are installing PSE for the first time, all the member names you identified in the PSE Database editor session are placed in this file. If you add a new member to the cluster at a later date, a new file is created that contains only the new member's machine name. The new file overwrites the old file.

The -m message option is used to pass message as an argument to the subset control program's configuration stage. Typical software subsets configuration stage only takes INSTALL and DELETE as arguments. Some subsets (such as PSEWSF120) can take a clustername as an argument to its configuration stage.

The subset argument is a list of software subset names that are to be loaded. You can specify multiple subset names if they are separated by a space character. You can also use the shell file expansion characters to specify a list of subsets. When used in conjunction with the -l , -d , - c , and -v option, the expansion is evaluated according to the contents of the kitpath directory. With the - i option, the expansion is evaluated in the target host's subset database directory (/usr/.smdb. ). Ensure the expansion characters are prefixed with the shell backslash (\) character so that the expansion characters are not expanded by the shell. For example, you can specify all of the PSE kit subsets by using the notation PSE\*120.