Uppgradering från Lokal Säkerhetstjänst v Windows

Uppgradering från Lokal Säkerhetstjänst v.3 Windows ALLMÄNT Förutsättningar Begränsningar Begrepp 4. Referenser FÖRBEREDELSER Nedstängning av Säkerhetstjänster 3 Applikatoriska förberedelser Sätta databasprefix MySQL Databas backup 4. Installation av MongoDB 4. Kontrollera portöppningar UPPGRADERING Installation Singel installation Installation på första noden i en fail-over lösning Installation på övriga noder i en fail-over lösning Migration av konfigurationer Uppgradering av MySQL databas Förberedelse Uppgradering 4. Uppstart 4. Uppstart av tjänsterna på servern 4. Installation av bundlar 4. Kontrollera bundlarna 4. Fel relaterade till ej installerade tjänster 4. Övrig felhantering 4.4. Uppdatering av behörighetsregler 4.5. Aktivera filter 5. Administrationsgränssnittet 5. Prefix i databasscheman 5. Användarhandbok 5. Konfiguration av MongoDb 4. LOGGTJÄNST 4. Migrering av PDL loggar 4. Migrering 4. Kontrollera 4. Upprensning 4. Konfigurera mot Nationell Loggtjänst 4. Log Agent Impl 0.0 4. Log WS Proxy Impl 0.0 4. Upprensning av gamla loggrapport databasen 5. TEST 6. UPPRENSNING 7. ROLLBACK Datum Version Namn Förändring 2014-01-29 0 Göran Kristiansson och Marcus Tinnsten Dokument fastställt

ALLMÄNT Detta dokument ger instruktioner för hur man uppgraderar lokala Säkerhetstjänster version 3 till 3 på en Windows miljö. Under uppgraderingens gång kommer vi att hänvisa till installationspaketet på ett flertal ställen. Vi har placerat installationspaketet under följande struktur: C:\temp\Uppgradera_LokalaSakerhetstjanster_v3_till_v3_windows Förutsättningar Nedan listas de förutsättningar som måste uppfyllas för att en uppgradering skall lyckas. En fungerande installation av Säkerhetstjänster Installationspaketet för uppgradering till Lokala Säkerhetstjänster 3 skall finnas tillgängligt. Hämta hem uppgraderingspaket: Uppgradera_LokalaSakerhetstjanster_v3_till_v3_windows.zip Begränsningar Om man väljer att inte installera en lokal Loggtjänst kommer de PDL loggar som tidigare skapats att inte att migreras. Det betyder att logguppföljning inte är möjlig efter uppgraderingen på händelser före uppgraderingen. Däremot kommer uppföljning vara tillgänglig via den Nationella Säkerhetstjänsten på händelser utförda efter uppgraderingen. Uppföljning kan då ske via Webtjänstegränssnitt eller Administrations GUI på nationella Säkerhetstjänsten. Tips är att innan uppgradering ta ut loggrapporter för uppföljning om inte en lokal Loggtjänst ska installeras. Begrepp Begrepp Bundle Rollback Sak_server Singel installation Terracotta Terracotta_server Beskrivning Komponent av mjukvara som utgör tjänsterna i Säkerhetstjänster. Återställning av systemet till dess utgångsläge. Tjänsten som kör Säkerhetstjänster på servern. En installationsform där endast en nod används och utan Terracotta. Produkt som koordinerar hanterandet av gemensamma resurser från flera noder. Tjänsten som kör Terracotta på servern. 4. Referenser Referensnr Namn Adress Ref 1 Inera AB www.inera.se

