2. Installation & Setup

2.1. Installation process

2.1.1. System requirements

2.1.1.1. Minimum system requirements

PHP version 4.0.3 or higher.
MySQL version 3.22 or higher.
Disk Space: approx. 2MB (database and file system 1MB each)

This disk space is enough for the basic installation. As soon as content is created in the forum the use of database space increases.

2.1.1.2. System recommendations

PHP version 4.1.2 or higher
MySQL version 3.23.33 or higher
more than 20 MB database space

To estimate the database space you can use these figures:

• each template pack uses approx. 500 KB
• 3000 posts use approx. 1MB

2.1.2. Installation process

2.1.2.1. Unpack the zip file

Unpack the zip file on your hard disk.

2.1.2.2. Upload all files and folders from the folder "wbb2"

On your hard disk should be a folder "wbb2". Please upload this folder and its content on the server you want to install wBB2. The upload is usually done by FTP. You need a FTP program like WSFTP, CuteFTP or SmartFTP. Select "automatically" as transfer mode.

2.1.2.3. Set permissions

If the server is a UNIX system, following subfolders and files need to have write permissions:

• /attachments
• /images/avatars
• /acp/lib
• /acp/temp
• /cache/templates
• /cache/templates/acp
• /cache/language
• /acp/lib/config.inc.php
• /acp/lib/options.inc.php

Change permissions with the chmod command (777). Do this with the console or with the option in your FTP program.

2.1.2.4. Update from wBB1

If you want to convert data from a wBB1, copy the file _data.inc.php from your wBB1 in the subfolder /acp from wBB2. You should also get to know which board number is used by your wBB1 (important for step 5)

2.1.2.5. Start installation

You can now open http://www.your-domain.com/wbb2/acp/setup.php in your Internet browser. Please select if you want to execute a new installation or an update from wBB1. If you click on "Continue" there will be a screen where you have to enter your database access data. If it is not your own server you can get this data from your hoster. For "Board number" it is recommended to use "1". If you have already other Burning Boards installed in the same database you may need to take a different number.

If you want to update from wBB1 it is important to use a different number than wBB1. (see step 4 - _data.inc.php)

Click on "Save" and follow the installation.

2.1.2.6. After installation

After installation you should go through the Settings in the Admin Control Panel especially the General Settings. Please read chapter 4 in this documentation.

2.1.2.7. Information to the update process from wBB1

Before updating you should make a database backup and test its integrety. Furthermore the wBB1 should be set in the offline mode. User groups are not converted. Administrators should be in the standard admin group otherwise they are normal users after the update and can not access the Admin Control Panel.
After the update the permissions for forums need to be set again. The fastest way to do this is in "Edit groups" -> "Edit access rights (simplified)"

2.2. Converting from other discussion board software

If you want to take over registered users, threads, posts and boards from another discussion board software to wBB2 you need a converter. Such a converter automatically formats data from one software to a structure of another system.

2.2.1. Which converters are available?

At the moment there are available following converters:

• vBulletin 2.2.x to wBB2.0.x
• APBoard 2.02 to wBB2.0.x

2.3. Update from Burning Board 1.x.x

2.3.1. What is converted from Burning Board 1?

With the official converter you can take over:

• users
• boards
• threads
• posts
• private messages

2.3.2. Do hacks and modifications interfere the update?

No, all released hacks and modifications do not interfere with the update. Only a renaming or changing of the table columns can make problems. Hacks and mods might not work after the update.