Systemintegration: Butterfly-Link-Installationsanleitung

Butterfly Cloud kann über eine sichere DICOM-TLS-Verbindung oder über Butterfly Link (enthalten in Enterprise-Mitgliedschaften) eine Verbindung zu den DICOM-Endpunkten in Ihrer Organisation herstellen. 

So verwenden Sie diesen Leitfaden

Das Ziel dieser Anleitung besteht darin, Administratoren der Butterfly Cloud dabei zu helfen, die DICOM- und HL7-Kommunikation zwischen Butterfly Cloud und dem DICOM-Archiv, der Arbeitsliste oder den ePAs des Kunden mithilfe von Butterfly Link einzurichten. Butterfly Link ist mit Butterfly-Enterprise-Mitgliedschaften verfügbar.

In diesem Dokument werden die Schritte für die Installation von Link V1 erläutert. Wenn Sie Link V2 installieren, wenden Sie sich bitte an Ihren Integrations Engineer, um Hilfe zu erhalten.

Butterfly Link

Einführung

Diese Anleitung gibt einen Überblick über die Installation der Butterfly-Link-Software und dient als Referenz für Administratoren. Die Butterfly-Cloud-Anwendung ist eine Windows-Softwareanwendung, die auf einem Server oder einer Workstation installiert wird und die DICOM- und/oder HL7-Endpunkte einer medizinischen Einrichtung sicher mit Butterfly Cloud verbindet. Butterfly Link kommuniziert mit DICOM-Geräten (PACS, Ultraschallmodalitäten und Modality Worklists), um über das Netzwerk der medizinischen Einrichtung medizinische Bilddaten zu senden und zu empfangen. Die Software kann auch HL7-Daten zwischen Butterfly Cloud und dem ePA oder der/den Schnittstellen-Engine(s) der Einrichtung senden und empfangen. Butterfly Link kommuniziert über eine ausgehende, verschlüsselte WebSocket-Verbindung mit Butterfly Cloud und nutzt diese Verbindung für die bidirektionale Datenübertragung.

Der Butterfly Link kann sowohl mit als auch ohne DICOM-Router verpackt werden, der zur Verwaltung der Speicher- und Weiterleitungsfunktionen dient. Der Butterfly Link mit einem DICOM-Router verfügt über bestimmte Speicher- und Rechenkapazitäten, basierend auf der Anzahl der Geräte und Studien, für die Sie täglich Daten verarbeiten möchten. Bitte arbeiten Sie mit Ihrem Butterfly-Implementierungsteam zusammen, um die VM für den Butterfly Link nach Bedarf zu dimensionieren.

Häufig gestellte Fragen (FAQ)

Wie funktioniert Butterfly Link?

Butterfly Link ist eine ausführbare 64-Bit-Windows-Datei, die im Hintergrund als Windows-Dienst ausgeführt wird. 

Butterfly Link stellt eine verschlüsselte ausgehende WebSocket-Verbindung zur Butterfly Cloud her. Diese Verbindung wird dann für den bidirektionalen Datenfluss verwendet.Die Verbindung ist mit zwei Schutzebenen gesichert:

• Ein krankenhausspezifischer Sicherheitscode, der zu Beginn jeder Sitzung mit Butterfly-Datensätzen abgeglichen wird.
• TLS-1.2-Verschlüsselung

Brauchen wir einen dedizierten Server für Butterfly Link?

Nein, ein dedizierter Server ist nicht erforderlich. Die Software läuft im Hintergrund auf einem aktuellen Anwendungsserver, sofern dieser die Mindestanforderungen erfüllt.

Kann die Software in einer VM-Umgebung ausgeführt werden?

Ja, Butterfly Link kann auf einer VM ausgeführt werden, solange der Server eingeschaltet bleibt, den Spezifikationen entspricht und über eine statische IP-Adresse verfügt.

Müssen wir spezielle Backups der Software erstellen?

Wenn Sie den verpackten DICOM-Router mit dem Butterfly Link verwenden, sollten Sie sicherstellen, dass es einen Prozess zur Datensicherung auf einem Datenträger gemäß den Datenaufbewahrungs- und Sicherungsrichtlinien Ihrer Organisation gibt. Butterfly speichert die Daten erst, wenn sie erfolgreich gesendet und vom Butterfly-Link-DICOM-Dienst bestätigt wurden. 

