Differences
This shows you the differences between the selected revision and the current version of the page.
1.3_usage 2008/09/29 04:29 | 1.3_usage 2020/02/06 11:04 current | ||
---|---|---|---|
Line 1: | Line 1: | ||
- | ====== PunBB 1.3 usage ====== | + | Moved to [[punbb13:faq|PunBB 1.3 FAQ]]. |
- | + | ||
- | ^ WARNING: PunBB 1.3 is still under development. DO NOT use it in production mode. ^ | + | |
- | + | ||
- | ===== Installation ===== | + | |
- | ==== Requirements ==== | + | |
- | * A webserver (preferably [[http://apache.org/|Apache]]). | + | |
- | * [[http://php.net/|PHP]] 4.3.0 or later (PHP 5 included). | + | |
- | * [[http://mysql.com/|MySQL]] 4.1.2 or later, [[http://postgresql.org/|PostgreSQL]] 7.0 or later or [[http://sqlite.org/|SQLite]] 2. | + | |
- | * MySQL: PunBB will not work at all with any version prior to 4.1.2. | + | |
- | * PostgreSQL: PunBB 1.3 should work fine with any version greater than 7.0. | + | |
- | * SQLite: PunBB 1.3 should work with any SQLite 2 version. SQLite 3 is not supported | + | |
- | * A database where forum data is to be stored. | + | |
- | + | ||
- | ==== Steps to install PunBB 1.3 ==== | + | |
- | - Download the latest revision of PunBB 1.3 from the [[http://punbb.informer.com/svn/punbb/branches/punbb-1.3-dev/|Subversion repository]] or [[http://punbb.informer.com/trac/browser/punbb/branches/punbb-1.3-dev|Trac browser (click "Zip Archive: link in the footer)]]. | + | |
- | - Copy/upload all contents of the directory ''upload/'' into the directory served by your web server (e.g. ''/home/user/example.com/punbb/''). | + | |
- | - Run ''install.php'' from the forum root directory (e.g. open ''http://example.com/forum/install.php'' in your browser). Follow the instructions. | + | |
- | + | ||
- | After the forum has been created, remove PunBB’s installation script (''install.php'') from the forum root for security reasons and install available hotfix extensions. | + | |
- | (You will be informed about this after logging in with admin privileges). | + | |
- | + | ||
- | Please report any problems you might encounter during installation in the [[http://punbb.informer.com/forums/forum/24/troubleshooting/|PunBB Forums]]. | + | |
- | + | ||
- | After a successful installation you may wish to enable [[wiki:"Fancy|URL Rewriting" fancy URL Rewriting]]. For other ideas, take a look at [[wiki:"1.3|usage#First Steps" First Steps]]. | + | |
- | + | ||
- | ---- | + | |
- | + | ||
- | === Migration from 1.2.* to 1.3 === | + | |
- | Follow these instructions to migrate from your current 1.2.* installation to 1.3. | + | |
- | + | ||
- | | **NOTE**: Make a backup of your current forum directory before proceeding. Also, don't forget to make a backup of your forum database. Use the tool ''mysqldump'' for MySQL and ''pg_dump'' if you are using PostgreSQL. If you're using SQLite, just make a backup copy of the SQLite database file. You can also make database backups via most administration tools such as [[http://mysql.com/products/tools/administrator/|MySQL Administrator]], [[http://phpmyadmin.net/|phpMyAdmin]] and [[http://phppgadmin.sourceforge.net/|phpPgAdmin]]. | | + | |
- | + | ||
- | - Download PunBB 1.3 and extract the archive on your hard disk. | + | |
- | - Replace your old 1.2 directory with the contents of the directory upload/ of version 1.3. | + | |
- | - Copy the file db_update.php from the version 1.3 ‘extras’ folder and paste it into the root directory of version 1.2. ''(TO BE UPDATED)'' | + | |
- | - Enter the URL leading to db_update.php in the address bar of your browser and press the ‘Start update’ button in the window that has opened. | + | |
- | - Follow instructions. | + | |
- | + | ||
- | You should now be running PunBB 1.3 | + | |
- | + | ||
- | After the installation is complete remove db_update.php from the root directory for security reasons. ''(TO BE UPDATED)'' | + | |
- | + | ||
- | ---- | + | |
- | + | ||
- | === Installing an extension for PunBB 1.3 === | + | |
- | - Download an extension’s archive from [[http://punbb.informer.com/extensions/|the PunBB extensions repository]] or other place. Extract it into your forum’s extensions directory, e.g. ''/home/user/example.com/punbb/extensions'' where ''/home/user/example.com/punbb/'' is absolute server path to your forum installation. | + | |
- | - Log into the forum and go to ''Administration'' console, ''Extensions'' section, choose ''Install extensions'' tab (http://example.com/punbb/admin/extensions.php?section=install). The downloaded extension will be listed there. | + | |
- | - Click the ''Install extension'' link to install the extension. | + | |
- | To manage the extensions installed in your forum, go to ''Extensions'' / ''Manage extensions'' (http://example.com/punbb/admin/extensions.php). | + | |
- | NOTE: You may use the [wiki:pun_repository] extension to download and install extension with one click. ''(TO BE UPDATED)'' | + |