Introduktion
Formål
Dette dokument er rettet mod systemadministratorer og driftspersoner, som skal kunne håndtere driftsmæssige aspekter af programmet.
Driftsvejledningen indeholder information om Registry Deletion Job (RegJob) komponenten med hensyn til eksterne afhængigheder, standard placering af output- og konfigurations-filer.
Læsevejledning
Læseren forventes at have kendskab til drifts-setuppet vedr. XDS Registry og det tilhørende XDB
Dokumenthistorik
Version | Dato | Ansvarlig | Beskrivelse |
0.8 | 09.01.2018 | KvalitetsIT | Initiel udgave |
0.9 | 24.01.2018 | KvalitetsIT | smårettelser mht output |
Komponenter
Dette dokument dækker følgende komponenter:
Registry Deletion Job
Type: Java program
Filnavn: registrydeletionjob.jar
Relaterede services
Registry Deletion Job afhænger af tilstedeværelsen af andre komponenter, og ved fejl i disse vil jobbet fejle tilsvarende. Disse services er:
Aftale XDS Registry
Aftale Registry XDB
Konfiguration
Program-konfiguration
Grundlæggende konfiguration foregår ved redigering i filen application.properties, som skal placeres under mappen "config" relativt i forhold til hvor jar-filen startes fra.
I filen skal følgende properties være definerede:
Property | Beskrivelse |
xds.iti18.endpoint | Adressen på Aftale XDS Registrys iti-18 endpoint |
xds.iti62.endpoint | Adressen på Aftale XDS Registrys iti-62 endpoint |
xdb.url | Stien til Aftale Registry XDB |
xdb.username | Brugernavn til Aftale Registry XDB |
xdb.password | Kodeord til Aftale Registry XDB |
xdb.database | Navnet på Aftale Registry XDB-databasen |
delete.after.days | Hvor gamle dokumenter i Registry skal være, før de slettes |
max.deletes | Hvor mange dokumenter der max slettes ved en kørsel af jobbet |
type.code | Type Code på de dokumenter der slettes (Her er aftale = "39289-4") |
Logning
Registry Deletion Job logger på standardout vha. log4j. Jobbet vil undervejs i kørslen udskrive følgende INFO statements ud:
- Undervejs i søgningen i XDB:
- Found documents to delete: X (efter hver 100 dokumenter)
- Finished finding documents to delete, found: X
- Undervejs i sletning fra XDS:
- Deleted X/Y documents from registry
- Finished deleting documents, deleted: X , failed deleting: Y
- Job finished successfully eller Job finished - Y deletions failed
Fejl vil blive logget som ERROR statements og vil være "Error fetching uuids from XDB" eller "Error deleting document with ID" med tilhørende fejlbesked.
Output
Efter kørsel af jobbet vil der blive placeret filer i det aktuelle bibliotek svarende til dokumenter der skal slettes i XDS repository. Der genereres een fil pr Repository der skal slettes dokumenter i.
Navngivningen på filen/filerne vil være:
- deleted-ddMMyyyyHHmm-repositoryId.txt
Hvor "ddMMyyyyHHmm" svarer til det tidspunkt, hvor jobbet blev startet, og repositoryId er OID på det repository der skal slettes dokumenter i.
Der vil herudover (men kun hvis nogle sletninger i registry fejler) blive genereret een fil med navnet:
- failed-ddMMyyyyHHmm.txt
Indeholdende id´er på de dokumenter, der ikke kunne slettes fra registry
Krav til backup m.m.
Det anbefales at aktuelle konfigurationsfiler er under versionskontrol og back up.
Konsekvenser m.h.t. restore/backup af XDB-databasen
RegJob vil kun slette to år gamle aftaler fra den kørende XDB-database, og disse aftaler vl altså stadigvæk eksistere i de backups af XDB-databasen, der kan være foretaget.
Dette betyder også, at hvis man foretager et restore af en gammel XDB-database, vil man skulle køre RegJob igen.