Chapter 1. Upgrading FUD Forum 2

Table of Contents

Upgrading 2.X and 1.9X series FUDforum
Download Upgrade Script
Running the Upgrade Script
Upgrading from 1.2.8 to 2.0.2 series FUDforum
Download Upgrade Script
Running the Upgrade Script
Upgrading from 1.X to 1.2.8 FUDforum
Download Upgrade Script
Running the Upgrade Script

FUDforum 2.3 is easily upgradeable to the next stable or development release via an upgrade script that can be freely downloaded from FUDforum's website. The upgrade script is a single file, that once run via the web browser, will upgrade your existing forum to the release for which the upgrade script was downloaded for.

Note

Each time an upgrade script runs it creates/updates a special file, UPGRADE_STATUS inside the errors directory. This file will prevent the same upgrade script from running twice or running of an upgrade script that will attempt to upgrade a forum to a version older then the current one. If you find it necessary to run the same upgrade script more then once, use the file manager to remove this file before running the upgrade script.

Announcements about new FUDforum releases as well as list of major changes done in the release can be found on FUDforum's support forum, the detailed changelog is also available.

Upgrading 2.X and 1.9X series FUDforum

To upgrade from 2.X or 1.9X to the latest stable or development release is a very easy process that can be accomplished in a few minutes by following the steps outlined below.

Download Upgrade Script

You can download the latest stable or development release from the FUDforum's download page, the upgrade scripts are always available in 3 compression formats: bzip2, gzip and zip.

The upgrade script to the latest stable release can be found under the 'Upgrade from 1.9.8+ & 2.0+ to FUDforum [version number]' sub-heading. The upgrade script to the latest development release can be found under the 'Upgrade from 1.9.8+ & 2.0+ to FUDforum [version number] (Development Release)' sub-heading.

If you wish to get an upgrade script to the very latest development release, you can do so via FUDforum's anonymous CVS, by doing the following:

Example 1.1. Downloading FUDforum upgrade script from CVS


cvs -z3 -d :pserver:anonymous@asuka.prohost.org:/forum21 checkout fud21_upgrade

Once the files are retrieved, run the following commands to create the upgrade script

cd fud21_install
chmod 644 upgrade.php
chmod 755 create_file_list
./create_file_list install 1>> upgrade.php

                                

Note

You will need to have php binary installed on your system in order to generate the install.php installation script. If you already have a php binary in your system, but it is not inside /usr/local/bin/php, modify the 1st line inside the install.php script to reflect the proper path of the php binary on your system.

Now that you have the upgrade script on your server, decompress it and place it inside your forum's main web directory, so that you can access the upgrade script by going to http://you_forum_url/upgrade.php

Running the Upgrade Script

Now that the upgrade script has been positioned, open the http://you_forum_url/upgrade.php URL with your web browser, this will begin the execution of the upgrade script. The script will output various progress indicators, letting you know of what is it doing at the moment.

Note

If you have output buffering enabled or using buffering modules such as mod_gzip you may not see any output of the upgrade script until it finishes.

Upon the completion of the upgrade script, you will need to run a consistency checker to rebuilt various caches and verify consistency of your forum's data. The upgrade script will try to automatically to run the consistency checker by popping up a new window using JavaScript. If for some reason such window does not appear click on the 'MUST click here' link, which will execute the consistency checker in the current window.

Once the consistency checker finishes running, the upgrade process is complete. The only thing left to do, is to remove the upgrade.php script you've placed inside the forum's web directory in the 1st step.