CaryvaneAyuda
/
ES

Solución de problemas

Primero el síntoma y después las comprobaciones, en el orden que encuentra la causa antes. Además, cada agente envía su propio registro a la consola, así que casi todo puede diagnosticarse sin tocar el equipo.

Dónde están los registros #

QuéDónde
Una ejecución de tarea: qué hizo, archivo por archivoConsola → Tareas → ⋮ → Historial de ejecuciones → la ejecución. Los archivos con error aparecen con el motivo de cada uno.
El registro del propio agente, desde la consolaSe envía de forma continua (INFO y superior). Puede leerse con la herramienta get_agent_logs, o pregúntenos.
Windows, en el equipoC:\ProgramData\Aurawolf\logs\agent.log (rotación diaria); la aplicación de la bandeja escribe tray.log al lado
macOSsudo launchctl print system/com.caryvane.agent; archivos de registro en /Library/Application Support/Caryvane/logs/
Linuxjournalctl -u caryvane-agent

El agente aparece Sin conexión #

Un agente está En línea mientras haya contactado con la consola en los últimos 90 segundos. Sin conexión significa que la consola no ha sabido nada de él; puede que el equipo simplemente esté apagado. Es normal que los portátiles y los equipos antiguos aparezcan y desaparezcan, y eso no es un fallo. Si debería estar encendido:

  1. ¿Se está ejecutando el servicio? Windows: Get-Service CaryvaneAgent. macOS: launchctl print system/com.caryvane.agent. Linux: systemctl status caryvane-agent.
  2. ¿Llega a la consola? Desde el equipo: curl -sI https://console.caryvane.com/healthz (o ábrala en un navegador). Solo saliente por el 443 (direcciones y reglas de firewall); un proxy que inspeccione TLS debe confiar en la cadena de certificados o excluir el host.
  3. ¿Se está actualizando? El agente se detiene un minuto mientras se instala una versión nueva y vuelve solo. La columna Versión muestra si lo ha hecho.
  4. Lea el registro. Las últimas líneas de agent.log dicen qué estaba haciendo. Si se repite «Server rejected the machine token», el registro del agente ya no es válido.

Agente instalado pero ausente de la consola, o la bandeja dice «Registered» y la consola no está de acuerdo #

Tres causas, de la más a la menos probable:

Avisos del antivirus durante la instalación

El instalador y todos los binarios que contiene están firmados. Un aviso con una descarga antigua suele indicar una versión preliminar sin firmar; descargue el instalador actual desde la consola.

La tarea terminó con Advertencia #

Advertencia significa que la ejecución terminó y que se omitieron algunos archivos. El registro de la ejecución los nombra todos, con el motivo. Los más habituales:

Línea del registroCausaQué hacer
SKIPPED (encrypted with EFS — the agent cannot read it)Los archivos cifrados con EFS de Windows solo los puede leer el usuario que los cifró; el agente se ejecuta como SYSTEM.Descífrelos (cipher /d) o excluya la carpeta. Es una advertencia a propósito, no un error.
Skipped (in use by another program)Un bloqueo exclusivo, y VSS estaba desactivado o no pudo crear una instantánea del volumen.Active Incluir archivos abiertos y bloqueados en la tarea (usa VSS); para bases de datos y máquinas virtuales use una tarea coherente con la aplicación (Hacer una copia de seguridad de Hyper-V, SQL Server o Active Directory).
… contains a virus or potentially unwanted softwareWindows Defender bloqueó la lectura. Suele ser un keygen o un crack antiguo en la carpeta de descargas de un usuario.Exclúyalo o deje que el cliente lo elimine. Caryvane no se salta el antivirus.
Skipped (stored in the cloud, not on this machine)Un marcador de posición de OneDrive/Dropbox: el contenido del archivo no está en el disco.Haga la copia de seguridad de la cuenta en la nube con una tarea de conector o de destino de almacenamiento.

La tarea terminó con Error #

Tareas de Hyper-V #

La unidad en la nube no se monta #

  1. Agente en línea y registrado como el agente al que se añadió la unidad. Las unidades se envían cuando el agente contacta con la consola; un agente sin conexión no tiene nada que montar.
  2. Windows: el controlador Dokany debe estar instalado (Agregar o quitar programas → Dokan Library). El instalador lo añade; en algunos sistemas, la primera instalación necesita un reinicio para que el controlador se cargue. La letra de unidad elegida debe estar libre.
  3. macOS: debe haber un usuario con la sesión iniciada (el módulo FSKit se ejecuta en la sesión del usuario) y Caryvane.app necesita Acceso total al disco. Compruebe que en Ajustes del Sistema → General → Ítems de inicio y extensiones → Extensiones del sistema de archivos Caryvane aparece activado.
  4. Linux: debe existir fusermount3 y debe poder crearse el punto de montaje; consulte el journal.
  5. La prueba del destino de almacenamiento debe ser correcta: una unidad sobre un destino con credenciales que ya no valen se monta vacía o no se monta.

El conector ha dejado de funcionar #

Una tarea se ejecutó a la hora equivocada #

Las programaciones cron están en UTC. 0 2 * * * son las 02:00 UTC: en la España peninsular, las 03:00 en horario de invierno y las 04:00 en horario de verano. Ajuste la hora y tenga en cuenta que la hora local se desplaza una hora con el cambio de horario.

¿Sigue sin resolverlo? #

Escriba a hello@caryvane.com indicando el cliente, el nombre del equipo y la hora de la ejecución; podemos leer desde nuestro lado el registro que envía el agente, sin necesidad de capturas de pantalla. Para un equipo que no llega a la consola en absoluto, adjunte las últimas 200 líneas de agent.log.

Para profundizar #