Bygging
=======

Ant
---

Bygging skjer vha. ant. For vellykket bygging trenger man:

1. Ant. På RHEL5 får man dette via RPM-pakken 'ant'.

2. Junit "tasks" for ant. På RHEL5 får man dette via RPM-pakken  'ant-junit'.

Man lager war-fil ved å bruke kommandoen 'ant'.

NB: Filen som lages *må* hete 'ws.war'! Resteasy bruker stammen i
filnavnet, 'ws', som en del av URI'ene, slik at man får URI'er
på formen: http://<servernavn>/ws/...


Man kan kan kjøre tester vha. kommandoen 'ant test'.  Rapporter fra
JUnit havner i underkatalogen 'reports/junit'.

Dekningsrapporter kan lages vha. kommandoen 'ant coverage'. Rapportene
finner man i underkatalogen 'reports/cobertura'.

Dokumentasjon i javadoc-format kan genereres vha. kommandoen 'ant
javadoc'. Resultatet legges i underkatalogen 'docs'.


Installasjon
------------

For testing på utviklingsmaskin kan man bruke ant til å automatisk
kopiere war-filen til riktig sted vha. kommandoen 'ant deploy'. Dette
forutsetter at man lager en fil i samme katalog som build.xml som må
hete 'jboss.properties' og som skal definere en ant-variabel kalt
'deploy.dir'. Eksempel (path'en vil avhenge av hvor man har installert
JBoss):

deploy.dir = /opt/jboss/server/default/deploy



Installasjon og kjøring
=======================

JBoss
-----

Koden er skrevet for å kjøre på JBoss 5.  Denne kan hentes fra:
http://www.jboss.org/jbossas/downloads/

I skrivende stund er 5.1.0.GA siste stable release og den vi
utvikler mot.

War filen vi bygger virker ikke på JBoss 4.  Ikke bruk JBoss 4.

Hvis du skal kunne deploye i jboss fra maven som vanlig bruker må du
fikse permissions. Om det er på din egen arbeidsstasjon og bare du
skal bruke jboss installasjonen kan du f.eks.:

  chmod -R bruker:usit /opt/jboss-5.1.0.GA

JBoss kan startes med f.eks.:

  /opt/jboss-5.1.0.GA/bin/run.sh

Evt. kan config spesifiseres med -c opsjonen hvis man ikke bruker
"default" config.


Database
--------

Man trenger Oracles JDBC-driver i Cristin-ws. Man må lage en
konfigurasjonsfil for å få tak i en databasekobling under
kjøring. Dette er laget slik for at de som installerer i
produksjonsmiljøet kan legge inn riktig skjema ("brukåernavn") og
passord for produksjonsdatabasen.

Konfigurasjonsfilen skal hete 'ws-ds.xml' og må ligge i
underkatalogen 'server/default/deploy/' der JBoss er installert.

En eksempelfil finnes i svn-repository der passordet ikke er fyllt
ut. IKKE COMMIT filer med gyldige passord i svn!! Kopier i stedet
eksempelfilen inn i JBoss deploy-mappen og legge inn riktig passord der.

Merkelig nok vil første forsøk på å bruke databasen feile
("Apparently wrong driver class specified") men deretter fungere
hvis man bruker JDBC driver fra .war filen.  Legg derfor en OJDBC
driver f.eks. her:

  /opt/jboss-5.1.0.GA/server/default/lib/ojdbc5-11.1.0.6.0.jar

Da fungerer også applikasjonens første forsøk på databasetilgang.