Verwaltung des charly-Servers

Diese Anleitung beschreibt die wichtigsten Verwaltungsbefehle für die charly-Server-Skripte. Für detaillierte Hilfe zu jedem Befehl verwenden Sie:

charly-server <Befehl> -Help

Tägliche Verwaltung

Status anzeigen

Wann zu verwenden:

Zur Überprüfung der Systemgesundheit
Bei Problemen
Für Supportanfragen

# Detaillierter Status
charly-server manage status

Der Befehl zeigt:

charly-Client Version
PostgreSQL Status und Version
Leistungsmetriken
Status aller ncjs-Services
Speicherverbrauch
Netzwerk-Status
SMB-Freigaben

Server starten, stoppen und neu starten

Wann zu verwenden:

Nach System-Neustart
Bei Wartungsarbeiten
Bei Performanceproblemen
Bei ncjs-Service spezifischen Problemen

# Server starten
charly-server manage start

# Server stoppen
charly-server manage stop

# Server neu starten
charly-server manage restart

Der Befehl führt folgende Aktionen aus:

Kontrolliertes Herunterfahren aller Dienste
Sicherung des Systemzustands
10 Sekunden Wartezeit
Geordneter Neustart aller Dienste
Verifikation der Dienstfunktionalität

Diagnose und Überwachung

Verzeichnisberechtigungen analysieren

Wann zu verwenden:

Bei Berechtigungsproblemen
Zur Fehlersuche
Bei Zugriffsproblemen (z.B. auf die Ablage)

# Berechtigungen anzeigen
charly-server manage folder-permissions "C:\Solutio\Client\Charly\Ablage"

Der Befehl zeigt:

Besitzer und Gruppen
Zugriffsrechte
Vererbungsstatus
Vererbungsquelle

Logs sammeln

Wann zu verwenden:

Vor Support-Kontakt zur Fehleranalyse
Nach Fehlermeldungen oder Problemen
Nach Updates bei auftretenden Schwierigkeiten
Zur Dokumentation von Systemzuständen

# Logs auf Desktop sammeln
charly-server manage get-logs

# Logs in benutzerdefiniertem Ordner sammeln
charly-server manage get-logs -ExportPath "C:\Support"

Der Befehl sammelt:

charly-Server Logs: Alle Anwendungsprotokolle aus %ProgramData%\charly-server\logs
PostgreSQL Logs: Datenbankprotokolle der letzten 14 Tage
Komprimierung: Alles wird in ein 7z-Archiv gepackt
Speicherort: Standardmäßig auf dem Desktop mit Zeitstempel im Dateinamen

Das erstellte Archiv (z.B. charly-logs-20241114-153045.7z) enthält alle relevanten Protokolldateien und kann direkt an den Support übermittelt werden.

TIPP

Das Archiv ist komprimiert und beinhaltet keine Patientendaten
Alte Log-Archive regelmäßig vom Desktop entfernen
Bei fehlender PostgreSQL-Installation werden nur charly-Server Logs gesammelt

Wartung und Reparatur

Verzeichnisberechtigungen reparieren

Wann zu verwenden:

Bei Zugriffsproblemen beim Anlegen von Patientendokumenten
Berechtigungsfehler beim Scannen von Dokumenten

# Einzelnes Verzeichnis reparieren
charly-server manage repair-acl -Path "C:\Solutio\Client\Charly\Ablage"

# Verzeichnis mit allen Unterverzeichnissen reparieren
charly-server manage repair-acl -Path "C:\Solutio\Client\Charly" -IncludeSubdirectories

# Mehrere Verzeichnisse reparieren
charly-server manage repair-acl -Path "C:\Solutio\Client\Charly\Ablage\SolutioText\PatEingang, C:\Solutio\Client\Charly\Ablage\SolutioText\Rechnungen"

# Nur geänderte Dateien seit dem 23.09.2024
charly-server manage repair-acl -StartDate "23.09.2024"

PostgreSQL-Berechtigungen

Wenn repair-acl auf das gesamte Server-Verzeichnis angewendet wird und PostgreSQL anschließend nicht mehr startet, verwenden Sie:

charly-server manage repair-postgres-acl

PostgreSQL-Berechtigungen reparieren

Wann zu verwenden:

