CaryvaneHilfe
/
DE

Fehlerbehebung

Zuerst das Symptom, dann die Prüfungen in der Reihenfolge, die die Ursache am schnellsten findet. Jeder Agent schickt außerdem sein eigenes Protokoll an die Konsole, sodass sich das meiste diagnostizieren lässt, ohne den Rechner anzufassen.

Wo die Protokolle liegen #

WasWo
Eine Job-Ausführung: was sie getan hat, Datei für DateiKonsole → Jobs → ⋮ → Ausführungsverlauf → die Ausführung. Fehlgeschlagene Dateien sind jeweils mit dem Grund aufgeführt.
Das Protokoll des Agenten selbst, aus der KonsoleWird laufend übertragen (INFO und höher). Lesbar mit dem Tool get_agent_logs, oder fragen Sie uns.
Windows, auf dem RechnerC:\ProgramData\Aurawolf\logs\agent.log (täglich rotierend); das Tray-Programm schreibt tray.log daneben
macOSsudo launchctl print system/com.caryvane.agent; Protokolldateien unter /Library/Application Support/Caryvane/logs/
Linuxjournalctl -u caryvane-agent

Agent wird als Offline angezeigt #

Ein Agent ist Online, solange er sich in den letzten 90 Sekunden gemeldet hat. Offline heißt, dass die Konsole nichts von ihm gehört hat; vielleicht ist der Rechner einfach aus. Laptops und Altrechner kommen und gehen erwartungsgemäß, das ist kein Fehler. Wenn er eingeschaltet sein sollte:

  1. Läuft der Dienst? Windows: Get-Service CaryvaneAgent. macOS: launchctl print system/com.caryvane.agent. Linux: systemctl status caryvane-agent.
  2. Erreicht er die Konsole? Auf dem Rechner: curl -sI https://console.caryvane.com/healthz (oder die Adresse im Browser öffnen). Nur ausgehend 443 (Adressen und Firewallregeln); ein Proxy, der TLS aufbricht, muss der Zertifikatskette vertrauen oder den Host ausnehmen.
  3. Wird er gerade aktualisiert? Der Agent hält etwa eine Minute an, während eine neue Version installiert wird, und kommt von selbst zurück. Die Spalte Version zeigt, ob das geklappt hat.
  4. Lesen Sie das Protokoll. Die letzten Zeilen von agent.log sagen, was er gerade getan hat. Wiederholt sich „Server rejected the machine token“, ist die Registrierung ungültig.

Agent installiert, aber nicht in der Konsole – oder das Tray meldet „Registered“ und die Konsole sieht das anders #

Drei Ursachen, nach Wahrscheinlichkeit geordnet:

Virenschutz-Meldungen bei der Installation

Das Installationsprogramm und jede darin enthaltene Binärdatei sind codesigniert. Eine Meldung bei einem alten Download deutet meist auf eine unsignierte Vorabversion hin; laden Sie das aktuelle Installationsprogramm aus der Konsole herunter.

Job mit Warnung beendet #

Warnung heißt: Die Ausführung ist abgeschlossen, einige Dateien wurden übersprungen. Das Ausführungsprotokoll nennt jede einzelne mit dem Grund. Die häufigsten:

ProtokollzeileUrsacheWas zu tun ist
SKIPPED (encrypted with EFS — the agent cannot read it)Mit Windows-EFS verschlüsselte Dateien kann nur der Benutzer lesen, der sie verschlüsselt hat; der Agent läuft als SYSTEM.Entschlüsseln (cipher /d) oder den Ordner ausschließen. Das ist bewusst eine Warnung, kein Fehler.
Skipped (in use by another program)Eine exklusive Sperre, und VSS war aus oder konnte keinen Snapshot des Volumes erstellen.Aktivieren Sie im Job Geöffnete und gesperrte Dateien einbeziehen (nutzt VSS); für Datenbanken und VMs verwenden Sie einen anwendungskonsistenten Job (Hyper-V, SQL Server oder Active Directory sichern).
… contains a virus or potentially unwanted softwareWindows Defender hat das Lesen blockiert. Oft ein alter Keygen oder Crack im Download-Ordner eines Benutzers.Ausschließen oder vom Kunden löschen lassen. Caryvane umgeht den Virenschutz nicht.
Skipped (stored in the cloud, not on this machine)Ein OneDrive-/Dropbox-Platzhalter – die Daten der Datei liegen nicht auf dem Datenträger.Sichern Sie das Cloud-Konto stattdessen mit einem Connector- oder Speicherziel-Job.

Job fehlgeschlagen #

Hyper-V-Jobs #

Cloud-Laufwerk wird nicht eingebunden #

  1. Agent online und registriert, und zwar als der Agent, dem das Laufwerk hinzugefügt wurde. Laufwerke werden beim Melden übertragen; ein Offline-Agent hat nichts einzubinden.
  2. Windows: Der Dokany-Treiber muss installiert sein (Programme hinzufügen oder entfernen → Dokan Library). Das Installationsprogramm fügt ihn hinzu; bei einer Erstinstallation braucht manches System einen Neustart, bevor der Treiber lädt. Der gewählte Laufwerksbuchstabe muss frei sein.
  3. macOS: Ein Benutzer muss angemeldet sein (das FSKit-Modul läuft in der Benutzersitzung), und Caryvane.app braucht Festplattenvollzugriff. Prüfen Sie, ob unter Systemeinstellungen → Allgemein → Anmeldeobjekte & Erweiterungen → Dateisystemerweiterungen Caryvane aktiviert ist.
  4. Linux: fusermount3 muss vorhanden sein und der Mountpunkt angelegt werden können; siehe Journal.
  5. Der Test des Speicherziels muss erfolgreich sein – ein Laufwerk auf einem Speicherziel mit ungültigen Zugangsdaten wird leer oder gar nicht eingebunden.

Connector funktioniert nicht mehr #

Ein Job lief zur falschen Zeit #

Cron-Zeitpläne laufen in UTC. 0 2 * * * ist 02:00 UTC – in Deutschland 03:00 Uhr (MEZ), während der Sommerzeit 04:00 Uhr (MESZ). Passen Sie die Stunde an und rechnen Sie damit, dass sich die Uhrzeit bei der Zeitumstellung um eine Stunde verschiebt.

Kommen Sie nicht weiter? #

Schreiben Sie an hello@caryvane.com mit Kunde, Rechnername und Uhrzeit der Ausführung; wir können das übertragene Protokoll des Agenten auf unserer Seite lesen, ganz ohne Screenshot. Für einen Rechner, der die Konsole gar nicht erreicht, hängen Sie die letzten 200 Zeilen von agent.log an.

Weiterführende Themen #