NAME srvmagt - ServerView Agents Linux Install Script SYNOPSIS srvmagt [-h|--help|--version] srvmagt [-fnRV][-p path] [-v vers] [--ssm inst] {install|start|restart|status|diag|stop|remove} srvmagtDVD.sh # shar for ServerView Suite DVD srvmagt.sh [options][action] # shar for SoftwarePool DESCRIPTION The srvmagt (bash) shell script combines maintenance actions for the RPM scripts of ServerView Agents Linux rpm -U srvmagt-mods_src-version-release.<arch>.rpm rpm -U ServerViewConnectorService-version-release.<arch>.rpm rpm -U srvmagt-eecd-version-release.<arch>.rpm rpm -U srvmagt-agents-version-release.<arch>.rpm rpm -U SSMWebUI-version-release.noarch.rpm rpm -U srv-cimprovider-version-release.x86_64.rpm and applies them in turn to all packages. There are two shell archives that contain the specified function srv- magt (named therein _srvmagt.sh) together with other components (mes- sage catalogues, shell function library, manual page, ServerView Agents README). Both shell archives have the .sh suffix for convenience. Both unpack the components prior to execution. srvmagtDVD.sh is specifically intended for RPM package installation directly from PRIMERGY ServerView Suite DVD. It contains additional logic for DVD installation. srvmagt.sh is specifically intended for installation of RPM packages directly downloaded from the FUJITSU SoftwarePool or prepared in a directory in the file system. srvmagt tries to test and verify all the dependencies known from expe- rience, catch all the necessary preparations and finally perform the required action to establish ServerView Agents Linux on the system. It checks if the target system satisfies the necessary requirements, tests dependencies and configuration and issues calls to the rpm(8) command that actually install or remove the packages. You must be root to execute this script. OPTIONS If called without options, srvmagt displays status. Otherwise, the options mean -f forces the intended action against an issued warning/rejection. [!] In that case you act on your own risk and responsibility. The behavior and functionality is undefined. -h|--help displays short SYNOPSIS of the command syntax and exits. -n does not start any ServerView Agents' daemon during installation with the install action. -p path where path indicates where the RPM packages are located. path is a path to a directory in a local or remote file system, like . (dot), the current directory. It must start with a / (slash) or with ./ (dot slash) or must be one of the special paths cd or dvd that tell to locate the RPM packages on the mounted PRIMERGY ServerView Suite DVD. [!] path must not contain spaces or special characters, even if these are properly escaped. Or path is an URL to a web site. An URL starts with scheme: see RFC 2396. -R also installs the ServerView RAID Manager RPM package if it is supplied together with the other RPM packages. --ssm inst determines the installation of ServerView System Monitor. inst may be install or not-install. Default is to install the ServerView System Monitor. [!] This option is only evaluated on RedHat, SuSE and Oracle Linux systems. -v vers indicates the version to handle. Default is the version of this script. -V log more information on progress. --version prints the script version and exits. ARGUMENTS Generally, the script performs the following test and decisions: o identify the Linux distribution (e.g. suse, redhat, ora- clelinux, citrix) o identify the kernel version and architecture (one of x86, x86-64, ia64) o identify the PRIMERGY server model using SM BIOS data o identify if PLDP or DUP is supported. In this case, the script tries automatically to install the ServerView kmp modules if necessary. o verify presence of SNMP packages for all server models and other packages for specific models or distrbutions. The final argument indicates the requested action, default status. install installs (repairs, upgrades) all ServerView Agents Linux' RPM packages according to the already installed configuration and the version supplied with the -v option. The corresponding ser- vices (i.e. daemons) are started afterwards unless the -n option is also given. start starts ServerView Agents Linux. restart restarts ServerView Agents Linux. status shows status of ServerView Agents Linux. diag collects diagnostic material by calling PrimeCollect(8). stop stops ServerView Agents Linux. remove removes all ServerView Agents Linux RPM packages. USE CASES There are three use cases for srvmagt: I) Installation from ServerView Suite DVD The DVD contains the ServerView Agents RPM packages and the shell archive srvmagtDVD.sh. To install the ServerView Agents from DVD 1. Insert the DVD into the drive and mount it if necessary 2. Browse in the DVD Web UI to ServerView Agents Linux 3. Download the srvmagtDVD.sh script to /tmp 4. Open (as root) a terminal, cd to /tmp and run sh srvmagtDVD.sh [-R] [--ssm install|not-install] The script installs the RPM packages from the DVD. II) Installation from a directory in the file system (not DVD) The ServerView Agents RPM packages plus the srvmagt.sh (shell archive) are stored in the file system at path, for example after their download from the FUJITSU support site. To install the ServerView Agents 1. Open a terminal as root and cd to path 2. Run sh ./srvmagt.sh [options] install [!] The leading sh and ./ ensure that the script is executed from the current working directory! The script installs the RPM packages. III) RPM package maintenance after installation The ServerView Agents RPMs are installed by either I or II. To maintain ServerView Agents (RPMs) 1. Open a terminal as root and cd to <path> 2. Run [/usr/sbin/]srvmagt [options] action with options and action as described above under OPTIONS and ARGUMENTS ENVIRONMENT BASH srvmagt.sh requires to be executed by bash(1) and tests that the BASH variable is not empty. LANG srvmagt.sh is internationalized for English and German language. If the LANG variable is set and an appropriate message catalog srvmagt_${LANG%_*}.msg is available, srvmagt.sh uses that mes- sage catalog, otherwise English language. FILES {/etc/srvmagt/messages|.}/srvmagt_de.msg /etc/[snmp/]snmpd.conf /etc/srvmagt/config /etc/{SuSE|redhat|oracle}-release /var/log/srvmagt/log.install (citrix only) DIAGNOSTICS The script prints messages to log its progress to stdout and error mes- sages to stderr. Relevant log entries are also logged to syslog, see logger(1). EXIT STATUS Exit status follows LSB conventions 0 OK, success 1 Error, generic or unspecified error 2 Argument Error, invalid or excess argument(s) 3 Not implemented, unimplemented feature, e.g. "reload") 4 Not authorized, user had insufficient privileges 5 Missing tool, program is not installed 6 Not configured, program is not configured 7 Not running, program is not running 151 Unsupported OS 152 Update failed, kmps could not be updated 153 Partially installed, installation of ServerView System Monitor and / or CIM provider failed. SEE ALSO ServerView Agents Linux Release Notes rpm(8), srvmagt-agents(8), PrimeCollect(8). Version: 8.00 Revised: 2017-02-15 srvmagt(8)