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 #
| Was | Wo |
|---|---|
| Eine Job-Ausführung: was sie getan hat, Datei für Datei | Konsole → Jobs → ⋮ → Ausführungsverlauf → die Ausführung. Fehlgeschlagene Dateien sind jeweils mit dem Grund aufgeführt. |
| Das Protokoll des Agenten selbst, aus der Konsole | Wird laufend übertragen (INFO und höher). Lesbar mit dem Tool get_agent_logs, oder fragen Sie uns. |
| Windows, auf dem Rechner | C:\ProgramData\Aurawolf\logs\agent.log (täglich rotierend); das Tray-Programm schreibt tray.log daneben |
| macOS | sudo launchctl print system/com.caryvane.agent; Protokolldateien unter /Library/Application Support/Caryvane/logs/ |
| Linux | journalctl -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:
- Läuft der Dienst? Windows:
Get-Service CaryvaneAgent. macOS:launchctl print system/com.caryvane.agent. Linux:systemctl status caryvane-agent. - 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. - 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.
- Lesen Sie das Protokoll. Die letzten Zeilen von
agent.logsagen, 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:
- Nicht registriert. Eine unbeaufsichtigte Installation mit einem abgelaufenen oder bereits verwendeten Token lässt den Agenten installiert und wartend zurück. Rechtsklick auf das Tray-Symbol → Enroll Agent… (das Tray-Programm zeigt den Eintrag derzeit auf Englisch) mit einem neuen Token. Unter macOS/Linux schreiben Sie
setup.json/agent.jsonmit dem Token und starten den Dienst neu (Agent bereitstellen). - Anderswo registriert. Der Rechner hat eine Registrierung von einem anderen Server (einer Pilotumgebung) oder bei einem gelöschten Kunden, und die Konsole, auf die er zeigt, lehnt sie ab. Der aktuelle Agent erkennt das, verwirft die ungültige Registrierung und fordert über das Tray ein neues Token an. Hängt ein Rechner mit einem alten Build so fest, installieren Sie die aktuelle Version darüber – ohne vorherige Deinstallation – und registrieren ihn dann.
- Falscher Kunde. Das Token bestimmt den Kunden. Sehen Sie bei den anderen Kunden nach, auf die Sie Zugriff haben; ist er beim falschen gelandet, deinstallieren Sie (dabei wird die Registrierung vergessen) und installieren Sie mit dem richtigen Token neu.
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:
| Protokollzeile | Ursache | Was 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 software | Windows 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 #
- „Interrupted: the agent restarted while this run was in progress.“ Der Rechner oder der Dienst wurde während der Ausführung neu gestartet (der Klassiker: Windows Update um 3 Uhr). Die nächste geplante Ausführung setzt dort fort, wo das inkrementelle Backup aufgehört hat. Passiert das jede Nacht, gleichen Sie den Neustartplan des Rechners mit dem Zeitplan des Jobs ab.
- Speicherfehler (Zugriff verweigert, Bucket nicht gefunden, Signatur stimmt nicht) – Speicher → Testen am Speicherziel. Ein rotierter Schlüssel, eine abgelaufene SAS, ein vom Administrator des Kunden widerrufenes OAuth-Token: All das zeigt sich hier zuerst. Egnyte-Tokens laufen nach 30 Tagen ab und werden nur automatisch erneuert, solange die Verbindung genutzt wird.
- „Source and destination must be different“ / Fehler zur Erreichbarkeit aus der Cloud – ein Cloud-Agent-Job kann keine LAN-Freigabe und keinen lokalen Ordner lesen; führen Sie ihn stattdessen auf einem Agenten aus.
- „Cancelled: superseded by a newer run.“ Nach dem Fehler wurde ein erneuter Versuch eingereiht, aber die nächste geplante Ausführung hat zuerst begonnen. Nur zur Information.
Hyper-V-Jobs #
- „Production checkpoints cannot be created“ für eine VM – der Gast kann nicht in einen konsistenten Zustand versetzt werden (Linux ohne Integrationsdienste oder ein Windows-Gast mit deaktiviertem VSS-Integrationsdienst). Caryvane erstellt stattdessen einen absturzkonsistenten Prüfpunkt und vermerkt das im Protokoll; aktivieren Sie unter den Integrationsdiensten der VM die Sicherung (Volumeschattenkopie), um Anwendungskonsistenz zu erhalten.
- Ein auf der VM zurückgebliebener Prüfpunkt nach einer unterbrochenen Ausführung – der Agent merkt sich jeden Prüfpunkt, den er erstellt, und führt zu Beginn der nächsten Ausführung alle übrig gebliebenen zusammen. Zeigt eine VM Tage später noch einen veralteten Backup-Prüfpunkt, löschen Sie ihn im Hyper-V-Manager; das Zusammenführen geschieht im laufenden Betrieb.
- Langsamer als erwartet – ein Backup der ganzen VM überträgt die komplette
.vhdx; die Größe im Ausführungsverlauf ist die Dateigröße, nicht die virtuelle Größe des Datenträgers. Inkrementelles Backup (geänderte Blöcke) ab Server 2016 reduziert das auf die nächtlichen Änderungen, sobald es über die API für den Agenten aktiviert ist (Hyper-V).
Cloud-Laufwerk wird nicht eingebunden #
- 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.
- 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.
- macOS: Ein Benutzer muss angemeldet sein (das FSKit-Modul läuft in der Benutzersitzung), und
Caryvane.appbraucht Festplattenvollzugriff. Prüfen Sie, ob unter Systemeinstellungen → Allgemein → Anmeldeobjekte & Erweiterungen → Dateisystemerweiterungen Caryvane aktiviert ist. - Linux:
fusermount3muss vorhanden sein und der Mountpunkt angelegt werden können; siehe Journal. - 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 #
- Microsoft 365: „consent“- oder 401-Fehler – ein globaler Administrator hat die App oder ihre Berechtigungen entfernt. Klicken Sie unter Connectors erneut auf Microsoft 365 verbinden, um die Zustimmung neu zu erteilen.
- Google Workspace: 403 bei einem Benutzer – die domainweite Delegierung wurde geändert, oder die Bereichsliste in der Admin-Konsole stimmt nicht mehr. Erneut prüfen auf der Seite Connectors nennt den fehlenden Bereich.
- Neue Benutzer werden nicht gesichert – der Job führt bestimmte Personen auf. Bearbeiten Sie ihn und wählen Sie für den Ressourcentyp die Option Alle … (z. B. Alle Postfächer (inkl. neuer)); danach werden neue Benutzer automatisch einbezogen.
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 #
- Versionshinweise — was sich in jeder Version geändert hat