Saltar al contenido
MoftgateMoftgate Docs
Guía del producto

Descubrimiento y rescate de flota

La Fleet Discovery & Rescue Tool de Moftgate descubre equipos, instala o elimina agentes en masa y reconecta la flota tras un cambio de IP o FQDN.

Qué es la herramienta#

La Moftgate Fleet Discovery & Rescue Tool resuelve un problema operativo específico: cuando la dirección del servidor de gestión de Moftgate cambia (por ejemplo, al pasar a una nueva IP o a un nuevo nombre de dominio), todos los agentes instalados previamente en clientes Windows, Linux y macOS siguen intentando alcanzar la dirección antigua y quedan fuera de línea. En lugar de visitar cada máquina a mano o reinstalar agentes, un administrador ejecuta esta herramienta desde una única máquina de gestión para descubrir toda la flota, enviar la nueva dirección del servidor a cada agente, reiniciar remotamente el agente de Moftgate y verificar que todo se reconecte.

La herramienta está pensada para organizaciones con una flota considerable (por ejemplo, 50+ clientes Windows/Linux/macOS) donde una corrección manual, máquina por máquina, sería poco práctica. La usa un administrador, ejecutándola una vez (o cuando sea necesario) desde una máquina de la red - no es algo con lo que interactúen los usuarios finales ni los clientes.

Una aplicación de escritorio independiente
Esto no es una página dentro de la plataforma Moftgate - es una aplicación de escritorio independiente para Windows y macOS. Descárgala a continuación e instálala como cualquier otra aplicación de escritorio.
Instalador de Fleet Tool

Esta plataforma está en verificación final y se publicará próximamente.

Motor de descubrimiento#

La herramienta admite dos modos de descubrimiento independientes, elegidos desde una pestaña de modo en la parte superior de la aplicación:

  • Modo Workgroup / Subnet - escanea tu red local para encontrar máquinas dentro de un rango que especifiques (p. ej. 192.168.1.0/24). Úsalo cuando las máquinas no forman parte de un dominio, o cuando simplemente quieras escanear una parte específica de tu red.
  • Modo Active Directory / Domain - obtiene la lista completa de máquinas directamente desde tu dominio de Active Directory, con un filtro opcional para limitar la lista a una unidad organizativa específica. Úsalo en entornos de dominio donde quieras una lista de máquinas completa y autoritativa en lugar de un escaneo de red.
La interfaz de Fleet Discovery permite escanear subredes locales o consultar Active Directory, mostrando endpoints detectados, sistemas operativos y estados de agentes.
Escáner de descubrimiento de flota y tabla de endpoints
Cerrar imagen
Puedes combinar ambos
Nada impide ejecutar un escaneo de subred y una consulta de dominio en pasadas separadas - útil cuando parte de tu flota está unida al dominio y parte está en un segmento de red de grupo de trabajo.

Requisitos de red y puertos#

Para que la herramienta pueda descubrir y reconfigurar las máquinas objetivo, asegúrate de que la gestión remota estándar de Windows y el acceso a compartición de archivos estén disponibles en tu red, y de que el acceso remoto esté habilitado en las máquinas Linux o macOS que quieras migrar:

RequisitoPropósitoEntorno
Gestión remota de WindowsPermite que la herramienta se conecte y gestione máquinas Windows de forma remota.Windows / AD / Grupo de trabajo
Compartición de archivosPermite que la herramienta actualice de forma segura la configuración de conexión de cada máquina.Windows / AD / Grupo de trabajo
Consulta de dominioPermite que la herramienta obtenga la lista de máquinas desde Active Directory.Active Directory
Acceso remoto a Linux/macOSPermite que la herramienta actualice la configuración y reinicie el agente en máquinas Linux y macOS.Linux / macOS
Las credenciales de administrador se gestionan localmente
Las credenciales de administrador local (para un escaneo de subred) o de Domain Admin (para el modo AD) se introducen directamente en la herramienta y se usan solo para autenticarse con cada máquina objetivo - no se envían a Moftgate ni a ningún servicio externo. Trata la máquina que ejecuta esta herramienta con el mismo cuidado que cualquier estación de trabajo que maneje credenciales administrativas, y prefiere ejecutarla en una máquina de gestión de confianza y con acceso controlado.

