IBM Tivoli Enterprise Console Guide des commandes et des tâches Version 3.9 SC11-1999-00 ��� IBM Tivoli Enterprise Console Guide des commandes et des tâches Version 3.9 SC11-1999-00 ��� Important Avant d’utiliser le présent document et le produit associé, prenez connaissance des informations générales figurant dans la section «Remarques» à la page 187. Première édition - septembre 2003 Réf. US : SC32-1232-00 LE PRESENT DOCUMENT EST LIVRE ″EN L’ETAT″. IBM DECLINE TOUTE RESPONSABILITE, EXPRESSE OU IMPLICITE, RELATIVE AUX INFORMATIONS QUI Y SONT CONTENUES, Y COMPRIS EN CE QUI CONCERNE LES GARANTIES DE QUALITE MARCHANDE OU D’ADAPTATION A VOS BESOINS. Certaines juridictions n’autorisent pas l’exclusion des garanties implicites, auquel cas l’exclusion ci-dessus ne vous sera pas applicable. Ce document est mis à jour périodiquement. Chaque nouvelle édition inclut les mises à jour. Les informations qui y sont fournies sont susceptibles d’être modifiées avant que les produits décrits ne deviennent eux-mêmes disponibles. En outre, il peut contenir des informations ou des références concernant certains produits, logiciels ou services non annoncés dans ce pays. Cela ne signifie cependant pas qu’ils y seront annoncés. Pour plus de détails, pour toute demande d’ordre technique, ou pour obtenir des exemplaires de documents IBM, référez-vous aux documents d’annonce disponibles dans votre pays, ou adressez-vous à votre partenaire commercial. Vous pouvez également consulter les serveurs Internet suivants : v http://www.fr.ibm.com (serveur IBM en France) v http://www.can.ibm.com (serveur IBM au Canada) v http://www.ibm.com (serveur IBM aux Etats-Unis) Compagnie IBM France Direction Qualité Tour Descartes 92066 Paris-La Défense Cedex 50 © Copyright IBM France 2003. Tous droits réservés. © Copyright International Business Machines Corporation 2002,2003. All rights reserved. © Copyright International Business Machines Corporation 2002. All rights reserved. http://www.fr.ibm.comhttp://www.can.ibm.comhttp://www.ibm.com Avis aux lecteurs canadiens Le présent document a été traduit en France. Voici les principales différences et particularités dont vous devez tenir compte. Illustrations Les illustrations sont fournies à titre d’exemple. Certaines peuvent contenir des données propres à la France. Terminologie La terminologie des titres IBM peut différer d’un pays à l’autre. Reportez-vous au tableau ci-dessous, au besoin. IBM France IBM Canada ingénieur commercial représentant agence commerciale succursale ingénieur technico-commercial informaticien inspecteur technicien du matériel Claviers Les lettres sont disposées différemment : le clavier français est de type AZERTY, et le clavier français-canadien de type QWERTY. OS/2 et Windows - Paramètres canadiens Au Canada, on utilise : v les pages de codes 850 (multilingue) et 863 (français-canadien), v le code pays 002, v le code clavier CF. Nomenclature Les touches présentées dans le tableau d’équivalence suivant sont libellées différemment selon qu’il s’agit du clavier de la France, du clavier du Canada ou du clavier des États-Unis. Reportez-vous à ce tableau pour faire correspondre les touches françaises figurant dans le présent document aux touches de votre clavier. © Copyright IBM Corp. 2002 iii Brevets Il est possible qu’IBM détienne des brevets ou qu’elle ait déposé des demandes de brevets portant sur certains sujets abordés dans ce document. Le fait qu’IBM vous fournisse le présent document ne signifie pas qu’elle vous accorde un permis d’utilisation de ces brevets. Vous pouvez envoyer, par écrit, vos demandes de renseignements relatives aux permis d’utilisation au directeur général des relations commerciales d’IBM, 3600 Steeles Avenue East, Markham, Ontario, L3R 9Z7. Assistance téléphonique Si vous avez besoin d’assistance ou si vous voulez commander du matériel, des logiciels et des publications IBM, contactez IBM direct au 1 800 465-1234. iv IBM Tivoli Enterprise Console - Guide des commandes et des tâches Table des matières Avis aux lecteurs canadiens . . . . . . iii Préface . . . . . . . . . . . . . . vii A qui s’adresse ce document . . . . . . . . vii Publications . . . . . . . . . . . . . . vii Bibliothèque IBM Tivoli Enterprise Console . . vii Publications connexes . . . . . . . . . viii Publications en ligne . . . . . . . . . . viii Commande de publications . . . . . . . . viii Comment prendre contact avec le service d’assistance . . . . . . . . . . . . . . ix Participation aux groupes de discussion . . . . . ix Conventions utilisées dans ce document . . . . . x Conventions typographiques . . . . . . . . x Variables et chemins de système d’exploitation . . xi Syntaxe de la ligne de commande . . . . . . xi Chapitre 1. Commandes . . . . . . . . 1 Etablissement de l’environnement Tivoli . . . . . 1 Utilisation des commandes Tivoli . . . . . . . 1 Références d’objet . . . . . . . . . . . . 2 Noms enregistrés . . . . . . . . . . . . 2 Chemins d’objet . . . . . . . . . . . . 3 Commandes Tivoli Enterprise Console . . . . . . 3 Commandes de la console . . . . . . . . . 4 Commandes source . . . . . . . . . . . 4 Commandes de messages d’événements . . . . 4 Commandes du serveur d’événements . . . . . 5 Commandes de la base de règles . . . . . . 5 Commandes de base de données . . . . . . 5 Commandes ACF . . . . . . . . . . . . 6 Commandes d’adaptateur . . . . . . . . . 7 chkclass . . . . . . . . . . . . . . . . 8 postemsg . . . . . . . . . . . . . . . 9 postzmsg . . . . . . . . . . . . . . . 11 tec_console . . . . . . . . . . . . . . 13 TECAgent . . . . . . . . . . . . . . . 16 upgrade_gui.sh . . . . . . . . . . . . . 18 waddac . . . . . . . . . . . . . . . . 19 wchkclass . . . . . . . . . . . . . . . 24 wconsole . . . . . . . . . . . . . . . 25 wcrtdefcfg . . . . . . . . . . . . . . . 39 wcrtebizgroups . . . . . . . . . . . . . 40 wcrtmtgroups . . . . . . . . . . . . . 42 wcrtnvgroups . . . . . . . . . . . . . 43 wcrtsrc . . . . . . . . . . . . . . . . 44 wcrtteccfg . . . . . . . . . . . . . . . 45 wdbconfig.sh . . . . . . . . . . . . . . 46 wdbmaint.sh . . . . . . . . . . . . . . 47 wdelac . . . . . . . . . . . . . . . . 49 wdelsrc . . . . . . . . . . . . . . . . 50 wlsac . . . . . . . . . . . . . . . . 51 wlsaddflt . . . . . . . . . . . . . . . 54 wlsadenv . . . . . . . . . . . . . . . 56 wlsadgui . . . . . . . . . . . . . . . 57 wlsadval . . . . . . . . . . . . . . . 58 wlsaeenv . . . . . . . . . . . . . . . 60 wlsemsg . . . . . . . . . . . . . . . 61 wlsesvrcfg . . . . . . . . . . . . . . . 63 wlssrc . . . . . . . . . . . . . . . . 65 wmigcon . . . . . . . . . . . . . . . 66 wpostemsg (version de noeud final) . . . . . . 69 wpostemsg (version de noeud géré) . . . . . . 71 wpostzmsg (version de noeud final) . . . . . . 73 wpostzmsg (version de noeud géré) . . . . . . 75 wrb . . . . . . . . . . . . . . . . . 77 wrb_default_rb . . . . . . . . . . . . . 94 wrbupgrade . . . . . . . . . . . . . . 95 wsendresp . . . . . . . . . . . . . . . 96 wsetac . . . . . . . . . . . . . . . . 97 wsetaddflt . . . . . . . . . . . . . . 102 wsetadenv . . . . . . . . . . . . . . 108 wsetadgui . . . . . . . . . . . . . . 109 wsetadval . . . . . . . . . . . . . . 111 wsetaeenv . . . . . . . . . . . . . . 113 wsetemsg . . . . . . . . . . . . . . . 116 wsetesvrcfg . . . . . . . . . . . . . . 118 wsetsrc . . . . . . . . . . . . . . . 120 wsighup . . . . . . . . . . . . . . . 121 wstartesvr . . . . . . . . . . . . . . 122 wstartmaint.sh . . . . . . . . . . . . . 123 wstatesvr . . . . . . . . . . . . . . . 124 wstopesvr . . . . . . . . . . . . . . 125 wstopmaint.sh . . . . . . . . . . . . . 126 wstoptecgw . . . . . . . . . . . . . . 127 wtdbclear . . . . . . . . . . . . . . 128 wtdbclear.pl . . . . . . . . . . . . . . 130 wtdbspace . . . . . . . . . . . . . . 132 wtdbstat . . . . . . . . . . . . . . . 134 wtdumper . . . . . . . . . . . . . . 135 wtdumprl . . . . . . . . . . . . . . 137 wtdumptr . . . . . . . . . . . . . . 139 wtecexport . . . . . . . . . . . . . . 141 wtecimport . . . . . . . . . . . . . . 143 wtouchac . . . . . . . . . . . . . . . 146 Chapitre 2. Tâches . . . . . . . . . 147 Noms et scripts des tâches . . . . . . . . . 148 Résultat de la tâche . . . . . . . . . . . 149 Change_Severity . . . . . . . . . . . . 150 Clean_Database . . . . . . . . . . . . 151 Clear_Closed_Events . . . . . . . . . . . 152 Clear_Reception_Log . . . . . . . . . . . 153 Close_Event . . . . . . . . . . . . . . 154 Dump_Event_Repository . . . . . . . . . 155 Event_Query . . . . . . . . . . . . . 157 Find_Similar_Events . . . . . . . . . . . 161 Forward_Event . . . . . . . . . . . . . 163 Log_Event_To_File . . . . . . . . . . . 164 Popup_Message . . . . . . . . . . . . 165 © Copyright IBM Corp. 2002 v Send_Email . . . . . . . . . . . . . . 166 Send_Event . . . . . . . . . . . . . . 167 Start_Maintenance . . . . . . . . . . . . 170 Wake_Up_Netscape . . . . . . . . . . . 173 Chapitre 3. Variables d’environnement disponibles pour les tâches . . . . . 175 Descriptions des variables . . . . . . . . . 175 Exemples . . . . . . . . . . . . . . . 181 Cliché de variable d’environnement lors de l’exécution d’une tâche à partir d’une règle . . 181 Cliché de variable d’environnement lors de l’exécution d’un programme à partir de la console d’événements . . . . . . . . . 182 Annexe. Paramètres de configuration 185 Remarques . . . . . . . . . . . . 187 Marques . . . . . . . . . . . . . . . 189 Index . . . . . . . . . . . . . . . 191 vi IBM Tivoli Enterprise Console - Guide des commandes et des tâches Préface IBM Tivoli Enterprise Console est une application de gestion d’événements basée sur des règles, qui intègre la gestion de réseau, de systèmes, de bases de données et d’applications pour garantir la disponibilité optimale des services informatiques d’une organisation. Le présent document décrit les commandes Tivoli Enterprise Console, les tâches figurant dans la bibliothèque de tâches livrée avec le produit Tivoli Enterprise Console, ainsi que les variables d’environnement associées aux tâches de la bibliothèque de tâches. A qui s’adresse ce document Ce document est destiné aux administrateurs Tivoli Enterprise Console qui souhaitent utiliser l’interface de ligne de commande et configurer les tâches Tivoli Enterprise Console. Le lecteur doit connaître les systèmes et logiciels suivants : v Systèmes d’exploitation utilisés par l’entreprise v Tivoli Management Framework Publications Cette section répertorie les publications contenues dans la bibliothèque de Tivoli Enterprise Console ainsi que les documents associés. Elle explique également comment accéder en ligne aux publications Tivoli et comment les commander. Bibliothèque IBM Tivoli Enterprise Console Les documents suivants sont disponibles dans la bibliothèque de Tivoli Enterprise Console : v IBM Tivoli Enterprise Console Adapters Guide, SC32-1242 Fournit des informations sur les adaptateurs pris en charge, notamment sur la procédure d’installation et de configuration de ces adaptateurs. v IBM Tivoli Enterprise Console - Guide des commandes et des tâches, SC11-1999-00 Fournit des détails sur les commandes Tivoli Enterprise Console, sur les tâches prédéfinies intégrées dans la bibliothèque de tâches et sur les variables d’environnement associées aux tâches qui s’exécutent avec un événement. v IBM Tivoli Enterprise Console - Guide d’installation, SC11-2000-00 Explique comment installer, mettre à niveau et désinstaller le produit Tivoli Enterprise Console. v IBM Tivoli Enterprise Console Release Notes, SC32-1238 Fournit des informations spécifiques à une édition qui ne sont disponibles qu’au moment de la commercialisation du produit. v IBM Tivoli Enterprise Console Rule Developer’s Guide, SC32-1234 Explique comment développer et intégrer des règles pour la corrélation d’événements et la gestion d’événements automatique. v IBM Tivoli Enterprise Console Rule Set Reference, SC32-1282 Fournit des informations de référence sur les jeux de règles Tivoli Enterprise Console. © Copyright IBM Corp. 2002 vii v IBM Tivoli Enterprise Console - Guide d’utilisation, SC11-2001-00 Présente Tivoli Enterprise Console et explique comment configurer et utiliser ce produit pour la gestion des événements. v IBM Tivoli Enterprise Console Warehouse Enablement Pack: Implementation Guide, SC32-1236 Explique comment installer et configurer le module d’activation d’entrepôt de données de Tivoli Enterprise Console et décrit le flux et les structures de données utilisés par ce module. v Tivoli Event Integration Facility Reference, SC32-1241 Explique comment créer des modules de traitement des événements personnalisés, adaptés à votre environnement réseau et aux besoins spécifiques de votre entreprise. Ce manuel de référence explique également comment filtrer des événements à la source. Publications connexes Le glossaire Tivoli définit la plupart des termes techniques liés aux logiciels Tivoli. Il n’est disponible qu’en anglais sur le site Web suivant : http://www.ibm.com/software/tivoli/library/ Pour y accéder, cliquez sur le lien Glossaire dans la sous-fenêtre de gauche de la fenêtre de la bibliothèque de logiciels Tivoli. Publications en ligne Le CD-ROM de documentation contient les publications qui figurent dans la bibliothèque du produit. Les publication sont au format PDF, HTML, ou les deux. Pour savoir comment accéder à la documentation, consultez le fichier readme sur le CD-ROM. IBM affiche sur le site Web du centre d’aide et d’information pour les logiciels Tivoli toutes les publications de ce produit et de tous les autres produits Tivoli, à mesure qu’elles sont disponibles et chaque fois qu’elles sont mises à jour. Pour accéder au centre d’aide et d’information pour les logiciels Tivoli, ouvrez la bibliothèque de logiciels Tivoli à l’adresse Web suivante : http://www.ibm.com/software/tivoli/library/ Faites défiler la page et cliquez sur le lien Product manuals. Dans la liste alphabétique des documents de produits techniques Tivoli, cliquez sur le lien IBM Tivoli Enterprise Console pour accéder à la bibliothèque du produit au centre d’aide et d’information Tivoli. Remarque : Si vous imprimez des documents PDF sur un papier dont le format est autre que le format A4, cochez la case Ajuster dans la fenêtre d’impression d’Adobe Acrobat. Cette option est disponible lorsque vous cliquez sur Fichier → Imprimer. Elle vous permet de vous assurer qu’une page au format A4 s’imprime en intégralité sur le papier que vous utilisez. Commande de publications Vous pouvez commander en ligne plusieurs publications Tivoli sur le site Web suivant : viii IBM Tivoli Enterprise Console - Guide des commandes et des tâches http://www.ibm.com/software/tivoli/library/http://www.ibm.com/software/tivoli/library/ http://www.elink.ibmlink.ibm.com/public/applications/publications/cgibin/pbi.cgi (ou en appelant le numéro 1-800-426-4968, pour le Canada). v Pour les Etats-Unis : 800-879-2755 v Pour le Canada : 800-426-4968 Pour obtenir la liste des numéros de téléphone dans les autres pays, consultez le site Web : http://www.ibm.com/software/tivoli/order-lit/ Comment prendre contact avec le service d’assistance Si un produit Tivoli vous pose problème, accédez au site Web du service d’assistance IBM suivant : http://www.ibm.com/software/sysmgmt/products/support/ Pour prendre contact avec le service d’assistance, reportez-vous au document IBM Software Support Guide sur le site Web suivant : http://techsupport.services.ibm.com/guides/handbook.html Ce document explique comment contacter le service d’assistance IBM en fonction de la gravité de l’incident. Il contient également les informations suivantes : v inscription et droit ; v numéros de téléphone et adresses électroniques (qui varient en fonction des pays) ; v informations à se procurer avant de contacter le service d’assistance IBM. Participation aux groupes de discussion Les groupes d’utilisateurs fournissent aux spécialistes en logiciels un groupe de discussion pour communiquer des idées, les compétences techniques et les expériences liées au produit. Ils se trouvent sur le réseau Internet et sont disponibles à l’aide de programmes de lecture standard. Ces groupes sont essentiellement destinés aux communications entre les utilisateurs et ne remplacent pas le support formel. Pour accéder à un groupe de discussion, utilisez les instructions appropriées de votre navigateur. Les instructions ci-dessous s’appliquent à un navigateur Microsoft Internet Explorer. 1. Ouvrez un navigateur Internet Explorer. 2. Dans le menu Outils, cliquez sur Options Internet. 3. Dans la fenêtre Options Internet, cliquez sur l’onglet Programmes. 4. Dans la liste Groupes de discussion, cliquez sur la flèche vers le bas puis sur Outlook Express. 5. Cliquez sur OK. 6. Refermez le navigateur Internet Explorer, puis ouvrez-le de nouveau. Préface ix http://www.elink.ibmlink.ibm.com/public/applications/publications/cgibin/pbi.cgihttp://www.elink.ibmlink.ibm.com/public/applications/publications/cgibin/pbi.cgihttp://www.ibm.com/software/tivoli/order-lit/http://www.ibm.com/software/sysmgmt/products/support/http://techsupport.services.ibm.com/guides/handbook.html 7. Découpez et collez l’adresse du groupe de discussion d’un produit dans la zone Adresse, puis appuyez sur Entrée pour ouvrir le groupe de discussion. Les instructions ci-dessous s’appliquent à un navigateur Netscape Navigator. 1. Ouvrez un navigateur Netscape Navigator. 2. Dans le menu Edition, cliquez sur Préférences. La fenêtre Préférences s’affiche. 3. Dans la vue Catégorie, cliquez sur Courrier et forum pour afficher les paramètres de courrier et forum. 4. Cochez la case Utilisez Netscape Mail comme application par défaut. 5. Cliquez sur OK. 6. Refermez le navigateur Netscape Navigator, puis ouvrez-le de nouveau. 7. Découpez et collez l’adresse du groupe de discussion d’un produit dans la zone Adresse, puis appuyez sur Entrée pour ouvrir le groupe de discussion. IBM Tivoli Enterprise Console : news://news.software.ibm.com/ibm.software.tivoli.enterprise-console IBM Tivoli NetView pour UNIX et IBM Tivoli NetView pour Windows : news://news.software.ibm.com/ibm.software.tivoli.netview-unix-windows Conventions utilisées dans ce document Plusieurs conventions typographiques sont associées à des actions et à des termes particuliers, à des commandes, à des chemins de système d’exploitation ou à la syntaxe de commande. Conventions typographiques Les conventions typographiques suivantes sont utilisées dans ce document : Gras v Commandes en minuscules et en caractères mixtes difficiles à distinguer du reste du texte v Commandes d’interface (cases à cocher, boutons de fonction, boutons d’option, flèches d’incrément, zones, dossiers, icônes, boîtes à liste, éléments figurant dans les boîtes à liste, listes à plusieurs colonnes, conteneurs, options de menu, noms de menu, onglets, feuilles de propriétés), libellés (tels que Conseil : et Remarques sur le système d’exploitation :) v Mots clés et paramètres dans le texte Italique v Termes définis dans le texte v Mise en évidence des termes (mot pour mot) v Nouveaux termes dans le texte (sauf dans une liste de définition) v Variables et valeurs devant être fournies Espacement fixe v Exemples et exemples de code v Noms de fichier, mots clés de programmation et autres éléments difficiles à distinguer du reste du texte v Texte de message et invites destinés à l’utilisateur x IBM Tivoli Enterprise Console - Guide des commandes et des tâches news://news.software.ibm.com/ibm.software.tivoli.enterprise-consolenews://news.software.ibm.com/ibm.software.tivoli.netview-unix-windows v Texte devant être tapé par l’utilisateur v Valeurs des arguments et options de commande Variables et chemins de système d’exploitation Ce document utilise la convention UNIX pour la spécification des variables d’environnement et des répertoires. Lorsque vous utilisez la ligne de commande sous Windows, remplacez $variable par %variable% lorsqu’il s’agit de variables d’environnement. De même, vous devez remplacer chaque barre oblique (/) par une barre oblique inversée (\) lorsque vous définissez des chemins d’accès aux répertoires. Remarque : Si vous utilisez le shell bash sous Windows, vous pouvez utiliser les conventions UNIX. Syntaxe de la ligne de commande Le présent document utilise les caractères spéciaux suivants pour définir la syntaxe de commande : [ ] Identifie un argument facultatif. Les arguments non placés entre crochets sont obligatoires. ... Indique que vous pouvez spécifier plusieurs valeurs pour l’argument précédent. | Indique des informations qui s’excluent mutuellement. Vous pouvez utiliser l’argument situé à gauche ou à droite du séparateur. Vous ne pouvez pas utiliser les deux arguments dans une seule exécution de la commande. { } Délimite un jeu d’arguments qui s’excluent mutuellement, lorsqu’un des arguments est obligatoire. Si les arguments sont facultatifs, ils sont placés entre crochets ([ ]). Remarques : 1. Un argument peut comporter au maximum 256 caractères. 2. Placez entre apostrophes ou entre guillemets les valeurs d’argument qui contiennent des espaces imbriqués. Par exemple : wsetsrc [–S serveur] [–l libellé] [–n nom] source L’argument source est le seul argument obligatoire de la commande wsetsrc. Les crochets encadrant les autres arguments indiquent que ces derniers sont facultatifs. Voici un autre exemple de commande wlsac : wlsac [–l | –f format] [clé... ] profil Dans cet exemple, les arguments –l et –f format s’excluent mutuellement et sont facultatifs. L’argument profil est obligatoire. L’argument clé est facultatif. De même, les points de suspension (...) qui figurent à la suite de l’argument clé indiquent que vous pouvez spécifier plusieurs noms de clé. Voici un autre exemple de commande wrb –import : Préface xi wrb –import {ensemble_de_règles | jeu_de_règles} ... Dans cet exemple, les arguments ensemble_de_règles et jeu_de_règles s’excluent mutuellement, mais un des arguments doit être indiqué. De même, les points de suspension (...) indiquent que vous pouvez spécifier plusieurs ensembles ou jeux de règles. xii IBM Tivoli Enterprise Console - Guide des commandes et des tâches Chapitre 1. Commandes Le présent chapitre explique comment établir un environnement Tivoli pour l’utilisation des commandes Tivoli et fournit des détails sur chaque commande Tivoli Enterprise Console. Etablissement de l’environnement Tivoli Lors de l’installation de Tivoli Management Framework, deux fichiers de configuration sont créés, permettant d’établir aisément les chemins de recherche et les variables d’environnement corrects. Ces fichiers sont disponibles sur n’importe quel poste client ou serveur de la TMR (Tivoli Management management). Pour configurer l’environnement système UNIX, effectuez les opérations suivantes pour exécuter les commandes Tivoli Enterprise : 1. Connectez-vous à un client Tivoli Enterprise ou au serveur Tivoli Enterprise sur lequel votre administrateur Tivoli Enterprise possède un alias avec le rôle super pour la TMR. Pour plus de détails sur la création d’administrateurs Tivoli Enterprise possédant des rôles d’autorisation pour la région, reportez-vous au document Tivoli Management Framework - Guide de l’utilisateur. 2. Deux scripts d’initialisation et de configuration d’environnement sont disponibles : un pour le shell Bourne et un pour le shell C. Si vous utilisez le shell Bourne, exécutez la commande suivante : . /etc/Tivoli/setup_env.sh Si vous utilisez le shell C, exécutez la commande suivante : source /etc/Tivoli/setup_env.csh Lancez les commandes suivantes à partir d’une invite Windows afin de configurer l’environnement système Windows pour les commandes Tivoli : 1. %SystemRoot%\system32\drivers\etc\Tivoli\setup_env 2. sh Remarque : La deuxième commande est facultative. Certaines commandes Windows correspondent à des scripts et doivent être exécutées avec sh ; la plupart des commandes peuvent être exécutées à partir de la ligne de commande. A présent, votre environnement est prêt à effectuer des opérations Tivoli. Utilisation des commandes Tivoli Utilisez les commandes Tivoli pour effectuer des opérations système à partir d’une ligne de commande et non à l’aide du bureau Tivoli. Il convient généralement d’appeler une opération de l’application de gestion Tivoli à partir de la ligne de commande et non du bureau ; par exemple : v Il se peut que vous n’ayez pas accès à un écran graphique, par exemple, lors de la connexion via une ligne téléphonique ou lors de l’exécution des scripts de maintenance. v Un certain nombre d’opérations vont être regroupés dans un script shell. © Copyright IBM Corp. 2002 1 v Vous utilisez l’éditeur Emacs et préférez rester au clavier plutôt que d’utiliser la souris ; de plus, vous préférez appeler une commande à partir d’un shell. v Une opération n’est pas disponible à partir du bureau Tivoli. La plupart des commandes d’utilisateur final Tivoli commencent par un w qui les identifie comme étant des commandes Tivoli. Les commandes d’utilisateur final Tivoli qui n’utilisent pas de services Tivoli ne commencent pas par un w. La plupart des commandes sont également développées à l’aide d’une syntaxe w+instruction+objet qui correspond à l’opération. Par exemple, pour créer un utilisateur, exécutez la commande wcrtusr. Pour supprimer un utilisateur, exécutez la commande wdelusr. Références d’objet Lorsqu’un objet est référencé à partir d’une commande, la référence ne correspond pas à une “référence d’objet” absolue comme celles utilisées en programmation. En revanche, un nom convivial est utilisé. Ce nom est dérivé d’un nom attribué à l’objet par l’utilisateur de l’application (par exemple, lors de la création d’une région d’administration). Les deux formats de noms suivants peuvent être utilisés avec les commandes de l’interface de ligne de commande : v Noms enregistrés v Chemins d’objet Les programmes de ligne de commande Tivoli prennent en charge les deux formats d’affectation de noms. Il convient parfois d’utiliser un format plutôt qu’un autre. Noms enregistrés Chaque région Tivoli contient un registre de noms. Le registre de noms est une table à deux dimensions qui contient les noms et les types des objets. Les noms enregistrés sont les noms des objets qui peuvent être consultés dans le registre de noms par nom d’instance et par type de ressource. Chaque objet ou ressource possède un nom et un type. Par exemple, une imprimante peut porter le nom apple et posséder le type imprimante. Tous les objets de la région Tivoli devant être consultés doivent être enregistrés dans le registre de noms une fois créés, désenregistrés lors de la suppression, et déplacés lors de la modification de leur libellé. Pour la plupart des ressources du produit Tivoli Enterprise Console, ces opérations sont traitées automatiquement. Pour obtenir une liste complète des types et informations d’échange de ressources, reportez-vous au document IBM Tivoli Management Framework Planning for Deployment Guide. L’utilisation du registre de noms facilite l’échange des ressources entre plusieurs régions Tivoli. Pour plus détails sur les régions Tivoli et les connexions inter-régionales, consultez le document IBM Tivoli Management Framework Planning for Deployment Guide. Utilisez la commande wlookup pour consulter une ressource. Par exemple, pour afficher tous les types de ressources enregistrées, utilisez la commande suivante : 2 IBM Tivoli Enterprise Console - Guide des commandes et des tâches % wlookup –R Pour plus de détails sur la syntaxe de la commande wlookup, consultez le document IBM Tivoli Management Framework Reference Manual. Les autres commandes qui utilisent des noms enregistrés sont wls et wmv. Par exemple, pour afficher la liste des objets sur le bureau de l’administrateur Jerry, entrez la commande suivante : wls @Administrator:jerry où Administrator représente la ressource et jerry l’instance. Chemins d’objet Les chemins d’objet sont similaires aux noms de chemin dans les systèmes de fichiers et peuvent être relatifs ou absolus. Un chemin absolu est un chemin qui commence par une barre oblique (/). Un chemin relatif peut commence par n’importe quel caractère autre qu’une barre oblique (/), y compris les composants de chemins spéciaux du répertoire en cours (.) et du répertoire parent (..). Voici quelques exemples de noms de chemin d’objet utilisés comme arguments pour les commandes wls et wmv : wls /Regions/Servers wmv ../Servers/ayers-rock /Regions/Servers Voici la syntaxe qui permet d’indiquer une ressource à l’aide du style de nom de chemin d’objet : /distinctif/parent/[type:]nom où : distinctif Désigne un type de ressource. parent Désigne le début du nom de chemin d’objet. type Désigne un libellé explicite facultatif. nom Désigne l’instance particulière sur laquelle vous souhaitez effectuer une opération. Utilisez le spécificateur type facultatif lorsque vous devez nommer une ressource particulière portant le même nom qu’une autre ressource dont le type est différent. Par exemple, supposons que la région d’administration Engineering comporte un gestionnaire de profil intitulé Serveurs et une sous-région d’administration intitulée Serveurs. Pour indiquer le gestionnaire de profil à l’aide d’un nom de chemin d’objet, vous pouvez utiliser la commande suivante : wls /Regions/Engineering/ProfileManager:Serveurs Commandes Tivoli Enterprise Console Les sections qui suivent décrivent brièvement les commandes Tivoli Enterprise Console en fonction du composant. Chapitre 1. Commandes 3 Commandes de la console Commande Fonction tec_console Démarre une console d’événements. wconsole Gère des consoles d’événements. wcrtdefcfg Crée une configuration par défaut dans la console d’événements. wcrtebizgroups Crée les groupes e-business dans la console d’événements. wcrtmtgroups Crée un groupe d’événements pour l’affichage des hôtes qui sont en mode maintenance dans la console d’événements. wcrtnvgroups Crée les groupes d’événements requis pour l’utilisation de l’ensemble de règles netview.rls. wcrtteccfg Crée une configuration par défaut pour le produit Tivoli Enterprise Console. wlsemsg Affiche la liste des événements reçus d’une console. Cette commande requiert des services Tivoli Management Framework. wmigcon Permet la migration des consoles Tivoli Enterprise Console version 3.6, des groupes d’événements, des filtres de groupe d’événements et des opérateurs vers les versions 3.7.x, 3.8 et 3.9. wsendresp Affiche une réponse adressée à un administrateur. wsetemsg Modifie un événement. Cette commande requiert des services Tivoli Management Framework. wtecexport Exporte des définitions de console d’événements vers un fichier. wtecimport Importe des définitions de console d’événements d’un fichier vers une région Tivoli différente. Commandes source Commande Fonction wcrtsrc Crée une source sur le serveur d’événements. wdelsrc Supprime une source de la liste des serveurs d’événements. wlssrc Affiche la liste des sources existantes au niveau du serveur d’événements. wsetsrc Réinitialise des attributs de source d’événements. Commandes de messages d’événements Commande Fonction postemsg Affiche un événement sur le serveur d’événements. Cette commande ne requiert pas de services Tivoli Management Framework. postzmsg Affiche un événement sur le serveur d’événements à l’aide d’une communication non Tivoli. TECAgent Affiche un événement sur le serveur d’événements à l’aide d’une communication Tivoli ou non Tivoli. wpostemsg (version de noeud final) Affiche un événement sur le serveur d’événements. Cette commande requiert des services Tivoli Management Framework. wpostemsg (version de noeud géré) Affiche un événement sur le serveur d’événements. Cette commande requiert des services Tivoli Management Framework. 4 IBM Tivoli Enterprise Console - Guide des commandes et des tâches Commande Fonction wpostzmsg (version de noeud final) Affiche un événement sur le serveur d’événements à l’aide d’une communication de noeud final Tivoli avec une passerelle Tivoli Enterprise Console ou à l’aide d’une communication non Tivoli directe avec le serveur d’événements. wpostzmsg (version de noeud géré) Affiche un événement sur le serveur d’événements à l’aide d’une communication de noeud géré Tivoli ou d’une communication non Tivoli. Commandes du serveur d’événements Commande Fonction wlsesvrcfg Affiche les paramètres de configuration d’un serveur d’événements qui est en cours d’exécution. wsetesvrcfg Définit les paramètres de configuration du serveur d’événements. wstartesvr Démarre le serveur d’événements. wstartmaint.sh Informe le serveur d’événements qu’un hôte a été mis en mode maintenance. wstatesvr Affiche l’état du serveur d’événements. wstopesvr Arrête le serveur d’événements. wstopmaint.sh Informe le serveur d’événements qu’un mode de maintenance en cours ou planifié pour une ressource de réseau est en cours d’annulation. Commandes de la base de règles Commande Fonction chkclass Vérifie la validité d’un fichier de définition de classe d’événements par rapport à un répertoire de base de règles. Cette commande permet de développer des classes dans un environnement utilisant des communications non Tivoli. upgrade_gui.sh Met à niveau les règles qui ont été générées par le générateur de règles version 3.6.2 et antérieure vers la syntaxe prise en charge par le compilateur de règles fourni dans cette version de Tivoli Enterprise Console. wchkclass Vérifie la validité d’un fichier de définition de classe d’événements par rapport à un répertoire de base de règles. Cette commande permet de développer des classes dans un environnement Tivoli Enterprise Console. wrb Gère des bases de règles. wrb_default_rb Désactive les jeux de règles actifs de la base de règles par défaut. wrbupgrade Met à niveau des bases de règles et des fichiers BAROC d’événements créés à l’aide des versions de Tivoli Enterprise Console antérieures à la version 3.7 vers le format de la version 3.7 et ultérieure. Commandes de base de données Commande Fonction wdbconfig.sh Exécute les scripts de configuration de base de données générés. wdbmaint.sh Met à jour les statistiques de distribution de données de la base de données et réorganise cette dernière. wtdbclear Permet de supprimer les événements anciens de la base de données des événements. Chapitre 1. Commandes 5 Commande Fonction wtdbclear.pl Permet de supprimer les événements anciens de la base de données des événements. wtdbspace Fournit des statistiques relatives à la base de données. wtdbstat Affiche l’état du serveur de base de données. wtdumper Génère un rapport d’événements traités à partir du référentiel d’événements. wtdumprl Génère un rapport d’événements reçus du journal de réception. wtdumptr Génère un rapport de tâches terminées. Commandes ACF Commande Fonction waddac Ajoute un enregistrement de configuration d’adaptateur dans un profil de configuration d’adaptateur. wdelac Supprime un enregistrement de configuration d’adaptateur d’un profil de configuration d’adaptateur. wlsac Affiche des enregistrements de configuration d’adaptateur à partir d’un profil de configuration d’adaptateur. wlsaddflt Affiche des enregistrements de configuration d’adaptateur à partir d’un profil de configuration d’adaptateur. wlsadenv Affiche une liste installée de variables d’environnement EIF (Event Integration Facility) spécifiques à un adaptateur. wlsadgui Affiche un lien installé vers des outils de configuration étendus spécifiques à un adaptateur. wlsadval Affiche des informations de validation installées concernant un type d’adaptateur. wlsaeenv Affiche les variables d’environnement disponibles au niveau d’un noeud final de profil de configuration d’adaptateur. wsetac Modifie un enregistrement de configuration d’adaptateur existant d’un profil de configuration d’adaptateur. wsetaddflt Ajoute ou définit un enregistrement de configuration d’adaptateur pour un type d’adaptateur par défaut. wsetadenv Installe une liste de variables d’environnement EIF (Event Integration Facility) reconnues pour un type d’adaptateur. wsetadgui Installe un lien à partir de l’interface graphique de l’utilitaire ACF (Adapter Configuration Facility) vers un outil de configuration spécifique. wsetadval Installe des informations de validation pour un type d’adaptateur. wsetaeenv Modifie des variables d’environnement stockées sur des noeuds finaux de profil de configuration d’adaptateur. wstoptecgw Arrête la passerelle Tivoli Enterprise Console. wtouchac Met à jour l’heure de modification sur un enregistrement de profil de configuration d’adaptateur pour forcer la redistribution. 6 IBM Tivoli Enterprise Console - Guide des commandes et des tâches Commandes d’adaptateur Commande Fonction wsighup Recharge les fichiers de configuration et de format pour les adaptateurs de format du journal d’événements Windows et Windows NT. Chapitre 1. Commandes 7 chkclass Vérifie la validité d’un fichier de définition de classe d’événements par rapport à un répertoire de base de règles. Syntaxe chkclass [–k rép_base_règles] fichier_classe Description La commande chkclass permet de garantir la validité d’un fichier de définition de classe d’événements pour le répertoire de base de règles indiqué par l’argument rép_base_règles. L’argument rép_base_règles utilisé avec l’option –k n’est facultatif que si vous n’avez pas défini la variable d’environnement $TEC_KB_DIR (celle-ci n’est pas définie automatiquement). Cette commande permet de développer des classes sur un système sur lequel Tivoli Management Framework n’est pas installé. Remarque : Si Tivoli Management Framework est installé sur votre système, utilisez la commande wchkclass. Classe d’autorisation Aucune Options fichier_classe Indique le chemin d’accès au fichier de définition de classe d’événements à vérifier. L’argument chemin doit indiquer un nom de chemin absolu. –k rép_base_règles Indique le répertoire de base de règles. Par défaut, il s’agit du répertoire défini par la variable d’environnement $TEC_KB_DIR. Exemples L’exemple suivant permet de vérifier le fichier de définition de classe d’événements /install/bin/hpux/TME/TEC /classfile1 pour le répertoire de base de règles indiqué par la variable d’environnement $TEC_KB_DIR : chkclass /install/bin/hpux/TME/TEC/classfile1 Voir aussi wchkclass 8 IBM Tivoli Enterprise Console - Guide des commandes et des tâches postemsg Affiche un événement sur le serveur d’événements à l’aide d’une communication non Tivoli. Syntaxe postemsg –S serveur | –f fichier_configuration [–m message] [–r gravité] [attribut=valeur...] source de classe Description La commande postemsg envoie un événement au serveur d’événements. Cette commande ne requiert pas l’utilisation des services Tivoli Framework et fonctionne dans les environnements dans lesquels des logiciels Tivoli ne sont pas installés. Remarques : 1. Même si cette commande est toujours prise en charge, il convient d’utiliser la commande postzmsg pour envoyer des événements à l’aide d’une communication non Tivoli. 2. Si Tivoli Management Framework est installé sur votre système, vous pouvez utiliser la commande wpostzmsg (version de noeud géré) ou wpostzmsg (version de noeud final). 3. Dans la mesure où les fichiers cache ne peuvent pas être partagés par les applications, vous ne devez pas utiliser pour cette commande un fichier de configuration qui est utilisé par un autre programme (tel qu’un adaptateur). Dans la mesure où cette commande n’a pas accès aux catalogues de messages des modules de support de langue, postemsg affiche les messages d’erreur uniquement en anglais. Classe d’autorisation Aucune Options attribut=valeur Attribue une valeur à tous les attributs valides. Il doit s’agir d’un attribut défini pour la classe d’événements. Séparez les expressions attribut=valeur à l’aide d’espaces. classe Indique la classe de l’événement. Il doit s’agir d’une classe configurée sur le serveur. Les classes sont définies par l’adaptateur et répertoriées dans le fichier BAROC de l’adaptateur. Si le nom de classe comporte des espaces, il doit être placé entre guillemets. source Indique la source de l’événement. Si le nom source comporte des espaces, il doit être placé entre guillemets. –f fichier_configuration Indique le nom du fichier de configuration de l’adaptateur. Vous devez indiquer l’argument –S ou –f. Pour plus d’informations sur les fichiers de configuration, reportez-vous au document IBM Tivoli Enterprise Console Event Integration Facility Reference. –m message Indique le texte de l’événement, placé entre guillemets. Chapitre 1. Commandes 9 –r gravité Indique un niveau de gravité. Il doit s’agir d’une gravité définie pour la classe d’événements. –S serveur Indique le nom d’hôte ou l’adresse IP du serveur. Utilisez cette option uniquement si l’associateur de port est en cours d’exécution sur le serveur d’événements. Vous devez indiquer l’argument –S ou –f. Exemples L’exemple suivant destiné aux environnements UNIX permet d’envoyer un message test qui affiche un événement Su_Failure sur les consoles d’événements : postemsg -S tecbox -r AVERTISSEMENT -m "échec de connexion su." Su_Failure LOGFILE Voir aussi postzmsg, TECAgent, wpostemsg (version de noeud final), wpostemsg (version de noeud géré), wpostzmsg (version de noeud final), wpostzmsg (version de noeud géré), wsetemsg 10 IBM Tivoli Enterprise Console - Guide des commandes et des tâches postzmsg Affiche un événement sur le serveur d’événements à l’aide d’une communication non Tivoli. Syntaxe postzmsg –S serveur | –f fichier_configuration [–m message] [–r gravité] [attribut=valeur...] source de classe Description La commande postzmsg envoie un événement à un serveur d’événements. Cette commande ne requiert pas l’utilisation des services Tivoli Framework et fonctionne dans les environnements dans lesquels des logiciels Tivoli ne sont pas installés. Dans la mesure où cette commande n’a pas accès aux catalogues de messages des modules de support de langue, postzmsg affiche les messages d’erreur uniquement en anglais. Remarques : 1. Si Tivoli Management Framework est installé sur votre système, vous pouvez utiliser la commande wpostzmsg (version de noeud final) ou wpostzmsg (version de noeud géré). 2. Dans la mesure où les fichiers cache ne peuvent pas être partagés par les applications, vous ne devez pas utiliser pour cette commande un fichier de configuration qui est utilisé par un autre programme (tel qu’un adaptateur). Classe d’autorisation Aucune Options attribut=valeur Attribue une valeur à tous les attributs valides. Il doit s’agir d’un attribut défini pour la classe d’événements. Séparez les expressions attribut=valeur à l’aide d’espaces. classe Indique la classe de l’événement. Il doit s’agir d’une classe configurée sur le serveur. Les classes sont définies par l’adaptateur et répertoriées dans le fichier BAROC de l’adaptateur. Si le nom de classe comporte des espaces, il doit être placé entre guillemets. source Indique la source de l’événement. Si le nom source comporte des espaces, il doit être placé entre guillemets. –f fichier_configuration Indique le nom du fichier de configuration. Vous devez indiquer l’argument –S ou –f. Pour plus d’informations sur les fichiers de configuration, reportez-vous au document IBM Tivoli Enterprise Console Event Integration Facility Reference. –m message Texte de l’événement, placé entre guillemets. –r gravité Indique un niveau de gravité. Il doit s’agir d’une gravité définie pour la classe d’événements. Chapitre 1. Commandes 11 –S serveur Indique le nom d’hôte ou l’adresse IP du serveur. Utilisez cette option uniquement si l’associateur de port est en cours d’exécution sur le serveur d’événements. Vous devez indiquer l’argument –S ou –f. Exemples L’exemple suivant destiné aux environnements UNIX permet d’envoyer un message test qui affiche un événement Su_Failure sur les consoles d’événements : postzmsg -S tecbox –r AVERTISSEMENT –m "échec de connexion su." Su_Failure LOGFILE Voir aussi postemsg, TECAgent, wpostemsg (version de noeud final), wpostemsg (version de noeud géré), wpostzmsg (version de noeud final), wpostzmsg (version de noeud géré), wsetemsg 12 IBM Tivoli Enterprise Console - Guide des commandes et des tâches tec_console Permet de démarrer la console d’événements Tivoli Enterprise Console. Syntaxe tec_console [–u idutil] [–p mot_de_passe] [–h nom_hôte[:port]] [–e groupe_événements] [–nowindow] [&] Desc
