PrimeCollect(8)
ServerView Agents Linux

[ Bottom ]

NAME
       PrimeCollect - Collect Relevant PRIMERGY Service Data

SYNOPSIS
       sh /etc/srvmagt/PrimeCollect [-hHvV]

DESCRIPTION
       The PrimeCollect shell script intends to collect relevant PRIMERGY sys-
       tem information for diagnostic purposes within PRIMERGY HW and SW ser-
       vice.  This includes primarily HW information, but also OS information
       for the supported Linux OSs.

       PrimeCollect execution requires root privileges.

       Generally, the script performs the following actions:

       o      identify ServerView Agents context

       o      identify the Linux distribution (for example Suse, RedHat,
              VMwware)

       o      identify Virtual Machine context

       o      collect support relevant data using standard tools supplied with
              the distribution (for example, supportconfig for SuSE Linux
              Enterprise Server sosreport for Red Hat Enterprise Linux, vm-
              support for VMware ESX)

       o      collect support relevant data using specific tools supplied by
              FUJITSU

       o      collect data using general system immanent tools (for example
              dmidecode, lspci)

       o      collect support relevant files

       o      collect /proc directory (partly)

       o      bundle collected data into a single archive and compress it
              (using either zip(1) or tar(1) and gzip(1), whatever the system
              offers)

       o      remove temporary data

OPTIONS
       PrimeCollect is normally called without options. Otherwise, the options
       mean

       -H, -h display help information

       -V, -v log more information on progress

FILES
       /var/log/PrimeCollect/PrimeCollect_Data_YYYY_mm_dd_HHMMSS.zip,
       /var/log/PrimeCollect/PrimeCollect_Data_YYYY_mm_dd_HHMMSS.tar.gz
              Resulting zip or gzipped tar archive with collected data

APPLICATION USAGE
       The PrimeCollect archive contains the XML file PCSysScan_Report.xml
       with important information about system HW and SW components.  The
       transformation of this XML file to HTML requires the XSLT (eXtensible
       Stylesheet Language Transformation) style sheet Report.xslt (included
       within the archive) and an XSLT 2.0-capable XSLT processor.

       For example, to perform the transformation in the Windows operating
       system using the free AltovaXML:

       1.     Transfer PCSysScan_Report.xml and PCSysScan_Report.xslt to a
              Windows operating system

       2.     Download and install AltovaXML from www.altova.com/alto-
              vaxml.html

       3.     From the command line run the command

              [path]AltovaXML /xslt2 PCSysScan_Report.xslt /in PCSysScan_Re-
              port.xml /out PCSsyScan_Report.html

RESOURCE CONSUMPTION
       PrimeCollect uses temporary disk space while collecting data and to
       store the collected results.  The following figures have been observed
       in typical configurations.

       Space for collected PrimeCollect archives
              PrimeCollect archives are between 10 and 20 MB in size, depend-
              ing on configuration.  These archives are stored in
              /var/log/PrimeCollect and remain there until the administrator
              removes them.

       Temporary space to collect data
              PrimeCollect usually collects and compresses data files (except
              for very small files) directly from original files without cre-
              ating a copy.  Thus the temporary disk space for PrimeCollect
              remains below 20 MB. This space is released when PrimeCollect
              terminates.

              [!]    These numbers do not include temporary disk space con-
                     sumed by system tool (like zip(1)) called from PrimeCol-
                     lect.

DIAGNOSTICS
       The script prints messages to log its progress to stdout and to file
       PrimeCollect.log which is part of the resulting archive.

       Error messages shown while running PrimeCollect can be ignored.  This
       is because there is only a subset of information available on the sys-
       tem under test.

EXIT STATUS
       Exit status follows LSB conventions

       0      OK, success

       1      Error, generic or unspecified error

       2      Error, another instance of PrimeCollect is already running

       3      Error, must be started as root

SEE ALSO
       zip(1), tar(1), gzip(1)

Version: 8.00                 Revised: 2017-02-15              PrimeCollect(8)
Table of Contents NAME SYNOPSIS DESCRIPTION OPTIONS FILES APPLICATION USAGE RESOURCE CONSUMPTION DIAGNOSTICS EXIT STATUS SEE ALSO

[ Top ]