NAME

DiaColloDB::Upgrade::v0_09_multimap - DiaColloDB utilities: auto-magic upgrade: v0.09.x: MultiMapFile format

SYNOPSIS

 ##========================================================================
 ## PRELIMINARIES
 
 use DiaColloDB::Upgrade::v0_09_multimap;
 
 ##========================================================================
 ## API
 
 $version = $up->toversion();
 $bool    = $up->upgrade();
 
 ##========================================================================
 ## Backups & Rollback
 
 $bool  = $up->backup();
 @files = $up->revert_created();
 @files = $up->revert_updated();
 

DESCRIPTION

DiaColloDB::Upgrade::v0_09_multimap provides a DiaColloDB::Upgrade-compliant package for upgrading a DiaColloDB database directory in-place.

Upgrade actions performed:

  • updates MultiMapFile formats from v0.08.x to v0.09.x

API

toversion
 $version = $CLASS_OR_OBJECT->toversion();

Returns default target version; here "0.09.000".

upgrade
 $bool = $up->upgrade();

Performs upgrade in-place on the local DiaColloDB index in $up->{dbdir}, returns true on success.

Backups & Rollback

backup
 $bool = $up->backup();

Backup any files we expect to change during upgrade() to $up->backupdir().

revert_created
 @files = $up->revert_created();

Returns list of files created by this upgrade, for use with default DiaColloDB::Upgrade::Base::revert().

revert_updated
 @files = $up->revert_updated();

Returns list of files updated by this upgrade, for use with default DiaColloDB::Upgrade::Base::revert().

AUTHOR

Bryan Jurish <moocow@cpan.org>

COPYRIGHT AND LICENSE

Copyright (C) 2016-2020 by Bryan Jurish

This package is free software; you can redistribute it and/or modify it under the same terms as Perl itself, either Perl version 5.14.2 or, at your option, any later version of Perl 5 you may have available.

SEE ALSO

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