1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75
|
phpbb2 for Debian
-----------------
****** First use
1) If you have not installed phpbb2-conf-mysql, please see the 'setup
database' section first.
2) Make sure you include /etc/phpbb2/apache.conf in the apache config of your
choice, for example by creating a symlink from /etc/apache(2)/conf.d to it.
Usually, phpbb2 should have asked you to do this for you during
configuring.
3) Reload apache to have the changes in (2) take effect
4) Go to the URL of your board, usually http://yourserver.example.com/phpbb.
If this doesn't work, see the previous step, and consult your apache
documentation if that still doesn't resolve the issue
5) Click 'login', login with user 'Admin' and password 'admin'
6) Click 'administration panel'
7) Goto 'General Admin / Configuration'
8) Review all settings, probably set 'Disable board' to 'No' to enable the
board, and submit
9) Go to your own profile, and fill in your email address, and change your login
name and password.
You now should have a functional phpbb board with yourself as admin!
****** Security
* Register Globals: Debian does not provide security support for installations
with the PHP register_globals setting turned On. It's also not required for
phpBB to operate. Make sure it's off. It's trivial to turn it on just for
specific legacy sites that may need it.
* The "Allow HTML" in user posts setting is inherently insecure: this feature is
turned off in Debian by default and should only be turned on in fully trusted
environments. We will not be sending out security updates for this specific
feature.
****** Custom templates
Please install your custom templates in /etc/phpbb2/templates, on the
administration panel you can then add those to your installation.
****** Upgrading, converting old posts
If you have used phpBB before, and want to set over the users, forums and
post from your old installation, see the not yet written UPGRADING.Debian
(if you (try to) do so, please mail me (or provide via bug report) the caveats
you ran into, so this can be documented in the package)
****** Setup database
If you don't want to use phpbb2-conf-mysql, for example if you want to have
full control yourself or want to use a different database system, you need to
setup the database yourself.
- login to your database server (running MySQL or PostgreSQL) as the database
administrator (normally root)
- create a database 'phpbb2'
- create a user 'phpbb2' with random password, and give it
SELECT/INSERT/UPDATE/DELETE rights for the phpbb database (rights to
alter the tables is not needed)
- execute the create table commands and the starting table content from
/usr/share/doc/phpbb2/schemas/$dbms_{schema,basic}.sql
- Add the correct server-details and user-credentials in
/etc/phpbb2/config.php (see /usr/share/doc/phpbb2/examples/config.php for an
example)
For the web server, the php files are in /usr/share/phpbb2/site, use the apache
config snippet in /etc/phpbb2/apache.conf if you have an apache flavour
web server. Upon installation of phpbb2, it is offered to add a symlink in
/etc/apache*/conf.d to /etc/phpbb2/apache.conf
Don't forget to reload the web server config after installation of phpbb2!
-- Jeroen van Wolffelaar <jeroen@wolffelaar.nl>, Thu, 8 Jan 2004 00:02:43 +0100
|