Zum Inhalt

Installation der charly-VM

Diese Anleitung beschreibt die Installation und den Betrieb der Container (charly-VM) unter Windows.

Die ncjs-Services werden in einer Linux-VM betrieben. In dieser VM läuft jeder ncjs-Service in einem eigenen Docker-Container.

WICHTIG

Beachten Sie, dass in Folge des Updates auf Container sich die IP und diverse Ports ändern. Konfigurieren Sie Drittanbieter-Software entsprechend um.

  • iOS-Apps verwenden statt Port 8086 nun Port 11052
  • Firewall der Praxis anpassen: Ports von 11040-11060 freigeben
  • Stellen Sie sicher, dass nach dem Container Update die Daisy-Dateien neben der neuen Ablage liegen

WICHTIG

Passen Sie den DHCP-Server der Praxis an: Macadresse der VM an die gewünschte IP binden

WICHTIG

Falls Sie ein Multimandantensystem betreiben, kann aktuell kein Update in die Containerlösung durchgeführt werden.

TIPP

Falls Sie unter ..\Solutio\Server\ncjs\conf2\microservice.descriptor individuelle Einstellungen für die ncjs-Services nutzen, notieren Sie sich diese Einträge vorab.

Systemvoraussetzungen

Es gelten die bisherigen Systemvorausetzungen.

Es muss außerdem ein DHCP-Server verfügbar sein, damit der Linux-VM während der Installation eine IP-Adresse zugewiesen wird.

Einleitung

Festplatten-Images der charly-VM

Die charly-VM speichert ihre Daten in vier Festplatten-Images ab. Drei davon sollten auf schnellen, internen Festplatten gespeichert werden. Die Images haben die Endung .vhdx. Die vier Festplatten Images können auf unterschiedlichen Festplatten gespeichert werden.

Der benötigte freie Speicherplatz hängt stark von der Datenmenge Ihrer Praxis ab. Empfohlen werden mindestens folgende Werte:

Image Beschreibung mindestens benötigter freier Speicherplatz
charly-system Enthält die Daten des Linux Systems, die nicht in einem anderen Image gespeichert werden. Dies sind allgemeine Daten, die nicht nutzerspezifisch sind. Diese Daten werden durch die Installation und den Update Prozess erzeugt. 100 GB
charly-data Enthält die Daten der PostgreSQL Datenbank. D.h. die Datenbank speichert Änderungen in dieses Image. Es enthält jedoch keine Backups. 1 TB
charly-files Enthält die charly Ablage. D.h. charly speichert Änderungen von Dateien in dieses Image. Es enthällt jedoch keine Backups. Die Ablage wird durch die charly-VM über ein Samba-Share zur Verfügung gestellt. 1 TB
charly-backup Enthält Backups der PostgeSQL Datenbank und der Ablage. Backup und Restore der Datenbank 1 TB

Die Images charly-system, charly-data und charly-files sollten auf einer schnellen internen SSD-Festplatte gespeichert werden. Es sollte insgesamt mindestens 500 GB freier Speicherplatz verfügbar sein.

Das Image charly-backup kann auf einer schnellen internen SSD-Festplatte gespeichert werden. Es kann aber auch eine HDD Festplatte oder eine externe USB SSD Festplatte sein.

WICHTIG

Die Festplatten-Images sehen für das Hostsystem wie große Dateien aus. Es sollte unter keinen Umständen versucht werden, diese zu mounten oder anderweitig zu verändern, da so die charly-VM beschädigt werden könnte.

WICHTIG

Die Pfade der Festplatten-Images werden bei der Installation festgelegt und sind aktuell nicht ohne Weiteres umkonfigurierbar. Wählen Sie die Pfade entsprechend bewusst.

Verwendung des charly-Server-Skripts

Die Container (charly-VM) werden durch ein zentrales Skript verwaltet. Dieses bietet verschiedene Kommandos an, durch welche die VM z.B. installiert, aktualisiert, gestartet oder gestoppt werden kann.

