Manual SIL server installation 3.1 - Inera

Innehållsförteckning
Installation och drift av
SIL

Instruktion 2 (10)
Datum 2012-10-09 Dokumentnummer
Version 3.1 SIL0081
1. INTRODUKTION............................................................................................................................
3
1.1 SYFTE
1.2 MÅLGRUPP
................................................................................................................................................ 3
......................................................................................................................................... 3
2. INLEDNING.....................................................................................................................................
3
3. INSTALLATION AV DRIFTSMILJÖ...........................................................................................
3
3.1 SILDB31 DATABASEN........................................................................................................................
3
3.2 TESTA ATT DATABASEN FUNGERAR.........................................................................................................
3
3.3 JAVA.................................................................................................................................................
4
3.3.1. Testa att Java fungerar.........................................................................................................
4
3.4 TOMCAT............................................................................................................................................
4
3.4.1. Installation...........................................................................................................................
4
3.4.2. Testa att Tomcat fungerar....................................................................................................
4
3.5 SIL-API...........................................................................................................................................
5
3.5.1. SilDB3.properties.................................................................................................................
5
3.5.2. SilDB3Log.properties...........................................................................................................
5
3.5.3. Testa att SIL-API fungerar...................................................................................................
5
4. UPPDATERING AV DATABAS - VECKOVIS............................................................................
6
4.1.1. Testa att databasen fungerar................................................................................................
6
5. SIL UPDATER.................................................................................................................................
7
5.1 SILUPDATER.PROPERTIES......................................................................................................................
7
5.1.1. log4j.properties....................................................................................................................
7
5.2 INSTALLERA FLERA SILUPDATER PÅ SAMMA TOMCAT.................................................................................
7
5.3 TESTA ATT SIL UPDATER FUNGERAR.....................................................................................................
8
5.4 STARTA OCH STOPPA SIL UPDATER.......................................................................................................
8
6. DRIFTTIPS.......................................................................................................................................
8
7. BILAGA............................................................................................................................................
9
7.1 REKORD REGIONSID (BESTÄNDIGA ÖVER TID) ....................................................................................... 9
2 (10)

1. Introduktion
1.1 Syfte
Instruktion 3 (10)
Datum 2012-10-09 Dokumentnummer
Version 3.1 SIL0081
Syftet med dokumentet är att beskriva hur man installerar, konfigurerar och
driftar SIL och dess miljö.
1.2 Målgrupp
Målgruppen är utvecklare och driftstekniker som skall installera och använda SIL.
Dessa bör ha läst igenom hela dokumentationen.
2. Inledning
SIL-projektet har utvecklat en databas med läkemedelsinformation samt
tillhörande tjänstegränssnitt.
Databasen heter SilDB31 och är implementerad på en MS SQL Server 2008 R2
SP2.
Tjänstegränssnittet heter SIL-API som installeras på en Tomcat webserver med
tillhörande SOAP stöd (Axis).
För att möjliggöra online uppdatering av Fassinformationen i SIL-databasen
installerar man även ett silupdater-program på sin webserver – kontrollera om
era journalsystem använder SILs FASS-tjänster, annars är denna silupdater
onödig.
3. Installation av driftsmiljö
Installationen rekommenderas att göra på en dator med operativsystemet
Windows Server 2008 R2 SP1 x64 och databashanterare MS SQL Server 2008 R2
SP2 x64.
Ladda ner och zippa upp filen SilDB3.1.x_lokal_nerladdning.zip från SIL-projektets
ftp-plats.
För mer information om ftp-platsen och behörighet, se http://www.silinfo.se/.
3.1 SilDB31 Databasen
Använd en SQL Server Management Studio och attacha SilDB31 databasen
(filerna SilDB31.mdf och SilDB31_log.LDF) på vanligt sätt.
3.2 Testa att databasen fungerar
1. Logga in på SQL Servern med user och password som skall användas för
SIL-API när det skall koppla sig mot databasen.
2. Kör frågan SELECT * FROM tblDataVersion och se att det kommer ett svar
från databasen.
Det skall komma information om databasversion och vilka källor som ingår.
3. KLART.
3 (10)