Despliegue masivo de agentes#

Además de rescatar agentes existentes, la Fleet Tool funciona como un instalador masivo de agentes, al estilo de las utilidades de instalación remota de los productos ITSM empresariales. Desde la misma lista de máquinas, un administrador puede enviar una instalación nueva del agente (o una eliminación limpia) a decenas de máquinas Windows, Linux y macOS en una sola ejecución, sin tocar ninguna de ellas. Es la forma recomendada de desplegar Moftgate por primera vez en entornos donde visitar cada endpoint llevaría días.

  • Un modal, dos operaciones: elige Install para enviar un agente nuevo, o Uninstall para eliminar limpiamente el servicio del agente, el binario y la configuración en todas las máquinas seleccionadas.
  • Objetivos flexibles: los objetivos provienen de la misma tabla de descubrimiento (escaneo de subred o consulta a Active Directory), y el botón Import CSV carga una lista preparada con las columnas hostname,ip,os,user cuando el inventario está fuera de la red.
  • Las máquinas Windows se alcanzan a través de WinRM, con SSH como fallback automático cuando el equipo ejecuta OpenSSH Server. La herramienta prefiere el paquete MSI firmado y lo instala en silencio con las propiedades SERVERURL, COMPANYID y NATSURL; cuando solo está disponible el ejecutable, registra e inicia el servicio de Windows MoftgateAgent por sí misma.
  • Los objetivos Linux reciben el binario del agente por SSH/SFTP en /usr/local/bin, obtienen una unidad systemd escrita, habilitada e iniciada, y guardan sus datos de trabajo en /var/lib/moftgate.
  • Los objetivos macOS se instalan desde el paquete .pkg cuando está publicado en el servidor, y en caso contrario recurren a una instalación de binario más un LaunchDaemon.
  • La entrega del paquete se elige por ejecución: Server Download hace que cada objetivo descargue el paquete directamente desde tu servidor Moftgate, mientras que Local Push sube el paquete desde la máquina que ejecuta la herramienta, útil cuando los objetivos aún no pueden alcanzar el servidor.
  • Las ejecuciones son paralelas con un límite de concurrencia acotado. Cada objetivo reporta su propio estado y líneas de log en vivo, y el informe final separa éxitos de fallos para que Retry Failed solo vuelva a intentar las máquinas que no completaron.
  1. 1
    Construye la lista de objetivos

    Ejecuta un escaneo de subred o una consulta a Active Directory, o haz clic en Import CSV para cargar una lista preparada. Las máquinas que aún no tienen agente aparecen como Not Installed, y el filtro de la tabla puede mostrar solo ellas.

  2. 2
    Selecciona las máquinas y abre el despliegue

    Marca las máquinas a las que quieres desplegar, luego haz clic en Install / Uninstall Agents (N) en la barra de herramientas de la tabla.

  3. 3
    Elige operación, entrega y credenciales

    Elige Install o Uninstall, selecciona Server Download o Local Push, y en Windows escoge el paquete MSI o EXE. Luego introduce las credenciales administrativas: administrador local o de dominio para Windows, contraseña o clave SSH para Linux y macOS.

  4. 4
    Inicia la ejecución y observa el progreso en vivo

    Haz clic en Start Deployment. La consola de logs transmite cada objetivo línea por línea mientras la columna Operation Status muestra Pending, Running, Success o Failed para cada máquina.

  5. 5
    Revisa, reintenta y exporta

    El informe de despliegue resume éxitos y fallos. Usa Retry Failed para las máquinas que no completaron, y Export CSV Report para un registro listo para auditoría.

