Zum Inhalt

charly Client

Der charly-Client ist die Anwendung, mit der Benutzer von ihren Arbeitsplätzen aus auf das charly-System zugreifen. Er verbindet sich mit der charly-VM und stellt die Solutio.app bereit.

Herunterladen

Der charly-Client kann über das Admin Web-Interface heruntergeladen werden:

  1. Ermitteln Sie die IP-Adresse der charly-VM:

Windows Administrator Powershell: 

charly-server vm 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 benötigten Dateien herunter:
  4. charly-client-win.zip - Client-Anwendung
  5. install-next.ps1 - NeXT-Installationsskript (nur bei Erstinstallation)

Grundvoraussetzung: NeXT-Laufzeitumgebung

Unter Windows benötigt der charly-Client die NeXT-Laufzeitumgebung. Diese muss vor der ersten Verwendung des Clients installiert werden.

  1. Laden Sie das install-next.ps1 Skript über das Admin Web-Interface herunter
  2. 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.

Installation

Automatische Installation (empfohlen)

Die Installation über das Skript verbindet automatisch den SMB-Share und lädt die neueste Version des charly-Clients herunter.

  1. Laden Sie charly-client-win.zip über das Admin Web-Interface herunter
  2. Bewegen Sie das Archiv an den gewünschten Installationsort
  3. Entpacken Sie das Archiv. Es enthält charly.exe und config.txt
  4. Starten Sie charly.exe

Hinweis

Sollte beim ersten Ausführen der charly.exe die Warnung "Möchten Sie Software dieses nicht vertrauenswürdigen Herausgebers ausführen?" erscheinen, dann wählen Sie bitte "Immer ausführen" und klicken "OK". Warnung Software dieses nicht vertrauenswürdigen Herausgebers ausführen?

WICHTIG

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

WICHTIG

Wenn die Ablage unter Windows bisher über eine Gruppenrichtlinie gemountet wurde, dann müssen Sie Ihren Systembetreuer kontaktieren, damit dieser die Gruppenrichtlinie aktualisiert oder ggf. entfernt. Andernfalls wird es beim Starten der charly App kontinuierlich zu Problemen kommen.

Automatische Aktualisierung

Der charly-Client aktualisiert sich und die Solutio.app automatisch:

  • Bei jedem Start überprüft der Client, ob eine neuere Version verfügbar ist
  • Updates werden automatisch vom Admin Web-Interface heruntergeladen
  • Keine manuelle Aktion erforderlich - der Client bleibt immer aktuell

Empfehlung

Starten Sie die Solutio.app nie direkt, sondern verwenden Sie immer die charly.exe. Nur so wird sichergestellt, dass die Anwendung aktuell ist.

Netzwerk-Monitoring

Der charly-Client richtet automatisch ein Netzwerk-Monitoring ein, das die Verbindung zur charly-VM überwacht.

Logfile-Speicherort

Die Netzwerk-Monitoring-Logs befinden sich unter: 

%PROGRAMDATA%\CharlyClient\logs
(typischerweise: C:\ProgramData\CharlyClient\logs)

Log-Typen

Logfile Inhalt
Ping-check_YYYY-MM-DD.log Ping-Ergebnisse zum Server
SMB-check_YYYY-MM-DD.log SMB-Verbindungstests zur Ablage
Monitoring-Script_YYYY-MM-DD.log Script-Status und Konfiguration

Unternehmensnetzwerke

Firewall-Anforderungen

Der charly-Client benötigt folgende Netzwerkverbindungen:

  • HTTP-Zugriff auf das Admin Web-Interface (für Downloads und Updates)
  • SMB-Port 445 zur charly-VM (für die Ablage)
  • ICMP (Ping) zur charly-VM (für Monitoring)

Gruppenrichtlinien (GPO)

WICHTIG

Wenn Netzlaufwerke über Gruppenrichtlinien gemountet werden, kann dies zu Konflikten mit dem charly-Client führen. Der Client erkennt solche Konfigurationen und gibt eine Warnung aus. Kontaktieren Sie Ihren Systembetreuer, um die Gruppenrichtlinie anzupassen.

Offline-Verhalten

Falls der Client den Server nicht erreichen kann:

  • Die Solutio.app startet trotzdem (sofern bereits heruntergeladen)
  • Updates werden übersprungen
  • Das Netzwerk-Monitoring protokolliert Verbindungsfehler

