Upgrades

From XMBdocs
Jump to: navigation, search

Before Getting Started

Backup Your Forum

Please backup both your forums database and files before continuing. This may seem like common sense but is often forgotten. If the upgrade process fails and you do not have a backup, XMB will be unable to help you. All data could be lost: posts, users, etc. You have been warned!

Modifications Notice

The upgrader is designed to work when modifications are installed. Starting with XMB-1.9.11.11.zip, all custom data in your database should be preserved during the upgrade procedure. Templates are not preserved because they are overwritten as part of the upgrade. If you attempt to upgrade to an older version such as 1.9.8 to 1.9.10, all modification data, templates and code, will be destroyed during the upgrade process. Please proceed with extreme caution if you wish to keep your modification data intact.

Known Issues

These are known issues with the upgrader. However, they will only affect a small percentage of XMB Forum users.

Upgrading can be quite resource intensive, especially with large databases. The upgrade script may appear to time out or be inactive. Do NOT stop it or close your browser window. The upgrade script can consume up to two times the amount of disk space you are currently using. Make sure your disk space quota is set accordingly. If the upgrader stops while modifying any table, please contact the support staff at XMBForum.com. Restore your database and original files from backups if necessary.

How To Upgrade From Old Versions

Upgrading from XMB 1.8+

XMB-1.9.11.11.zip and newer versions will enable you to upgrade smoothly. The XMB upgrade system has been completely re-written to provide improved stability and compatibility.

Upgrading from XMB 1.6 and older versions

You must upgrade to XMB 1.8, then XMB 1.9.11.

Upgrade Instructions

  1. Disable your forums using the Board Status setting.
  2. BACKUP YOUR DATABASE - This script cannot be undone!
  3. Copy your config.php settings into the new file.
  4. Upload the XMB 1.9.11 files. Do not upload the install folder (delete it if necessary).
  5. Upload the upgrade directory to your board's root directory.
  6. Run this script by hitting the upgrade URL, for example: http://www.example.com/forum/upgrade/
  7. When the upgrade finishes successfully, delete the upgrade directory.
  8. Enable your forums using the Board Status setting.