DIPS Communicator. Installasjonsveiledning

Transkript

1 DIPS Communicator Installasjonsveiledning DIPS ASA Versjon 7.0,

2 Innhold 1. Innledning Om DIPS Communicator Kundestøtte Nedlasting av nye versjoner Systemkrav Maskinvare og operativsystem Microsoft.NET Framework Tilstrekkelig diskplass Administratorrettigheter Valg av database Nettverkskonfigurasjon Etablering av testmiljø Etablering av fjernsupport Installere DIPS Communicator Fullføre installasjonen Velg databasemotor Sett passord for Admin brukeren Send statistikk til DIPS ASA Velg pasientjournalsystem Konfigurering Legge inn DIPS Communicator på nye/flere PC er Oppgradere DIPS Communicator Oppgradere fra DBISAM til SQL Server Oppdatering av partnere Oppgradering til bruk av NT-tjeneste Installasjon av Communicator på flere maskiner Avinstallere DIPS Communicator

3 DIPS Communicator Installasjonsveiledning Offisiell 2016 DIPS ASA. All rights reserved. No part of this publication may be reproduced, stored in a retrieval system, transmitted, or published to a third party, in any form or by any means, mechanical, electronic, photocopying, recording, or otherwise, without prior written permission of DIPS ASA. OpenEHR is a registered trademark of OpenEHR Foundation. HL7, CDA, FHIR and the FHIR [FLAME DESIGN] are the registered trademarks of Health Level Seven International. All other trademarks mentioned herein are the property of their respective owners. DIPS ASA Postboks Bodø Norway Historikk Dato Versjon Forfatter Beskrivelse Didrik Widding Omskrevet til Asciidoc for Communicator 7.0. Godkjenning Dato Versjon Godkjent av Stilling Per Arne Engstad Produkteier 1 E N A B L I N G E F F I C I E N T H E A L T H C A R E

4 Offisiell DIPS Communicator Installasjonsveiledning 1. Innledning Denne installasjonsveiledningen inneholder installasjons- og oppgraderingsprosedyrer for DIPS Communicator versjon 7.x I tillegg til denne installasjonsguiden finnes det en brukerveiledning som beskriver konfigurasjon og praktisk bruk av DIPS Communicator Om DIPS Communicator DIPS Communicator er en markedsledende kommunikasjons- og integrasjonsløsning for helsesektoren i Norge i dag. Systemet er utviklet over flere år og løsningen ivaretar alle krav som myndigheter og andre stiller til sikker og pålitelig samhandling i offentlig og privat sektor Kundestøtte Ved behov kan du kontakte DIPS på følgende måter: E-post: kundeservice@dips.no Telefon: (alle hverdager mellom ) 1.3. Nedlasting av nye versjoner DIPS distribuerer primært nye versjoner av DIPS Communicator via samarbeidspartnere. Kunder fra helseforetak kan laste ned nye versjoner fra DIPS Kundeportal: 2. Systemkrav Følgende punkter bør sjekkes før du installerer DIPS Communicator: 2.1. Maskinvare og operativsystem DIPS Communicator støtter alle 32 og 64-bitsversjoner av Microsoft Windows som Microsoft yter kundestøtte på. Se DIPS kan ikke garantere installasjon og bruk av DIPS Communicator på andre enn nevnte operativsystemer. Med innføringen av brukerkontokontroll (UAC) vil skriving av data til C:\Programfiler\ eller C:\Program Files\ i mange tilfeller ikke være mulig uten administratorrettigheter. DIPS Communicator benytter mappestrukturen til lagring av konfigurasjon, meldinger og flatfildatabase. All skriving til disse filene kan feile hvis DIPS Communicator blir installert under de ovennevnte lokasjonene. DIPS Communicator bør derfor installeres til en mappe utenfor programfilområdet til Windows. E N A B L I N G E F F I C I E N T H E A L T H C A R E 2

