„La plate-forme EAI “ Initiation à WBI 11/01/2019 „La plate-forme EAI “ Initiation à WBI « Tester avec WBI » 9

Sommaire Objectif Etre opérationnel Les Domaines Création d ’un flux 11/01/2019 Sommaire Objectif Etre opérationnel Les Domaines Création d ’un flux Mise à jour des composants Préparation Tests unitaires Tests intégrés Debugging Ce document est un support de cours; il n ’est donc pas utilisable seul 11/01/2019

L ’objectif Mener les tests des composants WBI développés 11/01/2019

L ’environnement opérationnel Le serveur ICS : un serveur ICS est mutualisé entre plusieurs utilisateurs et applications d’un même environnement (hors DEV) un serveur ICS doit être actif pour que des postes équipés d’un CSM puissent y accéder (un CSM seul ne peut rien faire) un serveur ICS mutualisé doit être lancé par une commande Unix (impossible à faire depuis le CSM) un serveur ICS peut être surveillé, arrêté depuis un CSM deux serveurs ICS peuvent cohabiter sur le même système Unix 11/01/2019

L ’environnement opérationnel Le CSM : chaque utilisateur dispose de son propre CSM sur son poste de travail un seul CSM peut être actif à un moment donné sur un poste de travail (plusieurs instances différentes de CSM peuvent être définies pour accéder à différents environnements) le CSM doit se connecter sur un ICS pour pouvoir accéder aux traitements qui s’y exécutent un CSM peut se connecter à plusieurs ICS 11/01/2019

La plate-forme est opérationnelle, rappels La plate-forme technique est lancée quand : L’ORB a été lancé et est actif L’ICS local a été lancé et est actif Le CSM a été lancé et est actif La connexion du CSM à l’ICS est opérationnelle 11/01/2019

Des exercices Réaliser le lancement de la plate-forme en respectant la séquence normale vérifier que les composants e la plate-forme sont bien opérationnels Des questions? 11/01/2019

La plate-forme est opérationnelle, rappels Le comportement normal de l'ORB est d'être lancé une fois et de ne plus être arrêté L'ORB doit être lancé en premier Le comportement normal de l'ICS est d'être lancé une fois et de ne pas être arrêté sauf besoin spécifique L'ORB doit être actif au lancement de l'ICS Le comportement normal du CSM est d'être lancé ou arrêté exactement quand son utilisateur le souhaite 11/01/2019

Les composants sont opérationnels La Collaboration : une Collaboration doit être “ Startée ” pour pouvoir traiter un événement une Collaboration “ Startée ” traite tous les événements la concernant qui se présentent une Collaboration doit être “ Stoppée ” pour éviter qu’elle traite des événements pour qu’une Collaboration puisse s’exécuter, il faut qu’elle-même et tous ses composants soient “ startés ” 11/01/2019

Les composants sont opérationnels Les connecteurs : un Connecteur doit être “ Starté ” pour pouvoir participer au traitement d’un événement un Connecteur est toujours composé de deux parties : le Controler et l’Agent qui doivent tous deux être “ Startés ” l'Agent est installé sur le système avec lequel il réalise l'interface 11/01/2019

Les composants sont opérationnels Les Maps : une Map doit être “ Startée ” pour pouvoir participer au traitement d’un événement 11/01/2019

Les composants sont opérationnels La signalétique: Triangle vert : “ Starté ” Carré rouge : “ Stopé ” Deux barres jaunes : “ Pausé ” … 11/01/2019

Des exercices Dans la vue ICS, mettre en Start tous les composants qui doivent être lancés Des questions? 11/01/2019

Comment arrêter un flux? Pour ne pas perdre d ’occurrence de flux, il faut: Arrêter les connecteurs qui pollent (en entrée) Laisser la Collaboration traiter tous les flux candidats Stopper la Collaboration 11/01/2019

Les domaines, rappels Le domaine Bibliothèques de composants d'intégration rassemble tous les composants existants Le regroupement de tous les composants dans ce domaine permet le ré-emploi des composants existants Il est matérialisé par un ensemble de répertoires Chaque utilisateur créé ses projets dans le domaine Projets utilisateur et y place les composants nécessaires au support du/des flux sur lesquels il travaille Les composants listés là sont des raccourcis sur les composants apparaissant dans le domaine Composants d'intégration 11/01/2019

Les Bibliothèques de composants d ’intégration Créer: une BBL par ICS identifié pour y regrouper tout ce qui vient de chacun une BBL pour tout ce qui provient d ’ailleurs: démos, exemples, ... 11/01/2019

Création d ’un flux Dans Projets utilisateurs: Clic droit sur Projets Interchange server ou sur Projets utilisateur Sélectionner Nouveau projet ICS Saisir le nom du nouveau flux Sélectionner les composants à "importer", si nécessaire, depuis ceux existants dans les Composants d'intégration 11/01/2019

Création d ’un flux Pour tenir compte des dépendances et ne rien oublier: importer la Collaboration afficher ses dépendances faire passer à droite tout ce qui est nécessaire 11/01/2019

Des exercices Créer un flux nommé Test1 avec plusieurs composants existants Des questions? 11/01/2019

Importation en production Transférer depuis Projets utilisateurs à ICS le flux visé: par Drag/Drop Il faut que chaque composant déjà existant (pas nouveau) soit arrêté pour pouvoir être mis à jour 11/01/2019

Mise à jour des composants en production Les mises à jour sont d'abord enregistrées dans le référentiel (DB2) Pour que ces mises à jour soient prises en compte par l'ICS, faire: Clic droit sur l'instance d'ICS Sélectionner Régénérer Aussi ... 11/01/2019

