Page History
Navitabs | ||
---|---|---|
| ||
Migreringskomponenten benyttes ikke længere, og er blevet slettet fra BTR.
Overblik
Dette dokument beskriver en migreringsvejledning for Livs- og behandlingstestamenteregister-servicen. Projektet indeholder en migreringskomponent, hvis formål er at importere data fra det eksisterende Livstestamenteregister til dette nye Livstestamenteregister. Behandlingstestamenteregistret er helt nyt, og der findes derfor ikke data, som skal importeres i dette.
Ændringslog
Version | Dato | Ændring | Ansvarlig |
---|---|---|---|
1.0.2 | 2018-08-31 | Ny release | Trifork |
1.0.7 | 2018-10-26 | Mindre rettelser | Trifork |
Installation
Se projektets installationsvejledning der også beskriver installation af migreringskomponenten ltr-migration.
Funktionalitet
Komponenten udstiller en række endpoints, der kan anvendes til at styre funktionaliteten.
...
Info |
---|
Status-siden kan løbende kaldes under kørslen for at holde øje med forløbet. Hvis det fx observeres at error count stiger højt, kan man afbryde migreringen vha. stop-funktionaliteten, i stedet for at køre hele datasættet igennem. Forventet throughput er ca. 500.000 rækker i minuttet, men det afhænger af mange faktorer. |
Filformat
For migrering af Livstestamenteregistret er der påkrævet 2 filer, den ene indeholdende PersonData og den anden med data for eksisterende livstestamenteregistreringer.
...
- Data for personer: PersonData.csv
- Data for livstestamenteregistreringer: LivingWillData.csv
Dataformater
Tabellerne nedenunder angiver hvilke kolonner, der er påkrævet for hver af de nødvendige filer, derudover format, et eksempel samt eventuelle bemærkninger.
...
Encoding skal være i UTF-8 format og da migreringskørslen formodes at køre på et Unix miljø, er det anbefalet, at der anvendes Unix linjeskift (\n), dog kan migreringskoden også godt håndtere Windows linjeskift.
PersonData:
Kolonnenavn | Format | Eksempel | Bemærkninger |
---|---|---|---|
PersonID | String | 215 | Inkrementelt id |
CivilRegistrationNumber | String | 2201601234 | CPR-nummer, uden bindestreg |
LivingWillData:
Kolonne Navn | Format | Eksempel | Bemærkninger |
---|---|---|---|
PersonID | int | 2158724 | Reference til PersonID i PersonData |
Answer1 | String (varchar(1)) | J | Kun J eller N |
Answer2 | String (varchar(1)) | N | Kun J eller N |
ValidDate | Date, format: yyyy-MM-dd HH:mm:ss.SSS | 2018-05-03 18:51:51.776 | Dansk tid. Skal være mellemrum mellem dato og tidspunkt |
EditDate | Date, format: yyyy-MM-dd HH:mm:ss.SSS | 2018-05-03 18:51:51.776 | Dansk tid. Skal være mellemrum mellem dato og tidspunkt |
Overvågning
IsAlive
Servicen udstiller en status-side (isAlive). På denne side fremgår servicens version, opstartstidspunkt mm.
...
Code Block |
---|
200 OK Title: ltr-migration Deployed: 2018-10-26T08:14:44.085Z Build-Date: 2018-10-18T13:08:04Z Build-Version: 1.0.7-SNAPSHOT Builder: A robot Display time: 2018-10-26T09:27:43.627Z |
HTTP statuskode
Status-siden returnerer følgende HTTP statuskoder afhængig af servicens status:
- 200: Applikationen kører i øjeblikket fint.
- 500: Der er opstået en fejl, der kræver indgriben.
Fejlfinding
Følgende årsager kan resultere i en statuskode 500:
...
Alle komponenter kan genstartes ved at opdatere war-filens last access time med Unix-kommandoen touch, hvilket automatisk detekteres af Wildfly's deploynent scanner. Alternativt kan Wildfly genstartes.
Migreringsstatus
Yderligere indeholder servicen en status-side for migreringsprocessen. På denne side fremgår hvornår migrering er påbegyndt, om migrering er under afvikling, antallet af fejl der har været mm.
...
Code Block |
---|
Display time: 2018-11-14T16:58:53.685Z Migration start time: 2018-11-14T16:49:14.403Z Is running: false Number of rows inserted in database: 187083 Error count: 136 |
Logning
Følgende beskrivelse af logning i servicen tager udgangspunkt i standard-opsætningen. Logning konfigureres vha. konfigurationsfilerne beskrevet i installationsvejledningen.
...