File: README.Debian

package info (click to toggle)
phpbb2 2.0.21-6
  • links: PTS
  • area: main
  • in suites: etch-m68k
  • size: 4,224 kB
  • ctags: 12
  • sloc: sh: 476; makefile: 108; perl: 29; php: 21
file content (75 lines) | stat: -rw-r--r-- 3,310 bytes parent folder | download | duplicates (2)
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