Page History
| Navitabs | ||||||
|---|---|---|---|---|---|---|
| ||||||
| Table of Contents |
|---|
1 Formål
Nærværende dokument er en guide til nye udviklere af stamdataservicen på NSP. Guiden gennemgår på overordnet plan de aktiviteter, der er nødvendige for at kunne videreudvikle stamdataservicen.
...
Dokumentet forudsætter, at læseren har grundig kendskab til Java udvikling, webservices, Maven samt Docker-compose. Kendskab til JBoss Wildfly applikationsserver vil yderligere hjælpe læseren, men er ikke en forudsætning.
...
Den primære målgruppe for dokumentet er systemudviklere.
| Table of Contents |
|---|
2 System design
Hver NSP komponent er designet som en Servlet 2.4 web-applikation og benytter Guice til dependency injection.
...
Stamdataservicen benytter Seal.java til håndtering af forespørgsler og svar i webservice snitfladen.
Seal.java bygger i nuværende version (2.5.x) på commons-logging, hvilket konflikter med JBoss AS6. I pom.xml filerne er commons-logging derfor fjernet, og erstattet med en slf4j commons-logging proxy.
Derudover er XercesImpl også fjernet, da den på tilsvarende måde konflikter med JBoss AS6Wildfly[1].
Properties
Stamdataservicen benytter Guice til konfigurationsstyring. Konfiguration styres via filen config.properties, der pakkes sammen med WAR-filen.
...
- Java Developer Kit (JDK 8)
- Et passende udviklingsmiljø
- Maven 3.x
- Docker 18.x (testet med 18.09.7)JBoss AS6
Kildekode
Kildekoden er placeret i SVN:
...
Obs! Denne metode kræver dog, at kommandoen udføres hver gang man ændrer i pom filerne.
Distribution
Stamdataservicen kan bygges til distribution eller lokal test ved at udføre:
...
Dette generer en række WAR filer, der efterfølgende kan deployeres lokalt eller i produktion.
Kodeord til serverne og databaserne skal indhentes hos NSP-operatøren.
Tips og tricks
I de følgende beskrives problemer og deres løsninger:
JBoss out of memory
Beskrivelse
I JBoss’s boot.log:
...
$JBOSS_HOME/server/default/log/boot.log
Logger JBoss noget i stil med ”out of memory” og nævner “permgenspace”
Løsning
Forøg JBoss permgen space ved at ændre linien indeholdende:
...
JAVA_OPTS="-Xms2048m -Xmx2048m -XX:MaxPermSize=256m -Dorg.jboss.resolver.warning=true -Dsun.rmi.dgc.client.gcInterval=3600000 -Dsun.rmi.dgc.server.gcInterval=3600000"
i filen
...
$JBOSS_HOME/bin/run.conf
til
...
JAVA_OPTS="-Xms2048m -Xmx2048m -XX:MaxPermSize=512m -Dorg.jboss.resolver.warning=true -Dsun.rmi.dgc.client.gcInterval=3600000 -Dsun.rmi.dgc.server.gcInterval=3600000"
JBoss kan ikke skrive til “trancsaction.log”
Beskrivelse
I JBoss’s boot.log:
...
$JBOSS_HOME/server/default/log/boot.log
Logger JBoss noget i stil med ”transaction.log” og ”cannot write”
Løsning
Ignorér denne fejl.
Ændringslog
Nyeste udgave af dette dokument kan erhverves ved henvendelse til NSP-operatøren.
...
Version
...
Dato
...
Ændring
...
Ansvarlig
...
1.0
...
28/4-2011
...
Initielt Dokument
...
Trifork
...
1.1
...
6/10-2011
...
Opdateret med CPR tjenester
...
Trifork
...
1.2
...
8/12-2011
...
Kvalitetssikret af Lakeside
...
Lakeside
...
1.3
...
22/12-2011
...
Opdateret bla. med performance test af autorisationsservicen og kopi-register-servicen
...
Trifork
...
1.4
...
14/5-2013
...
Opdateret afsnit omkring oprettelse af database
...
Trifork
Mavens release plugin anvendes til at lave releases:
mvn org.apache.maven.plugins:maven-release-plugin:2.5.3:prepare
...
8 Referencer og kilder
Reference-id | Indhold / Overskrift | Henvisning | |||
[MAVEN] | Welcome to Apache Maven | [NIAB] | NSP in a box | Kan rekvireres ved henvendelse til operatøren inklusiv vejledning i anvendelse og konfiguration. | |
[BRS-guide til anvendere] | Guide til anvendere | Ligger i doc bibliotek i en BRS release | |||
[BRS-driftvejledning] | Driftvejledning | Ligger i doc bibliotek i en BRS release |
...