Page History
BivWSP startes og stoppes med Docker Compose kommandoer.
| Navitabs | ||||
|---|---|---|---|---|
|
...
| Table of Contents |
|---|
Formål
Dette dokument beskriver installation og konfiguration af Behandlingsrelations-servicen (BRS).
...
Krav til applikationsservere
Komponenterne er udviklet og testet
...
i Docker ved anvendelse af et base-image for NSP platformen.
Komponenternes konfiguration er således tilpasset deployering på WildFly 8.2 applikationsservere med OpenJDK 8.
Krav til operativsystem
Der stilles ingen krav til operativsystemet udover, ud over det åbenlyse krav om at Java er understøttet på operativsystemet. Ubuntu Linux bruges som operativsystem på NSP’en, men udviklingen af komponenten er foretaget på hhv. OS X og Windows 10, og disse platforme kan ligeledes afvikle komponenterneat det skal være Linux, og docker skal være installeret.
Krav til database
Komponenten er testet mod MariaDB version 10.1.
...
Herunder beskrives opsætningen af databaserne, samt oprettelsen af tabellerne. Alle filer der refereres til kommer fra et SVN checkout. Den seneste version samt tidligere releases kan findes på på https://svn.nspop.dk/svnsrc/components/brs
Tilgang til Stamdataudstillet database
...
- compose/database/brs/database/04-create-treatmentrelationfollowup-tables.sql
- compose/database/brs/database/05-mysql-treatmentrelationfollowup-alter-tables.sql
NB: followup-databasen kan slettes, når migrering til Kafka er gennemført (se driftsvejledning for detaljer om migrering).
Oprettelse af database og tabeller i dNSP/cNSP-miljøer
...
- compose/database/brs/database/06-create-followup-tables.sql
- compose/database/brs/database/07-mysql-followup-alter-tables.sql
NB: followup-databasen kan slettes, når migrering til Kafka er gennemført (se driftsvejledning for detaljer om migrering).
Deployment
Denne sektion beskriver hvordan komponenten deployes.
...
BRS bygges med NSP's Jenkins server via følgende jobs:
- BRS_build - Bygger koden (sker automatisk ved commits)
- BRS_push_snapshot - Pusher det nyeste snapshot image til NSP Docker Registry
...
BRS leveres samtidig som et sæt af Docker Compose filer i folderen https://svn.nspop.dk/svnsrc/components/brs/trunk/compose.For release x.y.z af BivWSP findes Docker
Compose filerne i folderen https://svn.nspop.dk/svn/components/brs/tags/release-x.y.z/composeCompose folderen indeholder 5 underfoldere:
...
Konfiguration af properties
I folderen https://svn.nspop.dk/svnsrc/components/brs/trunk/compose/configuration findes følgende konfigurationsfiler:
| backend/brs-backend.dev.properties | Konfiguration af brs-backend til udviklingsbrug. |
| backend/brs-backend-log4j.xml | Logopsætning af brs-backend. |
| backend/brs-backend.properties | Konfiguration af brs-backend. |
| backend/crl.skip | Skipliste til certificate revocation tjek. |
| backend/properties/Capgemini_Sogeti_Danmark_AS_SOR_FOCES.jks | Keystore til SOR kald. |
| backend/properties/module.xml | Module-fil. |
| frontend/brs-frontend.dev.properties | Konfiguration af brs-frontend til udviklingsbrug. |
| frontend/brs-frontend-log4j.xml | Logopsætning af brs-frontend. |
| frontend/brs-frontend.properties | Konfiguration af brs-frontend. |
| frontend/crl.skip | Skipliste til certificate revocation tjek. |
| frontend/properties/Capgemini_Sogeti_Danmark_AS_SOR_FOCES.jks | Keystore til SOR kald. |
| frontend/properties/module.xml | Module-fil. |
| sores/* | Konfiguration til brug i udviklersetup. |
Filerne brs-backend.properties og brs-frontend.properties skal tilrettes til de forskellige miljøer hvorpå de installeres. Filerne indeholder en konfiguration der passer i en standalone test konfiguration. Se driftsvejledningen for en beskrivelse af indholdet af filerne.
...
Logning konfigureres i log4j-filerne nævnt ovenfor. Se driftsvejledningen for en mere detaljeret beskrivelse af hvad der logges.
Der benyttes en rolling file appender, hvor størrelsen af log filerne og antallet af gemte log filer konfigureres med de to environment variable: LOG_MAX_FILE_SIZE og LOG_MAX_BACKUP_INDEX.
Deployment af komponenter
...
| Komponent | Komponent(er) | Beskrivelse | |||
|---|---|---|---|---|---|
| brs-backend | replicationservice | Opsamling af behandlingsrelationer til opfølgning fra frontend. | followupservlet | followupjob | Kontrol af opfølgninger til sletning eller oprettelse af alarm-notifikationer. |
| Cleanupjob | Sletning af gamle notifikationer. | ||||
| brs-frontend | behandlingsrelationsservice | Service til forespørgsel på behandlingsrelationer. | |||
| notifikationsservice | Service til hent af notifikationer. | Replicationjob | Job til overførsel af behandlingsrelationer til opfølgning til backend. |
Der henvises til driftsvejledningen for yderligere information
...
Når der kommer opgraderinger til en komponent, vil der medfølge releasenotes, der beskriver opgradering, fallback, osv. for den enkelte komponent.
...
Version | Dato | Ændring | Ansvarlig |
|---|---|---|---|
0.1 | 2011-06-15 | Initielt dokument | Trifork |
0.2 | 2011-06-21 | Opdatering af databaseoprettelser på NSP og DoDis opfølgningstabeller | Trifork |
0.3 | 2011-07-27 | Opdateret jf. ny struktur med generel notificationsservice. | Trifork |
0.4 | 2011-08-10 | Opdateret dokumentation med GOS services | Trifork |
0.5 | 2011-10-05 | Opdateres dokumentation med CPRABBS service | Trifork |
0.6 | 2011-11-28 | Dokumentation opdateret med whitelist_config tabeloprettelse | Trifork |
0.7 | 2013-10-21 | Opdateret kilde | Trifork |
| 0.8 | 2014-03-12 | Opdateret med beskrivelse af propertyfil, og detaljer for hver property | Trifork |
| 0.9 | 2016-09-01 | Opdateret til Wildfly 8 | Trifork |
| 0.10 | 2016-11-11 | Opdateret logning til profiler | Trifork |
| 0.11 | 2017-03-09 | Tilrettet BRS2 | Trifork |
| 0.12 | 2017-03-14 | Rettet betegnelse på NSP-miljøer | Trifork |
| 0.13 | 2019-07-12 | Dokument fra repository lagt i confluence. Tidligere dokuments indhold var - forkert - arkitektur dokumentet | KvalitetsIT |
| 0.14 | 2020-07-23 | Opdateret med beskrivelse af docker-setup. | KvalitetsIT |
| 0.15 | 2020-11-23 | Gennemlæst og foretaget smårettelser (i krav til applikationsserver og operativsystem, hvor Docker er sat som krav) | KvalitetsIT |