Mise à jour des composants en production Une action supplémentaire peut être nécessaire pour réaliser la mise à jour de certains types de composants: Un Business Object: Création d'un BO: arrêt/démarrage de l'ICS Différents changements dans un BO: arrêt/relance de l'Agent Une Collab: Des changements de Propriétés: mise à jour dynamique Des changements de code Java: mise à jour dynamique Un connecteur: Ajout d'un nouveau connecteur: arrêt/relance de l'ICS Suppression d'un connecteur: supprimer d'abord les Collaborations objects dépendants Modification/suppression d'un BO dans un connecteur: arrêt/relance du connecteur ... 11/01/2019

Préparation, modifier les Propriétés Pour les Collab, les Maps, les connecteurs pour modifier: les niveaux de trace (Map) les niveaux de transactionnel, le mode de reprise, … (Collab) 11/01/2019

Préparation, compiler Pour les Template, les Maps 11/01/2019

Préparation, ICS et ICS ICS de développement: ICS de Prod: un flux peut être livré sans que tous les composants soient présents ICS de Prod: un flux doit être livré avec tous ses composants (intégrité des références) pour livrer de l ’un à l ’autre, faire: Exporter en tant que fichier de référentiel 11/01/2019

Tests unitaires Disponibles pour: connecteur Map Template 11/01/2019

Tests unitaires pour un connecteur Pour ces tests: communiquer en IDL (pas en MQS) faire du Key polling (pas du polling « à l ’horloge ») utiliser la fonction Virtual test connector (VTC) 11/01/2019

Tests unitaires pour un connecteur La VTC: agit comme un Agent (si un Agent existe pour ce connecteur et est démarré, il faut l ’arrêter) lancement: par Démarrer/Programmes/… la 1ere fois: créer un profil (la configuration) Ici, 2 VTC 11/01/2019

Des exercices Réaliser des tests du connecteur JDBC avec le VTC Des questions? 11/01/2019

Tests unitaires pour une Map Dans le Designer sélectionner l ’onglet Test renseigner : Le nom de l’ASBO Le Contexte appelant les valeurs des attributs ... L ’ASBO Le GBO 11/01/2019

Tests unitaires pour une Map Les valeurs apparaissent dans les attributs de l’objet Cible, ce qui permet de vérifier que la Map a réalisé les actions attendues Les valeurs Cible, en grisé Les valeurs Source 11/01/2019

Tests unitaires pour une Template Réaliser avec une version squelettique du/des GBO concernés 11/01/2019

Tests intégrés pour un flux Lancer : Les Agents Les statistiques de la Collaboration Les composants du flux L’outil déclencheur de l ’événement 11/01/2019

Tests intégrés pour un flux Lancer un Agent: clic sur son icône une fenêtre noire s ’ouvre Si ce connecteur "Poll" en attente d'un événement, plusieurs lignes font défiler dans la fenêtre à l'expiration de chaque intervalle de polling; sinon la fenêtre reste stable. Laisser ces fenêtres d'Agent ouvertes autant que nécessaire; elles permettent de voir "passer" les Business Objects traités par chaque connecteur, si les Trace sont activées Une fenêtre DOS par Agent 11/01/2019

Tests intégrés pour un flux L ’état d ’un Agent? (starté?) Dans la vue ICS: clic droit sur le groupe Connectors Aperçu ici 11/01/2019

Tests intégrés pour un flux Lancer les statistiques de la Collab: pour voir passer les occurrences du flux Dans la vue ICS: clic droit sur la Collab Statistiques ici 11/01/2019

Tests intégrés pour un flux Lancer les composants du flux: connecteurs Maps Collab Signalétique vert, rouge, ... 11/01/2019

Tests intégrés pour un flux Lancer l’outil déclencheur de l ’événement pour: écrire dans une table Events (pas obligatoirement avec un Trigger) envoyer un message MQS envoyer un fichier 11/01/2019

Des exercices Réaliser un test du flux utilisant le connecteur JDBC Des questions? 11/01/2019

Debugging Conserver les fenêtres DOS des connecteurs ouvertes Conserver Statistiques ouvert pour vérifier que les Agents sont Active Consulter les fichiers Log Consulter les fichiers Trace 11/01/2019

Debugging, le Log Les fichiers Log contiennent les messages envoyés par les composants concernés le Loging est toujours actif Il concerne: L'ICS La Collaboration Le connecteur En Windows 11/01/2019

Debugging, le Log Les informations sont envoyés vers: La console STDOUT, par défaut Un fichier Log, si une spécification en a été faite Le format des fichiers Log est décrit dans le document Problem determination guide 11/01/2019

Debugging,le fichier Log de l ’ICS Nommé InterchangeSystem.log Dans le répertoire de base de l’ICS un « incontournable » Très utilisé 11/01/2019

Debugging, la Trace Le Tracing permet de disposer d'informations détaillées concernant les actions prises par les composants concernés Le Tracing n'est actif que s'il a été spécifié Il concerne plusieurs types composants: L'ICS, la Collaboration, le connecteur, la Map, les BO 11/01/2019

Debugging, les fichiers Par défaut, il existe un seul fichier Log et sa dimension est spécifiée Illimitée Pour une bonne exploitation il est utile de: Spécifier une dimension maximum pour le fichier Log De cette manière, quand le fichier Log atteint cette dimension, il est automatiquement archivé et un nouveau fichier est créé Spécifier un nombre >1 pour le fichier Archive De cette manière, quand un nouveau fichier est archivé, les fichiers Archive existants voient leur indice augmenté de 1 et le plus ancien est supprimé 11/01/2019

Des exercices Des questions? 11/01/2019

Fin du module Vos remarques et commentaires peuvent être notés sur la page concernée ou sur cette page avant de les transmettre à votre interlocuteur Ils aideront à améliorer cette initiation 11/01/2019