Dette dokument er rettet mod systemadministratorer og driftspersoner, som skal kunne håndtere driftsmæssige aspekter af programmet.
Driftsvejledningen indeholder information om XDSCleanup komponenten med hensyn til afvikling, konfiguration og overvågning.
Læseren forventes at have kendskab til drifts-setuppet vedr. XDS Registry og det tilhørende XDB repository.
Version | Dato | Ansvarlig | Beskrivelse |
0.1 | 28-02-2022 | KvalitetsIT | Initiel udgave |
XDSCleanup udstiller et antal http-endpoints. Dette afsnit beskriver hvilke endpoints der er, og deres returkoder og fortolkning af svaret.
Det forventes at der kun deployes én instans af XDSCleanup. Servicen tjekker om den selv er i gang med at udføre en oprydning, inden den går i gang, men den tjekker ikke om eventuelle andre instanser er i gang.
Primært endpoint, som starter en iteration af oprydningen: Eksempel på kald:
curl -i localhost:8060/xdscleanup/cleanup
Der returneres følgende http-statuskoder:
Statuskode | Fortolkning |
---|---|
200 OK | Sletningen gik godt. Det vil fremgå af applikationloggen, hvad der er slettet. |
400 Bad Request | Requestet blev afvist, da et andet request allerede var i gang. |
500 Internal Server Error | Noget gik galt under sletning. Applikationsloggen bør inspiceres for at fastslå problemet. |
Overvågnings-endpoint, som bruges til at overvåge komponentens sundhedstilstand. Eksempel på kald:
curl -i localhost:8060/xdscleanup/health
Der returneres følgende http-statuskoder:
Statuskode | Fortolkning |
---|---|
200 OK | Servicen er i sund tilstand. |
500 Internal Server Error | Servicen er i usund tilstand. Responset indeholder yderligere information om årsagen. Applikationsloggen indeholder yderligere information. |
Body'en indeholder en json-struktur, der beskriver hvilke dele af systemet der er blevet tjekket, og deres tilstand. Eksempel hvor tjenesten er i sund tilstand:
{ "version": "42e17e1cb3ea8d8abd21d87252b14a136020e7c0", "registry.db": "ERROR: 7 entries could not be deleted from repository." } |
Eksempel hvor tjenesten er i usund tilstand:
{ "version": "42e17e1cb3ea8d8abd21d87252b14a136020e7c0", "registry.db": "ERROR: 7 entries could not be deleted from repository." } |
Grundlæggende konfiguration foregår ved redigering i filen /compose/configuration/xdscleanup.properties.
I filen skal følgende properties være definerede:
Property | Beskrivelse |
---|---|
datasource.nxrg.jndi.name | JNDI navnet på den datasource der giver adgang til NXRG databasen. |
datasource.openxds.jndi.name | JNDI navnet på den datasource der giver adgang til OpenXDS databasen. |
deletion.batchsize | Antal dokumenter der forsøges slettet i en kørsel af jobbet. |
deletion.max.attempts | Antal gange sletning fra repository'et forsøges, før sletningen markeres som 'fejlet'. |
XDSCleanup logger på standardout vha. log4j. Jobbet vil undervejs i kørslen udskrive information (på INFO-niveau) om, hvor mange dokumenter der er slettet i NXRG og OpenXDS. Eventuelle fejl vil blive logget på ERROR-niveau.
Nedenstående logudsnit viser et eksempel på, hvad der logges under en succesfuld kørsel:
2022-02-28 14:40:01,019 [INFO] dk.nsp.xdscleanup.ws.CleanupServlet - Attempting to run XDS Cleanup. 2022-02-28 14:40:01,020 [INFO] dk.nsp.xdscleanup.service.impl.CleanupServiceImpl - Performing iteration of XDS Cleanup ... 2022-02-28 14:40:01,020 [INFO] dk.nsp.xdscleanup.service.impl.CleanupServiceImpl - Preparing registry deletion. 2022-02-28 14:40:01,029 [INFO] dk.nsp.xdscleanup.service.impl.CleanupServiceImpl - Deleting DocumentEntries. Deletion parameters: [ typeCode: TypeCode[codeName=39289-4,codeScheme=2.16.840.1.113883.6.1], latestStartTime: 2021-12-28T13:40:01.020Z, batchSize: 3 ] 2022-02-28 14:40:01,497 [INFO] dk.nsp.xdscleanup.service.impl.CleanupServiceImpl - Deleted DocumentEntries are: [ DocumentEntry[entryId=1,entryUuid=urn:uuid:03437e9f-24ee-4ca3-81b5-bd9222b0a221,uniqueId=7365138326801008407.4732229697929786785.1638782612783], DocumentEntry[entryId=2,entryUuid=urn:uuid:523eb18f-10a3-4ec8-8518-1e33b6c54a54,uniqueId=6313982942207370191.4718769210813691557.1638782616933], DocumentEntry[entryId=3,entryUuid=urn:uuid:050fc787-17a1-4c07-91eb-adb61fefc31e,uniqueId=7503668617814493420.8306293344729713893.1638782619079] ] 2022-02-28 14:40:01,497 [INFO] dk.nsp.xdscleanup.service.impl.CleanupServiceImpl - Number of deleted DocumentEntries is: 3 2022-02-28 14:40:01,498 [INFO] dk.nsp.xdscleanup.service.impl.CleanupServiceImpl - Preparing repository deletion. 2022-02-28 14:40:01,508 [INFO] dk.nsp.xdscleanup.service.impl.CleanupServiceImpl - Attempting to delete Documents: [ DeletedDocumentEntry[entryId=1,entryUuid=urn:uuid:03437e9f-24ee-4ca3-81b5-bd9222b0a221,uniqueId=7365138326801008407.4732229697929786785.1638782612783], DeletedDocumentEntry[entryId=2,entryUuid=urn:uuid:523eb18f-10a3-4ec8-8518-1e33b6c54a54,uniqueId=6313982942207370191.4718769210813691557.1638782616933], DeletedDocumentEntry[entryId=3,entryUuid=urn:uuid:050fc787-17a1-4c07-91eb-adb61fefc31e,uniqueId=7503668617814493420.8306293344729713893.1638782619079] ] 2022-02-28 14:40:01,509 [INFO] dk.nsp.xdscleanup.service.impl.CleanupServiceImpl - Attempting deletion for 3 Documents. 2022-02-28 14:40:01,548 [INFO] dk.nsp.xdscleanup.service.impl.CleanupServiceImpl - Documents deleted are: [ DeletedDocumentEntry[entryId=1,entryUuid=urn:uuid:03437e9f-24ee-4ca3-81b5-bd9222b0a221,uniqueId=7365138326801008407.4732229697929786785.1638782612783], DeletedDocumentEntry[entryId=2,entryUuid=urn:uuid:523eb18f-10a3-4ec8-8518-1e33b6c54a54,uniqueId=6313982942207370191.4718769210813691557.1638782616933], DeletedDocumentEntry[entryId=3,entryUuid=urn:uuid:050fc787-17a1-4c07-91eb-adb61fefc31e,uniqueId=7503668617814493420.8306293344729713893.1638782619079] ] 2022-02-28 14:40:01,548 [INFO] dk.nsp.xdscleanup.service.impl.CleanupServiceImpl - Number of deleted Documents is: 3 2022-02-28 14:40:01,548 [INFO] dk.nsp.xdscleanup.service.impl.CleanupServiceImpl - Documents not deleted are: [ ] 2022-02-28 14:40:01,548 [INFO] dk.nsp.xdscleanup.service.impl.CleanupServiceImpl - Number of not deleted Documents is: 0 2022-02-28 14:40:01,548 [INFO] dk.nsp.xdscleanup.service.impl.CleanupServiceImpl - Marking successful deletion. 2022-02-28 14:40:01,557 [INFO] dk.nsp.xdscleanup.service.impl.CleanupServiceImpl - XDS Cleanup iteration finished! |
I dette eksempel køres med batchSize 3, og det ses at der slettes tre DocumentEntries i registry'et, og derefter tre tilsvarende Documents i repository'et.