$Id: UPGRADE.txt,v 1.9 2002/12/09 14:03:03 mdruilhe Exp $ ============================================================================= Release notes for w-agora 4.1.5 ============================================================================= ============= I CHANGES ============= * main changes in this version (4.1.5) -------------------------------------- - This release mainly includes the usual bug fixes and some enhancements in the admin panel and in the templates management. - The main structural change is concerning the messages management => Mostly all messages (texts, labels & icons) have been removed from the template file msgs.php and moved to the locales/*.php localized files. - No change has been made in the database & files structures compared with previous 4.1.4, so no update script is necessary if you have 4.1.3 or 4.1.4 installed. - The only manual change that you might have to do is to update you messages files (forums/sitename/default/msgs.php or forums/sitename/forumname/msgs.php) with one of the messages file coming with the distribution. Please, read the ChangeLog file for details. -------------------------------------------- * main changes in version 4.1.4 ------------------------------- - This release include a major security fixe preventing malicious users from running external PHP scripts from your server. No change has been made in the database & files structures compared with previous 4.1.3, so no update script is necessary if you have 4.1.3 installed. * main changes in version 4.1.3 -------------------------------- - This release include a new statistics module that needs forums access to be logged. A new table sitename_log has been added for this purpose. * main changes in version 4.1.2 -------------------------------- - The extra forum fields : cle, parent, childs, thread, newest (never used before) have been definitively removed form the user table. The userid field becomes the primary key. - In order to save DB queries, the field "att_size" in the forum table is checked. As a result it must be updated properly while attachments are made to the notes (done in upgrade script) - The 'inline' field in the attachment table is now used, it was previously not set, so old attachments will not be displayed inline, unless this field is set to 1 (done in upgrade script) ============================ II MIGRATING INSTRUCTIONS ============================ Before installing the new package, you can check your current version by calling : http://www.yoursite.com/w-agora/index.php?about --------------------------------------- * Migrating from 4.1.x version to 4.1.5 --------------------------------------- 1. As usual, backup your old w-agora installation (both the w-agora tree and the database) 2. Unpack the new w-agora distribution over the current installation (see the README) 3. Depending on your previous w-agora version, you may have to run the following upgrade scripts: tools/upgrade_412.php3 (4.1.1 -> 4.1.2) tools/upgrade_413.php3 (4.1.2 -> 4.1.3) (read the instructions below) - Upgrading 4.1.3 or 4.1.4 -> 4.1.5 ----------------------------------- you have nothing to do, your installation should work the same - Upgrading 4.1.2 or 4.1.2a -> 4.1.5 ------------------------------------ run the script tools/upgrade_413.php3. eg. (read the NOTICE below) : http://www.yoursite.com/w-agora/tools/upgrade_413.php - Upgrading 4.1.0 or 4.1.1 -> 4.1.5 ------------------------------------ you will first have to run upgrade_412.php first and AFTER THAT you can run the upgrade_413.php script to upgrade your database to the latest format. eg. (read the NOTICE below) : http://www.yoursite.com/w-agora/tools/upgrade_412.php http://www.yoursite.com/w-agora/tools/upgrade_413.php --------------------------------- * Migrating from 4.0.x versions : --------------------------------- If you are running old versions of w-agora4 (4.0b1 to 4.0.3), you should not have any difficulty to run w-agora 4.1 1. As usual, backup your existing installation (both the w-agora tree and the database) 2. untar the package over the current installation (see the README) 3. run the following migrations scripts in that order (see Notice(*) ) tools/upgrade_401.php3 (versions older than 4.0.1) tools/upgrade_402.php3 (versions older than 4.0.2) tools/upgrade_403.php3 (versions older than 4.0.3) tools/upgrade_410.php3 (4.0.3 -> 4.1.0) tools/upgrade_412.php3 (4.1.1 -> 4.1.2) tools/upgrade_413.php3 (4.1.2 -> 4.1.3) For example: if you were previously running v4.0.2a, you have to run IN THAT ORDER: upgrade_403, upgrade_410, upgrade_412, upgrade_413 ----------- * NOTICE ----------- For security reason the tools/ directory is protected against unauthorized WEB access. This is done using a .htaccess file located in that directory. Either edit or rename the .htaccess before running the scripts from this directory. * Migrating from versions 3.0.x : --------------------------------- This release is almost a complete rewrite of w-agora 3.0 and is not full compatible with existing installations of w-agora 3.0. Certainly, the best way would be to reinstall w-agora 4 from scratch. Nethertheless you should be able to migrate your existing forums, assuming you already have w-agora 3 running over a mysql/postgres database. o Migrating mysql / postgres forums : ------------------------------------- Here is the steps that you should follow. - export your database using mysqldump (or similar) - remove all the w-agora tables - backup your existing w-agora installation - install the new package, then recreate empty forums with the same names and settings - import the saved tables in the appropriate new created tables o Migrating DBM forums : ---------------------- Obviously, you should have mysql or postgres enabled and running at your website. Here is some suggestions 1. Create a new postgreSQL/mysql site / forum using w-agora 3.x (DO NOT use 'agora' as site name but whatever you want) 2. Copy your DBM forum to you newly created (mysql/postgres) forum using the export script located in extras/copy_forum.php3 3. Dump/export your table using a postgres/mysql tool 4. Install w-agora 4.0 (setup, create site, create forum) 5. Import your old forum in the newly created table.