Fehlerbehebung

Client reagiert nicht oder stürzt ab

Wenn der charly-Client "Keine Rückmeldung" zeigt oder regelmäßig abstürzt, prüfen Sie zuerst die Netzwerk-Logs des Clients.

Schnelle Fehlersuche per PowerShell

# Alle Ping-Fehler der letzten Tage anzeigen
Get-Content "$env:PROGRAMDATA\CharlyClient\logs\Ping-check_*.log" | Select-String "ERROR|Failed"

# Alle SMB-Probleme anzeigen (Verbindungsabbrüche zur Ablage)
Get-Content "$env:PROGRAMDATA\CharlyClient\logs\SMB-check_*.log" | Select-String "ERROR|WARNING"

# Nur heutiges Log prüfen
Get-Content "$env:PROGRAMDATA\CharlyClient\logs\Ping-check_$(Get-Date -Format 'yyyy-MM-dd').log" | Select-String "ERROR"

Typische Fehlerursachen

Fehlermeldung Mögliche Ursache
Failed to ping server Server nicht erreichbar (Netzwerk, Firewall, VM heruntergefahren)
SMB write failed Ablage nicht beschreibbar (Berechtigungen, Speicherplatz)
SMB share not mounted Netzlaufwerk nicht verbunden
SMB port 445 is not responding SMB-Dienst in VM nicht aktiv oder blockiert

Tipp

Bei häufigen Netzwerk-Aussetzern korrelieren Sie die Zeitstempel der Fehler mit anderen Netzwerkereignissen (Router-Neustarts, VPN-Verbindungen, etc.).

Diagnose: Server vs. Client-PC

Um festzustellen, ob Netzwerkprobleme nur auf einem bestimmten Client-PC auftreten oder ein generelles Problem vorliegt, können Sie die charly.exe auch direkt auf dem Windows-Server installieren und einmal starten. Dadurch wird das Netzwerk-Monitoring auch dort eingerichtet.

Vorgehen:

  1. Stellen Sie sicher, dass charly aktuell ist: charly-server vm update
  2. Laden Sie die charly.exe auf dem Server herunter und starten Sie sie einmal
  3. Vergleichen Sie die Logfiles auf Server und Client-PC

Auswertung:

  • Probleme nur auf Client-PC: Lokales Netzwerkproblem (Firewall, Switch, Kabel, WLAN)
  • Probleme auch auf Server: Problem zwischen Server und VM oder in der VM selbst

Hinweis

Der Server hat eine direktere Verbindung zur VM. Treten dort keine Fehler auf, liegt das Problem im Netzwerk zwischen Client-PC und Server.

Client-Neuinstallation

Eine Neuinstallation des Clients ist erforderlich nach Änderung des SMB-Passworts.

WICHTIG - Client-Neuinstallation erforderlich

Nach der Änderung des SMB-Passworts müssen alle charly-Clients auf allen Arbeitsplätzen neu heruntergeladen und installiert werden!

Erforderliche Schritte auf jedem Windows-Arbeitsplatz:

  1. Netzlaufwerk trennen: Trennen Sie das Netzlaufwerk zur Ablage (typischerweise S:)
  2. Client herunterladen: Laden Sie charly-client-win.zip über das Webinterface herunter
  3. Dateien extrahieren: Entpacken Sie die Dateien (charly.exe, config.txt, install-next.ps1, Netzwerk-ping.ps1)
  4. Dateien überschreiben: Kopieren Sie alle Dateien an den Ort, an dem aktuell charly.exe liegt und überschreiben Sie die vorhandenen Dateien

Grund: Der charly-Client speichert die SMB-Anmeldedaten im Windows Credential Manager. Nach dem ersten Start migriert der Client das Passwort aus der config.txt in den Credential Manager und entfernt es aus der Datei. Bei einer Passwort-Änderung muss der neue Client heruntergeladen werden, damit das neue Passwort in den Credential Manager übernommen wird.

Tipp

Planen Sie SMB-Passwort-Änderungen außerhalb der Arbeitszeiten und informieren Sie alle Benutzer über die erforderliche Client-Neuinstallation.

Credential Manager

Hinweis

Die Dokumentation des Credential Managers wird nach der Veröffentlichung dieser Funktion erweitert.

Version: 2.10.3

Datum der letzten Aktualisierung: 09.02.2026