FÖRBEREDELSER För över installationspaketet Uppgradera_LokalaSakerhetstjanster_v3_till_v3_windows till en temporär katalog på den maskinen där uppgraderingen ska ske av Säkerhetstjänster. C:\temp\Uppgradera_LokalaSakerhetstjanster_v3_till_v3_windows Våra rekommendationer är att backup av såväl applikatoriska och databasrelaterade resurser görs för att underlätta scenariot där en rollback är nödvändig. Tillvägagångssätt för detta beskrivs senare i kapitlet. Kontrollera vilken version som är installerat innan ni gör en nedstängning av systemet. Systemets version ska vara Logga in i administrationsgränssnittet. Vilket uppdrag som väljs har ingen betydelse. Gå till menyn Hjälp. Klicka på undermenyn Om Säkerhetstjänster för att se vilken version som är installerad. Nedstängning av Säkerhetstjänster 3 För att genomföra en säker nedstängning av systemet rekommenderas att den nod som är ACTIVE stängs ned sist. Kontrollera detta genom att logga in på en nod där Terracotta för Säkerhetstjänster är installerad. Öppna kommandotolken. Anpassa sökvägen och exekvera följande kommando: C:\share\Sakerhetstjanst3\terracotta\bin\server-stat.bat Skriptet kommer lista vilken status Terracotta har på noden. Dvs. om den är ACTIVE eller om den är PASSIVE. Se exempelbilden nedan. Det kan vara en god idé att anteckna vilken nod som är ACTIVE och vilken/vilka som är PASSIVE. Börja med att stänga ned applikationen Säkerhetstjänster 3 på PASSIVE-noden. Notera att det är viktigt att Säkerhetstjänster stängs ner före Terracotta på varje nod. 4. 5. 6. Öppna kontrollpanelen Gå till Services (under Administrative tools). Stoppa tjänsten Lokal Säkerhetstjänst Stoppa sedan tjänsten Lokal Säkerhetstjänst 1 Terracotta. Upprepa för steg 1-4 på samtliga PASSIVE-noder. Utför steg 1-4 på noden som är ACTIVE. Applikatoriska förberedelser Sätta databasprefix Om ni använder ett prefix till era databasscheman, måste det även sättas för de databasscheman som är nya för Säkerhetstjänster Detta prefix ska sättas manuellt i egenskapsfilen dist.properties. Det går att kontrollera att rätt prefix används i administrationsgränssnittet senare när väl systemet har startats. Detta beskrivs i kapitel 5.1 Prefix i databasscheman.

Följ instruktionerna nedan för att sätta prefixet i filen dist.properties. Öppna filen dist.properties, som finns i installationspaketet för Säkerhetstjänster C:\temp\Uppgradera_LokalaSakerhetstjanster_v3_till_v3_windows\install\resource\dist.target\dist.properties Hitta egenskapen db.prefix i filen. Ange ert prefix. Se följande exempel: db.prefix=exempel_ 4. Spara och stäng sedan filen. MySQL Databas backup Ta en backup av MySQL databasen. Detta kan göras på olika sätt. Vi rekommenderar verktyget MySQL Administrator som man lätt kan skapa en backup i. MySQL Administrator kan hämtas från följande länk: http://dev.mysql.com/downloads/gui-tools/5.0.html Det är viktigt att ni tar en backup av databasen för Säkerhetstjänster 3 i scenariot att en rollback skulle vara nödvändig. 4. Installation av MongoDB Om inte en lokal loggtjänst installeras kan detta kapitel hoppas över. MongoDB används av Loggtjänsten för att hantera loggrapporter och behövs således inte om loggtjänsten inte installeras. Instruktioner för hur ni sätter upp Mongodatabasen hittar ni i det ordinarie installationsdokumenetet av Säkerhetstjänster Installationsdokumentet ligger under följande struktur i installationspaketet: C:\temp\Uppgradera_LokalaSakerhetstjanster_v3_till_v3_windows\doc\Installation och administration - Lokala Säkerhetstjänster (Windows).pdf 4. Kontrollera portöppningar Kontrollera att portöppningar till mongodatabasen från applikations- och databasservern är gjorda. Logga in på applikationsservern. Öppna kommandotolken. Kontrollera portöppningarna med följande kommandon: telnet <IP_mongodb1> <port> Exempel: telnet mongodbsakerhetstjanst.example.com 27017 telnet <IP_mongodb2 > <port> Exempel: telnet mongodbsakerhetstjanst.example.com 27017 telnet <IP_mongodb0> <port> Exempel: telnet mongodb0.sakerhetstjanst.example.com 30000 Upprepa steg 2 för samtliga maskiner/noder som används.

UPPGRADERING När samtliga förberedelser i kapitel 2 är gjorda kan uppgraderingen genomföras. En rekommendation som gör installationen enklare är att börja med att anteckna vilka portar och host-adresser som systemet i dagsläget använder, samt vilka adresser och portar som ska användas till mongodatabasen. Om ingen annan beskrivning anges, ska instruktionerna nedan utföras på den nod som ni antecknade som ACTIVE i det inledande skedet av guiden användas. Installation Ett antal värden måste sättas när Säkerhetstjänster 3 ska installeras. Detta kapitel ger instruktioner för samtliga typer av installationer. Följ instruktionerna nedan. Steg 1-5 är identiska för alla installationstyper. Gå sedan till det kapitel som steg 6 hänvisar till. Gå till katalogen install i installationspaketet för Säkerhetstjänster 3 C:\temp\Uppgradera_LokalaSakerhetstjanster_v3_till_v3_windows\install Kör installationsprogrammet setup.exe. Se bilden nedan. 4. 5. 6. Klicka på knappen Next. Välj vart Säkerhetstjänster 3 ska installeras med knappen Browse. Välj även om installationen ska gälla för den specifika användaren eller för samtliga användare på datorn Klicka på knappen Next för att fortsätta. Klicka på knappen Next för att bekräfta installationen. Klicka på knappen Back om ni vill ändra på något i föregående steg. Fortsätt nu till följande kapitel: För en singel installation av Säkerhetstjänster, gå till kapitel 1 Singel installation. Installation på första noden i en Terracotta lösning, gå till kapitel 2 Installation på första noden i en fail-over lösning. Installation på övriga noder i en Terracotta lösning, gå till kapitel 3 Installation på övriga noder i en fail-over lösning. Singel installation Denna installation kommer att kopiera in de filer som behövs för applikationsservern samt registrera tjänsten Lokal Säkerhetstjänst 3. Efter installationen är det rekommenderat att man byter servicekonto. Se det ordinarie installationsdokumentet för detta ändamål. Välj Single installation i listan med möjliga installationstyper. Se bilden nedan.

