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
- 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
- AIX®:
- 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.