Agent bereitstellen
Der Agent ist ein Dienst, der auf dem zu sichernden Rechner läuft. Er registriert sich mit einem Registrierungstoken bei genau einem Kunden, meldet sich bei der Konsole und erledigt die Arbeit. Es gibt ein Installationsprogramm pro Plattform; von Kunde zu Kunde unterscheidet sich nur das Token.
Sie brauchen ein Registrierungstoken für den Kunden, zu dem dieser Rechner gehört. Ein Token gilt standardmäßig für einen Rechner (für eine Verteilung setzen Sie im Dialog Agent registrieren die Anzahl unter Rechner oder haken Unbegrenzt an) und läuft ab – nach 24 Stunden, sofern Sie nichts anderes gewählt haben, wählbar von 1 Stunde bis 90 Tage –, erstellen Sie es also erst, wenn Sie installieren. Der Rechner braucht ausgehendes HTTPS (443) zu console.caryvane.com; eingehend nichts. Die Adressen, und wo Sie sie sonst noch freigeben müssen.
Windows #
Windows 10/11 und Server 2016 oder neuer, x64 oder ARM64. Für jede Architektur gibt es zwei Installationsprogramme: eine Setup-EXE für Doppelklick und Installation von Hand und das darin enthaltene MSI für Intune, SCCM, RMM und Skripte. Beide sind codesigniert, ebenso jede Binärdatei, die sie installieren.
Stille Installation mit Token (RMM, Intune, Skripte) #
Die Konsole schreibt Ihnen diesen Befehl, wenn Sie ein Token erstellen – Agenten → Agent registrieren –, mit der aktuellen MSI-URL und bereits eingetragenem Token. Es ist das MSI, still ausgeführt:
msiexec /i "https://console.caryvane.com/downloads/agent/CaryvaneAgent-x64.msi" /quiet AURAWOLF_SERVER=https://console.caryvane.com AURAWOLF_TOKEN=<token>
Oder die Setup-EXE, die dieselben zwei Werte annimmt und das MSI für Sie ausführt:
CaryvaneAgentSetup-x64.exe /SP- /VERYSILENT /NORESTART /server="https://console.caryvane.com" /token="<token>"
Verwenden Sie auf ARM-Geräten (Surface Pro X, Snapdragon-Laptops) den arm64-Build; der x64-Build verweigert dort die Installation.
Das Installationsprogramm registriert einen Windows-Dienst und schreibt nach Program Files; ein RMM, das als SYSTEM läuft, ist ideal. Mit einem bereits verwendeten oder abgelaufenen Token ist der Agent zwar installiert, aber nicht registriert – er wartet dann auf die Registrierung über das Infobereich-Symbol und erscheint bis dahin in keiner Konsole.
Interaktive Installation #
- Laden Sie die Setup-EXE aus der Konsole herunter (Agenten → Agent registrieren zeigt den Link) und führen Sie sie aus. Sie installiert den Dienst, die Tray-Anwendung und – falls jemals ein Cloud-Laufwerk eingebunden wird – den dafür nötigen Dokany-Treiber.
- Über das Infobereich-Symbol registrieren. Rechtsklick auf das Caryvane-Symbol im Infobereich → Enroll Agent… → Registrierungstoken einfügen → Connect. (Die Tray-Anwendung zeigt diese Einträge derzeit auf Englisch.) Der Status wechselt innerhalb weniger Sekunden auf registriert.
- In der Konsole prüfen. Agenten listet den Rechner unter dem Kunden, zu dem das Token gehörte, als Online, mit seiner Version. Ist er nach einer Minute nicht da, lesen Sie Agent installiert, aber nicht in der Konsole.
Was wo liegt #
| Was | Wo |
|---|---|
| Binärdateien von Dienst und Tray-Anwendung | C:\Program Files\Caryvane\Caryvane Agent\ |
| Windows-Dienst | CaryvaneAgent (läuft als SYSTEM) |
| Registrierungstoken, lokale Datenbank, Laufwerks-Cache | C:\ProgramData\Aurawolf\ |
| Protokolle | C:\ProgramData\Aurawolf\logs\agent.log |
| Server-URL und Token aus einer MSI-Installation | HKLM\SOFTWARE\Centurion Computers\Aurawolf Agent |
Die Namen mit Aurawolf sind der ursprüngliche Produktname und stimmen so; sie wurden auf dem Datenträger bewusst beibehalten, damit ein Upgrade nie die Registrierung eines Rechners verwaist zurücklässt.
Upgrades und Deinstallation #
Agenten aktualisieren sich selbst: Wird eine neue Version veröffentlicht, lädt der Agent sie beim nächsten Melden herunter, wartet, bis laufende Jobs fertig sind, hält an, installiert und startet neu. Ein Upgrade rührt nichts in ProgramData an – der Rechner bleibt registriert und behält seine Laufwerke und seinen Job-Verlauf.
Eine echte Deinstallation (Programme hinzufügen oder entfernen oder msiexec /x) entfernt neben dem Programm auch die Registrierung, die lokale Datenbank und den Laufwerks-Cache, sodass eine spätere Neuinstallation sauber beginnt und sich neu registriert. Die Protokolle bleiben erhalten. Ein Rechner, dessen Registrierung auf diese Weise bewusst verworfen wurde, verschwindet aus der Online-Liste der Konsole; seine Agentenzeile kann dort deaktiviert werden.
macOS #
macOS 26 oder neuer (das Cloud-Laufwerk basiert auf FSKit, das diese Version voraussetzt); Builds für Apple Silicon und Intel, beide notarisiert. Der Agent läuft als LaunchDaemon (com.caryvane.agent).
- Paket installieren. Doppelklick auf
CaryvaneAgent-arm64.pkg(oder-x64) oder unbeaufsichtigt:sudo installer -pkg CaryvaneAgent-arm64.pkg -target / - Token übergeben. Legen Sie das Token bei einer unbeaufsichtigten Installation vor dem Ausführen des Pakets ab (der Daemon liest es beim ersten Start) oder danach und starten Sie neu:
sudo mkdir -p "/Library/Application Support/Caryvane" echo '{"DeploymentToken":"<token>"}' | sudo tee "/Library/Application Support/Caryvane/setup.json" >/dev/null sudo launchctl kickstart -k system/com.caryvane.agent - Festplattenvollzugriff erteilen. Pflicht – unter macOS genügt es nicht, als root zu laufen. Systemeinstellungen → Datenschutz & Sicherheit → Festplattenvollzugriff,
/Applications/Caryvane.apphinzufügen. Verteilen Sie per MDM ein PPPC-Profil, das der Bundle-ID der AppSystemPolicyAllFilesgewährt; ohne dieses sieht der Agent nur seine eigenen Dateien, und jedes Backup meldet die Quelle als leer. - Prüfen.
sudo launchctl print system/com.caryvane.agent | headzeigt, dass er läuft; die Konsole zeigt ihn als Online.
| Was | Wo |
|---|---|
| Anwendung (Daemon, Menüleiste, FSKit-Laufwerksmodul) | /Applications/Caryvane.app |
| Token, Datenbank, Cache | /Library/Application Support/Caryvane/ |
| Daemon | system/com.caryvane.agent |
Der Agent überspringt bewusst die macOS-Systemvolumes, Caches unter ~/Library und die AppleDouble-Begleitdateien ._*, die der Finder auf Nicht-Apple-Dateisystemen anlegt. So enthält ein Mac-Backup die Daten des Benutzers und keine Kopie von macOS.
Linux #
Debian/Ubuntu (.deb) und RHEL/Fedora/Rocky (.rpm), x86-64 und aarch64, systemd erforderlich. Der Dienst heißt caryvane-agent.
# Debian / Ubuntu
sudo apt install ./caryvane-agent_<ver>_amd64.deb
# RHEL / Fedora / Rocky
sudo dnf install ./caryvane-agent-<ver>-1.x86_64.rpm
# Enrol (the file is a conffile: upgrades never overwrite it)
echo '{"DeploymentToken":"<token>"}' | sudo tee /etc/caryvane/agent.json >/dev/null
sudo systemctl restart caryvane-agent
sudo journalctl -u caryvane-agent -n 30
Der Zustand liegt in /var/lib/caryvane. Cloud-Laufwerke werden unter Linux über FUSE eingebunden (fuse3 ist eine Paketabhängigkeit). Der Agent aktualisiert sich über den Paketmanager, mit dem er installiert wurde; der Verlauf von apt/dnf zeigt daher jede Version, die er je ausgeführt hat.
Registrierung prüfen #
In der Konsole Agenten → den Rechner suchen. Drei Dinge prüfen: Er steht unter dem richtigen Kunden (das legt das Token fest, und ohne Neuregistrierung lässt er sich nachträglich nicht verschieben), er ist Online (er meldet sich laufend; ein Rechner, von dem 90 Sekunden lang nichts kam, erscheint offline), und die Version entspricht dem aktuellen Release. Legen Sie dann seinen ersten Backup-Job an.
Einen Rechner zu einem anderen Kunden oder Server umziehen #
Eine Registrierung verbindet genau einen Rechner ↔ einen Kunden ↔ einen Server. Um eines davon zu ändern: deinstallieren (dabei wird die Registrierung vergessen) und mit einem Token des neuen Kunden neu installieren. Auf einem Rechner, der bei einem Server registriert war, den er nicht mehr erreicht – etwa einer Pilotumgebung –, bemerkt der aktuelle Agent die Ablehnung durch den Server, verwirft die tote Registrierung selbst und fragt über das Infobereich-Symbol nach einem neuen Token; dazu genügt es, die aktuelle Version darüber zu installieren.
Das Token ist an den Hardware-Fingerabdruck des Rechners gebunden. Ein kopiertes Token wird abgelehnt, und der kopierende Rechner ist am Ende bei nichts registriert.