Citrix Application Delivery Management service

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

April 29, 2021

Contribution de:

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 :

Connectez-vous à Citrix Cloud.
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
Cliquez sur Démarrer.
Sélectionnez Sur site comme type de déploiement ADC.
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.

Une URL de service et un code d’activation sont générés et affichés sur l’interface graphique.
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.

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

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

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

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

Revenez à la page du service ADM et cliquez sur Enregistrer l’instance.
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.
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.

La version officielle de ce document est en anglais. Certains contenus de la documentation Citrix ont été traduits de façon automatique à des fins pratiques uniquement. Citrix n'exerce aucun contrôle sur le contenu traduit de façon automatique, qui peut contenir des erreurs, des imprécisions ou un langage inapproprié. Aucune garantie, explicite ou implicite, n'est fournie quant à l'exactitude, la fiabilité, la pertinence ou la justesse de toute traduction effectuée depuis l'anglais d'origine vers une autre langue, ou quant à la conformité de votre produit ou service Citrix à tout contenu traduit de façon automatique, et toute garantie fournie en vertu du contrat de licence de l'utilisateur final ou des conditions d'utilisation des services applicables, ou de tout autre accord avec Citrix, quant à la conformité du produit ou service à toute documentation ne s'applique pas dans la mesure où cette documentation a été traduite de façon automatique. Citrix ne pourra être tenu responsable de tout dommage ou problème dû à l'utilisation de contenu traduit de façon automatique.

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

April 29, 2021

Contribution de:

April 29, 2021

Contribution de: