NAME

dcdb-upgrade.perl - upgrade a DiaColloDB directory in-place

SYNOPSIS

dcdb-upgrade.perl -list
dcdb-upgrade.perl [OPTIONS] DBDIR

Options:
  -h, -help       # this help message
  -l, -list       # list all available upgrade packages
  -w, -which      # list previous auto-upgrades to DBDIR
  -c, -check      # check applicability of available upgrades for DBDIR
  -u, -upgrade    # apply any applicable upgrades to DBDIR (default)
  -r, -revert     # revert the most recent upgrade to DBDIR
  -a, -apply PKGS # force-apply comma-separated upgrade package(s) to DBDIR
  -[no]backup     # do/don't create auto-backups (default=do)
  -[no]keep       # do/don't keep temporary files created by upgrade (default=don't)

DESCRIPTION

dcdb-upgrade.perl checks for & applies automatic upgrades to a DiaColloDB database directory, using the DiaColloDB::Upgrade API. The DBDIR database is altered in-place, so it is safest to make a backup of DBDIR before upgrading.

OPTIONS AND ARGUMENTS

Arguments

DBDIR

DiaColloDB database directory to be checked and/or upgraded.

Options

-h, -help

Display a brief help message and exit.

-l, -list

List all known DiaColloDB::Upgrade packages.

-w, -which

List upgrades previously applied to DBDIR.

-c, -check

Check applicability of available upgrades to DBDIR.

-u, -upgrade

Apply any applicable upgrades to DBDIR; this is the default mode of operation. It is safest to make a manual backup of DBDIR before upgrading, although the DiaColloDB::Upgrade::Base hierarchy should provide backup functionality for changed files.

-r, -revert

Revert the most recently applied upgrade to DBDIR; requires that a backup was auto-created by the DiaColloDB::Upgrade::Base subclass implementing the most recent upgrade.

-a, -apply PKGS

Force-apply the comma- or space-separated list of DiaColloDB::Upgrade-compliant packages PKGS to DBDIR. Use with caution, no applicability checking is performed in this mode.

BUGS AND LIMITATIONS

Probably many.

ACKNOWLEDGEMENTS

Perl by Larry Wall.

AUTHOR

Bryan Jurish <moocow@cpan.org>

SEE ALSO

DiaColloDB::Upgrade(3pm), DiaColloDB(3pm), dcdb-info.perl(1), perl(1).