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
  86 a2enmod headers rewrite