Skip to content

Latest commit

 

History

History
55 lines (40 loc) · 2.27 KB

INSTALL.manually.md

File metadata and controls

55 lines (40 loc) · 2.27 KB
Raw

Manual Installation

Linux is currently the only supported development platform. Theoretically this codebase should work on other platforms, but this has not been tested.

Here's what you need installed before you can run this:

  • Python >= 3.3 (with source headers)
  • Postgresql 9.0 or later

Let's start by getting all of the Python dependencies installed. We'll clone the repo, make a virtualenv, install distribute, and then install all of our Python dependencies:

$ git clone https://github.com/magfest/ubersystem  # or your fork
$ cd magfest
$ python3.3 -m venv env
$ ./env/bin/python distribute_setup.py
$ ./env/bin/python setup.py develop

Now we need to create a Postgresql database. The default username, password, and database name is "m13", so we'll go ahead and do that, e.g.

$ sudo -i
$ sudo -i -u postgres
$ createuser --superuser --pwprompt m13
$ createdb --owner=m13 m13

Now we're ready to create all of our database tables, which we can do by running the init_db script. After that we can actually start the server:

$ ./env/bin/python uber/init_db.py
$ ./env/bin/python uber/run_server.py

Now we can go to http://localhost:4321/ and log in with the email address "magfest@example.com" and the password "magfest".

If you'd live to override any of the default configuration settings, you can create a "development.conf" file in the top-level directory of the repo, and any values you put there will override the default values. For example, suppose we were running remotely on a cloud server like Rackspace, so instead of binding to localhost, we'd instead bind to our local IP address and tell the web server to issue its redirects appropriately, e.g.

hostname = "12.34.56.78"
url_root = "http://12.34.56.78:4321"

If you'd like to insert about 10,000 attendees with realistic shifts and whatnot, you can run the following command (warning, this takes 5-10 minutes to insert everything):

$ ./env/bin/python uber/tests/import_test_data.py

Alternatively, you could insert directly with the sql file in the same directory as that script (though you'll need to start with an empty database for this to work), e.g.

$ psql --host=localhost --username=m13 --password m13 < uber/tests/test_data.sql