Servicio NetScaler Console

Configurar el agente integrado para administrar instancias

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. Puedes iniciar este agente en la instancia de NetScaler en lugar de instalar un agente dedicado en tu 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 instancia de NetScaler:

  • NetScaler MPX
  • NetScaler VPX
  • NetScaler SDX
  • NetScaler Gateway

El agente integrado es ideal para implementaciones más pequeñas de NetScaler independientes o de par de alta disponibilidad (HA). Si tienes varias instancias de NetScaler, usa un agente dedicado para las implementaciones. Este agente garantiza que tengas mejores capacidades de agregación de datos que el agente integrado. Para obtener más información, consulta Instalar un agente local.

NetScaler Console admite la administración y supervisión de instancias de NetScaler mediante agentes integrados. Sin embargo, las siguientes funciones no son compatibles con el agente integrado:

  • Panel de aplicaciones
  • Web Insight
  • SSL Insight
  • HDX Insight
  • Gateway Insight
  • Security Insight
  • Análisis avanzados
  • Licencias agrupadas/flexibles

Puedes pasar de un agente integrado a un agente externo. Para obtener más información, consulta Transición de un agente integrado a un agente externo.

Requisitos previos

Antes de configurar un agente integrado en la instancia de NetScaler, asegúrate de lo siguiente:

  • La instancia de NetScaler (MPX, VPX o Gateway) ejecuta la versión 12.1.48.13 o posterior. La instancia de SDX ejecuta la versión 13.0.61.x y posteriores.

  • Se ha agregado un servidor de nombres DNS en la instancia de NetScaler.

    Para obtener más información, consulta Agregar un servidor de nombres.

  • Tienes una cuenta de Citrix Cloud. Para obtener más información, consulta Registrarse en Citrix Cloud.

Nota:

Para obtener toda la información relacionada con los puertos y otros requisitos del sistema, consulta Requisitos del sistema.

Configurar el agente integrado

Realiza las siguientes tareas para configurar el agente integrado de NetScaler:

  1. Selecciona la opción Agente integrado según las instrucciones de Introducción.

  2. Copia la URL del servicio y el código de activación.

    El agente usa la URL del servicio para localizar el servicio y el código de activación para registrarse en el servicio. Omite el paso 7 si eres cliente de MPX o Gateway.

  3. Inicia el agente integrado mediante un cliente SSH. Los usuarios de Gateway deben omitir este paso.

    1. Inicia sesión en tu instancia de NetScaler. Para obtener más información, consulta Acceder a un NetScaler.

    2. Navega hasta el directorio /var/mastools/scripts y escribe el siguiente comando:

      En la instancia de SDX

        Registro con perfil de NetScaler Registro sin perfil de NetScaler
      Requisito previo Antes de registrarte, crea un perfil de NetScaler. Para obtener más información, consulta Cómo crear un perfil de NetScaler.  
      Ejecuta 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 Introduce nsroot en <device_profile_name>. Alternativamente, puedes usar un nombre de usuario que tenga los mismos privilegios de acceso que nsroot. Introduce nsroot en <user_name>. Alternativamente, puedes usar un nombre de usuario que tenga los mismos privilegios de acceso que nsroot.

      Nota:

      NetScaler Console detecta todas las instancias de VPX que se ejecutan en ese SDX y no tienes que registrar las instancias de VPX individualmente.

      En instancias de VPX que no se ejecutan en un dispositivo SDX y en instancias de MPX y Gateway:

      Si la versión de la imagen de NetScaler es anterior a 13.0 61.x o 12.1 57.x, debes comprobar la versión de mastools escribiendo el comando cat /var/mastools/version.txt. Si la salida es 0.0-0.0, es la primera vez.

      Escribe uno de los siguientes comandos según la versión del software.

      Nota:

      Antes de registrarte con un perfil de NetScaler, debes crear el perfil. Para obtener más información, consulta 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 ./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>, introduce nsroot. Alternativamente, puedes usar un nombre de usuario que tenga los mismos privilegios de acceso que nsroot.
    • En un par de alta disponibilidad (HA), completa el registro en el nodo principal. Si ejecutas los comandos de registro en el nodo secundario, aparece el siguiente mensaje: Ejecuta el comando de registro en el nodo principal.
  4. Vuelve a la página de NetScaler Console y haz clic en Registrar instancia.

  5. En Agregar instancias, visualiza la instancia donde iniciaste el agente integrado. Asegúrate de que la instancia esté en estado Activo y haz clic en Siguiente.

  6. Haz clic en Listo.

Después de configurar correctamente el agente integrado, puedes acceder a las funciones de NetScaler Console, como:

  • Servidor virtual y análisis – Aplica licencias a tu servidor virtual para administrar instancias de NetScaler. Para obtener más información, consulta Administrar suscripciones.

  • Panel de aplicaciones – Para ver todas las aplicaciones de forma holística. Para obtener más información, consulta Administración de aplicaciones y panel.

  • Análisis de infraestructura – Esta función te ayuda a visualizar los factores que provocaron o podrían provocar un problema en las instancias. Para obtener más información, consulta Análisis de infraestructura.

Configurar el servidor de licencias mediante el agente integrado de NetScaler

Nota:

Al agente integrado de NetScaler no se le puede asignar el rol de LSA.

Si tienes un Agente de servidor de licencias (LSA) configurado en un sitio y quieres usar el mismo LSA desde otros sitios, puedes usar un agente integrado de NetScaler. Mientras usas el agente integrado, debes configurar el servidor de licencias mediante el siguiente comando en la instancia de NetScaler.

add licenseserver 127.0.0.1 -port 27000
<!--NeedCopy-->

En esta configuración, NetScaler puede acceder al Agente de servidor de licencias (LSA) a través del servicio Console.

Nota:

También puedes configurar el agente integrado navegando a la página Infraestructura > Instancias > Agentes > Generar código de activación. Copia y pega la URL y el código de activación en una instancia de NetScaler y detecta esa instancia.

Una vez iniciado el agente integrado, navega a Infraestructura > Instancias > NetScaler. Esta página muestra los detalles sobre la instancia administrada detectada mediante el agente integrado.

Solución de problemas

Puedes comprobar 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, comprueba 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, comprueba:
    • Los registros de Mastools_upgrade en /var/mastools/logs/mastools_upgrade.log
    • Los registros binarios en /var/log/mastoolsd.log.
Configurar el agente integrado para administrar instancias