5 DIPS Communicator Installasjonsveiledning Offisiell Maskinvaremessig stiller DIPS Communicator de samme kravene som operativsystemet. Dersom DIPS Communicator benyttes mot SQL Server, vil maskinvarekrav på maskinen som skal kjøre SQL Server være definert av Microsoft. Hardware- og softwarekrav for å installere SQL Server finnes her: SQL Server 2005: SQL Server 2008: SQL Server 2016: Microsoft.NET Framework DIPS Communicator krever at Microsoft.NET Framework 4.0 er installert for å kunne kjøre meldingsutveksling via FTP. Nedlasting av.net Framework 4.0 gjøres fra følgende side: Tilstrekkelig diskplass Installasjonen av DIPS Communicator krever rundt 210Mb med diskplass på filserver. Sørg for at det finnes nok ledig plass på harddisken før du starter selve installasjonen. I tillegg vil DIPS Communicator kreve diskplass til databaser, konfigurasjonsfiler, meldingskøer, logger osv. Størrelsen på dataområdet til DIPS Communicator vil avhenge av meldingsvolumet. Kontakt gjerne DIPS dersom du er usikker på hvor mye diskplass som systemet vil kreve ut i fra et gitt meldingsvolum Administratorrettigheter Installasjon av DIPS Communicator krever administratorrettigheter i Windows 2003 Server, Windows XP, Windows Vista, Windows 7 og Windows 2008 Server. Kontakt din systemansvarlig dersom du ikke har dette på den maskinen du installerer på. Installasjonsprogrammet til DIPS Communicator vil sjekke at dette er tilfelle før selve installasjonsprosedyren starter. Dersom du installerer DIPS Communicator i et nettverk er det dessuten påkrevd at brukeren som kjører installasjonsprogrammet har skriverettigheter i den katalogen som DIPS Communicator installeres i Valg av database DIPS anbefaler at DIPS Communicator benyttes mot en SQL Server installasjon. Er ikke dette tilgjengelig vil DIPS Communicator benytte en flatfildatabase som datalager (DBISAM). For større institusjoner og virksomheter med et høyt meldingsvolum (> 500 meldinger per dag) vil DIPS normalt kreve at SQL Server benyttes som databasemotor. Følgende må være utført før DIPS Communicator installeres med Microsoft SQL Server: 1. SQL Server må være installert på en datamaskin tilknyttet nettverket. 2. Du må ha tilgjengelig brukernavn og passord til en bruker med adgang til å opprette nye databaser i den aktuelle installasjonen av SQL Server (f.eks. brukere sa). 3 E N A B L I N G E F F I C I E N T H E A L T H C A R E

