Citrix Application Delivery Management service

Configurer l’agent intégré ADC pour gérer les instances

Un agent intégré est disponible sur les instances Citrix ADC MPX, VPX, Gateway exécutant la version 12.1.48.13 et les versions ultérieures et sur les instances Citrix ADC SDX exécutant la version 13.0 61.x et les versions ultérieures et 12.1 58.x et ultérieures. Vous pouvez lancer cet agent sur l’instance ADC au lieu d’installer un agent dédié dans votre centre de données ou cloud public. L’agent intégré permet la communication entre l’instance et le service Citrix ADM.

Remarque

L’agent intégré est disponible uniquement sur les types d’instance Citrix ADC suivants :

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

L’agent intégré est idéal pour les déploiements ADC autonomes ou de paires HA plus petits. Si vous disposez de plusieurs instances ADC, utilisez un agent dédié pour les déploiements. Cet agent garantit que vous disposez de meilleures capacités d’agrégation de données que l’agent intégré. Pour de plus amples informations, consultez la section Installer un agent sur site.

Le service Citrix ADM prend en charge la gestion et la surveillance des instances Citrix ADC à l’aide d’agents intégrés. Toutefois, les fonctionnalités suivantes ne sont pas prises en charge dans l’agent intégré :

  • Tableau de bord de l’application
  • Web Insight
  • Perspectives SSL
  • Aperçu HDX
  • Perspectives de
  • Informations sur la sécurité
  • Analyses avancées
  • Licences groupées

Vous pouvez passer d’un agent intégré à un agent externe. Pour de plus amples informations, consultez la section Transition d’un agent intégré à un agent externe.

Conditions préalables

Avant de configurer un agent intégré sur l’instance Citrix ADC, vérifiez ce qui suit :

  • L’instance Citrix ADC (MPX, VPX ou Gateway) s’exécute sur la version 12.1.48.13 ou une version ultérieure. L’instance SDX exécute la version 13.0.61.x et les versions ultérieures.

  • Un serveur de noms DNS est ajouté sur l’instance Citrix ADC.

    Pour de plus amples informations, consultez la section Ajouter un serveur de noms.

  • Vous disposez d’un compte Citrix Cloud. Pour de plus amples informations, consultez la section Ouvrir un compte sur Citrix Cloud.

Remarque

Pour plus d’informations sur les ports et les autres configurations système requises, reportez-vous à la section Configuration système requise.

Configurer l’agent intégré

