Zum Inhalt

Installation der charly VM

Diese Anleitung beschreibt die Installation die Installation der charly VM unter macOS.

Die charly-Services werden in einer Linux VM betrieben. In dieser VM laufen die charly-Services in mehreren Docker-Containern.

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
  • Passen Sie nach der Installation den DHCP-Server der Praxis an: Macadresse der VM an die gewünschte IP binden
  • Falls Sie ein Multimandantensystem betreiben, kann aktuell kein Update in die Containerlösung durchgeführt werden.
  • Falls Sie einen Konnektor betreiben, der sich nicht im gleichen Netzwerk befindet, kann aktuell kein Update in die Containerlösung durchgeführt werden.

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.

Damit der macOS Server unbeaufsichtigt neu gestartet werden kann, muss FileVault deaktiviert sein. Andernfalls könnte der macOS-Server und damit auch der charly-Server erst nach Eingabe des Administrator-Passwortes des macOS-Servers an der angeschlossenen Tastatur wieder verfügbar sein.

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 .qcow2. Die vier Festplatten-Images können auf unterschiedlichen Festplatten gespeichert werden. Siehe Installation der charly-VM.

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

Image Beschreibung 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ält jedoch keine Backups. Die Ablage wird durch die charly-VM über ein Samba-Share zur Verfügung gestellt. Siehe Installation der charly-VM. 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 500GB 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.
  • Die Pfade der Festplatten-Images werden bei der Installation festgelegt und sind aktuell nicht ohne Weiteres umkonfigurierbar. Wählen Sie die Pfade entsprechend bewusst.
  • Der Benutzer muss Administrator auf dem macOS sein. Und der Benutzer im Terminal muss der Nutzer sein, der auch unter macOS angemeldet ist.

Das charly-server Skript

Wenn Sie das charly-server Skript noch nicht haben, laden Sie es mit folgendem Befehl herunter: 

curl -o charly-server-install.zsh https://charly-cdn-solutio.s3.amazonaws.com/release/macos/charly-server-install.zsh
machen es ausführbar: 
chmod +x charly-server-install.zsh
und installieren charly-server 
./charly-server-install.zsh

Mehr dazu im Kapitel 8. Funktionen des charly-vm Skripts

Vorbereitungen

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.

Installation der charly-VM

Als Basis für den Betrieb der VM wird die Open Source Virtualisierungs-Technologie "QEMU" verwendet. Wenn Sie die charly-VM installieren, wird zunächst die Paketverwaltung "Homebrew" installiert, mit der dann QEMU installiert wird. Anschließend wird die Debian-Linux-VM installiert und gestartet.

Homebrew installieren

Prüfen, ob homebrew schon installiert ist: 

brew --version
Wenn hier nicht die Version, zB. Homebrew 4.3.24 ausgegeben wird, dann muss homebrew installiert werden:

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

WICHTIG

Am Ende fordert die brew Installation auf, noch einige Dinge als "Next steps" in der Kommandozeile einzugeben. Führen Sie die 3 Kommandos nacheinander aus.

Vorbereitung der Installation

Schon während auf dem Alt-System der Export läuft, kann auf dem neuen Zielsystem die Installation der VM vorbereitet werden, um Zeit zu sparen. Hier werden dann die nötigen homebrew Programme installiert und die unten stehenden Konfigurationen und die Passwörter abgefragt.

Die Konfiguration wird zum Schluss angezeigt und das Skript beendet sich.

Führen Sie zur Vorbereitung der Installation folgenden Befehl aus: 

charly-server install prepare

Konfiguratio der Installation

Führen Sie zuerst den obigen Schritt zur Vorbereitung der Installation aus. Es ist aber auch möglich, den Vorbereitungs-Schritt nicht durchzuführen.

Dann führen Sie zur Installation folgenden Befehl aus: 

charly-server install

Das Skript fragt nach dem Passwort des Benutzers.

