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

PCP ENVIRONMENT

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

SEE ALSO

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