Citrix Application Delivery Management service

Utiliser le modèle de configuration maître

L’utilisation d’un modèle de configuration maître est une option flexible pour la création et le déploiement d’une configuration maître sur plusieurs instances Citrix ADC.

En tant qu’administrateur, vous pouvez modifier la configuration et enregistrer les licences, certificats et autres fichiers sur une instance de Citrix ADC. Vous pouvez enregistrer la nouvelle configuration en tant que modèle de configuration maître (fichier .conf).

Pour enregistrer votre modèle de configuration maître à partir d’une instance de Citrix ADC, vous pouvez effectuer l’une des opérations suivantes :

  • À l’invite de commandes, entrez save ns config. La configuration est enregistrée dans la mémoire FLASH de l’instance dans le fichier /nsconfig/ns.conf.
  • À partir de l’interface graphique de l’instance d’Citrix ADC, accédez à Diagnostics > Afficher la configuration . Choisissez le type de configuration que vous souhaitez enregistrer. Par exemple, si vous souhaitez enregistrer la configuration enregistrée de votre instance de Citrix ADC, sélectionnez Configuration enregistrée. Cliquez sur le lien Enregistrer le texte dans un fichier pour enregistrer le fichier ‘ns.conf’ sur votre machine locale.

Lorsque vous déployez le modèle de configuration maître à l’aide du modèle de configuration ‘DeployMasterConfiguration’ lors de la création d’une tâche, vous pouvez le personnaliser davantage pour chaque instance Citrix ADC spécifique en ajoutant plus de commandes, en modifiant des commandes existantes et en fournissant différentes valeurs de variables dans le fichier d’entrée .

Par exemple, en tant qu’administrateur, vous pouvez télécharger des clés de certificat sur vos instances Citrix ADC en plus du fichier ns.conf et y déployer également la configuration principale.

Important

Vous ne pouvez pas exécuter un travail de configuration à l’aide du modèle DeploymasterConfiguration sur des instances Citrix ADC CPX, des instances Citrix ADC configurées dans un cluster ou sur des instances Citrix ADC partitionnées.

