summaryrefslogtreecommitdiff
path: root/README.rst
blob: c586d643bc036b939136aafa664e354a63ea8d9d (plain)
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
=================================
Radio Helsinki Program Management
=================================

Installation
============

To get setup you must have the following installed:

 * MySQL-Client Development libraries 
 * JPEG library development files
 * Python 2.7 including Development files
 * virtualenv 1.11

In Debian or Ubuntu (or derivatives) you should be able to achieve this with this command:

    $ sudo apt-get install libmysqlclient-dev libjpeg-dev python2.7-dev virtualenv


Setting up the environment
--------------------------

Create a virtual environment where the dependencies will live::

    $ virtualenv -p python2.7 python
    $ source python/bin/activate
    (python)$

Change into the base directory of this software and install the project dependencies::

    (python)$ pip install -r requirements.txt


Setting up the database
-----------------------

By default the project is set up to run on a SQLite database.  

Create a file pv/local_settings.py and add at least the line 

    SECRET_KEY = 'secret key'

(obviously replacing "secret key" with a key of you choice).

Then run::

    (python)$ python manage.py migrate
    (python)$ python manage.py loaddata program/fixtures/*.yaml


Adding an admin user
--------------------

In order to create an admin user (which you will need to login to the webinterface after the next step) run::

    (python)$ python manage.py createsuperuser


Running a web server
--------------------

In development you should run::

    (python)$ python manage.py runserver

After this you can open http://127.0.0.1:8000/admin in your browser and log in with the admin credential you created previously.