Muss sich der Server in der DMZ befinden?

Nein.

Welche Verschlüsselung verwenden Sie, um Daten zur/von der Butterfly Cloud zu übertragen?

TLS 1.2 wird für alle Datenübertragungen zwischen Butterfly Link und Butterfly Cloud verwendet.

Was sind die Netzwerkanforderungen?

Der Server, auf dem Butterfly Link gehostet wird, muss mit Ihren internen DICOM- und HL7-Endpunkten über TCP kommunizieren können. Gemäß den Systemanforderungen muss auch der ausgehende HTTPS-Zugriff auf Butterfly Cloud zugelassen sein.

Systemanforderungen

Die installierende Person sollte sich vergewissern, dass sie vor der Installation von Butterfly Link über Administratorrechte für die Butterfly Cloud verfügt.

• Aufgrund der Windows Benutzerkontensteuerung und der Notwendigkeit, den Dienst zu registrieren, benötigt die installierende Person lokale Administratorrechte, um Software auf dem Gerät zu installieren.
• Der Hosting-Server muss über eine statische oder reservierte IP-Adresse im lokalen Netzwerk verfügen.
• Der Hosting-Server muss Internetzugriff haben.
• Das System muss auf Windows Server 2016 oder höher (64-Bit) laufen.

Hosting-Server-Anforderungen für Butterfly Link mit DICOM-Router

• Ein Computer oder eine VM mit Windows Server 2016 oder höher (64 Bit)
• 2 vCPU
• 4 GB RAM
• 10 GB freier Speicherplatz auf der Festplatte
• Netzwerkzugang zu dem LAN, über das die Krankenhausservices zugänglich sind (d. h. ePA, PACS, MWL, Ultraschallgeräte von Drittanbietern)

Empfohlene Konfiguration

Dienstkonto

• Verwenden Sie ein von der Domäne verwaltetes oder lokales Dienstkonto.
• Das Konto sollte Mitglied der Benutzergruppe mit den folgenden Berechtigungen sein:
  • Als Dienst anmelden
  • RWX im Link-Installationspfad – C:\Programme\Butterfly Link\AntiVirus Considerations
• Die folgenden Ordner sollten vom Antiviren-Scan ausgeschlossen werden:
  • C:\Program Files\Butterfly Link
  • C:\ ProgramData\Butterfly Link
• Firewall oder Proxy
  • Der Butterfly-Link-Dienst stellt eine ausgehende Verbindung zur Butterfly Cloud her. Wahrscheinlich müssen die Firewall-Regeln dafür nicht angepasst werden, das hängt jedoch von Ihrer spezifischen Netzwerkkonfiguration ab.
  • Die Butterfly-Link-Software sollte mit einer Ausnahme für den Proxy eingerichtet werden. Der Grund dafür ist, dass wir durch Zertifikat-Pinning eine verschlüsselte End-to-End-Konnektivität gewährleisten, ohne dass diese von einem dazwischengeschalteten Proxy entschlüsselt werden kann.
• Stellen Sie sicher, dass Butterfly Link über HTTPS mit Hosts in der folgenden DNS-Subdomain kommunizieren kann:
  • *.cloud.butterflynetwork.com
• Ihre Organisation ist dafür verantwortlich, sicherzustellen, dass die Antivirenprogramme oder Anwendungs-Firewalls die ordnungsgemäße Funktion von Butterfly Link nicht beeinträchtigen, weder durch lokale Unterbrechung der Netzwerkaktivitäten noch durch Unterbrechung der Butterfly-Link-Prozesse. Die Butterfly-Implementierungsteams werden ihr Bestes tun, um zu ermitteln, welche Prozesse möglicherweise den Server beeinträchtigen, können jedoch letztendlich nicht die gesamte zugrunde liegende Infrastruktur Ihres Netzwerks kennen.

Hosting-Server-Anforderungen für Butterfly Link mit DICOM-Router

