Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Next revision
Previous revision
howtos:upgradingpopfiledata [2007/01/24 09:44] amatubuhowtos:upgradingpopfiledata [2008/02/08 19:49] (current) – external edit 127.0.0.1
Line 1: Line 1:
 ====== Upgrading existing POPFile data ====== ====== Upgrading existing POPFile data ======
 +
 +===== Windows version of POPFile =====
  
 The Windows installer for POPFile should automatically detect an existing POPFile installation and offer to update it. Sometimes an update involves changes to the format or structure of POPFile's corpus database and in these cases the installer will display some progress messages (because the update can take several minutes or even longer if a very large corpus database is involved). The Windows installer for POPFile should automatically detect an existing POPFile installation and offer to update it. Sometimes an update involves changes to the format or structure of POPFile's corpus database and in these cases the installer will display some progress messages (because the update can take several minutes or even longer if a very large corpus database is involved).
  
 Although the installer includes some additional Windows utilities used to display these progress messages (e.g. the Message Capture utility) the corpus database upgrade code is not part of the installer, it is actually part of POPFile. Although the installer includes some additional Windows utilities used to display these progress messages (e.g. the Message Capture utility) the corpus database upgrade code is not part of the installer, it is actually part of POPFile.
 +
 +===== Cross-Platform version of POPFile =====
  
 This wiki page provides an overview of the corpus database upgrade process for cross-platform users. This wiki page provides an overview of the corpus database upgrade process for cross-platform users.
Line 28: Line 32:
   * [[HowTos:CrossPlatformInstall|Cross-Platform Installation]]   * [[HowTos:CrossPlatformInstall|Cross-Platform Installation]]
   * [[HowTos:AllPlatformsRequirePerl|Extra Perl modules required by POPFile]]   * [[HowTos:AllPlatformsRequirePerl|Extra Perl modules required by POPFile]]
 +
 +==== SQLite Perl module ====
    
-Be careful when adding the SQLite module - there are two incompatible versions (using the SQLite 2.x and SQLite 3.x libraries) and the current version of POPFile (0.22.3) only works with SQLite 2.x.  +Be careful when adding the SQLite module - there are two incompatible versions (using the SQLite 2.x and SQLite 3.x libraries) and the current version of POPFile (0.22.5) only works with SQLite 2.x.  
- +
 When POPFile started using SQLite the Perl SQLite module used the SQLite 2.x library but when SQLite 3.x was released the SQLite module was updated to use SQLite 3.x and a new Perl SQLite2 module was created to support SQLite 2.x. This situation can be rather confusing so the Wiki discusses it in [[:SQLite3|some detail]]. When POPFile started using SQLite the Perl SQLite module used the SQLite 2.x library but when SQLite 3.x was released the SQLite module was updated to use SQLite 3.x and a new Perl SQLite2 module was created to support SQLite 2.x. This situation can be rather confusing so the Wiki discusses it in [[:SQLite3|some detail]].
- + 
 +=== POPFile 0.22.5 === 
 + 
 +By default, POPFile 0.22.5 uses SQLite2 Perl module. So if you install POPFile for the first time, there's no need to edit popfile.cfg. 
 + 
 +=== POPFile 0.22.4 (or earlier) === 
 You may find it easier to add the SQLite2 module to your Perl installation and manually edit popfile.cfg to use SQLite2 (as described [[:SQLite3|here]]).  You may find it easier to add the SQLite2 module to your Perl installation and manually edit popfile.cfg to use SQLite2 (as described [[:SQLite3|here]]). 
 +
 +===== Upgrading process =====
    
 The upgrade from a BerkeleyDB or flat file corpus to a SQLite database will occur when POPFile starts up. This database upgrade may take several minutes (or even tens of minutes) and during this time POPFile will appear to have locked up (e.g. the UI will not work). As each corpus bucket is converted, the old BerkeleyDB database file (table.db) or old flat file (table) will be deleted so you could look at the corpus directories to monitor the upgrade progress.  The upgrade from a BerkeleyDB or flat file corpus to a SQLite database will occur when POPFile starts up. This database upgrade may take several minutes (or even tens of minutes) and during this time POPFile will appear to have locked up (e.g. the UI will not work). As each corpus bucket is converted, the old BerkeleyDB database file (table.db) or old flat file (table) will be deleted so you could look at the corpus directories to monitor the upgrade progress. 
- +
 Since the corpus conversion process destroys your existing BerkeleyDB or flat file corpus, you are recommended to make a backup copy before trying to upgrade in case something unexpected happens during the upgrade.  Since the corpus conversion process destroys your existing BerkeleyDB or flat file corpus, you are recommended to make a backup copy before trying to upgrade in case something unexpected happens during the upgrade. 
- +
 By default the new SQLite database (popfile.db) is created in the same directory as the popfile.cfg file so you can safely delete the empty corpus directory tree once the BerkeleyDB or flat file corpus conversion has been completed.  By default the new SQLite database (popfile.db) is created in the same directory as the popfile.cfg file so you can safely delete the empty corpus directory tree once the BerkeleyDB or flat file corpus conversion has been completed. 
  
 
howtos/upgradingpopfiledata.1169631854.txt.gz · Last modified: 2008/02/08 19:49 (external edit)
Old revisions

Should you find anything in the documentation that is incomplete, unclear, outdated or just plain wrong, please let us know and leave a note in the Documentation Forum.

Recent changes RSS feed Donate Driven by DokuWiki
The content of this wiki is protected by the GNU Fee Documentation License