NAME

       pmlogger_merge - helper script to merge Performance Co-Pilot archives

SYNOPSIS

       $PCP_BINADM_DIR/pmlogger_merge [-fNVE?]  [input-basename ... output-name]

DESCRIPTION

       pmlogger_merge  is  a  helper script that is used by pmlogger_daily(1) when merging all of
       the Performance Co-Pilot (PCP) archives for a single host on a single day into a  combined
       PCP archive.

       pmlogger_merge  is  a  wrapper  script for pmlogextract(1) that merges all of the archives
       matching the input-basename arguments, and creates a new archive using output-name as  the
       base name for the physical files that constitute an archive.  The input-basename arguments
       may contain meta characters in the style of sh(1).

OPTIONS

       The available command line options are:

       -f, --force
            This option causes all of the input files to be removed once the output  archive  has
            been created.

       -N, --showme
            Runs  pmlogger_merge  in a ``show me'' or ``dry run'' mode where the tasks that would
            be performed are reported, but no changes are  made.   This  is  typically  used  for
            debugging in combination with one (verbose) or two (very verbose) -V options.

       -V, --verbose
            Increase verbosity in the output progress report.

       -E, --expunge
            When  metric  metadata differences are encountered between archives to be merged, the
            default behaviour is for pmlogger_merge to fail with a fatal error  and  the  output-
            name  archive  is not created.  The -E flag instead issues a warning and excludes the
            affected metrics from the merged output archive.   This  is  intended  for  automated
            daily  archive  rotation  where  it  is highly desirable for unattended daily archive
            merging, rewriting and compression to succeed.  See also pmlogger_daily(1) and the -x
            flag to pmlogextract(1).

       -?, --help
            Display usage message and exit.

PCP ENVIRONMENT

       Environment variables with the prefix PCP_ are used to parameterize the file and directory
       names used by PCP.  On each installation, the file /etc/pcp.conf contains the local values
       for  these  variables.   The  $PCP_CONF  variable  may  be  used to specify an alternative
       configuration file, as described in pcp.conf(5).

SEE ALSO

       PCPIntro(1), pmlogextract(1), pmlogger(1) and pmlogger_daily(1).