Danach wird Sie das Skript durch die Installation leiten. Folgende Einstellungen werden vom Skript angefragt, sofern sie nicht schon im Vorbereitungs-Schritt abgefragt wurden:

Einstellungen Beschreibung
Praxisgröße Anzahl der Arbeitsplätze der Praxis. Hieraus ermitteln sich die Systemvorausetzungen und die Empfehlungen für die CPU Kerne, RAM und Festplattengrößen
CPU Kerne Abhängig von den verfügbaren (virtuellen) CPU Kernen, sollten möglichst viele für die VM verwendet werden, typischerweise alle verfügbaren Kerne bis auf 2, um dem macOs 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
Name des Netzwerkinterfaces Das Netzwerkinterface, welches für die VM verwendet werden soll. Wenn Sie nicht sicher sind, geben Sie in einem Terminal ifconfig ein, um eine Übersicht der Netzwerkschnittstellen zu erhalten und suchen Sie nach dem Eintrag, der eine IP-Adresse besitzt. Meist ist es en0.
MAC Addressee der VM Die Voreinstellung kann typischerweise beibehalten werden, sollte in Ihrem Netzwerk aber einzigartig sein. Diese Mac Adresse müsssen Sie später zusammen mit der IP-Adresse der VM in ihren DHCP Server Ihres Routers eintragen, damit die VM auch nach einem Neustart seine IP-Adresse beibehält.
Soll die Route zu einem Konnektor konfiguriert werden? Beantworten Sie diese Frage mit J, wird die nächste Einstellung abgefragt. Sonst wird die Route nicht konfiguriert.
Konnektor IP Die IP-Adresse des Konnektors. Wenn Sie mehrere Konnektoren habe, geben Sie die IP eines Konnektors an.
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.
Größe der Systempartition Wie groß sollte die Fesplatte für VM Datein und Images werden können. Mindestens 100GB
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.
Größe des Ablage Image Größe des Ablage Images. Sollte mindestens das 1,5 Fache der aktuellen Ablage sein, idealerweise mehr wenn ausreichend Festplattenplatz vorhanden ist
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.
Größe des PostgreSQL Data Image Größe der PostgreSQL Festplatte für die Live Daten. Mindestens 20G
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
Größe des Backup-Image Größe der Backup Festplatte. Sollte mindestens 2* der Größe des Ablage Image entsprechen
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 danach abgefragt, wo die .iso Datei liegt. Sonst 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. Automatisch wird im Downloads Verzeichnis nach der ISO Datei gesucht. Sie können aber auch über AutoCompletion den Ordner in dem sich die ISO Datei befindet suchen

Danach werden sie gefragt ob die Konfiguration korrekt ist. Wenn ja, wird diese in /root/.config/charly-server/vm-config.yaml gesichert. Wenn nein haben sie Möglichkeit die Konfiguration zu ändern oder die Installation zu beenden ohne eine gespeicherte Konfiguration.

Als nächstes folgt die Abfrage der Credentials:

Einstellungen Beschreibung
Administrator eMail Die eMail 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 eMails versenden.
Administrator Passwort Die Passwort wird benötigt, um sich im Admin Web-Interface anzumelden.
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.
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 Key Passwort Es wird ein SSH Key generiert. Dafür wird nach einer Passphrase gefragt. Diese Passphrase wird später in der Installation und bei allen zukünftigen Skriptaufrufen benötigt. Merken Sie sich diese oder hinterlegen Sie sie an einem sicheren Ort!

Danach werden sie gefragt ob die Konfiguration korrekt ist. Wenn ja, wird diese in /root/.config/charly-server/credentials.yaml gespeichert und nur für diesen Benutzer sichtbar gemacht.

Durchführung der Konfiguation

Nachdem alle Konfiguration eingegeben wurden, wird die VM eingerichtet. Dies kann einige Zeit in Anspruch nehmen, da das Linux-Betriebssystem heruntergeladen und installiert wird.