Ange sökvägen till er java JDK med knappen Browse. Ange även port till JMX och OSGi-konsollen. Se exempelbilden nedan. Fyll sedan i värdena för varje konfiguration. Se tabellerna nedan för exempelvärden. Log setup Log archive shared path Exempel /share/archive Http(s) setup Host adress Exempel sakerhetstjanst.example.com OBS! Om lokal loggtjänst inte ska installeras kan dummy värden anges för Mongo Database setup Mongo Database setup Address replica server 1 Address replica server 2 Exempel mongodbsakerhetstjanst.example.com mongodbsakerhetstjanst.example.com Port 27017 Username Password Database name PDL log Database name archive search Database name audit log sak password pdllog archivesearch auditlog 4. Klicka på knappen Continue när ni har angivit värden till samtliga konfigurationer. Installationen utförs. 5. Gå vidare till kapitel 2 Migration av konfigurationer.

Installation på första noden i en fail-over lösning Denna installation kommer att kopiera in de filer som behövs för applikationsservern och kopiera de gemensamma filerna som används till den delade diskytan. Installationen kommer registrera två tjänster: Lokal Säkerhetstjänst 3 och Lokal Säkerhetstjänst 3 Terracotta. Efter installationen är det rekommenderat att man byter servicekonto. Se det ordinarie installationsdokumentet för detta ändamål. En förutsättning att man ska kunna installera en fail-over lösning är att man har satt upp en delad diskyta. Se det ordinarie installationsdokumentet för detta ändamål. Välj Cluster installation Node 1 (With TC Master) i listan med möjliga installationstyper. Ange också sökvägen till er delade diskyta. Se bilden nedan. Ange sökvägen till er java JDK med knappen Browse. Ange även port till JMX och OSGi-konsollen. Se exempelbilden nedan. Ange de portar och adresser ni använder för Terracotta. Se exempelbilden nedan. 4. Fyll sedan i värdena för varje konfiguration. Se tabellerna nedan för exempelvärden. Log setup Log archive shared path Exempel /share/archive Http(s) setup Host adress Exempel sakerhetstjanst.example.com

OBS! Om lokal loggtjänst inte ska installeras kan dummy värden anges för Mongo Database setup Mongo Database setup Address replica server 1 Address replica server 2 Exempel mongodbsakerhetstjanst.example.com mongodbsakerhetstjanst.example.com Port 27017 Username Password Database name PDL log Database name archive search Database name audit log sak password pdllog archivesearch auditlog 5. Klicka på knappen Continue när ni har angivit värden till samtliga konfigurationer. Installationen utförs. 6. Gå vidare till 3 Installation på övriga noder i en fail-over lösning. Installation på övriga noder i en fail-over lösning Andra delen av en installation med fail-over lösning som ska utföras på nästa nod. Notera att instruktionerna i kapitel 2 måste utföras innan ni påbörjar detta avsnitt. Installationen kommer registrera två tjänster: Lokal Säkerhetstjänst 3 och Lokal Säkerhetstjänst 3 Terracotta. Efter installationen är det rekommenderat att man byter servicekonto. Se det ordinarie installationsdokumentet för detta ändamål. Välj Cluster installation Node 2 (With TC Master) i listan med möjliga installationstyper. Ange också sökvägen till filen Node1InstallationProperties.xml som skapades vid installationen på den första noden och ligger på den delade diskytan. (C:\share\Sakerhetstjanst3\Node1InstallationProperties.xml). Se bilden nedan. Om noden ni installerar på ej är den första eller andra noden, välj då istället Cluster installation Other Node. Ange även här sökvägen till filen Node1InstallationProperties.xml. Klicka på knappen Continue. Installationen utförs. Gå vidare till kapitel 2 Migration av konfigurationer. Migration av konfigurationer

