Gestion des événements ayant échoué

Deux outils d'InterChange Server Express vous permettent de localiser, visualiser et traiter les événements ayant échoué : Failed Event Manager, outil fonctionnant dans un navigateur et doté d'une fonction de sécurité basée sur les rôles qui permet de gérer les événements ayant échoué sur le Web, et Flow Manager, outil installé avec le produit InterChange Server Express. Pour résoudre des flux transactionnels, vous devez utiliser Flow Manager, mais les deux programmes Failed Event Manager et Flow Manager vous permettent de gérer les événements ayant échoué. Cette section inclut les rubriques suivantes :

Utilisation de Failed Event Manager

Utilisation de Flow Manager

Utilisation de Failed Event Manager

Failed Event Manager vous permet de visualiser et de gérer les événements ayant échoué, à partir du Web. Pour accéder à l'application Failed Events Manager, connectez-vous à System Monitor. La catégorie Failed Events Manager s'affiche dans le cadre de gauche, avec deux options : Droits d'accès et Requête. L'option Droits d'accès permet d'afficher les droits d'accès à Failed Event Manager couramment associés au nom d'utilisateur connecté. L'option Requête ouvre l'écran dans lequel vous effectuez des opérations avec Failed Event Manager.

Les actions que vous pouvez effectuer sur les événements ayant échoué dépendent de la sécurité basée sur les rôles. Les administrateurs peuvent attribuer aux utilisateurs un ou plusieurs des quatre rôles par défaut. Pour plus d'informations sur ces rôles, voir Rôles par défaut pour Failed Event Manager.

Les administrateurs peuvent également créer des rôles personnalisés pour votre équipe en particulier. Pour plus d'informations sur ces rôles, voir Rôles personnalisés dans Failed Event Manager.

Failed Event Manager fonctionne avec IBM WebSphere Application Server Express ou avec Tomcat (systèmes Windows et Linux uniquement). Consultez le guide d'installation de WebSphere Business Integration Server Express pour Windows, pour Linux ou pour OS/400 et i5/OS, pour obtenir des informations complémentaires sur la configuration de Failed Event Manager pour une exécution avec WebSphere Application Server, WebSphere Application Server Express ou Tomcat. Le système OS/400 et i5/OS ne prend pas en charge Tomcat.

Failed Event Manager fonctionne avec les versions suivantes de WebSphere Application Server, WebSphere Application Server Express et Tomcat :

Cette section inclut les procédures suivantes :

Sécurité et accès basé sur les rôles pour Failed Event Manager

Failed Event Manager inclut des rôles par défaut. Les administrateurs peuvent également créer des rôles de sécurité supplémentaires. Pour plus d'informations sur le contrôle d'accès basé sur les rôles, voir Gestion du contrôle d'accès basé sur les rôles.

Rôles par défaut pour Failed Event Manager

Failed Event Manager fournit quatre rôles de base qui sont les suivants :

Pour créer les rôles par défautn excepté celui d'Administrateur, utilisez l'outil d'administration du serveur dans System Manager. Tous les rôles par défaut doivent avoir, et uniquement avoir, des droits de règle de sécurité au niveau du serveur pour visualiser les événements défaillants. Pour plus d'informations, voir Gestion des autorisations liées aux règles de sécurité.

Remarque :
Vous ne pouvez utiliser le rôle SubmitEvents qu'en association avec un autre rôle personnalisé qui inclut des droits de règle de sécurité au niveau du composant pour soumettre et supprimer des événements défaillants pour des collaborations et des connecteurs.
Rôles personnalisés dans Failed Event Manager

Vous pouvez également créer des rôles personnalisés à utiliser avec Failed Event Manager à l'aide de l'outil d'administration du serveur dans System Manager. Vous pouvez affecter des rôles personnalisés et par défaut à un utilisateur. Les rôles personnalisés peuvent fournir un accès au niveau des composants , par exemple, un utilisateur doté durôle approprié peut être limité à la visualisation d'événements défaillants qui apparti ennent à un propriétaire d'événement spécifique (connecteur ou collaboration). Pour plus d'informations, voir Gestion des rôles.

Tous les rôles personnalisés doivent avoir des droits de règle de sécurité au niveau du serveur pour visualiser les événements défaillants.

Au niveau des composants, chaque rôle personnalisé doit avoir des autorisations de sécurité Submit_Failed_Events et Delete_Failed_Events pour chaque composant. Le propriétaire d'événement (objet de collaboration ou objet connecteur) doit être identifié également.

Procédure de connexion à Failed Event Manager

Vous pouvez accéder à l'application Failed Events Manager lors de la connexion à System Monitor. Failed Events Manager s'affiche dans le cadre de gauche, aux côtés des vues et paramètres de System Monitor.

Failed Event Manager est accessible uniquement via un navigateur pris en charge sur les seules plateformes Windows. Les navigateurs pris en charge sont les suivants :

WebSphere Business Integration Server Express inclut maintenant System Monitor et Failed Events Manager, vous devez donc commencer par vous connecter à System Monitor pour accéder aux événements ayant échoué. Une fois connecté à System Monitor, sélectionnez simplement l'option Failed Events Manager dans le cadre de gauche.

