Procédure de surveillance de la sortie à partir d'un script

Configurer l'agent pour recevoir les données d'une source de données de script.

1. Sur la page Source de données initiale de l'agent ou Emplacement de la source de données, sélectionnez l'option Commande ou script dans la zone Catégories de données de surveillance.
2. Dans la zone Sources de données, cliquez sur Sortie d'un script.
3. Cliquez sur Suivant.
4. Dans la page Liste des commandes, cliquez sur Ajouter pour afficher une fenêtre Informations de commande.
   Remarque : La case Activer la collecte de données via SSH permet d'activer SSH pour ce groupe d'attributs. Si cette case n'est pas cochée, le groupe d'attributs s'exécute en local.

   Remarque : S'il existe une commande pouvant être exécutée sur le système d'exploitation sur lequel Agent Builder est en cours d'exécution, l'option Tester est activée. Vous pouvez utiliser Tester pour tester une commande que vous avez définie.
5. Dans la zone Informations de commande de la fenêtre Informations de commande, entrez un nom de commande à l'aide des arguments nécessaires dans la zone Commande, puis un séparateur dans la zone Séparateur.
   Remarque :

   1. Les scripts dans Windows sont fréquemment appelés sans indiquer l'extension .bat ou .cmd sur la ligne de commande. Pour une exécution à distance, un environnement d'interpréteur de commandes doit être installé et vous devez indiquer l'extension .bat ou .cmd dans la commande de source de données pour que le script s'exécute. Cygwin est un exemple d'environnement d'interpréteur de commandes disponible sous Windows, Linux, Red Hat et AIX. Pour vérifier l'existence d'un environnement d'interpréteur de commandes, utilisez SSH ou connectez-vous à l'hôte distant et entrez la commande :

      PATH=$PATH:. <commande>

      Si la commande s'exécute, cela prouve l'existence d'un environnement d'interpréteur de commandes.
   2. Placez le nom entre guillemets de sorte qu'il ne soit pas analysé par l'interpréteur de commandes. Par exemple, ceci est un argument test.bat devient :

      "ceci est un argument test.bat"

   3. Des variables d'environnement et variables de configuration peuvent être utilisées dans le script fourni par l'utilisateur, mais elles ne peuvent faire partie de la ligne de commande qui appelle le script. Les variables suivantes sont des exceptions à cette règle :

      AGENT_BIN_DIR

      Répertoire dans lequel l'agent place les fichiers binaires ou les scripts

      AGENT_ETC_DIR

      Répertoire dans lequel l'agent place les fichiers de configuration

      AGENT_LIB_DIR

      Répertoire dans lequel l'agent place les bibliothèques partagées ou les bibliothèques de liens dynamiques

      CANDLEHOME

      Répertoire d'installation de Tivoli Monitoring pour Linux ou UNIX.

      CANDLE_HOME

      Répertoire d'installation de Tivoli Monitoring pour Windows

   4. Si l'option de collecte de données SSH est utilisée, la ligne de commande est exécutée par rapport au répertoire de base de l'utilisateur sur le système distant. Si vous téléchargez en amont des scripts ou des exécutables sur le système distant, ils seront copiés dans l'emplacement indiqué dans la variable d'environnement de l'agent CDP_SSH_TEMP_DIRECTORY. L'emplacement correspond par défaut au répertoire de base de l'utilisateur sur le système distant. Sur certains systèmes, vous devrez peut-être utiliser un chemin relatif pour la ligne de commande : par exemple ./Script.sh.
6. Dans la zone Systèmes d'exploitation, sélectionnez un ou plusieurs systèmes d'exploitation. Lorsque vous collectez des données d'un système distant via le protocole SSH, l'option Systèmes d'exploitation est une propriété du système sur lequel l'agent est installé. Il ne s'agit pas du système d'exploitation du système distant. Il est conseillé de cocher la case Tous les systèmes d'exploitation lorsque vous utilisez les fonctions de collecte des données SSH.
7. Facultatif : Si un ou plusieurs fichiers définis par l'utilisateur sont nécessaires pour exécuter la commande, cliquez sur Ajouter dans la zone Fichiers de commandes pour indiquer les fichiers du système.
   Les fichiers sont copiés dans le dossier du projet de l'agent sous scripts/système d'exploitation, où système d'exploitation est une variable qui dépend de la valeur sélectionnée dans la fenêtre Informations de commande. Ces fichiers sont également intégrés à des packages et distribués avec l'agent. Si vous souhaitez modifier la définition d'un fichier de commandes qui a déjà été ajouté ou dont vous avez modifié le contenu, sélectionnez le fichier et cliquez sur Editer. Voir Modification d'une définition de fichier de commandes.