Efter ovanstående installation är gjord ska era inställningar i konfigurationen från Säkerhetstjänster 3 migreras till er nya systemversion. Migrationen av konfigurationerna görs med ett program, configuration_offline_upgrade.jar, som finns i installationspaketet: C:\temp\Uppgradera_LokalaSakerhetstjanster_v3_till_v3_windows\configuration_upgrade\configuration_offline_upgrade.jar Vid en kluster-installation (dvs. en installation med Terracotta och fler noder) ska migrationen av konfigurationen endast göras en gång. Konfigurationen ligger på en delad diskyta som delas av samtliga noder. Gör ni t.ex. migrationen på nod1, kommer även konfigurationen för nod2 uppgraderas. Verktyget behöver veta följande parametrar för att kunna göra en lyckad migrering: Sökvägen till konfigurationen tillhörande Säkerhetstjänster 3 Sökvägen till konfigurationen tillhörande Säkerhetstjänster 3 Sökvägen till XML-filen upgrade_config_3_to_xml som finns i uppgraderingskatalogen Öppna kommandotolken. Kör verktyget med parametrarna ovan enligt följande kommando: java -jar <sökväg_till_konfigurations_verktyg> -d <sökväg_till_säkerhetstjänster_3_config> -f <sökväg_till_filen_ upgrade_config_3_to_xml> -n <sökväg_till_säkerhetstjänster_3_config> -r true Se exempel nedan på hur kommandot ser ut när sökvägar har lagts till. Kom ihåg att ersätta exempelvärdena och använda era specifika sökvägar. java -jar C:\temp\Uppgradera_LokalaSakerhetstjanster_v3_till_v3_windows\configuration_upgrade\configuration_off line_upgrade.jar -d C:\share\Sakerhetstjanst3\sakerhetstjanst\config\ -f C:\temp\Uppgradera_LokalaSakerhetstjanster_v3_till_v3_windows\configuration_upgrade\upgrade_config_ 3_to_xml -n C:\share\Sakerhetstjanst3\sakerhetstjanst\config\ -r true Några varningar kan komma att skrivas ut. Dessa kan ignoreras. Det viktigaste är att verktyget meddelar följande indikation på att migrationen gick bra: Upgrade of configuration has been performed. Uppgradering av MySQL databas Förberedelse Flytta över katalogen mysql till er dedikerade databasmiljö. Ni hittar den i uppgraderingskatalogen, under följande katalogstruktur: C:\temp\Uppgradera_LokalaSakerhetstjanster_v3_till_v3_windows\db\mysql Katalogen kan exempelvis placeras i en temporär katalog på databasservern. Tänk på: Skriptet kommer att uppgradera er befintliga Säkerhetstjänster 3 databas. Kom ihåg att göra en backup av databasen innan ni kör uppgraderingsskriptet om det inte redan är gjort. Om ett prefix används på era databasscheman ska detta anges som en in-parameter när ni ska köra skriptet. Uppgradering Skriptet ska köras med följande in-parametrar: Användarnamnet till databasmiljön. Lösenord till databasmiljön. Ett prefix ska endast anges om ett sådant används, i annat fall behöver ni enbart ange uppgifterna i punktlistan ovan. Gör så här:

Öppna kommandotolken. Ställ er i katalogen mysql ni nyss flyttade till er databasserver. Anpassa och exekvera följande kommando: cd C:\temp\Uppgradera_LokalaSakerhetstjanster_v3_till_v3_windows\db\mysql Kör sedan uppgraderingsskriptet. Detta exekveras med kommandot nedan. Observera att i exemplet används prefixet exempel_. upgrade_create_script.bat root password exempel_ 4. Svara y för att bekräfta uppgradering. Varningen Could not drop database kan visas. Detta kan ignoreras. Uppgraderingsskriptet har kört klart när följande meddelande visas: Database upgrade complete. 4. Uppstart Systemet kan startas upp efter installation av mongo databasen, uppdatering av MySQL och migrationen av konfigurationen är klara enligt de beskrivningar som gavs ovan. 4. Uppstart av tjänsterna på servern Starta nu upp tjänsterna Lokal Säkerhetstjänst 3 och Lokal Säkerhetstjänst 3 Terracotta, som skapades upp automatiskt vid installationen. Detta ska göras på samtliga noder. Notera att om ni har en singel installation kan alla instruktioner angående Terracotta ignoreras (följ i övrigt instruktionerna som vanligt). Starta tjänsterna på alla noder: Öppna kontrollpanelen och gå till tjänster. Starta tjänsten Lokal Säkerhetstjänst 3 Terracotta. Den nod ni startar Terracotta först på kommer att agera som ACTIVE och övriga som PASSIVE. Starta sedan tjänsten Lokal Säkerhetstjänst 3. 4. Installation av bundlar När nu systemet är installerat och uppstartat ska de bundlar (dvs. enskilda komponenter av systemet som utgör tjänsterna i Säkerhetstjänster) installeras och startas upp. Det är rekommenderat att ni använder verktyget Putty (tredjepartsprodukt som ej medföljer i installationspaketet) för anslutning mot OSGi-konsolen. Följ sedan instruktionerna nedan. Börja med att öppna Säkerhetstjänster systemkonsol (OSGi-konsol). telnet localhost 1111 Lista samtliga aktiva bundlar med följande kommando: osgi> ss Utskriften som följer ska se ut som exemplet nedan: id State Bundle 0 ACTIVE org.eclipse.osgi_0.3 Följande visar en lista med de installationer som är möjliga att genomföra. Dessa går att kombinera, exempelvis installation av autentiseringstjänsten och spärrtjänsten. Annars kan man välja att göra en full installation, dvs. att samtliga tjänster som ingår i