Effectuez les tâches suivantes pour configurer l’agent intégré ADC :

  1. Connectez-vous à Citrix Cloud.

  2. Dans la vignette Application Delivery Management, cliquez sur Gérer . Sélectionnez ensuite la région qui correspond à vos besoins commerciaux. Pour de plus amples informations, consultez Gérer Citrix ADM avec un compte Express

    Compte Citrix ADM Express

  3. Cliquez sur Démarrer.

    Mise en route

  4. Sélectionnez Sur site comme type de déploiement ADC.

    Sélectionner un type de déploiement ADC local

  5. Sélectionnez Agent intégré.

    Important

    Pour utiliser l’agent intégré, votre instance Citrix ADC doit être en version 12.1 version 48.13 et supérieure.

    Sélectionner Agent intégré

    Une URL de service et un code d’activation sont générés et affichés sur l’interface graphique.

  6. Copiez l’URL du service et le code d’activation.

    L’agent utilise l’URL du service pour localiser le service et le code d’activation pour s’inscrire auprès du service. Ignorez l’étape 7 si vous êtes client MPX ou Gateway.

    Copier l'URL du service et le code d'activation

  7. Lancez l’agent intégré à l’aide d’un client SSH. Les utilisateurs de la passerelle doivent ignorer cette étape.

    1. Connectez-vous à votre instance Citrix ADC. Pour de plus amples informations, consultez la section Accéder à un Citrix ADC.

    2. Accédez au /var/mastools/scripts répertoire et tapez la commande suivante :

      Sur l’instance SDX

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

      ou

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

      Remarque

      ADM découvre toutes les instances VPX exécutées sur ce SDX et vous n’avez pas à enregistrer les instances VPX individuellement.

      Sur les instances VPX ne s’exécutant pas sur une appliance SDX et sur les instances MPX et Gateway

      Si la version d’image ADM est inférieure à 13.0 61.x ou 12.1 57.x, vous devez vérifier la mastools version en tapant la commande cat /var/mastools/version.conf. Si la sortie est 0.0-0.0, c’est la première fois.

      Tapez l’une des commandes suivantes indiquées ci-dessous, en fonction de la version du logiciel.

      Version de l’image ADC Est-ce que mastools_version 0.0-0.0 ? Commande pour l’enregistrement avec le profil Commande pour l’enregistrement sans profil
      Inférieur à 13,0 61.xx et 12,1 57,xx Oui ./mastools_init.sh <device_profile_name> <service_url> "MAS;<activation_code>" -profile ./mastools_init.sh <user_name> <pwd> <service_url> "MAS;<activation_code>"
      Inférieur à 13,0 61.xx et 12,1 57,xx Non ./mastools_init.sh <device_profile_name> <service_url> <activation_code> -profile ./mastools_init.sh <user_name> <pwd> <service_url> <activation_code>
      Supérieur à 13,0 61.x et 12,1 57.xx Sans objet ./mastools_init.sh <device_profile_name> <service_url> <activation_code> -profile ./mastools_init.sh <user_name> <pwd> <service_url> <activation_code>
      • Dans <username>, entrez le nom d’utilisateur Citrix ADC.

      • Dans <password>, entrez le mot de passe ADC.

      • Dans <service_url>, collez l’URL que vous avez copiée à l’étape précédente.

      • Dans <activation_code>, collez le code d’activation que vous avez copié à l’étape précédente.

      L'interface de ligne de commande lance l'agent intégré

    Pour les instances MPX, VPX et Gateway, une fois l’initialisation effectuée à l’aide de la mastools commande, la communication entre l’agent et le service ADM est établie. L’agent met automatiquement à niveau chaque fois qu’une version logicielle la plus récente est disponible. Cependant, à partir des versions ADC 12.1 57.18 et supérieures et ADC 13.0 61.48 et supérieures, l’agent intégré communique avec le service ADM sans initialisation et se met à niveau automatiquement vers la dernière version du logiciel régulièrement. Pour les instances SDX, l’agent est livré avec la fonctionnalité de mise à niveau automatique dans toutes les versions prises en charge, soit 13.0 61.x et versions ultérieures et 12.1 58.x et versions ultérieures.

    Remarque

    Dans une paire HA, effectuez l’enregistrement sur le nœud principal. Si vous exécutez l’enregistrement sur le nœud secondaire, le message suivant s’affiche :

    Exécutez la commande d’enregistrement sur le nœud principal.

  8. Revenez à la page du service ADM et cliquez sur Enregistrer l’instance.

  9. Dans Ajouter des instances, affichez l’instance dans laquelle vous avez lancé l’agent intégré. Assurez-vous que l’instance est dans l’état Up et cliquez sur Suivant.

    Ajouter des instances

  10. Cliquez sur Terminé.

Configuration complète de l'agent intégrée

Après avoir réussi la configuration intégrée de l’agent, vous pouvez accéder aux fonctionnalités ADM telles que :

  • Serveur virtuel et analytique  : appliquez des licences à votre serveur virtuel pour gérer les instances ADC. Pour de plus amples informations, consultez la section Gérer les abonnements.

  • Tableau de bord des applications  : permet d’afficher toutes les applications d’une manière holistique. Pour de plus amples informations, consultez la section Gestion des applications et tableau de bord.

  • Analyse de l’infrastructure  : cette fonctionnalité vous aide à visualiser les facteurs qui ont entraîné ou pourraient entraîner un problème sur les instances. Pour de plus amples informations, consultez la section Analyse d’infrastructure.

Remarque

Vous pouvez également configurer l’agent intégré en accédant à la page Réseaux > Agents > Générer un code d’activation. Copiez et collez l’URL et le code d’activation dans une instance ADC et découvrez cette instance.

Une fois l’agent intégré lancé, accédez à Réseaux > Instances > Citrix ADC. Cette page affiche les détails sur l’instance gérée découverte à l’aide de l’agent intégré.

Résolution des problèmes

Vous pouvez vérifier les journaux si l’enregistrement échoue ou si l’enregistrement réussit mais que l’agent intégré n’apparaît pas dans l’interface graphique ADM.

  • Si l’enregistrement échoue, vérifiez les journaux dans /var/mastools/logs/mastools_reg.py.log
  • Si l’enregistrement réussit, mais que l’agent intégré n’apparaît pas dans l’interface graphique ADM, vérifiez :
    • MASTools_Upgrade journaux dans /var/mastools/logs/mastools_upgrade.log
    • Journaux binaires/var/log/mastoolsd.log.
Configurer l’agent intégré ADC pour gérer les instances