Citrix Application Delivery Management

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

Vous pouvez utiliser la fonctionnalité Travaux de configuration de Citrix 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. Une tâche 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 SSH (Secure Shell) pour configurer les instances, et vous pouvez configurer une tâche de configuration pour utiliser Secure Copy (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 un travail 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 Citrix ADC.

Remarque Le fichier est téléchargé dans 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. 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 - Il s’agit du nom du fichier qui doit être téléchargé dans l’instance Citrix ADC.

    • /nsconfig/ssl-file - Il s’agit du dossier de destination de 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 est 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.

    Fichier en tant que variable

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

  9. Sous l’onglet Spécifier les valeurs de variables, 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 Charger pour charger le fichier dans Citrix ADM, puis cliquez sur Suivant.

    Charger le fichier

  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âches de configuration et en sélectionnant la tâche que vous avez configurée. Cliquez sur Détails, puis sur Détails des variables pour répertorier les variables ajoutées à votre tâche.

    Liste des variables

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

Dans cet article