3.3 Java
Instruktion 4 (10)
Datum 2012-10-09 Dokumentnummer
Version 3.1 SIL0081
Installera Java SE Development Kit, jdk1.7.0_17 x64 till en katalog t.ex. c:\java.
Java kan hämtas från:
http://www.oracle.com/technetwork/java/javase/downloads/index.html.
Systemvariabeln JAVA_HOME skall skapas och peka ut var Java är installerat. I det
här fallet skall den vara satt till c:\java\jdk1.7.0_17.
Systemvariabeln path skall få tillägget ;%JAVA_HOME%\bin;
3.3.1. Testa att Java fungerar
1. Öppna ett kommandofönster.
2. Skriv: java –version
3. Då skall man se information om vilken javaversion man har installerat om
allt fungerar.
4. KLART.
3.4 Tomcat
Installera apache-tomcat-7.0.37 x64 till en katalog t.ex. c:\java.
3.4.1. Installation
1. Gå in på http://tomcat.apache.org/download-70.cgi med en webbläsare.
2. Ladda ner installer-filen ”32-bit/64-bit Windows Service Installer”.
3. Kör installationen.
4. Öppna ett kommandofönster och gå till c:\java\apache-tomcat-7.0.37\bin
katalogen.
5. Kör kommandot Tomcat7w.exe och konfigurera Java Maximum memory
pool till minst 3000 MB. Om det sätts lägre kommer SIL-API inte att starta.l
6. Nu är Tomcat servicen installerad som en vanlig Windows Service. Det är
bra att ändra servicen så att den får startup Type Automatic istället för
Manual så att Tomcat alltid startas då servern startas eller startas om.
7. Systemvariabeln CATALINA_HOME skall sättas till c:\java\apache-tomcat-
7.0.37.
8. KLART.
Notera att en defaultinstallation ger att en access-log fil automatiskt skapas och
loggar alla anrop till Tomcat. Detta kan man enkelt konfigurera bort genom att
editera längst ner i c:\java\apache-tomcat-7.0.37\conf\server.xml filen.
För mer information angående installation av Tomcat se,
http://tomcat.apache.org/tomcat-7.0-doc/
3.4.2. Testa att Tomcat fungerar
1. Öppna en webb-läsare. Se till att du startat Tomcat-servicen.
2. Ange http://localhost:8080/
3. Kontrollera att man ser Apache Tomcats webbsida.
4 (10)

4. KLART.
3.5 SIL-API
Instruktion 5 (10)
Datum 2012-10-09 Dokumentnummer
Version 3.1 SIL0081
OBS! När SIL-API 3.1 tas i drift skall även tidigare version av SIL-API (2.9
och 3.0) tillhandahållas i produktion under en period. Dessa äldre
versioner av SIL-API är installerade i en axis_vara respektive
axis_silapi3-katalog på Tomcat. Därför är det viktigt att man inte tar
bort dessa kataloger vid installation av SIL-API 3.1. Då slutar SIL-API 2.9
och 3.0 att fungera!
SIL-API version 3.1 ligger i en axis_silapi31-katalog.
Antag att Tomcat är installerad på c:\java\apache-tomcat-7.0.37.
• Kopiera in axis_silapi31-katalogen till c:\java\apache-tomcat-
7.0.37\webapps.
• Ange i c:\java\apache-tomcat-7.0.37\webapps\axis_silapi31\serverconfig.wsdd
rätt path för attachments.Directory fältet. Det skall i det här
fallet stå c:\java\apache-tomcat-7.0.37\webapps\axis_silapi31\WEB-
INF\attachments.
• Kontrollera konfigurationsfilerna SilDB3.properties och
SilDB3Log.properties som ligger i:
c:\java\apache-tomcat-7.0.37\webapps\axis_silapi31\WEB-INF\classes, se
nedan.
3.5.1. SilDB3.properties
Parameternamn Betydelse Exempel
LogConfFile Konfigureringsfil för
loggningen.
SilDB3Log
Driver JDBC driver mellan com.microsoft.sqlserver.jdbc.SQLServerD
webserver och SQL Server. river
Host Värddator och port för SQL
servern.
127.0.0.1:1433
Name SIL-databasens namn SilDB31
User SIL-databasens
användarnamn
Sa
Passwd SIL-databasens password
3.5.2. SilDB3Log.properties
Parameternamn Betydelse Exempel
Level Loggningsnivå
INFO, DEBUG
INFO
dateTimeFormat Format för tidsangivelse i
loggningen.
yyyyMMdd H:mm:ss,SSS
File Loggens katalog och namn. c:/java/apache-tomcat-7.0.37/logs/SilDB3
5 (10)

