BUILD.txt

   1 Bygging
   2 =======
   3
   4 Ant
   5 ---
   6
   7 Bygging skjer vha. ant. For vellykket bygging trenger man:
   8
   9 1. Ant. På RHEL5 får man dette via RPM-pakken 'ant'.
  10
  11 2. Junit "tasks" for ant. På RHEL5 får man dette via RPM-pakken  'ant-junit'.
  12
  13 Man lager war-fil ved å bruke kommandoen 'ant'.
  14
  15 NB: Filen som lages *må* hete 'ws.war'! Resteasy bruker stammen i
  16 filnavnet, 'ws', som en del av URI'ene, slik at man får URI'er
  17 på formen: http://<servernavn>/ws/...
  18
  19
  20 Man kan kan kjøre tester vha. kommandoen 'ant test'.  Rapporter fra
  21 JUnit havner i underkatalogen 'reports/junit'.
  22
  23 Dekningsrapporter kan lages vha. kommandoen 'ant coverage'. Rapportene
  24 finner man i underkatalogen 'reports/cobertura'.
  25
  26 Dokumentasjon i javadoc-format kan genereres vha. kommandoen 'ant
  27 javadoc'. Resultatet legges i underkatalogen 'docs'.
  28
  29
  30 Installasjon
  31 ------------
  32
  33 For testing på utviklingsmaskin kan man bruke ant til å automatisk
  34 kopiere war-filen til riktig sted vha. kommandoen 'ant deploy'. Dette
  35 forutsetter at man lager en fil i samme katalog som build.xml som må
  36 hete 'jboss.properties' og som skal definere en ant-variabel kalt
  37 'deploy.dir'. Eksempel (path'en vil avhenge av hvor man har installert
  38 JBoss):
  39
  40 deploy.dir = /opt/jboss/server/default/deploy
  41
  42
  43
  44 Installasjon og kjøring
  45 =======================
  46
  47 JBoss
  48 -----
  49
  50 Koden er skrevet for å kjøre på JBoss 5.  Denne kan hentes fra:
  51 http://www.jboss.org/jbossas/downloads/
  52
  53 I skrivende stund er 5.1.0.GA siste stable release og den vi
  54 utvikler mot.
  55
  56 War filen vi bygger virker ikke på JBoss 4.  Ikke bruk JBoss 4.
  57
  58 Hvis du skal kunne deploye i jboss fra maven som vanlig bruker må du
  59 fikse permissions. Om det er på din egen arbeidsstasjon og bare du
  60 skal bruke jboss installasjonen kan du f.eks.:
  61
  62   chmod -R bruker:usit /opt/jboss-5.1.0.GA
  63
  64 JBoss kan startes med f.eks.:
  65
  66   /opt/jboss-5.1.0.GA/bin/run.sh
  67
  68 Evt. kan config spesifiseres med -c opsjonen hvis man ikke bruker
  69 "default" config.
  70
  71
  72 Database
  73 --------
  74
  75 Man trenger Oracles JDBC-driver i Cristin-ws. Man må lage en
  76 konfigurasjonsfil for å få tak i en databasekobling under
  77 kjøring. Dette er laget slik for at de som installerer i
  78 produksjonsmiljøet kan legge inn riktig skjema ("brukåernavn") og
  79 passord for produksjonsdatabasen.
  80
  81 Konfigurasjonsfilen skal hete 'ws-ds.xml' og må ligge i
  82 underkatalogen 'server/default/deploy/' der JBoss er installert.
  83
  84 En eksempelfil finnes i svn-repository der passordet ikke er fyllt
  85 ut. IKKE COMMIT filer med gyldige passord i svn!! Kopier i stedet
  86 eksempelfilen inn i JBoss deploy-mappen og legge inn riktig passord der.
  87
  88 Merkelig nok vil første forsøk på å bruke databasen feile
  89 ("Apparently wrong driver class specified") men deretter fungere
  90 hvis man bruker JDBC driver fra .war filen.  Legg derfor en OJDBC
  91 driver f.eks. her:
  92
  93   /opt/jboss-5.1.0.GA/server/default/lib/ojdbc5-11.1.0.6.0.jar
  94
  95 Da fungerer også applikasjonens første forsøk på databasetilgang.
  96
  97