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.

Installation

charly-Client_Setup.exe ist der empfohlene Installationsweg für alle Benutzer. Das Setup installiert die NeXT-Laufzeitumgebung und den charly-Client gemeinsam, übernimmt die Serverkonfiguration und erstellt die Desktop-Verknüpfung charly.

Setup herunterladen

  1. Öffnen Sie das Admin Web-Interface der charly-VM im Browser.
  2. Öffnen Sie Downloads und laden Sie charly-Client.zip herunter.
  3. Entpacken Sie charly-Client_Setup.exe und config.txt gemeinsam in einen Ordner.

Setup ausführen

  1. Doppelklicken Sie auf charly-Client_Setup.exe.
  2. Bestätigen Sie die Windows-Benutzerkontensteuerung. Für die Installation sind Administratorrechte erforderlich.

  3. Prüfen Sie die vorbelegten Verbindungsdaten und passen Sie sie bei Bedarf an. Als SMB-Benutzername wird immer smbuser verwendet:

    Feld Wert
    Server-IP IPv4-Adresse des charly-Servers, zum Beispiel 192.0.2.10
    SMB-Passwort Passwort für die SMB-Ablage
    Laufwerksbuchstabe Gewünschter Laufwerksbuchstabe ohne Doppelpunkt; Vorgabe ist S

Das Setup prüft die Server-IP als IPv4-Adresse und akzeptiert als Laufwerksbuchstaben genau einen Buchstaben von A bis Z.

  1. Schließen Sie die Installation ab. Das Setup prüft im Hintergrund eine vorhandene NeXT-Installation. Beim Abgleich des charly-Clients zeigt es den Hinweis „Der charly Client wird im Hintergrund heruntergeladen und eingerichtet …“. Es vergleicht vier Versionsdateien mit der SMB-Ablage und lädt Solutio.zip nur bei einer Abweichung oder fehlenden lokalen Dateien herunter. Ist die Ablage vorübergehend nicht erreichbar, wird dies protokolliert und beim ersten Start erneut versucht.
  2. Falls NeXT nach der Installation einen Neustart verlangt, starten Sie Windows neu, bevor Sie charly verwenden. Andernfalls können Sie bei Bedarf charly jetzt starten aktivieren und das Setup abschließen. Die Option ist standardmäßig deaktiviert.

Bei Neuinstallationen installiert das Setup den Client standardmäßig nach C:\Solutio\charly-Client. Der Installationspfad kann im Setup geändert werden. Bestehende Installationen können ihren bisherigen Ordner behalten, beispielsweise C:\Solutio\CharlyClient oder einen benutzerdefinierten Pfad. Verwenden Sie in diesem Fall den tatsächlichen Installationsordner für die folgenden Schritte. Lokale Benutzer erhalten Änderungsrechte für den gewählten Ordner, damit charly.exe den Client später ohne Administratorrechte aktualisieren kann. Dort müssen nach erfolgreicher Installation charly.exe, install-next.ps1, netzwerk-ping.ps1, SharedClientFunctions.psm1, 7za.exe.bin, 7za-License.txt und config.txt vorhanden sein. War die SMB-Ablage erreichbar, ist außerdem Solutio.app vorbereitet. Kann keine vollständige config.txt geschrieben werden, schlägt die Installation fehl und wird zurückgerollt.

Die Desktop-Verknüpfung charly startet den Client und wird bei der Deinstallation wieder entfernt.

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.

Konfiguration reparieren oder ändern

Starten Sie charly-Client_Setup.exe erneut und wählen Sie Reparieren. Werte aus einer config.txt neben dem Setup werden zuerst in die Eingabefelder übernommen; fehlende Werte werden aus der installierten config.txt ergänzt. Fehlen beide Dateien, ist der Laufwerksbuchstabe S vorbelegt; die übrigen Werte müssen erneut eingegeben werden. Als SMB-Benutzername wird immer smbuser verwendet.

Nach einer Änderung des SMB-Passworts laden Sie charly-Client.zip erneut herunter und führen das Setup als Reparatur aus. Dadurch wird die serverspezifische Konfiguration übernommen, ohne den Client manuell zu kopieren. Bei jeder Reparatur vergleicht das Setup außerdem Solutio.version, Solutio.flg, Solutio.exe.info und Solutio.exe.build mit der SMB-Ablage. Solutio.zip wird nur bei einer Abweichung oder fehlenden lokalen Dateien erneut kopiert und entpackt.

Deinstallation

Deinstallieren Sie charly-Client über die installierten Apps in den Windows-Einstellungen oder starten Sie charly-Client_Setup.exe erneut und wählen Sie Entfernen. Die gemeinsam nutzbare NeXT-Laufzeitumgebung bleibt installiert.

Manuelle Installation der NeXT-Laufzeitumgebung

Das charly-Client Setup installiert NeXT automatisch. Falls NeXT unabhängig davon installiert oder repariert werden muss:

  1. Öffnen Sie eine Windows Administrator PowerShell im Installationsordner des charly-Clients, bei Neuinstallationen standardmäßig C:\Solutio\charly-Client. Verwenden Sie bei bestehenden Installationen gegebenenfalls den bisherigen Ordner.

  2. Führen Sie das dort installierte Skript aus:

    .\install-next.ps1

Wenn charly.exe ohne einsatzbereite NeXT-Laufzeitumgebung gestartet wird, verweist der Client auf install-next.ps1 im selben Ordner.

Automatische Aktualisierung des Starters

