1 files changed, 42 insertions, 0 deletions
diff --git a/debian/UPGRADING.Debian b/debian/UPGRADING.Debian
new file mode 100644
index 0000000..724e3d0
--- /dev/null
+++ b/debian/UPGRADING.Debian
@@ -0,0 +1,42 @@
+Upgrade from 3.0.x
+==================
+
+An upgrade from a lower version of the same major version should
+happen automatically if you chose to use dbconfig-common.
+
+After an upgrade, make sure to refresh your themes and templates cache
+in the ACP (admin control panel), otherwise some pages might not
+display as they should.
+
+Note that the images folder has been moved from /usr/share/phpbb3/www/
+to /var/lib/phpbb3/. There now is a symlink from the former to the
+latter. Previously, there were symlinks from inside
+/usr/share/phpbb3/www/images/ to /var/lib/phpbb3. Since we had to make
+more and more things writable via the web, the entire directory had to
+be moved. If there are problems, make sure to check if this
+modification happened alright. Also make sure to correctly change the
+corresponding 'Alias' directive in your webserver config where
+necessary.
+
+If you did not choose to use dbconfig-common in the older package (or
+when upgrading) you may still use the provided install folder, which
+contains the upstream install/update utilities. However, with these
+you are on your own.
+
+Upgrade from older major versions
+=================================
+
+Upgrades from phpBB version 2 are not supported, however, for some
+hints concerning a manual update from phpBB2 (etch), see
+http://bugs.debian.org/550321#25.
+
+Switching from non-Debian install
+=================================
+
+Upgrading from non-Debian installed versions of phpBB is currently not
+supported.
+
+
+______________________________________________________________________
+If you have anything to add, please report to the phpbb maintainers,
+so they can add useful tips to this file.