About

!DANGER!

Beware killer rabbits! And don't use this in anything remotly related to a production or public deployment!!!

This is a vagrant configuration to build a development VM for the GC site/ABC. It contains:

• A LAMP stack
• PhpBB 3.0.12
• Django 1.7 (b2)
• Not much else yet

Requirements

1. Have VirtualBox installed
2. Have Vagrant installed

Installation

• Clone this repository.

• Clone the gcabc_ Repository into ./src/gcabc

• Change to the repository root and run:

  vagrant up
  

  vagrant up will do the following things:

  • Download a Ubuntu 14.04 vagrant image from ubuntu.com and set up a VM.
  • Add port forwarding from the client to the host so you can access phpBB and abc from http://localhost:10080 on the host.
  • Provision the VM with the Software above, especially: * Add a MySQL database for phpBB/ABC. * Install phpBB. * Import the Tables/Data of a new phpBB installation. * Configure Apache to serve phpBB and pass through django.

Customizations

The mysql database on the client is initalized with the data from a newly installed phpbb (3.1.3 at the time of writing). If you want to use different data you can replace the file files/phpbb_initial_data.sql with a mysql dump of your choice before you build the box the first time.

If you want to replace the data later you can replace the file phpbb_initial_data.sql and run ./bin/db_drop_and_load_initial_phpbb3_db.sh.

Usernames/Passwords

• systems user/password: vagrant (default of the VM image)
• mysql db/user/password: phpbb (configure in manifests/site.pp and used in `files/*config.php)
• phpbb admin user/password: admin/password (part of ` phpbb_initial_data.sql`)

Available Web services / local paths

We configure an apache virtual host on the guest that serves phpBB like described in it's README, and django trough a ProxyPass rule for the urls /djangoadmin and /abc.

• phpBB http://localhost:80 (inside the VM), forwarded to http://localhost:10080 (host) guest path: /var/www/html served by apache, started: automatically configured by vagrant/puppet it probably won't work inside the guest because of the port configured to 10080.

• gcabc (Prototype to implement ABC in django) http://localhost:80/abc + http://localhost:80/djangoadmin (guest), forwarded to http://localhost:10080/abc + http://localhost:10080/djangoadmin (host)

  guest path:

  • python environment: /home/vagrant/gcdjango
  • django application: /vagrant/projects/gcabc

  Needs to be started manually from the host with:

  ./bin/django_runserver
  

  You can get a django shell with…:

  ./bin/django_manage shell
  

  …and run the tests of abcapp with:

  ./bin/django_manage test abcapp
  

  Before it is usable you have to run the migrations on the host which is not done automatically.

  ./bin/django_manage migrate abcapp

  If you don't start the django server you'll get a bad gateway error for /abc and /djangoadmin