El aprovisionamiento es real, nunca simulado
Cada despliegue escribe la dirección API completa del agente (la URL de tu servidor más /api/agent), el Company ID y la dirección NATS en el objetivo, luego inicia el servicio y reporta el resultado real. Si una credencial, una descarga de paquete o un puerto falla, esa máquina se marca como Failed con el error real para que puedas corregirlo y reintentar solo ese objetivo.

Inyección de configuración y reinicio del servicio#

  • La actualización preserva la identidad: la herramienta actualiza de forma segura la configuración de conexión de cada máquina para que apunte al nuevo servidor, sin tocar la identidad, el emparejamiento ni las credenciales de la máquina. Solo redirige a dónde reporta el agente - nada más cambia en el agente.
  • En Windows, esta actualización y el reinicio del servicio que sigue se gestionan a través de las funciones de gestión remota integradas en la máquina.
  • En Linux y macOS, la misma actualización y reinicio del servicio se gestionan a través de las funciones de acceso remoto de la máquina.
Acceso remoto en objetivos Windows
La gestión remota debe estar habilitada en los objetivos Windows para que la herramienta pueda actualizarlos. En máquinas Windows en grupo de trabajo (no unidas a dominio), el Control de Cuentas de Usuario puede bloquear el acceso administrativo remoto a menos que esté configurado para permitirlo - consulta Solución de problemas más abajo si obtienes errores Access is Denied.