Da Butterfly Link mit DICOM-Router die Speicherung von Untersuchungen zwischen Ultraschallgeräten und der Butterfly Cloud auf dem Router ermöglicht, sollten Sie eine Speicherung von Untersuchungen auf dem Server ermöglichen, um so Ihre Anforderungen an den Datendurchsatz zu erfüllen. Butterfly stellt bestimmte Richtlinien für Rechenleistung, Arbeitsspeicher und Datenspeicher bereit, die auf bestimmten Durchsatzprofilen basieren. Wenn die Rechenleistung, der Arbeitsspeicher oder der Speicherplatz auf dem Butterfly-Link-Server nicht ausreicht, bleiben Untersuchungen in den Warteschlangen der angeschlossenen Ultraschallgeräte, während Butterfly Link vorhandene Untersuchungen verarbeitet. Daher sollten Sie die Kapazität der Butterfly Links testen und entsprechend planen. 

Mindestanforderungen

• vCPU – 6 Kerne
• Arbeitsspeicher – 16 GB RAM
• Festplatte – 32 GB, ausgehend von ca. 15 Untersuchungen pro Stunde
• .NET Framework 4.7.1 muss auf dem System installiert sein

Mittlere Anforderungen

• vCPU – 12 Kerne
• Arbeitsspeicher – 48 GB RAM
• Festplatte – 125 GB, ausgehend von ca. 40 Untersuchungen pro Stunde
• .NET Framework 4.7.1 muss auf dem System installiert sein

Hohe Anforderungen

• vCPU – 16 Kerne
• Arbeitsspeicher – 64 GB RAM
• Festplatte – 250 GB, ausgehend von ca. 40 Untersuchungen pro Stunde
• .NET Framework 4.7.1 muss auf dem System installiert sein

Empfohlene Konfiguration

Dienstkonto:

• Verwenden Sie ein domainverwaltetes oder lokales Dienstkonto. 
• Das Konto sollte Mitglied der Benutzergruppe mit den folgenden Berechtigungen sein:
  • Als Dienst anmelden
  • RWX im Link-Installationspfad – C:\Programme\Butterfly Link\
• Berechtigungen auf Administratorebene (lokal oder Domäne) werden für die Ausführung des Butterfly-Link-Dienstes nicht empfohlen.

Hinweise zu AntiVirus, Firewall and Proxy: 

• Sie sind dafür verantwortlich, sicherzustellen, dass die Antivirensoftware die von Butterfly bereitgestellten Windows-Dienste nicht beendet bzw. die auf der Festplatte gespeicherten Dateien nicht in Quarantäne verschiebt/löscht/die Berechtigungen dafür verwaltet. Der Butterfly Link-Dienst stellt eine ausgehende Verbindung zur Butterfly Cloud her. Die Firewall-Regeln müssen wahrscheinlich nicht angepasst werden, dies hängt jedoch von Ihrer spezifischen Netzwerkkonfiguration ab.
  • Die folgenden Ordner sollten vom Antiviren-Scan ausgeschlossen werden:
    • C:\Program Files\Butterfly Link
    • C:\ ProgramData\Butterfly Link
• Die Butterfly-Link-Software sollte mit einer Ausnahme für den Proxy eingerichtet werden. Der Grund dafür ist, dass wir durch Zertifikat-Pinning eine verschlüsselte End-to-End-Konnektivität gewährleisten, ohne dass diese von einem dazwischengeschalteten Proxy entschlüsselt werden kann.
• Stellen Sie sicher, dass Butterfly Link über HTTPS mit der folgenden Subdomain und dem folgenden IP-Adressbereich kommunizieren kann. Der DICOM-Router und Butterfly Link nutzen separate Whitelisting-Mechanismen für ihre Internetkommunikation:
  • *.cloud.butterflynetwork.com
  • 198.102.255.0/24 und 209.163.96.0/23
• Ihre Organisation ist dafür verantwortlich, sicherzustellen, dass die Antivirenprogramme oder Anwendungs-Firewalls die ordnungsgemäße Funktion von Butterfly Link nicht beeinträchtigen, weder durch lokale Unterbrechung der Netzwerkaktivitäten noch durch Unterbrechung der Butterfly-Link-Prozesse. Die Butterfly-Implementierungsteams werden ihr Bestes tun, um zu ermitteln, welche Prozesse möglicherweise den Server beeinträchtigen, können jedoch letztendlich nicht die gesamte zugrunde liegende Infrastruktur Ihres Netzwerks kennen.

Installationsanleitung

Die Software herunterladen

• Melden Sie sich mit Ihrem Browser bei Butterfly Cloud an (cloud.butterflynetwork.com oder ihredomain.butterflynetwork.com). Stellen Sie sicher, dass Ihre Benutzerrolle in Butterfly Cloud „Unternehmensadministrator“ ist. Diese ist nur verfügbar, wenn Ihre Lizenzstufe die Nutzung von Butterfly Link ermöglicht. Bitte wenden Sie sich an den Butterfly-Support, wenn Sie nicht sicher sind, ob Ihre Softwarestufe auch Butterfly Link umfasst. 
• Navigieren Sie zum Menü „Verbindungen“, indem Sie oben rechts im Fenster auf Ihren Benutzernamen klicken und „Unternehmenseinstellungen“ auswählen.

 

• Navigieren Sie zum Abschnitt „Konnektivität“ und klicken Sie im Abschnitt „Verbindungen“ auf die Option „+ Hinzufügen“. Wählen Sie dann „Butterfly Link“, um eine neue Butterfly-Link-Verbindung zu erstellen.

• Laden Sie das Butterfly-Link-Installationsprogramm auf Ihren Windows-Hostcomputer herunter.
• Kopieren Sie den geheimen Installationsschlüssel – er wird für die Softwareinstallation benötigt.
• Geben Sie der Butterfly-Link-Verbindung einen benutzerfreundlichen Namen.  Klicken Sie auf „Butterfly Link speichern“.

• Sie sollten eine Bestätigung Ihrer Butterfly-Link-Verbindung sehen.
• Falls Sie den Namen ändern oder die Butterfly-Link-Verbindung entfernen müssen, wählen Sie die Option „Bearbeiten“.

Die Software installieren

• Führen Sie die Datei „butterfly-link-installer.exe“ aus, die Sie von Butterfly Cloud heruntergeladen haben.
• Geben Sie den geheimen Schlüssel ein, den Sie während des Schritts zur Erstellung der Butterfly-Link-Verbindung erhalten haben.  Klicken Sie auf „Installieren“.
  • Hinweis: Derzeit können Integrationen nicht bearbeitet werden. Wenn der geheime Schlüssel also verlorengeht, muss die Integration vollständig neu angelegt werden. Bewahren Sie den geheimen Schlüssel für die zukünftige Verwendung/Fehlerbehebung an einem geeigneten Ort auf.
• Der Installationspfad lautet: C:\Programme\Butterfly Link\

• Schließen Sie das Installationsfenster nach Abschluss.

Butterfly-Link-Dienst überprüfen

• Führen Sie die Windows-Diensteverwaltungsanwendung aus.
• Suchen Sie den Butterfly-Link-Dienst und überprüfen Sie, ob sein Status „Wird ausgeführt“ lautet.

• Sie können das Konto „Anmelden als“ nach Bedarf bearbeiten.

Integrationskonfiguration

Nun können Sie die entsprechenden DICOM- oder HL7-Integrationen für Ihre internen Systeme erstellen, indem Sie sie mit der neu eingerichteten Butterfly-Link-Verbindung verknüpfen. Mehrere DICOM- oder HL7-Integrationen können mit derselben Butterfly-Link-Verbindung verknüpft werden und die Verbindung gleichzeitig nutzen.

DICOM: Integrationen mit PACS/VNA oder Modalitäts-Arbeitsliste

• Das Menü „Integrationen“ befindet sich auf der Registerkarte „Verbindungen“, direkt unter dem Abschnitt „Verbindungen“.
• Klicken Sie auf die Option „+ Hinzufügen“ neben „Integrationen“ und wählen Sie PACS/VNA oder MWL aus, um eine neue Verbindung mit dem DICOM-Speicher oder der Modalitäts-Arbeitsliste zu erstellen.

• Geben Sie einen benutzerfreundlichen Namen für den DICOM-Endpunkt ein, den Sie hinzufügen. Wählen Sie als Verbindungstyp die zuvor erstellte Butterfly-Link-Verbindung aus.

