This software is known to work on GNU/Debian 6.0 (squeeze).
It has been tested on architectures i386 and amd64.

= Required packages
===================
libgps-dev, postgresql, python (>= 2.5), python-serial, python-rrdtool, python-psycopg2, python-cracklib, libjs-jquery, apache2, libapache2-mod-python, python-django, xz-utils, python-daemon, ntp

libgps-dev postgresql python-serial python-rrdtool python-psycopg2 python-cracklib libjs-jquery apache2 libapache2-mod-python python-django xz-utils python-daemon ntp

python-decoratedstr (from nirgal.com)
python-htmlentities (from nirgal.com)


= File system setup
===================
addgroup ais
mkdir --mode 2775 /var/lib/ais # mode g+ws
chown :ais /var/lib/ais
mkdir --mode 2775 /var/lib/ais/db
mkdir --mode 2775 /var/lib/ais/db/bydate
mkdir --mode 2775 /var/lib/ais/db/last
mkdir --mode 2775 /var/lib/ais/stats/
mkdir --mode 2775 /var/lib/ais/nmea/
mkdir --mode 2775 /var/lib/ais/areas/
mkdir --mode 2775 /var/lib/ais/cron/
mkdir --mode 2775 /var/lib/ais/cron/fleets/
mkdir --mode 2775 /var/lib/ais/jobs/
mkdir --mode 2775 /etc/ais
chown :ais /etc/ais
mkdir --mode 2775 /var/log/ais
chown :ais /var/log/ais
mkdir --mode 2775 /var/run/ais/
chown :ais /var/run/ais

= Postgres setup
================
createuser --no-superuser --no-createdb --no-createrole ais
psql -c '\password ais'
createdb ais -O ais
psql ais -h localhost -U ais -f structure.sql

= Config
========
create your file in /etc/ais/config
chmod 660 /etc/ais/config
see etc/config.SAMPLE

create your file in /etc/ais/database
chmod 660 /etc/ais/database
see etc/database.SAMPLE

= Python module setup
=====================
ln -s /home/nirgal/kod/ais/bin /usr/lib/python2.6/ais
OR
sudo deploy.sh
OR
ln -s /home/nirgal/kod/ais/bin /usr/share/pyshared/ais
find /usr/share/pyshared/ais/ -name *.py > /usr/share/python-support/ais.public
update-python-modules /usr/share/python-support/ais.public

= Kernel tuning
===============

I suggest you add these lines to your /etc/sysctl.conf file:

# for postgres: a process may use up to 768MB of RAM
kernel.shmmax=805306368
# Udp recv queue max size. Note this is not the max size a default socket will
get. 256*1024-1 => doubled by kernel = 512KB
net.core.rmem_max=262143

= Autostart
===========
ln -s /home/nirgal/kod/ais/etc/init.sh /etc/init.d/ais
update-rc.d ais defaults

= Apache setup
==============
adduser www-data ais

change apache umask in /etc/apache2/envvars from 022 to 002 so that new folders are group writables. If there is no such line, just add "umask 002" at the end of the file.

a2enmod ssl headers rewrite

= Real time acquisition
=======================
umask 002
python -m ais.inputs.run --db --background

= Job queue runner
==================
umask 002
python -m ais.jobrunner --daemon