Säkerhetstjänster installeras. osgi> pkg list 4. Följande installerar samtliga bundlar som ingår i installationsvalet automatiskt. Valet av en full installation: osgi> pkg install package 1 För en kombinerad installation (i exemplet nedan kombineras autentiseringstjänsten och spärrtjänsten): osgi> pkg install package 2,5 5. När de har installerats klart, starta dem med kommandot: osgi> pkg start 4. Kontrollera bundlarna Kör följande kommando för att verifiera att alla bundlar startar upp som de ska: osgi> context state Upprepa kommandot ett par gånger tills listan med UNRESOLVED DEPENDENCIES är tom (detta kan ta någon minut). Vänta en stund mellan varje repetition. När listan är tom kan ni fortsätta till kapitel 4.4 Uppdatering av behörighetsregler. Om bundlarna inte går upp som de ska (dvs. om listan med UNRESOLVED DEPENDENCIES inte blir tom), kan det vara något problem som har uppstått. Det kan bero på någon av följande punkter: Om INTE lokal loggtjänst är installerad kommer com.logica.se.bif.log.agent.impl.0.0 att visas med UNRESOLVED DEPENDENCIES. Följ då instruktioner i Kap. 4.2 Konfigurera mot Nationell Loggtjänst. Om INTE lokal loggtjänst är installerad kommer com.logica.se.iac.logging.mongo_0.0 att visas med UNRESOLVED DEPENDENCIES. Stoppa och avinstallera bundeln, då MongoDB enbart används för PDL-loggning. Lista först bundelns id: osgi> ss mongo.logging Notera bundelns id. Stoppa bundeln: osgi> stop <id> Avinstallera sedan bundeln: osgi> uninstall <id> Adresser och portar till mongodatabasen är felaktiga. Kontrollera att dessa stämmer. Se kapitel 5.3 Konfiguration av MongoDb. Att det prefix (om sådant används) de till databasscheman som är nya i Säkerhetstjänster 3 inte är satt än. Dessa ska göras i administrationsgränssnittet. Se kapitel 5.1 Prefix i databasscheman. Gå till kapitel 4.6.1 Fel relaterade till ej installerade tjänster om ni inte har valt en installation med samtliga tjänster. Gå till kapitel 4.6.2 för övrig felhantering. 4. Fel relaterade till ej installerade tjänster I en installation där inte alla tjänster ingår kommer ni kommer få UNRESOLVED DEPENDENCIES. Dessa problem är knutna till de tjänster som ni valde att inte installera. I följande exempel har vi endast installerat autentiserings- och spärrtjänsten. Vi får då felen som bilden nedan visar. Bilden visar att felen är knutna till "consent" (dvs samtyckestjänsten) och patientrelation (dvs. patientrelationstjänsten).

Konfigurationen i bilden ovan, "com.logica.se.bif.ping.ws.factory", väntar på tjänsterna samtycke och patientrelation. För att få bort felet så får man gå in i konfigurationskatalogen för "com.logica.se.bif.ping.ws.factory" och ta bort konfigurationsfilerna som tillhör tjänsterna. Gå till katalogen:.../share/sakerhetstjanst3/local/config/com.logica.se.bif.ping.ws.factory.0.0/ Tabellen nedan visar vilka kontextfiler i katalogen som tillhör vilken tjänst. Tjänst Spärr Kontextfil(er) blocklocal.xml blocklocalvxml Samtycke Lokal logg Patientrelation consent.xml log.xml patientrelation.xml I detta exempel skulle vi då behöva ta bort filerna consent.xml och patientrelation.xml. Vi måste sedan uppdatera konfigurationen i OSGi-konsollen. Kör kommandot: osgi> context st Följande listas UNRESOLVED DEPENDENCIES för tjänsterna. Notera det id som de har och uppdatera konfigurationen med följande kommando: osgi> up <id> Verifiera sedan om problemet har löst sig med kommandot: osgi> context state Koppla ned från OSGi-konsolen med kommandot: osgi> disconnect I exemplet ovan hade vi endast installerat autentiserings- och spärrtjänsten. Om ni t.ex. endast har installeras autentiseringstjänsten och samtyckestjänsten kommer ni få ett liknande scenario, fast för spärr och patientrelation. Samma procedur som vi beskrev ovan gäller då. 4. Övrig felhantering Kontrollera systemloggen efter fel loggar om problemen kvarstår efter ni har genomfört lösningsförslagen som listades ovan. Logga in i OSGi-konsollen: telnet localhost 1111 Kontrollera systemloggen efter alla fel som har loggats: osgi> audit search level error Kontrollera systemloggen efter alla fel som har loggats den senaste timmen: osgi> audit search -level error -time 1h