PostgreSQL startet nach repair-acl auf Server-Verzeichnis nicht mehr
PostgreSQL-Berechtigungen sind beschädigt
Fehlermeldungen bezüglich Dateizugriffsrechten

# PostgreSQL-Berechtigungen reparieren
charly-server manage repair-postgres-acl

# Ohne Benutzerbestätigung (für Automatisierung)
charly-server manage repair-postgres-acl -AutoConfirm

Der Befehl führt folgende Aktionen aus:

Ermittelt automatisch den PostgreSQL-Pfad
Prüft ob PostgreSQL läuft und fordert Bestätigung an
Stoppt PostgreSQL-Service falls aktiv
Deaktiviert Vererbung auf PostgreSQL-Verzeichnis
Setzt explizite Berechtigungen für SYSTEM, Administrators und Service-Account
Aktiviert Vererbung für data-Unterverzeichnis
Startet PostgreSQL-Service wieder

WICHTIG

PostgreSQL wird während der Reparatur gestoppt
Bei laufendem Service wird Benutzerbestätigung angefordert
Alle Änderungen werden protokolliert

ncjs-Services deregistrieren

Wann zu verwenden:

Vor einer Neuinstallation
Bei hartnäckigen ncjs-Service Problemen
Als Teil der Deinstallation

charly-server manage remove-services

ISO-Datei erstellen

Wann zu verwenden:

Nach einem Export
Für Backupzwecke
Zur Datenweitergabe

# ISO-Datei aus Export erstellen
charly-server manage create-iso

Spezielle Funktionen ausführen

Wann zu verwenden:

Auf Anweisung des Supports
Für spezielle Wartungsaufgaben

# Funktion ausführen
charly-server manage runfunction <Funktionsname>

Ressourcenüberwachung

Wann zu verwenden:

Bei Performanceproblemen
Für proaktive Wartung
Zur Kapazitätsplanung

# Ressourcen überwachen
charly-server manage track-resources

# Mit angepasstem Intervall
charly-server manage track-resources -IntervalSeconds 30

Der Befehl sammelt Daten zu:

CPU-Auslastung (%)
Verfügbarer Arbeitsspeicher (MB)
Festplatten Lese-/Schreibraten (MB/s)
Netzwerk-Durchsatz (MB/s)
Top 3 der CPU-intensiven Prozesse
Top 3 der speicherintensiven Prozesse

Die Daten werden als JSON gespeichert unter: %ProgramData%\CharlyServer\system_resources.json

Einwilligungen widerrufen

Wann zu verwenden:

Zum Widerruf von Datenübermittlungen an die solutio GmbH & Co.KG
Bei Änderung der Datenschutzeinstellungen

# Einwilligungen anzeigen und widerrufen
charly-server manage revoke-consent

Der Befehl:

Zeigt alle aktiven Einwilligungen
Ermöglicht selektiven Widerruf
Erstellt Zusammenfassung der Änderungen

TIPP

Widerruf gilt nur für zukünftige Übertragungen
Bereits gesendete Daten bleiben erhalten
Einwilligung kann jederzeit neu erteilt werden

charly-Server-Skript deinstallieren

Wann zu verwenden:

Bei Neuinstallation
Bei vollständiger Systemreinigung
Bei Migration zu neuer Version

# Skript deinstallieren
charly-server manage uninstall-script

Der Befehl entfernt:

charly-Server-Skript Dateien
Umgebungsvariablen
Registry-Einträge
Geplante Aufgaben

WICHTIG

Entfernt NUR das charly-Server-Skript
solutio-Software bleibt erhalten
Log-Dateien werden archiviert
Deinstallation kann nicht rückgängig gemacht werden

Java Service Konfiguration

application.yml bearbeiten

Wann zu verwenden:

Für service-spezifische Konfigurationen (z.B. Time-Server für eHealth-Gateway)
Zum Anpassen von Logging-Einstellungen
Für Datenbankverbindungsoptionen
Bei Anweisung durch den Support

Hinweis

Kundenspezifische Konfigurationen werden im conf2-Verzeichnis abgelegt, da dieses durch charly-Updates nicht überschrieben wird.

Solutio-Pfad ermitteln

Bevor Sie Konfigurationsdateien bearbeiten, ermitteln Sie zunächst den Solutio-Installationspfad:

charly-server

