Opsummering af review af Nyt BBR Review af dokumentation, kildekode og miljø til nyt Bygnings- og Boligregister (BBR) 10. september, 2014 (Version 1.0) Review-team: Bent Bilstrup, btb@lakeside.dk Christian Gasser, chg@lakeside.dk Christian Ernstsen, che@lakeside.dk Anni Markussen, anni@lakeside.dk Review-periode: Juni 2014 August 2014 Kontaktpersoner KOMBIT: Henrik Povlsen Christina Hostrup Stærke Kontaktperson leverandør (KMD): Charlotte Bech-Madsen
Overordnede konklusioner Generel vurdering Reviewet af Nyt BBR giver indtryk af et it-system, der altovervejende og på det generelle niveau er yderst veldokumenteret og også er blevet forvaltet og løbende vedligeholdt siden udvikling og idriftsættelsen. En overdragelse til en eventuel anden, ny leverandør i forbindelse med et genudbud af Nyt BBR ser således ikke ud til at blive forhindret af det nuværende dokumentationsniveau eller den generelle kvalitet af dokumentationen. Dog vil en styrkelse og opdatering af systemdokumentationen og den støttende dokumentation til udviklingsmiljøet i væsentlig grad forenkle og accelerere en systemoverdragelse. Metode Reviewet har kritisk gennemgået den eksisterende dokumentation, i det som den nuværende leverandør (KMD) har anset som den nyeste og mest opdaterede version, ligesom selve kildekoden er blevet reviewet. Endvidere er den nuværende leverandør blevet interviewet. Dels for at besvare opklarende spørgsmål og dels demonstrere at kompetencesættet omkring BBR-løsningen er intakt. Reviewets overordnede konklusioner Nyt BBRs generelle (forretnings- og domæneorienterede) dokumentation er i overvejende rigtig god stand. Kildekode og udviklingsmiljø er dokumentationsmæssigt i meget begrænset omfang understøttet. Centrale tekniske og udviklerrettede guides og vejledninger bør udarbejdes til at støtte en evt. overdragelse af Nyt BBR. Systemdokumentationen bør opdateres og tage udgangspunkt i dette reviews forslag til rework (primært opdateringer og revideringer). Det vil være nødvendigt at håndhæve de kontraktmæssige forpligtigelser for den nuværende leverandør til aktivt at støtte op omkring en transition til en ny leverandørkontekst. Der bør derfor formuleres forslag til organisering og aktiviteter til at sikre denne transition.
Formål med reviewet Primært formål Det primære formål er at vurdere, om it-løsningen det nye BBR er i en tilstand hvor løsningen rent teknisk kan overdrages til en anden leverandør f.eks. ved genudbud: Er kontraktens krav til åbenhed, dokumentation og overdragelighed tilgodeset? Er dokumentationen fyldestgørende og retvisende? Er kildekoden velstruktureret og arkitekturmæssig sund? Er der bindinger til den nuværende leverandørs (KMD) drifts- og udviklingsmiljø der står i vejen for eller besværliggør en eventuel overdragelse? Det er heraf afledt, at vurderingen også indeholder anbefalinger til korrigerende aktiviteter ( ) på punkter, hvor løsningen i form af dokumentation, kildekode eller miljøbeskrivelser vurderes ikke at være overdragelig i tilstrækkeligt omfang. Sekundært formål Reviewet vil påpege og foreslå yderligere kvalificerende aktiviteter, der kan sikre en bedre, hurtigere eller mere sikker overdragelse til en ny leverandør. Udenfor scope Det ligger uden for dette reviews scope at vurdere løsningens forretningsmæssige eller funktionelle performance dvs. hvor godt Nyt BBR-løsningen løser den domænespecifikke opgave omkring opdatering og registrering af BBRoplysninger. Det ligger også udenfor dette reviews scope at vurdere BBR-løsningens non-funktionelle performance dvs. generelle ydelse, svartider eller ressourceudnyttelse.
Metode og proces: Reviewmetoder Metodemæssigt har reviewforløbet taget udgangspunkt i et traditionel Fagan-inspektion samt ISO standard 25010 (Systems and software Quality Requirements and Evaluation), med speciel fokus på områderne i standarden omkring maintainability og portability capabilities. Endvidere er tjeklisten fra Lakesides egen kvalitetshåndbogs omkring overdragelsesreview blevet anvendt. Hovedaktiviteter Review af eksisterende dokumentation med henblik på vurdering af kvalitet og egnethed for overdragelse til evt. ny systemleverandør. Reviewet har taget udgangspunkt i 5 overordnede kriterier: 1. 2. 3. 4. 5. Opfylder dokumentationen de formelle krav? Er den relevant i forhold til målgruppen? Er dokumentationen fyldestgørende? Er dokumentationen forståelig? Er dokumentationen retvisende? Kvalitative interviews af relevante ressourcer hos nuværende leverandør med henblik på at vurdere og kvalificere særlige områder omkring f.eks. arkitekturvalg, byggemiljøer og konfiguration af udviklings-, deployment- og driftsmiljøer. Gennemgang af kildekode og udvidede stikprøver for at validere at kodemoduler, snitflader, datamodeller etc. er i overensstemmelse med dokumentationen og at strukturering af kildekoden er hensigtsmæssig.
BBR-reviewets dokumentationsgrundlag BBR-reviewet har gennemgået den samlede generelle og tekniske dokumentation og kildekode, som den nuværende leverandør har stillet til rådighed. Dette dokumentationsgrundlag har et omfang af ca. 2200 siders dokumentation *) fordelt over forskellige kategorier (se oversigt til højre) samt naturligvis kildekoden og evt. vejledninger til udviklingsmiljøet. Denne dokumentation henvender sig bredt til en række interne og eksterne interessenter. På den efterfølgende side er der udarbejdet en infographic, der illustrerer den samlede dokumentations sammensætning, fordeling i forhold til målgrupper og behov for rework i forhold til en sikker overdragelse til evt. ny udviklings- og driftsleverandør. *) Der er under de kvalitative interviews på foranledning af reviewernes opklarende spørgsmål frembragt yderligere enkelte stykker systemdokumentation og rapporter, der dog ikke er medtaget i denne oversigt. Antal sider dokumentation (tilnærmet) Arkitektur og Design 7 Brugerdokumentation 460 sdokumentation 338 Krav 135 Overblik 318 Systemdokumentation 903 Test og Performance 41 Ialt 2202 Kildekode 2 Visual Studio Solutions opdelt i et antal områder
Resultat af overtagelsesprøv Leverancekontrakt e februar 2012 Kapitel 1 - Indledning kapitel 12 - Ændringer Resultat af overtagelsesprøv skontrakt e februar 2012 Resultat af overtagelsesprøv shåndbog e februar 2012 Installationsvejledning til Net Applikationsserver Installationsvejledning til Net Webserver Installationsvejledning til databaseserver Resultat af Resultat af overtagelsesprøv overtagelsesprøve e februar 2012 februar 2012 Resultat af Kontrakt overtagelsesprøv e februar 2012 kapitel 12 - Ændringer - Udadvendt Change Log sdokumentation Kode, test og performance Stress-test - rapporter og vejledninger Leverancekontrakt Bilag 2 - Kravspecifikation Overblik Performancetest - rapporter og vejledninger Kapitel 11 - Overensstemmelses matrix krav systembeskrivelse Krav Nyt BBR Generelt overbliksdokument over kildekoden Kapitel 3 - Forretningslogik Udviklerdokumentation Byggevejledning Kapitel 6 - Dataudveksling Systemdokumentation Brugerdokumentation Vejledning til opsætning af udviklingsmiljø Bilag til kap 6: Energidata ind i BBR Kapitel 7 - Datamodel Kapitel 8 Administrationsdatabase Kapitel 9 - Sikkerhed Vejledning til snitfladen: AddressGeometry- Service Arkitektur og design Kapitel 2 - Systemarkitektur Kapitel 4 - Brugerdialog Kapitel 5 - Udskrifter til borgerne Kapitel 10 - Rapporter BBR Adresser Adresser BOB Brugeradministration Generelt Inddataboks Meddelelse Rapporter Systemadministration Vejledning til kommandolinjescripts Guide til videreudvikling Kendte fejl og mangler Signaturforklaring Dokument Dokument Dokument med med bilag bilag [Dokumenter der burde være der]
Læsevejledning - Infografik Viser hvilke målgrupper dokumentationen henvender sig til samt hvor mange sider det drejer sig om. Jo større cirkel, jo flere sider. Antal sider dokumentation er angivet i cirklen. Viser den forholdsmæssige fordeling af dokumentationen i områder / kategorier. Antal sider kan aflæses i skalaen i højre side. Viser hvilke områder i dokumentationen, der vurderes til at have behov for rework / opdatering, hvor påtrængende behovet er samt en indikation af omfang. Cirkel placeret i den røde ende af skalaen = stort behov for revision/rework. I den grønne del = intet eller meget lille behov for rework. Cirklens størrelse angiver omfang og antallet af sider er angivet i midten af cirklen. Detaljering af dokumentationens sammensætning, eventuelle mangler samt forslag til rework.
Systemdokumentation Krav Overblik Brugerdokumentation Arkitektur & design 42 Test & performance sdokumentation 318 135 272 135 338 55 903 7 42 129 7 460 7 Udviklerdokumentation 33 41 291 41 265 903 Orientering 338 41 318 K1 - Indledning K12 - Ændringer Leverancekontrakt + bilag 1-22 Kontrakt KMD-BBR + bilag 1-13 K11 - Overenstemmelsesmatrix krav systembeskrivelse Leverancekontrakt - K2 - Systemarkitektur - K3 - Forretningslogik K4 - Brugerdialog + bilag K5 - Udskrifter til borgerne K10 - Rapporter (Systembeskrivelse) K6 - Dataudveksling + bilaget Systemdesign for Energidata ind i BBR K7 - Datamodel + bilaget Table Report K8 - Administrationsdatabase K9 - Sikkerhed Vejledning til snitfalden: AddressGeometryService Sæt af 8 manualer - Meget begrænset Meget begrænset Meget begrænset Indadvendt 460 7 135 Udadvendt changelog Udadvendt Væsentlige behov for opdateringer og tilføjelser Meget begrænset Webapplikation baseret på Microsoft.NET plalform 2 projekter (server og klient) Struktureret i et antal Visual Studio projekter (30+) Performancetest - rapporter og vejledninger Generelt overbliksdokument over kildekode Byggevejledning Vejæedning til opsætning af udviklingsmiljø Vejledning til kommandolinjescripts Guide til videreudvikling Kendte fejl og mangler Meget omfattende Resultat af overtagelsesprøve 2012 for performancetest, stresstest, m.v. Væsentlige behov for tilføjelser shåndbog for Nyt BBR skontrakt samt bilag Installationsvejledning for Nyt BBR Applikationsserver Installationsvejledning for nyt BBR Webserver Installationsvejledning til databaseserver Væsentlige behov for opdateringer og tilføjelser
Udsnit af infografik, der dækker reviewområdet af systemdokumentationen Overordnet delkonklusion på reviewet af system og dokumentation Hvilket område reviewet dækker Review af Overblik Den overordnede dokumentation og den forretningsvendte del af kontraktmaterialet giver et godt overblik over baggrunden for og behovskataloget bag Ny BBR-løsningen. Forslag og indstilling til rework / revidering af dokumentation og systembeskrivelse. Indstillinger til rework er angivelser af områder eller initiativer, som reviewteamet vurderer er nødvendige at styrke for at en sikker systemoverdragelse kan gennemføres. er netop forslag - initiativer der kunne styrke en evt. overdragelse af systemet, men som ikke er strengt nødvendige. Indstillinger til rework Det vil klart styrke overdrageligheden, hvis det nuværende meget detaljerede, internt orienterede ændringsdokument blev omarbejdet til et eksternt orienteret revisionsdokument. Dokumentet kunne med fordel baselines således at det kun indeholdt de væsentligste ændringer for de sidste 3-4 versioner og at historikken blev vendt om i forhold til det nuværende, således at change loggen fulgte Nyt BBR løsningens versionering og angav de nyeste versioner først. Det vurderes at dette produkt kunne frembringes med en mindre indsats ved at redigere det foreliggende dokument - Kapitel 12 - Ændringer. Dokumentet kunne med fordel have en decideret læse-vejledning, der i forhold til de nævnt målgrupper udpegede relevante områder. Dette kunne evt. støtte sig op ad en (grafisk) oversigt over løsningsdokumentationen, der kunne styrke overblikket af dokumentationen. Kravene til anvendelse af åbne standarder og fælles-offentlige arkitektur-principper, har siden denne kontrakts indgåelse flyttet sig en del ud over snitflader beskrevet med OIOXML (F.eks. snitflader rettet mod integration og udveksling med FESD-løsninger. Således bør Nyt BBR med udgangspunkt i Leverance-kontrakten (især bilag 2 Kravspecifikation) fremadrettet forholde sig eksplicit til Digitaliseringsstyrelsens opstilling af 7 sæt af obligatoriske åbne standarder.
Overblik 42 42 272 318 318 K1 - Indledning K12 - Ændringer Leverancekontrakt + bilag 1-22 Kontrakt KMD-BBR + bilag 1-13 Udadvendt changelog Review af Overblik Meget begrænset Den overordnede dokumentation og den forretningsvendte del af kontraktmaterialet giver et godt overblik over baggrunden for og behovskataloget bag Ny BBR-løsningen. Indstillinger til rework Ingen Overbliksdokumentationen (de enkelte dokumenter) kunne med fordel have en decideret læsevejledning, der udpeger relevante områder i forhold til de nævnte målgrupper. Dette kunne evt. støtte sig op ad en (grafisk) oversigt over løsningsdokumentationen, så læserens overblik styrkes. Kravene til anvendelse af åbne standarder og fællesoffentlige arkitekturprincipper, har siden denne kontrakts indgåelse flyttet sig en del ud over snitflader beskrevet med OIOXML (f.eks. snitflader rettet mod integration og udveksling med FESD-løsninger). Således bør Nyt BBR med udgangspunkt i Leverance-kontrakten (især bilag 2 Kravspecifikation) fremadrettet forholde sig eksplicit til Digitaliseringsstyrelsens opstilling af 7 sæt af obligatoriske åbne standarder. Det vil klart styrke overdrageligheden, hvis det nuværende meget detaljerede, internt orienterede ændringsdokument blev suppleret med eller omarbejdet til et eksternt orienteret revisionsdokument. Dokumentet kunne med fordel baselines således at det kun indeholdt de væsentligste ændringer for de sidste 3-4 versioner og at historikken blev vendt om i forhold til det nuværende, således at change loggen fulgte Nyt BBR løsningens versionering og angav de nyeste versioner først. Det vurderes at dette produkt kunne frembringes med en mindre indsats ved at redigere det foreliggende dokument - Kapitel 12 - Ændringer.
Review af Krav Krav 135 135 Krav og opgaver som Nyt BBR skal løse fremstår veldokumenterede, klare og strukturerede. I sagens natur kan en kravspecifikation ikke opdateres, men i forbindelse med et evt. nyt udbud af Nyt BBR og eventuelt nye og opdaterede krav vil det være en stor fordel om der blev taget aktivt stilling til Digitaliseringsstyrelsens opstilling af 7 sæt af obligatoriske åbne standarder. Der er derfor som sådan ikke direkte presserende behov for at revidere denne del af BBRdokumentationen. Indstillinger til rework 135 K11 - Overenstemmelsesmatrix krav systembeskrivelse Leverancekontrakt - Meget begrænset Ingen En læsevejledning vil styrke kravsdokumentationen og gøre det nemmere for nye aktører og interessenter at overskue og forstå denne del af løsningen. En supplerende proces med at opsamle nye og ændre krav til løsningen og løsningens virkemåde kan med fordel baseres på den eksisterende kravsdokumentation.
Review af Arkitektur & Design Arkitektur & design 7 7 7 Beskrivelsen af Nyt BBRs arkitektur og overordnede design er meget kortfattet men vurderes til at være valid. Interview med leverandøren understøtter denne vurdering. Mange beslutninger er bevidst overladt til det underliggende framework (.NET) og platform, ligesom løsningen baserer sig på en traditionel arkitektur for webløsninger. Indstillinger til rework Ingen 7 K2 - Systemarkitektur - Meget begrænset Der savnes en beskrivelse af hvor arkitektur og design fraviger de frameworks, der henvises til, alternativt en eksplicit note om, at der ikke er foretaget modifikationer. I forhold til overdragelighed af systemet giver denne del af dokumentation anledning til overvejelser omkring hvorvidt teknologivalget er fremtidssikkert, idet der refereres til servere og værktøjer med en del år på bagen (IIS 6.0,.NET 3.0, Windows Server 2003 R2, Microsoft SQL Server 2005, m.v.). Den interviewbaserede, kvalitative del af reviewet har også afklaret, at den underliggende teknologi- og driftsplatform løbende er blevet opgraderet. Dette er betryggende og forslaget her går alene på, at dette også afspejler sig i den relevante del af dokumentationen.
Systemdokumentation 55 903 129 33 903 K3 - Forretningslogik K4 - Brugerdialog + bilag K5 - Udskrifter til borgerne K10 - Rapporter (Systembeskrivelse) K6 - Dataudveksling + bilaget Systemdesign for Energidata ind i BBR K7 - Datamodel + bilaget Table Report K8 - Administrationsdatabase K9 - Sikkerhed Vejledning til snitfalden: AddressGeometryService Væsentlige behov for opdateringer og tilføjelser Review af Systemdokumentation Dokumenterne der tilsammen udgør systemdokumentationen til Nyt BBR beskriver dels den domænemodel og forretningslogik, der ligger til grund for BBR samt den datamodel systemet bygger på. Dokumentationen omfatter også de snitflader Nyt BBR udstiller i forhold til eksterne systemer og services. Systemdokumentationen for Nyt BBR er ret omfattende, men mangler opdatering på en række afgørende punkter - især hvis overdrageligheden af løsningen skal sikres. Indstillinger til rework Alle dokumenterne, der udgør systemdokumentationen (se oversigt i figur til venstre) bør som et minimum føres ajour i forhold til de ændringer, der er foretaget på Nyt BBRløsningen over tid i miljø, versioner af komponenter samt snitflader til eksterne systemer. Dokumentationen fremstår langt overvejende fyldestgørende men er næppe helt ajourført. Især da denne systemdokumentation i høj grad også skal støtte udviklerne i at forstå Nyt BBR-løsningen, da kildekoden er ret svagt dokumenteret. Løsningens datamodel er helt central for at forstå løsningens indretning og interne design. Derfor er der et stort behov for sikring af konsistens mellem den beskrevne datamodel (kapitel 7) og øvrige dele af systemdokumentationen, der henviser til eller benytter datamodellen. Under reviewet af kildekoden er det blevet bemærket, at certifikatvalideringen bør undergå en mere detaljeret analyse. Især i forhold til hvordan det bliver valideret, at de certifikater, som løsningens klienter anvender, rent faktisk er OCES-certifikater. Der kunne med fordel udarbejdes en læsevejledning til kapitlet samt tilhørende bilag. F.eks. med en opdeling af brugerdialogen rettet mod forretnings- eller domænebrugere samt bruger- og BBR-administratorer.
Brugerdokumentation 460 Review af: Brugerdokumentation 460 Indstillinger til rework Baggrundsafsnittene (i nogle kaldet Forord e.lign.) i Brugerdokumentationen (alle dokumenter) bør valideres af en domæneekspert med henblik på om henvisninger til regler, bekendtgørelser, cirkulærer, etc. for ejendomsområdet er opdaterede og korrekte. Sæt af 8 manualer - Brugerdokumentationen fremstår generelt fyldestgørende og ganske retvisende. Brugerdokumentationen rummer en stor domæneviden og formidler denne sammen med anvendelsen af Nyt BBR-systemet. Sproget er direkte henvendt til brugeren i alle dokumenter, instruerende og rigt illustreret med skærmbilleder. Bemærk dog at der ikke er foretaget interviews med brugere i forhold til om der savnes yderligere dokumentation. Den eksternt orienterede, brugervendte dokumentation er ganske omfangsrig og rummer en stor domæneindsigt. Selvom brugerdokumentationen som nævnt er eksternt orienteret kan den i et overdragelsescenarie godt tænkes anvendt internt af nye udviklere, der skal forstå BBR-domænet. Meget begrænset Man kunne overveje at dele den brugerrettede dokumentation op i en decideret systemhjælp, der alene dokumenterer og bistår brugeren i den rent anvendelsesmæssige del af Nyt BBR og en superbruger henvendt dokumentation, der rummer mere baggrunds- og domænedokumentation. Det ville dels gøre dokumentationens omfang mere overskuelig og måske enklere at anvende.
Udviklerdokumentation Webapplikation baseret på Microsoft.NET plalform 2 projekter (server og klient) Struktureret i et antal Visual Studio projekter (30+) Performancetest - rapporter og vejledninger Generelt overbliksdokument over kildekode Byggevejledning Vejledning til opsætning af udviklingsmiljø Vejledning til kommandolinjescripts Guide til videreudvikling Kendte fejl og mangler Meget omfattende Review af Udviklerdokumentation Dokumentationen der retter sig mod udviklere samt tekniske profiler hos systemejeren er i det udleverede meget begrænset. Dette stiller en evt. ny leverandør i en situation, hvor der potentielt skal afses betydelige ressourcer til at etablere en viden og et overblik over de nødvendige udviklings-, bygge- og deploymentmiljøer. Kildekoden til Nyt BBR fremstår struktureret i form af Visual Studio Projekter, der hver typisk repræsenterer et modul. Løsningens klient- og serverdel er placeret i separate projekter, der hver er yderligere opdelt i et antal områder. Indstillinger til rework Der bør udarbejdes et generelt overbliksdokument over kildekoden. Dvs. modulernes virkemåde, projekternes indbyrdes relationer og afhængigheder. Der bør udarbejdes en byggevejledning. Både en generel vejledning samt detaljerede bygge-vejledninger for Nyt BBRs komponenter og moduler Der bør udarbejdes en vejledning til opsætning af udviklingsmiljøet Der bør udvikles vejledninger til de kommandolinie-scripts, der knytter sig til BBRløsningens konfiguration, test og deployment. En guide til videreudvikling kan være med til at styrke forståelsen af design- og arkitekturvalg samt generel kurs for løsningen. F.eks. oversigt over hvilke dele eller moduler der har behov for opdatering eller refactoring.
Test & performance 41 41 41 Resultat af overtagelsesprøve 2012 for performancetest, stresstest, m.v. Væsentlige behov for tilføjelser Review af Test & Performance Overordnet set er testmaterialet yderst begrænset i omfang. Det er derfor ikke muligt at afgøre i hvor høj grad kildekoden er systematisk testet, funktionelt og performancemæssigt. Dokumentationen for overtagelsesprøven (test-drejebog, referat af test, test-rapporter etc.) tegner et billede af en tilrettelagt og metodisk overdragelse ligesom dokumentationen har inkluderet dokumentation af løbende udførte loadtests ved idriftsættelse af nye versioner af Nyt BBR. Det bør dog fremhæves, at testrapporten kun i begrænset omfang opfylder det erklærede formål, da testen er udført under uens vilkår: på en udviklermaskine i en konfiguration der er væsensforskellig fra produktionsmiljøet og uden sikring af at forstyrrende processer er stoppet på maskinen på forhånd. Derfor kan testen kun i meget begrænset omfang bruges til at uddrage væsentlige konklusioner om BBR-løsningens opførsel i produktionsmiljøet. Der er ikke noget i dokumentationen eller beskriver en mere mere systematisk eller kodenær testdækning. Reviewteamet har vurderet at dette ikke står i vejen for eller yderligere understøtter et overdragelsesscenarie for løsningen. Man kan også konstatere, at Nyt BBRløsningen i flere år har kørt i meget stabil drift med ganske få fejl og funktionsforstyrrelser. Gennemfør forskellige typer performancetest, hvor relevante egenskaber som skalerbarhed og robusthed af Nyt BBR afdækkes, og eventuelle fejl og mangler bliver identificeret. Resultaterne herfra kan direkte indgå i udarbejdelsen af SLA-aftaler i et overdragelsesscenarie. Der kan med fordel søges inspiration i eksisterende litteratur i forhold til hvordan testforløb specificeres, eksekveres og afrapporteres. (Der er som bilag vedlagt en konceptuel beskrivelse af, hvordan et dækkende test-koncept, kan etableres og eksekveres.) Udarbejd et sæt af unit-tests, så funktionalitet af områder, kodeblokke og algoritmer sikres bevaret (eller bevidst ændret) ved efterfølgende tilføjelser og ændringer.
sdokumentation 338 291 265 338 shåndbog for Nyt BBR skontrakt samt bilag Installationsvejledning for Nyt BBR Applikationsserver Installationsvejledning for nyt BBR Webserver Installationsvejledning til databaseserver Væsentlige behov for opdateringer og tilføjelser Review sdokumentation 1/2 Materialet og dokumentationen omkring driften og systemforvaltningen omkring Nyt BBR er generelt af meget høj kvalitet, og størstedelen af materialet har ikke givet anledning til kommentarer fra reviewteamet. skontrakt og tilhørende bilag udgør tilsammen en yderst fyldestgørende opsamling af information, krav og vilkår omkring driften af Nyt BBR. Materialet er af høj kvalitet og er - målgruppen taget i betragtning - letforståeligt. Materialet kan derfor med fordel bruges som afsæt for krav til en evt. ny driftsleverandør og til at sikre en stabil drift under en eventuel overdragelse. Der er dog beskrevet design- og teknologivalg, der potentielt kan stå i vejen for en overdragelse (f.eks. anvendelse af KMD s inderste sikkerhedszone, og manglende specifikation af protokol for interne services ). Indstillinger til rework Der mangler en beskrivelse af hvilken ITIL-tilgang, der anvendes i driften. KOMBITs krav til sikkerhedspolitikker er indarbejdet med KMD efter de standarder man arbejdede med i 2006-2009 (DS484). En opdateret driftshåndbog må forventes at rette sig mod ISO-21 eller ISO-22. Der udestår angivelse af testmiljøer og vilkår/specifikation for disse. Specifikation af protokol for interne services, samt beskrivelse af hvad det indebærer at anvende KMD s inderste sikkerhedszone. shåndbogen bør opdateres til de aktuelle forhold, og figurtegninger bør opdateres eller kommenteres (så det fremgår eksplicit at der ikke er sket ændringer hvis dateringen af figurerne ligger langt tilbage i forhold til dokumentets overordnede datering). Dokumentet tager udgangspunkt i ITIL processer, og det vil fremme overdrageligheden hvis der blev tilføjet en mere struktureret beskrivelse af hvilke processer og procedurer der anvendes, og hvilke der er fravalgt. Der savnes mere detaljerede procedurebeskrivelser for alle områder, eller specifikke henvisninger til hvor sådanne er placeret, hvis de allerede eksisterer.
sdokumentation 338 291 265 338 shåndbog for Nyt BBR skontrakt samt bilag Installationsvejledning for Nyt BBR Applikationsserver Installationsvejledning for nyt BBR Webserver Installationsvejledning til databaseserver Væsentlige behov for opdateringer og tilføjelser Review sdokumentation 2/2 Installationsvejledningen indeholder en overbliksbeskrivelse af applikationsserveren samt vejledning til installation i form af trinvise gennemgange af processen Den meget kortfattede form kan give anledning til en række praktiske og tekniske spørgsmål, der ikke findes svar til i vejledningen. Den kortfattede form samt fravær af fejlscenarier og udbedringsforslag er en hindrende faktor i forhold til en evt. overdragelse til en ny leverandør. Det vurderes at der forudsættes tavs viden hos udførende part eller adgang til kolleger med kendskab til servicen. Indstillinger til rework: Installationsvejledningerne til både Nyt BBR applikations- og webserver bør ajourføres til nuværende tilstand, både hvad angår installation på aktuelle miljøer og konsistenstjek i forhold til brug af eksterne CPR-services. De indforståede elementer bør udspecificeres så der ikke forudsættes intern KMD-viden. F.eks.: Afsnit 2.1: WM-version angives til Dispensation, egen TDM, men uden angivelse af hvad dette betyder i praksis. Der bør være en angivelse af, hvilke certifikater der skal erhverves, herunder hvilke krav der er til certifikaterne (f.eks. om det er et bestemt CVR-nummer, der skal udstede certifikaterne). Det bør fremgå om testmiljøer og produktionsmiljø adskiller sig fra hinanden og hvordan de adskiller sig. Der bør udarbejdes en lignende installationsvejledning til databaseserveren, som der foreligger til web- og applikationsserver. Test af korrekt installation består alene i at konstatere at servicen kører, og at der ikke er fejl i log og eventlog. En opsamling af kendte fejlscenarier (f.eks. ved opdateringer) ville hjælpe meget på overdrageligheden (og generelt driften af servicen).