Utiliser la commande SCP (put) dans les tâches de configuration

Vous pouvez utiliser la fonctionnalité Travaux de configuration de Citrix Application Delivery Management (ADM) pour créer des tâches de configuration, envoyer des notifications par e-mail et vérifier les journaux d’exécution des tâches créées. Un travail est un ensemble de commandes de configuration que vous pouvez créer et exécuter sur une seule instance gérée ou sur plusieurs instances gérées. Par exemple, vous pouvez utiliser des tâches de configuration pour les mises à niveau de périphériques.

Les tâches de configuration dans Citrix ADM utilisent les commandes Secure Shell (SSH) pour configurer des instances, et vous pouvez configurer une tâche de configuration pour utiliser la copie sécurisée (SCP) pour transférer des fichiers en toute sécurité. SCP est basé sur le protocole SSH. L’une des commandes SCP que vous pouvez inclure dans une tâche de configuration est la commande « put ». Vous pouvez utiliser la commande « put » dans les tâches de configuration pour télécharger ou transférer un ou plusieurs fichiers stockés dans un répertoire local de votre système vers Citrix ADM, puis vers un répertoire sur l’instance ou les instances de Citrix ADC.

Remarque

Le fichier est téléchargé sur Citrix ADM et il est ensuite copié (mis) dans les instances Citrix ADC sélectionnées. Le fichier téléchargé est stocké dans Citrix ADM et n’est supprimé que lorsque le travail est supprimé. Ceci est nécessaire pour que les tâches planifiées s’exécutent ultérieurement.

La commande a la syntaxe suivante :

put <local_filename> <remote_path/remote_filename>

où,

<local_filename> est le nom du fichier local à télécharger.

<remote_path/remote_filename> est le chemin d’accès à un répertoire distant et le nom à attribuer au fichier lorsqu’il est copié dans ce répertoire.

Lors de la création de la tâche de configuration, vous pouvez convertir les paramètres de nom de fichier local et distant en variables. Cela vous permet d’affecter différents fichiers à ces paramètres pour le même ensemble d’instances de Citrix ADC chaque fois que vous exécutez le travail. En outre, lorsque vous utilisez un fichier à plusieurs endroits dans une tâche et si vous souhaitez renommer le fichier, vous pouvez redéfinir la variable au lieu de changer le nom du fichier à tous les endroits.

Pour utiliser la commande put pour télécharger des fichiers dans une tâche de configuration :

  1. Dans Citrix ADM, accédez à Réseaux > Travaux de configuration.

  2. Sur la page Travaux, cliquez sur Créer un travail .

  3. Dans la page Créer un travail, entrez le nom du travail dans le champ Nom du travail et, dans le volet Éditeur de configuration, entrez la commande « put ».

    Par exemple, si vous souhaitez créer un travail de configuration qui copie un fichier de certificat SSL enregistré sur votre système local vers plusieurs instances de Citrix ADC, vous pouvez ajouter une commande « put » qui utilise une variable au lieu du nom d’un fichier particulier, et définir le type de variable comme « file ».

    put ssl-file /nsconfig/ssl-file
    

    Dans cet exemple,

    • ssl-file - Il s’agit du nom du fichier qui doit être téléchargé dans l’instance de Citrix ADC.
    • /nsconfig/ssl-file - Il s’agit du dossier de destination sur l’instance où le fichier ssl-sera placé après l’exécution de la tâche.
  4. Dans la commande que vous venez de saisir, sélectionnez le nom de fichier que vous souhaitez convertir en variable, puis cliquez sur Convertir en variable, comme illustré dans la figure suivante.

    image localisée

  5. Vérifiez que le nom du fichier a été entouré de signes dollar (indiquant qu’il s’agit maintenant d’une variable), puis cliquez sur la variable.

  6. Spécifiez les détails de la variable, tels que le nom, le nom complet et le type.

  7. Dans la liste déroulante Type, sélectionnez Fichier. Cliquez sur Enregistrer.

    La déclaration de la variable en tant que type « Fichier » vous permet de télécharger des fichiers sur Citrix ADM.

    image localisée

  8. Cliquez sur Suivant et sélectionnez les instances Citrix ADC vers lesquelles copier les fichiers.

  9. Sous l’onglet Spécifier les valeurs de variable, sélectionnez la section Valeurs de variables communes pour toutes les instances, sélectionnez le fichier dans le stockage local de votre système, cliquez sur Télécharger pour télécharger le fichier sur Citrix ADM, puis cliquez sur Suivant .

    image localisée

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

  11. Sous l’onglet Exécuter, vous pouvez exécuter le travail maintenant ou programmer 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 créer une notification par e-mail pour recevoir une notification sur la réussite ou l’échec de la tâche, ainsi que d’autres détails. Cliquez sur Terminer.

  12. Vous pouvez afficher les détails du travail en accédant à Réseaux > Tâches de configuration et en sélectionnant la tâche que vous venez de configurer. Cliquez sur Détails, puis cliquez sur Détails de la variablepour répertorier les variables ajoutées à votre tâche.

    image localisée

Utiliser la commande SCP (put) dans les tâches de configuration