Difference between revisions of "PhpBB3"

From MineOS Wiki
Jump to navigation Jump to search
 
(17 intermediate revisions by the same user not shown)
Line 1: Line 1:
 
== Getting started ==
 
== Getting started ==
[http://www.phpbb.com/files/release/phpBB-3.0.9.tar.bz2 Download phpBB 3.0.9 (bz2)] (~1.5MB)
+
 
 +
You can watch a complete [http://www.youtube.com/watch?v=n05wlcMRnus Youtube video walkthrough] here.
  
 
The following instructions will set up a phpBB3 forum at <tt>[ip-address]/forum</tt>. If you prefer a different path, be sure to adjust the values accordingly.
 
The following instructions will set up a phpBB3 forum at <tt>[ip-address]/forum</tt>. If you prefer a different path, be sure to adjust the values accordingly.
 +
 +
'''Note, this page applies only to MineOS CRUX.'''  Addons are a MineOS CRUX-only functionality.  On other MineOS Variants, such as Turnkey, Ubuntu or FreeBSD, will have many similarities, but will ultimately not work with these instructions alone.  Proper installation of PhpBB3 should with [https://www.phpbb.com/community/docs/INSTALL.html instructions provided directly by phpbb].
 +
 +
There is an additional wikipage with tips and help with [[installing PhpBB3 on FreeBSD]].
 +
 +
== Enable PHP ==
 +
Enable CGI execution (PHP) in the [[Hiawatha#Enabling_CGI|Hiawatha configuration]].
  
 
== Secure MySQL ==
 
== Secure MySQL ==
Be sure to set the MySQL root password by [[MySQL#Securing_MySQL|securing your MySQL installation]]
+
Be sure to set the MySQL root password by [[MySQL#Securing_MySQL|securing your MySQL installation]].
 +
 
 +
== GD library ==
 +
PhpBB requires an imaging library, such as [[php-gd]], which is available as an [[Addons|addon]].
  
 
== Downloading phpBB3 ==
 
== Downloading phpBB3 ==
  
Download as user ''mc'':
+
Download a current version of PhpBB: [http://www.phpbb.com/files/release/phpBB-3.0.10.tar.bz2 Download phpBB 3.0.10 (bz2)] (~1.5MB)
  
<syntaxhighlight>
+
{{executeasmc
# cd /var/www/hiawatha/
+
|commands = cd /var/www/hiawatha/
# wget http://www.phpbb.com/files/release/phpBB-3.0.9.tar.bz2
+
wget http://www.phpbb.com/files/release/phpBB-3.0.10.tar.bz2
# tar -xjf phpBB-3.0.9.tar.bz2
+
tar -xjf phpBB-3.0.10.tar.bz2
# mv phpBB3 forum
+
mv phpBB3 forum}}
</syntaxhighlight>
 
  
 
== Creating database and user ==
 
== Creating database and user ==
As 'root':
+
 
 +
{{executeasmc
 +
|commands = cd /usr/games/minecraft/addons
 +
./mysql_create_user.py}}
 +
 
  
 
  <syntaxhighlight>
 
  <syntaxhighlight>
cd /usr/games/minecraft/addons
 
root:addons/ $ ./mysql_create_user.py
 
 
Type in the EXISTING root password for MySQL: mysqlrootpass
 
Type in the EXISTING root password for MySQL: mysqlrootpass
 
Database name to create in MySQL: phpforum
 
Database name to create in MySQL: phpforum
Line 57: Line 69:
  
 
* Congratulations! PhpBB is set up!
 
* Congratulations! PhpBB is set up!
 +
 +
[[Category:Addons]]

Latest revision as of 15:51, 18 June 2013

Getting started

You can watch a complete Youtube video walkthrough here.

The following instructions will set up a phpBB3 forum at [ip-address]/forum. If you prefer a different path, be sure to adjust the values accordingly.

Note, this page applies only to MineOS CRUX. Addons are a MineOS CRUX-only functionality. On other MineOS Variants, such as Turnkey, Ubuntu or FreeBSD, will have many similarities, but will ultimately not work with these instructions alone. Proper installation of PhpBB3 should with instructions provided directly by phpbb.

There is an additional wikipage with tips and help with installing PhpBB3 on FreeBSD.

Enable PHP

Enable CGI execution (PHP) in the Hiawatha configuration.

Secure MySQL

Be sure to set the MySQL root password by securing your MySQL installation.

GD library

PhpBB requires an imaging library, such as php-gd, which is available as an addon.

Downloading phpBB3

Download a current version of PhpBB: Download phpBB 3.0.10 (bz2) (~1.5MB)

Creating database and user


<syntaxhighlight>

Type in the EXISTING root password for MySQL: mysqlrootpass Database name to create in MySQL: phpforum Username for MySQL backend: phpbbuser Set the password for phpbbuser: phpbbpass /usr/bin/mysql -uroot -pmysqlrootpass -e "CREATE DATABASE IF NOT EXISTS phpforum;" /usr/bin/mysql -uroot -pmysqlrootpass -e "CREATE USER 'phpbbuser'@'localhost' IDENTIFIED BY 'phpbbpass';" /usr/bin/mysql -uroot -pmysqlrootpass -e "GRANT ALL ON *.* TO 'phpbbuser'@'localhost' IDENTIFIED BY 'phpbbpass';" /usr/bin/mysql -uroot -pmysqlrootpass -e "FLUSH PRIVILEGES;" </syntaxhighlight>

Note: phpforum, phpbbuser, and phpbbpass can and should be changed to values of your choice. These are used for PhpBB's backend into the database and WILL NOT be used beyond the installation. Also, the above SQL queries are echoed to you for your benefit as they are executed for you (no further action needed in this script).

Completing quick install

  • Open your browser to http://[ip-address]/forum/install/index.php, filling in your server's IP address.
Overview page
Install page
Requirements page (top)
Database page
Database confirmation page
Administrator page
Administrator confirmation page
Configuration confirmation page
Advanced settings page
Create database tables page
Final Stage output
Remove install directory
  • As the page states, the board is inaccessible while the /install directory exists. Remove the directory:
    • rm -rf /var/www/hiawatha/forum/install/
  • Congratulations! PhpBB is set up!