Banksynkronisering
BANKSYNKRONISERING... 3 BESKRIVNING...3 VILLKOR...4 DEFINITIONER...4 ANVÄNDARHANDLEDNING... 6 STARTA VERKTYGET...6 ÖPPNA EN SYNKRONISERING...9 SKAPA NYTT SYNKRONISERINGFÖRHÅLLANDE...11 VISA/ÄNDRA EN SYNKRONISERING...12 RADERA EN SYNKRONISERING...13 EDITERA SYNKRONISERINGSTABELL...14 Söka efter en post...15 Ändra en post...15 Ta bort en post...16 Lägga till en post...16 VISA TABELL...16 SKAPA NY KÖRNING...17 UTFÖRA EN SYNKRONISERINGSKÖRNING...20 Påfyllningfasen...20 Fas 1...21 Incheckningsfasen...22 Fas 2...22 SYNKRONISERINGSKÖRNING FRÅN PROMPT...23 SYSTEMADMINISTRATION...24 SYSTEMBESKRIVNING...24 Synkroniseringstabell och synkroniseringskatalog...24 Synkroniseringskörning...25 Synkroniseringsverktyget...26 BankIRserver...27 Automatisk körning...27 Loggningsfiler med e-mail...27 ADMINISTRATION...28 Synkroniseringssignatur...28 Synkroniseringsbeställning...28 Filterscript...29 Behörighet...29 Synkroniseringscript...29 FÖRSTAGÅNGSINLÄGGNING...30 ALLMÄNT...30 HANTERING...30 UTÖKNING AV BEFINTLIG SYNKRONISERINGEN...32 Geografisk utökning...32 Tematisk utökning...32 2
BANKSYNKRONISERING Beskrivning Banksynkronisering är utvecklad för att på ett säkert sätt utbyta (synkronisera) geografiska data mellan skilda geodatabanker placerade i samma eller olika datorer. Meningen är att då en geodatabank ajourhålls, ska motsvarande data i den andra geodatabanken ajourhållas på ett sådant sätt att gemensamma data alltid är identisk lika i de båda bankerna. Metoden bygger på, att när data kopieras från en bank till en annan, görs detta via en översättningstabell, där specifika attribut lagras från respektive bank. Banksynkronisering stödjer såväl enkelriktad som dubbelriktad ajourhållning d v s antingen förs data över endast från en bank till en annan eller så ajourhåller de varandra. T ex kan fastighetsdata som ajourhålls inom en tätort i en lokal geodatabank synkroniseras mot en nationell bank. Omvänt kan data om t ex allmänna vägnätet inom en kommun, som ajourhålls i den nationella banken, också synkroniseras mot den lokala geodatabanken. Även samma typ av data som ajourhålls i båda bankerna kan synkroniseras i båda riktningarna under förutsättning att samma post inte uppdateras i de olika bankerna under samma synkroniseringsperiod. Vid eventuella krockar får man manuellt lösa upp skillnaderna. Banksynkroniseringen bygger på en s k client-server lösning som är uppbyggd av ett begränsat utbud av möjliga kommandon vilket medför hög säkerhet. Lösningen fungerar utmärkt tillsammans med eventuella brandväggar. AutoKa:s datamodell med unika permanenta identiteter (födelsenummer) och versionshantering (ändringsdatum) på samtliga lagrade poster (geografiska detaljer), samt funktioner för inkrementell datahantering i BankIR-systemet, ger tillsammans förutsättningar för banksynkroniseringen. I normalfallet körs automatiska synkroniseringskörningar vid en bestämd tidpunkt och med ett bestämt intervall. Kontrollen av synkroniseringskörningarna görs genom att de loggningsfiler som genereras vid körningarna automatiskt skickas som e-mail till utsedda ansvariga. Vid särskilda tillfällen t ex då fel uppstått eller vid stora överföringar (t ex vid en förstagångsinläggning) används det grafiska synkroniseringsverktyget. Ytterligare aspekter: Eventuella skillnader av objektskodning (detaljtyper) av poster i de båda bankerna kan hanteras genom automatiska omvandlingar vid körningarna. Synkroniseringen kan hantera sammansatta detaljer. Topologiska skillnader mellan de båda bankerna t ex ytbildning av objekt i den ena banken kan för närvarande inte hanteras. 3
Villkor Definitioner För att synkronisering av data mellan två geodatabanker skall kunna genomföras skall följande villkor vara uppfyllda: Alla objekt/detaljer i bankerna skall ha unika födelsenummer (fnr). Alla objekt/detaljer i bankerna skall ha en tidstämpel (ändringsdatum), detta markerar senaste ändringstillfället (versionshantering). In- och utcheckning av data i bankerna skall göras med s k beställningar (BankIR-beställningar) och generera flyttfiler. Det ska finnas en specifik synkroniseringssignatur för varje par av banker som skall synkroniseras. Banksynk-klient Används av både verktyget och synkroniseringsscriptet för att kommunicera med BankIR-servern under en synkroniseringskörnings fyra faser. BankIR-server Server som hanterar kommandon från klienten, oavsett om denna körs via synkroniseringsverktyget eller synkroniseringsscriptet. Filterscript Ett script som används för att sortera bort eller byta objektskodning (detaljtyper) på detaljer. Scriptet ska ligga under synkroniseringskatalogen och använder sig av en filterfil där detaljtyperna som ska tas bort/bytas ut anges. Huvudbank Den bank som i huvudsak ajourhålls av den andra banken. Satellitbank Den bank som i huvudsak ajourhåller den andra banken. Synkronisering Metod att garantera att data i två banker är identiskt lika. Synkroniseringen omfattar hela eller delar av bankerna, geografiskt och/eller tematiskt. Synkroniseringsbeställning BankIR-beställning som i samband med synkronisering används av programmet vid utcheckning (kopiering) eller incheckning (lagring) i respektive bank. 4
Synkroniseringskatalog Katalog som skapas för varje bankpar som skall synkroniseras. I katalogen lagras synkroniseringstabellen och ytterligare filer som används vid synkroniseringskörningarna. Synkroniseringskörning Överföring av data mellan två banker via en synkroniseringstabell. Synkroniseringsscript Kommandoscript som innehåller de kommandon som erfordras för att utföra en synkroniseringskörning utan att använda det grafiska verktyget. Scriptet startas av datorns system vid en angiven tidpunkt, vilket innebär att en automatisk körning görs. Synkroniseringssignatur Signatur som används för in- och utcheckning i respektive geodatabank. Varje post som lagras i en bank märks med denna signatur. Synkroniseringstabell Databas (översättningstabell) som innehåller födelsenummer och ändringsdatum för varje gemensam detalj i de båda bankerna. Synkroniseringsverktyg Grafiskt program för att skapa synkroniseringar samt hantera synkroniseringskörningar och deras respektive synkroniseringstabeller. 5
ANVÄNDARHANDLEDNING Starta verktyget Programmet kan antingen köras ifrån grafisk miljö eller från prompt men då med begränsat utbud av funktioner. Tänk på att det är skillnad mellan en synkronisering (bankförhållandet) och en synkroniseringskörning (databearbetningen). Den grafiska varianten av programmet startas med kommandot banksynk utan några parametrar angivna. Figur 1 - Formuläret visar de banker som är synkroniserade Det första fönstret som visas då programmet startas är Banksynkroniseringar som innehåller en lista över de synkroniseringsförhållanden (bankpar) som har upprättats. Ett synkroniseringsförhållande kan vara enkelriktat (->) eller dubbelriktat (-> och <- ). Som framgår av figur 1 består namnet av bankernas namn samt en pil -> som visar riktningen på dataflödet. sunne -> alfa är en synkronisering från banken sunne till banken alfa sunne <- alfa är en synkronisering från banken alfa till banken sunne För de flesta menyalternativ som finns i detta fönster krävs att man först väljer (markerar) den synkronisering man är intresserad av. 6
Synkroniseringsmeny Figur 2 - Synkroniseringsmenyn för hantering av synkroniseringar Följande funktioner finns i menyn: Öppna Ny Visa/Ändra Radera Avsluta öppnar en befintlig synkronisering skapar en ny synkronisering mellan två banker visar information om en synkronisering och ger möjlighet att ändra på vissa uppgifter raderar en befintlig synkronisering inklusive dess eventuella invers avslutar synkroniseringsverktyget Notera: Funktionerna Ny och Radera kan endast köras av användaren gdbadm som är en användare som alltid ska finnas för BankIR-installationer. Begränsningen är till för att säkerhetsställa att synkroniseringar skapas eller raderas under kontrollerade förhållanden av personer som har kunskap inom ämnet. Användaren gdbadm har också rätt att ändra på fler fält i Visa/Ändra än övriga användare. 7
Tabellmeny Figur 3 - Tabell-menyn för hantering av synkroniseringstabellen Följande funktioner finns i menyn: Editera tabell Visa tabell Hjälpmeny Öppnar ett formulär för att söka, ändra, addera eller radera poster i synkroniseringstabellen för vald synkronisering. Visar innehållet av synkroniseringstabellen för vald synkronisering. Det går även i samband med detta att spara tabellen till en vanlig textfil. Figur 4 - Hjälpmeny För närvarande går det endast att få information om version för programmet. 8
Öppna en synkronisering För att öppna en synkronisering antingen dubbelklickar man på den önskade synkroniseringen i huvudfönstrets synkroniseringslista eller så markerar man den önskade synkroniseringen och väljer Öppna under menyn Synkronisering. Ett valfönstret visas då med gjorda eller påbörjade synkroniseringskörningar. Figur 5 - Valfönstret med lista över synkroniseringskörningar Körningslistan I fönstret visas alla körningar för den valda synkroniseringsriktningen. För varje körning redovisas datum och tid då körningen skapades. Dessutom redovisas den status som körningen har. Följande status kan förekomma: Registrerad - synkroniseringskörningen har lagrats men ingen data har ännu körts igenom programmet Påfyllningsfasen - påfyllning har gjorts i satellitbanken och flyttfilen har hämtats till synkroniseringskatalogen Fas 1 - programmet har bearbetat satellitbankens flyttfil, byggt upp en temporär synkroniseringstabell över vilka poster som har översatts och skapat den flyttfil som ska användas för incheckning i huvudbanken. Incheckningsfasen - incheckning i huvudbanken har gjorts och kvittofilen har hämtats till synkroniseringskatalogen Synkronisering lyckad - synkroniseringen har genomförts utan problem Synkronisering misslyckad - synkroniseringen har misslyckats Synkronisering onödig - innebär antingen att det inte finns några poster att synkronisera i den utcheckade flyttfilen eller att alla poster har oförändrade ändringsdatum jämfört med de datum som finns i synkroniseringstabellen. 9
Öppna Öppnar en eller flera valda synkroniseringskörningar. Ett nytt fönster för varje vald körning öppnas. Avbryt Stänger valfönstret och fokus återgår till huvudfönstret.. Körningsmeny Figur 6 - Körningsmenyn för hantering av synkroniseringskörningar Följande funktioner finns i menyn. Ny Öppna Radera Avsluta öppnar ett nytt fönster med möjlighet att göra en ny synkroniseringskörning. Valfönstret stängs. öppnar den/de synkroniseringskörningar som är markerade i körningslistan. Ett nytt fönster per synkroniseringskörning öppnas och valfönstret stängs. raderar den eller de synkroniseringskörningar som är markerade i körningslistan stänger valfönstret Hjälpmeny Fungerar på samma sätt som Hjälp-menyn i huvudfönstret. 10
Skapa nytt synkroniseringförhållande Genom att välja Ny under menyn Synkronisering i huvudfönstret öppnas ett formulär för att skapa ett nytt synkroniseringsförhållande. Notera: För att skapa en synkronisering måste signaturen gdbadm köra synkroniseringsverktyget. Figur 7 - Formulär för ny synkronisering. Satellitsida/Huvudsida I formuläret finns ett antal fält för vardera satellit och huvudsida av synkroniseringen. Information om användare och passord behövs endast vid automatiska körningar varför denna information lagras i en speciell fil med speciella rättigheter. Bank Namn på aktuell bank. Domän Namn på domän som banken ligger i. Beställning Namn på synkroniseringsbeställningen. Adress IP-adress till den dator som banken ligger lagrad i. Användare Namn på den användare som används för synkroniseringens in- och utcheckningar. Editera Knapp som öppnar ett dialogfönster för inmatning av passord för användaren. Editera Öppnar en passordsdialog där man får mata in passordet för angiven användare. Fältet för användaren är låst och går inte att ändra i. 11
Figur 8 - Formulär för att byta passord för synkroniseringen Spara passordsinformation Om denna ruta är iklickad måste man också ange användarnamn och passord för att kunna spara synkroniseringen. Som standard är denna redan ifylld då formuläret öppnas. Notera: Systemet kräver för närvarande att samma signatur används i båda bankdatorerna. Passordet för respektive dator kan dock vara olika. Att byta passord i verktyget betyder inte att passordet byts i respektive maskin. OK Sparar synkroniseringen. Om synkroniseringsförhållandet är helt nytt erbjuds man att skapa ett inversförhållande genom att ett likadant formulär öppnas med all information ifylld utom beställningsnamnen. Ångra Stänger formuläret utan att spara eventuellt ändrad information. Visa/Ändra en synkronisering Genom att välja Visa/Ändra under menyn Synkronisering i huvudfönstret öppnas ett formulär som visar information om en vald synkronisering. En normal användare kan här ändra på beställningsnamn och passord. Användaren gdbadm kan dessutom ändra på användarsignaturen. I övrigt fungerar formuläret som det är beskrivet i "Skapa ny synkronisering". 12
Figur 9 - Formulär för ny synkronisering. Radera en synkronisering Markera den synkronisering som skall raderas och välj Radera under menyn Synkronisering. Därefter får man bekräfta i en dialogruta att raderingen ska utföras. Notera: För att ta bort en synkronisering måste signaturen gdbadm köra synkroniseringsverktyget. Detta för att säkerhetsställa att synkroniseringar inte försvinner av misstag då det är mycket svårt att återställa dem. Att radera en synkronisering innebär att all information om den valda synkroniseringen inklusive information om en eventuell invers synkronisering försvinner. På filnivå innebär detta att hela synkroniseringskatalogen inklusive flyttfiler, tabeller, objektkodningsfiler, passordsfil o.s.v. raderas. Figur 10 - Dialogruta vid radering. Här bekräftas att synkroniseringen skall raderas. 13
Editera synkroniseringstabell Genom att välja Editera tabell från menyn Tabell för en vald synkronisering i huvudfönstret får man möjlighet att söka, ändra, lägga till och ta bort poster i synkroniseringstabellen. Figur 11 - Editera synkroniseringstabell Söktabell/Bank Här väljer man den bank som man är intresserad av att söka efter födelsenummer i eller lägga till/ändra poster i. Födelsenummer I fältet för födelsenummer skriver man in det födelsenummer man är intresserad av att få mer information om, ändra eller lägga till. Sök Söker efter angivet födelsenummer i angiven bank. Satellit fnr/satellit adat Här visas födelsenumret och ändringsdatumet för aktuell post i satellitbanken. Vilken bank som anses vara satellit beror på synkroniseringsförhållandet man valde i huvudfönstret. Huvud fnr/huvud adat Här visas födelsenumret och ändringsdatumet för aktuell post i huvudbanken. Vilken bank som anses vara huvudbank beror på synkroniseringsförhållandet man valde i huvudfönstret. Satellitbank Namnet på den bank som är satellitbank enligt det synkroniseringsförhållande man valde i huvudfönstret. 14
Huvudbank Namnet på den bank som är huvudbank enligt det synkroniseringsförhållande man valde i huvudfönstret. Spara Är alla fält ifyllda sparas posten i synkroniseringstabellen. Om ett födelsenummer som inte finns i tabellen angetts erbjuds man via en dialog att lägga till en ny post till tabellen. Innan en post verkligen sparas i synkroniseringstabellen krävs alltid en bekräftelse via en dialog som kommer upp. Vill man spara klickar man OK annars Ångra. Figur 12 - Bekräftelse krävs innan en post sparas. Söka efter en post 1. Välj bank som det sökta födelsenumret ska finnas i 2. Skriv in födelsenumret i födelsenummerfältet 3. Klicka på Sök eller avsluta inmatningen i födelsenummerfältet med ett Enter 4. Finns posten visas födelsenumrets ändringsdatum (senaste uppdateringen via banksynk) samt motsvarande födelsenummer och ändringsdatum i den andra banken. Om posten inte finns visas ett felmeddelande som försvinner då man klickar på det. Ändra en post 1. Sök efter den post som ska ändras 2. Kontrollera att det är rätt post som visas med avseende på de olika bankerna. 3. Gör önskade förändringar i fälten för ändringsdatum. Datumet ska vara på formatet ÅÅÅÅ-MM-DD TT:MM samt vara ett datum som man kan hitta i en kalender. Om formatet är fel eller om man t ex matat in 2000-02-31 12:12 så får man ett felmeddelande. 4. Klicka på Spara och bekräfta att posten ska sparas med OK i dialogrutan som kommer upp 15
Visa tabell Ta bort en post 5. Sök efter den post som ska raderas 6. Kontrollera att det är rätt post som visas med avseende på de olika bankerna 7. Klicka på Radera och bekräfta att posten ska raderas med OK i dialogrutan som kommer upp Lägga till en post 1. Sök efter posten som ska läggas in och kontrollera att den inte redan finns 2. Klicka på Spara och bekräfta att en ny post ska läggas in. Födelsenumret man har angivit i sökfältet kommer nu att visas i fältet för den bank man valt och alla andra fält kommer att öppnas för editering. 3. Fyll i de tomma fälten med önskad information 4. Klicka på Spara och bekräfta att posten ska sparas med OK i dialogrutan som kommer upp Genom att markera en synkronisering och välja Visa tabell under menyn Tabell visas aktuell översättningstabell i ett nytt fönster. Figur 13 - Tabellformulär Information om vad som visas i Tabell-rutan finns längst upp i fönstret tillsammans med hur många rader i taget som visas samt totalt antal poster i tabellen. 16
Nästa Visar nästa uppsättning av poster till dess att det inte finns fler poster att visa. Till fil Öppnar en dialogruta med en förfrågan om namnet på den textfil man vill skriva hela tabellen till. Filen kommer med automatik att hamna på hemmakatalogen för den som kör programmet. Filnamnet får inte innehålla tecknen "/", "\", "-" eller " " (mellanslag). Avbryt Stänger fönstret. Skapa ny körning Öppna den synkronisering för vilken en ny körning ska göras. Därefter väljs Ny under menyn Körning. Ny går endast att välja om den föregående körningen är helt avslutad d v s är lyckad, misslyckad eller onödig. Figur 14 - Fönster för ny synkroniseringskörning Följande information finns att utläsa Satellitbank banknamn på satellitsidan Beställning den beställning som används för utcheckning Domän den domän där satellitbanken återfinns Hämta flyttfil knapp för manuell hämtning av en flyttfil Huvudbank namn på den bank där incheckning ska göras 17
Beställning Domän Hämta kvittofil Skapad av Status Log Till fil namn på den beställning som används för incheckning namn på den domän där huvudbanken återfinns knapp för manuell hämtning av en kvittofil signatur på den person som skapade körningen status som visar hur långt synkronisering hunnit och hur det gått textfönster som visar statistik och resultat på hur de olika faserna går knapp som möjliggör att skriva loggen till en textfil Arkiv Denna meny har missvisande namn och kommer att ändras i senare version. Det enda som finns under denna meny är Avsluta som stänger fönstret. Visa Figur 15 - Möjlighet att visa olika typer av loggar och temporära data finns Synkroniseringslog Fellog Temporär tabell standardval som visar hur körningen går i loggfönstret. Detta val går endast att göra om felloggen visas växlar loggfönstret till att visa felaktiga poster om sådana finns öppnar ett tabellfönster som visar hur den temporära översättningstabellen ser ut. Den temporära tabellen existerar under Fas1, Incheckningsfasen och större delen av Fas 2. Fönstret har samma funktionalitet som beskrivits i "Visa tabell" 18
Utför Figur 16 - Meny för de fyra steg som en synkroniseringskörning består av Med hjälp av denna meny utför man i specifik ordning de olika steg som ingår i en synkroniseringskörning: Påfyllning Fas1 Incheckning Fas 2 tar kontakt med satellitbanken och beställer alla förändringar som skett sedan senaste körningen. Resultatet blir en flyttfil som hämtas till synkroniseringskatalogen. Denna funktion går endast att välja om status är Registrerad kontrollerar den hämtade flyttfilen och översätter alla poster som är nya eller förändrade enligt synkroniseringstabellen. Översättningen lagras i en temporär synkroniseringstabell och de översatta posterna skrivs till en ny flyttfil. Denna funktion går endast att välja om status är Registrerad eller Påfyllningsfasen tar kontakt med huvudbanken och skickar dit den översatta flyttfilen som sedan checkas in i banken. Den kvittofil som skapas vid en lyckad incheckning hämtas till synkroniseringskatalogen. Går endast att välja om status är Fas 1 kontrollerar kvittofilen och fyller i den temporära tabellen utifrån de resultat som finns i kvittofilen. Om alla poster i temporärtabellen är korrekt uppdaterade överförs posterna till den stora synkroniseringstabellen. Den temporära tabellen tas sedan bort. Denna funktion går endast att välja om status är Fas 1 eller Incheckningsfasen 19
Utföra en synkroniseringskörning Skapa en ny synkroniseringskörning och gå igenom de fyra faserna steg för steg. Om en synkronisering har misslyckats går det inte att fortsätta köra någon av faserna även om man rättat felet. I de fallen måste man avsluta körningsfönstret och skapa en ny synkroniseringskörning. Eftersom filerna från föregående körning ligger kvar i synkroniseringskatalogen räcker det med att göra om de steg som är nödvändiga vilka ofta är Fas 1 och Fas 2. Påfyllningfasen Välj Påfyllning under menyn Utför. Fyll i användarnamn och passord för den synkroniseringsanvändare som påfyllningsbeställningen tillhör i den dialogruta som kommer upp. Klicka på OK. Figur 17 - Lyckad påfyllning Vid t ex misslyckade körningar eller om klienten har tappat kontakt med servern så har påfyllningen redan gjorts och det enda som behöver göras är att hämta den flyttfil som ligger i beställningen. Istället för att köra påfyllningsfasen klickar man då på knappen vid Hämta flyttfil och fyller i användarnamn och passord på samma sätt som ovan. 20
Ibland kan det inträffa att man vill köra påfyllningen över en längre tidsperiod än vad som gått sedan senaste körningen. För att göra detta måste själva beställningen backas med avseende på tid i BankIR-systemet. Eftersom det ännu inte finns stöd för detta via synkroniseringsverktyget ska detta utföras av en synkroniseringsansvarig med BankIR-kunskap. Fas 1 Då flyttfilen som ska översättas finns i synkroniseringskatalogen välj Fas 1 under menyn Utför. Kontroller och översättning till ny flyttfil kommer då att göras och övriga alternativ kommer att bli valbara i menyn. Figur 18 - Lyckad Fas 1 Om fasen misslyckas beror detta ofta på att det finns poster i flyttfilen som pekar på andra poster som vare sig finns i synkroniseringstabellen eller i flyttfilen. Orsaken till felet ska undersökas och om det krävs får flyttfilen från påfyllningsfasen manuellt manipuleras genom att lägga till poster eller ta bort poster ur den. Därefter måste en ny synkroniseringskörning skapas och Fas 1 ska åter köras (påfyllningsfas behöver alltså inte göras). Eftersom det endast är användaren gdbadm som har rätt att skriva i synkroniseringskatalogen kan det krävas att manipulationen görs i satellitbankens beställningskatalog. Innan man kör första fasen ska man då manuellt hämta flyttfilen så som är beskrivet i Påfyllningsfasen. 21
Incheckningsfasen Välj Incheckning under menyn Utför för att checka in den översatta filen i huvudbanken. Återigen kommer en passordsdialog upp som ska fyllas i och därefter bekräftas med OK. Figur 19 - Lyckad Incheckning Det händer ibland att incheckningsfasen misslyckas p.g.a. att originalposten i huvudbanken har ändrats, en post har felaktiga pekare eller att incheckningen tar så lång tid att klienten tappar kontakten med servern. Oavsett vad som är fel måste en ny synkroniseringskörning skapas och första fasen måste köras igen på den flyttfil som ska checkas in/har checkats in. Om felet berodde på tappad kontakt mellan server och klient så har ofta incheckningen lyckats och då ska man inte göra om incheckningsfasen. Istället hämtas kvittofilen genom att man klickar på knappen bredvid fältet Hämta kvittofil och fyller i den passordsdialog som kommer upp. Fas 2 Då incheckningen är klar och en kvittofil finns i synkroniseringskatalogen är det dags att fullborda synkroniseringskörningen genom att välja Fas 2 under menyn Utför. 22
Figur 20 - Synkroniseringen lyckad Då körningen väl har nått stadiet att andra fasen ska köras brukar det sällan bli något fel. Synkroniseringskörning från prompt Det går att automatiskt göra en synkroniseringskörning utan att behöva starta verktyget. Genom att starta banksynk med ett antal parametrar körs alla fyra faserna i en synkroniseringskörning. Genom att skriva följande kommando vid prompten eller låta ett cronjob starta det kan man automatisera synkronsieringskörningarna. banksynk <satellitbank> <satellitdomän> <synksign> <huvudbank> <huvuddomän> <synksign> <e-mail> Synkroniseringsförhållandet måste redan vara skapad via verktyget och det måste finnas en fil innehållande passord och användarnamn i synkroniseringskatalogen. Den eller de som ska få loggarna som programmet generar ska skrivas in som sista argument. Observera att om flera ska få loggarna ska mailadresserna skiljas med ett komma-tecken utan omgivande mellanslag d v s aa.aa@aa.aa,bb.bb@bb.bb,cc.cc@cc.cc 23
SYSTEMADMINISTRATION Systemet består av en synkroniseringstabell, en klientdel och en serverdel. Därutöver utnyttjas tidigare utvecklade BankIRfunktioner för utcheckning och incheckning via BankIR-beställningar. Systembeskrivning Synkroniseringstabell och synkroniseringskatalog För varje par av banker som skall synkroniseras, skapas en synkroniseringstabell. Tabellen är egentligen en databas i vilken all synkroniseringsdata lagras. För varje detalj som delas mellan två banker finns en post i tabellen. Varje post består av fyra fält. Två fält används för satellitsidan och två fält för huvudsidan i synkroniseringen enligt följande struktur. Satellitbanksdata Huvudbanksdata Födelsenummer (sfnr) Ändringsdatum (sdat) Födelsenummer (hfnr) Ändringsdatum (hdat) 1510400 19981027 13590710 19990115 Födelsenummer - Detaljens födelsenummer i banken. Ändringsdatum - Detaljens senaste ändringsdatum i banken. För att skapa en synkronisering, d v s en synkroniseringskatalog och en synkroniseringstabell, används synkroniseringsverktyget (se Användarhandledning). Placeringen av katalogen och tabellen styrs av programmet och lagringen sker under /opt/gdb/synk. Namnet på katalogen styrs av bank- och domännamn enligt normen, <satellitbanknamn>_<domän>_to_<huvudbanknamn>_<domän>. Om ajourhållning skall vara dubbelriktad skapas först förhållandet satellitbank-> huvudbank och därefter huvudbank -> satellitbank. Samma fysiska katalog används för båda synkroniseringsriktningarna. Vid synkroniseringskörningarna kopieras de flyttfiler och kvittofiler från respektive BankIR-beställning till synkroniseringskatalogen där även synkroniseringstabellen ligger. Notera: I synkroniseringskatalogen lagras en passordsfil som används vid automatisk körning. Passordsfilen måste av säkerhetsskäl ha begränsade rättigheter, annars stoppar synkroniseringsprogrammet automatiskt körningen. 24
Synkroniseringskörning En synkroniseringskörning består av fyra moment: påfyllning, fas1, incheckning och fas2. Medan en synkroniseringskörning pågår sker allt arbete i en temporär synkroniseringstabell. Detta för att man skall kunna "backa" en felaktig körning. Sist i fas 2 - då programmet bekräftat att körningen gått bra - förs data över till den "riktiga" synkroniseringstabellen. Påfyllning Påfyllningen körs i satellitbanken och datafilen (flyttfilen) förs sedan över till synkroniseringskatalogen. Påfyllningsfasen görs i följande steg: Uppkoppling mot servern. Användaridentitet och passord skickas till servern. Domän väljs. Bank väljs. Beställning väljs. Beställningen (påfyllning) körs. Flyttfilen hämtas och läggs i synkroniseringskatalogen. Felfilen hämtas och läggs i synkroniseringskatalogen. Flyttfilen och felfilen raderas från beställningskatalogen. Nedkoppling Fas 1 I första fasen läses flyttfilen och en temporär tabell byggs upp enligt följande ordning: 1. Läs en detalj från flyttfilen. 2. Finns detaljens födelsenummer i den ordinära tabellen? Ja: Om adat i flyttfilen > än sdat skrivs den till den temporära tabellen med sdat = flyttfilens adat. Om adat i flyttfilen < sdat så har ett fel uppstått. Om adat i flyttfilen = sdat så är posten oförändrad och ignoreras. Nej: Skriv till den temporära tabellen med: sfnr = flyttfilens födelsenummer. sdat = flyttfilens adat. hfnr = preliminärt födelsenummer. hdat = 0 3. Översätt kopplingar m h a synkroniseringstabellen, flyttfilen och den temporära tabellen. Skulle inte kopplingen finnas någonstans så har ett fel uppstått. 25
4. Om inget fel har inträffat skrivs detaljen till den nya flyttfilen med översatta födelsenummer och adat. Incheckning Incheckningen körs i huvudbanken och samtliga filer förs över med hjälp av servern. Uppkopplingen görs i följande steg: 1. Uppkoppling mot servern. 2. Användaridentitet och passord skickas till servern. 3. Domän väljs. 4. Bank väljs. 5. Beställning väljs. 6. Flyttfilen som skapades i Fas 1 skickas till beställningen. 7. Beställningen körs (incheckning). 8. Kvittofilen hämtas och läggs i synkroniseringskatalogen. 9. Felfilen hämtas och läggs i synkroniseringskatalogen. 10. Felfilen raderas från beställningskatalogen. 11. Nedkoppling. Fas 2 I fas 2 läses kvittofilen som skapades vid incheckningen. Informationen används för att uppdatera den temporära synkroniseringstabellen. Detta sker enligt följande mönster för varje kvittenspost i flyttfilen: Finns detaljen i den temporära tabellen? Ja: Om födelsenumret är ett permanent födelsenummer ändras huvudsidans adat i temporärtabellen till det som står i kvittensposten. Har posten fått ett permanent födelsenummer byts även det preliminära födelsenumret ut för huvudsidan. Om den har ett preliminärt födelsenummer har vi ett fel uppstått. Nej: Rapportera ett fel. Då alla poster i kvittofilen har behandlats kontrolleras den temporära tabellen. Finns det fortfarande poster kvar med preliminära födelsenummer rapporteras dessa via felloggen, annars flyttas alla poster över till den ordinarie synkroniseringstabellen. Den temporära tabellen tas bort om körningen är lyckad. För automatkörningar sänds avslutningsvis loggningsfilerna för de olika momenten, via e-mail, till synkroniseringsansvariga. Synkroniseringsverktyget Ett grafiskt användargränssnitt som kan användas för att skapa nya synkroniseringar, skapa/köra synkroniseringskörningar, radera körningar, titta i och editera synkroniseringstabellen. 26