Pour plus d'informations sur la connexion à System Monitor, voir Procédure de connexion à System Monitor.

Procédure de visualisation des événements ayant échoué

Pour visualiser les informations relatives aux événements ayant échoué dans Failed Event Manager, appliquez la procédure suivante :

  1. Sur la page Requête, sélectionnez les informations sur les événements ayant échoué que vous souhaitez visualiser :
  2. Cliquez sur Valider.

    Une table des événements ayant échoué apparaît, comme illustré figure 64.

    Figure 64. Table des événements ayant échoué de Failed Event Manager

    Si vous n'avez pas été affecté à l'un des rôles pouvant visualiser les objets métier, les boutons relatifs aux objets métier peuvent ne pas être disponibles dans cette table, comme illustré figure 65.

    Remarque :
    En fonction de votre navigateur, des boutons et autres contrôles peuvent ne pas apparaître ou apparaître mais être désactivés.

    Figure 65. Table des événements ayant échoué de Failed Event Manager sans droit de visualiser les objets métier
  3. Pour visualiser les détails d'un événement ayant échoué particulier, cochez la case correspondante dans la colonne de gauche et cliquez sur Afficher dans la colonne Détails.

    La boîte de dialogue Détail des événements apparaît, comme illustré figure 66.

    Figure 66. Boîte de dialogue Détail des événements de Failed Event Manager
  4. Si vous avez été affecté à un rôle ayant accès à l'objet métier, cliquez sur le bouton de l'objet métier dans la colonne Objets métier pour afficher les détails relatifs à l'objet métier. La boîte de dialogue Données objet métier, comme illustré figure 67.
    Figure 67. Boîte de dialogue Données objet métier de Failed Event Manager

Procédure de traitement des événements ayant échoué dans Failed Event Manager

Pour traiter les événements ayant échoué dans une table d'événements ayant échoué, appliquez la procédure suivante :

  1. Cochez la case dans la colonne gauche correspondante aux événements ayant échoué que vous souhaitez gérer.
  2. Procédez de l'une des façons suivantes :

Procédure de vérification des droits d'accès dans Failed Event Manager

Pour vérifier les droits d'accès des rôles qui vous ont été attribués dans Failed Event Manager, appliquez la procédure suivante :

  1. Connectez-vous à Failed Event Manager (voir Procédure de connexion à Failed Event Manager).
  2. Sur la page de requête qui apparaît, cliquez sur le lien de vérification des droits d'accès, dans l'angle inférieur gauche.

    La page qui s'affiche contient les rôles par défaut disponibles. Vous pouvez entrer un nom de rôle pour savoir si vous êtes affecté à ce rôle.

Utilisation de Flow Manager

Pour localiser, visualiser et traiter les événements ayant échoué, utilisez Flow Manager, outil installé avec le produit InterChange Server Express. Flow Manager vous permet de créer facilement une requête pour localiser et afficher les flux non résolus. Flow Manager vous permet d'afficher les flux non résolus de plusieurs serveurs et se lance soit en tant qu'outil autonome, soit en tant qu'éditeur de System Manager.

Lorsque vous avez affiché les flux non résolus, vous pouvez sélectionner n'importe quel flux à l'écran et le valider, le supprimer ou effectuer d'autres actions. Pour des informations de fond sur les flux ayant échoué, voir Echecs de flux.

Les rubriques suivantes décrivent l'utilisation de Flow Manager pour créer des requêtes, afficher les détails et traiter les événements :

Procédure de démarrage de Flow Manager en tant qu'outil autonome

Procédure de démarrage de Flow Manager à partir de System Manager

Procédure de recherche des flux non résolus

Procédure de visualisation du détail des flux non résolus

Procédure de traitement des flux non résolus

Procédure de démarrage de Flow Manager en tant qu'outil autonome

Pour démarrer Flow Manager en tant qu'outil autonome, appliquez la procédure suivante :

  1. Cliquez sur Démarrer > Programmes > IBM WebSphere Business Integration Express > Toolset Express > Administration > Flow Manager. La fenêtre de l'application Flow Manager s'ouvre.
  2. Sélectionnez Serveur > Connexion au serveur. La fenêtre Connexion à InterChange Server s'affiche.
  3. Entrez le nom du serveur à l'aide de l'une des méthodes ci-dessous. Pour Windows, le serveur par défaut est WebSphereICS. Pour OS/400 et i5/OS, le serveur par défaut est QWBIDFT44.
  4. Entrez le nom d'utilisateur et le mot de passe pour le serveur auquel vous souhaitez vous connecter. Si vous cochez la case Mémoriser le nom d'utilisateur et le mot de passe, le nom d'utilisateur et le mot de passe sont stockés dans le registre avec le nom du serveur et le mot de passe est chiffré. Cliquez sur Connecter.
    Remarque :
    Pour supprimer les utilisateurs ou les serveurs inutilisés du registre, cliquez sur Options. La boîte de dialogue Options qui apparaît vous permet de supprimer des serveurs ou des utilisateurs.
    La figure suivante illustre la boîte de dialogue Options.
    Figure 68. Boîte de dialogue Options

