Commands Reference, Volume 3

installms Command

Purpose

Installs the Cluster Systems Management (CSM) management server software.

Syntax

installms [-h]

installms [-f] [-v | -V] {-x | -p pkg_path1:pkgpath2} [Attr=value [Attr=value...]]

Description

The installms command is used to install the Cluster Systems Management (CSM) management server software. It automatically installs both CSM and its prerequisite software. Before running the installms command, a supported version of the operating system must be installed.

The command performs the following tasks:

Creates the /csminstall directory structure that is required for CSM files.
Note

If the /csminstall directory does not exist, it will be created by the installms command. However, it is recommended that you create the /csminstall in a separate file system before running the installms command. See the IBM CSM for AIX 5L: Software Planning and Installation Guide for more information on requirements for /csminstall.
Optionally copies the required CSM file sets to the correct /csminstall subdirectories.
Installs the CSM scripts and files, that are required to install CSM on the nodes of the cluster, to the correct /csminstall subdirectories.
Sets global cluster system attribute values.

If the -p flag is provided, the installms command copies the required file sets from the specified location into the correct subdirectories of /csminstall. If the -x flag is provided, the installms command assumes that the files have already been copied. When the installms command installs the management server software, it uses the file sets that have been copied to the /csminstall subdirectories. For a list of required file sets, see the IBM CSM for AIX 5L: Software Planning and Installation Guide.

Flags

-f: Forces installation regardless of the status of the existing installation.
-h: Writes the command's usage statement to standard output.
-p pkg_path: Specifies one or more colon-separated directories where installation packages are located. This cannot be used with -x.
-v | -V: Writes the command's verbose messages to standard output.
-x: Specifies to not copy software packages and to use packages in the /csminstall subdirectory. This flag cannot be used with -p.

Parameters

[Attr=value [Attr=value...]]: Specifies one or more Attr=value pairs, separated by spaces.
RemoteShell=<full path name of shell>: The RemoteShell attribute value determines the default remote shell for the dsh command if the DSH_REMOTE_CMD variable is not set. It also determines which shell to set up on the nodes during installation. The default attribute value is /usr/bin/rsh.
SetupRemoteShell={yes | no}: The SetupRemoteShell attribute value controls whether the remote shell is set up on the management server and the nodes. If it is set to yes or 1, then the remote shell is set up. The remote shell is not set up if the attribute is set to no or 0. The default value for this attribute is 1.

Security

You must have root privilege to run this command.

Exit Status

0: The command has run successfully.
1: An error has occurred.

Environment Variables

DSH_PATH: Sets the path that is used on the remote nodes. If DSH_PATH is not set, the default path for the remote shell is used. For example, DSH_PATH=$PATH sets the path on the remote node to the same path that is used on the source node.
DSH_REMOTE_CMD: Specifies the path of the remote shell executable to use instead of the default.
DSH_REMOTE_OPTS: Includes the options specified in the remote command when the command is forwarded to the remote nodes.
DSH_FANOUT: Sets the maximum number of concurrent remote shell commands. This can also be set by the -f flag.
DSH_LIST: Specifies a file that contains definitions of the set of nodes that comprise the node list.
DSH_TIMEOUT: Specifies the time, in seconds, to wait for response from the remote shell. This can also be set with the -t flag.
WCOLL: Specifies a file that contains definitions of the set of nodes that comprise the working collective.

Examples

To install CSM management server software using CSM file sets that were previously copied to the /tmp/csm directory, enter:
```
installms -p /tmp/csm
```
To install CSM and the packages contained in the current directory on the management server using the force option, enter:
```
installms -f -p .
```
To install CSM on the management server using the AIX CSM version 1.3.0 packages previously copied to the /csminstall/AIX/csm/1.3.0/packages directory, enter:
```
installms -x 
```

Files

/opt/csm/bin/definenode: Location of the definenode command.
/opt/csm/install/nodedef.sample: Location of the sample node definition file.

Prerequisite Information

/var/log/csm/installms.log: Location of the log file on the management server for the installms command. Up to five copies of this log are maintained. Old logs receive a numeric suffix up to 4. The oldest file is installms.log.4.

Related Information

The uninstallms command.
The IBM CSM for AIX 5L: Administration Guide.
The IBM CSM for AIX 5L: Software Planning and Installation Guide.