6 Offisiell DIPS Communicator Installasjonsveiledning Microsoft ADO versjon 2.6 eller bedre kan være installert på alle PC-er som skal kjøre DIPS Communicator. Installasjonsprogrammet for DIPS Communicator vil automatisk installere ADO som en del av både ordinær og nettverksklient installasjon hvis dette ikke ligger inne på datamaskinen fra før Nettverkskonfigurasjon Normalt vil DIPS Communicator være konfigurert til å fungere mot et eller flere fagsystemer i forbindelse med mottak og sending av elektroniske meldinger. Som regel vil DIPS Communicator være installert og driftet i samme sone som de aktuelle fagsystemene. I den grad det eksisterer sikkerhetsbarrierer mellom fagsystemene og DIPS Communicator, må disse konfigureres slik at meldinger kan utveksles direkte (gjennom WebService, MQ, filsystemet osv). Generelt anbefaler DIPS at det benyttes en eller annen form for MQ-teknologi som integrasjonsmetode mellom fagsystemer og DIPS Communicator. Kontakt gjerne DIPS dersom du ønsker en oversikt over hvilke fagsystemer DIPS Communicator kan benyttes mot og hvilke MQ-teknologier DIPS har erfaring med. Hovedbruksområdet for DIPS Communicator vil normalt være sikker og pålitelig meldingsutveksling med eksterne kommunikasjonspartnere. En vanlig protokoll for meldingsutveksling som benyttes i dag er Internet Mail. Sikkerhetsmessig vil da kommunikasjonen være basert på postkassemodellen. I praksis innebærer dette at DIPS Communicator må være i stand til å åpne en TCP/IP-forbindelse fra sin sone og ut til kommunikasjonsnavet (dvs. e-postserveren). Helt spesifikt vil en normal konfigurasjon av DIPS Communicator basert på e-post og PKI kreve følgende: Det må finnes en eller flere EDI-postkontoer (for innkommende meldinger til egen virksomhet). Kunden må ha tilgjengelig X.509 sertifikat-par, utstedt av en offentlig godkjent sertifikatutsteder (CA). Communicator må kunne åpne TCP/IP-forbindelse til SMTP-port (standard 25) og POP3-port (standard 110) for sending og mottak av elektroniske meldinger. Communicator må i standard installasjon ha tilgang til NHN Adresseregisteret. Trafikken går over HTTPS port 443. Verisign revokeringsliste må kunne nås via HTTP port 80. Communicator henter ned sertifikater via PKI-peker i NHN Adresseregister, eventuelt ved hjelp av katalogsøk i Communicator. Dette krever at LDAP port 389 ut til sertifikatutsteders katalogtjeneste er åpen. Communicator sjekker revokeringslister (OCSP) for sertifikater. Ulike sertfikatutstedere benytter ulike adresser. Normalt benyttes OCSP på http port 80, eventuelt LDAP port 389. Adresse for OCSP er definert inne i hvert sertifikat. Hvis adressen ikke nås logges dette som advarsel. DIPS Communicator støtter også en rekke andre topologier og nettverksprotokoller. Kontakt gjerne DIPS dersom du ønsker en gjennomgang av hvordan DIPS Communicator kan fungere i din nettverkskonfigurasjon Etablering av testmiljø For større virksomheter anbefaler DIPS at det etableres et testmiljø som er så likt produksjonsmiljøet som mulig. DIPS har gode erfaringer med bruk av virtualiseringsteknologi (som for eksempel VMWare E N A B L I N G E F F I C I E N T H E A L T H C A R E 4

7 DIPS Communicator Installasjonsveiledning Offisiell eller Virtual PC) som en basis i forhold til etableringen av et testmiljø. Kontakt gjerne DIPS dersom du ønsker bistand eller råd om hvordan et slikt testmiljø kan etableres. Ved oppgradering til nyere versjoner av produktet anbefaler DIPS at ny versjon først utprøves i testmiljøet. Alle versjoner av DIPS Communicator vil inneholde en detaljert versjonshistorikk som beskriver alle revisjoner med dato for en beskrivelse av de endringene (klassifisert i Nyheter, Forbedringer og Feilrettelser ) som er gjort Etablering av fjernsupport For større virksomheter ønsker DIPS muligheten for å kunne etablere en eller annen form for fjernsupport mot den aktuelle installasjonen av DIPS Communicator. 3. Installere DIPS Communicator Kjør filen setup.exe dersom du har lastet ned en versjon av DIPS Communicator fra DIPS Kundeportal/ftp-server, eller fått den gjort tilgjengelig på annen måte. Etter at installasjonsprogrammet har startet følger du instruksjonene på skjermen for å utføre selve installasjonen av DIPS Communicator. Stegene i installasjonen vil være: Å akseptere lisensavtalen. Informasjon om nyheter i denne versjonen. 5 E N A B L I N G E F F I C I E N T H E A L T H C A R E

