Citrix Application Delivery Management service

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

Vous pouvez utiliser la fonctionnalité Jobs 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 est supprimé uniquement lorsque le travail est supprimé. Ceci est nécessaire pour les travaux planifiés pour s’exécuter plus tard.

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 du travail 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 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 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 « fichier ».

    put ssl-file /nsconfig/ssl-file
    

    Dans cet exemple,

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

    Convertir en variable

  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 vers Citrix ADM.

    Enregistrez le fichier

  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 .

    Télécharger le fichier vers ADM

  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 planifier son exécution ultérieure. 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 le succès ou l’échec de la tâche, ainsi que d’autres détails. Cliquez sur Terminer.

  12. Vous pouvez afficher les détails de la tâche en accédant à Réseaux > Tâces de configurationet en sélectionnant la tâche que vous avez configurée. Cliquez sur Détails, puis cliquez sur Détails de la variablepour répertorier les variables ajoutées à votre tâche.

    Vérifier les détails de la variable

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