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