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