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 info@inera.se 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 (silinfo@inera.se) 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 info@inera.se 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 info@inera.se 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 info@inera.se 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 (silinfo@inera.se) 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 info@inera.se 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 info@inera.se 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 info@inera.se www.inera.se Organisationsnummer 556559-4230 Sid 8/8
© Copyright 2024