4.4. Uppdatering av behörighetsregler Behörighetsreglerna måste uppdateras för att vara korrekt till Säkerhetstjänster I installationspaketet finns det ett verktyg som kan användas i syftet att skapa upp regler. Detta verktyg hittar ni under katalogstrukturen: C:\temp\Uppgradera_LokalaSakerhetstjanster_v3_till_v3_windows\rules\RuleConfigGenerator.exe Instruktioner för hur ni skapar upp reglerna (med verktyget vi nämnde ovan, eller manuellt) finns i det ordinarie installationsdokumentet av Säkerhetstjänster Detta dokument hittar ni under katalogstrukturen: C:\temp\Uppgradera_LokalaSakerhetstjanster_v3_till_v3_windows\doc\userguide\Anvandarhandbok_Sakerhetstjanster.pdf Läs in reglerna i systemet: Börja med att öppna Säkerhetstjänster systemkonsol (OSGi-konsol). telnet localhost 1111 Anpassa följande kommando och exekvera det: sys acc -import file:/// <sökväg till er anpassade regel-fil> Kom ihåg ändelsen ".xml". Klicka på Enter för att exekvera kommandot. Reglerna har nu lästs in i systemet. 4.5. Aktivera filter Kom ihåg att aktivera behörighets- och autentiseringsfiltren. Dessa kan inaktiveras om ni måste göra konfigurationer i administrationsgränssnittet som ni inte annars kommer åt. Notera att filtren måste aktiveras vid produktionssättning av systemet. Logga först in i OSGi-konsolen. telnet localhost 1111 Aktivera behörighets- och autentiseringsfilter: sys spfilter -on sys authz on Inaktivera behörighets- och autentiseringsfilter: sys spfilter off sys authz off 5. Administrationsgränssnittet 5. Prefix i databasscheman Det här avsnittet har två syften; Instruktioner för att sätta det prefix som övriga scheman har, och Beskriva hur ni kan kontrollera att rätt prefix används. Gå in i administrationsgränssnittet. Klicka på menyn Generell Konfiguration i huvudmenyn Administration. Bläddra i tabellen som visas och kontrollera i följande konfigurationer att det prefix ni använder finns i samtliga nya scheman: Commission Repository 0.0

Log Download Archive 0.0 Log Logsink Impl Factory 0.0 Log Report Archive Repository Impl 0.0 Log Repository Impl 0.0 Se exempelbilden nedan för hur det kan se ut i konfigurationerna med prefixet exempel_. Det ska se liknande ut på samtliga konfigurationer som listas ovan. Om inget prefix används ska endast databasnamnet vara angivet (databasnamnet i exempelbilden nedan skulle då endast ha namnet commission ). 5. Användarhandbok I installationspaketet finns användarhandboken till Säkerhetstjänster Den ska laddas upp i administrationsgränssnittet. Öppna administrationsgränssnittet och klicka på menyn Administration. Klicka sedan på undermenyn Uppdatera användarhandbok. Klicka på knappen Välj fil. Användarhandboken hittar ni under följande sökväg i installationspaketet: C:\temp\Uppgradera_LokalaSakerhetstjanst er_v3_till_v3_windows\doc\userguide\anvandarhandbok_sakerhetstjanster.pdf Klicka sedan på Ladda upp användarhandbok. Handboken finns nu tillgänglig för nedladdning i menyn Hjälp. 5. Konfiguration av MongoDb Följande avsnitt hänvisar till de konfigurationer som den nya mongodatabasen använder. Dessa konfigurationer hittar ni i administrationsgränssnittet, i menyn Generell Konfiguration under huvudmenyn Administration. Följande konfigurationer används av mongodb: Log Handler - Mongo 0.0 Logreport Archive Store MongoDB Impl 0.0 Logreport Store Online MongoDB Impl 0.0

