Citrix Application Delivery Management service

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. 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 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 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 tâches planifiées pour s’exécuter 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 du travail de configuration, vous pouvez convertir les paramètres de nom de fichier local et distant en variables. Cela vous permet d’attribuer 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 « 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 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 à 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 Save.

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

    image localisée

  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 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 entreprendre 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 du travail en accédant à Réseaux > Tâches de configurationet en sélectionnant le travail que vous venez de configurer. Cliquez sur Détails, puis sur Détails des variables pour répertorier les variables ajoutées à votre tâche.

    image localisée

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