Pour créer une tâche de configuration à l’aide du modèle de configuration Master Config sur Citrix ADM :

  1. Dans Citrix Application Delivery Management (ADM), accédez à Réseaux > Travaux de configuration, puis cliquez sur Créer un travail.

  2. Dans la page Créer un travail, sous l’onglet Sélectionner une configuration, spécifiez le nom du travail et sélectionnez le type d’instance dans la liste déroulante.

  3. Sélectionnez Configuration principale dans la liste déroulante Source de configuration . Faites glisser les commandes du modèle DeployMasterConfiguration vers le volet droit. Vous pouvez également ajouter, modifier ou supprimer des commandes dans le volet droit. Cliquez sur Suivant.

    Remarque

    Vous pouvez ajouter des commandes de mise pour ajouter des fichiers d’entrée à votre modèle. Dans notre exemple, nous devons télécharger des fichiers de certificat et de clé en plus du fichier de modèle de configuration et des fichiers d’entrée de variables.

    Configuration principale

  4. Vous pouvez consulter toutes les variables que vous avez définies lors de la création ou de la modification d’un travail de configuration dans une vue consolidée unique.

  5. Pour afficher toutes les variables dans une seule vue consolidée, procédez de l’une des manières suivantes :

    • Lors de la création d’une tâche de configuration, accédez à Réseaux > Travaux de configuration, sélectionnez Créer un travail. Sur la page Créer un travail, vous pouvez consulter toutes les variables que vous avez ajoutées lors de la création du travail de configuration.

    • Lors de la modification d’un travail de configuration, accédez à Réseau > Travaux de configuration, sélectionnez le nom du travail et cliquez sur Modifier. Sur la page Configurer le travail, vous pouvez passer en revue toutes les variables qui ont été ajoutées lors de la création du travail de configuration.

  6. Vous pouvez ensuite cliquer sur l’onglet Aperçu des variables pour prévisualiser les variables dans une vue consolidée unique que vous avez définie lors de la création ou de la modification d’un travail de configuration.

    Exemple d'aperçu de la configuration

  7. Une nouvelle fenêtre contextuelle s’affiche et affiche tous les paramètres des variables telles que Nom, Nom d’affichage, Type et valeur par défaut sous forme de tableau. Vous pouvez également modifier ces paramètres. Cliquez sur le bouton Terminé après avoir modifié l’un des paramètres.

    Variables spécifiées

  8. Sélectionnez les instances sur lesquelles vous souhaitez exécuter le travail de configuration, puis cliquez sur Suivant.

  9. Sous l’onglet Spécifier les valeurs de variable, chargez les éléments suivants :

    • Fichier de modèle de configuration (.conf) : téléchargez le fichier .conf extrait d’une instance de Citrix ADC.
    • Télécharger le fichier d’entrée (.xml/csv) - Téléchargez le fichier d’entrée avec des valeurs pour les variables que vous avez définies dans vos commandes.

    Un exemple de fichier xml est fourni ici pour votre utilisation. Assurez-vous que les fichiers xml contiennent les détails correspondant aux instances ADC que vous utilisez.

    
    <?xml version="1.0" encoding="UTF-8" ?>
    
    <properties>
    
    <!-- 
    
    Provide inputs for all the parameters defined in the master config file.
    
    -  global. This tag contains all the common parameters and value.
    
    -  devicegroup. This tag contains all the instance group specific parameters and values.
    
    If the same parameters are defined in global and instance tags, the instance specific parameters value will take precedence over the instance group. The instance group specific parameters value will take precedence over global parameters in the execution.	        
    
    -  name. This attribute represents the name of the instance group.
    
    -  device. This tag contains all the instance specific parameters and value. 
    
    If the same parameters are defined in global and instance tags, the instance specific parameters value will take precedence in the execution.
    
    -  name. This attribute represents the IP Address of the instance. Host name is not supported for the attibute.
    
    HA pair should be represented as <primaryip>-<secondaryip>. Example 10.102.2.1-10.102.2.2
    
    In the template file, the parameter name must be specified within the dollar sign,Example: $NSIP$, $CC_Trap_Dest$ and parameters names are case sensitive.
    -->
    
    <global>
    
    </global>
    <devicegroup name="BLR_DEVS">
    </devicegroup>
    <device name="10.106.101.209">
    <param name="IP" value="10.106.101.209"/>
    </device>
    
    <!-- HA PAIR-->
    <!--<device name="10.102.43.154-10.102.43.155">
    <param name="NSIP" value="10.102.43.154"/>
    <param name="HostName" value="NS43HA"/>
    <param name="LBSERVER" value="haserver43http"/>
    <param name="SNMPTrapDest" value="10.102.43.130"/>
    </device>-->
    </properties>
    
    <!--NeedCopy-->
    

    Un exemple de fichier csv est fourni ici pour votre utilisation.

    #job-s_variable_input_key_file ,,,,
    ,,,,
    #Global,NSIP,HostName,LBSERVER,SNMPTrapDest
    Global Values,,,,
    #InstanceGroup,NSIP,HostName,LBSERVER,SNMPTrapDest
    example_doc,,,,
    #Instance(s),NSIP,HostName,LBSERVER,SNMPTrapDest
    10.xx.xx.xx,,,,
    <!--NeedCopy-->
    

    Le même fichier est affiché dans Microsoft Excel :

    Exemple de CSV sur Excel

  10. Cliquez sur Suivant.

    Sélectionner les fichiers

    Les fichiers d’entrée contenant les valeurs de variables sont conservés (avec le même nom de fichier) dans les tâches de configuration. Vous pouvez afficher et modifier ces fichiers d’entrée que vous avez utilisés et chargés précédemment lors de la création ou de la modification des tâches de configuration.

    Pour afficher les travaux de configuration exécutés lors de la création d’un travail de configuration, accédez à Réseau > Travaux de configuration, puis cliquez sur Créer un travail. Dans la page Créer une tâche. Sous l’onglet Spécifier les valeurs de variable, sélectionnez l’option Valeurs variables communes pour toutes les instances pour afficher les fichiers téléchargés. Pour modifier les fichiers d’entrée, téléchargez le fichier d’entrée, puis modifiez et chargez les fichiers (en conservant le même nom de fichier).

    Pour afficher les travaux de configuration déjà exécutés lors de la modification d’un travail de configuration, accédez à Réseau > Travaux de configuration, sélectionnez le nom du travail et cliquez sur Modifier. Dans la page Configurer la tâche, sous l’onglet Spécifier les valeurs de variable, sélectionnez l’option Valeurs variables communes pour toutes les instances pour afficher les fichiers chargés. Pour modifier les fichiers d’entrée, téléchargez le fichier d’entrée, puis modifiez et téléchargez les fichiers (en conservant le même nom de fichier).

  11. Sous l’onglet Aperçu des tâches, vous pouvez évaluer et vérifier les commandes à exécuter sur chaque instance ou groupe d’instances, puis cliquez sur Suivant .

    Vérifier les commandes

  12. Sous l’ongletExécuter, vous pouvez choisir d’exécuter votre travail maintenant ou de le programmer pour qu’il soit exécuté ultérieurement. Vous pouvez également choisir l’action que Citrix ADM doit prendre en cas d’échec de la commande.

    Vous pouvez également choisir d’autoriser les utilisateurs autorisés à exécuter des travaux sur vos instances gérées, et vous pouvez choisir d’envoyer une notification par e-mail concernant le succès ou l’échec de la tâche, ainsi que d’autres détails.

    Autoriser les utilisateurs autorisés

    Après avoir exécuté votre travail, vous pouvez voir les détails de la tâche en accédant à Réseaux > Tâces de configuration et sélectionnez la tâche que vous venez de configurer. Cliquez sur Détails, puis sur Récapitulatif de l’exécution pour afficher les détails de votre tâche. Cliquez sur l’instance pour afficher les journaux des commandes pour voir les commandes exécutées sur la tâche.

    Afficher les commandes exécutées sur le travail

Utiliser le modèle de configuration maître