Installationsbeskrivning UND-07-T-06 DB03 Funktionalitet för att upptäcka fel i databasen 2011-12-22 Version: Beteckning: Status: 1.0 UND-07-T-06
Ändringshistorik Revision Datum Av Kommentar Granskare Godkännare 0.01 2007-10-29 Markus Umefjord Första utkast 0.02 2007-11-08 Markus Umefjord Rättningar och ändringar utifrån synpunkter från Torgny Fridlund 0.03 2007-11-09 Markus Umefjord Uppdaterad kontaktinformation 0.04 2007-11-13 Markus Umefjord Ändringar utifrån synpunkter från Daniel Lind och Thomas Dahlberg 0.05 2007-11-14 Markus Umefjord Ändring i krav: Krav 6 har bytt namn, separatorsträng är ~#~ istället för ~, efter önskemål från Thomas Dahlberg och Daniel Lind. Förtydligande kring användning av separatortecken. 0.06 2007-11-28 Markus Umefjord Ändrad nomenklatur. Begreppet styrfil utgår till förmån för regelfil enligt önskemål från Ladokenheten och konsensus på projektmöte. Borttag av kontaktinformation finns i utskickssammanställningen. 1.0 2008-01-25 Daniel Lind Slutlig version
Markus Umefjord 2011-12-22 UND-07-T-06 3 (6) Innehållsförteckning 1 INLEDNING... 4 1.1 SYFTE... 4 1.2 ENKEL ÖVERSIKT... 4 1.3 CHECKLISTA... 4 1.4 KRAV PÅ MILJÖN... 4 2 KONFIGURATION... 5 2.1 NYA PROPERTIES... 5 2.1.1 db03.reportfilefolder... 5 2.1.2 db03.controlfilefolder... 5 2.2 REGELFILER... 5 2.3 RAPPORTFILER... 6
Markus Umefjord 2011-12-22 UND-07-T-06 4 (6) 1 Inledning 1.1 Syfte Syftet med detta dokument är att beskriva den konfiguration som krävs vid driftssättning av batchen DB03. 1.2 Enkel översikt DB03 läser en eller flera regelfiler från disk, tolkar dessa samt exekverar den SQL-kod som finns i regelfilerna och genererar rapportfiler utifrån det utsökta resultatet. För varje regelfil ska batchen generera två olika rapportformat utifrån samma data. Rapportfilerna skrivs till disk och görs tillgängliga för läsning via Nouveau-gränssnittet. DB03 består av två delar; en generell beställningsfunktionalitet i Nouveau, och en del i javabatchramverket som exekverar regler och producerar rapportfiler. Batchen har som indata regelfiler som definierar olika verksamhetsregler som DB03 hanterar. Regelfilerna innehåller regler i form av SQL-satser som tolkas av DB03 och körs mot den underliggande databasen. Posterna som påträffas med hjälp av reglerna i regelfilerna skrivs till rapportfiler för manuell uppföljning. 1.3 Checklista Installationen av DB03 är mycket enkel. Följ dessa steg för att konfigurera DB03. 1. Öppna filen ladok.batch.properties i en texteditor 2. Lägg till två nya rader enligt stycke 2.1. 3. Klart! Se separat dokumentation för information om hur de generella delarna av batchramverket ska konfigureras. 1.4 Krav på miljön DB03 exekverar i samma miljö som övriga batchar, vilket innebär att den typiskt behöver följande förutsättningar på servern (för närvarande): Java 1.6.0_25 mysql 5.5.15 Uniface 9.4.01 Se separat dokumentation för information om hur de generella delarna av batchramverket ska konfigureras.
Markus Umefjord 2011-12-22 UND-07-T-06 5 (6) 2 Konfiguration 2.1 Nya properties Batchen är beroende av att två nya properties sätts i filen ladok.batch.properties. Exempel på nytt innehåll i filen ladok.batch.properties. db03.reportfilefolder=${batchfiles} db03.controlfilefolder=/home/ladok/db03/regelfiler 2.1.1 db03.reportfilefolder Obligatorisk: Nej (om ej angiven används attributet batchfiles, dvs. standardkatalogen för filer som genereras av batchar) Den katalog på disken som rapportfilerna ska skrivas till. Detta bör vara samma som katalogen för Nouveau-filer, annars kan rapporterna inte hämtas via Nouveau-gränssnittet (med nuvarande filhämtningsfunktion i Nouveau). 2.1.2 db03.controlfilefolder Obligatorisk: Nej (Vi rekommenderar dock att man anger ett explicit värde för att undvika problem med sammanblandning med andra filer) Den katalog på disken som regelfilerna ska läsas från. Denna katalog bör helst vara dedikerad för syftet, dvs. använd ej en katalog som kan innehålla andra filer. Syftet är att batchprogrammet kommer att söka efter alla XML-filer i katalogen och försöka tolka dessa som regelfiler. Om filerna inte följer formatet kommer batchen att avsluta med ett felmeddelande. Även om detta attribut inte måste anges är det vår rekommendation att man gör det för att undvika beblandning med andra filer. 2.2 Regelfiler Batchen DB03 är beroende av att det finns tillgängliga regelfiler på disken (katalog anges med propertyn db03.controlfilefolder). Vi använder det engelska begreppet control file för att beteckna regelfiler i batchens implementation/kod. Regelfiler kräver ingen speciell installation de kopieras till en katalog någonstans på servern som sedan pekas ut via propertyn db03.controlfilefolder i ladok.batch.properties. Regelfilerna tillhandahålls av Ladokenheten och placeras i en egen katalog, förslagsvis under /incoming/db03. Denna katalog måste anges i propertyn db03.controlfilefolder i
Markus Umefjord 2011-12-22 UND-07-T-06 6 (6) ladok.batch.properties. Regelfilernas namn och filändelse ska inte ändras, och de ska vara läsbara för batch-processen. 2.3 Rapportfiler DB03 genererar en sammanställningsfil och upp till två rapportfiler per regelfil. Rapportfilerna och sammanställningsfilen skrivs till en katalog som kan konfigureras i propertyn db03.reportfilefolder i ladok.batch.properties. Denna katalog måste vara skrivbar för batchprocessen. Gamla rapportfiler kan tas bort och/eller döpas om, men man får inte ändra skrivrättigheterna till dessa filer de måste kunna skrivas över av batchprocessen.