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.

Grundvoraussetzung: Rosetta

Wenn Sie den charly-Client auf einem Mac mit Apple Silicon (M1, M2, M3, etc.) installieren, müssen Sie vorher Rosetta installieren. Für Macs mit Intel-Prozessor ist dies nicht notwendig.

Geben Sie im Terminal folgendes ein: 

softwareupdate --install-rosetta --agree-to-license

WICHTIG

Ohne Rosetta kommt es beim Starten des charly-Clients auf Apple Silicon Macs zu einem Fehler.

Herunterladen

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

  1. Ermitteln Sie die IP-Adresse der charly-VM:
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 Datei charly-client-mac.zip herunter

Installation

Automatische Installation (empfohlen)

Die charly Starter-App verbindet automatisch den Samba-Share und lädt die neueste Version der Solutio.app herunter.

  1. Laden Sie charly-client-mac.zip über das Admin Web-Interface herunter
  2. Entpacken Sie das .zip Archiv durch Doppelklick im Finder
  3. Es sollten jetzt die charly App und die config.txt vorhanden sein
  4. Bewegen Sie die charly App und die config.txt in Ihre Programme
  5. Öffnen Sie die App in Programme über das Kontextmenü "Öffnen"

Hinweis

Beim ersten Start muss die App über das Kontextmenü "Öffnen" gestartet werden, da sie nicht aus dem App Store stammt. macOS zeigt sonst eine Warnung an (Gatekeeper).

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 Aktualisierung

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

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

Empfehlung

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

Hinweis

Beim ersten Download kann es eine Weile dauern, da die komplette Solutio.app heruntergeladen wird. Die Dateigröße der charly Starter-App wächst dadurch an.

Netzwerk-Monitoring

Die charly.app richtet automatisch ein Netzwerk-Monitoring ein, das im Hintergrund läuft und die Verbindung zur charly-VM überwacht.

Logfile-Speicherorte

Die Logs befinden sich unter: 

~/Library/Application Support/Solutio/VM/Solutio/

Log-Typen

Logfile Inhalt
charlyApp.log Hauptlog der charly.app (Start, Updates, Verbindung)
charly-client-monitor.log Netzwerk-Monitoring (Ping, SMB-Port, Mount-Status)

LaunchAgent

Das Netzwerk-Monitoring läuft als LaunchAgent im Hintergrund. Sie können den Status prüfen mit:

launchctl list | grep charly-client-monitor

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)

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 im Terminal

# Alle Fehler im Monitor-Log anzeigen
grep "ERROR" ~/Library/Application\ Support/Solutio/VM/Solutio/charly-client-monitor.log

# charly.app Log auf Fehler prüfen
grep "ERROR\|WARN" ~/Library/Application\ Support/Solutio/VM/Solutio/charlyApp.log

# LaunchAgent Status prüfen (sollte "de.solutio.charly-client-monitor" zeigen)
launchctl list | grep charly-client-monitor

# Monitor-Script manuell ausführen für sofortige Diagnose
~/Library/Application\ Support/Solutio/VM/Solutio/charly-client-monitor.sh

Typische Fehlerursachen

Fehlermeldung Mögliche Ursache
Ping failed to <IP> Server nicht erreichbar (Netzwerk, Firewall, VM heruntergefahren)
SMB port test failed SMB-Dienst in VM nicht aktiv oder Port 445 blockiert
SMB share not mounted Netzlaufwerk /Volumes/charly-ablage nicht verbunden
Failed to mount SMB share Falsche Zugangsdaten oder Netzwerkproblem

Tipp

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

LaunchAgent neu starten

Falls das Monitoring nicht läuft, können Sie es manuell neu starten:

# LaunchAgent entladen und neu laden
launchctl unload ~/Library/LaunchAgents/de.solutio.charly-client-monitor.plist
launchctl load ~/Library/LaunchAgents/de.solutio.charly-client-monitor.plist

# Status prüfen
launchctl list | grep charly-client-monitor

Diagnose: Server vs. Client-Mac

Um festzustellen, ob Netzwerkprobleme nur auf einem bestimmten Client-Mac auftreten oder ein generelles Problem vorliegt, können Sie die Logfiles auf dem macOS-Server (Host) mit denen auf dem Client-Mac vergleichen.

Vorgehen:

  1. Stellen Sie sicher, dass charly aktuell ist: charly-server vm update
  2. Starten Sie die charly.app auf dem Server einmal, um das Monitoring einzurichten
  3. Vergleichen Sie die Logfiles auf Server und Client-Mac

Auswertung:

  • Probleme nur auf Client-Mac: 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-Mac und Server.

Mehrere Solutio.app Installationen

Wenn mehrere Instanzen der Solutio.app auf dem System vorhanden sind, kann dies zu Problemen führen. Stellen Sie sicher, dass nur eine charly App in Programme vorhanden ist und entfernen Sie alte Versionen.

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 macOS-Arbeitsplatz:

  1. Netzlaufwerk trennen: Trennen Sie das Netzlaufwerk zur Ablage
  2. Client herunterladen: Laden Sie charly-client-mac.zip über das Webinterface herunter
  3. Anwendung ersetzen: Ersetzen Sie die bestehende charly.app durch die neue Version

Grund: Der charly-Client speichert die SMB-Anmeldedaten im macOS-Schlüsselbund (Keychain) unter dem Label charly.smbcredentials. Nach dem ersten Start migriert die App das Passwort aus der config.txt in den Schlüsselbund und entfernt es aus der Datei. Bei einer Passwort-Änderung muss die charly.app neu heruntergeladen werden, damit das neue Passwort in den Schlüsselbund ü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