----------------------------------------------------------------------- -------- "POPFile 0.23.0-COOKIES-2" is not an official release -------- ----------------------------------------------------------------------- This is an experimental installer built using CVS files from a snapshot taken on 18 March 2005 at 14:20 GMT. To look for a newer experimental installer, visit Xuesheng's Workshop: http://www.sugelan.co.uk/popfile/cvsbuild.html ----------------------------------------------------------------------- WARNING: This is an unstable version - do NOT use it for critical data DO NOT USE THIS FOR ANYTHING MORE THAN LOGGING IN AS ADMIN RIGHT NOW (no password required); STRANGE THINGS MAY HAPPEN! ----------------------------------------------------------------------- WARNING: If this installer is used to upgrade a 0.22.2 or earlier version, the SQL database will get converted to the 0.23.0 format and there is NO WAY to convert it back into a format which is compatible with earlier versions of POPFile! >> You have been warned << ----------------------------------------------------------------------- CONTENTS Switching between this version and an earlier version Some of the POPFile changes made since the 0.22.2 release Some of the installer changes made since the 0.22.2 release Upgrading an old corpus Short File Name (SFN) problem Known Issues ---------------------------------------------------------------------- SWITCHING BETWEEN THIS VERSION AND AN EARLIER VERSION: Do not install this experimental version in the same folder as an earlier version and do not use the same 'User Data' folder as an earlier version. If you want to use your old database and message history with this new version, you can COPY the files to the 'User Data' folder used by this experimental version. The 'User Data' Backup/Restore Utility makes this task easy (http://www.sugelan.co.uk/popfile/databru.html). When you install this experimental version it will hijack your Start Menu entries and your POPFile environment variables so you will not be able to run your earlier version of POPFile in the normal manner. To reset the Start Menu entries and environment variables so you can use the earlier version of POPFile, run the adduser.exe program in the earlier version's main POPFile program folder (the one containing popfile.pl). When adduser.exe asks for the 'User Data' folder make sure you select the one used by your old version of POPFile (not the one for this experimental version). After resetting the Start Menu and environment variables to the earlier version, you can then run this experimental version using the pfi-run.bat batch file in the experimental version's 'User Data' folder. By default this CVS version will use the Message Capture utility if POPFile is configured to run in a console window. If you use the Start Menu shortcut to start this CVS version of POPFile you can make it use a DOS box instead of the Message Capture utility simply by renaming or deleting the 'pfimsgcapture.exe' file in the main POPFile folder. If you use the 'pfi-run.bat' file to run POPFile you'll need to edit the batch file or you can rename or delete the msgcapture.exe _and_ pfimsgcapture.exe files. Note for Win9x users: When you run the pfi-run.bat batch file a DOS box should appear briefly, followed by the window for the "POPFile Message Capture Utility". If all you see is a DOS box popping up and instantly disappearing (with no Message Capture Utility window appearing), you will need to allocate some more environment space for the batch file. To do this, right-click the pfi-run.bat icon, select "Properties", select the "Memory" tab and look at the "Initial environment" value (at the top right). If the setting is "Auto", select "512" from the list, click "Apply" then "OK". If the setting is not "Auto" then select a higher value (e.g. if it says "512" then change it to "768"). After increasing the environment space, double-click the pfi-run.bat icon to start the POPFile Message Capture Utility. ---------------------------------------------------------------------- SOME OF THE POPFILE CHANGES MADE SINCE THE 0.22.2 RELEASE: [P-01] Work has started on the multi-user changes for the 0.23.0 release. There are now two types of POPFile user: users with POPFile administration rights (who see the full set of UI pages) and ordinary POPFile users (who see a simpler UI). While these changes are being introduced, POPFile will probably be unstable. [P-02] The UI's Configuration page has been removed - configuration changes are now accessed from the relevant page using the new "configuration" bar at the foot of each page in the UI. This bar can be hidden since it is unlikely to be used frequently. [P-03] A new method for arranging the History page columns has been introduced (columns can be moved to left or right and removed using controls at the top of the column, columns can be restored using the configuration bar at the foot of the History page). [P-04] It is now possible to jump directly to a particular History page. [P-05] The Buckets page has been redesigned to make it easier to use, especially for those users with more than a couple of buckets. The separate buttons for each setting for each bucket have been replaced by checkboxes and there is now a single 'Apply' button. [P-06] By default POPFile no longer shows the familiar startup messages. To restore "normal" operation, use the "--verbose" command-line option. [P-07] Some more POPFile features can now be accessed via the optional XMLRPC interface (e.g. messages can be reclassified) [P-08] The SQLite corpus conversion progress messages are now more frequent, to give better feedback to the user. [P-09] A single click can now tick all the checkboxes on the history page (instead of having to click each box separately). [P-10] Cookies are now used to keep client-side state concerning the current connection to POPFile's UI. Multiple users can now be connected to POPFile's UI at the same time (but only the admin user should log in for now). There is a new 'Logout' UI link. DO NOT USE THIS FOR ANYTHING MORE THAN LOGGING IN AS ADMIN RIGHT NOW (no password is required); STRANGE THINGS MAY HAPPEN! ----------------------------------------------------------------------- SOME OF THE INSTALLER CHANGES MADE SINCE THE 0.22.2 RELEASE: [I-01] On Win9x systems, when Chinese, Japanese or Korean is selected, the installer no longer displays some garbled meaningless banner messages (it now uses English text for these messages) [I-02] If the Browse button is used to select an installation location the installer no longer appends "\POPFile" if the chosen path does not end with "\POPFile". [I-03] If the user enters a path using short filename (SFN) format the installer tries to use the long filename (LFN) equivalent. [I-04] Upgrades from very old versions of POPFile are less likely to fail. [I-05] The Message Capture utility now uses the "--verbose" command-line option to ensure that the familiar startup messages are still shown (by default POPFile 0.23.0 no longer displays any startup messages). [I-06] The separate "SSL Setup" wizard has been integrated with the main installer (this means a "live" Internet connection is required if the optional SSL files are to be downloaded and installed). If the SSL files cannot be downloaded, installation will continue. Later you can run the command "setup-cookies-2.exe /SSL" to make the installer act like the "SSL Setup" wizard (i.e. only the SSL download/install work will be performed). Alternatively you can use the separate "SSL Setup" wizard shipped with the 0.22.2 release to add the SSL support files. [I-07] The main installer now displays a summary page to allow the user to review the settings and change them before starting to install the program. [I-08] The main installer (setup-cookies-2.exe) now saves an installation log file (install.log) in the POPFile program folder. [I-09] Installer now offers to delete the old minimal Perl folder before installing the new version (this will make it easier to use a slimmer version of the minimal Perl in the future). [I-10] The installer now displays the entire list of optional components (so users do not need to expand the list to see what is available). [I-11] sqlite.exe v2.8.16 is installed (this version fixes a vacuum bug). ----------------------------------------------------------------------- UPGRADING AN OLD CORPUS This version uses a new database schema and it will automatically convert an old database to the new format used for 0.23.0 - there is NO WAY to go back to a database format which is compatible with pre-0.23.0 versions. ----------------------------------------------------------------------- WARNING: Do not use this installer with critical data - you could lose it all ----------------------------------------------------------------------- A small 'User Data' Backup/Restore Utility is available. This may be useful if you wish to relocate (or simply make a copy of) the 'User Data': http://www.sugelan.co.uk/popfile/databru.html ----------------------------------------------------------------------- SHORT FILE NAME (SFN) PROBLEM The current version of POPFile does not work properly if the values in the POPFILE_ROOT and POPFILE_USER environment variables contain spaces. To avoid problems, the installer normally uses the short file name format for these two variables. Some NTFS-based systems have disabled support for short file names. When the installer is used on such a system, it should not allow installation paths which contain spaces. If you are upgrading an earlier version which uses a path containing spaces on a system which does not support short file names, there are several workarounds, including (in no particular order): (a) Enable short file name support then use this installer to upgrade the existing version of POPFile (b) Enable short file name support, use the installer to upgrade the existing version of POPFile then disable short file name support (you'll need to repeat the enable/disable when running the installer (setup-cookies-2.exe) or the 'Add POPFile User' wizard (adduser.exe) later (c) Use the POPFile 'User Data' Backup/Restore Utility to make a backup and then restore it using a path without spaces so that this installer can upgrade the relocated 'User Data'. The POPFile 'User Data' Backup/Restore Utility can be found at http://www.sugelan.co.uk/popfile/databru.html (d) Manually relocate the existing installation and then use this installer to upgrade it ----------------------------------------------------------------------- KNOWN ISSUES (1) Installer no longer attempts to wait until the UI is responding (if user asks the installer to start POPFile) so if the installer tries to display the UI the browser may need to be refreshed before the UI can be seen (2) If something goes wrong during the pre-0.22 SQL database conversion it is possible that the new version of POPFile will delete all of the message history, so you may want to make a backup copy of the message history _before_ installing this new version. The POPFile 'User Data' Backup/Restore Utility can be used to backup the message history: http://www.sugelan.co.uk/popfile/databru.html (3) Forking should be disabled (this is the default setting for forking). Unlike the current 0.22 release this limitation is not limited to cases where the optional SSL support has been installed. (4) The new "Show/Hide Configuration" bar buttons only work on the History pages (elsewhere the configuration bar is always shown). (5) Only the 'admin' user is supported (no password required). (6) The "official" build of popfile.exe does not work so I've built a temporary replacement using NSIS to make things easier for the installer. (7) The current popfileb.exe and popfilef.exe programs do not work with this CVS version of POPFile (there is a problem with the way the packing list (popfile.pck) is handled). As a temporary workaround popfile.pck is renamed as popfile.pck.disabled in order to let the popfileb.exe & popfilef.exe programs work. ----------------------------------------------------------------------- Brian Smith POPFile (Bleeding Edge - Source Code) Discussion Forum: http://sourceforge.net/forum/forum.php?forum_id=230652 ----------------------------------------------------------------------- -------- "POPFile 0.23.0-COOKIES-2" is not an official release -------- ----------------------------------------------------------------------- (end)