Oft ist das charly-Server-Skript bereits installiert. Um dies herauszufinden, rufen Sie es in der Powershell von einem beliebigen Ort auf (ohne vorangestelltes '.\', ohne ps1-Endung):

Windows Administrator Powershell: 

charly-server

Wenn das charly-Server-Skript bereits installiert ist, erscheint nun die Hilfe mit einer Übersicht aller möglichen Parameter. Ansonsten muss das charly-Server-Skript installiert werden. Führen Sie dazu folgende Befehle in der Powershell (mit Administratorrechten) aus:

Invoke-WebRequest -Uri "https://charly-cdn-solutio.s3.amazonaws.com/release/windows/charly-server-install.ps1" -OutFile ".\charly-server-install.ps1"

Set-ExecutionPolicy RemoteSigned -Force

.\charly-server-install.ps1

Wenn es zu einem Problem beim Download kommt, können Sie noch probieren TLS in der PowerShell zu setzen.

[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12

Vorbereitungen

Vor der Installation müssen unter Windows noch vorbereitende Schritte durchgeführt werden.

TIPP

Erstellen Sie eine Liste aller Hardware und Software die Sie in Kombination mit charly betreiben. Prüfen Sie im Anschluss an das Update ob Sie die Geräte und Anwendungen wie gewohnt verwenden können. Passen Sie die Konfigurationen gegebenenfalls an.

HyperV unter Windows-Server Betriebssystem aktivieren

Unter Windows muss die Virtualisierung „HyperV" aktiviert werden.

  1. Öffnen Sie den Server-Manager.
  2. Klicken Sie auf Verwalten > Rollen & Features hinzufügen.
  3. Default: Rollenbasierte oder featurebasierete Installation.
  4. Wählen Sie aus dem Serverpool Ihren Server aus.
  5. Wählen Sie Hyper-V und falls vorhanden Hyper-V-Tools aus.
  6. Folgen Sie den weiteren Installationsanweisungen zum Neustarten Ihres Computers, um die Aktivierung abzuschließen.

Erstellen eines externen Switches

Unter Windows muss vor der Installation ein externer Switch angelegt werden, sofern noch keiner existiert. Falls Sie bereits für andere virtuelle Maschinen einen solchen externen Switch angelegt haben, können Sie diesen auch für die charly-VM verwenden. Falls Sie einen externen Switch anlegen müssen, gehen Sie wie folgt vor:

WICHTIG

Beim Erstellen des Switches wird für kurze Zeit der Netzwerkadapter getrennt und der Server hat für ein paar Sekunden keine Netzwerkverbindung. Beachten Sie dies beim folgenden Vorgehen!

  1. Starten Sie den Hyper-V-Manager.
  2. Klicken Sie rechts unter Aktionen auf Manager für virtuelle Switches...
  3. Falls Sie bereits einen externen Switch erstellt haben, erscheint er im sich öffnenden Fenster im linken Bereich in der Liste. Falls nicht:
  4. Im linken Bereich sollte bereits Neuer virtueller Netzwerkswitch ausgewählt sein und im rechten Bereich die Auswahl auf Extern stehen.
  5. Klicken Sie auf Virtuellen Switch erstellen unter der Liste der Switch-Arten.
  6. Hier können Sie dem virtuellen Switch einen Namen geben, den Sie später bei der Installation der charly-VM angeben müssen.
  7. Stellen Sie sicher, dass als Verbindungstyp Externes Netzwerk ausgewählt ist. Hier können Sie einen Netzwerkadapter auswählen, den der virtuelle Switch verwenden soll. (Default: ExternalSwitch)
  8. Stellen Sie zusätzlich sicher, dass das Häkchen bei Gemeinsames Verwenden dieses Netzwerkadapters für das Verwaltungsbetriebssystem zulassen gesetzt ist.
  9. Erstellen Sie den virtuellen Switch mit Klick auf Anwenden oder OK.
  10. Alle diese Einstellungen, bis auf den Namen, sollten standardmäßig richtig eingestellt sein.
  11. Falls Sie den Namen des externen Switches ändern möchten, tun Sie dies bitte in Hyper-V und nicht in der Systemsteuerung bei den Adaptereinstellungen.

Überprüfen der Netzwerkkonfiguration

Bevor Sie mit der Installation beginnen, stellen Sie sicher, dass Ihre Netzwerkkonfiguration korrekt ist:

  1. Überprüfen Sie die DNS-Server-Einstellungen auf Ihren virtuellen Switches im Hyper-V-Manager.
  2. Stellen Sie sicher, dass die DNS-Server-Adressen auf aktuelle, funktionierende Server verweisen.
  3. Testen Sie die Namensauflösung mit dem folgenden Befehl in der PowerShell: 
    nslookup www.solutio.de
    Wenn die Namensauflösung funktioniert, sollten Sie eine IP-Adresse als Antwort erhalten.
  4. Überprüfen Sie die Internetverbindung mit einem Ping-Test: 
    ping www.example.com

Wenn diese Tests erfolgreich sind, können Sie mit der Installation fortfahren. Falls nicht, überprüfen und korrigieren Sie Ihre Netzwerk- und DNS-Einstellungen, bevor Sie fortfahren.

Überprüfen der Energieoptionen

Überprüfen Sie, dass im Energiemanagement des Betriebssystems keine Einstellung für den Energiesparmodus bei Inaktivität aktiviert ist.

Installation der Container (charly-VM)

Führen Sie in der Windows Powershell (mit Administratorrechten) folgenden Befehl aus: 

charly-server install

Das charly-server-Skript wird Sie durch die Installation leiten. Folgende Einstellungen werden vom charly-server-Skript angefragt:

Einstellungen Beschreibung
Name des externen Switches Vor der Installation sollte ein externer Switch konfiguriert werden. Dieser wird benötigt, damit die VM über das Netzwerk erreichbar ist.
CPU-Kerne Abhängig von den verfügbaren (virtuellen) CPU-Kernen, sollten möglichst viele für die charly-VM verwendet werden, typischerweise alle verfügbaren Kerne bis auf 2, um dem Windows 2 Kerne zu überlassen (z.B. das System hat 12 Kerne -> 10 Kerne für die VM). Wenn Sie andere Programme auf dem System ausführen müssen, die erhebliche Rechenleistung erfordern (z.B. Röntgen/DVT-Anwendungen), können Sie mit weniger Kernen beginnen, jedoch mindestens 4. Seien Sie jedoch darauf vorbereitet, die Anzahl der Kerne in der VM später manuell zu erhöhen, wenn mehr Ressourcen benötigt werden.
RAM Arbeitsspeicher in GB Abhängig vom verfügbaren Arbeitsspeicher, aber mindestens 24
Pfad für die VM Dateien und Images Der Pfad, in dem alle Dateien für die VM und Festplatten-Images abgespeichert werden, sofern nicht nachfolgend anders konfiguriert. Dieser Pfad sollte auf einer schnellen SSD liegen um die Geschwindigkeit der VM zu optimieren.
Pfad für das Ablage Image Der Pfad an dem das Festplatten-Image gespeichert wird, der die Ablage Daten enhalten wird. Am Pfad sollte ausreichend Platz verfügbar sein. Die Festplatte kann sich auf bis zu 1 TB vergrößern von initial mindestens 1TB.
Pfad für das PostgreSQL Data Image Der Pfad an dem das Festplatten-Image gespeichert wird, das die Live Daten, nicht die Backups, der PostgreSQL Datenbank enthält. Dieser Pfad sollte auf einer schnellen SSD liegen um die Datenbank-Geschwindigkeit zu optimieren. Die Festplatte kann sich auf bis zu 1 TB vergrößern.
Windows Laufwerksbuchstabe Der Buchstabe des Laufwerks, unter dem in Windows die Ablage verbunden wird. Dieser Laufwerksbuchstabe sollte auf jedem Client PC noch frei, also nicht in Verwendung sein. Es muss sichergestellt sein, dass das alte Samba Share auf allen Clients entbunden wird. Wenn der Laufwerksbuchstabe ein anderer ist, als bisher, müssen die Applikationen, die die Solutio.app/charlyAblage.exe benutzen, angepasst werden.
Soll von einer .iso Datei importiert werden? Beantworten Sie diese Frage mit J, wird im Anschluss der Pfad zur .iso-Datei abgefragt. Bei N wird eine Neuinstallation eingerichtet.
Pfad zur .iso Datei In der .iso Datei sind die Sicherungen der Datenbank und der Ablage enthalten. Diese Datei muss zuvor auf dem bisherigen Server erstellt werden.
Soll eine statische IP konfiguriert werden? Beantworten Sie diese Frage mit J, wird im Anschluss die IP-Adresse abgefragt.
Administrator E-Mail Die E-Mail des Systemadministators wird benötigt, um sich im Admin Web-Interface anzumelden. Außerdem wird die charly-VM an diese Adresse bei besonderen System-Ereignissen E-Mails versenden.
Administrator Passwort Das Passwort wird benötigt, um sich im Admin Web-Interface anzumelden und den SMB-Share "charly-config" einzubinden.
Samba Passwort Das Password für den Samba-User smbuser, um sich mit dem Samba-Share der Ablage und für den Download der Solutio.app zu verbinden. Siehe Manuelles Vorgehen ohne Skript
SSH-Schlüssel Passwort Das Passwort für die Generierung des SSH-Schlüssels.
PostgreSQL Passwort Sollen die Daten von einer existieren Datenbank übernommen werden, sollte es das bisherige Password sein; zu finden in der Solutio.flg. Die Voreinstellung ist dann typischerweise richtig. Bei einer Neuinstallation kann das Passwort frei gewählt werden.
MAC Adresse Vergabe der MAC Adresse der charly-VM. Verwenden Sie nur Kleinbuchstaben und Zahlen.
Soll die Route zu einem Konnektor konfiguriert werden? Beantworten Sie diese Frage mit J, wird im Anschluss die IP des Konnektors abgefragt. Bei N wird die Route nicht konfiguriert. Relevant für die Verwendung des E-Rezepts und der ePA.
Konnektor IP Die IP Adresse des Konnektors. Wenn Sie mehrere Konnektoren habe, geben Sie die IP eines Konnektors an. Erreichbarkeit des Konnektors wird geprüft.
Pfad für das Backup Image Der Pfad an dem das Festplatten-Image gespeichert wird, in dem die Backups für Datenbank und Ablage gesichert werden. Die Festplatte kann sich auf bis zu 1 TB vergrößern. Siehe Backup und Restore der Datenbank

Nachdem alle Konfiguration eingegeben wurden, werden die Container (charly-VM) eingerichtet. Dies kann einige Zeit in Anspruch nehmen, da das Linux-Betriebssystem heruntergeladen und installiert wird. Bei der Installation wird eingerichtet, dass die charly-VM automatisch startet, wenn der Computer neu gestartet wird.

Anschließend wird der charly-Server automatisch eingerichtet und installiert. Hierbei werden die Container-Images aus unserem CDN heruntergeladen, was ebenfalls einige Zeit in Anspruch nehmen kann.

Zum Schluss wird ein erstes Backup der Ablage und PostgreSQL-Datenbank erzeugt.

Nach erfolgreicher Installation kann der Status der charly-VM abgefragt werden. Geben Sie im Terminal folgendes ein:

Windows Administrator Powershell: 

charly-server vm status

Hier erhalten Sie, neben weiteren Informationen, auch die IP-Adresse der Linux-VM, die zusammen mit der Mac-Adresse in Ihren DHCP-Server eingetragen werden sollte.

Erst-Installation der charly-VM

Bei einer Installation, bei der die Frage "Soll von einer .iso Datei importiert werden?" mit N beantwortet wurde, funktionieren einige Docker-Container noch nicht richtig, da die Datenbank noch keine gültige Lizenz enthält.

Darum muss nachträglich noch folgendes durchgeführt werden:

  1. Laden Sie den charly-Client herunter. Siehe Installation des charly-Clients
  2. Starten Sie den charly-Client und geben Sie die Seriennummer und Lizenz ein.
  3. Beenden Sie den charly-Client.
  4. Starten Sie die Docker-Container der VM neu.

Geben Sie im Terminal folgendes ein:

Windows Administrator Powershell: 

charly-server vm docker-restart

Danach sollten nach einiger Zeit alle Docker-Container erfolgreich gestartet sein und keine Fehler mehr gemeldet werden.

Installation mit Datenübernahme

Bei einer Installation, bei der die Frage "Soll von einer .iso Datei importiert werden?" mit J beantwortet wurde, wird von einer bestehenden .iso Datei die Datenbank und Ablage importiert.

Deaktivieren der alten Installation

Nach der charly-VM Installation sollte die bisherige native Installation deaktiviert werden.

Die ncjs-Services beenden und deaktivieren: 

  cd C:\Solutio\Server\ncjs
  .\acd.bat stopall
  .\acd.bat unregisterall

Datenbank beenden und deaktivieren: 

  sc stop Solutio_PostgreSQL13
  sc delete Solutio_PostgreSQL13

TIPP

  • Der Name des PostgreSQL-Dienstes kann variieren. Häufige Namen sind "Solutio_PostgreSQL13", "Solutio_PostgreSQL" oder ähnliche Varianten. Überprüfen Sie den genauen Namen des Dienstes in Ihrer Installation, bevor Sie den Befehl ausführen.
  • Nach der Installation werden ihnen mögliche Services zum Beenden vom Skript angezeigt. Das funktioniert jedoch nur wenn die Datenübernahme vom Host System auf dem die Installation durchgeführt wird erfolgt.

Installation des charly-Clients

Die charly-VM stellt einen SMB-Share zur Verfügung. Dieser kann von macOS und Windows PCs eingebunden werden. Er enhält die charly-Ordner (Ablage) und die solutio.app (charly-Client).

Der charly-Client muss auf den jeweiligen Arbeitsrechner kopiert werden. Er ist bereits so konfiguriert, dass er die Datenbank und die Ablage des SMB-Shares verwendet.

Das Verbinden des SMB-Share, das Herunterladen bzw. Aktualisieren des charly-Client und das Starten des charly-Client kann automatisch durch ein charly-client Skript erfolgen. Dieses Vorgehen wird empfohlen. Es ist aber auch möglich, diese Schritte manuell durchzuführen.

WICHTIG

Entfernen Sie die alte Solutio Applikation aus Programme bzw. C:\Solutio und trennen Sie den bisherigen /Volumes/Charly bzw. S:\Ablage SMB-Share.

WICHTIG

Wenn Sie den charly-Client auch unter macOS benutzen wollen, lesen Sie den Abschnitt "Installation des charly-Clients" in der Anleitung für macOS nach.

Grundvoraussetzung: Installation von NeXT

Unter Windows benötigt der charly-Client die NeXT-Laufzeitumgebung. Diese kann über ein Skript herunter geladen und installiert werden.

  1. Ermitteln Sie zuerst die IP-Adresse, indem auf dem Server in einem Terminal folgendes ausgeführt wird:

Windows Administrator Powershell: 

charly-server vm status

  1. Geben Sie auf dem Client-PC die URL des Admin Web-Interface in einem Browser ein.
  2. Öffnen Sie den Menü-Eintrag "Downloads".
  3. Laden Sie das install-next.ps1 Skript herunter.
  4. Führen Sie das Skript aus:

Windows Administrator Powershell: 

.\install-next.ps1

TIPP

Wenn das Programm charly.exe ausgeführt wird, überprüft es, ob die NeXT-Laufzeitumgebung bereits installiert ist. Falls nicht, gibt das Skript einen Link zum NeXT Installations-Skript aus.

Automatische Installation mit ausführbarem Programm

Das Installations-Skript kann vom Admin Web-Interface heruntergeladen und ausgeführt werden.

Das Skript verbindet den SMB-Share und lädt die neueste Version des charly-Client herunter. Das kann beim ersten Mal eine Weile dauern. Danach wird das Skript die Solutio.app automatisch starten. Bei jedem Start des charly-Clients wird die Solutio.app aktuallisiert. Darum wird empfohlen, die Solutio.app nie direkt starten, sondern für jeden Start den charly-Client zu verwenden.

Um das Programm herunterzuladen und zu starten, gehen Sie wie folgt vor:

  1. Ermitteln Sie zuerst die IP-Adresse, indem auf dem Server in einem Terminal folgendes ausgeführt wird:

Windows Administrator Powershell: 

charly-server vm status

  1. Geben Sie auf dem Client-PC die URL des Admin Web-Interface in einem Browser ein.
  2. Öffnen Sie den Menüeintrag "Downloads".
  3. Laden Sie die Datei charly-client-win.zip herunter.
  4. Bewegen Sie das Archiv an die Stelle, wo Sie die Solutio.app installieren wollen.
  5. Entpacken Sie alles aus dem Archiv. Im Archiv sind die Dateien charly.exe und config.txt enthalten.
  6. Starten Sie die charly.exe

WICHTIG

Falls Sie Arbeitsplätze mit macOS betreiben, lesen Sie hierzu bitte die Anleitung für macOS.

Manuelles Vorgehen ohne Skript

Einbinden des Samba (SMB)-Shares

  1. Öffnen Sie den Windows-Explorer (Sie können die Tastenkombination Windows + E verwenden).
  2. Klicken Sie in die Adressleiste am oberen Rand des Explorers.
  3. Geben Sie den Pfad des SMB-Shares in die Adressleiste, die von charly-server vm status angegeben wird. Ein Dialogfenster zur Anmeldung sollte nun erscheinen.
  4. Geben Sie als Name "smbuser" und das Passwort ein, das Sie bei der Installation vergeben haben. Wählen Sie "Anmeldeinformationen speichern", damit sich Windows die Anmeldeinformationen für zukünftige Verbindungen merkt.
  5. Nach erfolgreicher Authentifizierung wird Ihnen der Inhalt des "charly" SMB-Shares angezeigt.
  6. Um das Laufwerk dauerhaft zu verbinden, klicken Sie mit der rechten Maustaste auf das Share und wählen Sie "Netzlaufwerk verbinden...".
  7. Wählen Sie einen Laufwerksbuchstaben aus, zum Beispiel "S:". Stellen Sie sicher, dass das Kästchen "Verbindung bei Anmeldung wiederherstellen" angehakt ist.
  8. Klicken Sie auf "Fertig stellen".

Bereitstellung des charly-Clients

  1. Öffnen Sie den Windows-Explorer (Sie können die Tastenkombination Windows + E verwenden).
  2. Klicken Sie auf das Laufwerk S:
  3. Kopieren Sie den Ordner Solutio.app in ein lokales Verzeichnis, z.B. C:\Solutio\VM
  4. Starten Sie den charly-Client aus diesem Ordner, z.B. aus C:\Solutio\VM\Solutio.app\Solutio.exe

Testszenarien manuell

Um sicherzustellen, dass Ihr System einwandfrei arbeitet, können Sie sich an der folgenden Liste von Testszenarien orienteren. Diese Tests helfen dabei, mögliche Auffälligkeiten frühzeitig zu erkennen und die Funktionsfähigkeit des Systems zu gewährleisten.

  • Datensicherung
    • Datensicherung durchführen
    • Datensicherung wiedereinspielen
  • Übergeordnete Funktionalität
    • Mandantenwechsel
    • Benutzerwechsel
    • ÜBAG
  • Patient
    • Neuanlage
    • eGK-Karte einlesen
    • eGK mit mobilem Kartenlesegerät
    • Patientennotizen
    • ePA
    • EMP
    • NFDM
    • Email versenden
    • Serien-Email versenden
    • SMS
    • Serien-SMS versenden
    • TAPI einrichten
    • Ablage
    • scannen
    • drucken
    • Planung
  • Befund
  • Behandlungsblatt
    • Leistungen
    • Komplexe
    • Röntgen
    • Historisierung
  • Rechnungen
    • Abrechnung
    • Mahnungen
    • DZR
  • Terminbuch
    • OTV
  • HKP
    • EBZ
    • KGL
    • KBR
    • ZE
    • PAR
    • KFO
    • PMB
  • MIS
    • MIS Dashboard
    • Solvi
    • GOBD-Export
  • Material
  • Programmhilfe

  • Textvorlagen

  • KIM

  • Mail senden

  • Mail empfangen

  • Konnektoren

    • HBA einrichten
    • Signieren mit HBA
    • SMC-B einrichten
    • Signieren mit SMC-B

  • Steri-Protokolle abrufen

  • Kassenbuch

    • Buchung
    • Druck
    • Export
    • Abschluss

  • Diverses

    • Moduleversion
    • Brother Labeldrucker
    • rose4charly
    • HalloCharly
    • DICOM4charly
    • iOS-Apps
    • Anamnese-App
    • Foto-App
    • Termine-App

Version: 2.5.0

Datum der letzten Aktualisierung: 12.06.2025