Updated INSTALL doc for jobrunner daemon
[ais.git] / INSTALL
1 This software is known to work on GNU/Debian 'lenny' and 'squeeze'.
2 It has been tested on architectures i386 and amd64.
3
4 = Required packages
5 ===================
6 libgps-dev
7 postgresql
8 python (>= 2.5)
9 python-serial
10 python-rrdtool
11 python-psycopg2
12 python-cracklib
13 libjs-jquery
14
15
16 =Recommanded packages
17 ===================
18 ntp
19 python-daemon
20
21
22 = File system setup
23 ===================
24 addgroup ais
25 mkdir --mode 2775 /var/lib/ais # mode g+ws
26 chown :ais /var/lib/ais
27 mkdir --mode 2775 /var/lib/ais/db
28 mkdir --mode 2775 /var/lib/ais/db/bydate
29 mkdir --mode 2775 /var/lib/ais/db/last
30 mkdir --mode 2775 /var/lib/ais/stats/
31 mkdir --mode 2775 /var/lib/ais/nmea/
32 mkdir --mode 2775 /var/lib/ais/areas/
33 mkdir --mode 2775 /var/lib/ais/cron/
34 mkdir --mode 2775 /var/lib/ais/cron/fleets/
35 mkdir --mode 2775 /var/lib/ais/jobs/
36 mkdir /etc/ais/
37 mkdir --mode 2775 /var/log/ais
38 chown :ais /var/log/ais
39 mkdir --mode 2775 /var/run/ais/
40 chown :ais /var/run/ais
41
42 = Postgres setup
43 ================
44 createuser ais
45 ALTER USER ais PASSWORD '...';
46 modify user
47 createdb ais -O ais
48 psql ais -h localhost -U ais -f structure.sql
49
50 = Config
51 ========
52 create your file in /etc/ais/config
53 chmod 660 /etc/ais/config
54 see etc/config.SAMPLE
55
56 create your file in /etc/ais/database
57 chmod 660 /etc/ais/database
58 see etc/database.SAMPLE
59
60 = Python module setup
61 =====================
62 sudo deploy.sh
63 OR
64 ln -s /home/nirgal/kod/ais/bin /usr/lib/python2.5/ais
65 OR
66 ln -s /home/nirgal/kod/ais/bin /usr/share/pyshared/ais
67 find /usr/share/pyshared/ais/ -name *.py > /usr/share/python-support/ais.public
68 update-python-modules /usr/share/python-support/ais.public
69
70 = Real time acquisition
71 =======================
72 umask 002
73 python -m ais.inputs.run --db --background
74
75 = Job queue runner
76 ==================
77 umask 002
78 python -m ais.jobrunner --loop --daemon
79
80 = Apache setup
81 ==============
82 adduser www-data ais
83
84 change apache umask in /etc/apache2/envvars from 022 to 002 so that new folders are group writables
85