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.

Grundvoraussetzung: Rosetta

Wenn Sie den charly-Client auf einem Mac mit Apple Silicon (M1, M2, M3, etc.) installieren, muessen Sie vorher Rosetta installieren. Fuer 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 ueber 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. Oeffnen Sie den Menueeintrag "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 laedt die neueste Version der Solutio.app herunter.

  1. Laden Sie charly-client-mac.zip ueber 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. Oeffnen Sie die App in Programme ueber das Kontextmenü "Oeffnen"

Hinweis

Beim ersten Start muss die App ueber das Kontextmenue "Oeffnen" 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 fuer Windows nach.

Automatische Aktualisierung

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

  • Bei jedem Start ueberprueft die charly-App, ob eine neuere Version der Solutio.app verfuegbar 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 Dateigroesse der charly Starter-App waechst dadurch an.

Netzwerk-Monitoring

Die charly.app richtet automatisch ein Netzwerk-Monitoring ein, das im Hintergrund laeuft und die Verbindung zur charly-VM ueberwacht.

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 laeuft als LaunchAgent im Hintergrund. Sie koennen den Status pruefen mit:

launchctl list | grep charly-client-monitor

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)

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 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 pruefen
grep "ERROR\|WARN" ~/Library/Application\ Support/Solutio/VM/Solutio/charlyApp.log

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

# Monitor-Script manuell ausfuehren fuer sofortige Diagnose
~/Library/Application\ Support/Solutio/VM/Solutio/charly-client-monitor.sh

Typische Fehlerursachen

Fehlermeldung Moegliche 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 haeufigen Netzwerk-Aussetzern korrelieren Sie die Zeitstempel der Fehler mit anderen Netzwerkereignissen (Router-Neustarts, VPN-Verbindungen, etc.).

LaunchAgent neu starten

Falls das Monitoring nicht laeuft, koennen 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 pruefen
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, koennen 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 fuehren. 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 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 macOS-Arbeitsplatz:

  1. Netzlaufwerk trennen: Trennen Sie das Netzlaufwerk zur Ablage
  2. Client herunterladen: Laden Sie charly-client-mac.zip ueber 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-Schlueesselbund (Keychain) unter dem Label charly.smbcredentials. Nach dem ersten Start migriert die App das Passwort aus der config.txt in den Schlueesselbund und entfernt es aus der Datei. Bei einer Passwort-Aenderung muss die charly.app neu heruntergeladen werden, damit das neue Passwort in den Schlueesselbund 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