Der Starter prueft beim Start das Client-Paket der charly-VM. Die entpackten Dateien bleiben unter %ProgramData%\CharlyClient\extracted erhalten, bis ein neues Paket erfolgreich heruntergeladen und entpackt wurde. Die laufende charly.exe wird erst nach ihrem Ende ersetzt; erst danach wird der Paket-Hash gespeichert und der aktualisierte Starter bei Bedarf neu gestartet. Fehler stehen im Tagesprotokoll unter %ProgramData%\CharlyClient\logs; die erhaltenen Dateien erlauben einen erneuten Versuch beim naechsten Start.

Aeltere Starter koennen bereits den aktuellen Paket-Hash gespeichert haben, obwohl ihre EXE nicht ersetzt wurde. Sobald sie das korrigierte gemeinsame Modul geladen haben, laden sie das Paket deshalb erneut und ersetzen die EXE nach ihrem Ende. Dafuer koennen nach Bereitstellung des Updates zwei Starts erforderlich sein. Ein fehlender Parameter fuer das Ping-Monitoring wird nur protokolliert; der Start der Anwendung wird fortgesetzt. Die Wiederherstellung setzt voraus, dass der alte Starter seinen Update-Schritt erreicht und der Installationsordner beschreibbar ist.

Für Systembetreuer: Installation über die CLI

Die folgenden Befehle sind für unbeaufsichtigte Installationen und Softwareverteilung vorgesehen. Entpacken Sie charly-Client.zip und öffnen Sie eine PowerShell als Administrator im Zielordner.

Falls die Adresse des Admin Web-Interface nicht bekannt ist, ermitteln Sie die IP-Adresse der charly-VM auf dem Windows-Server:

charly-server vm status

Erstinstallation mit beigefügter Konfiguration

Wenn config.txt neben dem Setup liegt, übernimmt es SMB_IP, SMB_PASSWORD und SMB_MOUNT_POINT daraus:

$setup = Start-Process `
    -FilePath ".\charly-Client_Setup.exe" `
    -ArgumentList "/quiet", "/norestart" `
    -Wait `
    -PassThru

$setup.ExitCode

Erstinstallation mit Parametern

$setup = Start-Process `
    -FilePath ".\charly-Client_Setup.exe" `
    -ArgumentList @(
        "/quiet"
        "/norestart"
        "SMB_IP=192.0.2.10"
        "SMB_PASSWORD=secret"
        "SMB_MOUNT_POINT=S"
    ) `
    -Wait `
    -PassThru

$setup.ExitCode

Explizite Parameter haben Vorrang vor config.txt. Als SMB-Benutzername wird immer smbuser verwendet und SMB_MOUNT_POINT verwendet standardmäßig S; nur SMB_IP und SMB_PASSWORD müssen aus der Datei, aus Parametern oder aus einer Kombination davon verfügbar sein.

Ein großes Update erkennt den bisherigen Installationsordner automatisch und ergänzt fehlende Parameter aus der dort installierten config.txt. Ein benutzerdefinierter Installationsordner bleibt deshalb auch bei einer unbeaufsichtigten Aktualisierung ohne danebenliegende Konfigurationsdatei erhalten.

Unbeaufsichtigte Reparatur

Ein normaler Installationsaufruf führt bei einem bereits vorhandenen Client möglicherweise keine MSI-Aktion aus. Verwenden Sie deshalb ausdrücklich /repair, wenn die installierte Konfiguration aktualisiert oder neu erstellt werden soll:

$setup = Start-Process `
    -FilePath ".\charly-Client_Setup.exe" `
    -ArgumentList "/repair", "/quiet", "/norestart" `
    -Wait `
    -PassThru

$setup.ExitCode

Die Reparatur verwendet zuerst explizite Parameter, dann config.txt neben dem Setup und ergänzt fehlende Werte aus der installierten config.txt.

Unbeaufsichtigte Deinstallation

$setup = Start-Process `
    -FilePath ".\charly-Client_Setup.exe" `
    -ArgumentList "/uninstall", "/quiet", "/norestart" `
    -Wait `
    -PassThru

$setup.ExitCode

Exitcode 0 bedeutet Erfolg, 3010 bedeutet Erfolg mit erforderlichem Neustart. Burn- und MSI-Protokolle befinden sich unter %TEMP%. Die Deinstallation entfernt außerdem die heruntergeladene Solutio.app, temporäre Update-Dateien und die installierte Konfiguration. Diagnoseprotokolle unter %ProgramData%\CharlyClient\logs bleiben erhalten.

Zugangsdaten

Das SMB-Passwort wird im Klartext in C:\Solutio\charly-Client\config.txt beziehungsweise im tatsächlichen Installationsordner gespeichert. Wird es als CLI-Parameter übergeben, kann es während der Ausführung zusätzlich in der Prozessliste sichtbar sein. Das Setup blendet das Passwort in seinen Logdateien aus.

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

Solutio.app fehlt nach der Installation

Ein fehlgeschlagener Hintergrund-Download bricht die Installation nicht ab. Stellen Sie sicher, dass der charly-Server erreichbar ist, und starten Sie anschließend die Desktop-Verknüpfung charly. charly.exe wiederholt denselben Versionsvergleich und lädt Solutio.zip bei Bedarf erneut herunter.

Für die Diagnose öffnen Sie das neueste Burn- beziehungsweise MSI-Protokoll unter %TEMP% und suchen nach InstallSolutio oder WARNUNG.

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 den charly-Client auch 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 charly-Client.zip über das Admin Web-Interface herunter und installieren Sie den Client mit charly-Client_Setup.exe
  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.

Version: 2.13.1

Datum der letzten Aktualisierung: 02.11.2026