Administration des connecteurs
L'administration des connecteurs peut consister à démarrer, mettre en pause, arrêter et fermer des connecteurs. Pour plus d'informations sur la configuration des connecteurs, notamment la définition des propriétés, les objets métier pris en charge et les mappes associées, voir le Guide d'implémentation du système.
Vous pouvez démarrer, interrompre, arrêter et fermer des connecteurs à partir de System
Monitor ou de System Manager et vous pouvez démarrer manuellement des connecteurs à l'aide
de scripts sous Windows, sous OS/400 et sous i5/OS et Linux.
Le script du gestionnaire de connecteurs générique appelle le script start_connecteur .bat ou start_connecteur.sh approprié, qui prend en charge la gestion effective du connecteur (y compris l'arrêt). Le produit InterChange Server Express propose un script start_connecteur.bat ou start_connecteur.sh pour chaque connecteur fourni.
Cette section inclut les rubriques suivantes :
Affichage des états de connecteur
Démarrage, arrêt et mise en pause de connecteurs
Procédure de configuration du contrôle des flux pour les connecteurs
Procédure de modification des profils utilisateur pour les agents d'adaptateur sous OS/400 et i5/OS
Affichage des états de connecteur
Vous pouvez afficher l'état d'un connecteur en vous connectant à System Monitor et en accédant à une vue contenant les états de connecteur ou via la vue Gestion de composant InterChange Server, dans System Manager. Pour utiliser System Manager, appliquez les instructions de la section Procédure de connexion à une instance d'InterChange
Server Express.
L'état d'un connecteur est représenté différemment, selon l'outil que vous utilisez.
Procédure d'utilisation de System
Monitor pour afficher les états de connecteur
Pour afficher les états de connecteur dans System Monitor, procédez comme suit :
- Connectez-vous à System Monitor (voir Procédure de connexion à System Monitor).
- Si la vue Aperçu général du système n'apparaît pas, cliquez sur le lien Aperçu général du système sous Vues. Le moniteur Aperçu général du système s'affiche.
Lorsque le produit est installé, la vue par défaut est Aperçu général du système et le moniteur par défaut de cette vue est également Aperçu général du système. Ces valeurs par défaut peuvent être adaptées à vos exigences en matière de surveillance.
Voir Définition de vues pour surveiller le système pour plus d'instructions.
- Cliquez sur le triangle en regard du nom du serveur pour afficher la liste des composants du système.
- Cliquez sur le triangle en regard d'une collaboration en cours d'exécution pour afficher les connecteurs associés (voir figure 27).
Figure 27. System Monitor, Aperçu général du système affichant l'état des connecteurs
Procédure d'utilisation de System
Manager pour afficher les états de connecteur
Pour afficher l'état d'un connecteur dans System Manager, procédez comme suit :
- Connectez-vous à une instance d'InterChange Server Express contenant le connecteur que vous souhaitez afficher. Pour plus d'instructions sur la connexion à une instance d'InterChange
Server Express, voir Procédure de connexion à une instance d'InterChange
Server Express.
- Développez l'instance d'InterChange Server Express, puis le dossier Connecteurs.
Les connecteurs apparaissent sous le dossier Connecteurs ouvert, en différentes couleurs indiquant les différents états.
Figure 28. Dossier Connecteurs dans la vue Gestion de composant InterChange Server
Le tableau 6 répertorie les états de connecteur représentés par la couleur d'affichage de chaque connecteur et indique les actions effectuées dans ces états.
Tableau 6. Etats de connecteur
Etat de connecteur (couleur) |
Requêtes de souscription traitées |
Requêtes d'appel de service traitées |
Envois de souscriptions traités |
Actif (vert) |
Oui |
Oui |
Oui |
En pause (jaune) |
Oui |
Oui |
Non |
En reprise ou inconnu (gris) |
|
|
|
Inactif (rouge) |
Non |
Non |
Non |
Démarrage, arrêt et mise en pause de connecteurs
Cette section décrit comment démarrer, arrêter et mettre en pause des connecteurs.
Cette section traite des points suivants :
Initialisation d'un connecteur
Procédure de démarrage, d'arrêt et de mise en pause de connecteurs
Commandes System Manager de modification des états de connecteur
Procédure de démarrage manuel d'un connecteur sous Windows
Procédure de démarrage manuel d'un connecteur
sous OS/400 et i5/OS
Procédure de démarrage manuel d'un connecteur sous Linux
Arrêt d'un connecteur
Redémarrage d'un connecteur
Procédure de définition de redémarrage automatique et à distance d'un connecteur
Procédure d'utilisation d'OAD sous forme de service Windows
Initialisation d'un connecteur
Lorsque vous démarrez un connecteur pour la première fois, vous devez d'abord l'initialiser.
Cette opération implique que vous démarriez le connecteur manuellement. Pour plus d'instructions sur le démarrage manuel d'un connecteur, voir Procédure de démarrage manuel d'un connecteur sous Windows.
Si le connecteur ne démarre pas, vérifiez que la ligne de commande utilisée pour le démarrer contient le nom en cours d'InterChange Server
Express. Pous plus d'informations, consultez le guide d'installation de WebSphere Business
Integration Server Express pour Windows, pour Linux
ou pour OS/400 et i5/OS.
Procédure de démarrage, d'arrêt et de mise en pause de connecteurs
Une fois le connecteur initialisé, vous pouvez le démarrer, l'arrêter et le mettre en pause à partir de System Monitor ou System Manager.
Pour démarrer, arrêter et mettre en pause des connecteurs dans System Monitor, procédez comme suit :
- Dans la vue Aperçu général du système (voir figure 27), spécifiez un connecteur en sélectionnant la case à sa gauche.
- Sélectionnez l'icône Démarrer, Mettre en pause ou Arrêter dans le groupe d'icônes, dans l'angle supérieur gauche de la vue (voir figure 29).
Figure 29. System Monitor, icônes de démarrage, mise en pause, redémarrage ou arrêt des composants
Pour démarrer, arrêter et mettre en pause des connecteurs dans System Manager, procédez comme suit :
- Dans System Manager, placez-vous dans le dossier Connecteurs de la vue Gestion de composant InterChange Server (voir figure 28).
- A l'aide du bouton droit de la souris, cliquez sur le nom d'un connecteur, puis sélectionnez Démarrer Nom_connecteur, Mettre en pause Nom_connecteur ou Arrêter Nom_connecteur.
Commandes System Manager de modification des états de connecteur
La liste suivante contient les commandes que vous pouvez utiliser pour modifier l'état d'un connecteur et décrit les actions de traitement correspondantes :
- Démarrer Nom_connecteur
- Démarre le connecteur sélectionné s'il est en pause ou arrêté.
Les connecteurs interrogent l'application et les contrôleurs de connecteur lisent la file d'attente persistante. Les flux sont traités.
- Mettre en pause Nom_connecteur
- Met en pause le connecteur sélectionné s'il est en cours d'exécution ou arrêté.
Les connecteurs cessent d'interroger l'application et les contrôleurs de connecteur cessent de lire les nouvelles requêtes, mais le traitement des événements se poursuit.
- Arrêter Nom_connecteur
- Arrête le connecteur sélectionné s'il est en cours d'exécution ou en pause. Les connecteurs cessent d'interroger l'application et provoquent l'échec des requêtes, avec un message d'exception. Les contrôleurs de connecteur cessent de lire la file d'attente persistante.
Les flux et les requêtes ne sont pas traités.
- Quitter Nom_connecteur
- Quitte le connecteur sélectionné. Le processus du connecteur est arrêté.
- Lancer Nom_connecteur
- Relance le connecteur sélectionné. Cette action est disponible uniquement si vous avez défini la propriété OADAutoRestartAgent du connecteur par True. Voir Procédure de définition de redémarrage automatique et à distance d'un connecteur.
Procédure de démarrage manuel d'un connecteur sous Windows
Lorsque vous installez IBM WebSphere Business Integration
Adapters, un raccourci est créé pour chaque connecteur installé, dans le menu du programme IBM WebSphere. Le connecteur est défini dans le référentiel d'InterChange Server Express et il est chargé lorsque vous chargez le référentiel.
Le démarrage d'InterChange Server Express initialise automatiquement chaque connecteur défini dans le référentiel. Le connecteur est disponible pour utilisation dès qu'InterChange Server Express s'exécute.
Remarque :
Pour qu'un connecteur soit fonctionnel lors de sa première utilisation, vous devez le configurer avant de le démarrer. Consultez le guide des cartes relatives aux connecteurs que vous utilisez pour connaître les instructions de configuration.
Exécutez l'une des étapes suivantes pour démarrer le connecteur :
- Cliquez sur le raccourci sur le bureau.
Démarrez le connecteur en cliquant sur le raccourci du programme créé pendant la procédure d'installation.
- Sélectionnez la commande de menu du connecteur dans le sous-menu IBM WebSphere du menu Windows Démarrer > Programmes.
- Utilisez une fenêtre d'invite de commande DOS pour lancer le script de démarrage.
Ouvrez une fenêtre d'invite de commande DOS et naviguez vers le répertoire de connecteurs appropriés. A l'invite, entrez l'instruction ci-dessous :
start_Nom_conn Nom_conn Nom_ICS_WebSphere [-cFichier_config ]
où Nom_conn est le nom du connecteur et Nom_ICS_WebSphere est le nom de l'instance InterChange Server Express et Fichier_config est le nom du fichier de configuration à utiliser au démarrage. Par défaut, le nom de l'instance d'InterChange Server Express est
WebSphereICS.
Consultez le dossier Connecteurs dans System Manager pour connaître le Nom_conn correct.
Vous pouvez personnaliser le démarrage pour chaque connecteur en modifiant le raccourci du connecteur ou le fichier start_connecteur.bat. Utilisez les paramètres de démarrage du connecteur indiqués dans le tableau 7 pour personnaliser le démarrage d'un connecteur. -
Tableau 7. Paramètres de démarrage de connecteur
Paramètre |
Fonction |
-b |
Déclenche l'exécution de l'agent d'adaptateur en processus d'arrière-plan. Cela évite que l'agent ne tente de lire le caractère 'q' (quit) dans les entrées système. Les agents qui lisent les informations dans les entrées système réduisent les performances des agents qui s'exécutent dans un sous-système iSeries. |
-c Fichier_config |
Nom du fichier de configuration à utiliser lors du démarrage. Si le nom du fichier contient un chemin relatif, le script de démarrage recherche le fichier dans le répertoire d'installation du produit. Ce paramètre est requis uniquement si vous utilisez un fichier de configuration de connecteur local. Si tel n'est pas le cas, entrez le nom du fichier de configuration utilisé par IBM WebSphere InterChange Server Express (par défaut, InterchangeSystem.cfg). |
-c |
Déclenche l'utilisation du fichier de configuration par défaut si le fichier de configuration spécifié par l'utilisateur n'existe pas. |
-d |
Spécifie le nom du fichier de bibliothèque du connecteur C++, lequel est une bibliothèque de liens dynamiques (DLL). Ce nom de DLL ne contient pas l'extension de fichier .dll. Le script de démarrage spécifie cette option pour tous les connecteurs C++. |
-f Fréquence_interrog. |
La fréquence d'interrogation est le nombre de millisecondes entre deux actions d'interrogation.
- Pour indiquer le nombre de millisecondes, entrez une valeur pour Fréquence_interrogation.
- Pour que le connecteur exécute une interrogation uniquement lorsque vous entrez la valeur p dans la fenêtre d'invite de commande du connecteur, indiquez l'option -fkey.
- Si un connecteur est configuré pour traiter uniquement les demandes d'objet métier et non les événements d'application, l'interrogation n'est pas nécessaire ; vous pouvez désactiver l'interrogation en spécifiant l'option -fno.
La valeur de ce paramètre remplace toutes les définitions de référentiel.
Vous pouvez indiquer -fkey ou -fno, mais pas les deux options simultanément. |
-j |
Indique que le connecteur est écrit en Java.
Ce paramètre est facultatif si vous indiquez l'option -l Nom_classe. |
-l Nom_classe |
Indique le nom de la classe globale du connecteur Java, laquelle est une extension de la classe de base du connecteur.
Le script de démarrage spécifie cette option pour tous les connecteurs Java. |
-n Nom_connecteur |
Indique le nom du connecteur à démarrer. |
-p mot_de_passe |
Indique le mot de passe utilisé par le connecteur pour accéder à InterChange
Server Express. |
-s Nom_serveur |
Indique le nom du serveur. Ce paramètre est requis. Ce nom respecte la distinction majuscules/minuscules. |
-t |
Active la propriété de connecteur SingleThreadAppCalls. Cette propriété garantit que tous les appels effectués par l'architecture du connecteur vers le code de connecteur spécifique d'une application comportent un flux déclenché par événement. La valeur par défaut est false. Important : ne modifiez pas la valeur d'origine de cette propriété. Le paramètre approprié est défini pour chaque connecteur selon son modèle d'unité d'exécution. Définissez cette option uniquement lorsque vous démarrez un connecteur que vous avez créé. |
-x Props_connecteur |
Transmet les propriétés de connecteur spécifiques d'une application au connecteur. Utilisez le format prop_name=valeur pour chaque valeur entrée. |
Procédure de démarrage manuel d'un connecteur
sous OS/400 et i5/OS
Les agents de connecteur s'exécutant sur un système OS/400 et i5/OS sont généralement démarrés et arrêtés
de l'une des trois façons ci-après.
Exécutez l'une des étapes suivantes pour démarrer manuellement un connecteur
sous OS/400 et i5/OS :
- Ouvrez la console WebSphere Business Integration Console (cliquez sur Démarrer > Programmes > IBM WebSphere Business Integration Express > Toolset Express > Outils d'administration > Console),
sélectionnez un serveur dans la liste Serveur, sélectionnez un adaptateur dans la liste Adaptateurs, dans la fenêtre principale et cliquez sur le bouton Démarrer l'adaptateur.
Lorsque vous choisissez de démarrer un adaptateur à l'aide de la console WebSphere
Business Integration, un travail est soumis à exécution dans le sous-système
QWBISVR44, sur le système OS/400 et i5/OS où a été installé InterChange
Server Express. Ces travaux s'exécutent par lots, sans aucune intervention possible de l'utilisateur. En modifiant de manière appropriée les scripts de démarrage de l'adaptateur, vous pouvez personnaliser le démarrage de ces travaux.
Par exemple, vous pouvez ajouter des paramètres pour indiquer un fichier de configuration d'entrée. Vous pouvez ajouter des paramètres et effectuer d'autres modifications sur les scripts de démarrage de l'adaptateur.
Lorsque vous démarrez les adaptateurs de cette façon, vous pouvez arrêter les travaux à l'aide des
fonctions habituelles de contrôle des travaux OS/400 et i5/OS. Pour ce faire, vous pouvez,
à partir du poste Windows, utiliser les fonctions OS/400 et i5/OS
Operations Navigator ou ouvrir une session de terminal OS/400 et i5/OS. Par exemple, à partir d'une session de terminal OS/400 et i5/OS, vous pouvez lancer la commande WRKACTJOB SBS(QWBISVR44) pour afficher tous les travaux
actifs du serveur InterChange Server Express. Vous pouvez localiser le travail correspondant à l'adaptateur à arrêter et utiliser l'option 4 (fin du travail) pour arrêter l'adaptateur. La liste suivante contient les noms des travaux correspondant aux différents adaptateurs :
- Adaptateur de courrier électronique (Email) - QWBIEMAILC
- Adaptateur HTTP - QWBIHTTPC
- Adaptateur iSeries - QWBIISRSC
- Adaptateur J D Edwards - QWBIJDEC
- Adaptateur JDBC - QWBIJDBCC
- Adaptateur JMS - QWBIJMSC
- Adaptateur Jtext - QWBIJTEXTC
- Adaptateur Lotus Domino - QWBIDOMC
- Adaptateur Oracle - QWBIOCLC
- Adaptateur SAP - QWBISAPC
- Adaptateur Swift - QWBISWIFTC
- Adaptateur TCP IP - QWBITCPIPC
- Adaptateur Web Services - QWBIWEBSVC
- Adaptateur WebSphere Commerce - QWBIWEBCSC
- Adaptateur WebSphere MQ - QWBIWEBMQC
- Adaptateur XML - QWBIXMLC
- Sur le système OS/400 et i5/OS sur lequel a été installé InterChange Server
Express, les scripts QSHELL sont disponibles pour démarrer chacun des adaptateurs
pris en charge. Pour démarrer un adaptateur de cette manière, ouvrez une session d'émulation
de terminal sur le système OS/400 et i5/OS. En ligne de commande, entrez la commande
QSH pour placer la session de terminal dans un environnement permettant l'exécution des scripts shell.
Lorsque les connecteurs sont démarrés de la sorte, les travaux sont exécutés de manière interactive et vous pouvez les arrêter de l'une des façons suivantes :
- Appuyez sur la touche de fonction 3 (F3) dans l'environnement QSHELL pour arrêter l'environnement QSHELL en cours et tous les travaux en cours d'exécution.
- Appuyez sur la touche Sys/Req et sélectionnez l'option 2 pour arrêter le connecteur en cours et quitter l'environnement QSHELL.
- Vous pouvez activer vos connecteurs afin qu'ils démarrent automatiquement avec le serveur Interchange Server sur lequel ils s'exécutent. Pour ce faire, à partir de la ligne de commande,
entrez la commande QSH puis, dans l'environnement QSHELL, utilisez le script
/QIBM/ProdData/WBIServer44/bin/add_autostart_adapter.sh Nom_Conn Nom_ICS_WebSphere Nom_Script Nom_Description_Travail,
où Nom_Conn correspond au nom de
l'adaptateur, Nom_ICS_WebSphere au nom du serveur
InterChange Server avec lequel il doit s'exécuter (QWBIDFT44 est le serveur par défaut
pour le système OS/400 et i5/OS), Nom_Script correspond au chemin d'accès
complet du script de démarrage de l'adaptateur et Nom_Description_Travail correspond
au nom de la description du travail à utiliser pour le travail de l'adaptateur.
Si vous utilisez cette méthode, l'arrêt de ces connecteurs se fait de la même manière que l'arrêt des connecteurs lorsque les travaux sont démarrés depuis la console WebSphere
Business Integration Console, comme décrit dans la première étape ci-avant.
Au prochain démarrage du sous-sytème QWBISVR44, votre adaptateur sera automatiquement
démarré.
Pour supprimer un adaptateur de l'ensemble des connecteurs démarrés automatiquement,
utilisez le script /QIBM/ProdData/WBIServer44/bin/remove_autostart_adapter.sh Nom_conn Nom_ICS_WebSphere.
Procédure de démarrage manuel d'un connecteur sous Linux
Exécutez l'une des étapes suivantes pour démarrer manuellement un connecteur sous Linux :
Arrêt d'un connecteur
Cette section traite des points suivants :
Procédure d'arrêt d'un connecteur dans System Monitor
Procédure d'arrêt d'un connecteur dans System Manager
L'arrêt d'un connecteur interrompt les processus du connecteur.
Avant d'arrêter un connecteur, mettez en pause ou arrêtez tout objet de collaboration utilisant le connecteur (vous devez configurer la collaboration pour qu'elle prenne en charge la mise en pause ; voir la documentation relative à la collaboration pour plus d'instructions). Si la case Mettre en attente lorsqu'une erreur grave se produit est cochée dans la fenêtre Propriétés générales de collaboration, la collaboration se met automatiquement en pause lorsqu'une erreur grave se produit.
Les derniers événements non traités de ces collaborations sont alors déplacés dans la file d'attente de soumission des événements.
Vous pouvez effectuer un arrêt "définitif" ou "temporaire" du connecteur. Vous pouvez contrôler le type d'arrêt en activant ou désactivant le redémarrage automatique (par défaut) :
- Si vous n'avez pas activé le redémarrage automatique, lorsque vous exécutez une action d'arrêt, l'effet est "définitif" : le connecteur s'arrête et ne redémarre que si vous le relancez manuellement, en ligne de commande ou à l'aide d'un fichier de traitement par lots.
- Si vous avez activé le redémarrage automatique, l'action d'arrêt est temporaire et vous pouvez redémarrer le connecteur à l'aide de l'action de l'agent d'amorçage de connecteur, dans la Vue système de System Monitor.
Pour plus d'instructions sur l'activation ou la désactivation du redémarrage automatique, voir Procédure de définition de redémarrage automatique et à distance d'un connecteur.
Les instructions relatives à l'arrêt d'un connecteur varient selon l'outil utilisé pour surveiller le système :
Procédure d'arrêt d'un connecteur dans System Monitor
Pour arrêter un connecteur dans System Monitor, procédez comme suit :
- Dans la vue Aperçu général du système, sélectionnez l'objet de collaboration relatif au connecteur à arrêter, en cochant la case à sa gauche, puis cliquez sur le bouton Mettre en pause, dans l'angle supérieur gauche de la vue (voir figure 29). Répétez cette opération pour chaque collaboration associée au connecteur.
- Cochez la case en regard du connecteur à arrêter et cliquez sur le bouton Arrêter, dans l'angle supérieur gauche de la vue (voir figure 29).
Procédure d'arrêt d'un connecteur dans System Manager
Pour arrêter un connecteur dans System Manager, procédez comme suit :
- Développez le dossier Objets de collaboration, dans la vue Gestion de composant InterChange Server (voir figure 32).
- Cliquez, à l'aide du bouton droit de la souris, sur l'objet de collaboration associé au connecteur et cliquez sur Mettre en pause Nom_Collaboration. Répétez cette opération pour chaque collaboration associée au connecteur.
Sur l'icône de l'objet de collaboration, deux lignes verticales apparaissent.
- A partir du dossier Connecteurs ouvert dans la vue Gestion de composant InterChange Server, cliquez, à l'aide du bouton droit de la souris, sur le connecteur, puis cliquez sur Arrêter Nom_Connecteur.
Attention :
N'utilisez pas Ctrl+C ni la commande CL ENDJOB pour arrêter un connecteur. Cette méthode arrête en effet le connecteur de manière incorrecte.
En outre, si vous utilisez la séquence de touches Ctrl+C, la commande CL ENDJOB ou "q", ou encore d'autres méthodes manuelles pour procéder à l'arrêt, et si le programme Object Activation Daemon
(OAD) est activé, OAD redémarre immédiatement le connecteur.
Redémarrage d'un connecteur
Les procédures décrites dans cette section relancent le connecteur après que vous avez utilisé l'action d'arrêt du connecteur dans System Monitor ou dans System Manager, dans la vue Gestion de composant InterChange Server. Cette action est disponible uniquement si vous avez activé le redémarrage automatique et à distance pour le connecteur (voir Procédure de définition de redémarrage automatique et à distance d'un connecteur).
Cette section traite des points suivants :
Procédure d'utilisation de System
Monitor pour redémarrer un connecteur
Procédure d'utilisation de System
Manager pour redémarrer un connecteur
Procédure d'utilisation de System
Monitor pour redémarrer un connecteur
Pour redémarrer un connecteur dans System Monitor, procédez comme suit :
- Dans la vue Aperçu général du système (voir figure 27), cochez la case à gauche du connecteur que vous souhaitez redémarrer.
- Cliquez sur le bouton Redémarrer l'agent dans l'angle supérieur gauche de la vue (voir figure 29).
Procédure d'utilisation de System
Manager pour redémarrer un connecteur
Pour redémarrer un connecteur dans System Manager, procédez comme suit :
- Développez le dossier Connecteurs dans la vue Gestion de composant InterChange System, (voir figure 28).
- Cliquez, à l'aide du bouton droit de la souris, sur le connecteur à redémarrer, puis cliquez sur Lancer Nom_Connecteur.
Procédure de définition de redémarrage automatique et à distance d'un connecteur
A l'aide du programme Object Activation Daemon (OAD), déclenché par
IBM WebSphere MQ, vous pouvez activer un connecteur afin qu'il prenne en charge la fonction de redémarrage automatique et à distance, ce qui lui permet de vérifier les conditions suivantes :
- Disponibilité : redémarrage automatique d'un connecteur après qu'il a été arrêté
- Maintenabilité : démarrage ou redémarrage d'un agent de connecteur éloigné, à partir de System Manager
Cette section traite des points suivants :
Procédure de définition de redémarrage automatique et à distance d'un connecteur sous Windows
Procédure de définition de redémarrage automatique et à distance d'un connecteur sous Linux
Procédure de redémarrage automatique et à distance d'un connecteur
sous OS/400 et i5/OS
Procédure d'activation des connecteurs pour MQ-triggered OAD
Procédure de définition de redémarrage automatique et à distance d'un connecteur sous Windows
Pour définir le redémarrage automatique et à distance d'un connecteur sur une plateforme Windows, procédez comme suit :
- Installez IBM WebSphere MQ.
Pour utiliser le programme MQ-triggered OAD, vous devez installer MQ-trigger
Monitor et configurer certaines files d'attente. Ce moniteur fait partie de l'installation du logiciel WebSphere MQ. Ces files d'attente sont créées et configurées par un script spécial mqtriggersetup.bat .
Important :
WebSphere MQ-trigger Monitor doit être installé sur le poste où se trouve l'agent de connecteur. Si plusieurs agents de connecteur se trouvent sur un même poste, installez un seul exemplaire de MQ-trigger Monitor.
- Lancez MQ-trigger Monitor.
Pour lancer MQ-triggered OAD, vous devez démarrer MQ-trigger
Monitor, de l'une des façons suivantes :
- Démarrez explicitement MQ-trigger Monitor à l'aide du script de démarrage approprié.
- Installez MQ-trigger Monitor en tant que service Windows (pour lancer manuellement MQ-trigger Monitor, exécutez la commande runmqtrm ou runmqtmc si le client MQ est démarré sur ce poste).
- Configurez un connecteur pour le redémarrage automatique et à distance.
Voir Procédure d'activation des connecteurs pour MQ-triggered OAD ci-après.
- Exécutez le script mqtriggersetup.bat (situé dans le répertoire bin) pour chaque connecteur devant être redémarré, par exemple :
mqtriggersetup.bat WebSphereICS.queue.manager JDBC WebSphereICS
D:/IBM/WebSphereServer/connectors/JDBC/start_JDBC.bat
Procédure de définition de redémarrage automatique et à distance d'un connecteur sous Linux
Pour définir le redémarrage automatique et à distance d'un connecteur sur une plateforme Linux, procédez comme suit :
- Exécutez le fichier mqtriggersetup avec les arguments requis. Le fichier script shell se trouve dans le répertoire d'installation de votre produit, par exemple : /home/smbadmin/IBM/WebSphereServer/bin/mqtriggersetup.
Les arguments du fichier sont les suivants :
- Nom du gestionnaire de files d'attente correspondant à l'installation du produit, tel que : WebSphereICS.queue.manager
- Nom de l'adaptateur, tel que : JDBC
- Commande complète utilisée pour démarrer l'adaptateur, telle que :/home/smbadmin/IBM/WebSphereItemSync/connectors/JDBC/start_JDBC.sh JDBC WebSphereICS
Par exemple :
mqtriggersetup
WebSphereICS.queue.manager
JDBC
/home/smbadmin/IBM/WebSphereItemSync/connectors/JDBC/start_JDBC.sh
JDBC WebSphereICS
Procédure de redémarrage automatique et à distance d'un connecteur
sous OS/400 et i5/OS
Pour activer le redémarrage automatique et à distance d'un connecteur
sur une plateforme OS/400 et i5/OS, procédez comme suit :
- Exécutez mqtriggersetup.sh avec les arguments requis pour ajouter et configurer une file d'attente afin de transférer l'événement déclencheur. Ce fichier se trouve dans le répertoire d'installation du produit,
par exemple, /QIBM/ProdData/WBIServer44/bin. Les arguments du fichier sont les suivants :
- Nom du gestionnaire de files d'attente
- Nom de l'adaptateur
- Chemin d'accès au script shell pour démarrer l'adaptateur
- Nom d'Interchange Server Express
- Description du travail de l'adaptateur
Par exemple :
mqtriggersetup.sh
Nom_Instance.QUEUE.MANAGER
JDBC
/QIBM/UserData/WBIServer44/QWBIDFT44/connectors/JDBC/start_JDBC.sh
Nom_Instance
QWBIJDBCC
où Nom_Instance désigne le nom de l'instance d'InterChange
Server Express, en lettres majuscules.
- Activez WebSphere MQ Trigger Monitor. Par exemple :
STRMQMTRM INITQNAME(INITIATION.QUEUE)
MQMNAME(Nom_Instance.QUEUE.MANAGER)
où Nom_Instance désigne le nom de l'instance d'InterChange
Server Express, en lettres majuscules.
- Octroyez au profil utilisateur QMQM le droit *USE sur les objets suivants :
Description du travail (*JOBD) de l'adaptateur (par exemple, QWBISVR44/QWBIJDBCC
pour JDBC)
Procédure d'activation des connecteurs pour MQ-triggered OAD
Pour lancer Connector Configurator
Express pour le connecteur avant de définir les propriétés OAD, procédez comme suit :
- Lancez InterChange Server Express.
- Ouvrez System Manager.
- Cliquez deux fois sur le connecteur, sous Bibliothèques des composants d'intégration.
La fenêtre Connector Configurator Express s'ouvre.
- Sur l'onglet Propriétés standard, définissez les propriétés standard illustrées dans le tableau 8.
Tableau 8. Configuration des propriétés standard dans Connector Configurator Express
Nom |
Valeurs possibles |
Description |
Valeurs par défaut |
OADAutoRestartAgent |
true ou false |
Si cette propriété est activée, MQ-triggered
OAD tente automatiquement de redémarrer le connecteur après un arrêt anormal. Elle permet également de démarrer l'agent de connecteur à distance.
Cette valeur est dynamique. |
false |
OADMaxNumRetry |
Nombre |
Nombre maximal de tentatives. |
10 000 |
OADRetryTimeInterval |
Minutes |
Durée en minutes entre chaque nouvelle tentative. Si l'agent de connecteur ne démarre pas pendant ce laps de temps, une nouvelle tentative de redémarrage est effectuée. |
10 |
A partir de Connector Configurator Express, vous pouvez effectuer les actions suivantes :
- Initialisation d'un connecteur pour MQ-triggered OAD :
Pour activer le premier redémarrage automatique et à distance d'un connecteur, procédez comme suit :
- Définissez la propriété OADAutoRestartAgent par True.
- Définissez toutes les autres propriétés OAD souhaitées dans le tableau 8.
- Sauvegardez les propriétés OAD dans Connector Configurator Express.
- Activation/désactivation du redémarrage automatique et à distance :
Modifiez la valeur de la propriété OADAutoRestartAgent de True en False pour activer et désactiver la fonction de redémarrage automatique et à distance.
Cette propriété de connecteur est dynamique, dans le sens où il est inutile de redémarrer InterChange Server Express pour appliquer la modification.
Par conséquent, lorsque vous définissez OADAutoRestartAgent par False, le redémarrage automatique et à distance est désactivé. Lorsque vous définissez cette propriété par True, le redémarrage automatique est activé.
Si vous arrêtez l'agent de connecteur lorsque la fonction de redémarrage automatique et à distance est activée, vous effectuez un arrêt temporaire.
La réponse du connecteur dépend de la méthode que vous utilisez pour l'arrêter, à savoir :
- Si vous arrêtez le connecteur à partir de la fenêtre de démarrage du connecteur (en entrant "q" ou Ctrl+C), l'agent de connecteur s'arrête et MQ-triggered OAD redémarre automatiquement le connecteur.
- Si vous arrêtez le connecteur à partir de System Manager (en cliquant sur le bouton Quitter l'agent), l'agent de connecteur s'arrête. Toutefois, MQ-triggered OAD ne peut pas redémarrer automatiquement le connecteur. Vous devez relancer l'agent à partir de System
Manager (en cliquant sur le bouton Lancer l'agent).
Toutefois, si vous désactivez la fonction de redémarrage automatique et à distance, puis arrêtez l'agent de connecteur, vous effectuez un arrêt définitif, c'est-à-dire que vous devez redémarrer manuellement le connecteur.
Procédure d'utilisation d'OAD sous forme de service Windows
Remarque :
Cette rubrique s'applique uniquement aux plateformes Windows.
Si vous configurez un connecteur pour le redémarrage automatique ou à distance à l'aide d'OAD, ne configurez pas le connecteur pour une exécution sous forme de service Windows automatique. Installez WebSphere MQ Trigger
Monitor pour qu'il s'exécute comme un service Windows. Lorsque le système démarre, OAD démarre automatiquement en tant que service Windows ; lorsqu'InterChange Server
Express redémarre, il lance le connecteur via le programme OAD.
Important :
Par défaut, les connecteurs sont installés en tant que services Windows nécessitant un démarrage manuel. La fonction de redémarrage à distance ne s'exécute pas si le service Windows du connecteur est modifié de manuel en automatique.
Pour installer WebSphere MQ Trigger Monitor en tant que service Windows, procédez comme suit
- Sélectionnez Démarrer > Programmes > IBM WebSphere MQ > WebSphere MQ Services.
- A l'aide du bouton droit de la souris, cliquez sur le gestionnaire de files d'attente utilisé par WebSphere Business Integration Server Express, puis cliquez sur New > Trigger Monitor.
La boîte de dialogue Create Trigger Monitor Service apparaît.
- Cliquez sur l'onglet Parameters. Dans la zone de nom de file d'attente, entrez la chaîne "INITIATION.QUEUE".
Dans la colonne Description, Trigger Monitor apparaît dans la liste des services pour ce gestionnaire de files d'attente.
- Exécutez l'outil de configuration des services Windows. Sélectionnez InterChange Server Express dans la liste des composants de service.
- Dans la zone des dépendances de service, entrez le nom du service Windows OAD.
Après avoir effectué ces opérations, vous pouvez utiliser l'outil de configuration de services de Windows pour lancer et arrêter le programme démon.
Procédure de configuration du contrôle des flux pour les connecteurs
Le contrôle des flux est un service configurable vous permettant de gérer le flux des files d'attente de connecteurs et d'objets de collaboration.
Les paramètres de configuration du contrôle des flux peuvent être définis pour l'ensemble du système, pour des composants individuels ou les deux. Si vous définissez les deux configurations, celle des composants individuels est prioritaire sur celle du système.
Pour plus d'instructions sur la configuration du contrôle de flux sur l'ensemble du système, voir Procédure de configuration du contrôle des flux sur l'ensemble du système. Cette section décrit le mode de configuration du contrôle des flux au niveau des connecteurs.
Remarque :
Les modifications de configuration des connecteurs ou des objets de collaboration individuels sont dynamiques, ce qui signifie qu'il est inutile de réamorcer le système
InterChange Server Express. Les modifications de configuration sur l'ensemble du système pour le contrôle des flux requièrent le réamorçage d'InterChange Server Express.
Pour surveiller le mode de fonctionnement du contrôle de flux dans le système, vous pouvez afficher le moniteur et la vue Contrôle de flux fournis avec System Monitor ou vous pouvez afficher les Statistiques sur les objets de collaboration ou les connecteurs à partir de System Manager dans la vue Gestion de composant InterChange Server. Pour plus d'informations sur l'utilisation du moniteur et de la vue Contrôle des flux dans System Monitor, voir Procédure de révision des moniteurs par défaut et Procédure d'utilisation des vues par défaut.
Pour plus d'informations sur l'affichage du contrôle des flux dans la vue Gestion de composant InterChange Server, voir Procédure de visualisation des statistiques sur les objets de collaboration ou Procédure de visualisation des statistiques de connecteur.
Pour configurer le contrôle des flux sur un connecteur, procédez comme suit :
- Dans System Manager, naviguez vers le connecteur pour lequel vous souhaitez configurer le contrôle des flux, puis cliquez deux fois sur ce connecteur. La fenêtre Connector
Configurator Express apparaît (voir figure 30).
Figure 30. Connector Configurator Express, onglet Propriétés standard
- Dans l'onglet Propriétés standard, cliquez dans la cellule Valeur de la propriété MaxEventCapacity.
- Remplacez la valeur par le nombre maximal d'événements que vous souhaitez mettre en file d'attente pour un connecteur. La valeur admise de cette propriété est comprise entre 1 et 2147483647.
- Cliquez sur Fichier > Sauvegarde> Dans le projet.
Le message suivant apparaît dans la partie inférieure de la fenêtre Connector Configurator Express : Le connecteur 'Nom_connecteur' a été correctement sauvegardé.
- Redéployez le connecteur.
Procédure de modification des profils utilisateur pour les agents d'adaptateur sous OS/400 et i5/OS
Par défaut, les agents d'adaptateur sous OS/400 et i5/OS s'exécutent sous le profil utilisateur QWBISVR44. Ce profil utilisateur dispose donc du droit de lecture et éventuellement de mise à jour sur les informations d'application. Si vous ne pouvez pas accorder ce droit au profil QWBISVR44, vous pouvez modifier le profil utilisateur associé au processus de l'agent d'adaptateur.
Pour modifier le profil utilisateur du processus de l'agent d'adaptateur, procédez comme suit :
- Modifiez la description du travail de l'agent d'adaptateur à l'aide de la commande CL CHGJOBD comme suit :
CHGJOBD JOBD(QWBISVR44/nom_desc_travail)
USER(nouvel_id)
où nom_desc_travail désigne le nom de la description du travail pour l'agent d'adaptateur et nouvel_id le profil utilisateur sous lequel l'agent d'adaptateur doit s'exécuter. Le profil utilisateur nouvel_id doit préalablement disposer des droits sur les informations de votre application.
- Accordez les droits sur la description du travail de l'adaptateur pour votre profil utilisateur à l'aide de la commande CL suivante :
GRTOBJAUT OBJ(QWBISVR44/nom_desc_travail)
OBJTYPE(*JOBD) USER(nouvel_id)
où nom_desc_travail désigne le nom de la description du travail pour l'agent d'adaptateur et nouvel_id le profil utilisateur sous lequel l'agent d'adaptateur doit s'exécuter.
- Accordez les droits sur la bibliothèque QWBISVR44 pour votre profil utilisateur
à l'aide de la commande CL suivante :
GRTOBJAUT OBJ(QWBISVR44) OBJTYPE(*LIB) USER(nouvel_id)
où nouvel_id est le profil utilisateur sous lequel l'agent d'adaptateur doit s'exécuter.
- Accordez les droits sur la description du sous-système QWBISVR44
pour votre profil utilisateur à l'aide de la commande CL suivante :
GRTOBJAUT OBJ(QWBISVR44/QWBISVR44) OBJTYPE(*JOBD) USER(nouvel_id)
où nouvel_id est le profil utilisateur sous lequel l'agent d'adaptateur doit s'exécuter.
- Accordez les droits sur la classe QWBISVR44 de la bibliothèque QWBISVR44
pour votre profil utilisateur à l'aide de la commande CL suivante :
GRTOBJAUT OBJ(QWBISVR44/QWBISVR44) OBJTYPE(*CLS) USER(nouvel_id)
où nouvel_id est le profil utilisateur sous lequel l'agent d'adaptateur doit s'exécuter.
- Accordez les droits sur le répertoire du connecteur où se trouve le script de démarrage de l'adaptateur correspondant à votre profil utilisateur, à l'aide de la commande CL suivante :
CHGAUT OBJ('/chemin_script_de_démarrage')
USER(nouvel_id) DTAAUT(*RWX)
où chemin_script_de_démarrage est le chemin d'accès au script de démarrage de l'adaptateur et nouvel_id le profil utilisateur sous lequel l'agent d'adaptateur doit s'exécuter.