Das Skript zeigt den aktuellen Solutio-Pfad an (z.B. C:\Solutio oder D:\Solutio).

Konfigurationsdatei erstellen

Navigieren Sie zum conf2-Verzeichnis:
```
<SolutioPath>\Server\ncjs\conf2
```
(Ersetzen Sie <SolutioPath> durch den ermittelten Pfad, z.B. C:\Solutio)
Erstellen Sie einen Ordner mit dem Namen des Service (z.B. ehealth-gateway, auth, query)
Erstellen Sie eine Datei namens application.yml in diesem Ordner
Bearbeiten Sie die Datei mit einem Texteditor (Notepad++, VS Code oder Notepad)

Beispiel: Time-Server für eHealth-Gateway konfigurieren

Pfad:

<SolutioPath>\Server\ncjs\conf2\ehealth-gateway\application.yml

Inhalt:

de.solutio.ncjs.ehealth.infrastructure.time-sync-addresses: 192.168.172.1

WICHTIG

Achten Sie auf korrekte YAML-Syntax (Leerzeichen nach Doppelpunkt!)
Speichern Sie die Datei mit UTF-8 Kodierung
Verwenden Sie keine Tabs, nur Leerzeichen für Einrückung
Nach Änderungen muss der Service neu gestartet werden:
```
charly-server service restart ehealth-gateway
```

Beispiel: charly Termine App aktivieren

Die charly Termine App synchronisiert Termine über WebDAV mit externen Kalendern.

TLDR (vorausgesetzt Sie haben bereits: Mandant-ID, WebDAV-URL, Benutzername und Passwort):

Erstellen Sie <SolutioPath>\Server\ncjs\conf2\gateway\application.yml
Fügen Sie folgende Konfiguration ein:

de.solutio.termine:
  enabled: true
  instances:
    meinkalender:
      enabled: true
      tenant: 1
      webdav:
        server: https://webdav.example.com/calendars/
        username: kalender-user
        password: kalender-passwort

Starten Sie den Gateway-Service neu: charly-server service restart gateway

Mehrere Kalender

Sie können mehrere Instanzen definieren, indem Sie zusätzliche Blöcke unter instances hinzufügen (z.B. meinkalender, kalender2, usw.). Jede Instanz kann einen eigenen Mandanten und WebDAV-Server haben.

Vollständige Konfigurationsdetails finden Sie in der offiziellen Termine-App Dokumentation.

Weitere Informationen

Eine ausführliche Dokumentation zur application.yml Konfiguration finden Sie in der offiziellen charly-Hilfe:

application.yml Konfiguration

Software-Aktualisierung

charly-Server aktualisieren

Wann zu verwenden:

Bei Verfügbarkeit neuer Versionen
Für regelmäßige Wartungsupdates
Zur Behebung bekannter Probleme
Nach Ankündigung wichtiger Updates durch den Support

# charly-Server aktualisieren
charly-server manage update

Der Befehl führt folgende Aktionen aus:

Prüft, ob der charly-Updater installiert ist; installiert ihn bei Bedarf
Stoppt alle laufenden Solutio-Dienste
Überprüft und handhabt eventuelle Lockfiles vom Updater
Führt den charly-Updater aus, der die Software aktualisiert
Stellt die ursprüngliche Umgebungskonfiguration wieder her
Zeigt detaillierte Timing-Informationen für jeden Schritt an

TIPP

Das Update sollte außerhalb der Praxiszeiten durchgeführt werden
Stellen Sie sicher, dass keine anderen Benutzer auf das System zugreifen
Ein Backup vor dem Update wird empfohlen

WICHTIG

Der Update-Prozess kann je nach Größe des Updates 5-30 Minuten dauern
Das System ist während des Updates nicht verfügbar
Bei Problemen während des Updates wenden Sie sich an den Support

ncjs-Service Management

Verbesserte Dienstverwaltung in Version 2.1.5+

In Version 2.1.5 wurde die ncjs-Service-Verwaltung grundlegend verbessert. ncjs-Services können nun individuell oder zusammen verwaltet werden, mit parallelen Operationen für schnellere Wartungsarbeiten.

Weiter Informationen finden sich in der Hilfe für die ncjs-Service Befehle.

Version: 2.8.8

Datum der letzten Aktualisierung: 19.11.2025