8 Offisiell DIPS Communicator Installasjonsveiledning Velge installasjonsmappe. Velge opprettelse av startgruppe og snarveier på skrivebordet Fullføre installasjonen Etter at installasjonsprogrammet har opprettet nødvendige mapper og kopiert nødvendige filer til installasjonsområdet vil installasjonsprogrammet kjøre et Update-program". I dette skjermbildet har du følgende valg: Installer Communicator som en NT-tjeneste. Marker denne dersom du ønsker at meldingsutveksling og andre oppgaver som Communicator regelmessig utfører skal kjøre som en NT-tjeneste. Fler-installasjonsstøtte (ASP). Marker denne dersom du skal installere og drifte flere Communicatorinstallasjoner på en og samme server. Dersom du krysser av for dette valget må du også angi en installasjonskode (installasjonsnavn) slik at de ulike Communicator-installasjonene kan skilles fra hverandre (dette er spesielt nyttig dersom flere Communicator-installasjoner logger hendelser til for eksempel Windows Event Log). Klikk deretter [ Neste ] 3.2. Velg databasemotor Her vil du få valget mellom å benytte DBISAM (flatfildatabase) eller Microsoft SQL Server som E N A B L I N G E F F I C I E N T H E A L T H C A R E 6

9 DIPS Communicator Installasjonsveiledning Offisiell databasemotor. Velg i utgangspunktet Microsoft SQL Server. Se Valg av database for mer informasjon. Klikk [ Neste ] Dersom du velger Microsoft SQL Server som databasemotor vises følgende vindu: 7 E N A B L I N G E F F I C I E N T H E A L T H C A R E

10 Offisiell DIPS Communicator Installasjonsveiledning SQL Server instance name: Instansnavn til SQL Server. Kontakt din systemansvarlig dersom du er usikker på hva instansnavnet er. DIPS Communicator database name: Angir databasenavnet som skal benyttes. Vi anbefaler å endre navnet fra standardvalget til et unikt navn kun for installasjonen. Navnet må endres hvis flere DIPS Communicator installasjoner skal installeres mot samme SQL Server. Database security: Use integrated Windows OS security: Benytter rettighetene til pålogget Windowsbruker for å opprette database med tilhørende innhold. Brukeren må på forhånd ha blitt satt opp med de nødvendige bruker-/grupperettigheter i SQL Server før man kan installere databasen. Når programmet er installert må brukere som skal benytte Communicator ha de nødvendige lese- /skriverettigheter satt opp i SQL Server. Use SQL Server security (mixed mode): Benytter den integrerte påloggingsfunksjonen i SQL Server for å opprette databasen med tilhørende innhold. Brukeren som benyttes må minst ha tilgang til å opprette databaser, tabeller og stored procedures samt opprette nye brukere i SQL Server. Vi anbefaler å benytte sa eller en annen bruker satt opp som sysadmin. Hvis en annen sysadmin enn sa benyttes må dette markeres i boksen SysAdmin User?. Videre må det defineres et eget brukernavn under DIPS Communicator application user name. Denne brukeren vil DIPS Communicator benytte i sin kommunikasjon mot SQL Server. Vi anbefaler å endre navnet fra standardvalget til et unikt kun for denne installasjonen. Navnet må endres hvis det skal installeres flere DIPS Communicator installasjoner mot samme SQL Server. E N A B L I N G E F F I C I E N T H E A L T H C A R E 8

11 DIPS Communicator Installasjonsveiledning Offisiell Klikk [ Ok ] for å starte prosessen med å opprette databasen Sett passord for Admin brukeren Du blir nå bedt om å sette passordet til brukeren admin i DIPS Communicator. Dette er viktig slik at installasjonen blir sikret. Det er viktig at du husker dette passordet slik at du senere får tilgang til DIPS Communicator og bl.a. kan opprette nye brukere i systemet. Klikk [ Neste ] 3.4. Send statistikk til DIPS ASA Vi ber om du aksepterer at statistikk sendes til DIPS ASA, noe som gjør oss i stand til å fange opp eventuelle feil på et tidligere tidspunkt. Skjermbildet inneholder nøyaktig informasjon om hva som sendes. 9 E N A B L I N G E F F I C I E N T H E A L T H C A R E

