Added archive_date for jobs.
[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 /etc/ais/
36 mkdir --mode 2775 /var/log/ais
37 chown :ais /var/log/ais
38
39 = Postgres setup
40 ================
41 createuser ais
42 ALTER USER ais PASSWORD '...';
43 modify user
44 createdb ais -O ais
45 psql ais -h localhost -U ais -f structure.sql
46
47 = Config
48 ========
49 create your file in /etc/ais/config
50 chmod 660 /etc/ais/config
51 see etc/config.SAMPLE
52
53 create your file in /etc/ais/database
54 chmod 660 /etc/ais/database
55 see etc/database.SAMPLE
56
57 = Python module setup
58 =====================
59 sudo deploy.sh
60 OR
61 ln -s /home/nirgal/kod/ais/bin /usr/lib/python2.5/ais
62 OR
63 ln -s /home/nirgal/kod/ais/bin /usr/share/pyshared/ais
64 find /usr/share/pyshared/ais/ -name *.py > /usr/share/python-support/ais.public
65 update-python-modules /usr/share/python-support/ais.public
66
67 = Real time acquisition
68 =======================
69 umask 002
70 python -m ais.inputs.run --db --background
71
72 = Apache setup
73 ==============
74 adduser www-data ais
75
76 change apache umask in /etc/apache2/envvars from 022 to 002 so that new folders are group writables
77