Upgrading pppusage from an older release
========================================


Upgrading from a version prior to 0.2.3
---------------------------------------

  In pppusage versions prior to 0.2.3, the syslog files to parse were
  specified directly in the script (by editing the variable @logfiles).
  In order to make *future* upgrades easier, the files to parse are now
  specified in /usr/local/etc/pppusagerc (on BSD) or /etc/pppusagerc (on
  Linux).

  The new default setting is to parse /var/log/messages and all of the
  rotated files (such as messages.0.gz etc.):

     $logfiles = `ls /var/log/messages*`;

  What to do now? Depends on which logfiles were used in the past:

  - *If*, in the past, /var/log/messages and *all* of the rotated
    messages.* files were specified, everything is fine.

  - *If*, in the past, /var/log/messages and only *some* of the rotated
    files were parsed, you *must* change the variable $logfiles in the
    pppusagerc if you want to keep your old pppusage database file. For
    example:

       $logfiles = "/var/log/messages /var/log/messages.0.gz";

    Note that if you don't specify exactly the same files as before, the
    pppusage data *will* be messed up, the results will be *wrong*. Also
    note that if you specify files this way (instead of using `ls') you
    *must* use normal "quotation marks", *not* the `backticks` that are
    used by default.

  - *If* some other files were parsed, you must of course change
    $logfiles. For example:

       $logfiles = "/var/log/ppp.log /var/log/ppp.log.0.gz";

  - *If*, in the past, only *one* file was parsed (as opposed to also
    parsing at least *some* of the rotated files), you should move your
    old pppusage.db out of the way and let pppusage create a new one (by
    reading more than one file). This actually has nothing to do with
    this upgrade, I'm just taking the chance to warn you once more. It
    can easily happen that you miss ppp[d] entries when the logfile
    get's rotated before pppusage has seen the newest entry! Thus, the
    pppusage results would *not* be correct.


Upgrading from a version prior to 0.2.2 (on Linux)
--------------------------------------------------

  If you are upgrading from a version prior to 0.2.2, you'll have to
  move the old database file out of the way and let pppusage create a
  new one. Else, the values for sent and received data will be messed
  up. However, the total values will still be correct. This applies to
  Linux systems only, if you're running pppusage on BSD, you can keep
  your database file.
