Configurar el agente integrado para gestionar instancias

Last published : Oct 02, 2026
Un agente integrado está disponible en las instancias de NetScaler MPX, VPX y Gateway que ejecutan la versión 12.1.48.13 y posteriores, y en las instancias de NetScaler SDX que ejecutan la versión 13.0 61.x y posteriores, y 12.1 58.x y posteriores. Puede iniciar este agente en la instancia de NetScaler en lugar de instalar un agente dedicado en su centro de datos o nube pública. El agente integrado permite la comunicación entre la instancia y NetScaler Console.
Nota:
El agente integrado solo está disponible en los siguientes tipos de instancias de NetScaler:
  • NetScaler MPX
  • NetScaler VPX
  • NetScaler SDX
  • NetScaler Gateway
El agente integrado es ideal para implementaciones más pequeñas de NetScaler autónomas o en pares de alta disponibilidad. Si tiene varias instancias de NetScaler, utilice un agente dedicado para las implementaciones. Este agente garantiza mejores capacidades de agregación de datos que el agente integrado. Para obtener más información, consulte Instalar un agente localmente.
El agente integrado de NetScaler Console admite la gestión de instancias, la supervisión y las licencias agrupadas o flexibles. Sin embargo, las siguientes funciones no son compatibles con el agente integrado:
  • Panel de aplicaciones
  • Web Insight
  • SSL Insight
  • HDX™ Insight
  • Gateway Insight
  • Información de seguridad
  • Análisis avanzados
  • Licencias agrupadas o flexibles (licencias basadas en archivos)
Puede pasar de un agente integrado a un agente externo. Para obtener más información, consulte Transición de un agente integrado a un agente externo.

Requisitos previos

Antes de configurar un agente integrado en la instancia de NetScaler, asegúrese de lo siguiente:
  • La instancia de NetScaler (MPX, VPX o Gateway) se ejecuta en la versión 12.1.48.13 o posterior. La instancia de SDX se ejecuta en la versión 13.0.61.x o posterior.
  • Se agrega un servidor de nombres DNS en la instancia de NetScaler.
    Para obtener más información, consulte Agregar un servidor de nombres.
  • Tiene una cuenta de Citrix Cloud. Para obtener más información, consulte Registrarse en Citrix Cloud.
Nota:
Para obtener toda la información relacionada con los puertos y otros requisitos del sistema, consulte Requisitos del sistema.

Configurar el agente integrado

