1PMLOGGER_REWRITE(1)         General Commands Manual        PMLOGGER_REWRITE(1)
2
3
4

NAME

6       pmlogger_rewrite  -  helper  script to rewrite Performance Co-Pilot ar‐
7       chives
8

SYNOPSIS

10       $PCP_BINADM_DIR/pmlogger_rewrite [-dNsVvw?]  [-c config] archive ...
11

DESCRIPTION

13       pmlogger_rewrite is a helper script that is used  by  pmlogger_daily(1)
14       when  rewriting Performance Co-Pilot (PCP) archives.  Rewriting is usu‐
15       ally required to accommodate evolutionary changes in  metadata  so  old
16       archives can be updated and then merged with current archives.
17
18       pmlogger_rewrite  is a wrapper script for pmlogrewrite(1) that will po‐
19       tentially rewrite all of the archive logs matching  the  archive  argu‐
20       ments.  Each archive argument may be a PCP archive file name, the base‐
21       name for the files in a PCP archive, or a directory (in which case  all
22       subordinate PCP archives are found by recursive descent).
23
24       pmlogrewrite  is  run  with  the  -i  option  so rewriting is done ``in
25       place''.  The -q option is also used, so if no  rewriting  is  required
26       then no changes are made to the archive files.
27

OPTIONS

29       The  following  options  are  passed  through  to  pmlogrewrite: -c (or
30       --config), -d (or --desperate), -s (or --scale), -v (or --verbose)  and
31       -w  (or --warnings).  Refer to pmlogrewrite(1) for the meaning of these
32       options.
33
34       The remaining options are:
35
36       -N, --showme
37            Runs pmlogger_rewrite in a ``show me'' or ``dry run''  mode  where
38            the tasks that would be performed are reported, but no changes are
39            made.  This is typically used for debugging  in  combination  with
40            one (verbose) or two (very verbose) -V options.
41
42       -V, --verbose
43            Increase script output verbosity.
44
45       -?, --help
46            Display usage message and exit.
47

PCP ENVIRONMENT

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

SEE ALSO

56       PCPIntro(1), pmlogger(1), pmlogger_daily(1) and pmlogrewrite(1).
57
58
59
60Performance Co-Pilot                  PCP                  PMLOGGER_REWRITE(1)
Impressum