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 Repository Deletion Job (RepJob) 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 Repository og det tilhørende XDB

Dokumenthistorik

Komponenter

Dette dokument dækker følgende komponenter:

• Repository Deletion Job

• Type: Java program

• Filnavn: repositorydeletionjob.jar

  
  

Relaterede services

Repository Deletion Job afhænger af tilstedeværelsen af andre komponenter, og ved fejl i disse vil jobbet fejle tilsvarende. Disse services er:

• Aftale Repository 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:

Programopstarts-parametre

Når programmet startes op fra kommandolinien, skal der gives en filnavn med, svarende til de dokumenter der skal slettes fra repository XDB. Denne fil vil typisk komme fra Registry Deletion Job. Eksempel på program-opstart:

• java - jar repositorydeletionjob.jar deleted-080120180150-1.2.208.176.43210.8.88.1.30.txt
  

Logning

Repository Deletion Job logger på standardout vha. log4j. Jobbet vil undervejs i kørslen udskrive følgende INFO statements ud:

• Attempting to delete based on file X
• Found IDs to delete from repository: X
• Deletion progress: X/Y (efter hver 50 dokumenter)
• Deleted X documents successfully, Failed Y deletions.

Fejl vil blive logget som ERROR statements og vil være "Filename must be given as arg input" , "Error reading from input file" eller "Fatal error occurred whilst deleting documents" med tilhørende stacktrace.

Output

Efter kørsel af jobbet vil der blive placeret filer i det aktuelle bibliotek svarende til hvilke sletninger der er gået godt, og hvilke der er gået dårligt, d.v.s. to filer:

• <input-filnavn>-success - hvor hver linje indeholder et ID på en sletning, der er gået godt
• <input-filnavn>-failure - hvor hver linje indeholder er ID på en sletning, der er gået dårligt (d.v.s. enten at dokumentet ikke findes, eller fejler under sletningen)

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

RepJob vil kun slette de listede ID´er 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 RepJob igen.