Differences

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

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision
Previous revision
howtos:backup [2007/05/27 13:27] – Vista-compatible pfidiag.zip file is slightly bigger xueshenghowtos:backup [2011/12/21 16:04] (current) – external edit 127.0.0.1
Line 9: Line 9:
   - Viruses, hardware failure, a user error, or a bug in POPFile may damage your corpus. Since the corpus reflects everything POPFile has learned about the categorization of your email, it is the single most valuable collection of files in your POPFile installation.   - Viruses, hardware failure, a user error, or a bug in POPFile may damage your corpus. Since the corpus reflects everything POPFile has learned about the categorization of your email, it is the single most valuable collection of files in your POPFile installation.
  
 +For Windows users there is a POPFile User Data Backup/Restore utility. This utility makes it easy for Windows users to make a backup of their current POPFile data which can then be restored to the same location or a different one, possibly on another computer. You can find out more about this utility on its homepage at [[http://www.sugelan.co.uk/popfile/databru.html]]
  
-===== Finding the User Data files =====+===== Finding the User Data files (Windows version) =====
  
 Originally POPFile and all of its data files were kept in your POPFile folder and its subfolders. Starting with the 0.21.0 release, the data files can now be stored separately from the POPFile files when a clean installation is performed. One of the reasons for storing the data files separately is to make it possible for each user to have their own corpus etc. Originally POPFile and all of its data files were kept in your POPFile folder and its subfolders. Starting with the 0.21.0 release, the data files can now be stored separately from the POPFile files when a clean installation is performed. One of the reasons for storing the data files separately is to make it possible for each user to have their own corpus etc.
Line 20: Line 21:
 The installer creates shortcuts to the program //runpopfile.exe// (in the POPFile folder) which sets the environment variables to the appropriate values and then starts POPFile. For "technical reasons" the installer uses the short file name (SFN) format for the environment variables it creates. The installer creates shortcuts to the program //runpopfile.exe// (in the POPFile folder) which sets the environment variables to the appropriate values and then starts POPFile. For "technical reasons" the installer uses the short file name (SFN) format for the environment variables it creates.
  
-Since the SFN format is not very human-friendly, a small utility has been created to make it easy to find the location of the User Data files for the current user. The Windows installer for POPFile 0.22.0 (or later) installs this utility and creates some Start Menu shortcuts for it (e.g. Start -> Programs -> POPFile -> Support -> PFI Diagnostic utility (simple)). If you are using POPFile 0.21.x the [[http://www.sugelan.co.uk/popfile/download/test/pfidiag.zip| PFI Diagnostic utility]] is available as a separate download (42 KB zip file).+Since the SFN format is not very human-friendly, a small utility has been created to make it easy to find the location of the User Data files for the current user. The Windows installer for POPFile 0.22.0 (or later) installs this utility and creates some Start Menu shortcuts for it (e.g. Start -> Programs -> POPFile -> Support -> PFI Diagnostic utility (simple)). If you are using POPFile 0.21.x the [[http://www.sugelan.co.uk/popfile/download/test/pfidiag.zip| PFI Diagnostic utility]] is available as a separate download (62 KB zip file).
  
 To make a full backup of POPFile, simply backup the POPFile folder and subfolders and, if your User Data is stored separately, backup the User Data folder and subfolders (assuming that the default locations were used for message history, etc). To make a full backup of POPFile, simply backup the POPFile folder and subfolders and, if your User Data is stored separately, backup the User Data folder and subfolders (assuming that the default locations were used for message history, etc).
Line 34: Line 35:
   * if a clean install was performed, or if a new user configuration has been created by the 'Add POPFile User' wizard, then the default location of the User Data depends upon the Windows version and how it has been configured. For example, if you are using Windows 2000 or XP then the default location is probably //C:\Documents and Settings\YOURUSERNAME\Application Data\POPFile// (or //%DocumentsAndSettings%\YOURUSERNAME\Application Data\POPFile//). On Windows 9x the default location could be //C:\Windows\Application  Data\POPFile\YOURUSERNAME// or //C:\Windows\Profiles\YOURUSERNAME\Application Data\POPFile//.   * if a clean install was performed, or if a new user configuration has been created by the 'Add POPFile User' wizard, then the default location of the User Data depends upon the Windows version and how it has been configured. For example, if you are using Windows 2000 or XP then the default location is probably //C:\Documents and Settings\YOURUSERNAME\Application Data\POPFile// (or //%DocumentsAndSettings%\YOURUSERNAME\Application Data\POPFile//). On Windows 9x the default location could be //C:\Windows\Application  Data\POPFile\YOURUSERNAME// or //C:\Windows\Profiles\YOURUSERNAME\Application Data\POPFile//.
  
-The installer and the 'Add POPFile User' wizard make it very easy to select a different location from the default one, and even if the default locations are used it can be difficult to find the relevant folder, so a small utility has been created to avoid the need to delve into the registry. If you used the Windows installer for 0.22.0 (or later) then the utility can be run by selecting Start -> Programs -> POPFile -> Support -> PFI Diagnostic utility (simple). If you are using POPFile 0.21.x the [[http://www.sugelan.co.uk/popfile/download/test/pfidiag.zip| PFI Diagnostic utility]] is available as a separate download (42 KB zip file).+The installer and the 'Add POPFile User' wizard make it very easy to select a different location from the default one, and even if the default locations are used it can be difficult to find the relevant folder, so a small utility has been created to avoid the need to delve into the registry. If you used the Windows installer for 0.22.0 (or later) then the utility can be run by selecting Start -> Programs -> POPFile -> Support -> PFI Diagnostic utility (simple). If you are using POPFile 0.21.x the [[http://www.sugelan.co.uk/popfile/download/test/pfidiag.zip| PFI Diagnostic utility]] is available as a separate download (62 KB zip file).
  
 Once you have identified the folders which are to be backed up, you can simply make a copy of those folders but you may want to use a utility like zip or WinZip.  If space is a concern, you can leave out the "messages" folder.  The only downside is you won't be able to reclassify any messages after a transfer or restore.  Once you have identified the folders which are to be backed up, you can simply make a copy of those folders but you may want to use a utility like zip or WinZip.  If space is a concern, you can leave out the "messages" folder.  The only downside is you won't be able to reclassify any messages after a transfer or restore. 
 +
 +The POPFile User Data Backup/Restore utility makes it easy for Windows users to make a backup of their current POPFile data, including the "messages" folder. This backup is a customised installer which can then be used to restore the user data to a new location or a new computer. You can find out more about this utility on its homepage at [[http://www.sugelan.co.uk/popfile/databru.html]]
 +
 +===== Finding the User Data files (Mac OS X version) =====
 +
 +POPFile user data is stored in //%%/Library/POPFile/%%// (same as the POPFile program folder) if you are using Mac OS X version.
  
 ===== Restoration and Transfer ===== ===== Restoration and Transfer =====
Line 44: Line 51:
  
   * 1. Shut down POPFile if it is running.   * 1. Shut down POPFile if it is running.
-  * 2.a. If the currently installed version of POPFile is equal to or older then the backup version,  +  * 2.a. If the currently installed version of POPFile is equal to or older than the backup version,  
-    * Copy the files from the backup you made above. If you used zip or WinZip, make sure to unzip the files. Either way, the files must be returned to the POPFile installation directory, which on Windows is //c:\program files\POPFile//.+    * Copy the files from the backup you made above. If you used zip or %%WinZip%%, make sure to unzip the files. Either way, the files must be returned to the POPFile user data directory. You can find it on Windows by above introduction 'Finding the User Data files', and on Mac OS X it is //%%/Library/POPFile/%%//.
   * 2.b. If the currently installed version of POPFile is newer than the backup or if POPFile isn't currently installed,    * 2.b. If the currently installed version of POPFile is newer than the backup or if POPFile isn't currently installed, 
     * Restore POPFile as above, and then reinstall the new version.  Doing it in this order will prevent some configuration files from being overwritten (like if the user added anything to stopwords).  It just saves the step of renaming the backed up config file if you are using the same version.     * Restore POPFile as above, and then reinstall the new version.  Doing it in this order will prevent some configuration files from being overwritten (like if the user added anything to stopwords).  It just saves the step of renaming the backed up config file if you are using the same version.
 
howtos/backup.1180272444.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