El agente en Linux
El agente de Linux es un servicio de systemd que se instala desde un paquete nativo. Se registra mediante un archivo JSON que el paquete nunca sobrescribe, se actualiza con el gestor de paquetes con el que se instaló y monta las unidades en la nube mediante FUSE.
Requisitos #
- Una distribución con systemd: Debian 11+, Ubuntu 20.04+, RHEL/Rocky/Alma 8+, Fedora 39+. x86-64 (
amd64/x86_64) o ARM de 64 bits (arm64/aarch64). - HTTPS saliente hacia
console.caryvane.com. fuse3para las unidades en la nube (una dependencia del paquete, que se instala con el agente).
Instalar y registrar #
# Debian / Ubuntu
sudo apt install ./caryvane-agent_<ver>_amd64.deb
# RHEL / Rocky / Fedora
sudo dnf install ./caryvane-agent-<ver>-1.x86_64.rpm
# Enrol: the file is a conffile, so upgrades leave it alone
echo '{"DeploymentToken":"<token>"}' | sudo tee /etc/caryvane/agent.json >/dev/null
sudo systemctl restart caryvane-agent
sudo systemctl status caryvane-agent
sudo journalctl -u caryvane-agent -n 50
Instale con apt/dnf en lugar de dpkg -i/rpm -U para que se resuelvan las dependencias. agent.json es un archivo de configuración del paquete (conffile) que las actualizaciones no tocan, y también puede llevar "ServerUrl" para un servidor autoalojado.
Dónde queda cada cosa #
| Elemento | Ubicación |
|---|---|
| Binario | /opt/caryvane/agent/ |
| Unidad de systemd | caryvane-agent.service, se ejecuta como root (debe leer los archivos de todos los usuarios) |
| Configuración de registro | /etc/caryvane/agent.json |
| Token, base de datos, manifiestos, caché | /var/lib/caryvane/ |
| Archivos de registro (logs) | el journal (journalctl -u caryvane-agent); también se envían a la consola |
| Unidades en la nube | /mnt/caryvane/<drive name> |
Actualización automática #
El agente detecta si se instaló con dpkg o con rpm y se actualiza mediante apt-get o dnf, pasando el comando a systemd como unidad transitoria para que detener el servicio antiguo no mate al instalador que lo está sustituyendo. Por eso el historial de su gestor de paquetes muestra todas las versiones que ha ejecutado el equipo. Para quitarlo: apt remove caryvane-agent / dnf remove caryvane-agent; purge elimina también el directorio de datos.
Particularidades de Linux #
- No hay VSS; los archivos abiertos se leen tal como están. Para una base de datos, haga un volcado en un script previo.
- La copia de seguridad continua usa inotify; en árboles de carpetas profundos puede que haya que aumentar
fs.inotify.max_user_watches. - Los sistemas de archivos con instantáneas (LVM, Btrfs) se detectan y se comunican a la consola; el agente los usa siempre que puede para obtener lecturas coherentes.
- Las rutas distinguen mayúsculas de minúsculas y se conservan tal cual en el destino.