• Nachdem Sie den Verbindungstyp ausgewählt haben, wird der DICOM-Konfigurationsbildschirm angezeigt.
• Geben Sie dann alle erforderlichen DICOM-Verbindungsparameter ein.
  • Beachten Sie, dass die IP-Adresse dem DICOM-Endpunkt entsprechen muss, auf den von dem Computer aus zugegriffen werden kann, auf dem die Butterfly-Link-Software gehostet wird.
  • Wenn ein Hostname verwendet wird, muss dieser für den Computer, auf dem Butterfly Link gehostet wird, auflösbar sein. Klicken Sie auf „Speichern“, wenn Sie fertig sind.

Beispielhafte Konfigurationsbildschirme für DICOM-PACS/-VNA/-Arbeitsliste.

Hinweis

• Wenn Ihr PACS/VNA nicht im Promiscuous-Modus arbeitet, müssen Sie die AE-Bezeichnung von Butterfly Cloud als zugelassene DICOM-Quelle hinzufügen.
• Bitte beachten Sie, dass das PACS die IP-Adresse des Servers, auf dem Butterfly Link gehostet wird, als Quelle der DICOM-Daten aus der Butterfly Cloud betrachtet.

HL7: EHR-Integrationen

• Das Menü „Integrationen“ befindet sich auf der Registerkarte „Verbindungen“, direkt unter dem Abschnitt „Verbindungen“.
• Klicken Sie neben Integrationen auf die Option „+ Hinzufügen“ und wählen Sie EHR aus, um eine neue HL7-Verbindung zu erstellen.

• Geben Sie einen benutzerfreundlichen Namen für den HL7-Endpunkt ein, den Sie hinzufügen. Wählen Sie als Verbindungstyp die zuvor erstellte Butterfly-Link Verbindung aus.

• Nachdem Sie den Verbindungstyp ausgewählt haben, wird ein Bildschirm zur Konfiguration des HL7-Ziels angezeigt.
• Geben Sie dann alle erforderlichen HL7-Verbindungsparameter ein.
  • Beachten Sie, dass die IP-Adresse dem HL7-Endpunkt entsprechen muss, auf den von dem Computer aus zugegriffen werden kann, auf dem die Butterfly-Link-Software gehostet wird.
  • Wenn ein Hostname verwendet wird, muss dieser für den Computer, auf dem Butterfly Link gehostet wird, auflösbar sein. Klicken Sie auf „Speichern“, wenn Sie fertig sind.

Beispielhafter Konfigurationsbildschirm für die Konfiguration des HL7-Ziels.

Überprüfen der DICOM-Verbindung und automatische Weiterleitung

Überprüfen der Verbindung von Butterfly Cloud

• Navigieren Sie anschließend zum Abschnitt „Integrationen“, der sich auf der Registerkarte „Konnektivität“ direkt unter dem Abschnitt „Verbindung“ befindet.

 

• Klicken Sie auf die drei Punkte neben einer DICOM-Verbindung. Wählen Sie die Option „Echo“, um ein DICOM C-ECHO von Butterfly Cloud durchzuführen.
• Überprüfen Sie, ob die Ausgabe ungefähr folgendermaßen aussieht:

• Sie haben eine sichere Verbindung zu Ihrem DICOM-Ziel eingerichtet. Sie können jetzt Bilddaten senden oder die Modalitäts-Arbeitsliste abfragen.

(Optional) – Automatische Weiterleitung an den DICOM-Speicher

1. Um alle in einem Butterfly Cloud-Ordner gespeicherten Studien automatisch an Ihren DICOM-Endpunkt zu senden, können Sie diesen mit einem Archiv verknüpfen.
2. Wählen Sie den Archivordner aus, den Sie mit der DICOM-Verbindung verknüpfen möchten.  Wählen Sie „Archiveinstellungen“.
   
   
3. Wählen Sie den DICOM-Speicherort aus, der dem Archivordner zugeordnet werden soll.
   
   
4. Nun wird jede (mit der Butterfly iQ™-App) in diesem Ordner gespeicherte Studie automatisch an das ausgewählte DICOM-Ziel weitergeleitet.