Citrix Application Delivery Management

Configurar el agente integrado ADC para administrar instancias

Hay un agente integrado disponible en las instancias de Citrix ADC MPX, VPX, Gateway que ejecutan la versión 12.1.48.13 y versiones posteriores, y en las instancias de Citrix ADC SDX que ejecutan la versión 13.0 61.x y posterior y 12.1 58.x y posteriores. Puede iniciar este agente en la instancia de ADC 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 el servicio Citrix ADM.

Nota

El agente integrado solo está disponible en los siguientes tipos de instancia de Citrix ADC:

  • Citrix ADC MPX
  • Citrix ADC VPX
  • Citrix ADC SDX
  • Citrix Gateway

El agente integrado es ideal para implementaciones de pares de alta disponibilidad o independientes ADC más pequeños. Si tiene varias instancias ADC, utilice un agente dedicado para las implementaciones. Este agente garantiza que dispone de mejores capacidades de agregación de datos que el agente integrado. Para obtener más información, consulte la Instalar un agente local.

El servicio Citrix ADM admite la administración y supervisión de instancias de Citrix ADC mediante agentes integrados. Sin embargo, el agente integrado no admite las siguientes funciones:

  • Panel de aplicaciones
  • Información web
  • SSL Insight
  • HDX Insight
  • Gateway Insight
  • Security Insight
  • Análisis avanzado
  • Licencias agrupadas

Puede realizar la transición de un agente integrado a otro externo. Para obtener más información, consulte la Transición de un agente integrado a un agente externo.

Requisitos previos

Antes de configurar un agente integrado en la instancia de Citrix ADC, asegúrese de lo siguiente:

  • La instancia de Citrix ADC (MPX, VPX o Gateway) se ejecuta en la versión 12.1.48.13 o posterior. La instancia de SDX está ejecutando la versión 13.0.61.x y posterior.

  • Se agrega un servidor de nombres DNS a la instancia de Citrix ADC.

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

  • Tener una cuenta de Citrix Cloud. Para obtener más información, consulte la 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 ADC:

  1. Inicie sesión en Citrix Cloud.

  2. En el icono Application Delivery Management, haga clic en Administrar. A continuación, seleccione la región que se adapte a sus necesidades empresariales. Para obtener más información, consulte Administre Citrix ADM con una cuenta Express

    Cuenta de Citrix ADM Express

  3. Haga clic en Get Started.

    Empiece aquí

  4. Seleccione En locales como tipo de implementación ADC.

    Seleccionar el tipo de implementación de ADC local

  5. Seleccione Agente integrado.

    Importante

    Para utilizar el agente integrado, la instancia de Citrix ADC debe hallarse en la versión 12.1, compilación 48.13, o posterior.

    Seleccionar agente integrado

    Se generan una URL de servicio y un código de activación y se muestran en la GUI.

  6. 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.

    Copiar la URL del servicio y el código de activación

  7. Inicie el agente integrado mediante un cliente SSH. Los usuarios de la puerta de enlace deben omitir este paso.

    1. Inicie sesión en su instancia de Citrix ADC. Para obtener más información, consulte la Acceder a un Citrix ADC.

    2. Desplácese hasta el /var/mastools/scripts directorio y escriba el siguiente comando:

      En la instancia de SDX

      ./mastool_int.sh <user-name> <service-url> <activation-code> -sdx
      

      o

      ./mastool_init.sh <device-profile-name> <service-url> <activation-code> -sdx -profile
      
      

      Nota

      ADM descubre todas las instancias VPX que se ejecutan en ese SDX y no es necesario registrarlas individualmente.

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

      Si la versión de la imagen ADM es inferior a 13.0 61.x o 12.1 57.x, debe verificar la mastools versión escribiendo el comando cat /var/mastools/version.conf. Si la salida es 0.0-0.0, es la primera vez.

      Escriba uno de los siguientes comandos que se indican a continuación, dependiendo de la versión del software.

      Versión de imagen ADC ¿Es mastools_version 0.0-0.0? Comando para el registro con perfil Comando para el registro sin perfil
      Menos de 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>"
      Menos de 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>
      Más de 13,0 61.x y 12.1 57.xx No corresponde ./mastools_init.sh <device_profile_name> <service_url> <activation_code> -profile ./mastools_init.sh <user_name> <pwd> <service_url> <activation_code>
      • En<username>, introduzca el nombre de usuario de Citrix ADC.

      • En<password>, introduzca la contraseña ADC.

      • En<service_url>, pegue la URL que ha copiado en el paso anterior.

      • En<activation_code>, pegue el código de activación que ha copiado en el paso anterior.

      CLI inicia el agente integrado

    Para las instancias MPX, VPX y Gateway, una vez completada la inicialización mediante el mastools comando, se establece la comunicación entre el agente y el servicio ADM. El agente se actualiza automáticamente cada vez que hay disponible una versión más reciente de software. Sin embargo, a partir de las versiones ADC 12.1 57.18 y posteriores y ADC 13.0 61.48 y posteriores, el agente integrado se comunica con el servicio ADM sin inicialización y se actualiza automáticamente a la última versión de software regularmente. Para las instancias SDX, el agente viene con la función de actualización automática en todas las versiones compatibles, que es 13.0 61.x y versiones posteriores y 12.1 58.x y posteriores.

    Nota

    En un par HA, complete el registro en el nodo principal. Si ejecuta el registro en el nodo secundario, aparece el siguiente mensaje:

    Ejecute el comando de registro en el nodo principal.

  8. Vuelva a la página del servicio ADM y haga clic en Registrar instancia.

  9. En Agregar instancias, vea la instancia en la que inició el agente integrado. Asegúrese de que la instancia está en el estado Arriba y haga clic en Siguiente.

    Agregar instancias

  10. Haga clic en Done.

Configuración completa del agente integrada

Después de una correcta configuración del agente integrada, puede acceder a las funciones de ADM como:

  • Servidor virtual y análisis: Aplique licencias a su servidor virtual para administrar instancias ADC. Para obtener más información, consulte la Administrar suscripciones.

  • Panel de aplicación: Para ver todas las aplicaciones de una manera holística. Para obtener más información, consulte la Administración de aplicaciones y panel de control.

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

Nota También

puede configurar el agente integrado navegando a la página Redes > Agentes > Generar código de activación. Copie y pegue la URL y el código de activación en una instancia ADC y descubra esa instancia.

Una vez iniciado el agente integrado, vaya a Redes > Instancias > Citrix ADC. Esta página muestra los detalles sobre la instancia administrada detectada mediante el agente integrado.

Solucionar problemas

Puede comprobar los registros si el registro falla o si el registro se realiza correctamente, pero el agente integrado no aparece en la GUI de ADM.

  • 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 ADM, compruebe:
    • MastOols_Upgrade registra /var/mastools/logs/mastools_upgrade.log
    • Inicia sesión binaria/var/log/mastoolsd.log.
Configurar el agente integrado ADC para administrar instancias