srvmagt(8)
ServerView Agents Linux

[ Bottom ]

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)
Table of Contents NAME SYNOPSIS DESCRIPTION OPTIONS ARGUMENTS USE CASES ENVIRONMENT FILES DIAGNOSTICS EXIT STATUS SEE ALSO

[ Top ]