12 Offisiell DIPS Communicator Installasjonsveiledning 3.5. Velg pasientjournalsystem Til slutt i installasjonen kan du spesifisere om DIPS Communicator skal benyttes mot et kjent pasientjournalsystem. Dette gjør det mulig å enkelt konfigurere DIPS Communicator mot et bestemt fagsystem. DIPS Communicator har ferdige integrasjonsprofiler mot en hel rekke fagsystemer. Ved valg av et fagsystem her vil du få opp et eget vindu for å konfigurere egenskapene til fagsystemet, blant annet installasjonskatalog. Dersom du ikke benytter noen av de aktuelle valgene angitt i listen, eller benytter flere forskjellige fagsystemer kan du la dette valget stå til [Ikke definert]. Dette kan også konfigureres etter at installasjonen er gjort. Integrasjon mot pasientjournalsystem eller andre fagsystemer kan også konfigureres på en annen måte under Kanaler og Filmappe i Communicator. Se brukerveiledning for mer informasjon. E N A B L I N G E F F I C I E N T H E A L T H C A R E 10

13 DIPS Communicator Installasjonsveiledning Offisiell Til slutt klikker du [ Neste ], [ Fullfør ], [ Neste ] og [ Ferdig ] for å avslutte installasjonen. DIPS Communicator er nå installert. 4. Konfigurering For å kunne sende og motta meldinger er det nå nødvendig å konfigurere systemet. Hvordan dette gjøres, er beskrevet i brukerveiledningen for DIPS Communicator Legge inn DIPS Communicator på nye/flere PC er Når man allerede har en installasjon, men ønsker å kjøre DIPS Communicator på flere klienter må man gjøre følgende: 1. Gå til området der DIPS Communicator er installert, videre inn i mappa Program og finn og kjør fila dorisupd.exe. 11 E N A B L I N G E F F I C I E N T H E A L T H C A R E

14 Offisiell DIPS Communicator Installasjonsveiledning 1. Velg Registrer eksterne komponenter. 2. Klikk [ Neste ] 3. Når dialogen viser Oppdatering ferdig, klikk OK for å avslutte. 4. Lag deretter snarvei på Skrivebordet til doriscom.exe. 5. Oppgradere DIPS Communicator For å oppgradere en DIPS Communicator installasjon er det i utgangspunktet bare nødvendig å kjøre installasjonsprogrammet på nytt. Dersom oppgraderingen gjøres fra samme maskin som opprinnelig installasjon, vil installasjonsprogrammet automatisk finne opprinnelig installasjonsmappe for produktet. Det er ikke nødvendig å avinstallere eksisterende versjon av DIPS Communicator før oppgradering gjøres. Eventuelle NT tjenester som DIPS Communicator benytter vil stoppes før oppgradering, og startes opp igjen når oppgraderingen er ferdig. En oppgradering av DIPS Communicator vil automatisk oppdatere databasen dersom det har skjedd strukturelle endringer siden siste versjon. Tilsvarende vil programfiler også bli oppdatert. Før en oppgradering må man ta en back-up av databasen og programkatalogen som med config-katalogen Oppgradere fra DBISAM til SQL Server Det er fullt mulig i ettertid å oppgradere en DBISAM-installasjon av DIPS Communicator til å benytte SQL Server. For å oppgradere fra DBISAM til SQL Server, kjør programmet dorisupz.exe som ligger i mappen Program til DIPS Communicator. E N A B L I N G E F F I C I E N T H E A L T H C A R E 12

