Cette section présent la page de manuel disponible pour la commande mfwkadm, qui constitue un utilitaire de maintenance. Les informations ci-dessous sont accessibles dans la section 1M des pages de manuel. Utilisez cette commande pour gérer le contenu d'un agent de noeud, notamment l'ensemble des modules des composants contrôlés et les règles de contrôle, également appelées « tâches », que vous avez définies pour ce noeud. Certains des termes et descriptions de la page de manuel ont été modifiés pour refléter la terminologie utilisée dans le présent manuel.
L'utilitaire mfwkadm est l'interface de ligne de commande que vous pouvez utiliser pour gérer l'agent Monitoring Framework, également appelé « agent de noeud ». L'agent de noeud s'exécute dans le Conteneur d'agents communs. Vous pouvez utiliser la commande mfwkadm pour arrêter et redémarrer l'agent de noeud ou pour gérer les tâches de contrôle que celui-ci exécute. Elle doit être exécutée sur le même hôte que celui de l'agent de noeud. L'ordre des arguments de cette commande présenté dans cette section doit être respecté.
Pour changer la langue dans laquelle s'affichent les messages de sortie, définissez la variable d'environnement LC_MESSAGE sur votre langue. La commande mfwkadm utilise les messages stockés dans le fichier JesmfMessages_ langue.pm qui se trouve dans le répertoire lib/resources. Si aucun fichier de messages n'existe pour votre langue, ou si aucune langue n'est spécifiée, la commande mfwkadm utilise le groupe de messages du fichier JesmfMessages.pm.
L'utilitaire mfwkadm est associé aux sous-commandes suivantes. Celles marquées d'un astérisque (*) nécessite l'exécution du Conteneur d'agents communs et le chargement de l'agent de noeud :
start
stop
restart
list-params (*)
list-modules (*)
info (*)
pm-job (*)
opstat-job (*)
thrsh-job (*)
Suivant le nombre de modules du Conteneur d'agents communs à charger, un délai de quelques secondes à plusieurs minutes peut être observé entre le démarragede l'agent de noeud et la disponibilité de l'utilitaire mfwkadm. Au cours de cette période, les commandes exécutées échouent et un message explicite s'affiche.
Les options suivantes sont prises en charge.
Affiche le résumé des utilisations.
Cette sous-commande démarre l'agent de noeud du composant Monitoring Framework, ainsi que les modules des composants associés, sans arrêter le Conteneur d'agents communs.
Elle procède au déploiement de l'agent de noeud, puis à celui des modules des composants associés dans le Conteneur d'agents communs. Il s'agit d'un utilitaire wrapper qui prévaut sur les sous-commandes lock et unlock de l'utilitaire cacaoadm.
La sous-commande start se limite à démarrer l'agent de noeud et les modules des composants de Java ES associés au composant Monitoring Framework. Les modules des composants ont le préfixe com.sun.cmm.
Sécurité : la sous-commande start peut uniquement être exécutée par l'utilisateur qui a démarré le Conteneur d'agents communs. Si un autre utilisateur l'exécute, le message suivant s'affiche :
Error occured in mfwkadm Problem running /usr/sbin/cacaoadm unlock com.sun.mfwk 2>&1. Stdout/Stderr: This command must be run by user: [root]. |
Cette sous-commande arrête l'agent de noeud Monitoring Framework et les modules des composants de Java ES associés dans le Conteneur d'agents communs.
Elle arrête tout d'abord les modules des composants de Java ES déployés dans le Conteneur d'agents communs, puis l'agent de noeud. Il s'agit d'un utilitaire wrapper qui prévaut sur les sous-commandes lock et unlock de l'utilitaire cacaoadm.
La sous-commande stop arrête uniquement les modules des composants de Java ES qui sont associés au composant Monitoring Framework, puis l'agent de noeud proprement dit. Les modules des composants ont le préfixe com.sun.cmm.
Sécurité : la sous-commande stop peut uniquement être exécutée par l'utilisateur qui a démarré le Conteneur d'agents communs. Si un autre utilisateur l'exécute, le message suivant s'affiche :
Error occured in mfwkadm Problem running /usr/sbin/cacaoadm unlock com.sun.mfwk 2>&1. Stdout/Stderr: This command must be run by user: [root]. |
Cette sous-commande redémarre l'agent de noeud Monitoring Framework et les modules des composants de Java ES dans le Conteneur d'agents communs.
Elle tente d'arrêter, puis de redémarrer l'agent de noeud et les modules qui lui sont associés dans Conteneur d'agents communs de la même façon que les sous-commandes stop et start.
Sécurité : la sous-commande restart peut uniquement être exécutée par l'utilisateur qui a démarré le Conteneur d'agents communs. Si un autre utilisateur l'exécute, le message suivant s'affiche :
Error occured in mfwkadm Problem running //usr/sbin/cacaoadm unlock com.sun.mfwk 2>&1. Stdout/Stderr: This command must be run by user: [root]. |
Cette sous-commande affiche la liste de tous les paramètres de configuration associés à l'agent de noeud Monitoring Framework.
Sécurité : il n'existe aucune restriction d'utilisation pour cette commande.
Cette sous-commande affiche la liste des modules des composants qui implémentent le modèle de contrôle commun (CMM) et qui sont chargés dans le Conteneur d'agents communs. Elle fournit également la liste de toutes les instances en cours d'exécution pour chaque composant de Java ES installé. Pour chaque composant, zéro, une ou plusieurs instances peuvent être en cours d'exécution.
Sécurité :pour les utilisateurs autres que celui qui a démarré le Conteneur d'agents communs, la liste des composants de Java ES installés ne spécifie pas les instances en cours d'exécution des composants.
Cette sous-commande affiche des informations sur l'instance-exécutée désignée. instance-exécutée doit correspondre à une instance en cours d'exécution qui figure dans la liste affichée par la sous-commande list-modules.
Les informations affichées incluent :
Pour chaque type de tâche de contrôle, tous les objets contrôlables associés à l'instance en cours d'exécution, triés par nom de classe. Les objets contrôlables sont ceux pour lesquels vous pouvez créer des tâches de contrôle des performances, des tâches de contrôle de l'état opérationnel ou encore des tâches de contrôle de seuil en utilisant respectivement les sous-commandes pm-job, opstat-job ou thrsh-job.
Pour chaque classe d'objets contrôlables, tous les objets contrôlables associés, avec leur nom et type indiqués.
Sécurité : pour les utilisateurs autres que celui qui a démarré le Conteneur d'agents communs, aucune information n'est affichée.
Cette sous-commande affiche la liste de toutes les classes d'objets actuellement contrôlables pour lesquelles il est possible de créer des tâches de contrôle des performances.
Cette sous-commande affiche la liste de tous les objets actuellement contrôlables pour lesquels il est possible de créer des tâches de contrôle des performances. Par défaut, tous les objets de toutes les classes contrôlables et de tous les domaines sont affichés. La liste des objets est triée par nom de classe.
Si vous spécifiez le paramètre classe-objets optionnel, cela permet de limiter la sortie aux objets contrôlables de la classe désignée. La valeur de classe-objets doit correspondre à l'une des classes qui figure dans la liste affichée par la sous-commande pm-job observable-classes.
Si vous spécifiez le paramètre domaine-objets optionnel, cela permet de limiter la sortie aux objets contrôlables du domaine désigné. Le domaine d'un objet correspond à la chaîne qui précède les deux-points (:) dans le nom de cet objet.
Cette sous-commande affiche la liste de tous les objets contrôlables dans la classe-objets spécifiée. Les attributs sont affichés avec leur nom et type. La valeur de classe-objets doit correspondre à l'une des classes qui prend en charge les tâches de contrôle des performances, telles que listées par la sous-commande pm-job observable-classes.
Cette sous-commande affiche la liste de toutes les tâches de contrôle des performances actuellement définies. Les tâches sont affichées pour chacun des objets auquel est associé une tâche de contrôle des performances. De plus, les objets sont triés par nom de classe. Les informations affichées pour chaque tâche sont identiques à celles obtenues avec la sous-commande pm-job info.
Sécurité : pour les utilisateurs autres que celui qui a démarré le Conteneur d'agents communs, aucune tâche n'est affichée.
Cette sous-commande affiche les informations détaillées relatives à la tâche de contrôle des performances nom-tâche. La valeur de nom-tâche doit correspondre à l'une des tâches affichées par la sous-commande pm-job list. Les informations affichées par cette sous-commande sont les suivantes :
Le nom de la tâche de contrôle des performances.
Le type de la tâche de contrôle des performances, à savoir « par objet » ou par « par classe ».Les tâches de type par objet contrôlent une ou plusieurs instances de l'objet spécifié, tandis que les tâches de type par classe surveillent chaque instance d'une classe d'objets. Notez que la commande mfwkadm ne permet pas de créer des tâches de type par classe.
L'état de la tâche de contrôle des performances : active en fonctionnement, active hors fonctionnement ou suspendue. Une tâche active en fonctionnement est actuellement planifiée pour être exécutée et collecte des données. Une tâche active hors fonctionnement est en cours d'exécution, mais ne collecte aucune donnée car l'heure courante se situe hors de la planification de traitement. Une tâche suspendue n'est pas exécutée et ne collecte aucune donnée. Utilisez les sous-commandes pm-job suspend et pm-job resume pour changer l'état d'exécution d'une tâche de contrôle des performances.
La granularité, exprimée en secondes, de la tâche de contrôle des performances. Il s'agit de l'intervalle défini pour la collecte des données effectuée par cette tâche.
La période de compte rendu définie pour la tâche de contrôle. La période de compte rendu multipliée par la granularité donne la fréquence de notification. Par exemple, si la période de granularité est définie sur 10 secondes et la période de compte rendu sur 6, un compte rendu de tâche par événement collectera les données toutes les 10 secondes et enverra une notification comprenant 6 comptes rendus toutes les 60 secondes (10*6). Si la tâche effectue également un compte rendu par fichier, elle enverra un événement toutes les 60 secondes avec l'emplacement des 6 fichiers générés.
Si la tâche de contrôle des performances effectue un compte rendu par événement. Cela signifie que les résultats de la tâche de contrôle des performances sont envoyés sous forme de notifications à un client enregistré.
Si la tâche de contrôle des performances effectue un compte rendu par fichier. Cela signifie que les comptes rendus de la tâche de contrôle des performances sont écrits dans des fichiers locaux et que les notifications contenant les noms de fichiers sont envoyées aux clients enregistrés.
Le format du compte rendu de la tâche de contrôle des performances, qui est toujours XML.
La planification de la tâche de contrôle des performances. La planification définit les jours et les heures auxquels la tâche est active en fonctionnement ou active hors fonctionnement (et collecte ou non des données, respectivement).
Puis, pour une tâche de type par objet :
La liste des objets contrôlés, triée par nom.
Si seul un sous-ensemble d'attributs contrôlables est spécifié, les attributs contrôlés des objets contrôlés sont listés par nom et par type.
Et, pour une tâche de type par classe :
La liste des tâches contrôlés, triée par nom.
Si seul un sous-ensemble d'attributs contrôlables est spécifié, les attributs contrôlés des classes contrôlées sont listés par nom et par type. Ces attributs sont communs à toutes les classes.
Sécurité : pour les utilisateurs autres que celui qui a démarré le Conteneur d'agents communs, aucune information n'est affichée.
Cette sous-commande crée une nouvelle tâche de contrôle des performances d'un ou plusieurs objets. La commande mfwkadm ne permet pas de créer des tâches par classe. Lors de la création de tâches de contrôle des performances, les paramètres suivants peuvent être définis :
Chaîne qui identifie de façon unique la tâche de contrôle des performances. Le paramètre nom-tâche ne peut pas etre déjà utilisé par une autre tâche quelconque de contrôle des performances.
Intervalle exprimé en secondes qui sépare le début de deux collectes successives de données de mesure alors que la tâche est active en fonctionnement. La période de granularité peut être définie sur 300 secondes (5 minutes), 900 secondes (15 minutes), 1800 secondes (toutes les demi-heures), 3600 secondes (toutes les heures). Une période de granularité de 300 secondes est convient dans la plupart des cas. Pour certaines mesures, l'utilisation de périodes de granularité plus longues pour la collecte des données peut cependant être plus significative.
Un ou plusieurs objets contrôlables pour lesquels la tâche de contrôle des performances doit collecter des données et fournir un compte rendu. La valeur de nom-objet doit correspondre à l'un des noms affichés par les sous-commandes pm-job list ou pm-job observable-objects. Si vous spécifiez plusieurs paramètres object= nom-objet, une seule tâche de contrôle des performances est créée pour plusieurs objets.
Sécurité : cette sous-commande peut uniquement être exécutée par l'utilisateur qui a démarré le Conteneur d'agents communs.
Cette sous-commande supprime la tâche de contrôle des performances nom-tâche. La valeur de nom-tâche doit correspondre à l'une des tâches affichées par la sous-commande pm-job list.
Sécurité : cette sous-commande peut uniquement être exécutée par l'utilisateur qui a démarré le Conteneur d'agents communs.
Cette sous-commande suspend la tâche de contrôle des performances nom-tâche. Une tâche suspendue n'est pas active et ne collecte aucune donnée, quelle que soit sa planification. Elle reste toutefois définie et peut être réactivée via l'utilisation de la sous-commande pm-job resume. La valeur de nom-tâche doit correspondre à l'une des tâches affichées par la sous-commande pm-job list.
Sécurité : cette sous-commande peut uniquement être exécutée par l'utilisateur qui a démarré le Conteneur d'agents communs.
Cette sous-commande reprend l'exécution de la tâche de contrôle des performances nom-tâche. Une tâche dont l'exécution est reprise commencera à collecter des données et à envoyer des comptes rendus en fonction de sa planification. La valeur de nom-tâche doit correspondre à l'une des tâches affichées par la sous-commande pm-job list. Cette sous-commande est l'homologue de la sous-commande pm-job suspend.
Sécurité : cette sous-commande peut uniquement être exécutée par l'utilisateur qui a démarré le Conteneur d'agents communs.
Cette sous-commande affiche la liste de toutes les classes d'objets actuellement contrôlables pour lesquelles il est possible de créer des tâches de contrôle de l'état opérationnel.
Cette sous-commande affiche la liste de tous les objets actuellement contrôlables pour lesquels il est possible de créer des tâches de contrôle de l'état opérationnel. Par défaut, tous les objets de toutes les classes contrôlables et de tous les domaines sont affichés. La liste des objets est triée par nom de classe.
Si vous spécifiez le paramètre classe-objets optionnel, cela permet de limiter la sortie aux objets contrôlables de la classe désignée. La valeur de classe-objets doit correspondre à l'une des classes qui figurent dans la liste affichée par la sous-commande opstat-job observable-classes.
Si vous spécifiez le paramètre domaine-objets optionnel, cela permet de limiter la sortie aux objets contrôlables du domaine désigné. Le domaine d'un objet correspond à la chaîne qui précède les deux-points (:) dans le nom de cet objet.
Cette sous-commande affiche la liste de tous les objets contrôlables dans la classe-objets spécifiée. Les attributs sont affichés avec leur nom et type. La valeur de classe-objets doit correspondre à l'une des classes qui figurent dans la liste affichée par la sous-commande opstat-job observable-classes.
Cette sous-commande affiche la liste de toutes les tâches de contrôle de l'état opération actuellement définies. Les tâches sont affichées pour chacun des objets auquel est associé une tâche de contrôle de l'état opérationnel. De plus, les objets sont triés par nom de classe. Les informations affichées pour chaque tâche sont identiques à celles obtenues avec la sous-commande opstat-job info.
Sécurité : pour les utilisateurs autres que celui qui a démarré le Conteneur d'agents communs, aucune tâche n'est affichée.
Cette sous-commande affiche les informations détaillées relatives à la tâche de contrôle de l'état opérationnel nom-tâche. La valeur de nom-tâche doit correspondre à l'une des tâches affichées par la sous-commande opstat-job list. Les informations affichées par cette sous-commande sont les suivantes :
Le nom de la tâche de contrôle de l'état opérationnel.
Le type de la tâche de contrôle de l'état opérationnel, à savoir « par objet » ou par « par classe ».Les tâches de type par objet contrôlent une instance de l'objet spécifié, tandis que les tâches de type par classe surveillent chaque instance d'une classe d'objets. Notez que la commande mfwkadm ne permet pas de créer des tâches de type par classe.
L'état de la tâche de contrôle de l'état opérationnel : active en fonctionnement, active hors fonctionnement ou suspendue. Une tâche active en fonctionnement est actuellement planifiée pour être exécutée et collecte des données. Une tâche active hors fonctionnement est en cours d'exécution, mais ne collecte pas de données car l'heure courante est en dehors de la planification de traitement. Une tâche suspendue n'est pas exécutée et ne collecte aucune donnée. Utilisez les sous-commandes opstat-job suspend et opstat-job resume pour changer l'état d'exécution d'une tâche de contrôle de l'état opérationnel.
La granularité, exprimée en secondes, de la tâche de contrôle de l'état opérationnel. Il s'agit de l'intervalle défini pour la collecte des données effectuée par cette tâche.
Si la tâche de contrôle de l'état opérationnel effectue un compte rendu par événement. Cela signifie que les résultats de la tâche de contrôle de l'état opérationnel sont envoyés sous forme de notifications à un client enregistré.
Si la tâche de contrôle de l'état opérationnel effectue un compte rendu par fichier. Cela signifie que les comptes rendus de la tâche de contrôle de l'état opérationnel sont écrits dans des fichiers locaux et que les notifications contenant les noms de fichiers sont envoyées aux clients enregistrés.
Le format du compte rendu de la tâche de contrôle de l'état opérationnel, qui est toujours XML.
La planification de la tâche de contrôle de l'état opérationnel. La planification définit les jours et les heures auxquels la tâche est active en fonctionnement ou active hors fonctionnement (et collecte ou non des données, respectivement).
Pour une tâche de type par objet, la liste des objets contrôlés, triée par nom.
Pour une tâche de type par classe, la liste des classes contrôlées, triée par nom.
Sécurité : pour les utilisateurs autres que celui qui a démarré le Conteneur d'agents communs, aucune information n'est affichée.
Cette sous-commande crée une nouvelle tâche de contrôle de l'état opérationnel d'un ou plusieurs objets. La commande mfwkadm ne permet pas de créer des tâches par classe. Lors de la création de tâches de contrôle des performances, les paramètres suivants peuvent être définis :
Chaîne qui identifie de façon unique la tâche de contrôle de l'état opérationnel. Le paramètre nom-tâche ne peut pas etre déjà utilisé par une autre tâche quelconque de contrôle de l'état opérationnel.
Intervalle exprimé en secondes qui sépare le début de deux collectes successives de données de mesure alors que la tâche est active en fonctionnement.
Un ou plusieurs objets contrôlables pour lesquels la tâche de contrôle de l'état opérationnel doit collecter des données et fournir un compte rendu. La valeur de nom-objet doit correspondre à l'un des noms affichés par les sous-commandes opstat-job list ou opstat-job observable-objects. Si vous spécifiez plusieurs paramètres object=nom-objet, une seule tâche de contrôle de l'état opérationnel est créée pour plusieurs objets.
Sécurité : cette sous-commande peut uniquement être exécutée par l'utilisateur qui a démarré le Conteneur d'agents communs.
Cette sous-commande supprime la tâche de contrôle de l'état opérationnel nom-tâche. La valeur de nom-tâche doit correspondre à l'une des tâches affichées par la sous-commande opstat-job list.
Sécurité : cette sous-commande peut uniquement être exécutée par l'utilisateur qui a démarré le Conteneur d'agents communs.
Cette sous-commande suspend la tâche de contrôle de l'état opérationnel nom-tâche. Une tâche suspendue n'est pas active et ne collecte aucune donnée, quelle que soit sa planification. Elle reste toutefois définie et peut être réactivée via l'utilisation de la sous-commande opstat-job resume. La valeur de nom-tâche doit correspondre à l'une des tâches affichées par la sous-commande opstat-job list.
Sécurité : cette sous-commande peut uniquement être exécutée par l'utilisateur qui a démarré le Conteneur d'agents communs.
Cette sous-commande reprend l'exécution la tâche de contrôle de l'état opérationnel nom-tâche. Une tâche dont l'exécution est reprise commencera à collecter des données et à envoyer des comptes rendus en fonction de sa planification. La valeur de nom-tâche doit correspondre à l'une des tâches affichées par la sous-commande opstat-job list. Cette sous-commande est l'homologue de la sous-commande opstat-job suspend.
Sécurité : cette sous-commande peut uniquement être exécutée par l'utilisateur qui a démarré le Conteneur d'agents communs.
Cette sous-commande affiche la liste de toutes les classes d'objets actuellement contrôlables pour lesquelles il est possible de créer des tâches de contrôle des valeurs seuil.
Cette sous-commande affiche la liste de tous les objets actuellement contrôlables pour lesquels il est possible de créer des tâches de contrôle des valeurs seuil. Par défaut, tous les objets de toutes les classes contrôlables et de tous les domaines sont affichés. La liste des objets est triée par nom de classe.
Si vous spécifiez le paramètre classe-objets optionnel, cela permet de limiter la sortie aux objets contrôlables de la classe désignée. La valeur de classe-objets doit correspondre à l'une des classes qui figurent dans la liste affichée par la sous-commande thrsh-job observable-classes.
Si vous spécifiez le paramètre domaine-objets optionnel, cela permet de limiter la sortie aux objets contrôlables de le domaine désigné. Le domaine d'un objet correspond à la chaîne qui précède les deux-points (:) dans le nom de cet objet.
Cette sous-commande affiche la liste de tous les objets contrôlables dans la classe-objets spécifiée. Les attributs sont affichés avec leur nom et type. La valeur de classe-objets doit correspondre à l'une des classes qui figurent dans la liste affichée par la sous-commande thrsh-job observable-classes.
Cette sous-commande affiche la liste de toutes les tâches de contrôle des valeurs seuil actuellement définies. Les tâches sont affichées pour chacun des objets auquel est associé une tâche de contrôle des valeurs seuil. De plus, les objets sont triés par nom de classe. Les informations affichées pour chaque tâche sont identiques à celles obtenues avec la sous-commande thrsh-job info.
Sécurité : pour les utilisateurs autres que celui qui a démarré le Conteneur d'agents communs, aucune tâche n'est affichée.
Cette sous-commande affiche les informations détaillées relatives à la tâche de contrôle des valeurs seuil nom-tâche. La valeur de nom-tâche doit correspondre à l'une des tâches affichées par la sous-commande thrsh-job list. Les informations affichées par cette sous-commande sont les suivantes :
Le nom de la tâche de contrôle des valeurs seuil.
La multiplicité de la tâche de contrôle des valeurs seuil. Cette version prend uniquement en charge des tâches de contrôle des valeurs seuil simples qui surveillent un attribut d'un seul objet.
L'état de la tâche de contrôle des valeurs seuil : active en fonctionnement, active hors fonctionnement ou suspendue. Une tâche active en fonctionnement est actuellement planifiée pour être exécutée et collecte des données. Une tâche active hors fonctionnement est en cours d'exécution, mais ne collecte pas de données car l'heure courante est en dehors de la planification de traitement. Une tâche suspendue n'est pas exécutée et ne collecte aucune donnée. Utilisez les sous-commandes thrsh-job suspend et thrsh-job resume pour changer l'état d'exécution d'une tâche de contrôle des valeurs seuil.
La granularité, exprimée en secondes, de la tâche de contrôle des valeurs seuil. Il s'agit de l'intervalle défini pour la collecte des données effectuée par cette tâche.
La planification de la tâche de contrôle des valeurs seuil. La planification définit les jours et les heures auxquels la tâche est active en fonctionnement ou active hors fonctionnement (et collecte ou non des données, respectivement).
La configuration de l'alarme pour la tâche de contrôle des valeurs seuil. Il s'agit de l'alarme qui sera déclenchée si la valeur observée de l'attribut contrôlé dépasse la valeur seuil définie. Le type et la gravité de l'alarme sont également affichés.
L'objet contrôlé par la tâche de contrôle des valeurs seuil.
Le nom de l'attribut auquel le seuil s'applique.
La valeur du seuil sur lequel est basé le déclenchement de l'alarme.
La direction de la progression de la valeur pour laquelle une alarme sera déclenchée en cas de dépassement du seuil, à savoir ÉLÉVATION ou CHUTE.
Le décalage de tolérance pour le seuil. Lorsque la direction définie est ÉLÉVATION, l'alarme est redéclenchée lorsque la valeur de l'attribut contrôlé est inférieure à valeur-seuil-valeur-décalage. Lorsque la direction définie est CHUTE, l'alarme est redéclenchée lorsque la valeur de l'attribut contrôlé est supérieure à valeur-seuil+valeur-décalage. Ce comportement s'applique même si la valeur du décalage est égale à zéro.
Sécurité : pour les utilisateurs autres que celui qui a démarré le Conteneur d'agents communs, aucune information n'est affichée.
Cette sous-commande crée une nouvelle tâche de contrôle des valeurs seuil qui surveille un attribut d'un seul objet. Lors de la création des tâches de contrôle des valeurs seuil, les paramètres suivants peuvent être définis :
Chaîne qui identifie de façon unique la tâche de contrôle des valeurs seuil. Le paramètre nom-tâche ne peut pas etre déjà utilisé par une autre tâche quelconque de contrôle des valeurs seuil.
Objet contrôlable pour lequel la tâche de contrôle des valeurs seuil collectera les valeurs de l'attribut afin de les comparer à la valeur seuil définie. La valeur de nom-objet doit correspondre à l'un des noms affichés par les sous-commandes thrsh-job list ou thrsh-job observable-objects.
Intervalle exprimé en secondes qui sépare le début de deux coontrôles successifs de la valeur de l'attribut alors que la tâche est active en fonctionnement.
Nom de l'attribut pour lequel la tâche de contrôle des valeurs seuil collecte les valeurs qu'elle compare à la valeur seuil. La valeur de nom-attribut doit correspondre à l'un des noms affichés par les sous-commandes thrsh-job list ou thrsh-job observable-objects.
Type de l'attribut contrôlable à contrôler. La valeur de type-attribut doit figurer dans la liste affichée par les sous-commandes thrsh-job info et thrsh-job observable-attributes.
Valeur de l'atribut contrôlé pour laquelle cette tâche de contrôle des valeurs seuil déclenchera une alarme en cas de dépassement dans la direction spécifiée par direction-seuil.
La valeur de valeur-décalage détermine la tolérance de la tâche de contrôle des valeurs seuil pour le déclenchement d'alarmes successives. La valeur de valeur-décalage doit être égale à zéro ou à une valeur positive. Après le déclenchement d'un premier événement d'alarme, une autre alarme est déclenchée lorsque la valeur de l'attribut contrôlé se trouve hors de la plage définie par valeur-décalage et direction-seuil.
Lorsque la direction définie est ÉLÉVATION, un événement d'alarme est redéclenché lorsque la valeur de l'attribut contrôlé est inférieure à valeur-seuil-valeur-décalage. Lorsque la direction définie est CHUTE, un événement d'alarme est redéclenché lorsque la valeur de l'attribut contrôlé est supérieure à valeur-seuil+valeur-décalage. Ce comportement s'applique même si la valeur de valeur-décalage est égale à zéro.
Sécurité : cette sous-commande peut uniquement être exécutée par l'utilisateur qui a démarré le Conteneur d'agents communs.
Cette sous-commande supprime la tâche de contrôle des valeurs seuil nom-tâche. La valeur de nom-tâche doit correspondre à l'une des tâches affichées par la sous-commande thrsh-job list.
Sécurité : cette sous-commande peut uniquement être exécutée par l'utilisateur qui a démarré le Conteneur d'agents communs.
Cette sous-commande suspend la tâche de contrôle des valeurs seuil nom-tâche. Une tâche suspendue n'est pas active et ne collecte aucune donnée, quelle que soit sa planification. Elle reste toutefois définie et peut être réactivée via l'utilisation de la sous-commande thrsh-job resume. La valeur de nom-tâche doit correspondre à l'une des tâches affichées par la sous-commande thrsh-job list.
Sécurité : cette sous-commande peut uniquement être exécutée par l'utilisateur qui a démarré le Conteneur d'agents communs.
Cette sous-commande reprend l'exécution de la tâche de contrôle des valeurs seuil nom-tâche. Une tâche dont l'exécution est reprise commencera à collecter des données et à envoyer des comptes rendus en fonction de sa planification. La valeur de nom-tâche doit correspondre à l'une des tâches affichées par la sous-commande thrsh-job list. Cette sous-commande est l'homologue de la sous-commande thrsh-job suspend.
Sécurité : cette sous-commande peut uniquement être exécutée par l'utilisateur qui a démarré le Conteneur d'agents communs.
Le scénario fictif suivant montre comment utiliser la commande mfwkadm avec ses options et sous-commandes associées.
La sous-commande list-modules affiche les instances des composants de Java ES sur l'hôte courant avec les modules correspondants dans le Conteneur d'agents communs. L'exemple ci-dessous présente la liste de deux composants installés : Directory Server pour lequel aucune instance n'est en cours d'exécution et Web Server pour lequel une seule instance existe.
$ mfwkadm list-modules Installed products and their running instances: ============================================== Instances for installed product: com.sun.cmm.ds:collectionID=/opt/SUNWdsee/ds6, name=Sun Java(TM) System Directory Server,type=CMM_InstalledProduct ------------------------------- No instance. Instances for installed product: com.sun.cmm.ws:collectionID=/var/opt/SUNWwbsvr7, name=WebServer,type=CMM_InstalledProduct ------------------------------- /wsPrefix/com.sun.cmm.ws:name=https-hostname.example.com,type=CMM_ApplicationSystem |
La sous-commande info suivante affiche les objets contrôlables dans l'instance Web Server, avec les classes et les attributs pour chaque type de tâche.
$ mfwkadm info /wsPrefix/com.sun.cmm.ws:name=https-hostname.example.com,\\ type=CMM_ApplicationSystem Information about running instance: /wsPrefix/com.sun.cmm.ws: name=https-hostname.example.com,type=CMM_ApplicationSystem ================================== Observable objects for performance jobs: --------------------------------------- + Objects of class: com.sun.cmm.settings.CMM_ApplicationSystemSetting /wsPrefix/com.sun.cmm.ws:name=https-hostname.example.com-setting, type=CMM_ApplicationSystemSetting Observable attributes: Caption [STRING] ConfigurationDirectory [STRING] CreationClassName [STRING] Description [STRING] DirectoryName [STRING] ElementName [STRING] InstanceID [STRING] Name [STRING] URL [STRING] + Objects of class: com.sun.cmm.settings.CMM_KeepAliveSetting /wsPrefix/com.sun.cmm.ws:name=process-1-keepalive-setting, type=CMM_KeepAliveSetting Observable attributes: AllocationUnit [STRING] Caption [STRING] ConnectionsUpperBound [LONG] CreationClassName [STRING] Description [STRING] ElementName [STRING] InputUnit [STRING] InstanceID [STRING] LowerAllocationLimit [LONG] LowerInputLimit [LONG] LowerOutputLimit [LONG] Name [STRING] OtherAllocationUnit [STRING] OtherInputUnit [STRING] OtherLowerAllocationLimit [LONG] OtherLowerInputLimit [LONG] OtherLowerOutputLimit [LONG] OtherOutputUnit [STRING] OtherUpperAllocationLimit [LONG] OtherUpperInputLimit [LONG] OtherUpperOutputLimit [LONG] OutputUnit [STRING] QueuedUpperBound [LONG] SecondsTimeout [LONG] TimeoutUpperBound [LONG] UpperAllocationLimit [LONG] UpperInputLimit [LONG] UpperOutputLimit [LONG] ... |
La commande suivante affiche la liste des tâches de contrôle des performances définies. Dans cet exemple, il n'y a qu'une seule tâche de contrôle des performances appelée myPerfJob qui surveille un seul objet :
$ mfwkadm pm-job list BY_OBJECTS performance jobs: =========================== Performance job information for: myPerfJob ------------------------------- Type: BY_OBJECTS State: ACTIVE_ON_DUTY Granularity period: 30 Reporting period: 1 By event: EVENT_SINGLE By file: EVENT_SINGLE Report format: XML Schedule: Global start time: Immediately Global stop time: Forever Weekly schedule: Everyday Daily schedule: All day Observed objects: /wsPrefix/com.sun.cmm.ws:name=virtualServer-hostname.example.com- webApp-/-stats,type=CMM_VirtualServerWebModuleStats Observed attributes: All available BY_CLASSES performance jobs: =========================== No jobs found. |
La commande suivante crée une tâche de contrôle de l'état opérationnel pour deux objets contrôlables dont le nom a été obtenu à l'aide des sous-commandes opstat-job info et opstat-job observable-objects :
$ mfwkadm opstat-job create myOpStatJob granularity=60 \\ object=/wsPrefix/com.sun.cmm.ws:name=process-1,type=CMM_UnixProcess \\ object=/wsPrefix/com.sun.cmm.ws:name=process-1-DNSCache1,type=CMM_DnsCache |
La commande suivante suspend l'exécution de la tâche créée ci-dessus :
$ mfwkadm opstat-job suspend myOpStatJob |
La commande suivante affiche les classes contrôlables pour d'éventuelles tâches de contrôle des valeurs seuil :
$ mfwkadm thrsh-job observable-classes Threshold jobs observable classes: ================================= com.sun.cmm.cim.CIM_ScopedSettingData com.sun.cmm.cim.CIM_SettingData com.sun.cmm.cim.CIM_StatisticalData com.sun.cmm.cim.statistics.CIM_EthernetPortStatistics com.sun.cmm.cim.statistics.CIM_NetworkPortStatistics com.sun.cmm.cim.statistics.j2ee.CIM_J2eeJVMStats com.sun.cmm.cim.statistics.j2ee.CIM_J2eeStatistic com.sun.cmm.settings.CMM_ApplicationSystemSetting com.sun.cmm.settings.CMM_KeepAliveSetting com.sun.cmm.settings.CMM_QueueTimeoutSetting com.sun.cmm.settings.CMM_RFC2788ApplicationSystemSetting com.sun.cmm.settings.CMM_ScopedSettingData com.sun.cmm.settings.CMM_SoftwareResourceSetting com.sun.cmm.settings.CMM_SWRBufferSetting com.sun.cmm.settings.CMM_SWRLimitSetting com.sun.cmm.settings.CMM_SWRQueueSetting com.sun.cmm.settings.CMM_VirtualServerSetting com.sun.cmm.statistics.CMM_ApplicationSystemStats com.sun.cmm.statistics.CMM_ApplicationSystemWatchdogStats com.sun.cmm.statistics.CMM_ConnectionQueueStats com.sun.cmm.statistics.CMM_DnsCacheStats com.sun.cmm.statistics.CMM_EthernetPortStats com.sun.cmm.statistics.CMM_FileCacheStats com.sun.cmm.statistics.CMM_HTTPResponsesStats com.sun.cmm.statistics.CMM_JVMJSR174ExtStats com.sun.cmm.statistics.CMM_JVMJSR174Stats com.sun.cmm.statistics.CMM_JVMStats com.sun.cmm.statistics.CMM_NetworkPortStats com.sun.cmm.statistics.CMM_OperatingSystemStats com.sun.cmm.statistics.CMM_ProcessorStats com.sun.cmm.statistics.CMM_ProcessStats com.sun.cmm.statistics.CMM_QueueTimeoutStats com.sun.cmm.statistics.CMM_RFC2788ApplicationTableStats com.sun.cmm.statistics.CMM_ServiceStats com.sun.cmm.statistics.CMM_SoftwareResourceStats com.sun.cmm.statistics.CMM_SolarisEthernetPortStats com.sun.cmm.statistics.CMM_SolarisNetworkPortStats com.sun.cmm.statistics.CMM_SolarisOperatingSystemStats com.sun.cmm.statistics.CMM_SolarisProcessorStats com.sun.cmm.statistics.CMM_SolarisProcessorSysinfoStats com.sun.cmm.statistics.CMM_SolarisProcessorVmStats com.sun.cmm.statistics.CMM_Statistic com.sun.cmm.statistics.CMM_SWRBufferStats com.sun.cmm.statistics.CMM_SWRCacheStats com.sun.cmm.statistics.CMM_SWRLimitStats com.sun.cmm.statistics.CMM_SWRQueueStats com.sun.cmm.statistics.CMM_UnixOperatingSystemStats com.sun.cmm.statistics.CMM_UnixProcessStats com.sun.cmm.statistics.CMM_VirtualServerWebModuleStats com.sun.cmm.statistics.CMM_WebModuleStats |
La commande suivante affiche les attributs contrôlables pour les tâches de contrôle des valeurs seuil qui surveillent les objets de la classe com.sun.cmm.statistics.CMM_SWRQueueStats trouvée à l'exemple précédent :
$ mfwkadm thrsh-job observable-attributes \\ class=com.sun.cmm.statistics.CMM_SWRQueueStats Threshold jobs observable attributes: ==================================== Class: com.sun.cmm.statistics.CMM_SWRQueueStats Attributes: BufferSize [LONG] EntriesCount [LONG] EntriesHighWaterMark [LONG] EntriesLowWaterMark [LONG] EntriesTotal [LONG] ErrorCount [INTEGER] FailedOperations [LONG] LowerLimit [LONG] OperationsCount [LONG] OtherLowerLimit [LONG] OtherUpperLimit [LONG] OverflowsCount [LONG] QueuedCount [LONG] QueuedHighWater [LONG] SampleInterval [LONG] TotalQueuedCount [LONG] UpperLimit [LONG] |
La commande suivante est un autre exemple de création de tâche, mais cette fois pour le contrôle des valeurs seuil :
$ mfwkadm thrsh-job create myThreshJob granularity=30 \\ object=/wsPrefix/com.sun.cmm.ws:name=process-1-threadPool-NativePool-stats,\\ type=CMM_SWRQueueStats attributeName=EntriesCount attributeType=LONG \\ thresholdValue=1000 thresholdOffset=10 thresholdDirection=RISING |
L'exemple ci-dessous reproduit la sortie de la sous-commande thrsh-job info pour la tâche de contrôle des valeurs seuil créée à l'exemple précédemment :
$ mfwkadm thrsh-job info myThreshJob Threshold job information for: myThreshJob ----------------------------- Type: SIMPLE State: ACTIVE_ON_DUTY Granularity period: 30 Schedule: Global start time: Immediately Global stop time: Forever Weekly schedule: Everyday Daily schedule: All day Alarm configuration: Type: QualityOfServiceAlarm Severity: INDETERMINATE Threshold definition(s): Object: /wsPrefix/com.sun.cmm.ws:name=process-1-threadPool- NativePool-stats,type=CMM_SWRQueueStats Attribute: EntriesCount [LONG] Value: 1000 Direction: RISING Offset: 10 |
Les valeurs de sortie suivantes sont retournées :
Exécution réussie
Une erreur est survenue.
Type d'attribut |
Valeur d'attribut |
---|---|
Disponibilité |
SUNWmfwk |
Stabilité de l'interface |
Contract Private |
cacao.5, cacaoadm.1m