4. LOGGTJÄNST 4. Migrering av PDL loggar Om en lokal Loggtjänst är installerad ska migrering av loggposter utföras annars kan detta kapitel hoppas över. Utför migrering av PDL loggar till den nya lokala loggtjänsten. Den nya lokala loggtjänsten lagrar loggar i arkiv filer till skillnad från äldre versioner av Säkerhetstjänster som lagrat dessa i MySQL databas. Dessa måste flyttas (migreras) för att möjliggöra uppföljning via loggrapporter. 4. Migrering Installera bundle för migrering av loggposter. Logga först in i OSGi-konsolen. telnet localhost 1111 osgi> install file:///c:\temp\uppgradera_lokalasakerhetstjanster_v3_till_v3_windows\log_migrati on\com.logica.se.bif.tools.local.log.migration.v.3-0.0.jar Notera bundelns id och starta den. bundle id is xxx osgi> start xxx Kontrollera att bundeln är installerad. osgi> ss log.migration Bundeln ska nu ha status Installed. Om inte, kontrollera audit loggen efter felmeddelanden: audit search level error time 10m 4. Stoppa proxy bundeln for log tjänsten, då denna inte ska användas om man har installerat lokal loggtjänst. 5. Kolla vilket id bundlen har: osgi> ss log.ws.proxyimpl Stoppa bundeln: osgi> stop <bundle-id> Kör kommandot dep och context state för att se att bara com.logica.se.bif.log.ws.proxyimpl har blivit avstängd och att inga andra bundlar har fått något fel pga detta. Lista möjliga kommandon för migrationsbundeln: osgi> log... LogMigration Migrera lokala loggposter från Säkerhetstjänster version 3 till version 3 Syntax: -dburl -dbport -schema -user -password -validate 3 URL adress till den gamla databasen Databas port till den gamla databasen Databas schema namn för den gamla log rapport databasen Användare för att logga in mot den gamla databasen Lösenord för att logga in mot den gamla databasen Validera loggposterna som ska migreras. Inga loggposter sparas i nya loggtjänsten v

-help Hjälp kommando 6. Validera att loggposterna kan migreras. osgi> log LogMigration -dburl <database hostname> -dbport 3306 -schema <prefix_>logreport -user xxxx -password xxxx validate Resultat: Validering av loggposter ok! Totalt antal loggposter som validerats: xxx 7. Om validering är ok. Migrera loggposterna. osgi> log LogMigration -dburl <database hostname> -dbport 3306 -schema <prefix_>logreport -user xxxx -password xxxx Resultat: Migrering ok! Totalt antal loggposter som migrerats: xxxx 4. Kontrollera Utför ett antal kontroller för att säkerställa att loggposter migrerats. Verifiera antalet loggposter i gamla databasen är detsamma som de som migrerats. Kör sql kommando i en query browser. SELECT count(*) FROM <prefix_>logreport.log; Verifiera att loggposter tagit emot av nya loggtjänsten. Kontrollera status variabel nroflogsrecieved att summan är densamma som antal migrerade loggposter. Logga in i osgi konsolen (på samma nod som migrering utfördes på om det är en klustrad miljö). telnet localhost 1111 osgi> sys mon filter log.service.impl Resultat: nroflogsrecieved xxx 4. Upprensning Avinstallera bundle för migrering. Logg in i osgi konsolen. telnet localhost 1111 osgi> ss migration id State Bundle xxx ACTIVE com.logica.se.bif.tools.local.log.migration.v.3_0.0 uninstall <id> osgi> ss migration Ingen migration bundle ska finnas.

4. Konfigurera mot Nationell Loggtjänst Utförs endast om ingen lokal Loggtjänst är installerad. Uppdatera generella konfigurationen så att PDL loggar skickas till den Nationella Loggtjänsten. OBS! För att anslutningen till den nationella loggtjänsten ska fungera måste förvaltningsorganisationen för nationella säkerhetstjänster kontaktas för att öppna upp access till tjänsten. Kontakta Ineras förvaltning i god tid före driftstart [ Ref 1]. För att använda nationell loggtjänst konfigurerar man modulen Log Agent Impl till att använda en Proxy samt ange adress och portnummer till den externa loggtjänsten i modulen Log WS Proxy Impl. ( Log WS Proxy Impl används ej om lokal loggtjänst är installerad) Samtliga konfigurationer av tjänsten Logg ligger i menyn Administration i undermenyn Generell Konfiguration. 4. Log Agent Impl 0.0 Öppna konfigurationen Log Agent Impl 0.0. Sätt Logstore service till "Proxy". Klicka på knappen Spara när konfigurationen är klar och återgå till Generell konfiguration med knappen Tillbaka. 4. Log WS Proxy Impl 0.0 Öppna konfigurationen Log WSProxy Impl 0.0. Ange Context Path, Host name och Port number. Dessa ska anges så att anropen går via Tjänsteplattformen. Adresser till Tjänsteplattformen: Miljö Hostnamn IP-adress port contextpath QA-Sjunet (Test) qa.esb.ntjp.sjunet.org 8136.149.53 20000 /vp

