Der Agent unter Windows
Unter Windows leistet der Agent am meisten – VSS, anwendungskonsistente Sicherungen von Hyper-V und SQL Server, ein Cloud-Laufwerk auf Basis von Dokany und eine Tray-Anwendung für den Benutzer. Auf dieser Seite steht alles, was nur Windows betrifft.
Voraussetzungen #
- Windows 10 oder 11 oder Windows Server 2016 oder neuer; Builds für x64 oder ARM64. Der Agent ist eigenständig (.NET ist enthalten) und installiert die benötigte Visual-C++-Laufzeit selbst.
- Ausgehendes HTTPS (443) zu
console.caryvane.com. Eingehend nichts. Ein Proxy mit TLS-Inspektion muss der Zertifikatskette vertrauen oder den Host ausnehmen. - Lokale Administratorrechte für die Installation; danach läuft der Dienst als SYSTEM.
- Für inkrementelle Hyper-V-Backups: Server 2016 oder neuer. Für SQL Server: Der Dienst SQL Server VSS Writer muss laufen.
Die beiden Installationsprogramme #
CaryvaneAgentSetup-<ver>-x64.exe ist ein Inno-Setup-Wrapper für die Installation per Doppelklick; er führt das enthaltene MSI aus. CaryvaneAgent-<ver>-x64.msi ist für Intune, SCCM, RMM und Skripte gedacht. Beide sind mit Authenticode signiert, ebenso jede Binärdatei, die sie installieren – Defender und SmartScreen bleiben also still. Verwenden Sie auf Snapdragon-Geräten die arm64-Builds.
# MSI, silent, enrolled (the console writes this line for you under Agents → Enroll Agent)
msiexec /i "https://console.caryvane.com/downloads/agent/CaryvaneAgent-x64.msi" /quiet AURAWOLF_SERVER=https://console.caryvane.com AURAWOLF_TOKEN=<token>
# Setup EXE, silent, enrolled
CaryvaneAgentSetup-x64.exe /SP- /VERYSILENT /NORESTART /server="https://console.caryvane.com" /token="<token>"
# Uninstall (forgets the enrolment; keeps logs)
msiexec /x "CaryvaneAgent-x64.msi" /quiet
Den fertigen Befehl liefert Ihnen die Konsole unter Agenten → Agent registrieren. Intune: Verteilen Sie das MSI als Branchen-App (Line-of-Business) mit den beiden Eigenschaften in den Befehlszeilenargumenten. Ein Registrierungstoken pro Gerät ist die sichere Voreinstellung (ein Token gilt standardmäßig für einen Rechner); für eine Verteilung aus einem Paket setzen Sie im selben Dialog Rechner auf die erwartete Anzahl oder haken Unbegrenzt an (oder maxUses über die API).
Was wo landet #
| Element | Ort |
|---|---|
| Binärdateien von Dienst und Tray-Anwendung | C:\Program Files\Caryvane\Caryvane Agent\ |
| Dienst | CaryvaneAgent, Starttyp Automatisch, läuft als SYSTEM |
| Tray-Anwendung | Caryvane.Agent.Tray.exe, startet bei der Anmeldung (HKCU Run) und wird vom Dienst neu gestartet, falls sie beendet wird |
| Registrierung, Datenbank, Manifeste, Cache | C:\ProgramData\Aurawolf\ – token.json, local_store.db, manifests\, cache\, hyperv-chains\ |
| Protokolle | C:\ProgramData\Aurawolf\logs\agent.log (täglich rotierend); ab Stufe INFO an die Konsole übertragen |
| Server-URL und Registrierungstoken aus einer MSI-Installation | HKLM\SOFTWARE\Centurion Computers\Aurawolf Agent |
| Treiber für Cloud-Laufwerke | Dokany, vom MSI installiert; erscheint unter „Programme hinzufügen oder entfernen“ als Dokan Library |
Die Namen mit Aurawolf sind der ursprüngliche Produktname und wurden bewusst beibehalten, damit ein Upgrade nie eine Registrierung verwaist zurücklässt.
Die Tray-Anwendung #
Sie läuft in der Sitzung des Benutzers, hält keine Zugangsdaten und spricht über eine lokale Named Pipe mit dem Dienst. Sie zeigt den Status (registriert/online) und die Upload-Warteschlange der Cloud-Laufwerke, bietet Enroll Agent… an, solange der Rechner nicht registriert ist, öffnet die Konsole und – wenn die Laufwerksanmeldung des Kunden es erlaubt – Sign in to Caryvane Drive… für die eigenen Laufwerke einer Person. Sie erledigt auch die Explorer-Arbeit für Cloud-Laufwerke: den Knoten des Kunden im Navigationsbereich mit den Laufwerken darunter, die Kontextmenüeinträge Version history… und Tag…, Archiving… auf Ordnern, bei denen das Markieren unter Windows erlaubt ist, und das Fenster N files to tag… für Dateien, die ohne eine Pflichtspalte gespeichert wurden. (Tray-Anwendung und Explorer-Einträge sind derzeit nur auf Englisch verfügbar.)
Selbstaktualisierung #
Wird ein Release veröffentlicht, lädt der Agent das MSI beim nächsten Melden herunter und prüft seine Signatur. Laufende Jobs lässt er zu Ende laufen; danach hält er an, aktualisiert und startet neu – etwa eine Minute Ausfall. Ein Job, der seit mehr als 72 Stunden zu laufen scheint, oder eine abgebrochene Ausführung hält das Update nicht auf. Upgrades behalten alles in ProgramData. Die Versionsspalte der Konsole zeigt, welche Rechner schon umgestellt sind; ein Rechner, der auf einer alten Version hängt, ist offline oder erreicht die Konsole nicht.
Deinstallation #
Über „Programme hinzufügen oder entfernen“ oder msiexec /x. Eine echte Deinstallation stoppt den Dienst, entfernt das Programm und vergisst den Rechner: Registrierungstoken, lokale Datenbank, Statusdatei und Laufwerks-Cache werden gelöscht, damit sich eine Neuinstallation neu registriert; die Protokolle bleiben erhalten. Ein Upgrade tut das nie.
Funktionen nur für Windows #
- Geöffnete und gesperrte Dateien einbeziehen (VSS) in Datei-Jobs.
- Anwendungskonsistente Jobs (Hyper-V, SQL Server oder Active Directory sichern) für Hyper-V, SQL Server und Active Directory.
- EFS-verschlüsselte Dateien werden mit einer Warnung übersprungen (SYSTEM kann die EFS-Dateien eines anderen Benutzers nicht lesen); entschlüsseln oder ausschließen Sie sie.