Komponenter

Dette dokument dækker følgende komponenter på NSP:

NSP XDS Registry Felt migrerings service
Type: Webservice
Filnavn: nxrgfieldmigration.war
Url: <serverurl>/nxrgfieldmigration
Servicecheckurl: <serverurl>/nxrgfieldmigration/status
Versionurl: <serverurl>/nxrgfieldmigration/health

Konfiguration

Servicekonfiguration

Grundlæggende konfiguration foregår ved redigering i filen nxrgfieldmigration.properties, der placeres i følgende WildFly modul:

/pack/wildfly/modules/sds/nxrgfieldmigration/configuration/main/

Moduldefinitionen er at finde i sourcekoden til nxrg under:

/compose/configuration/fieldmigration/module.xml

I filen skal følgende properties være definerede:

Property	Beskrivelse
Property	Beskrivelse
datasource.jndi.name	JNDI navnet på den datasource der giver adgang til NXRG databasen.
nxrg.data.max.no.of.documents	Angiver, hvor mange dokument registreringer (antal database records) der skal håndteres i een kørsel. Større antal tager længere tid.

log4j konfiguration

Log4j konfiguration findes i samme wildfly modul som servicekonfigurationen

Se yderligere opsætning i installationsvejledningen.

Overvågning

NXRG felt migrering udstiller en overvågningsside på endpoint <serverurl>/nxrgfieldmigration/status

Fortolkning af HTML overvågningsside

NXRG-overvågningssiden returnerer enten:

HTTP 200, hvis servicen i øjeblikket kører fint.
HTTP 500, hvis der er opstået en fejl der kræver indgriben.

Overvågningstyper

Det overvåges om der kan opnås forbindelse til databasen.

Status

NXRG udstiller to status sider

Version

Udstilles på endpoint <serverurl>/nxrgfieldmigration/health

Eksempel på status:

{
   "version":"1.0.14-SNAPSHOT"
}

Den fortæller, hvilken version af felt migrering, som kører.

Migrerings status

Udstilles på endpoint <serverurl>/nxrgfieldmigration/fieldmigrationstatus

Eksempel på status:

[
   {
      "id":3,
      "migrationid":"documententry-repositoryid-add",
      "progressid":94,
      "targetid":94,
      "migrationStartTime":"2022-05-17T08:15:33Z",
      "migrationEndTime":"2022-05-17T08:15:35Z",
      "lastUpdateTime":"2022-05-17T06:15:35.081334Z"
   }
]

Den fortæller, hvor langt en given migrering er:

Er migrationStartTime sat, har migeringen været aktiveret mindst een gang
Er progressId = targetId og migrationEndTime sat, er migreringen kørt færdig
Er progressId != targetId og migrationEndTime ikke sat, er migreringen ikke færdig kørt

Fortolkning af HTML overvågningsside

NXRG-overvågningssiden returnerer enten:

HTTP 200, hvis servicen i øjeblikket kører fint.
HTTP 500, hvis der er opstået en fejl der kræver indgriben.

Overvågningstyper

Det overvåges om der kan opnås forbindelse til databasen.