Installasjonsrutine for NAV på Debian GNU/Linux (sarge)
=========================================================

Pakker fra Debians offisielle arkiver
-------------------------------------

apt-get install ant autoconf build-essential patch \
  libwww-perl libtimedate-perl libdigest-hmac-perl \
  libdigest-sha1-perl snmp libnet-snmp-perl libmd5-perl \
  postgresql postgresql-dev libdbd-pg-perl libpgjava libpg-perl \
  python python-dev python-egenix-mxdatetime \
  libsasl-dev libsnmp-session-perl libcrypt-des-perl \
  rrdtool cricket \
  apache libapache-mod-python libapache-mod-ssl php4 \
  python-psycopg python-cheetah python-rrd

Pakker fra uoffisielle Debian-arkiver
-------------------------------------

 - forgetHTML, forgetSQL; legg følgende i /etc/apt/sources.list:
    deb http://skolelinux.no/~werner/debian unstable local
   og kjør
    apt-get update && apt-get install python-forgethtml python-forgetsql
 - Gammu; legg følgende i /etc/apt/sources.list:
    deb http://www.cihar.com/debian/ ./
   og kjør
    apt-get update && apt-get install gammu

Java 1.4 SDK
------------

 - ved å bruke Blackdown sine Debianpakker, vil ikke getDeviceData
   kjøre (ukjent hvorfor), derfor bruker vi Sun's JDK:
 - legg til følgende i /etc/apt/sources.list
    deb http://z42.de debian/
   og kjør
    apt-get update
 - hent ned binærutgaven av Sun's SDK
    http://java.sun.com/j2se/1.4.2/download.html (J2SE SDK)
    (j2sdk-1_4_2_05-linux-i586.bin)
   lagre i /tmp
 - kjør kommandoen
    apt-get install j2se-package
 - lag Debian-pakke av j2sdk-fila
    j2se-package j2sdk-1_4_2_05-linux-i586.bin
 - installer Debian-pakken fra forrige punkt
    dpkg -i sun-j2sdk1.4_1.4.2+05_i386.deb
 - installer Debian-spesifikk pakke for Sun's J2SDK1.4
    apt-get install sun-j2sdk1.4debian

Pakker som må kompileres opp og installeres manuelt
---------------------------------------------------

 - PySNMP: http://pysnmp.sourceforge.net/
   pakk ut og 'python setup.py install'
 - IPY http://c0re.23.nu/c0de/IPy/
   pakk ut og 'python setup.py install'
 - Westhawk SNMP/Java: http://snmp.westhawk.co.uk/
   Kopier snmp4_13.jar fra zip-fila og plasser den i
   /usr/lib/j2sdk1.4-sun/jre/lib/ext

Tomcat 5
--------

 - tomcat4 er ikke klar bruk når nav må bygges (mangler catalina-ant.jar)
   (tomcat4 i Debian unstable har catalina-ant.jar)
 - henter ned binærfil og pakker ut i /usr/local/:
   http://www.powertech.no/apache/dist/jakarta/tomcat-5/v5.0.25/bin/jakarta-tomcat-5.0.25.tar.gz
 - lager symbolsk lenke til tomcat-katalogen i /usr/local:
   cd /usr/local; ln -s jakarta-tomcat-5.0.25 jakarta-tomcat
 - linker til catalina-ant.jar i Ant's libdir:
    ln -s /usr/local/jakarta-tomcat/server/lib/catalina-ant.jar /usr/share/ant/lib/
 - Legger dette inn i /etc/environment
   JAVA_HOME=/usr/lib/j2sdk1.4-sun

Konfigurasjon av PostgreSQL
---------------------------

 - Setter følgende i /etc/postgres/postgresql.conf:
   shared_buffers = 1024
   max_fsm_relations = 2000
   max_fsm_pages = 500000
   max_locks_per_transaction = 512
   wal_buffers = 128
 - Forandrer disse linjene i /etc/postgres/pg_hba.conf til å bruke md5:
   local   all         all                                             md5
   host    all         all         127.0.0.1         255.255.255.255   md5
   host    all         all         ::1               ffff:ffff:ffff:ffff:ffff:ffff:ffff:ffff        md5
   host    all         all         ::ffff:127.0.0.1/128                md5
 - Restartet PostgreSQL:
   /etc/init.d/postgresql restart
 - Kjører følgende:
   su - postgres
   createuser --createdb --adduser --pwprompt manage
   exit
   createdb -U manage --encoding UTF-8 manage
   createdb -U manage --encoding UTF-8 navprofiles
   createdb -U manage --encoding UTF-8 navlog
   su - postgres
   createlang plpgsql manage
   createlang plpgsql navprofiles
   createuser navread
   createuser navwrite
   cd /usr/src/nav-<versjon>/doc/sql
   psql -f manage.sql manage
   psql -f navprofiles.sql navprofiles
   psql -f navlog.sql navlog
   psql -f snmpoid.sql manage
   psql: "alter user navread with password '<passord>';"
         "alter user navwrite with password '<passord2>';"
   exit

Legge til brukere
-----------------

Kjør kommandoene:
 addgroup --system nav
 addgroup --system navroot
 adduser --system --home /usr/local/nav --shell /bin/bash --ingroup nav navcron
 adduser navcron navroot
 adduser navcron dialout # for å få skrivetilgang til /dev/ttyS*

NAV-modifikasjoner til cricket
------------------------------

(Ikke gjort noe her foreløpig... på tide at nav-dev sender patcher upstream?)

Bygge og installere NAV
-----------------------

 - editer src/webapps/navAdmin/build.xml
   forandre variabelen catalina.home til riktig path:
   /usr/local/jakarta-tomcat
 - editer src/webapps/vPServer/build.xml
   forandre variabelen catalina.home til riktig path:
   /usr/local/jakarta-tomcat
 - Pakker ut tar-ballen i /usr/src og starter byggingen:
   #legg til 'crondir = ${prefix}/cron' øverst i Makefile
   ./configure
   make
   make install
 - chown -R navcron.root /usr/local/nav/var/log
 - cp /usr/local/nav/apache/webapps/*.war /usr/local/jakarta-tomcat/webapps/

Oppsett av miljø
----------------

 - cd /usr/lib/python2.3; ln -s /usr/local/nav/lib/python/nav
   ln -s /usr/local/nav/lib/python/rotater.py
 - cd /usr/lib/perl/5.8.3/;
   for file in `ls /usr/local/nav/lib/perl/`; do
       ln -s /usr/local/nav/lib/perl/$file
   done
 - cd /usr/lib/j2se/; rmdir ext; ln -s /usr/share/java ext; cd ext;
   for file in `find /usr/local/nav/lib/java/* -path '*.jar*'`; do
       ln -s $file
   done