Uso paso a paso#

  1. 1
    Define y prueba la nueva dirección del servidor

    En la cabecera, introduce la nueva IP/URL del servidor (p. ej. http://192.168.1.200:8000) y, opcionalmente, el Company ID. Haz clic en Test Server - un resultado verde Online (X ms) confirma que el nuevo servidor es accesible antes de tocar ningún cliente.

  2. 2
    Descubre la flota

    Elige Workgroup / Subnet Mode (introduce un CIDR como 192.168.1.0/24, elige un timeout de escaneo y, opcionalmente, credenciales de administrador local, luego haz clic en Start Subnet Scan) para escanear tu red local, o Active Directory / Domain Mode (introduce los datos de tu dominio, un filtro Base OU opcional y credenciales de administrador de dominio, luego haz clic en Query Domain Computers) para obtener la lista de máquinas directamente desde tu dominio de Active Directory.

  3. 3
    Selecciona los objetivos y revisa el estado

    La tabla de resultados lista la IP, el sistema operativo, la IP del servidor actual y el estado del agente (Offline / Server Down, Running, Stopped) de cada máquina. Busca por hostname, IP o usuario, luego marca las máquinas que quieres rescatar, o selecciona todas.

  4. 4
    Envía la configuración y reinicia el servicio

    Haz clic en Reconfigure & Restart Selected (X). En el modal de confirmación, deja marcadas Restart Moftgate Agent Service remotely y Verify Agent Handshake, luego haz clic en Start Migration. La Live Log Console muestra en vivo, línea por línea, el progreso de cada máquina mientras se actualizan sus ajustes de conexión y se reinicia su agente.

  5. 5
    Verifica y exporta el informe

    Al terminar, el Migration Execution Report resume los éxitos y fallos. Usa Export CSV Report para un informe de migración detallado, y Retry Failed para reintentar solo las máquinas que fallaron o estaban fuera de línea durante el escaneo.

La consola de migración en vivo transmite actualizaciones de conexión en tiempo real, reinicios de servicio y verificación de enlaces en todos los endpoints seleccionados.
Consola de registros de migración en vivo y estado de reconfiguración
Cerrar imagen

Solución de problemas#

Síntoma / ErrorCausa probableSolución
"Unreachable" (error de Test Server)La nueva dirección del servidor Moftgate es incorrecta, o un firewall está bloqueando la conexión.Verifica la dirección del servidor y asegúrate de que tu firewall permita que la máquina de gestión la alcance.
"Access is Denied"La cuenta usada no tiene privilegios administrativos en la máquina objetivo.Usa una cuenta con privilegios de administrador local (o de administrador de dominio, para el modo Active Directory) en las máquinas objetivo.
Algunas máquinas no son accesiblesLa gestión remota puede estar deshabilitada en esa máquina, o bloqueada por una política de red/seguridad.Habilita el acceso remoto en la máquina objetivo, consulta con tu equipo de red, o contacta con soporte de TI.
Las máquinas Linux/macOS no respondenEl acceso remoto no está disponible en esa máquina.Asegúrate de que el acceso remoto esté habilitado en la máquina objetivo, o contacta con soporte de TI.
Un escaneo de subred encuentra 0 dispositivos, incluso la propia máquina de gestiónEn macOS, Remote Login (SSH) y File Sharing (SMB) están deshabilitados por defecto, por lo que el escaneo no tiene ningún puerto abierto para detectar la máquina.En el Mac que ejecuta el escaneo, ve a System Settings > General > Sharing y habilita Remote Login (SSH) - y File Sharing si también quieres detección basada en SMB - luego vuelve a escanear.
El despliegue falla con errores de autenticación o "Access is Denied"Las credenciales no tienen privilegios administrativos, o la gestión remota no está habilitada en el objetivo.Usa una cuenta con privilegios de administrador local o de dominio. En objetivos Windows, habilita WinRM (winrm quickconfig) o instala OpenSSH Server; en Linux y macOS, asegúrate de que SSH esté en ejecución.
La instalación en Windows parece correcta pero el agente nunca se conectaLas propiedades del MSI pueden ser incorrectas, o el objetivo no puede alcanzar el servidor Moftgate tras finalizar la instalación.Verifica que la URL del servidor incluya la base API completa (por ejemplo https://server/api/agent), comprueba que el objetivo pueda alcanzar el servidor y la dirección NATS, luego reintenta esa máquina.

Preguntas frecuentes#

¿La herramienta cambia la identidad de un agente o su emparejamiento con el servidor?
No. La actualización solo cambia a qué servidor se conecta el agente (y, si se indica, el Company ID). La identidad de la máquina y su emparejamiento existente con el servidor central no se tocan, por lo que sobreviven a la migración.
¿Puedo migrar máquinas Windows, Linux y macOS en la misma ejecución?
Sí. La tabla de descubrimiento lista las máquinas sin importar el sistema operativo, y puedes seleccionar un lote mixto de objetivos - la herramienta usa automáticamente el método adecuado para el sistema operativo de cada máquina dentro del mismo trabajo de migración.
¿Qué ocurre con las máquinas que están fuera de línea durante el escaneo?
Aparecen como Offline / Server Down (o simplemente no aparecen en un escaneo de subred si no son accesibles) y se omiten durante esa ejecución de migración. Una vez generado el informe de migración, usa el botón Retry Failed para reintentar solo las máquinas que fallaron o no fueron accesibles, sin repetir toda la flota.
¿Se requiere Active Directory para usar esta herramienta?
No. El modo Active Directory / Domain es uno de los dos métodos de descubrimiento - es opcional y solo útil en entornos de dominio. El modo Workgroup / Subnet funciona completamente sin él, escaneando tu red local directamente.
¿Esta herramienta forma parte de la plataforma principal de Moftgate?
No. Es una aplicación de escritorio independiente (la Moftgate Fleet Discovery & Rescue Tool) que un administrador descarga del sitio web de Moftgate, instala como cualquier otra aplicación de escritorio y ejecuta desde una máquina de gestión - no es una página dentro de la plataforma web de Moftgate.
¿Puede la herramienta instalar agentes en máquinas que nunca tuvieron Moftgate?
Sí. El despliegue masivo está pensado exactamente para la primera implantación: cualquier máquina Windows, Linux o macOS accesible y con acceso remoto habilitado puede recibir una instalación de agente nueva, totalmente aprovisionada con tu dirección de servidor y Company ID.
¿También puedo eliminar agentes de forma masiva?
Sí. El mismo modal de despliegue incluye una operación Uninstall que detiene y elimina el servicio del agente, borra el binario y limpia la configuración en todas las máquinas seleccionadas.