La commande mfwkadm

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.

Descriptif

Contrôle des performances

Contrôle de l'état opérationnel

Contrôle des valeurs seuil

Description

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.

Options

Les options suivantes sont prises en charge.

--help

Affiche le résumé des utilisations.

Sous-commandes

start

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].

stop

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].

restart

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].

list-params

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.

list-modules

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.

info instance-exécutée

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.

Contrôle des performances

pm-job observable-classes

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.

pm-job observable-objects [class=classe-objets] [domain=domaine-objets]

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.

class=classe-objets

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.

domain=domaine-objets

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.

pm-job observable-attributes class=classe-objets

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.

pm-job list

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.

pm-job info nom-tâche

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.

pm-job create nom-tâche granularity= valeur-entière object=nom-objet [object=nom-objet ...]

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 :

nom-tâche

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.

granularity=valeur-entière

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.

object=nom-objet [object=nom-objet ...]

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.

pm-job delete nom-tâche

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.

pm-job suspend nom-tâche

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.

pm-job resume nom-tâche

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.

Contrôle de l'état opérationnel

opstat-job observable-classes

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.

opstat-job observable-objects [class=nom-classe] [domain=domaine-objets]

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.

class=classe-objets

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.

domain=domaine-objets

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.

opstat-job observable-attributes class= classe-objets

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.

opstat-job list

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.

opstat-job info nom-tâche

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.

opstat-job create nom-tâche granularity= valeur-entière object=nom-objet [object=nom-objet ...]

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 :

nom-tâche

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.

granularity=valeur-entière

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.

object=nom-objet [object=nom-objet ...]

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.

opstat-job delete nom-tâche

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.

opstat-job suspend nom-tâche

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.

opstat-job resume nom-tâche

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.

Contrôle des valeurs seuil

thrsh-job observable-classes

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.

thrsh-job observable-objects [class=classe-objets] [domain=domaine-objets]

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.

class=classe-objets

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.

domain=domaine-objets

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.

thrsh-job observable-attributes class=classe-objets

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.

thrsh-job list

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.

thrsh-job info nom-tâche

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.

thrsh-job create nom-tâche object=nom-objet granularity=valeur-entière attributeName=nom-attribut attributeType=type-attribut thresholdValue=valeur-seuil thresholdOffset=valeur-décalage thresholdDirection=[ÉLÉVATION|CHUTE]

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 :

nom-tâche

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.

object=nom-objet

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.

granularity=valeur-entière

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.

attributeName=nom-attribut

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.

attributeType=type-attribut

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.

thresholdValue=valeur-seuil

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.

thresholdOffset=valeur-décalage

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.

thresholdDirection=[ÉLÉVATION|CHUTE]

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.

thrsh-job delete nom-tâche

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.

thrsh-job suspend nom-tâche

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.

thrsh-job resume nom-tâche

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.

Exemples

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

État de sortie

Les valeurs de sortie suivantes sont retournées :

0

Exécution réussie

1

Une erreur est survenue.

Attributs

Voir aussi

cacao.5, cacaoadm.1m