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.
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.
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:
| Requisito | Propósito | Entorno |
|---|---|---|
| Gestión remota de Windows | Permite que la herramienta se conecte y gestione máquinas Windows de forma remota. | Windows / AD / Grupo de trabajo |
| Compartición de archivos | Permite que la herramienta actualice de forma segura la configuración de conexión de cada máquina. | Windows / AD / Grupo de trabajo |
| Consulta de dominio | Permite que la herramienta obtenga la lista de máquinas desde Active Directory. | Active Directory |
| Acceso remoto a Linux/macOS | Permite que la herramienta actualice la configuración y reinicie el agente en máquinas Linux y macOS. | Linux / macOS |
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.
- 1Construye 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.
- 2Selecciona 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.
- 3Elige 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.
- 4Inicia 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.
- 5Revisa, 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.
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.
Uso paso a paso#
- 1Define 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.
- 2Descubre 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.
- 3Selecciona 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.
- 4Enví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.
- 5Verifica 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.
Solución de problemas#
| Síntoma / Error | Causa probable | Solució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 accesibles | La 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 responden | El 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ón | En 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 conecta | Las 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. |