15 DIPS Communicator Installasjonsveiledning Offisiell Klikk [ Upsize now ]. Fremgangsmåten videre er den samme som når man installerer en ny DIPS Communicator mot SQL Server. Se Velg databasemotor. Under prosessen med å flytte data fra DBISAM til SQL Server vil dialogen vise fremgangen. Ved oppgradering fra DBISAM til SQL Server er det vanlig at det fremkommer feilmeldinger i oppgraderingsloggen av typen referential constraint errors. Dette skyldes at databasestrukturen er mer entydig og bedre definert ved bruk av SQL Server. Når oppgraderingen er ferdig vil det øverst i dialogen stå Update finished. Klikk [ OK ] for å avslutte oppgraderingsprogrammet. Installasjonen av DIPS Communicator vil nå benytte SQL Server for datalagring Oppdatering av partnere Ved oppgradering til ny versjon av DIPS Communicator er det mulig å få importert og registrert nye partnere med deres sikkerhetssertifikat, slik at denne registrering skjer automatisk. Automatisk registrering av partnere kan være hensiktsmessig ved massedistribusjon av DIPS Communicator til kunder, mens manuell registrering anbefales for kunder som selv laster ned ny versjon via DIPS Kundeportal. Automatisk registrering eller oppdatering av partner: 1. Kopier filen setup.exe til installasjonsmappen til DIPS Communicator. 13 E N A B L I N G E F F I C I E N T H E A L T H C A R E

16 Offisiell DIPS Communicator Installasjonsveiledning 2. I installasjonsmappen, opprett underkatalogene.\import\partners. 3. Legg til de ønskede kommunikasjonspartnerne i.\import\partners. 4. Start oppgradering av DIPS Communicator ved å kjøre filen setup.exe i installasjonsmappen. 5. Følg instruksjonene under oppgradering og etter endt oppgradering skal partneren ligger inne i DIPS Communicator. Manuell registrering eller oppdatering av partner: For manuell registrering eller oppdatering av partner, se beskrivelse av hvordan dette gjøres i menyen Hjelp Brukerguide i DIPS Communicator Oppgradering til bruk av NT-tjeneste Dersom installasjonen ble gjort uten at dette ble valgt, og man ønsker å kjøre Communicator som en NT-tjeneste, kan man gjøre følgende: 1. Åpne kommandolinje og gå til stien der Communicator er installert: Eks. "cd c:\dips\program" 2. Skriv inn "dorissrv.exe /install". Klikk OK på dialogen som kommer opp. 3. For å starte NT-tjenesten kan man enten skrive inn "net start DIPSComTaskService" eller gå til Management Services, se etter DIPSComTaskService og starte den der. Merk at hvis Communicator kommuniserer med nettverksstasjoner på andre servere og/eller bruker en SQL Server-database som er installert på en annen server, må man endre Login i egenskaper for servicen til en bruker som har tilganger til de nevnte ressursene. Servicen får SYSTEM-bruker som standard, og den har jo som kjent kun tilganger lokalt på maskinen der Communicator er installert Installasjon av Communicator på flere maskiner Noen ønsker at installasjonen av DIPS-Communicator skal ligge på en maskin (typisk et fileshare) mens det finnes flere maskiner (klient-pc) i nettverket som skal benytte denne. I dette tilfellet må man gjøre følgende fra hver av klientmaskinene. 1. Kjøre dorisupd.exe som ligger i katalogen <share>\<installasjonsmappe for Communicator>\Program. Velg Registrer eksterne komponenter i dialogen som kommer opp. Dette gjøres på hver av klientmaskinene. 2. Lage snarvei til doriscom.exe på klientmaskinen Avinstallere DIPS Communicator Dersom du ønsker å avinstallere DIPS Communicator så bør dette gjøres fra Windows Kontrollpanel. Ved avinstallering stoppes eventuelle NT tjenester som DIPS Communicator benytter automatisk som en del av avinstalleringsprosedyren. E N A B L I N G E F F I C I E N T H E A L T H C A R E 14

17 DIPS Communicator Installasjonsveiledning Offisiell Ved avinstallering vil eventuelle data- og konfigurasjonsfiler som DIPS Communicator har opprettet i etterkant av installasjon/oppgradering, ikke bli slettet av avinstalleringsprosedyren. I den grad disse filene inneholder sensitive/uønskede data, så må disse filene slettes fra disken manuelt. 15 E N A B L I N G E F F I C I E N T H E A L T H C A R E