Produktion-Sjunet esb.ntjp.sjunet.org 8136.149.61 20000 /vp Klicka på knappen Spara när konfigurationen är klar och återgå till Generell konfiguration med knappen Tillbaka. 4. Upprensning av gamla loggrapport databasen Ta bort gamla loggrapport databasen från MySQL (Vid behov finns den sparad i backup). Logga in i MySQL query browser och välj schema <prefix_>logreport. Kör följande kommandon: DROP TABLE IF EXISTS log; DROP TABLE IF EXISTS resources resource; DROP TABLE IF EXISTS resources; DROP TABLE IF EXISTS resource; DROP TABLE IF EXISTS system; DROP TABLE IF EXISTS activity; DROP TABLE IF EXISTS user; DROP TABLE IF EXISTS patient; DROP TABLE IF EXISTS care_unit; DROP TABLE IF EXISTS care_provider;

5. TEST Utför testerna i tabellen nedan för att verifiera att systemet har uppgraderats utan några problem. Uppdatera Generell konfiguration Utfört Loggen ska vara inställd på. Konfiguration: Log File Archive Store 0.0 Auto Archive Rotate Check Interval = 10 Max Archive Rotation Time = 30 Konfiguration: Log Logsource Consumer 0.0 Max queue time = 10000 Skapa patientrelation med en testpatient Utfört Antal: 2 st. Sök patientrelation. Kontrollera att det är 2 st skapade för testpatienten. Administrera patientrelation Utfört Makulera det ena Återkalla det andra Skapa samtycke med en testpatient Utfört Antal: 2 st. Sök samtycke. Kontrollera att det är 2 st skapade för testpatienten. Administrera samtycke Utfört Makulera det ena Återkalla det andra Skapa lokal spärr med en testpatient Utfört Antal: 3 st. Sök spärrar. Kontrollera att det är 3 st skapade för testpatienten. Administrera spärr Utfört Makulera det ena Häv permanent det andra Registrera tillfällig hävning, den tredje Kör loggrapport patient Utfört Ange den testpatient ni har utfört testerna med. Fr.o.m datum igår T.o.m datum imorgon Uppdatera Generella konfigurationen Utfört Återställ loggkonfiguration. Konfiguration: Log File Archive Store 0.0 Auto Archive Rotate Check Interval = 600 Max Archive Rotation Time = 21600 Konfiguration: Log Logsource Consumer 0.0 Max queue time = 10800000

6. UPPRENSNING När systemet är installerat och verifierat att det fungerar som det ska kan Säkerhetstjänster 3 städas bort från maskinerna. Detta är inget nödvändigt steg och behöver därmed inte göras i samband med uppgraderingen. Viktigt: Om en upprensning utförs kan ingen "Rollback" genomföras enligt sista kapitlet. Ta bort services: Öppna kommandotolken. Exekvera följande kommando på samtliga noder: sc delete "Lokal Säkerhetstjänst 1" Exekvera följande kommando på samtliga noder (kan ignoreras ifall en singel installation har använts): sc delete "Lokal Säkerhetstjänst 1 Terracotta" 4. Ta bort kataloger som skapats på delade disken och lokalt som heter Säkerhetstjänster

7. ROLLBACK Återställningsinstruktioner vid en misslyckad uppgradering. Då den nya versionen av Säkerhetstjänster installeras parallellt med den gamla stänger man ner tjänsten för version 3 och startar sedan tjänsten för den gamla installationen. Stäng ner Säkerhetstjänsten 3 på alla noder den är installerad (fail-over installation) a. Öppna kontrollpanelen och gå till tjänster b. Stäng ner tjänsten Lokal Säkerhetstjänst 3. sc delete "Lokal Säkerhetstjänst 3" c. Stäng ner tjänsten Lokal Säkerhetstjänst 3 Terracotta om fail-over installation är installerad. sc delete "Lokal Säkerhetstjänst 3 Terracotta" Återställ MySQL databasen med den backup som togs innan uppgraderingen påbörjades. Starta gamla versionen av Säkerhetstjänsten på alla noder som den är installerad (fail-over installation) a. Öppna kontrollpanelen och gå till tjänster. b. c. Starta tjänsten Lokal Säkerhetstjänst 1 Terracotta om fail-over installation är installerad. Starta tjänsten Lokal Säkerhetstjänst 1. 4. Gå in i OSGi-konsolen och slå på behörighets- och autentiseringsfiltren: a. telnet localhost 1111 b. osgi> sys spfilter on c. osgi> sys authz -on 5. Avinstallera Säkerhetstjänster 3 a. Öppna kontrollpanelen. Gå till Program. b. Välj Säkerhetstjänster 3 och avinstallera. 6. Ta bort services a. Öppna kommandotolken. b. Exekvera följande kommando: sc delete "Lokal Säkerhetstjänst 3" c. Exekvera följande kommando: sc delete "Lokal Säkerhetstjänst 3 Terracotta" 7. Ta bort mappar som skapats på delade disken och lokalt som heter Säkerhetstjänster