This file contains:

A) Instructions on upgrading a 3.1 Final version to 3.1.x

B) Instructions on upgrading a 3.1 beta or RC version to the final version.

To upgrade from version 3.0.x, please read the file upgrade30.txt


A) Instructions on upgrading a 3.1 Final version to 3.1.1

0) Make a backup of your current working Phorum directory as well as your tables.  This
   shouldn't be necessary, but it's good common sense.  We've all misread an instruction
   that has left us cursing for hours or days.

1) Extract the code from 3.1.1 into a folder (e.g. phorum_new) at the same level as 3.1.  If
   you have access to a telnet prompt, these commands should work:
   gzip -d phorum-3.1.1.tar
   tar xvf phorum-3.1.1
   mv phorum311 phorum_new

2) Apply any changes that you had to make in common.php for version 3.1 into the
   new common.php.  For instance, the location/name of your admin area, the location/name
   of your forums.php and forums.bak.php files, and the type of database you are using if
   you are not using MySQL.

3) Apply any security measures from the old installation to the new one.  You can use the
   old forums.php and forums.bak.php files.  If you did not move them from the default
   /include folder, copy them into the new /include folder.

4) Copy any files that you may have modified in the old configuration, such as the header.php,
   footer.php and the profanity/banned users files into the new installation.

*** These changes should be made during an off time, as your phorum will be down momentarily.

5) STOP Phorum from the old Admin interface

6) Rename the directory that stores the old Phorum to something else. (e.g. phorum_old)

7) Rename the new install to the same name as the existing install.

8) Load up the new admin script, and choose "Rebuild INF File"

9) In the admin, test that all of your existing forums are in place, and that any custom
   settings have been properly migrated.

10) Take a deep breath.

11) START Phorum from the new admin interface.

12) Test all of your forums to make sure that they are responding properly.


B) Instructions on upgrading a 3.1 beta or RC version to the final version.

0) Make a backup of your current working Phorum directory as well as your tables.  This
   shouldn't be necessary, but it's good common sense.  We've all misread an instruction
   that has left us cursing for hours or days.

1) STOP Phorum (we don't want people posting and potentially screwing up the
   upgrade do we?)

2) Edit common.php and apply the same settings you now have, specifically:
     $inf_path
     $admindir (if different, otherwise leave as-is)

3) Run this little SQL Statement to update your current 'forums' structure.
     ALTER TABLE forums ADD config_suffix char(50) DEFAULT '' NOT NULL AFTER description;

4) Copy your updates over (make sure you don't overwrite your admin/forums folder
   or custom header.php and footer.php)

5) Rebuild your inf file using the admin.

6) if you use custom header and footer files, you will need to run this SQL:
     UPDATE forums SET config_suffix = table;

7) RESTART Phorum
 