installSAM

Name

installSAM - Checks that all installation or upgrade prerequisites are met and installs or upgrades System Automation for Multiplatforms, including the end-to-end automation adapter.

Synopsis

installSAM [--noliccheck] [--nonls] [--noupgrade] [-d inst_pkg_dir] [-l log_file] [-n language] [--silent]

Description

The installSAM command first invokes the prereqSAM command, which checks that all prerequisites for the installation or upgrade of System Automation for Multiplatforms are met. If the system passes the check, installSAM verifies that the license file is available and installs or upgrades the product, including the end-to-end automation management adapter. Information about the actions that are performed during both the prerequisites check and the installation are recorded in a log file. The default log file is /tmp/installSAM.<#>.log, where <#> is a sequential number; the highest number identifies the most recent log file.

Typically, no options need to be specified. The available options allow you to install or upgrade the product although no license file is available (--noliccheck), to prevent an upgrade (--noupgrade), to install the product although the installSAM script is not in the package directory (-d), and to specify that a log file other than /tmp/installSAM.<#>.log is to be used (-l).

The installSAM command is not applicable to System Automation for Multiplatforms on Windows. For instructions on installing and upgrading System Automation for Multiplatforms on Windows, see .

Options

--noliccheck
Allows you to install or upgrade IBM Tivoli System Automation although no license file is available. This option is used by products which bundle System Automation for Multiplatforms and install the license separately. Note that System Automation for Multiplatforms can not be used if no license is installed. If you specify the option, the fact is recorded in the log file.
--nonls
Installs packages with English language support only. All messages are displayed in English. If this option is specified, option -n must not be specified.
--noupgrade
Prevents an upgrade of System Automation for Multiplatforms although an upgrade is required. You can use this option, for example, if only an initial installation is desired or to find out whether an upgrade would occur if the option were not specified.
-d inst_pkg_dir
Allows the installation of packages from the specified directory although the installSAM script is not available in the directory. This option is used by products which bundle System Automation for Multiplatforms.
-l log_file
Logs information generated by the installSAM command to the specified log file.
-n language
Installs all available packages to support the specified language in addition to English. As a prerequisite, language-independent packages with the same version and release must already have been installed. To install more than one language, the installation must be repeated for each language in turn. If this option is specified, option --nonls must not be specified. Valid values for language are as follows:
BR
Portuguese (Brazil)
DE
German
ES
Spanish
FR
French
IT
Italian
JP
Japanese
KR
Korean
CN
Simplified Chinese
TW
Traditional Chinese
--silent
Suppresses output to the command line and prompts such as acceptance of license agreements.

Exit Status

These are the return codes returned by the installSAM command during the license check and installation. For information about the return codes returned during the prerequisites check, see prereqSAM.
0
The installation or upgrade completed successfully.
1
<package installer> returned a return code other than 0; the return code and the corresponding message can be found in the log file. Package installer is:
  • AIX®: installp
  • Linux®: rpm
2
Package sam is already installed at the same version.
3
Package sam is already installed at a higher version.
4
Option --noupgrade was specified and package sam was found installed at a lower version than the package version. No upgrade was performed.
5
The node on which the installation task must be performed is online in a System Automation for Multiplatforms cluster. The task was not performed.
6
The license file for System Automation for Multiplatforms was not found, or no installed license could be detected, or the installation of the license failed.
7
installSAM was unable to continue because directories or files could not be detected or other conditions are not met.
8
The specified language is not supported. This error code may only be returned if option -n was used.

Security

This command requires root authority.