Sil installationsmanual

Sil installationsmanual
Installation och drift av Sil Server 4.2
sil-installationsmanual-4.2.pdf
Version: 1.0
Diarienummer: 201609-023
Författare: Janne Kippola
Dokumentägare: Paul Cohen
Senast ändrad
2016-09-23
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
3.4.4
Fel-loggning i Tomcat ............................................................................................ 6
4.
Uppdatering av databas ...................................................................................................... 6
5.
Uppladdning av loggfiler .................................................................................................... 7
6.
Drifttips ................................................................................................................................. 8
Revisionshistorik
Version
Datum
Författare
Kommentar
1.0
2016-09-23
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.2.pdf
Version: 1.0
Diarienummer: 201609-023
Författare: Janne Kippola
Dokumentägare: Paul Cohen
Senast ändrad
2016-09-23
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 SilDB42.
3. Installation av driftmiljö
Installationen rekommenderas att man gör på en server 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 SilDB42.zip och silapi_4.2.zip. Observera att SFTP-servern
skiljer på gemener och versaler.
3.1
Sil-databasen
Använd SQL Server Management Studio och attacha SilDB42 databasen (filerna SilDB42.mdf
och SilDB42_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.2.pdf
Version: 1.0
Diarienummer: 201609-023
3.1.1
Författare: Janne Kippola
Dokumentägare: Paul Cohen
Senast ändrad
2016-09-23
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 8u102 till en katalog t.ex. C:\Program
Files\java\jdk1.8.0_102. Java kan hämtas från:
http://www.oracle.com/technetwork/java/javase/downloads/server-jre8-downloads2133154.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_102.
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.37 (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 installations-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.2.pdf
Version: 1.0
Diarienummer: 201609-023
Författare: Janne Kippola
Dokumentägare: Paul Cohen
Senast ändrad
2016-09-23
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 silapi42-katalog.
Kopiera in silapi42-katalogen från silapi_4.2.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 SQL-servern
127.0.0.1:1433
name
Sil-databasens
namn
SilDB42
user
Sil-databasens
användarnamn
sa
passwd
Sil-databasens
lösenord
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.2.pdf
Version: 1.0
Diarienummer: 201609-023
3.4.2
Författare: Janne Kippola
Dokumentägare: Paul Cohen
Senast ändrad
2016-09-23
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 silapi42_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 de 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/silapi42/SilDB?wsdl. Om det fungerar skall man få se en xmlrespons med alla Sil-tjänster.
3. Ange sedan http://localhost:8080/silapi42/SilStatus och kontrollera att status är ok
samt att databasversionen (datumet) är riktig.
4. Testa tjänsterna med någon SOAP-klient.
3.4.4
Fel-loggning i Tomcat
När man stänger eller startar om Tomcat så kommer Tomcat att logga vissa saker i catalina*.log samt tomcat8-stderr-*.log. Rader som börjar med
org.apache.catalina.loader.WebappClassLoaderBase.checkThreadLoca
lMapForLeaks och
org.apache.catalina.loader.WebappClassLoaderBase.clearReferences
Jdbc.
Orsaken till dessa loggfelmeddelanden är att vi valt inkludera jar filer för SOAP-stacken i
silapi42 webapplikationen och dessa jar filer städar inte upp efter sig när en webapplikation
stängs av. Felen som loggas är harmlösa och är inget att oroa sig över då jar filerna kommer
raderas och läsas om av Tomcat när webapplikationen stängs av eller startas om.
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.
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.2.pdf
Version: 1.0
Diarienummer: 201609-023
Författare: Janne Kippola
Dokumentägare: Paul Cohen
Senast ändrad
2016-09-23
Ladda ner och extrahera filen SilDB42.zip från SFTP servern. Använd SQL Server
Management Studio och detacha den installerade databasen och attacha den nya SilDB42
databasen (filerna SilDB42.mdf och SilDB42_log.LDF).
5. Uppladdning av loggfiler
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 silapi42_access.yyyy-mm-dd.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 sil42_log_uploader från silapi_4.2.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\sil42_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\sil42_log_uploader
4. Editera filen upload.ps1 som nu ligger i C:\Program Files\Apache
Software Foundation\Tomcat 8.0\sil42_log_uploader
Anpassa inställningen Client 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: sil42_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:
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.2.pdf
Version: 1.0
Diarienummer: 201609-023
Författare: Janne Kippola
Dokumentägare: Paul Cohen
Senast ändrad
2016-09-23
Program/script: powershell
Add arguments (optional): -file "C:\Program Files\Apache Software
Foundation\Tomcat 8.0\sil42_log_uploader\upload.ps1"
Klicka på knappen Next
12. Klicka på knappen Finish
13. Högerklicka på det nyskapade jobbet sil42_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/silapi42/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