Installation der charly-VM
Diese Anleitung beschreibt die Installation und den Betrieb der charly-VM unter Windows.
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
- 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 Microservices 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. 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 | 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. 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.
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.
Verwenden des charly-server Skripts
Die charly-VM wird 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 Skript bereits installiert ist, erscheint nun die Hilfe mit einer Übersicht aller möglichen Parameter. Ansonsten muss das Skript intstalliert werden. Laden Sie hierzu das Install-Skript herunter:
Nach dem Download sollten Sie unter Windows sicherstellen, dass das Script ausführbar ist. Führen Sie dafür folgendes Kommando in einem Terminal aus:
Windows Administrator Powershell:
set-executionpolicy remotesigned
Führen Sie nun das Install-Skript im Ordner, in den es heruntergeladen wurde, aus. Es installiert charly-server:
Windows Administrator Powershell:
.\charly-server-install.ps1
Vorbereitungen
Vor der Installation müssen unter Windows noch vorbereitende Schritte unternommen 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 aktivieren
Unter Windows muss die Virtualisierung HyperV aktiviert werden.
- Öffnen Sie die Systemsteuerung.
- Gehen Sie zu "Programme" und dann zu "Programme und Features".
- Klicken Sie auf "Windows-Features aktivieren oder deaktivieren".
- Setzen Sie ein Häkchen bei "Hyper-V" und klicke auf "OK".
- Folgen Sie den Anweisungen zum Neustarten deines Computers, um die Installation 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!
- Starten Sie den Hyper-V-Manager
- Klicken Sie rechts unter Aktionen auf Manager für virtuelle Switches...
- Falls Sie bereits einen externen Switch erstellt haben, erscheint er im sich öffnenden Fenster im linken Bereich in der Liste. Falls nicht:
- Im linken Bereich sollte bereits Neuer virtueller Netzwerkswitch ausgewählt sein und im rechten Bereich die Auswahl auf Extern stehen.
- Klicken Sie auf Virtuellen Switch erstellen unter der Liste der Switch-Arten
- Hier können Sie dem virtuellen Switch einen Namen geben, den Sie später bei der Installation der charly-VM angeben müssen.
- 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.
- Stellen Sie zusätzlich sicher, dass das Häkchen bei Gemeinsames Verwenden dieses Netzwerkadapters für das Verwaltungsbetriebssystem zulassen gesetzt ist.
- Erstellen Sie den virtuellen Switch mit Klick auf Anwenden oder OK
- Alle diese Einstellungen bis auf den Namen sollten standardmäßig richtig eingestellt sein.
Überprüfen der Netzwerkkonfiguration
Bevor Sie mit der Installation beginnen, stellen Sie sicher, dass Ihre Netzwerkkonfiguration korrekt ist:
- Überprüfen Sie die DNS-Server-Einstellungen auf Ihren virtuellen Switches im Hyper-V-Manager.
- Stellen Sie sicher, dass die DNS-Server-Adressen auf aktuelle, funktionierende Server verweisen.
- Testen Sie die Namensauflösung mit dem folgenden Befehl in der PowerShell:
Wenn die Namensauflösung funktioniert, sollten Sie eine IP-Adresse als Antwort erhalten.
nslookup www.solutio.de
- Ü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 charly-VM
Windows Administrator Powershell:
charly-server install
Danach wird Sie das Skript durch die Installation leiten. Folgende Einstellungen werden vom 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 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. |
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 |
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. |
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 und das Samba-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 |
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. |
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. |
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. |
Als nächstes 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. Diese Passphrase kann nach der Installation nicht eingesehen werden! Merken Sie sich diese oder hinterlegen Sie sie an einem sicheren Ort!
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.
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:
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 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:
- Laden Sie den charly-Client herunter. Siehe Installation des charly-Clients
- Starten Sie den charly-Client und geben Sie die Seriennummer und Lizenz ein
- Beenden Sie den charly-Client
- 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 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.
Deaktivieren der alten Installation
Nach der Installation sollte die bisherige Installation deaktiviert werden.
Die Java Dienste 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
Hinweise: * 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 Samba (SMB) Share zur Verfügung. Dieser kann von macOS und Windows PCs eingebunden werden. Er enhält 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. 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 entbinden 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.
- Ermitteln Sie zuerst die IP Adresse, indem auf dem Server in einem Terminal folgendes ausgeführt wird:
Windows Administrator Powershell:
charly-server vm status
- Geben Sie auf dem Client die URL des Admin Web-Interface in einem Browser ein
- Öffnen Sie den Menüeintrag "Downloads"
- Laden Sie das
install-next.ps1
Skript herunter - Führen Sie das Skript aus:
Windows Administrator Powershell:
.\install-next.ps1
Hinweis: 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 Samba-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-client Programms wird die Solutio.app aktuallisiert. Darum wird empfohlen, die Solutio.app nie direkt starten, sondern für jeden Start das charly-client Programm zu verwenden.
Um das Programm herunterzuladen und zu starten, gehen Sie wie folgt vor:
- Ermitteln Sie zuerst die IP Adresse, indem auf dem Server in einem Terminal folgendes ausgeführt wird:
Windows Administrator Powershell:
charly-server vm status
- Geben Sie auf dem Client die URL des Admin Web-Interface in einem Browser ein
- Öffnen Sie den Menüeintrag "Downloads"
- Laden Sie die Datei
charly-client-win.zip
herunter - Bewegen Sie das Archiv an die Stelle, wo Sie die Solutio.app installieren wollen
- Entpacken Sie alles aus dem Archiv. Im Archiv sind die Dateien charly.exe und config.txt enthalten.
- Starten Sie die charly.exe
WICHTIG
Falls Sie Arbeitsplätze mit macOS betreiben, sehen Sie hierzu bitte in der Anleitung für macOS nach.
Manuelles Vorgehen ohne Skript
Einbinden des Samba-Shares
- Öffnen Sie den Windows-Explorer (Sie können die Tastenkombination Windows + E verwenden).
- Klicken Sie in die Adressleiste am oberen Rand des Explorers.
- Geben Sie den Pfad des Samba-Shares in die Adressleiste, die von
charly-server vm status
angegeben wird. Ein Dialogfenster zur Anmeldung sollte nun erscheinen. - 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.
- Nach erfolgreicher Authentifizierung wird Ihnen der Inhalt des "charly" Samba-Shares angezeigt.
- Um das Laufwerk dauerhaft zu verbinden, klicken Sie mit der rechten Maustaste auf das Share und wählen Sie "Netzlaufwerk verbinden...".
- Wählen Sie einen Laufwerksbuchstaben aus, zum Beispiel "S:". Stellen Sie sicher, dass das Kästchen "Verbindung bei Anmeldung wiederherstellen" angehakt ist.
- Klicken Sie auf "Fertig stellen".
Bereitstellung des charly-Clients
- Öffnen Sie den Windows-Explorer (Sie können die Tastenkombination Windows + E verwenden).
- Klicken Sie auf das Laufwerk S:
- Kopieren Sie den Ordner Solutio.app in ein lokales Verzeichnis, z.B. C:\Solutio\VM
- Starten Sie charly 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 lesen
- eGK mit mobilem Kartenlesegerät
- Patientennotizen
- ePA
- EMP
- NFDM
- Email versenden
- Serien-Email versenden
- SMS
- Serien-SMS versenden
- TAPI einrichten
- Ablage
- scannen
- 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: 2.1.3
Datum der letzten Aktualisierung: 27.02.2025