Zum Inhalt

charly Client

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

Herunterladen

Der charly-Client kann ueber 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. Oeffnen Sie den Menueeintrag "Downloads"
  3. Laden Sie die benoetigten Dateien herunter:
  4. charly-client-win.zip - Client-Anwendung
  5. install-next.ps1 - NeXT-Installationsskript (nur bei Erstinstallation)

Grundvoraussetzung: NeXT-Laufzeitumgebung

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

  1. Laden Sie das install-next.ps1 Skript ueber das Admin Web-Interface herunter
  2. Fuehren Sie das Skript aus:

Windows Administrator Powershell: 

.\install-next.ps1

Tipp

Wenn das Programm charly.exe ausgefuehrt wird, ueberprueft 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 ueber das Skript verbindet automatisch den SMB-Share und laedt die neueste Version des charly-Clients herunter.

  1. Laden Sie charly-client-win.zip ueber das Admin Web-Interface herunter
  2. Bewegen Sie das Archiv an den gewuenschten Installationsort
  3. Entpacken Sie das Archiv. Es enthaelt charly.exe und config.txt
  4. Starten Sie charly.exe

Hinweis

Sollte beim ersten Ausfuehren der charly.exe die Warnung "Moechten Sie Software dieses nicht vertrauenswuerdigen Herausgebers ausfuehren?" erscheinen, dann waehlen Sie bitte "Immer ausfuehren" und klicken "OK". Warnung Software dieses nicht vertrauenswuerdigen Herausgebers ausfuehren?

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 ueber eine Gruppenrichtlinie gemountet wurde, dann muessen 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 ueberprueft der Client, ob eine neuere Version verfuegbar 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 ueberwacht.

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 benoetigt folgende Netzwerkverbindungen:

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

Gruppenrichtlinien (GPO)

WICHTIG

Wenn Netzlaufwerke ueber Gruppenrichtlinien gemountet werden, kann dies zu Konflikten mit dem charly-Client fuehren. 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 uebersprungen
  • Das Netzwerk-Monitoring protokolliert Verbindungsfehler

Fehlerbehebung

Client reagiert nicht oder stuerzt ab

Wenn der charly-Client "Keine Rueckmeldung" zeigt oder regelmaessig abstuerzt, pruefen 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 (Verbindungsabbrueche zur Ablage)
Get-Content "$env:PROGRAMDATA\CharlyClient\logs\SMB-check_*.log" | Select-String "ERROR|WARNING"

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

Typische Fehlerursachen

Fehlermeldung Moegliche 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 haeufigen 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, koennen 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 Aenderung des SMB-Passworts.

WICHTIG - Client-Neuinstallation erforderlich

Nach der Aenderung des SMB-Passworts muessen alle charly-Clients auf allen Arbeitsplaetzen 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 ueber das Webinterface herunter
  3. Dateien extrahieren: Entpacken Sie die Dateien (charly.exe, config.txt, install-next.ps1, Netzwerk-ping.ps1)
  4. Dateien ueberschreiben: Kopieren Sie alle Dateien an den Ort, an dem aktuell charly.exe liegt und ueberschreiben 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-Aenderung muss der neue Client heruntergeladen werden, damit das neue Passwort in den Credential Manager uebernommen wird.

Tipp

Planen Sie SMB-Passwort-Aenderungen ausserhalb der Arbeitszeiten und informieren Sie alle Benutzer ueber die erforderliche Client-Neuinstallation.

Credential Manager

Hinweis

Die Dokumentation des Credential Managers wird nach der Veroeffentlichung dieser Funktion erweitert.

Version: 2.9.4

Datum der letzten Aktualisierung: 13.01.2026