Switch to English Guide
YaBB Quick Start Guide

Upgrading from YaBB 2.x

The Setup ScreenIf you are trying to upgrade your existing YaBB 2 installation, there are a few simple steps that need to be taken in order to correctly complete the process. Before you begin, however, please make sure you have a full backup of your working YaBB. It is also advised that you inform your users you will be upgrading before you begin.

As soon as you are ready, place your existing forum into maintenance mode. In YaBB 2.1 by going into your Admin Center under the section titled "Forum Configuration", click the link "Forum Settings". There you will see a checkbox with the label "Maintenance Mode". Check this box and save the change. In YaBB 2.2.x, once in Admin Center, scroll down the left side Menu, click on "Maintenance Settings", check "Maintenance Mode?" and save the change.

Upgrading

  1. If you are upgrading from a "beta" version of YaBB 2.0, OR if you are upgrading from a YaBB 2.0 beta earlier than YaBB 2.0 Pre-Release, see this post in the YaBB Codex for further instructions on how to proceed before continuing.
  2. If you are upgrading from YaBB 2.3 Forum Software you can use the upgrade package we provide to download and follow the instructions in the README_UPDATE.txt in that package. You will not need the files in this package here and you can stop reading here now.
  3. If you are upgrading from YaBB 2.1 or later ... continue. Basically, you will install a completely new version of YaBB 2.3.1 forum and then import all your old forum's data.
  4. Be sure your old forum is in Maintenance Mode (described above).
  5. Go to the Install section of this Quick Guide and follow all steps up to and including "Step 4 - Setting Up" until point 5 (which has you run the Setup program on the new forum).
  6. Log in to your new forum (remember, your default username is "admin" and password is "admin" too) and place it in maintenance mode ("AdminCenter" => "Maintenance Settings" => "Maintenance Mode?").
  7. Using your FTP program or File Manager, copy the following files from your old forum into the same folders in your new forum:
    • cgi-bin/yabb2/Boards/*all files*
    • cgi-bin/yabb2/Members/*all files*
    • cgi-bin/yabb2/Messages/*all files*
    • public_html/yabbfiles/Attachments/*all files*
      Note:
      If your forum is very big it may take many time to copy all the files from the four folders above. In this case you also can just move the old folders. To do that, delete these four folders in your new forum first. After moving the folders, make sure that the folders Boards, Members and Messages include the files .htaccess and index.html by copying in only those files from the original YaBB 2.3.1 folders.

    • cgi-bin/yabb2/Variables/*all files EXCEPT the following files*:
      • Menu0.def, Menu1.def, Menu2.def
      • advsettings.txt
      • secsettings.txt
      • Settings.pl

    • If you have any special template files, you may wish to upload those files also, but they will need some modification before they will work properly with YaBB 2.3.1.
      Note:
      If you plan on keeping your old YaBB 2.x Templates and CSS settings, do not copy over the new template files with older templates of the same file name or you will not get what you expect. These files have changed, so you will either have to modify the new template/css files that come with YaBB 2.3.1, or follow the procedures in the link below to update your existing template files before overwriting the YaBB 2.3.1 template/css files.
      We recommend you create a new folder in your new forum: cgi-bin/yabb2/Templates/new_folder_name/ and put your old template files (html) in it. Now rename the .html file to new_folder_name.html. Rename also your old CSS file to new_folder_name.css and put it in the public_html/yabbfiles/Templates/Forum/ directory. Repeat this for each of your existing custom templates in your old forum. Template and CSS Comparisons from earlier versions to YaBB 2.3
  8. Once the uploading is complete, DO NOT visit your new forum just yet. If you are upgrading from a beta version of YaBB 2.0 earlier than YaBB 2.0 Pre-Release, specifically versions YaBB 2 RC 1, YaBB 2 RC 2, or YaBB 2 RC 3, then point your browser window to FixFile.pl and run this utility. This will update the file structure for your YaBB 2 data. If not, skip to step 10.
  9. As soon as FixFile.pl has finished, delete that file so it cannot be run again!
  10. Now verify CHMODs for all your imported files.
  11. Log in your new forum as Administrator with the Admin username and password you used in your old forum and go directy to the "Admin Center" => "Maintenance Controls" and run the "Rebuild Notifications Files" first!
  12. Run the other Maintenance Controls starting with "Rebuild Message Index" going through until "Rebuild Members History."
  13. Go to ALL tabs in the "Forum Settings" and "Advanced Settings" sections and verify all your settings. There are many new settings in version 2.3.1, so take your time here. Click the Save button at the bottom of each page even if you do not change any settings on the page.
  14. Go to "Maintenance Settings" and turn "Maintenance Mode?" off. Return to your forum. Refresh the page or clear the browser chache and start enjoying your brand new YaBB 2.3.1 Forum!
    Note:
    If you did allow users to get Email notification on new "Notifications" or new "PM" before you updated, you will have to set these settings again as new in your "Profile" => "Options" and "PM Preferences". If no other users logged in before you ran the "Rebuild Notifications Files" maintenance function, you (the Admin) will be the only one who has to reset these as new settings.