Realice las siguientes tareas para configurar el agente integrado de NetScaler:
  1. Seleccione la opción Agente integrado según las instrucciones de Introducción.
  2. Copie la URL del servicio y el código de activación.
    El agente utiliza la URL del servicio para localizar el servicio y el código de activación para registrarse en el servicio. Omita el paso 7 si es cliente de MPX o Gateway.
  3. Inicie el agente integrado mediante un cliente SSH. Los usuarios de Gateway deben omitir este paso.
    1. Inicie sesión en su instancia de NetScaler. Para obtener más información, consulte Acceder a un NetScaler.
    2. Vaya al directorio /var/mastools/scripts y escriba el siguiente comando:
      En la instancia de SDX
      Registro con perfil de NetScaler Registro sin perfil de NetScaler
      Requisito previo Antes de registrarse, cree un perfil de NetScaler. Para obtener más información, consulte Cómo crear un perfil de NetScaler.
      Ejecute este comando ./mastools_init.sh <device-profile-name> <service-url> <activation-code> -sdx -profile ./mastools_init.sh <user_name> <service-url> <activation-code> -sdx
      Credencial de usuario Introduzca nsroot en <device_profile_name>. Alternativamente, puede usar un nombre de usuario que tenga los mismos privilegios de acceso que nsroot. Introduzca nsroot en <user_name>. Alternativamente, puede usar un nombre de usuario que tenga los mismos privilegios de acceso que nsroot.
      Nota:
      NetScaler Console detecta todas las instancias VPX que se ejecutan en ese SDX y no es necesario registrar las instancias VPX individualmente.
      En instancias VPX que no se ejecutan en un dispositivo SDX e instancias MPX y Gateway:
      Si la versión de la imagen de NetScaler es inferior a 13.0 61.x o 12.1 57.x, debe comprobar la versión mastools escribiendo el comando cat /var/mastools/version.txt. Si la salida es 0.0-0.0, es la primera vez.
      Escriba uno de los siguientes comandos según la versión del software.
      Nota:
      Antes de registrarse con un perfil de NetScaler, debe crear el perfil. Para obtener más información, consulte Cómo crear un perfil de NetScaler.
      Versión de la imagen de NetScaler ¿Es mastools_version 0.0-0.0? Comando para el registro con perfil Comando para el registro sin perfil
      Inferior a 13.0 61.xx y 12.1 57.xx Sí ./mastools_init.sh <device_profile_name> <service_url> "MAS;<activation_code>" -profile ./mastools_init.sh <user_name> <pwd> <service_url> "MAS;<activation_code>"
      Inferior a 13.0 61.xx y 12.1 57.xx No ./mastools_init.sh <device_profile_name> <service_url> <activation_code> -profile ./mastools_init.sh <user_name> <pwd> <service_url> <activation_code>
      Superior a 13.0 61.x y 12.1 57.xx No aplicable ./mastools_init.sh <device_profile_name> <service_url> <activation_code> -profile ./mastools_init.sh <user_name> <pwd> <service_url> <activation_code>
    Nota:
    • En <device_profile_name> o <user_name>, introduzca nsroot. Alternativamente, puede usar un nombre de usuario que tenga los mismos privilegios de acceso que nsroot.
    • En un par HA, complete el registro en el nodo principal. Si ejecuta los comandos de registro en el nodo secundario, aparece el siguiente mensaje: Ejecute el comando de registro en el nodo principal.
  4. Vuelva a la página de NetScaler Console y haga clic en Registrar instancia.
  5. En Agregar instancias, vea la instancia donde inició el agente integrado. Asegúrese de que la instancia esté en estado Activo y haga clic en Siguiente.
  6. Haga clic en Listo.
Después de una configuración exitosa del agente integrado, puede acceder a las funciones de NetScaler Console, como:
  • Servidor virtual y análisis – Aplique licencias a su servidor virtual para administrar instancias de NetScaler. Para obtener más información, consulte Administrar suscripciones.
  • Panel de aplicaciones – Para ver todas las aplicaciones de forma integral. Para obtener más información, consulte Administración y panel de aplicaciones.
  • Análisis de infraestructura – Esta función le ayuda a visualizar los factores que causaron o podrían causar un problema en las instancias. Para obtener más información, consulte Análisis de infraestructura.

Configurar el servidor de licencias a través del agente integrado de NetScaler®

Nota:
Al agente integrado de NetScaler no se le puede asignar el rol de LSA.
Si tiene un Agente de servidor de licencias (LSA) configurado en un sitio y desea usar el mismo LSA desde otros sitios, puede usar un agente integrado de NetScaler. Al usar el agente integrado, debe configurar el servidor de licencias mediante el siguiente comando en la instancia de NetScaler.
add licenseserver 127.0.0.1 -port 27000
En esta configuración, NetScaler puede acceder al Agente de servidor de licencias (LSA) a través del servicio Console.
Nota:
También puede configurar el agente integrado navegando a la página Infrastructure > Instances > Agents > Generate Activation code. Copie y pegue la URL y el código de activación en una instancia de NetScaler y descubra esa instancia.
Una vez iniciado el agente integrado, navegue a Infrastructure > Instances > NetScaler. Esta página muestra los detalles sobre la instancia administrada descubierta mediante el agente integrado.

Solución de problemas

Puede revisar los registros si el registro falla o si el registro se realiza correctamente pero el agente integrado no aparece en la GUI de NetScaler Console.
  • Si el registro falla, compruebe los registros en /var/mastools/logs/mastools_reg.py.log
  • Si el registro se realiza correctamente, pero el agente integrado no aparece en la GUI de NetScaler Console, compruebe:
    • Registros de Mastools_upgrade en /var/mastools/logs/mastools_upgrade.log
    • Registros binarios en /var/log/mastoolsd.log.