KONFIGURATIONS ADMINISTRATIONSPLAN 1. INTRODUKTION Den här mjukvarukonfigurations administrationsplanen (MKAP) beskriver hur artifakterna för projektet SYSTEM X skall hanteras. 1.1 Förkortningar KO: Konfigurationsobjekt - ett objekt som hanteras av konfigurationssystemet. KA: Konfigurationsadministration - Processen för hantering och underhåll av aktuella versioner i projektet. MKA: Mjukvarukonfigurations administration. MKAP: Mjukvarukonfigurations administrationsplan (det här dokumentet). CVS: Concurrent Versions System - Versionshanteringsverktyg. 1.2 Terminologi Artifakt: En produkt av projektet. Till exempel dokument, källkod eller testresultat. 2. REFERERADE DOKUMENT Projektplanen för projektet SYSTEMX, revision B. 3. MKA ADMINISTRATION 3.1 Organisation Hårdvaruadministratören antar rollen som "konfigurationsledare" för det här projektet. 1
3.2.1 Konfigurationsledare Konfigurationsledaren skall ansvara för att organisera och styra all form av KA. Han eller hon skall även underhålla detta dokument (MKAP). Konfigurationsledaren är dessutom ansvarig för installationen och underhållet av KA-verktygen specificerade i avsnitt 3.3. 3.2.2 Tekniker Det är varje teknikers skyldighet att följa de regler och direktiv som konfigurationsledaren publicerar. 3.3 Policies, direktiv och procedurer 1.Varje aktuell och tidigare publicerade KO kommer att bevaras. 2.Alla inblandade i projektet bör ha tillgång till befintliga KO vid varje tillfälle. 3.Projektet Bilspel kommer använda sig av verktyget Concurrent Versions System (CVS) 1.11, för versionshantering. 4.Arkivering kommer att ske med hjälp av CVS. 5.Intern revisionshantering kommer att ske med hjälp av CVS. 4. SCM AKTIVITETER 4.1 Konfigurationsidentifiering 4.1.1 Indentifiera konfigurationsobjekt Identifiering av olika KO skall ske i samförstånd mellan projektgruppens alla medlemmar. 4.1.2 Namngivning av konfigurationsobjekt Konfigurationsledaren skall ha ansvar för namngivningen av alla KO. Filnamnskonventionen skall vara som följer: 1.Root biblioteket ska heta smd114. Underbibliotek för lagring av specifika KO, eller samlingar av sådana, döps i enlighet med innehållet. 2
2.Officiellt publicerade KO döps enligt namn-r.xxx, där R svara mot det officiella revisionläget R. 3. Officiellt publicerade utkast av KO döps enligt namn-prn.xxx där R svara mot det officiella revisionsläget som KO förväntas uppnå, medan N är ett heltal som talar om i vilket steg mot ett officiellt slutgiltigt revsionsläge som dokumentet befinner sig. Specifika revisionslägen, för enskilda KO, både för nuvarande och tidigare officiella revisioner av projektet markeras i CVS:et med hjälp av så kallade tags. 4.1.3 Tillhandahållning av konfigurationsobjekt Tekniker tillhandahåller KO, för modifiering, genom att "checka ut" dem från CVS förvaringsplatsen. En tekniker får aldrig förmedla ett KO till någon annan direkt. 4.2 Konfigurationskontroll 4.2.1 Begäran av förändring 4.2.2 Utvärdering av förändringar 4.2.3 Godkänna eller avvisa förändringar 4.2.4 Implementation av förändringar 4.3 Bokföring av konfigurationsstatus Konfigurationsledaren skall se till att konfigurationsinformationen på projekthemsidan hålls uppdaterad. En sammanfattning skall publiceras minst en gång i samband med ett milstolpemöte med beställaren. Logfiler från CVS kan fungera som fullvärdiga sammanfattningar. 3
4.4 Konfigurationsgenomgång och granskning 4.5 Gränssnittskontroll 4.6 Underleverantör 5 MKA SCHEMA För schema över publikantionstillfällen se tidsplanen i projektplanen för projekt Bilspel. 6. MKA RESURSER Konfigurationsledaren kommer avsätta nödvändig tid för att underhålla systemkonfigurationen. 7. MKAP UNDERHÅLL För att bibehålla och, och fortsatt sträva, mot en så hög stabilitetsnivå som möjligt på MKAP:en så ska konfigurationsledaren göra följande: 1.Uppskatta förluster till följd av brister i den här planen. 2.Studera dokumentation för CVS. Föreslå specifika förändringar av den här KM processen. 8. Dokumentregler Under den här rubriken definieras alla de regler som bör gälla för de dokument som ska produceras. Färdigt skrivna dokument kommer att granskas innan de lämnas in. Följande regler kommer att tillämpas: Alla dokument kommer att skrivas i en redan definierad dokumentmall. Framsidan ska vara väl formulerad med dokument namn, projekt namn, osv. Brödtext ska skrivas som Normal med Times New Roman stil i storlek 12. Huvudrubrik skrivs som Rubrik 1 med Arial fet stil i storlek 16. Underrubrik skrivs som Rubrik 2 Arial kursiv och fet stil i storlek 14. 4
Dokumentlista Under vår projekt kommer vi att ha följande dokument: Kravspecifikation. Progressdokument för varje vecka. Manual O.s.v. (om vi tycker att flera dokument behövs ska de läggas in i efterhand). Eller se annat dokument Verktyg För att undvika missförstånd och för att erhålla ett enhetlig standardutseende stipuleras att följande verktyg skall användas för dokumentproduktion och hantering. Dokument ska skrivas i Microsoft Word programmet. Dokument kommer även att vara tillgängliga i pdf-format, m.h.a. Adobe Acrobat. Generell dokumentationshantering Sidhuvudet enligt standard ska finnas med i alla dokument. Vid ändringar ska orsak och ansvarig anges, samt annan information (i sidhuvudet) uppdateras. All aktuell och godkänd dokumentation ska finnas att tillgå via projektets webbsida. Den som iordningställt dokumentet bör själv behålla en kopia som backup i pappersformat, även gärna på dator. Revisionsnumrering enligt standard..xyz. Projektets webbsida För projektets webbsida ansvarar informations ansvarige Ny information bör tillfogas den redan existerande informationen, så att det är möjligt att återskapa en tidigare version. Underlaget kommer att finnas på två separata datorer. E-mail Alla projekt medlemmar bör delges information som berör hela projektet. Viktiga e-mail bör lagras tills dess att projektet är avslutat. Maillistor upprättas av 5