Lorsque vous cliquez sur Connecter dans la boîte de dialogue InterChange Server, Flow Manager apparaît (voir figure 69).

Figure 69. Flow Manager

Procédure de démarrage de Flow Manager à partir de System Manager

Pour démarrer Flow Manager à partir de System Manager, appliquez la procédure suivante :

  1. Démarrez System Manager et connectez-vous au serveur.
  2. Dans System Manager, cliquez à l'aide du bouton droit de la souris sur le serveur dans ma vue Gestion de composant InterChange Server et cliquez sur Flow Manager.

Procédure de recherche des flux non résolus

Pour rechercher les flux non résolus, appliquez la procédure suivante dans Flow Manager :

  1. Démarrez Flow Manager. Voir Procédure de démarrage de Flow Manager en tant qu'outil autonome ou Procédure de démarrage de Flow Manager à partir de System Manager.
  2. Procédez de l'une des façons suivantes :
  3. Après avoir précisé vos critères de recherche, cliquez sur le bouton Rechercher ou sur FlowManager > Evénement > Rechercher. Les résultats s'affichent dans la partie inférieure de la fenêtre Flow Manager.
  4. Pour sauvegarder les informations de filtre en cours sous forme de requête, cliquez sur FlowManager > Requête > Sauvegarder. Le nom de requête que vous entrez apparaît dans la liste Requête.
Onglet Attributs d'événement

Cliquez sur l'onglet Attributs d'événement pour effectuer la recherche à partir des caractéristiques de l'événement non résolu (voir figure 70).

Figure 70. Onglet Attributs d'événement de Flow Manager

Les options suivantes sont disponibles à partir de l'onglet Attributs d'événement :

Onglet Date & Heure

Utilisez l'onglet Date & Heure pour rechercher uniquement les flux ayant échoué pendant une période spécifique (voir figure 71).

Figure 71. Onglet Date & Heure

Les options suivantes sont disponibles à partir de l'onglet Date & Heure :

Onglet Texte d'erreur et attributs d'objet métier

L'onglet Texte d'erreur et attributs d'objet métier vous permet de créer une requête incluant uniquement certains objets métier, attributs d'objet métier et valeurs d'attribut (voir figure 72).

Figure 72. Texte d'erreur et attributs d'objet métier

Sélectionnez des valeurs dans les colonnes suivantes :

Vous pouvez également ne rechercher que les flux non résolus qui génèrent un message contenant un texte défini que vous indiquez dans la zone Contenant le texte d'erreur.

Remarque :
La distinction majuscules/minuscules n'est pas significative dans les mots clés que vous entrez dans la zone Contenant le texte d'erreur.

Procédure de visualisation du détail des flux non résolus

Pour visualiser le détail relatif aux flux non résolus dans Flow Manager, appliquez la procédure suivante :

  1. Sélectionnez une requête dans la liste Requête.
  2. Procédez de l'une des façons suivantes :

    Les résultats s'affichent dans la partie inférieure de la fenêtre Flow Manager.

    La table des flux non résolus qui apparaît contient la liste des événements ainsi que les informations suivantes :

    Pour les événements en attente, la cellule Etat d'événement contient les informations suivantes :

    En attente
    [expiration du délai :...]
    [nom du scénario :...]
    [ID noeud du scénario...]

  3. Pour obtenir plus d'informations sur un événement, cliquez deux fois sur la ligne contenant cet événement (ou cliquez sur FlowManager > Evénement > Sélectionner tout). La boîte de dialogue Afficher le détail des événements apparaît alors (voir figure 73).
    Figure 73. Boîte de dialogue Afficher le détail des événements de Flow Manager
  4. Pour obtenir plus d'informations sur l'objet métier associé à l'événement sélectionné, cliquez sur FlowManager > Evénement > Afficher les détails. La boîte de dialogue Affichage des données d'objet métier apparaît (voir figure 74).
    Figure 74. Boîte de dialogue Affichage des données d'objet métier

Pour effectuer des opérations sur l'un des flux non résolus, voir Procédure de traitement des flux non résolus.

Procédure de gestion des requêtes

Pour gérer les requêtes de recherche des flux non résolus, effectuez l'une des opérations suivantes :

Procédure de gestion des résultats de requêtes

Pour gérer les requêtes de recherche des flux non résolus, appliquez la procédure suivante :

  1. Dans la liste des résultats de Flow Manager, sélectionnez un ou plusieurs événements.
  2. Procédez de l'une des façons suivantes :

Procédure de traitement des flux non résolus

Pour traiter les événements ayant échoué dans la liste de résultats de Flow Manager, appliquez la procédure suivante :

  1. Dans la liste des résultats de Flow Manager, sélectionnez un ou plusieurs événements.
  2. Procédez de l'une des façons suivantes :

Copyright IBM Corp. 2004, 2005