Upgrading Burning Board 4.0 to Burning Board 4.1

Step 1: Enable maintenance mode

The maintenance mode disables the forums and most other features (including cronjobs) to preserve data consistency. We understand that putting a live forum into maintenance mode is unpleasant, but failing to do so will most likely cause data inconsistency and might even cause the upgrade to fail.

Step 2: Create a backup

You should always create a backup before applying any updates, but upgrading is a much more complicated and irreversible process. If for any reason the process fails before completion, your installation is most likely irreparably damaged and cannot be recovered, except for restoring it from a backup.


A full backup consists of two parts:

  • Full database dump
    Please avoid using phpMyAdmin for this task, it is not designed to handle large databases and eventually yield broken or incomplete dumps. We recommend using mysqldump (if you have access to the command line) or the free PhpMyAdmin.
  • Full copy of the forum files
    Create a copy of all files belonging to the software and its components, including all user-generated data, e.g. attachments

Avoid mixing database dumps with file copies originating from a different point of time, it will most likely not work or cause serve damage to your forums.

Step 3: (Optional) Adjust timeouts

The upgrade adds additional columns to these database tables:

  • wbb1_post
  • wcf1_conversation_message
  • wcf1_user

We have optimized the upgrade process to add only one column at a time, granting each query a single request to complete. If you have large sets of data in one of these tables (250k+), you might want to consider temporarily raising webserver, database and PHP timeouts to prevent the request from encountering a timeout.

Step 4: Update your installation

The update only works from the latest available version of our products, namely Burning Board 4.0.10 and WoltLab Community Framework 2.0.11 pl 1, upgrading from an earlier version will not work. Please run a full update by navigating to ACP > System > Packages > List Packages and click on the button Search for Updates and apply all updates presented to you.

Step 5: Add the required update servers

  • Navigate to ACP > System > Packages > List Update Servers
  • Click on the button Add Server
  • Insert http://update.woltlab.com/typhoon/ into the field Address and leave all other fields empty
  • Click the Submit button to add the new server
  • Repeat step 1. and 2.
  • Insert http://store.woltlab.com/typhoon/ into the field Address and leave all other fields empty
  • Click the Submit button to add the new server

Step 6: Run the update

Please navigate to ACP > System > Packages > List Packages and click on the button Search for Updates. The system should redirect you to a new page offering the beta version of Burning Board 4.1 and other products.

Step 7: Rebuild all data

Some changes require you to rebuild data, it is recommended to run all steps listed in ACP > System > Maintenance > Rebuild Data once the update has completed.

Notice

If any of these steps failed for you, please copy the error message and report the issue so we can look after it.