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.2018KvalitetsIT

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.usernameBrugernavn til Aftale Registry XDB
xdb.passwordKodeord til Aftale Registry XDB
xdb.databaseNavnet på Aftale Registry XDB-databasen
delete.after.daysHvor gamle dokumenter i Registry skal være, før de slettes
max.deletesHvor mange dokumenter der max slettes ved en kørsel af jobbet
type.codeType 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.

  • No labels