Instruktion 6 (10)
Datum 2012-10-09 Dokumentnummer
Version 3.1 SIL0081
3.5.3. Testa att SIL-API fungerar
1. Kontrollera att SQL Server och Tomcat är startade.
2. Starta en webbläsare lokalt på din dator och ange
”http://localhost:8080/axis_silapi31/services/SilDB3?wsdl.
Om det fungerar skall man få se en xml-fil med alla SIL-tjänster.
3. Ange sedan ”http://localhost:8080/axis_silapi31/SilStatus” och kontrollera
att status är ok samt att databasversionen (datumet) är riktig.
4. Kör tjänsterna med någon SOAP-klient, t.ex. ”javaSilDB3Client” som
levereras av SIL-projektet eller ett journalsystem som använder SIL’s
tjänster.
5. KLART.
4. Uppdatering av databas - veckovis
För tillfället skall SIL’s databas uppdateras regelbundet med c:a en veckas
mellanrum.
Ladda ner och zippa upp filen SilDB3.x_lokal_nerladdning.zip från SIL-projektets
ftp-plats.
För mer information om ftp-platsen och behörighet, se http://www.silinfo.se/.
Använd en SQL Server Management Studio och detacha den installerade
databasen och attacha den nya SilDB3 databasen (filerna SilDB31.mdf och
SilDB31_log.LDF) på vanligt sätt.
4.1.1. Testa att databasen fungerar
1. Starta en webbläsare och ange
”http://localhost:8080/axis_silapi31/SilStatus och kontrollera att status är
ok samt att databasversionen (datumet) är riktig.
2. KLART.
6 (10)

5. Sil Updater
Instruktion 7 (10)
Datum 2012-10-09 Dokumentnummer
Version 3.1 SIL0081
Man installerar en SIL Updater till varje databas man vill ha uppdaterade FASStexter
mellan veckouppdateringarna.
Antag att Tomcat är installerad på c:\java\apache-tomcat-7.0.37.
• Kopiera in silupdater-katalogen till c:\java\apache-tomcat-7.0.37\webapps.
• Kontrollera konfigurationsfilen SilUpdater.properties som ligger i
c:\java\apache-tomcat-7.0.37\webapps\silupdater\WEB-INF\classes, se
nedan.
5.1 SilUpdater.properties
Parameternamn Betydelse Exempel
silMasterSoapUrl SIL’s centrala webserver
som man hämtar
uppdateringar från.
dBDriver JDBC driver mellan
webserver och SQL Server
http://fass.silinfo.se/SILMasterWebService
30/Service.asmx
com.microsoft.sqlserver.jdbc.SQLServerD
river
dBUrl SQL Serverns URL. jdbc:sqlserver://:1433;User=username;Password=s
ercret;DatabaseName=SilDB3
updateIntervalInMilliSec Uppdateringsintervall [ms] 120000
allowedClientIP IP som får starta/stoppa
silupdater via GUI
127.0.0.1
level Loggningsnivå INFO
dateTimeFormat Format för tidsangivelse i
loggningen.
yyyyMMdd H:mm:ss,SSS
file Loggens katalog och namn. c:/java/apache-tomcat-
7.0.37/logs/SilUpdater
Kontrollera konfigurationsfilen log4j.properties som ligger i
c:\java\apache-tomcat-7.0.37\webapps\silupdater\WEB-INF\classes, se nedan.
Notera att det finns fält i filen som ej är beskrivna i dokumentationen och dessa
skall man inte ändra.
5.1.1. log4j.properties
Parameternamn Betydelse Exempel
log4j.appender.R.File Axis2 klientens logg c:/java/apache-tomcat-
7.0.37/logs/log4j_axis2.log
5.2 Installera flera silupdater på samma Tomcat
Vill man uppdatera flera databaser från samma Tomcat skall man kopiera
c:\java\apache-tomcat-7.0.37\webapps\silupdater-katalogen och byta namn på
den till t.ex. silupdater_2. Man måste också editera filen web.xml i dess WEB-INF
7 (10)

Instruktion 8 (10)
Datum 2012-10-09 Dokumentnummer
Version 3.1 SIL0081
katalog. Där skall man byta värdet för parametern till
silupdater_2 på samtliga ställen.
Sedan skall man ange ett unikt ’file’ värde i dess SilUpdater.properties samt ange
ett unikt ’log4j.appender.R.File’ värde i dess log4j.properties för att loggningen
skall fungera.
5.3 Testa att SIL Updater fungerar
1. Kontrollera att Tomcat är startad.
2. Starta en webbläsare lokalt på din dator och
”http://localhost:8080/silupdater/
Om det fungerar skall man få se en webb sida med SILUPDATER STATUS.
Den skall visa ’ON’.
3. Titta i logg-filen c:/java/apache-tomcat-7.0.37\logs\SilUpdater.log att SIL Updater är startad.
4. Har man även installerat en SIL Updater med namnet t.ex. silupdater_2
testar man den på samma sätt som ovan genom att ange
’http://localhost:8080/silupdater_2/’ och sedan titta i dess loggfil på samma
sätt som ovan.
5. KLART.
5.4 Starta och stoppa SIL Updater
När Tomcat startas, startas alltid SIL Updater också.
Vill man tillfälligt stoppa eller starta SIL Updater öppnar man en webbläsare och
anger ”http://localhost:8080/silupdater/. Där finns start- och stopp-knappar.
Vill man konfigurera så att SIL Updater inte startas när Tomcat startas gör man
det genom att editera filen c:/java/apache-tomcat-
7.0.37\webapps\silupdater\WEB-INF\web.xml.
Kommentera ut raden med load-on-startup parametern genom att ändra till:
6. Drifttips
1. Kontrollera regelbundet att server datorn mår bra genom att kontrollera
att CPU kraft och RAM-minne är tillräckligt.
2. Kontrollera regelbundet SIL installationens status genom att starta en
webbläsare och ange ”http://localhost:8080/axis_silapi31/SilStatus” och
kontrollera att status är ok.
3. Kontrollera regelbundet att SIL-API’s loggfil inte innehåller några
felmeddelanden.
Kontakta SIL-projektet vid tveksamheter.
Loggfilen ligger där man valt att den skall ligga enligt
SilDB3Log.properties.
4. Om SIL Updater är installerad kontrollera att dess loggfil inte innehåller
några felmeddelanden. Kontakta SIL-projektet vid tveksamheter.
8 (10)

Instruktion 9 (10)
Datum 2012-10-09 Dokumentnummer
Version 3.1 SIL0081
Loggfilen ligger där man valt att den skall ligga enligt
SilUpdater.properties.
9 (10)

7. BILAGA
7.1 RekOrd RegionsId (Beständiga över tid)
1 Stockholms läns landsting
2 Landstinget i Uppsala län
3 Landstinget Sörmland
4 Landstinget i Östergötland
5 Landstinget i Jönköpings län
6 Landstinget Kronoberg
7 Landstinget i Kalmar län
8 Landstinget Blekinge
9 Region Skåne
10 Region Halland
11 Västra Götalandsregionen
12 Landstinget i Värmland
13 Örebro läns landsting
14 Landstinget Västmanland
15 Landstinget Dalarna
16 Landstinget Gävleborg
17 Landstinget Västernorrland
18 Jämtlands läns landsting
19 Västerbottens läns landsting
20 Norrbottens läns landsting
21 Gotlands kommun
22 Sverige
Instruktion 10 (10)
Datum 2012-10-09 Dokumentnummer
Version 3.1 SIL0081
10 (10)