RIV Tekniska Anvisningar Livscykelhantering för tjänstekontrakt
| RIV Tekniska Anvisningar Livscykelhantering för nationella tjänstekontrakt
Version 1.3 ARK_0057 2024-09-18 |
Innehållsförteckning
Utgåva | Revision Datum | Beskrivning | Ändringarna gjorda av |
1.0 | 2019-08-28 | första version | Björn Hedman |
1.1 | 2019-09-04 | tagit bort länk till bilaga som inte skulle vara med | Björn Hedman |
1.2 | 2022-09-15 | Utökat beskrivningar och strukturerat om. Lagt till Bilaga 1 med förslag till tillämpningar kring hantering av uppgradering till ny majorversion | Joakim Lundin Björn Hedman |
1.3 | 2024-09-18 | Passat in i ny struktur för RIV-TA Förtydligat rubrik att det avser nationella tjänstekontrakt. Lagt till anvisningens sammanhang, målgrupp och tillgänglighet | Björn Hedman |
1. Inledning
Detta dokument beskriver regelverket RIV Tekniska Anvisningar Livscykelhantering nationella tjänstekontrakt.
1.1 Målgrupp
Denna anvisning riktar sig främst till de som förvaltar nationella tjänstekontrakt men grupperingar som tillhandahåller nationella informationsförsörjningstjänster bör också kunna nyttja den. Anvisningen innehåller rutiner, grundläggande regler och förslag på hur tjänstedomänsförvaltningar bör besluta om regler och hantering kring när tjänstekontrakt uppstår, underhålls samt när förvaltning upphör.
1.2 Syfte
Syftet med denna anvisning är att beskriva en enhetlig hantering kring förvaltning av nationella tjänstekontrakt för att skapa tydlighet i rutiner och kommunikation och därmed underlätta för parter som använder eller planerar att använda tjänstekontrak.
1.3 Tillgänglighet
Detta dokument är publicerat under licensen Creative Commons CC-BY-SA (Sammanfattning - Erkännande-DelaLika 2.5 - Creative Commons ).
Det betyder att du fritt får kopiera, distribuera och skapa bearbetningar av anvisningarna under förutsättning att upphovsmannen Sveriges Kommuner och Regioner anges, men inte på ett sätt som antyder att de godkänt eller rekommenderar din användning av verket.
2. Om livscykelhantering
Livscykelhanteringen och regelverket som beskrivs nedan avser de tjänstedomäner som förvaltas inom Inera (nationella/gemensamma och applikationsspecifika) och avser att förtydliga vad som gäller för slutdatum för support och avveckling. (ofta kallat end of life).
Utöver att användas av tjänstedomänernas förvaltningar så kan även informationsförsörjningstjänster och gemensamma (nationella) tillämpningar följa samma modell. Detta för att hantera sin användning av tjänstekontrakt och avveckling av stöd för versioner och skapa en tydlighet för de parter som ingår i samarbetet. I dessa fall så leder avvecklingen av en version inte nödvändigtvis till att stöd i tjänsteplattformar avvecklas eftersom andra tillämpningar kan ha fortsatt användning av versionen. Det är viktigt att påpeka att parter som tar bort stöd för en viss version också måste uppdatera detta i tjänsteadresseringskatalogen TAK.
Dokumentet beskriver vad som gäller när slutdatum utlysts, men bakomliggande skäl för att utlysa slutdatum, och ta beslut om avveckling, definieras inte i detalj i reglerna. Detta eftersom skälen till detta normalt är domänspecifika.
Observera att det här finns ett visst fokus på livscykeln utifrån tjänstekontraktets förvaltning och dess tillgänglighet i nationella tjänsteplattformen NÄR ett beslut om avveckling har tagits. Processen för beslut om avveckling kan se olika ut beroende på hur utbredd användning som finns för ett visst tjänstekontrakt. Det är heller inget självändamål utifrån domänerna eller tjänsteplattformen att ha så få versioner som möjligt.
För specifika tillämpningar kan det dock finnas vinster i att begränsa antalet parallella majorversioner givet att det kan vara svårt att skapa vettiga tjänster om informationstillgången varierar kraftigt.
Nedan angivna tidsintervall kan utökas men inte minskas, om en domän regelmässigt förlänger tidsintervall så bör detta tydligt beskrivas i en policy för den aktuella domänen så att anslutande parter vet vad som gäller.
Externa förvaltningar (Externa domäner) är fria att själva definiera regler men det är viktigt att dessa dokumenteras tydligt.
Olika typer av nya versioner:
I denna dokumentation kommer versionstyperna benämnas Major/Minor eftersom det är ett vedertaget språkbruk i branchen. I språkbruket på andra platser kan begreppen “huvudversion” och “underversion” användas.
När ett tjänstekontrakt behöver förändras så ändras versionen antingen i form av en minorversion om ändringen anses vara bakåtkompatibel. Om den inte anses vara bakåtkompatibel så blir det en ny majorversion.
För mer information om versionshantering inom RIV-TA hänvisas till RIV Tekniska Anvisningar Översikt (Kapitel 8.2)
3. Tjänstekontrakt uppstår
Initiativen att skapa nya gemensamma/nationella tjänstekontrakt kommer från olika håll och kan tex. komma från projekt eller förvaltningar och det finns mer eller mindre beskrivna processer och rutiner för detta i form av Ineras programkontor m.m. så därför läggs inte vikt på denna fas i den här beskrivningen. istället fokuseras arbetet på att beskriva vad som gäller när tjänstekontrakt ska avvecklas.
Respektive tjänstekontraktsförvaltning behöver vara klar över hur beslutsgången ser ut och hur finansiering för att skapa nya tjänstekontrakt och förvalta dessa ska fungera, både på kort och lång sikt .
4. Tjänstekontrakt förvaltas
Med förvaltning avses här endast arbete kring själva tjänstekontrakten samt också att bevaka utökade behov, frågeställningar och felrapporter. Installation och konfiguration i tjänsteplattformar samt anslutning av aktörer ingår inte i detta arbete.
Under ett tjänstekontrakts livstid förvaltas detta både i så mån att dokumentation uppdateras och rättas men också genom mer tekniska förändringar i form av nya versioner med schemaförändringar.
En ny version kan vara bakåtkompatibel med tidigare version och släpps då som en minorversion (ex 1.1) eller så kan den bryta kravet på kompabilitet genom att släppas som en ny majorversion( ex 2.0).
En ny minorversion ersätter alltid tidigare minorversioner i publicering (publicering 1.0 -> 1.1) samt i Ineras tjänsteplattform även om den installerade basen hos andra parter kan bestå av en mix av versioner.
5. (Version av) tjänstekontrakt avvecklas
Med avveckling avses här att:
Supporten kring den aktuella majorversionen upphör både gällande felrättningar och rådgivning. Den publicerade statusen ändras och eventuella paketeringar tas bort
Virtuella och aggregerande tjänster som baseras på den majorversionen av tjänstekontrakt avinstalleras i Ineras tjänsteplattform
Gemensamt finansierad utveckling ska heller inte ske mot versioner med utlyst slutdatum
Källkod kommer inte nödvändigtvis rensas bort (men kommer inte underhållas eller nödvändigtvis flyttas vid eventuellt byten av källkodssystem) och det finns alltså inget som hindrar fortsatt lokalt användande så länge detta är självständig.
5.1 Besluta om avveckling
Ansvarig förvaltning är den part som tar beslut om avveckling. Skäl till avveckling kan variera men bör ha sitt ursprung i faktorer som kostnadsbesparing, regulatoriska krav, minskad komplexitet eller helt enkelt att ingen längre använder en viss version.
Så länge en version av ett tjänstekontrakt tillför mer värde än det kostar att vidmakthålla finns det inget egenvärde i att avveckla tjänstekontraktet..
5.2 Annonsera slutdatum för en viss huvudversion (end of life)
När beslut om att avveckla en version har tagits så ska detta meddelas så att eventuella kvarvarande användare kan planera för att uppgradera till senare huvudversion eller lösa informationsförsörjning på annat sätt.
Beslutet meddelas dels där tjänstekontraktet är publicerat (rivta.se) samt andra kontaktvägar som tjänstedomänförvaltningen använder.
För att parter ska ha en möjlighet att bedöma en ny investering i en viss version, samt ge alla existerande användare en rimlig chans att anpassa sina lösningar, så ska slutdatum annonseras minst 18 månader innan någon avveckling sker på befintliga centrala installationer. En förvaltning kan självklart välja att annonsera slutdatum med längre framförhållning.
Under tiden fram till slutdatum införs inga funktionella förändringar för den majorversion som avvecklas.
Rättningar av tekniska fel samt anpassningar till regulatoriska krav kan ske under hela perioden fram till slutdatum om det anses vara rimligare än att påskynda övergång till högre version (om sådan finns)
Kunskapsmässig support kring tjänstekontraktsversionen bibehålls under hela tiden fram till slutdatum.
Begränsningar i support runt tjänstekontrakt efter annonsering av slutdatum
Det ska inte ske några tekniska nyanslutningar till central infrastruktur mot den version som ska avvecklas.
Förberedelser inför avinstallation i nationella tjänsteplattformen
När slutdatum närmar sig planerar förvaltningen för Ineras tjänsteplattform för avveckling av versionen och kontrollerar då eventuella kvarvarande anslutna parter och verifierar att dessa inte längre använder versionen.
Avinstallation i tjänsteplattform
När slutdatum inträffat och kontroller av användning och konfiguration gjorts så görs följande:
I tjänsteplattformar avinstalleras eventuella virtuella tjänster som baseras på den majorversionen av tjänstekontrakt.
Eventuella aggregerande tjänster som baseras på den majorversionen av tjänstekontrakt avinstalleras.
All eventuell kvarvarande addressering (TAK) till avvecklad version raderas.