Objets VARA BACKEND

Si vous êtes développeur et concepteur d'objet, vous devez définir des objets VARA BACKEND pour qu'ils exécutent une commande sur un système d'exploitation (Windows ou UNIX) et donnent le résultat sous forme de valeurs affichées en colonnes. Les commandes des différents systèmes d'exploitation, noms de systèmes et versions peuvent être conservées dans un seul objet VARA BACKEND. Lorsque l'objet VARA est résolu, la commande correcte de l'agent concerné est automatiquement sélectionnée et exécutée.

Remarques :

• La création et l'édition d'objets VARA BACKEND requièrent un privilège spécifique.
• VAR_TIMEOUT (UC_HOSTCHAR_DEFAULT - Caractéristiques de l'hôte) et BACKENDVAR_MAX_ROWS dans UC_SYSTEM_SETTINGS - Paramètres système sont également disponibles pour les objets VARA BACKEND.
• Les variables PromptSet sont supportées dans les champs sélectionnés pour les variables de type BACKEND, EXEC, FILELIST, SEC_SQLI, SEC_SQL, SQLI, SQL et XML. La fonction Rechargement dynamique (prompts Liste déroulante) requiert l'utilisation de variables PromptSet.

• Les variables PromptSet sont supportées dans les champs sélectionnés pour les variables de type BACKEND, EXEC, FILELIST, SEC_SQLI, SEC_SQL, SQLI, SQL et XML. La fonction Rechargement dynamique (prompts Liste déroulante) requiert l'utilisation de variables PromptSet.

Définir des objets VARA BACKEND

La définition d'un objet VARA BACKEND se compose des pages suivantes :

• Page Général

• Variables

  Vous permet de définir les paramètres spécifiques aux objets. Certaines sections de cette page sont communes à tous les objets VARA et sont décrites dans des rubriques dédiées :

  • Paramètres des variables, voir ci-après
  • Paramètres
  • Formats et types de données
  • Accès au script
  • Objets VARA du client 0 dans d'autres clients
  • Aperçu, voir ci-après
• Page Gestion des versions
• Page Documentation

Section Paramètres des variables

Spécification du mode d'accès de l'objet VARA au système client dont il récupère les valeurs.

• Agent

  Agent sur lequel la commande est exécutée.

• Appliquer l'agent de la tâche

  Déploie l'agent de la tâche utilisant l'objet VARA. Si la tâche n'a pas d'agent (tel que c'est le cas dans les objets Script, par exemple), c'est l'agent de l'objet VARA qui est utilisé. Si ni l'objet VARA, ni la tâche n'ont un agent, une erreur se produit.

• Login

  Objet Login (LOGIN) permettant à l'objet VARA d'accéder au système d'exploitation cible.

• Appliquer le Login de la tâche

  Déploie le login de la tâche utilisant l'objet VARA.

  Si la tâche n'a pas d'objet Login affecté (tel que c'est le cas dans les objets Script, par exemple), c'est le login affecté à l'objet VARA qui est utilisé. Si ni l'objet VARA, ni la tâche n'ont un objet Login, une erreur se produit.

Remarques :

Les conditions suivantes s'appliquent aux attributs Agent et Login :

• Vous pouvez inclure des variables PromptSet ici, en utilisant la fonction Rechargement dynamique (prompts Liste déroulante) pour les invites de listes déroulantes. Lorsque vous utilisez des variables PromptSet dans un objet Variable dynamique, la fonction d'aperçu renvoie une erreur. La raison en est que les variables PromptSet n'existent pas dans l'objet variable dynamique. Cependant, les variables PromptSet seront résolues lorsque les objets incluant des PromptSet sont exécutés.
• Les Objets VARA BACKEND prédéfinis (modèles) fournis pour les objets VARA Backend utilisent les variables PromptSet &AGENT# pour leur agent et &LOGIN# pour leur login.

Page Commandes

Les objets VARA BACKEND exécutent exactement une commande sur les systèmes d'exploitation cibles. Cela s'applique à la fois à Windows et Unix. Saisissez la commande dans cette page :

• Nom d'OS

  Nom de l'agent du système d'exploitation qui s'affiche dans Perspective Administration (page Agents, colonne Logiciel). Le caractère générique "*" est autorisé.

• Version

  Version de l'agent qui s'affiche dans Perspective Administration (page Agents, colonne Logiciel).

• Commande

  Sous Windows, seules les commandes Powershell sont prises en charge.

  Vous pouvez inclure des variables PromptSet ici, en utilisant la fonction Rechargement dynamique (prompts Liste déroulante) pour les invites de listes déroulantes. Lorsque vous utilisez des variables PromptSet dans un objet Variable dynamique, la fonction d'aperçu renvoie une erreur. La raison en est que les variables PromptSet n'existent pas dans l'objet variable dynamique. Cependant, les variables PromptSet seront résolues lorsque les objets incluant des PromptSet sont exécutés.

• Format de colonne

  Détermine le mode de répartition des colonnes de résultat. Utilisez la syntaxe suivante :

  Nom de colonne  : position de début ( longueur) [ ;nom de colonne :position de début(longueur) . . .]

  Où :

  • Nom de colonne = nom de la colonne, défini par l'utilisateur
  • Position de début = position du caractère à partir duquel la colonne commence.
  • Longueur = nombre de caractères qui détermine la taille de la colonne.

  Important !

  • Le point-virgule (;) ne doit être utilisé qu'entre des colonnes. Un point-virgule n'est pas nécessaire à la fin de la définition.
    
  • Vous devez définir au moins une valeur de colonne (minimum requis).

  Exemple :

  process:1(20);pid:25(10)

  L'exemple précédent répartit le résultat de la commande sur deux colonnes. La colonne process commence au premier caractère et contient 20 caractères, "pid" commence par au 25ème caractère et a une longueur de 10 caractères.

Remarques :

• Windows

  • Les commandes ne sont pas des lignes batch. Vous devez définir un programme spécifique à exécuter.

    Exemples :

    Lister les répertoires : cmd /c dir C:\temp

    Exécuter un ping : ping localhost -n 10

  • Le code retour est automatiquement défini à 1 si une commande se termine en erreur. Dans ce cas, si vous utilisez l'objet VARA à l'intérieur d'un script, le script s'interrompt. Pour éviter ceci, vous pouvez ajouter & set ERRORLEVEL=0 à la fin de la commande Windows. Par exemple :

    cmd /c dir /b /o:d C:\temp\*.xml & set ERRORLEVEL=0

    Cette commande liste les fichiers d'un répertoire. Le code retour est toujours 0, peu importe que les fichiers soient trouvés ou pas. Cela vous permet d'être sûr que les tâches utilisant l'objet VARA ne seront pas interrompues.

• Unix

  L'utilisateur indiqué dans l'objet Login requiert les autorisations correspondantes pour exécuter la commande.

• Windows et Unix

  Les colonnes Nom d'OS et Version vous permettent de filtrer par noms (telle qu'une variante UNIX particulière) et par version du système d'exploitation. La ligne appropriée pour l'agent spécifié est automatiquement utilisée lors de l'exécution de l'objet VARA. La première ligne qui correspond au système d'exploitation, nom d'OS et version de l'agent est utilisée.

• Linux

  Les droits "root" sont requis pour les commandes chkconfig et runlevel.

Aperçu

Vous permet d'exécuter la commande sur l'ordinateur spécifié et de vérifier les résultats.

Objets VARA BACKEND prédéfinis (modèles)

Les objets VARA BACKEND prédéfinis sont fournis dans le client 0 (dossier : UC _RB_VARIABLES). Ils peuvent être utilisés pour la fonctionnalité de Rechargement dynamique (prompts Liste déroulante). Leur agent est le nom de variable &AGENT# et leur login est &LOGIN#. Utilisez ces noms pour les variables PromptSet des éléments requis.

Nom d'objet	Système d'exploitation	Fonction	Colonnes
UC_RB_VARA_PROCESSLIST	Windows, Linux, AIX, SunOS, HP-UX	Liste les processus actifs. La longueur maximale du nom du processus peut différer en fonction du système UNIX correspondant. Ajustez la longueur de la colonne de l'objet variable, si nécessaire.	ProcessID Nom de processus
UC_RB_VARA_SERVICES_PAUSED	Windows, Linux, AIX, SunOS, HP-UX	Liste tous les services suspendus.	Nom du service
UC_RB_VARA_SERVICES_RUNNING	Windows, Linux, AIX, SunOS, HP-UX	Liste tous les services en cours.	Nom du service
UC_RB_VARA_SERVICES_STOPPED	Windows, Linux, AIX, SunOS, HP-UX	Liste tous les services arrêtés.	Nom du service
UC_RB_VARA_USERLIST	Windows, Linux, AIX, SunOS, HP-UX	Liste tous les utilisateurs du système d'exploitation. Windows : Active Directory pour Powershell doit être installé sur l'ordinateur correspondant.	Nom du compte utilisateur

Voir aussi :

• Objets VARA
• Variables et objets VARA