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 nach /Applications/charly.app und die config.txt nach /Applications/config.txt
  5. Öffnen Sie die App in Programme über das Kontextmenü "Öffnen"

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:

  • Starter: Bei jedem Start vergleicht /Applications/charly.app die Prüfsumme des Client-Pakets mit dem gespeicherten Stand. Beim ersten Start wird nur der Ausgangsstand gespeichert. Eine spätere Änderung löst die Aktualisierung aus; das gilt auch für Änderungen an der mitgelieferten Konfiguration.
  • Sicherer Austausch: Das Paket, die erwartete App-Kennung und die gültige Codesignatur werden geprüft; für lokale Tests sind auch Ad-hoc-Signaturen zulässig. Anschließend beendet sich der Starter, ein temporäres Hilfsprogramm ersetzt die vollständige App und startet sie erneut. Falls nötig, fragt macOS nach Administratorrechten. Bei Abbruch bleibt der bisherige Starter nutzbar; bei einem Fehler beim Austausch wird der vorherige Stand wiederhergestellt.
  • Konfiguration: Bei einer Aktualisierung wird die mitgelieferte config.txt übernommen und ein enthaltenes SMB-Passwort beim Neustart in den Schlüsselbund übertragen.
  • Solutio.app: Der Starter prüft weiterhin Version und Build auf dem Samba-Share und lädt bei Bedarf die signierte macos/Solutio.zip von dort.

Bereits installierte Starter ohne Selbstaktualisierung müssen einmal manuell durch die neue App ersetzt werden. Außerhalb von /Applications/charly.app wird nur ein Installationshinweis angezeigt. Ist der HTTP-Download nicht erreichbar oder die Prüfung fehlgeschlagen, wird die Selbstaktualisierung übersprungen und der bisherige Startablauf fortgesetzt.

Prüfsumme und Aktualisierungsstatus liegen unter ~/Library/Preferences/Solutio/. Das zusätzliche Protokoll charly-self-update.log in diesem Verzeichnis dokumentiert die Selbstaktualisierung und wird bei einem Austausch der Solutio.app nicht gelöscht.

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 Start kann der Download der vollständigen Solutio.app länger dauern. Sie wird separat im Benutzerverzeichnis gespeichert; das Starter-Bundle wächst dadurch nicht 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

Ist nur der HTTP-Download nicht erreichbar, überspringt der Starter seine Selbstaktualisierung und setzt den bisherigen Startablauf fort. Ist der SMB-Server nicht erreichbar, beendet der Starter den Start mit einer Fehlermeldung; auch eine bereits heruntergeladene Solutio.app wird dann nicht gestartet. 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

Starter mit eingerichteter Selbstaktualisierung übernehmen eine geänderte Server-Konfiguration vor der SMB-Anmeldung automatisch und übertragen das neue Passwort in den Schlüsselbund. Alte Starter ohne diese Funktion oder Clients, deren Selbstaktualisierung fehlschlägt, benötigen eine manuelle Neuinstallation.

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 und Konfiguration ersetzen: Ersetzen Sie /Applications/charly.app und legen Sie die neue config.txt unter /Applications/config.txt ab

Grund: Der charly-Client speichert die SMB-Anmeldedaten im macOS-Schlüsselbund (Keychain) unter dem Label charly.smbcredentials. Er überträgt ein Passwort aus der config.txt in den Schlüsselbund und entfernt es erst nach erfolgreicher Übertragung aus der Datei. Die aktualisierte Konfiguration kann über die Selbstaktualisierung oder die manuelle Installation bereitgestellt werden.

Tipp

Planen Sie SMB-Passwort-Änderungen außerhalb der Arbeitszeiten und aktualisieren Sie ältere Starter vorher, damit sie die neue Konfiguration automatisch übernehmen können.

Credential Manager

Hinweis

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

Version: 2.13.1

Datum der letzten Aktualisierung: 02.11.2026