Page History
...
| Info |
|---|
Alle filer der refereres til ligger sammen med projektets kildekode i NSP's Subversion. Referencer til stier er relative med udgangspunkt i projektets rodmappe. |
Ændringslog
Version | Dato | Ændring | Ansvarlig |
|---|---|---|---|
1.0.1 | 2018-08-20 | Initialt dokument | Trifork |
| 1.0.2 | 2018-08-31 | Ny release | Trifork |
| 1.0.3 | 2018-09-11 | Ændret databasedriver til MySQL | Trifork |
| 1.0.11 | 2019-08-16 | Opdateret default value for property "minlog.read-activity-text". | Trifork |
Byggevejledning
For at bygge projektet og dets deployables (war-filer) uden at køre unit-tests og integrationstests, anvendes følgende Maven kommando:
...
Det drejer sig om denne property, som også er beskrevet i tabellen længere nede:
| Property |
|---|
| jobs.delete.enabled |
Krav til operativsystem
Der stilles ingen krav til operativsystemet udover Java-understøttelse. Ubuntu Linux bruges som operativsystem på NSP’en, men udviklingen af servicen er foretaget på Windows 10 og denne platform kan ligeledes afvikle servicen.
...
Properties er her opdelt i to tabeller. Den første tabel indeholder anvendte Spring Boot-properties. Den anden tabel indeholder properties, der er specifikt defineret til brug i servicen. Begge typer af properties er defineret i samme konfigurationsfil.
Spring Boot-properties
| Property | Beskrivelse | Default |
|---|---|---|
| spring.active.profiles | Aktiv profil i Spring Boot. Skal ikke ændres. Anvendes til at styre forskellige databasekonfigurationer ved henholdsvis unit-tests og deployment. | production |
| spring.application.name | Navnet på applikationen. Skal ikke ændres. | odr |
| spring.jmx.enabled | Disable Spring Boot JMX. Skal ikke ændres. Deaktiveret da vi ikke udstiller særlig JMX funktionalitet. | false |
| spring.jta.enabled | JTA transaktioner. Det er påkrævet at denne er false, således at Spring Boot i stedet anvender dens egen håndtering af transaktioner. (true/false) | false |
| management.server.port | Port som Spring Boot management endpoints bind'er på. Endpoints deaktiveres ved at sættes værdien til -1. | -1 |
Komponentspecifikke-properties
| Property | Beskrivelse | Default |
|---|---|---|
| datasource.odr.jndi-name | Angiver navnet på en JNDI datasource til Organdonorregister-databasen | java:jboss/datasources/ODR-DS |
| datasource.stamdata.jndi-name | Angiver navnet på den JNDI datasource der giver adgang til en (replikeret) stamdata-database | java:jboss/datasources/STM-DS |
| dcc.endpoint | Angiver det endpoint, som DCC'en skal kalde. Dette kommer til at fremgå af den XML, der returneres i /dksconfig. Bør ændres før produktion. | http://test1.fsk.netic.dk:8080/odr/odr |
| minlog.read-activity-text | Angiver den tekst der registreres i MinLog, når der bliver læst Organdonorregistering-data for et CPR-nummer |
| L\u00e6sning af Organdonorregistrering | ||
| schemavalidation.validate-requests | Angiver om requests skal schema-valideres (true/false) | true |
| schemavalidation.validate-responses | Angiver om responses skal schema-valideres (true/false) | true |
| schemavalidation.fail-on-response-error | Angiver om en kald skal returnere fejl, hvis response ikke er schema-valid (true/false) | true |
| forward-only-filter.enabled | Angiver om servicen kun skal kunne tilgås igennem DGWS/IDWS Proxyen (wsproxy komponenten). Bør altid være sat til true. (true/false) | true |
| jobs.delete.enabled | Slettejob: Angiver om det schedulerede slettejob skal være aktiveret (true/false) | true |
| jobs.delete.schedule | Slettejob: Angiver schedulering-pattern for slettejobet | 0 0 12 * * ? |
| jobs.delete.cpr-max-results | Slettejob: Angiver maksimum antal rækker med opdateringer i cpr-registry der skal læses ad gangen | 1000 |
| jobs.delete.cpr-max-loops | Slettejob: Angiver maksimum antal batches der skal behandles pr. jobeksekvering | 1000 |
log4j2.xml
Konfigurerer logning for servicen.
...
application.properties
Spring Boot-properties
| Property | Beskrivelse | Default |
|---|---|---|
| spring.application.name | Navnet på applikationen | odr-migration |
| spring.jmx.enabled | Disable Spring Boot JMX. Skal ikke ændres. Deaktiveret da vi ikke udstiller særlig JMX funktionalitet. | false |
| spring.jta.enabled | JTA transaktioner. Det er påkrævet at denne er false, således at Spring Boot i stedet anvender dens egen håndtering af transaktioner. (true/false) | false |
| management.server.address | Netværksadresse som management endpoints bliver bind'et på. Når der ikke defineret anden autentifikation skal den af hensyn til sikkerhed kun bind'e på 127.0.0.1. | 127.0.0.1 |
| spring.datasource.jndi-name | Angiver navnet på den primære JNDI datasource | java:jboss/datasources/ODR-DS |
migration.personFileName | Angiver navnet på csv filen for persondata | PersonData.csv |
migration.organDonorFileName | Angiver navnet på csv filen for organdonordata | OrganDonorData.csv |
log4j2.xml
Konfigurerer logning for migreringskomponenten.
...
Komponenter, der skal deployes til Wildfly, kopieres til mappen <wildfly-root>/standalone/deployments.
Filnavn når deployet | Beskrivelse | Kilde |
|---|---|---|
odr-service-wildfly.war | ODR servicen | odr-service-wildfly-<version>.war |
odr.war | DGWS/IDWS Proxy . Se Installationsvejledning (DGWS/IDWS Proxy) for dokumentation. War-filen for wsproxy komponenten omdøbes til odr.war, hvilket bevirker at webservice context-path for wsproxy i dette tilfælde bliver /odr. | wsproxy-<version>.war (findes ikke i odr-projektet) |
| odr-migration.war | ODR migeringsværktøj. Deployes kun når migrering skal foretages. | odr-migration-<version>.war |
Se driftsvejledningen for yderligere information.
...