README.md 1.82 KB
Newer Older
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
# Archweb README

To get a pretty version of this document, run

    $ markdown README > README.html

# License

See LICENSE file.

# Authors

See AUTHORS file.

# Dependencies

- python2
- python2-virtualenv

# Python dependencies

More detail in `requirements.txt` and `requirements_prod.txt`; it is best to
use virtualenv and pip to handle these. But if you insist on (Arch Linux)
packages, you will probably want the following:

- django
- python2-psycopg2
- python2-markdown
- python2-memcached

# Testing Installation

1. Run `virtualenv2`.

35
        cd /path/to/archweb && virtualenv2 ./env/
36
37
38

2. Activate the virtualenv.

39
        source ./env/bin/activate
40
41
42

2. Install dependencies through `pip`.

43
        pip install -r requirements.txt
44
45
46
47
48
49
50

3. Copy `local_settings.py.example` to `local_settings.py` and modify.
   Make sure to uncomment the appropriate database section (either sqlite or
   PostgreSQL).

4. Sync the database to create it.

51
        ./manage.py syncdb
52
53
54

5. Migrate changes.

55
        ./manage.py migrate
56
57
58
59

6. Load the fixtures to prepopulate some data. If you don't want some of the
   provided data, adjust the file glob accordingly.

60
61
62
63
        ./manage.py loaddata main/fixtures/*.json
        ./manage.py loaddata devel/fixtures/*.json
        ./manage.py loaddata mirrors/fixtures/*.json
        ./manage.py loaddata releng/fixtures/*.json
64
65
66

7. Use the following commands to start a service instance

67
        ./manage.py runserver
68
69
70

8. To optionally populate the database with real data:

71
        wget http://mirrors.kernel.org/archlinux/core/os/i686/core.db.tar.gz
72
73
        ./manage.py reporead i686 core.db.tar.gz
        ./manage.py syncisos
74
75
76
77
78
79
80
81
82

Alter architecture and repo to get x86\_64 and packages from other repos if
needed.

# Production Installation

Ask someone who knows, or you are going to be in trouble.

vim: set syntax=markdown et: