Installation och drift av SIL Server 4.1

Sil installationsmanual
Installation och drift av Sil Server 4.1
sil-installationsmanual-4.1.pdf
Version: 1.0
Diarienummer: 201510-012
Författare: Janne Kippola
Dokumentägare: Erik Heneryd
Senast ändrad
2015-10-28
Innehåll
1.
Introduktion .......................................................................................................................... 3
1.1
Syfte............................................................................................................................... 3
1.2
Målgrupp ........................................................................................................................ 3
2.
Inledning ............................................................................................................................... 3
3.
Installation av driftmiljö ...................................................................................................... 3
3.1
Sil-databasen ................................................................................................................. 3
3.1.1
3.2
Java ............................................................................................................................... 4
3.2.1
3.3
Testa att databasen fungerar ................................................................................ 4
Testa att java fungerar........................................................................................... 4
Tomcat ........................................................................................................................... 4
3.3.1
Installation ............................................................................................................. 4
3.3.2
Testa att Tomcat fungerar ..................................................................................... 5
3.4
Sil SOAP API ................................................................................................................. 5
3.4.1
SilDB.properties ..................................................................................................... 5
3.4.2
log4j2.xml (fel-loggning) ........................................................................................ 6
3.4.3
Testa att Sil SOAP API fungerar ........................................................................... 6
4.
Uppdatering av databas ...................................................................................................... 6
5.
Uppladdning av loggfiler .................................................................................................... 6
6.
Drifttips ................................................................................................................................. 8
Revisionshistorik
Version
Datum
Författare
Kommentar
1.0
2015-10-28
Janne Kippola
Första utgåva.
Inera AB
Box 177 03
Östgötagatan 12
118 93 Stockholm
Tel 08 452 71 60
[email protected]
www.inera.se
Organisationsnummer
556559-4230
Sid 2/8
sil-installationsmanual-4.1.pdf
Version: 1.0
Diarienummer: 201510-012
Författare: Janne Kippola
Dokumentägare: Erik Heneryd
Senast ändrad
2015-10-28
1. Introduktion
1.1
Syfte
Detta dokument beskriver hur man installerar, konfigurerar och driftar Sil Server och dess
miljö.
1.2
Målgrupp
Dokumentet vänder sig till utvecklare och drifttekniker som skall installera och använda Sil
Server.
2. Inledning
Sil tillhandahåller en databas med läkemedelsinformation samt tillhörande tjänstegränssnitt.
Sil Server består dels av ett SOAP API implementerad i Java och med Tomcat webserver och
dels en SQL-databas som heter SilDB41.
3. Installation av driftmiljö
Installationen rekommenderas att göras på en dator med operativsystemet Windows Server 2012
R2 och databashanterare SQL Server 2012 SP2 (64bit).
För att hämta APIt och databasen krävs åtkomst till Sils SFTP server. Saknas åtkomst kontakta
Sils support ([email protected]) eller besök http://www.inera.se/sil för information om
anslutning.
Ladda ner och extrahera filerna SilDB41.zip och silapi_4.1.zip
3.1
Sil-databasen
Använd SQL Server Management Studio och attacha SilDB41 databasen (filerna SilDB41.mdf
och SilDB41_log.LDF).
Inera AB
Box 177 03
Östgötagatan 12
118 93 Stockholm
Tel 08 452 71 60
[email protected]
www.inera.se
Organisationsnummer
556559-4230
Sid 3/8
sil-installationsmanual-4.1.pdf
Version: 1.0
Diarienummer: 201510-012
3.1.1
Författare: Janne Kippola
Dokumentägare: Erik Heneryd
Senast ändrad
2015-10-28
Testa att databasen fungerar
1. Logga in på SQL Servern med användarnamn och lösenord som skall användas för Sil
SOAP 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. Resultatet ska visa information om databasversion och vilka källor som
ingår.
3.2
Java
Installera Java SE Server JRE 8u60 till en katalog
t.ex. C:\Program Files\java\jdk1.8.0_60. 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:\Program Files\java\jdk1.8.0_60.
Systemvariabeln PATH skall få tillägget ;%JAVA_HOME%\bin
3.2.1
Testa att java fungerar
1. Öppna ett kommandofönster.
2. Skriv: java –version
Då skall man se information om vilken java-version man har installerat om allt fungerar.
3.3
Tomcat
Installera Apache Tomcat 8.0.27 (64bit) till en katalog t.ex. C:\Program Files\Apache
Software Foundation\Tomcat 8.0.
3.3.1
Installation
Gå in på http://tomcat.apache.org/download-80.cgi med en webbläsare.
Ladda ner installer-filen 32-bit/64-bit Windows Service Installer.
Kör installationen.
Öppna katalogen C:\Program Files\Apache Software
Foundation\Tomcat 8.0\bin.
5. Kör programmet Tomcat8w.exe och konfigurera Java Maximum memory pool till minst
3000 MB. Om det sätts lägre kommer Sil SOAP API inte att starta.
6. Nu är Tomcat servicen installerad som en vanlig Windows Service. Man bör även ä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.
1.
2.
3.
4.
Inera AB
Box 177 03
Östgötagatan 12
118 93 Stockholm
Tel 08 452 71 60
[email protected]
www.inera.se
Organisationsnummer
556559-4230
Sid 4/8
sil-installationsmanual-4.1.pdf
Version: 1.0
Diarienummer: 201510-012
Författare: Janne Kippola
Dokumentägare: Erik Heneryd
Senast ändrad
2015-10-28
7. Systemvariabeln CATALINA_HOME skall sättas till C:\Program Files\Apache
Software Foundation\Tomcat 8.0.
För annan konfiguration, t.ex konfiguration av HTTPS, se tomcats
dokumentation: http://tomcat.apache.org/tomcat-8.0-doc/.
3.3.2
Testa att Tomcat fungerar
1. Se till att du startat Tomcat-servicen.
2. Öppna en webbläsare, ange adressen http://localhost:8080
3. Kontrollera att man ser Tomcats webbsida.
3.4
Sil SOAP API
Sil SOAP API ligger i en silapi41-katalog.
Kopiera in silapi41-katalogen från silapi_4.1.zip till webapps-katalogen där man installerade
Tomcat. Kontrollera innehållet i konfigurationsfilen SilDB.properties, se nedan.
3.4.1
SilDB.properties
Denna fil innehåller databas-inställningar för Sil SOAP API, den ligger under katalogen WEBINF\classes där man installerade Sil SOAP APIt.
Denna fil bör uppdateras med korrekta databasinställningar.
Parameternamn
Betydelse
Exempel
Driver
JDBC driver
mellan webserver
och SQL server
com.microsoft.sqlserver.jdbc.SQLServerDriver
Host
Värddator och
port för SQLservern
127.0.0.1:1433
Name
Sil-databasens
namn
SilDB41
User
Sil-databasens
användarnamn
sa
Inera AB
Box 177 03
Östgötagatan 12
118 93 Stockholm
Tel 08 452 71 60
[email protected]
www.inera.se
Organisationsnummer
556559-4230
Sid 5/8
sil-installationsmanual-4.1.pdf
Version: 1.0
Diarienummer: 201510-012
Passwd
3.4.2
Författare: Janne Kippola
Dokumentägare: Erik Heneryd
Senast ändrad
2015-10-28
Sil-databasens
lösenord
log4j2.xml (fel-loggning)
Filen log4j2.xml ligger under katalogen WEB-INF/classes där man installerade Sil SOAP
APIt.
Denna fil innehåller inställningar för fel-loggning för Sil SOAP API och använder sig av log4j2.
Den är inställd så att filer skapas med prefixet silapi41_error under mappen logs där tomcat
installerades. Loggrotation är konfigurerad så att den skapar en ny loggfil om den blir för stor.
Om man vill att loggfiler ska automatiskt raderas när dom blir för många kan man lägga
till <DefaultRolloverStrategy max="20"/> under taggen <RollingFile> där
max="20" betyder att den behåller 20 filer.
Se log4j2 manualen för mer information. http://logging.apache.org/log4j/2.x/manual
3.4.3
Testa att Sil SOAP 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/silapi41/SilDB?wsdl. Om det fungerar skall man få se en
xml-respons med alla Sil-tjänster.
3. Ange sedan http://localhost:8080/silapi41/SilStatus och kontrollera att status är ok
samt att databasversionen (datumet) är riktig.
4. Testa tjänsterna med någon SOAP-klient.
4. Uppdatering av databas
Sil-databasen bör uppdateras så fort det kommer en ny version av databasen på Sils SFTP
server. För information om åtkomst bör man kontakta Sils support ([email protected]) eller
besök http://www.inera.se/sil.
Ladda ner och extrahera filen SilDB41.zip från SFTP servern. Använd SQL Server
Management Studio och detacha den installerade databasen och attacha den nya SilDB41
databasen (filerna SilDB41.mdf och SilDB41_log.LDF).
5. Uppladdning av loggfiler
Inera AB
Box 177 03
Östgötagatan 12
118 93 Stockholm
Tel 08 452 71 60
[email protected]
www.inera.se
Organisationsnummer
556559-4230
Sid 6/8
sil-installationsmanual-4.1.pdf
Version: 1.0
Diarienummer: 201510-012
Författare: Janne Kippola
Dokumentägare: Erik Heneryd
Senast ändrad
2015-10-28
För att vi bättre ska kunna följa hur Sil API används ute i landet lanserar vi nu ett Powershellscript som hjälper er att ladda upp loggfiler vid namn silapi41_access.yyyy-mmdd.log till vår SFTP-server.
OBS! Dessa loggfiler innehåller endast teknisk information. Ej patientuppgifter.
Vi vill endast att ni laddar upp loggfiler från er(a) produktionsmiljö(er).
1. Kopiera katalogen sil41_log_uploader från silapi_4.1.zip till Tomcatkatalogen C:\Program Files\Apache Software Foundation\Tomcat
8.0
2. Kopiera er privata SSH-nyckel (Ex: id_rsa.ppk, vilken ni skapade när ni ansökte
om åtkomst till Sil SFTP) till katalogen C:\Program Files\Apache Software
Foundation\Tomcat 8.0\sil41_log_uploader
3. Ladda ner WinSCP .NET Assembly/COM library från:
https://winscp.net/download/winscp575automation.zip
Kopiera filerna WinSCP.exe och WinSCPnet.dll från
winscp575automation.zip till katalogen C:\Program Files\Apache
Software Foundation\Tomcat 8.0\sil41_log_uploader
4. Editera filen upload.ps1 som nu ligger i C:\Program Files\Apache
Software Foundation\Tomcat 8.0\sil41_log_uploader
Anpassa Client-inställningarna till er miljö.
5. Starta Task Scheduler genom att trycka WINDOWSTANGENT + R och sedan
skriva in taskschd.msc
6. Markera Task Scheduler Library till vänster. Högerklicka sedan och
välj Create Basic Task...
7. Namnge det schemalagda jobbet (Ex: sil41_log_uploader) och ge det en
beskrivning (Ex: Schemalagt jobb som laddar upp accessloggar
till Sil en gång per dygn.). Klicka sedan på knappen Next
8. Se till att alternativet Daily är valt. Klicka sedan på knappen Next
9. Standardvärdena på nästa sida bör vara OK. Klicka på knappen Next
10. Se till att alternativet Start a program är valt. Klicka sedan på knappen Next
11. Fyll i följande:
Program/script: powershell
Add arguments (optional): -file "C:\Program Files\Apache Software
Foundation\Tomcat 8.0\sil41_log_uploader\upload.ps1"
Klicka på knappen Next
Inera AB
Box 177 03
Östgötagatan 12
118 93 Stockholm
Tel 08 452 71 60
[email protected]
www.inera.se
Organisationsnummer
556559-4230
Sid 7/8
sil-installationsmanual-4.1.pdf
Version: 1.0
Diarienummer: 201510-012
Författare: Janne Kippola
Dokumentägare: Erik Heneryd
Senast ändrad
2015-10-28
12. Klicka på knappen Finish
13. Högerklicka på det nyskapade jobbet sil41_log_uploader och välj
alternativet Properties
Se till att alternativen Run whether user is logged on or
not och Hidden är valda.
Klicka sedan på knappen OK och fyll i användarens lösenord.
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/silapi41/SilStatus och kontrollera att status är ok.
3. Kontrollera regelbundet att Sil SOAP API's loggfil inte innehåller några
felmeddelanden. Kontakta Sil support vid tveksamheter. Loggfilen ligger där man valt
att den skall ligga enligt log4j2.xml.
Inera AB
Box 177 03
Östgötagatan 12
118 93 Stockholm
Tel 08 452 71 60
[email protected]
www.inera.se
Organisationsnummer
556559-4230
Sid 8/8