aboutsummaryrefslogtreecommitdiffstats
path: root/README.mga.md
diff options
context:
space:
mode:
authorColin Guthrie <colin@mageia.org>2013-12-03 11:24:46 +0000
committerColin Guthrie <colin@mageia.org>2013-12-03 11:24:46 +0000
commit7bbd3c1a68513bf5a560a5ed6da60715dd54d19a (patch)
tree0cbcd99fff1f7f9f376da7c396850ed45132be91 /README.mga.md
parent33193de3c84f52917ba5c340591cc2d97dc42ebb (diff)
downloadforums-7bbd3c1a68513bf5a560a5ed6da60715dd54d19a.tar
forums-7bbd3c1a68513bf5a560a5ed6da60715dd54d19a.tar.gz
forums-7bbd3c1a68513bf5a560a5ed6da60715dd54d19a.tar.bz2
forums-7bbd3c1a68513bf5a560a5ed6da60715dd54d19a.tar.xz
forums-7bbd3c1a68513bf5a560a5ed6da60715dd54d19a.zip
Add some Mageia instructions on how to do the updates.
Diffstat (limited to 'README.mga.md')
-rw-r--r--README.mga.md71
1 files changed, 71 insertions, 0 deletions
diff --git a/README.mga.md b/README.mga.md
new file mode 100644
index 0000000000..4482eba580
--- /dev/null
+++ b/README.mga.md
@@ -0,0 +1,71 @@
+## Mageia Update Instructions
+
+phpBB is a free bulletin board written in PHP. Mageia use this to power their [forums](https://forums.mageia.org/).
+
+## Updating Code
+
+To be completed by MaĆ¢t.
+
+## Testing
+
+1. Create a backup database of one of the forums (pick your preferred language - using "en" here)
+
+ [root@alamut ~]# psql -U postgres
+ psql (9.0.13)
+ Type "help" for help.
+ .
+ postgres=# CREATE DATABASE phpbb_xx WITH TEMPLATE phpbb_en OWNER phpbb;
+
+2. Copy the current forum folder on the webserver (note the folder has to be two letters)
+
+ [root@alamut ~]# ssh friteuse
+ [root@friteuse ~]# cd /var/www/forums/
+ [root@friteuse forums]# cp -a en xx
+
+3. Edit the copies db config and point it at the new db you just created
+
+ [root@friteuse forums]# vi xx/phpBB/config.php
+
+4. Test the "new" [forum](https://forums.mageia.org/xx/) to make sure it works as current.
+
+5. Update the code to what is in git. First we have to restore the "install" folder which is removed for security.
+
+ [root@friteuse forums]# cd xx/
+ [root@friteuse xx]# git checkout -- phpBB/install
+ [root@friteuse xx]# git pull
+
+6. The forum shold be disabled automatically. You can login and perform the upgrade.
+
+7. When done, delete the "install" folder.
+
+ [root@friteuse xx]# rm -rf phpBB/install
+
+8. Now test the forum as normal and make sure the upgrade has worked!
+
+## Deployment
+
+Mostly the same as above. As space is limited we should tidy up first.
+
+1. Delete our test schema.
+
+ [root@alamut ~]# psql -U postgres
+ psql (9.0.13)
+ Type "help" for help.
+ .
+ postgres=# DROP DATABASE phpbb_xx;
+
+2. Make a database dump file as a backup.
+
+ [root@alamut ~]# pg_dump -U postgres phpbb_en | xz >forums_dump/forum_en-20131202.sql.xz
+
+3. Trash the test folder
+
+ [root@alamut ~]# ssh friteuse
+ [root@friteuse ~]# cd /var/www/forums/
+ [root@friteuse forums]# rm -rf xx
+
+4. Copy the forum files "just in case"
+
+ [root@friteuse forums]# cp -a en en-bak
+
+5. Perform steps 5 onwards as per the testing section above.