There are three primary reasons for backing up POPFile.
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
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.
NOTE: If you upgrade an old version of POPFile, the Windows installer will suggest upgrading the existing data, so your data files will still be kept in the POPFile folder. This limitation only applies to the user running the installer - when POPFile is configured for use by additional users, these new users can store their data separately.
POPFile uses the POPFILE_ROOT and POPFILE_USER environment variables to find the location of the POPFile folder and the location of the User Data. The installer is aimed at the mainstream POPFile user who needs to get up and running quickly on Windows so it handles the creation of the environment variables for each user (and records the settings in the registry).
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 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).
NOTE: If POPFile has been configured for use by more than one user, there may be several different sets of User Data to be backed up!
In Windows systems the default location for POPFile is C:\Program Files\POPFile (though a different location can be chosen when running the installer).
The default location for the User Data is not so straightforward:
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 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.
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
POPFile user data is stored in /Library/POPFile/ (same as the POPFile program folder) if you are using Mac OS X version.
You may need to restore POPFile settings or want to copy your settings to another machine. For example, you may want to share your POPFile settings between your home computer and with a machine at work. To restore POPFile,
In either case, restoring the messages folder is optional. The only thing you will loose if that folder is not restored is the ability to reclassify those messages. Message reclassification on a restored machine is often not useful anyway.
If you want to go for a minimal backup, the list of files below is (or may be) vital for your configuration: