Switch to English Guide
YaBB Quick Start Guide

Upgrading from YaBB 2.x

The Setup ScreenIf you are upgrading 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, make sure you have a full backup of your working YaBB. It is also advisable to inform your users that you will be upgrading before you begin.

Make note of which mods that may have been added by checking Admin Center of your old install -> Installed Mods. 2.6 came with HoneyPot, Anti-spam Question, SpamFruits, nospammeremail, self-delete-lock, X Posts Before Website Link, Event Calendar, IP-Lookup, Board password, External board link, Add Moderator, Minimum Registration Time, Set Search, Topic Preview, Ajax Live Preview, Guest Viewing Limit, Board Rules, CSS Buttons, Social Bookmarks, and Reason for Editing, as part of the core. YaBB 2.7 comes with Print Post Permissions, Advanced Details, Advanced Backup, Advanced Global Moderator Permissions, Advanced PM Minimum Posts, Advanced Referrer Controls, Advanced Time Ban, E-Mail Settings Check, ErrorLog Security, Fix Board Dupes, PM Reply to All, Style Switcher, Text Sizer, and YaBMod. If you have any of these installed on your old forum, they do not need to be reinstalled. All other mods will need to be reinstalled once you have finished upgrading your board. Note that 2.4/2.5AE/2.5.2 mods are not compatible with 2.7. Editing will need to be done.

As soon as you are ready, place your existing forum into maintenance mode. Go to the Admin Center, scroll down the left side Menu, click on "Maintenance Settings", check "Maintenance Mode?" and save the change.

Upgrading

  1. You will need to install a completely new version of YaBB 2.7 forum first!
  2. Go to the Installation section of this Quick Guide and follow all steps up through "Step 4 - Setting Up", including point 5 (which has you run the Setup program on the new forum). Then return here to the next step below.
  3. Your NEW forum is already in Maintenance Mode now, leave it that way while you complete the following steps.
  4. Be sure your OLD forum is in Maintenance Mode too.
    Versions 2.2 and later are described above, versions 2.1 and earlier, the Maintenance Mode setting is at the top of the Forum Configuration/Forum Settings page.
  5. If your old forum had 'Board password', 'Board Rules', or any other mod that directly altered the function of the Boards of your Forum you must install BoardConvert.pl into the yabb2 directory of your OLD forum, CHMod it to 755 and run it. It will create the conversion data necessary to properly import your Board settings into 2.7.
  6. If your old forum is older than 2.6 and you did not have custom Language packs using UTF-8 encoding, or your 2.6 forum was using 'ISO-8859-1' and had a 'windows-1251' encoded Language Pack (such as Russian) installed, you must install LangConvert.pl into the yabb2 directory of your OLD forum, CHMod it to 755 and run it. It will create the conversion data necessary to properly convert the encoding of your old data to UTF-8 for 2.7.
  7. Copy these files (if they exist) into your new YaBB 2.7 installation:
    • oldforum/yabbfiles/Attachments/* (all files) copy to newforum/yabbfiles/Attachments/* (all files)
    • oldforum/yabbfiles/PMAttachments/* (all files) copy to newforum/yabbfiles/PMAttachments/* (all files)
    • oldforum/yabbfiles/avatars/UserAvatars/* (all files) copy to newforum/yabbfiles/avatars/UserAvatars/* (all files)
    • oldforum/yabbfiles/Templates/default/Boards/* (all files) copy to newforum/yabbfiles/Templates/default/Boards/* (all files)
  8. If your YaBB 2 forum is NOT located on the same server as your YaBB 2.7 installation or you do not know the server path to your of your old YaBB install you will also need to copy:
    • oldforum/cgi-bin/yabb2/Boards/* (all files) copy to newforum/cgi-bin/yabb2/Convert/Boards/* (all files)
    • oldforum/cgi-bin/yabb2/Members/* (all files) copy to newforum/cgi-bin/yabb2/Convert/Members/* (all files)
    • oldforum/cgi-bin/yabb2/Messages/* (all files) copy to newforum/cgi-bin/yabb2/Convert/Messages/* (all files)
    • oldforum/cgi-bin/yabb2/Variables/* (all files) copy to newforum/cgi-bin/yabb2/Convert/Variables/* (all files)
  9. Note:
    You must use the 2x converter for all older 2x versions. 2.7 has many differences from previous versions and many files have been renamed, moved, and reconfigured.

    If your forum is very large it may take a long time to copy all the files from the four folders above. - Reminder: Make sure you have a backup of your old forum files and folders stored in a safe place.
  10. 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 may render your forum inoperable. These files have changed, so you will either have to modify the new template/css files that come with YaBB 2.7, or follow the procedures in the link below to update your existing template files before overwriting the YaBB 2.7 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 and template) in it. Now rename the .html file to new_folder_name.html. Also rename 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. Note that the CSS files may contain links to graphics that are now in a renamed folder. Change those links to point to the new_folder_name.

    Template and CSS Comparisons from earlier versions of YaBB. One more edit: in your old css files you will need to add one additional class tag for the anti-spam Honeypot. Add:
    ".green, .none {
    display:none;
    }"

    to every template/css file. If you have a preexisting class with those names, they will need to be renamed.
  11. Once the uploading is complete, go to your Admin Center and run the Convert2x utility. YaBB will handle checking the permissions on the files and folders, convert old files to the new configuration and import your old settings into your new installation. Follow the instructions on the screen. If your old installation is on the same server, put the server paths to your old YaBB installation into the appropriate text boxes. Otherwise use './Convert/' as the path to your old files. If you use the 'tab' key to move between the test fields, the converter should automatically fill in the paths to the folders holding old data.
    Important: If your old forum was running 2.6 and your character encoding was set to 'UTF-8', uncheck the 'Do you need to convert your files to UTF-8?' checkbox. Running the Language Encoding converter on UTF-8 encoded files will damage your data.
  12. Follow the on-screen instructions. If 'Do you need to convert your files to UTF-8?' was checked, you will be directed to proceed to 'Go to Convert Language' instead of logging into your new forum. Again, follow the on-screen instructions. (Converting the Language encoding requires a lot of space on your server. Make sure you have at least 3 times the space required for your old forum for the conversion to work. You'll get the space back when you're done and can delete the ./Convert and ./ConverLang folders.)
  13. Log Out and Log back into your new forum as Administrator with the admin user ID and password you used in your old forum and check your settings. YaBB should have imported your Forum date and other custom settings for you. (Note: for security reasons in 2.7, using your Screen name as your log in name is turned off by default - only your user ID or e-mail is initially usable.)
  14. Go to "Admin Center" => "Maintenance Controls" and run the "Rebuild Notifications Files" first!

    Now run the other Maintenance Controls starting with "Rebuild Message Index" going through "Rebuild Members History."
  15. Go through ALL tabs in the "Forum Settings" and "Advanced Settings" sections and verify all your settings. While most of the settings are the same for 2.6, there are a number of changes from earlier version of YaBB, 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.
  16. Go to "Maintenance Settings" and turn "Maintenance Mode?" off. Return to your forum. Refresh the page or clear the browser cache and start enjoying your brand new YaBB 2.7 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.
  17. Once you are satisfied that your old forum has been imported properly, you should delete the Converter backup files using the Admin Center 'Delete backup files' utility - this will also remove the setup and converter utility files. Note: this function only removes the files in the 'yabb2/Convert' folder. If the files you used for conversion were in your old installation, they will not be removed.
  18. You may want to keep the files in the './ConvertLang/' folders in the event some characters did not convert properly. See YaBB Codex for instructions on how to hand edit the wrongly encoded characters.
  19. As a final note - if converting from a forum older than 2.6: many of the default graphics files have been redone and renamed. Among the renamed files are the Group Membership stars. If you wish to use your old stars, they will need to be imported, otherwise you will need to assign new stars to your Member Groups from the Member Group section of the Admin Center.