Implementar el agente
El agente es un servicio que se ejecuta en el equipo del que se hace la copia de seguridad. Se registra en un cliente con un token de registro, se comunica con la consola y hace el trabajo. Hay un instalador por plataforma; lo único que cambia de un cliente a otro es el token.
Necesita un token de registro del cliente al que pertenece este equipo. Por defecto, un token sirve para un solo equipo (para un despliegue, indique el número en Equipos o marque Ilimitado en el cuadro de diálogo Registrar agente) y caduca: a las 24 horas, salvo que elija otra cosa, entre 1 hora y 90 días. Así que créelo cuando vaya a instalar. El equipo necesita HTTPS saliente (443) hacia console.caryvane.com; nada entrante. Las direcciones, y dónde más puede hacer falta permitirlas.
Windows #
Windows 10/11 y Server 2016 o posterior, x64 o ARM64. Para cada arquitectura hay dos instaladores: un Setup EXE para instalar con doble clic o a mano, y el MSI que lleva dentro, para Intune, SCCM, RMM y scripts. Ambos están firmados digitalmente, igual que todos los binarios que instalan.
Instalación silenciosa con token (RMM, Intune, scripts) #
La consola le escribe este comando al crear un token (Agentes → Registrar agente), con la URL del MSI actual y el token ya incluido. Es el MSI, ejecutado en silencio:
msiexec /i "https://console.caryvane.com/downloads/agent/CaryvaneAgent-x64.msi" /quiet AURAWOLF_SERVER=https://console.caryvane.com AURAWOLF_TOKEN=<token>
O el Setup EXE, que acepta los mismos dos valores y ejecuta el MSI por usted:
CaryvaneAgentSetup-x64.exe /SP- /VERYSILENT /NORESTART /server="https://console.caryvane.com" /token="<token>"
En dispositivos ARM (Surface Pro X, portátiles Snapdragon) use la compilación arm64; la x64 se niega a instalarse en ellos.
El instalador registra un servicio de Windows y escribe en Program Files; lo ideal es un RMM que se ejecute como SYSTEM. Con un token ya usado o caducado, el agente queda instalado pero sin registrar: espera a que se registre desde el icono del área de notificación y no aparece en ninguna consola hasta entonces.
Instalación interactiva #
- Descargue el Setup EXE desde la consola (Agentes → Registrar agente muestra el enlace) y ejecútelo. Instala el servicio, la aplicación de la bandeja del sistema y, si alguna vez se monta una unidad en la nube, el controlador Dokany que necesita.
- Regístrelo desde el icono del área de notificación. Clic derecho en el icono de Caryvane del área de notificación → Enroll Agent… → pegue el token de registro → Connect. (Por ahora la aplicación de la bandeja muestra estas opciones en inglés.) En pocos segundos el estado pasa a registrado.
- Compruébelo en la consola. Agentes muestra el equipo bajo el cliente al que pertenecía el token, En línea, con su versión. Si no aparece al cabo de un minuto, consulte Agente instalado pero no aparece en la consola.
Dónde queda cada cosa #
| Qué | Dónde |
|---|---|
| Binarios del servicio y de la aplicación de la bandeja | C:\Program Files\Caryvane\Caryvane Agent\ |
| Servicio de Windows | CaryvaneAgent (se ejecuta como SYSTEM) |
| Token de registro, base de datos local, caché de unidades | C:\ProgramData\Aurawolf\ |
| Archivos de registro (logs) | C:\ProgramData\Aurawolf\logs\agent.log |
| URL del servidor y token de una instalación con MSI | HKLM\SOFTWARE\Centurion Computers\Aurawolf Agent |
Los nombres con Aurawolf son el nombre original del producto y son correctos; se mantuvieron en disco a propósito para que una actualización nunca deje huérfano el registro de un equipo.
Actualizaciones y desinstalación #
Los agentes se actualizan solos: cuando se publica una versión nueva, el agente la descarga en su siguiente comunicación con la consola, espera a que terminen las tareas en curso, se detiene, la instala y se reinicia. Una actualización no toca nada de ProgramData: el equipo sigue registrado y conserva sus unidades y su historial de tareas.
Una desinstalación real (Agregar o quitar programas, o msiexec /x) elimina, además del programa, el registro, la base de datos local y la caché de unidades, de modo que una reinstalación posterior empieza de cero y se registra de nuevo. Los archivos de registro se conservan. Un equipo cuyo registro se descarta así a propósito desaparece de la lista En línea de la consola, y su fila de agente se puede desactivar allí.
macOS #
macOS 26 o posterior (la unidad en la nube se basa en FSKit, que lo requiere); compilaciones para Apple silicon e Intel, ambas notarizadas. El agente se ejecuta como LaunchDaemon (com.caryvane.agent).
- Instale el paquete. Doble clic en
CaryvaneAgent-arm64.pkg(o-x64), o sin intervención:sudo installer -pkg CaryvaneAgent-arm64.pkg -target / - Proporcione el token. En una instalación desatendida, coloque el token antes de ejecutar el paquete (el daemon lo lee en el primer arranque), o después y reinícielo:
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 - Conceda acceso total al disco. Es obligatorio: en macOS no basta con ejecutarse como root. Ajustes del Sistema → Privacidad y seguridad → Acceso total al disco, añada
/Applications/Caryvane.app. Con MDM, distribuya un perfil PPPC que concedaSystemPolicyAllFilesal identificador de paquete de la aplicación; sin él, el agente solo ve sus propios archivos y todas las copias de seguridad informan de que el origen está vacío. - Compruébelo.
sudo launchctl print system/com.caryvane.agent | headmuestra que se está ejecutando; la consola lo muestra En línea.
| Qué | Dónde |
|---|---|
| Aplicación (daemon, barra de menús, módulo de unidad FSKit) | /Applications/Caryvane.app |
| Token, base de datos, caché | /Library/Application Support/Caryvane/ |
| Daemon | system/com.caryvane.agent |
El agente omite a propósito los volúmenes de sistema de macOS, las cachés de ~/Library y los archivos auxiliares AppleDouble ._* que el Finder escribe en sistemas de archivos no nativos, de modo que la copia de seguridad de un Mac contiene los datos del usuario y no una copia de macOS.
Linux #
Debian/Ubuntu (.deb) y RHEL/Fedora/Rocky (.rpm), x86-64 y aarch64; se requiere systemd. El servicio es 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
El estado se guarda en /var/lib/caryvane. En Linux, las unidades en la nube se montan mediante FUSE (fuse3 es una dependencia del paquete). El agente se actualiza con el gestor de paquetes con el que se instaló, así que el historial de apt/dnf muestra todas las versiones que ha ejecutado.
Comprobar el registro #
En la consola, Agentes → busque el equipo. Compruebe tres cosas: que está bajo el cliente correcto (lo decide el token, y después no se puede mover sin volver a registrarlo), que está En línea (se comunica continuamente; un equipo del que no se sabe nada en 90 segundos aparece sin conexión) y que la versión coincide con la última versión publicada. Después cree su primera tarea de copia de seguridad.
Pasar un equipo a otro cliente o a otro servidor #
Un registro vincula un equipo ↔ un cliente ↔ un servidor. Para cambiar cualquiera de ellos: desinstale (lo que olvida el registro) y vuelva a instalar con un token del cliente nuevo. En un equipo registrado en un servidor al que ya no puede llegar (un entorno piloto, por ejemplo), el agente actual detecta el rechazo del servidor, descarta él mismo el registro inservible y pide un token nuevo desde el icono del área de notificación; para que eso ocurra basta con instalar la versión actual encima.
El token está ligado a la huella de hardware del equipo. Un token copiado se rechaza, y el equipo en el que se copió acaba sin estar registrado en nada.