Danach wird dafür gesorgt, dass die VM automatisch gestartet wird, wenn der Computer neu gestartet wird.

In den Systemeinstellungen > Datenschutz & Sicherheit > Festplattenvollzugriff muss QEMU die nötigen Rechte gegeben werden. Achten Sie auf die konkrete Anzeige, die bei der Installation erscheint.

Danach wird nach der Passphrase für the SSH Key gefragt, da das Skript jetzt eine Verbindung zur VM aufbauen 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 VM abgefragt werden. Geben Sie im Terminal folgendes ein:

charly-server manage 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 existieren Datenbank und Ablage 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:

charly-server manage docker-restart

Danach sollten nach einiger Zeit alle Docker gestartet sein und keine Fehler mehr melden.

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.

Installation des charly-Clients

Die charly-VM stellt einen Samba (SMB) Share zur Verfügung. Dieser kann von macOS und Windows PCs eingebunden werden. Er enhällt die Ablage der Praxis und den 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 Samba-Shares verwendet.

Das Verbinden des Samba-Share, das Herunterladen bzw. Aktuallisieren 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

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

Automatische Installation

Die charly Starter-App kann vom Admin Web-Interface heruntergeladen und ausgeführt werden.

Die Starter-App verbindet den Samba-Share und lädt die neueste Version der Solutio App herunter. Das kann beim ersten Mal eine Weile dauern und führt dazu, dass die Dateigröße der charly Starter-App anwächst. Danach wird die charly App die eigentliche Solutio.app, die sich nun in der charly befindet, automatisch starten. Bei jedem Start des der charly App wird die Solutio.app aktuallisiert. Darum wird empfohlen, die Solutio App nie direkt starten, sondern für jeden Start die charly App zu verwenden.

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

  1. Ermitteln Sie zuerst die IP-Adresse, indem in einem Terminal folgendes ausgeführt wird:
charly-server manage status
  1. Geben Sie die URL des Admin Web-Interface in einem Browser ein
  2. Öffnen Sie den Menüeintrag "Downloads"
  3. Laden Sie die Datei charly-client-mac.zip herunter
  4. Entpacken Sie durch Doppelklick im Finder das .zip Archiv. Es sollte jetzt die charly App vorhanden sein.
  5. Bewegen Sie die charly App in Ihre Programme
  6. Öffnen Sie die App in Programme über das Kontextmenü "Öffnen". Möglicherweise 2x, bis die Auswahl zum öffnen erscheint.

NOTIZ: Das Verschieben nach Programme und das Öffnen über Kontextmenü ist aktuell noch notwending. In Zukunft wird die charly App korrekt signiert, was das Starten via Doppelklick möglich machen wird.

Manuelles Vorgehen ohne Skript

Einbinden des Samba-Shares

  1. Öffnen Sie den Finder.
  2. Gehen Sie im Menü auf "Gehe zu" und wählen Sie "Mit Server verbinden..." oder drücken Sie Command + K.
  3. Gebn Sie die SMB-Adresse ein, die von ./charly-server.zsh status angegeben wird.
  4. Klicken Sie auf "Verbinden".
  5. Wählen Sie "Als Registrierter Nutzer anmelden", Verwenden Sie "smbuser" als Name und das Samba Passwort, dass Sie bei der Installation angegeben haben.
  6. Klicken Sie auf "Verbinden".

Bereitstellung des charly-Clients

  1. Öffnen Sie den Finder.
  2. Klicken Sie auf den gerade eben erstellte Netzwerkshare
  3. Kopieren Sie die Solutio App auf den lokalen Computer

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 lesen
    • 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
    • SMCB einrichten
    • signieren mit SMCB

  • Steri-Protokolle abrufen

  • Kassenbuch

    • Buchung
    • Druck
    • Export
    • Abschluss

  • Diverses

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

Version: 1.1.1

Datum: 2025-01-06