8. Cliquez sur OK. La page Liste des commandes s'affiche.
9. Pour tester la commande, procédez comme suit :
   1. Cliquez sur Tester pour afficher les informations de commande et pour afficher la fenêtre Tester la commande. Pour tester le script sur un système distant, sélectionnez un système dans la liste Nom de connexion ou cliquez sur Ajouter pour ajouter le nom d'hôte d'un système.
   2. Utilisez la fenêtre Tester la commande pour modifier la commande, le séparateur par défaut et les séparateurs d'attribut, puis pour déterminer l'impact des changements sur les données renvoyées.
      1. Tapez la commande et le séparateur dans les zones, s'ils ne sont pas déjà renseignés.
         Remarque : Vous pouvez spécifier d'autres séparateurs à l'aide de la fenêtre Informations d'attribut au moment de la création d'attribut ou à l'aide de l'éditeur d'agent pour modifier un attribut existant. Pour plus d'informations sur l'éditeur d'agent, voir Utilisation de l'éditeur d'agent pour modifier l'agent ; pour plus d'informations sur la manipulation des source de données et des attributs, voir Modification des propriétés de sources de données et d'attributs
      2. Avant de démarrer le test, vous pouvez définir des variables d'environnement et des propriétés de configuration. Pour plus d'informations, voir Test des groupes d'attributs.
      3. Cliquez sur OK pour revenir à la fenêtre Paramètres de test.
      4. Cliquez sur l'option de démarrage de l'agent. Une fenêtre indique que l'agent est en cours de démarrage.
      5. Pour simuler une demande de données d'agent provenant de Tivoli Enterprise Portal ou de SOAP, cliquez sur Collecte de données. Agent Builder exécute votre commande. Si vous avez indiqué un système distant, fournissez un ID utilisateur et un mot de passe. Même si le code retour n'est pas 0, Agent Builder analyse les résultats de la commande selon la même méthode utilisée par l'agent.
      6. La fenêtre Paramètres de test collecte et affiche toutes les données du cache de l'agent depuis son dernier démarrage. Les noms initiaux des attributs sont Attribute_1, Attribute_2, etc. Toutefois, vous pouvez modifier les propriétés des attributs en cliquant sur l'en-tête de colonne approprié.
      7. Cliquez sur Vérifier les résultats pour afficher le code retour généré par la commande, les données non analysées et les éventuels messages d'erreur renvoyés.
      8. L'agent peut être arrêté en cliquant sur Arrêter l'agent.
      9. Cliquez sur OK pour revenir à la fenêtre Informations de commande.

         Si vous modifiez la commande ou le séparateur, la commande appropriée est mise à jour pour refléter ces modifications.

         Si cette fenêtre a été lancée lors de la création de la source de données de script, les attributs ont été ajoutés dans la nouvelle source de données de script.

         Si cette fenêtre a été ouverte à partir d'une source de données de script existante, les modifications apportées aux attributs sont appliquées à la source de données de script. Les attributs supplémentaires sont ajoutés, mais les attributs superflus ne sont pas supprimés. Ces options ont une incidence uniquement sur les attributs soumis à l'analyse à partir du script de sortie. Aucun attribut dérivé n'est affecté. Si l'un de ces attributs n'est plus valide en fonction des attributs auxquels ils font référence, vous devez mettre à jour ou supprimer manuellement les attributs dérivés. La formule d'attribut dérivé s'affiche et non pas la valeur du résultat.

   Remarque : Si le groupe d'attributs existe, procédez comme suit pour commencer un test :

   1. Sélectionnez le groupe d'attributs sur la page Définition des sources de données de l'éditeur d'agent.
   2. Sélectionnez le script à tester dans la liste des commandes.
   3. Cliquez sur Tester et suivez la procédure de l'étape 9.
10. Si vous avez ignoré le test de la commande à l'étape (9), procédez comme suit :
    1. Sur la page Liste des commandes qui contient les informations de commande, cliquez sur Suivant.
    2. Sur la page Information d'attribut, fournissez le nom de l'attribut et les informations de type en utilisant le Tableau 1. Sélectionnez Ajouter des attributs supplémentaires pour ajouter d'autres attributs.
    3. Dans la page Information d'attribut, utilisez l'onglet Informations d'attribut de script pour choisir un séparateur de données spécifique pour cet attribut.
       Le séparateur standard ; est sélectionné par défaut. Vous pouvez choisir un certain nombre d'autres séparateurs, par exemple une chaîne, un certain nombre de caractères, une tabulation ou un espace. Vous pouvez également choisir d'utiliser un autre séparateur de chaînes pour le début et la fin des données. Enfin, vous pouvez également choisir Reste de l'enregistrement pour affecter le reste de l'enregistrement à l'attribut. Pour plus d'informations sur l'analyse syntaxique et les séparateurs de script, voir Script d'analyse et séparateurs.
11. Effectuez l'une des opérations suivantes :
    • Si vous utilisez l'assistant d'agent, cliquez sur Suivant.
    • Cliquez sur Terminer pour sauvegarder la source de données et ouvrir l'éditeur d'agent.
12. Vous pouvez ajouter des attributs et fournir les informations correspondantes. Pour plus d'informations, voir Création d'attributs.
    Outre les zones applicables à toutes les sources de données (décrites dans Zones et options de définition des attributs), la page Définition des sources de données de la source de données du script propose les options suivantes :

    Liste des commandes

    Fournit un accès aux commandes et scripts à démarrer lors d'une collecte de données.

    Ajouter

    Permet à l'utilisateur d'ajouter une commande à démarrer en fonction de ce groupe d'attributs.

    Modifier

    Permet à l'utilisateur de modifier une entrée de commande existante.

    Supprimer

    Permet à l'utilisateur de supprimer une entrée de commande existante.

    Test

    Permet à l'utilisateur d'accéder à l'environnement de test de ce groupe d'attributs.

    Activer la collecte de données via SSH

    Cette case à cocher permet d'activer SSH pour ce groupe d'attributs. Si cette case n'est pas cochée, le groupe d'attributs s'exécute en local.

    Pour plus d'informations sur la configuration des connexions SSH distantes pour les sources de données de script, voir Configuration d'une connexion distante SSH (Secure Shell).