Dollar Universe Manager pour Java Manuel utilisateur Version : 6.7.01 Date de publication : 2016-09 Automic Software GmbH ii | Copyright Copyright Automic ® et les logo Automic ® sont des marques déposées appartenant à Automic Software GmbH (Automic). L'utilisation de toutes les marques déposées nécessite une autorisation explicite écrite et est soumise aux conditions de la licence. Les logiciels et/ou le programme sont la propriété protégée d'Automic Software. L'accès et l'utilisation de ces derniers sont soumis à des conditions de licence devant être approuvées par écrit. Les logiciels et/ou le programme sont également protégés par des droits de reproduction par des contrats internationaux ainsi que par les lois nationales et internationales. Un accès et/ou une utilisation non autorisés peuvent entraîner des poursuites civiles et pénales. La copie non autorisée et d'autres formes de reproduction partielle ou totale, la décompilation, la reproduction, la modification, ou le développement de produits dérivés du logiciel sont strictement interdits. Le non-respect de ces conditions peut entraîner des poursuites pénales. Sous réserve de modifications. Aucune responsabilité ne sera acceptée pour toute modification, omission, erreur d'impression ou de production. Toute reproduction, totale ou partielle, est strictement interdite. © Copyright Automic Software GmbH. Tous droits réservés. Dollar Universe Manager pour Java Manuel utilisateur | iii Table des matières 1 Release Notes ...................................................................................................................... 5 2 Introduction .......................................................................................................................... 6 2.1 Présentation .................................................................................................................... 6 2.2 Architecture ..................................................................................................................... 6 2.3 Présentation de Java™ Message Service ...................................................................... 7 2.3.1 Le fournisseur JMS ................................................................................................... 7 2.3.2 Les modèles JMS ..................................................................................................... 7 2.3.3 Présentation d'un fournisseur JMS ........................................................................... 9 3 Installation .......................................................................................................................... 11 3.1 Prérequis ...................................................................................................................... 11 3.2 Installer Dollar Universe Manager pour Java™ ............................................................ 11 3.2.1 Structure des répertoires ........................................................................................ 12 3.2.2 Emplacement des fichiers ...................................................................................... 12 3.2.3 Automate Java JEE ................................................................................................ 12 3.3 Mettre à jour Dollar Universe Manager pour Java™ .................................................... 12 4 Configuration ..................................................................................................................... 13 4.1 Administrer le Manager................................................................................................. 13 4.1.1 Activer le Manager pour Java™ ............................................................................. 13 4.1.2 Activer le Manager .................................................................................................. 13 4.1.3 Licence utilisateur ................................................................................................... 14 4.1.4 Démarrer/Arrêter le Manager pour Java™ ............................................................. 14 4.1.5 Désactiver le Manager ............................................................................................ 15 4.1.6 Désactiver le Manager pour Java™ ....................................................................... 15 4.2 Paramètres nœud du Manager pour Java™ ................................................................ 15 4.3 Paramètres du Manager ............................................................................................... 17 4.3.1 Paramètres EJB ..................................................................................................... 17 4.3.2 Paramètres JMS ..................................................................................................... 19 4.4 Journalisation du Manager pour Java™ ....................................................................... 20 5 UniViewer Console ............................................................................................................ 21 5.1 Invoquer un EJB ........................................................................................................... 21 5.1.1 Uproc EJB............................................................................................................... 21 5.1.2 Exécuter une invocation EJB à partir d'une Uproc EJB ......................................... 23 5.2 Envoyer un a Message dans une file ou un sujet ......................................................... 24 5.2.1 Uproc JMS_SEND .................................................................................................. 24 5.2.2 Envoyer un message à partir d'une Uproc JMS_SEND ......................................... 25 5.3 Consommer un Message.............................................................................................. 26 5.3.1 Message Information JMS ...................................................................................... 26 5.3.2 Conditionner une Uproc sur la ressource JMS ....................................................... 27 6 Commandes ....................................................................................................................... 28 6.1 Créer une Uproc ........................................................................................................... 28 iv | Table des matières 6.2 Modifier une Uproc ....................................................................................................... 28 6.2.1 Informations EJB générales ................................................................................... 29 6.2.2 Informations EJB avancées .................................................................................... 29 6.3 Afficher une Uproc ........................................................................................................ 30 6.4 Exécuter un EJB ........................................................................................................... 31 6.4.1 Exemples ................................................................................................................ 32 6.5 Démarrer/Arrêter le Manager ....................................................................................... 33 6.5.1 Démarrage .............................................................................................................. 33 6.5.2 Arrêt ........................................................................................................................ 33 6.5.3 Statut ...................................................................................................................... 33 7 A propos d'Automic, de la communauté et des services .............................................. 34 7.1 La société Automic Software ........................................................................................ 34 7.2 La communauté Automic .............................................................................................. 34 7.3 Centre de téléchargement ............................................................................................ 34 7.4 Support technique ......................................................................................................... 35 7.5 Formation et services ................................................................................................... 35 Chapitre 1 Release Notes | 5 1 Release Notes Le tableau ci-dessous récapitule l'historique des modifications. Les informations sur les corrections de problèmes et sur les problèmes connus sont disponibles les Release Notes Workload Automation ou en contactant le Support technique d'Automic. Date Fonctionnalités clés 11-2014 Les manuels utilisateurs de Dollar Universe changent de look pour s'intégrer dans le monde Automic. 03-2015 Dollar Universe Manager v6.4 pour Microsoft SQL Server utilise l'automate JEE. 03-2016 Variables dans tous les champs d’une Uproc JMS Inclure le contenu d'un fichier dans une commande JMS 6 | Chapitre 2 Introduction 2 Introduction Bienvenue dans le Manuel Utilisateur de Dollar Universe Manager pour Java™! Ce manuel est destiné aux développeurs et operateurs ayant besoin de comprendre rapidement les fonctions de Dollar Universe Manager pour Java™. Le lecteur est supposé être familier avec Dollar Universe, les applications Java™ et l'utilisation de JavaBeans Enterprise. Les administrateurs trouveront également des informations utiles dans la partie « Installation et Configuration ». Ce manuel est un guide d'utilisation de Dollar Universe Manager pour Java™. Il décrit : L’implémentation (l’installation, la configuration et les commandes d’administration) Les interfaces l’utilisateur (UniViewer Console et l’interface ligne de commande). Dollar Universe Manager pour Java™ permet à des Uprocs de Dollar Universe : D'invoquer un EJB D'envoyer des messages à JMS Message Provider (Broker) De se synchroniser (via les conditions des ressources spécifiques JMS) sur l'arrivée d'un message dans le JMS Message Broker Notez que le contenu du message n'a pas d'importance (il n'est pas interprété pour déclencher une Uproc par exemple) seule la présence du message est requise. Les fonctionnalités des services web SOAP et REST, parties intégrantes de Dollar Universe Manager pour Java™, sont décrites dans le Manuel utilisateur de Dollar Universe Manager pour Web Services. 2.1 Présentation Dollar Universe Manager pour Java™ regroupe en version 6 les managers EJB et JMS qui étaient séparés en version 5. Dollar Universe Manager pour Java™ permet à l'automate de Dollar Universe : D'invoquer des Enterprise JavaBeans (uniquement des beans de type session sans état) déployées sur un serveur d'applications Java EE. D'envoyer/de consommer des messages vers/de destinations qui peuvent être des files (Point à Point) ou des sujets (Producteur - consommateur). 2.2 Architecture Dollar Universe Manager pour Java™ est un serveur. Il peut être considéré comme une interface entre Dollar Universe (DUAS) et une ou plusieurs plateformes Java EE. Dollar Universe Manager pour Java™ est un programme Java™ multi-threadé qui lit les messages sur un port TCP/IP dédié. Sous UNIX, le serveur est démarré en tant que processus. Sous Windows, le serveur peut être démarré en tant que service Windows (par défaut) ou en tant que processus. Chapitre 2 Introduction | 7 Dollar Universe Manager pour Java™ n'implémente pas la sécurité EJB. Il n'est donc pas possible d'invoquer un EJB qui requiert une authentification ou une autorisation. Dollar Universe Serveur Dollar Universe Manager pour Java Messages JMS Stubs des EJB Paramètres de configuration Fichier log … Plateforme Java EE Figure 1 : Architecture de Dollar Universe Manager pour Java™ 2.3 Présentation de Java™ Message Service Java Message Service (JMS) est le protocole standard qui permet à des programmes Java™ de créer, d'envoyer et de recevoir des messages d'autres applications Java™ dans un système de messagerie d'entreprise. 2.3.1 Le fournisseur JMS Un fournisseur JMS (broker) est une implémentation de l'interface JMS de Message Oriented Middleware (MOM). Les clients JMS n'échangent pas de messages directement; ils interagissent avec le fournisseur JMS (Message Queue Broker) qui assure la persistance et le transfert des messages. 2.3.2 Les modèles JMS L'API JMS supporte deux modèles: Point à Point ou Producteur - Consommateur. 2.3.2.1 Point à Point Dans le modèle point à point ou file, un émetteur poste les messages dans une file (queue) et le consommateur lit le message dans cette file. Dans ce cas, l'émetteur connait la destination du message et poste le message directement dans la file du consommateur. Les caractéristiques de ce modèle sont les suivantes : Un seul consommateur pourra accéder au message. L'émetteur n'a pas besoin d'être démarré lorsque le récepteur consomme le message, de même, le consommateur n'a pas besoin d'être démarré lorsque le message est émis. Chaque message traité est acquitté par le consommateur. 8 | Chapitre 2 Introduction L'émetteur envoie le message dans une file. Le message persiste jusqu'à ce qu'il soit consommé ou qu'il expire. Il n'existe aucune dépendance temporelle entre l'émetteur et le consommateur. Le message ne peut avoir qu'un seul consommateur. Le message est toujours acquitté après qu'il ait été consommé. 2.3.2.2 Producteur - Consommateur Le modèle Producteur - Consommateur supporte la publication de messages dans un sujet de message. Zéro ou plusieurs abonnés peuvent s'inscrire pour recevoir des messages sur un sujet de message particulier. Dans ce modèle, ni l'éditeur ni l'abonné ne se connaissent. Les caractéristiques de ce modèle sont les suivantes : Plusieurs consommateurs peuvent récupérer le message. Il existe une dépendance temporelle entre le producteur et les consommateurs. Le producteur doit créer un abonnement pour que les clients puissent s'y abonner. L'abonné doit rester actif en permanence pour recevoir des messages, sauf s'il a établi un abonnement durable. Dans ce cas, les messages publiés alors que l'abonné n'était pas connecté seront redistribués lors de sa connexion. Le message est envoyé dans un sujet (topic) où il pourra être lu par plusieurs consommateurs. Les consommateurs doivent tout d'abord s'abonner à ce sujet. Lorsque le producteur envoie un message dans un sujet, les consommateurs peuvent recevoir le message. Le producteur et le consommateur sont anonymes. 2.3.2.3 Application JMS Une application JMS est composée des éléments suivants : Un fournisseur JMS (broker) Des clients JMS : applications Java™ qui envoient et reçoivent des messages Des messages : objets utilisés pour communiquer des informations entre des clients JMS Des objets d'administrés : objets JMS préconfigurés créés par un administrateur pour être utilisés par des clients JMS Pour plus d'informations, reportez-vous aux documents : Spécifications de Java Message Service - version 1.1 : http://www.oracle.com/technetwork/java/jms/index.html Démarrer avec Java Message Service (JMS): http://www.oracle.com/technetwork/articles/java/introjms-1577110.html Chapitre 2 Introduction | 9 2.3.2.4 Java Naming and Directory Interface (JNDI) Java Naming and Directory Interface (JNDI) est une API pour les services de répertoires. Elle permet aux clients de découvrir et de rechercher des données et des objets par leur nom et, comme pour toutes les APIs Java™ qui s'interfacent avec le système hôte, est indépendante de l'application sousjacente. L'API JNDI est utilisée pour rechercher des objets dans un réseau et fournit : Un mécanisme pour lier un objet à un nom Une interface de recherche dans les répertoires qui permet des requêtes générales Une interface événementielle qui permet aux clients de savoir quand les entrées d'un répertoire ont été modifiées Les clients JMS recherchent les objets JMS configurés utilisant l'API JNDI. Les administrateurs JMS utilisent les outils spécifiques au fournisseur pour créer et configurer ces objets. Cette répartition des tâches augmente la portabilité des clients en déléguant le travail spécifique au fournisseur, à l'administrateur. Dollar Universe Manager pour Java™ implémente la spécification JMS 1.1 pour agir en tant qu'application cliente d'un fournisseur JMS. 2.3.3 Présentation d'un fournisseur JMS Dollar Universe Manager pour Java™ agit en tant qu'application cliente d'un fournisseur JMS (Broker). Le Manager se connecte aux : Services de nommage pour récupérer les objets JMS administrés (fabriques de connexions et destinations) Fournisseurs JMS pour produire et consommer des messages 2.3.3.1 Fabrique de connexion Une Fabrique de connexion (Connection Factory) est un objet administré qu'un client utilise pour créer une connexion avec un fournisseur JMS. Les clients JMS accèdent à la fabrique de connexions via des interfaces portables afin que le code ne soit pas modifié si l'implémentation sous-jacente est modifiée. Les administrateurs configurent la fabrique de connexions dans l'espace de noms du Java Naming and Directory Interface (JNDI) pour que les clients puissent les trouver. Selon le type du message, les utilisateurs utiliseront une fabrique de connexion de file (queue connection factory) ou une fabrique de connexion de sujet (topic connection factory). 2.3.3.2 Connexion Lorsqu'une fabrique de connexion est obtenue, une connexion au fournisseur JMS peut être créée. Une connexion représente un lien de communication entre l'application et le serveur de messagerie. Selon le type de la connexion, les connexions permettent aux utilisateurs de créer des sessions pour envoyer et recevoir des messages d'une file ou d'un sujet. 2.3.3.3 Destination Une Destination est un objet administré encapsulant l'identité de la destination d'un message, qui est le lieu où les messages sont livrés et consommés. Ce peut être une file ou un sujet. L'administrateur JMS crée ces objets, et les utilisateurs les découvrent en utilisant le JNDI. Comme pour la fabrique de connexions, l'administrateur peut créer deux types de destinations : des files pour le modèle Point à point ou des sujets pour le modèle Producteur - consommateur. 10 | Chapitre 2 Introduction 2.3.3.4 L'API JMS Pour se connecter aux services de nommage et aux fournisseurs JMS, le Manager a besoin que l'API JMS : Implémente la connexion au service de nommage et de recherche des objets Java™ Implémente la connexion aux fournisseurs JMS et toutes les actions associées (créer un message, envoyer un message et consommer un message ...) Ces classes Java™ sont fournies avec le fournisseur JMS. Elles doivent être installées par l'utilisateur. 2.3.3.5 Liste des principaux fournisseurs JMS De nombreux fournisseurs JMS Open Source et propriétaires JMS existent (cette liste n'est pas exhaustive) : Les fournisseurs open source incluent : ActiveMQ JBossMQ de JBoss Inc. Joram OpenJMS d'OpenJMS Group Les fournisseurs propriétaires incluent : Sun Java System Message Queue d'Oracle BEA WebLogic Serveur JMS d'Oracle BEA Systems EMS de TIBCO Software FioranoMQ Enterprise Messaging XAP de GigaSpaces iBus de Softwired AG IONA JMS d'IONA Technologies webMethods Broker de software AG Nirvana de my-channels SonicMQ d'Oracle SwiftMQ d'Oracle WebSphere MQ d'IBM Chapitre 3 Installation | 11 3 Installation 3.1 Prérequis Pour plus d’informations sur les systèmes d’exploitation et sur la compatibilité avec les autres produits Dollar Universe, reportez-vous à la matrice de compatibilité ("Compatibility Matrix") accessible sur le site du Service Clients, dans l’onglet "Content". Java™ Runtime Environment : Dollar Universe Manager pour Java™ requiert un Java™ Runtime Environment (JRE). Si aucun JRE n'est installé, vous pouvez le télécharger depuis la page http://java.com/fr/ EJB : Enterprise Java Bean Dollar Universe Manager pour Java™ est compatible avec les spécifications EJB version 2.1, 3.1. Java Naming and Directory Service Dollar Universe Manager pour Java™ est compatible avec les spécifications JNDI version 1.2.1. L'installation de Dollar Universe Manager pour Java™ sous Windows requiert la commande reg.exe. JMS : Dollar Universe Manager pour Java™ permet à l'automate de Dollar Universe de communiquer avec d'autres applications clientes JMS via des services de messagerie conformes avec la spécification de Java Message Service 1.1. 3.2 Installer Dollar Universe Manager pour Java™ Dollar Universe Manager pour Java™ est une partie intégrante de Dollar Universe version 6. Lors de l'installation de Dollar Universe version 6 sur votre machine, dans le dialogue "Managers installation" sous Windows ou "Usage of the ODB, EJB, JMS, WSC Managers" sous UNIX/Linux, trois options sont proposées pour le service Java : Remove service ("r") : le Manager pour Java n'est pas installé. Keep service ("k") : le Manager pour Java est installé mais devra être activé par la suite. Reportez-vous à la section "Activer le Manager pour Java™" page 13. Activate service ("a") : le Manager pour Java est installé et activé. Le chemin d'accès complet à un JRE/JDK valide doit être saisi. Par exemple C:\Program Files\Java\jre7 sous Windows ou /usr/bin/java sous UNIX/Linux. Le service Java est utilisé par le Manager pour Oracle Database, par le Manager pour Microsoft SQL Server, par le Manager pour Java (JMS et EJB) et par le Manager pour Web Services. Si le service Java n'est pas installé, aucun de ces Managers ne pourra être activé/utilisé. 12 | Chapitre 3 Installation 3.2.1 Structure des répertoires L’installation copie les fichiers nécessaires au Manager : Le sous-répertoire bin/bin_java de la Société ciblé par la variable UXJEE_DIR_EXEC contient tous les binaires. Le sous-répertoire data/data_java de la Société ciblé par la variable UXJEE_DIR_DATA contient les données et paramètres du Manager. Le sous-répertoire log de la Société ciblé par la variable UXJEE_DIR_LOG contient le journal du produit mgrjava.log. Le sous-répertoire thirdparty de la Société contient les fichiers internes déclarés dans les "Paramètres du Manager". 3.2.2 Emplacement des fichiers Fichiers des Uprocs : Les scripts des Uprocs JMS sont situés dans le répertoire: <SOCIETE>\<espace>\upr. Ils sont écrits en XML. Le codage du nom des Uprocs est décrit dans le Manuel d'Administration de Dollar Universe, section "Identifiants des objets". Fichiers des ressources : Les fichiers de description des ressources JMS sont situés dans le sous-répertoire data\res de la Société. Ils sont également écrits en XML. Journal du Manager : Le fichier journal du Manager est nommé mgrjava.log, il est situé dans le répertoire log de la Société. Journaux des exécutions : Comme pour les autres types d'Uprocs, les résultats d’exécution sont affichés dans le journal de l'Uproc. 3.2.3 Automate Java JEE Lorsque Dollar Universe a été installé ou mis à jour en version 6, l'automate Java JEE est installé. C'est un processus Java lancé par le serveur d'IO. Lorsque l'automate est démarré, il utilise un port TCP. Son numéro est le numéro du port de base de la Société Dollar Universe (par défaut 10600) plus 16, soit 10616 par défaut. 3.3 Mettre à jour Dollar Universe Manager pour Java™ La mise à jour de Dollar Universe Manager pour Java™ pour Dollar Universe v5 (EJB et JMS) en Dollar Universe v6 Manager pour Java™ est décrite dans le Manuel d'Upgrade v5 vers 6 de Dollar Universe. La mise à jour de Dollar Universe v6 Manager pour Java™ est réalisée lors de la mise à jour de Dollar Universe v6. Chapitre 4 Configuration | 13 4 Configuration 4.1 Administrer le Manager En mode Administration d'UniViewer Console, les actions suivantes peuvent être effectuées sur le nœud Dollar Universe : "Activer le Manager pour Java™" page 13. "Activer le Manager" page 13 Modifier les "Paramètres du Manager" page 17. "Désactiver le Manager" page 15 "Désactiver le Manager pour Java™" page 15. En mode Production d'UniViewer Console : Si Dollar Universe Manager pour Java™ est activé sur le nœud Dollar Universe : Suivi > Automates pour afficher si le Manager est démarré ou non. Le Manager ne peut être démarré que si Dollar Universe est démarré. 4.1.1 Activer le Manager pour Java™ Cette action est valide si le Manager pour Java™ est installé mais n’est pas actif. Cette action permet d’activer la gestion des opérations Java™ depuis le nœud Dollar Universe. Elle permet également d'activer par la suite les Managers rattachés : EJB, JMS, Web Services, Oracle DB ou Microsoft SQL Server. Dans UniViewer Console, en mode Administration, cliquez sur la section Nœuds > Nœuds. Sélectionnez le nœud Dollar Universe v6 et cliquez sur Modifier. Dans la section Configuration Service, sélectionnez Manager Java, et cliquez sur Activer. Une fenêtre nommée “Activation : Manager Java” est affichée. Saisissez le numéro de port TCP, par défaut le numéro de port du serveur d'IO X +16 est proposé. Saisissez le chemin d'accès complet à une commande java valide (JRE/JDK), par exemple C:\Program Files\Java\jre7\bin\java.exe. Cliquez sur Activer. Une fenêtre "Traitement…" affiche les actions en cours. Lorsque l'activation est terminée ("…fait"), vous pouvez cliquer sur Fermer. Le message "Succès de la procédure d'activation" est affiché. Cliquez sur Ok et enregistrez les modifications du nœud DUAS. Lors de l'activation, l'automate JEE est automatiquement démarré. 4.1.2 Activer le Manager Cette action est valide si le Manager pour Java™ est actif et si le Manager à activer est "Disponible". Dans UniViewer Console, en mode Administration, cliquez sur la section Nœuds > Nœuds. Sélectionnez le nœud Dollar Universe v6 et cliquez sur Modifier. 14 | Chapitre 4 Configuration Dans la section Configuration Service, sélectionnez le Manager que vous souhaitez activer : EJB, JMS ou Web Services (ces Managers étant liés au Manager pour Java, leur procédure d'activation est identique). Cliquez sur Activer. Une fenêtre nommée “Activation : Manager …” est affichée. Saisissez une Licence utilisateur valide. Si une licence de ce Manager existe déjà dans le fichier des licences du nœud Dollar Universe elle est affichée. Cliquez sur Activer. Une fenêtre "Traitement…" affiche les actions en cours. Lorsque l'activation est terminée ("…fait"), vous pouvez cliquer sur Fermer. Le message "Succès de la procédure d'activation" est affiché. Cliquez sur Ok et enregistrez les modifications du nœud DUAS. Le statut du Manager devient "Activé". 4.1.3 Licence utilisateur L’utilisation de Dollar Universe Manager pour EJB, JMS ou Web Services est soumise à une licence. La clé de la licence doit être déclarée dans le fichier des licences de Dollar Universe. Ce fichier %UNI_DIR_ROOT%\data\u_fali01.txt est créé par la procédure d’installation. La licence peut être saisie: Par UniViewer Console: mode Administration > Nœuds > Nœuds, sélectionnez le nœud Dollar Universe v6 supportant le Manager > Paramètres nœud > Licences. Ou directement par un éditeur de texte. Cette licence est spécifique au nom de nœud Dollar Universe sur lequel le Manager pour Java™ est situé. Les codes du produit sont JMS, EJB ou WSC (pour Web Services); la version du produit est 6. Saisissez la licence valide au format suivant : noeud produit version date_expiration clé Exemples : DU6_node DOLLAR_UNIVERSE:JMS 6 20201231 0123456789ABCDEF DU6_node DOLLAR_UNIVERSE:EJB 6 20201231 0123456789ABCDEF DU6_noeud DOLLAR_UNIVERSE:WSC 6 20201231 0123456789ABCDEF Les licences du Manager sont testées lors de la soumission des jobs. Si Dollar Universe est en période de grâce, une licence JMS ou EJB n'est pas nécessaire. Si Dollar Universe possède une licence, le Manager pour Java devra en posséder une (ou deux) également, sinon les jobs ne pourront pas être soumis. Les clés de licence peuvent être obtenues depuis le site du Service Clients ou par votre contact commercial. 4.1.4 Démarrer/Arrêter le Manager pour Java™ Dollar Universe Manager pour Java™ peut être démarré ou arrêté avec UniViewer Console : en mode Production, sélectionnez l’environnement du nœud Dollar Universe sur lequel le Manager pour Java™ est activé. Puis sélectionnez Suivi > Automates pour afficher la liste des automates. Le Manager pour Java™ est nommé JEE. Il peut être démarré ou arrêté (selon son statut). L'automate JEE est aussi utilisé par le Manager pour Oracle Database, par le Manager pour SQL Server et par le Manager pour Web Services. Si vous arrêtez l'automate JEE vous pouvez interrompre l'activité de ces Managers. Chapitre 4 Configuration | 15 Le Manager ne peut être démarré que si Dollar Universe est démarré. Dollar Universe Manager pour Java™ peut être démarré ou arrêté à l’aide de l’interface commandes. Reportez-vous à la section "Démarrer/Arrêter le Manager" page 33. 4.1.5 Désactiver le Manager Si vous n'utilisez plus le Manager pour EJB, JMS, Web Services, Oracle DB ou Microsoft SQL Server, vous pouvez le désactiver pour libérer des ressources. Cette action n’est possible que si le Manager correspondant est actif. Dans UniViewer Console, en mode Administration, cliquez sur la section Nœuds > Nœuds. Sélectionnez le nœud Dollar Universe v6 et cliquez sur Modifier. Dans la section Configuration Service, sélectionnez le Manager que vous souhaitez désactiver : EJB, JMS ou Web Services, Oracle DB ou Microsoft SQL Server (ces Managers étant liés au Manager pour Java, leur procédure de désactivation est identique) Cliquez sur Désactiver. Une fenêtre nommée “Désactivation : Manager …” est affichée. Cliquez sur Désactiver. Une fenêtre "Traitement…" affiche les actions en cours. Lorsque la désactivation est terminée ("…fait"), vous pouvez cliquer sur Fermer. Le message "Succès de la procédure de désactivation" est affiché. Cliquez sur Ok et enregistrez les modifications du nœud Dollar Universe. La licence du Manager est conservée dans le fichier des licences de Dollar Universe. 4.1.6 Désactiver le Manager pour Java™ Cette action n’est possible que si le Manager pour Java™ est actif. Si vous désactivez ce service, la gestion des opérations Java™ définis pour ce nœud Dollar Universe sera interrompue. La désactivation du Manager pour Java désactive tous les managers rattachés : EJB, JMS, Web Services, Oracle DB et Microsoft SQL Server. Dans UniViewer Console, en mode Administration, cliquez sur la section Nœuds > Nœuds. Sélectionnez le nœud Dollar Universe v6 et cliquez sur Modifier. Dans la section Configuration Service, sélectionnez Manager Java, et cliquez sur Désactiver. Une fenêtre nommée “Désactivation : Manager Java” est affichée. Cliquez sur Désactiver. Une fenêtre "Traitement…" affiche les actions en cours. Lorsque la désactivation est terminée ("…fait"), vous pouvez cliquer sur Fermer. Le message "Succès de la procédure de désactivation" est affiché. Cliquez sur Ok et enregistrez les modifications du nœud Dollar Universe. 4.2 Paramètres nœud du Manager pour Java™ Le tableau suivant décrit les variables du Manager. Ces variables sont définies dans les Paramètres nœud > Manager pour Java du nœud Dollar Universe v6 supportant le Manager. Comme pour Dollar Universe, les variables du Manager sont de type Install (I), Statique (S) ou Dynamique (D). Les variables du Manager liées à l’installation de Dollar Universe ne peuvent pas être 16 | Chapitre 4 Configuration modifiées. Elles sont de type Install (I). Les autres variables de type Statique ou Dynamique peuvent être modifiées avec UniViewer Console ou avec la commande unisetvar. La modification de variables statiques ne sera prise en compte qu'après le redémarrage du Manager pour Java™. Les variables dynamiques sont prises en compte par le Manager sans avoir à le redémarrer. Variable / Nom I/S/D Description UXJEE_MINJVMMEM Taille mémoire initiale de la zone heap (Moctets) S 128 par défaut UXJEE_MAXJVMMEM Taille mémoire maximum de la zone heap (Moctets) S 128 par défaut UXJEE_DIR_ROOT Répertoire racine du manager Java I !UNI_DIR_ROOT! Correspond au répertoire racine de la Société Dollar Universe. UXJEE_DIR_EXEC Répertoire des binaires du manager Java I !UNI_DIR_EXEC!\bin_java Répertoire contenant les exécutables et outils du Manager. Correspond à UXJEE_DIR_ROOT/bin/bin_java UXJEE_DIR_DATA Répertoire des données du manager Java I !UNI_DIR_DATA!\data_java Répertoire contenant toutes les données gérées par le Manager. Correspond à UXJEE_DIR_ROOT/data/data_java UXJEE_DIR_LOG Répertoire des logs du manager Java I !UNI_DIR_LOG! Correspond au répertoire des journaux de la Société Dollar Universe U_LOG_JAVA_LOG4J_FILE Fichier de configuration log4j I !UXJEE_DIR_DATA!\log4j.xml U_LOG_JAVA_LOG_FILE Fichier journal du manager java I !UXJEE_DIR_LOG!\mgrjava.log U_LOG_JAVA_LOG_LEVEL Niveau du journal du Manager Java D FATAL : erreurs fatales uniquement ERROR : toutes les erreurs WARN : toutes les erreurs et les avertissements INFO (valeur par défaut) : toutes les erreurs, les avertissements et les informations TRACE : toutes les erreurs, les avertissements, les informations et les messages de trace DEBUG : tous les messages U_LOG_JAVA_MAX_SIZE_LOG_FILE Taille maximum du fichier journal Java (Mo) S Min 1, défaut 100 U_LOG_JAVA_ARCH_MAX_NB Nombre maximum de fichiers journaux Java archivés D Min 0, défaut 1 UXJEE_JAVA_EXE Chemin d'accès à la commande "java" pour le démarrage du Manager Java D "java" par défaut Chemin d'accès complet à une commande java valide (JRE/JDK), par exemple C:\Program Files\Java\jdk1.6.0_20\bin\java.exe. UXJEE_SSL_SESSION_CACHE_SIZE Taille du cache de sessions SSL D 100 par défaut UXJEE_MAIN_MIN_POOL_SIZE Nombre minimum de threads dans le pool de threads principal S Minimum 0, 5 par défaut UXJEE_MAIN_MAX_POOL_SIZE Nombre maximum de threads dans le pool de threads principal S Minimum 1, 20 par défaut Chapitre 4 Configuration | 17 Variable / Nom I/S/D Description UXJEE_MAIN_POOL_QUEUE_SIZE Taille de la queue du pool de threads principal (0 pour une taille illimitée) S Minimum 0, 200 par défaut UXJEE_MAIN_POOL_KEEP_ALIVE Temps limite en secondes pendant lequel les threads du pool principal peuvent rester actifs S Minimum 0, 120 secondes par défaut UXJEE_SUBMISSION_MIN_POOL_SIZE Nombre minimum de threads dans le pool de threads de soumission S Minimum 0, 1 par défaut UXJEE_SUBMISSION_MAX_POOL_SIZE Nombre maximum de threads dans le pool de threads de soumission S Minimum 1, 100 par défaut UXJEE_SUBMISSION_POOL_QUEUE_SIZE Taille de la queue du pool de threads de soumission (0 pour une taille illimitée) S Minimum 0, 100 par défaut UXJEE_SUBMISSION_POOL_KEEP_ALIVE Temps limite en secondes pendant lequel les threads du pool de soumission peuvent rester actifs S Minimum 0, 120 secondes par défaut UXJEE_HTTP_CONNECTION_TIMEOUT Valeur du timeout sur connexion (en secondes) S Temps maximum d'attente pour la création d'un socket. 120 secondes par défaut. UXJEE_HTTP_READ_TIMEOUT Valeur du timeout pour attendre les données (en secondes) S Temps maximum d'attente pour la lecture des données. 120 secondes par défaut. 4.3 Paramètres du Manager Ces paramètres permettent de configurer la communication entre le Manager et les serveurs d'applications et fournisseurs Java™. En mode Administration, affichez la liste des nœuds. Sélectionnez le nœud Dollar Universe v6 auquel le Manager Java™ est rattaché et cliquez Modifier. Dans la section Configuration service, sélectionnez la ligne Manager EJB ou Manager JMS et cliquez Paramètres du Manager. Pour définir l'un des paramètres ou ajouter une valeur, sélectionnez l'une des sections cidessous et cliquez sur le bouton Ajouter. Selon le paramètre sélectionné, le dialogue est différent. Pour modifier une valeur d'un paramètre, sélectionnez la section et le paramètre à modifier et cliquez sur le bouton Modifier. Pour supprimer une valeur d'un paramètre, sélectionnez la section et le paramètre à modifier et cliquez sur le bouton Supprimer. N'oubliez pas de cliquer sur Enregistrer pour sauvegarder les modifications apportées. Les paramètres des services web sont décrits dans le Manuel utilisateur de Dollar Universe Manager pour Web Services. 4.3.1 Paramètres EJB La modification de ces paramètres peut nécessiter le redémarrage du service JEE. Une confirmation du redémarrage sera demandée à l'utilisateur. 18 | Chapitre 4 Configuration Pour invoquer un EJB sur un serveur d’application, le Manager Java™ a besoin : d’un ensemble de librairies fournies par le serveur d’application (API de communication fournies par le serveur d'applications Java EE, API de communication spécifiques au fournisseur JNDI). C’est le jar technique. d’une représentation locale des EJB à invoquer (un stub), qui se matérialise sous la forme d’une classe, packagée en jar. C’est le jar client. Il y a donc en général un jar technique et plusieurs jars clients. Les jars peuvent être téléchargés en interne dans Dollar Universe ou adressés en externe par le Manager. Si des classes Java™ ne sont pas connues du Manager, une exception Java™ est générée et un message d'erreur est inscrit dans le journal du Manager. En cas d'erreur, l'Uproc s'incidente et en cliquant sur les boutons d'aide aux valeurs dans UniViewer Console, les informations ne peuvent pas être affichées, puisque le serveur Java™ n'a pas pu charger les classes. 4.3.1.1 Fichiers jar techniques internes EJB Cette liste contient l'ensemble des fichiers jars techniques qui sont stockés en interne par le Manager dans le sous-répertoire thirdparty\ejbtech de la Société. Cliquez sur Ajouter pour ajouter un nouveau fichier. Dans la fenêtre affichée, sélectionnez le fichier à importer et cliquez sur Enregistrer. Le nom du fichier est affiché dans la liste (sans le chemin). Le téléchargement des fichiers est réalisé quand l'utilisateur sauvegarde les paramètres. La liste des fichiers est enregistrée dans le fichier data_java\ejb_techjars_int.txt. 4.3.1.2 Fichiers jar techniques externes EJB Cette liste contient l'ensemble des fichiers jars techniques auxquels le Manager peut faire référence. Cliquez sur Ajouter pour déclarer un nouveau fichier ou sur Modifier pour modifier son nom. Dans la fenêtre affichée, saisissez le nom complet du fichier jar externe et cliquez Ok. Le nom complet du fichier est affiché dans la liste. La liste des fichiers est enregistrée dans le fichier data_java\ejb_techjars_ext.txt. 4.3.1.3 Fichiers jar clients internes EJB Cette liste contient l'ensemble des fichiers jars clients qui sont stockés en interne par le Manager dans le sous-répertoire thirdparty\ejbclient de la Société. Cliquez sur Ajouter pour ajouter un nouveau fichier. Dans la fenêtre affichée, sélectionnez le fichier à importer et cliquez sur Enregistrer. Le nom du fichier est affiché dans la liste (sans le chemin). Le téléchargement des fichiers est réalisé quand l'utilisateur sauvegarde les paramètres. La liste des fichiers est enregistrée dans le fichier data_java\ejb_clientjars_int.txt. 4.3.1.4 Fichiers jar clients externes EJB Cette liste contient l'ensemble des fichiers jars clients auxquels le Manager peut faire référence. Cliquez sur Ajouter pour déclarer un nouveau fichier ou sur Modifier pour modifier son nom. Dans la fenêtre affichée, saisissez le nom complet du fichier jar externe et cliquez Ok. Le nom complet du fichier est affiché dans la liste. La liste des fichiers est enregistrée dans le fichier data_java\ejb_clientjars_ext.txt. 4.3.1.5 Connexions JNDI pour EJB Cette section liste les services JNDI connus du Manager. Chapitre 4 Configuration | 19 Service Id : le service JNDI est identifié par un nom choisi arbitrairement. Context Factory : classe Java™ du contexte de nommage (Initial Context Factory). Fournisseur URL : adresse URL du fournisseur. Utilisateur JNDI : utilisateur JNDI si une authentification est requise. Propriétés personnalisées : le Manager paramètre automatiquement la connexion avec certaines propriétés (java.naming.factory.initial, java.naming.provider.url, java.naming.security.principal, java.naming.security.credentials) mais l’utilisateur peut en ajouter de nouvelles au travers des propriétés personnalisées suivant ce qu’accepte le serveur d’application ou le broker. Cliquez sur Ajouter pour ajouter une nouvelle propriété, sélectionnez une propriété dans la liste et cliquez sur Modifier pour modifier sa valeur ou cliquez sur Supprimer pour la supprimer. Cliquez sur Ok pour enregistrer la connexion. Les données sont enregistrées dans le fichier data_java\jee_connections.xml de la Société. 4.3.1.6 Utilisateurs JNDI pour EJB La configuration JNDI peut nécessiter une authentification (utilisateur et mot de passe) lors d'une tentative de connexion. Utilisateur : saisissez le nom de l'utilisateur JNDI. Mot de passe : saisissez le mot de passe de l'utilisateur JNDI Cliquez sur Ok pour enregistrer l'utilisateur JNDI. Les utilisateurs et les mots de passe cryptés sont enregistrées dans le fichier de données data_java\jee_users.xml de la Société. 4.3.2 Paramètres JMS La modification de ces paramètres peut nécessiter le redémarrage du service JEE. Une confirmation du redémarrage sera demandée à l'utilisateur. Les fournisseurs du répertoire JNDI et des serveurs JMS fournissent des classes Java™ qui sont nécessaires au Manager pour accéder au registre JNDI et pour se connecter aux serveurs JMS. Le manager ne délivre aucune librairie Java™ spécifique JNDI ou JMS. L'utilisateur doit déclarer les librairies Java™ de son fournisseur JMS. Vous devez télécharger ou déclarer les jars techniques (API JMS stockées dans les archives Java™) du fournisseur de files de messages (situées dans le répertoire \lib du fournisseur). 4.3.2.1 Fichiers jar techniques internes JMS Cette liste contient l'ensemble des fichiers jars techniques qui sont stockés en interne par le Manager dans le sous-répertoire thirdparty\jmstech de la Société. Cliquez sur Ajouter pour ajouter un nouveau fichier. Dans la fenêtre affichée, sélectionnez le fichier à importer et cliquez sur Enregistrer. Le nom du fichier est affiché dans la liste (sans le chemin). Le téléchargement des fichiers est réalisé quand l'utilisateur sauvegarde les paramètres. La liste des fichiers est enregistrée dans le fichier data_java\jms_techjars_int.txt. 4.3.2.2 Fichiers jar techniques externe JMS Cette liste contient l'ensemble des fichiers jars techniques auxquels le Manager peut faire référence. Cliquez sur Ajouter pour déclarer un nouveau fichier ou sur Modifier pour modifier son nom. Dans la fenêtre affichée, saisissez le nom complet du fichier jar externe et cliquez Ok. Le nom complet du fichier est affiché dans la liste. 20 | Chapitre 4 Configuration La liste des fichiers est enregistrée dans le fichier data_java\jms_techjars_ext.txt. 4.3.2.3 Propriétés personnalisées JMS Le Manager paramètre automatiquement la connexion avec certaines propriétés (java.naming.factory.initial, java.naming.provider.url, java.naming.security.principal, java.naming.security.credentials) mais l’utilisateur peut en ajouter de nouvelles au travers des propriétés personnalisées suivant ce qu’accepte le serveur d’application ou le broker. Nom : saisissez le nom de la propriété personnalisée Valeur : saisissez sa valeur Cliquez sur Ok pour enregistrer la propriété personnalisée. Les données sont enregistrées dans le fichier data_java\jms_custom_properties.xml de la Société. 4.3.2.4 Utilisateurs JNDI pour JMS La configuration JNDI peut nécessiter une authentification (utilisateur et mot de passe) lors d'une tentative de connexion. Utilisateur : saisissez le nom de l'utilisateur JNDI. Mot de passe : saisissez le mot de passe de l'utilisateur JNDI Cliquez sur Ok pour enregistrer l'utilisateur JNDI. Les utilisateurs et les mots de passe cryptés sont enregistrées dans le fichier de données data_java\jee_users.xml de la Société. 4.3.2.5 Utilisateurs JMS Les mots de passe des différents utilisateurs Java™ (JNDI, JMS...) sont cryptés et enregistrés dans la structure de données du Manager. Utilisateur : saisissez le nom de l'utilisateur JMS. Mot de passe : saisissez le mot de passe de l'utilisateur JMS Cliquez sur Ok pour enregistrer l'utilisateur JMS. Les utilisateurs et les mots de passe cryptés sont enregistrées dans le fichier de données data_java\jee_users.xml de la Société. 4.4 Journalisation du Manager pour Java™ Dollar Universe Manager pour Java™ génère des traces afin d’aider l’administrateur à identifier et résoudre des problèmes éventuels. Vous pouvez activer le mode trace du Manager en modifiant le Paramètre nœud du nœud Dollar Universe > catégorie Manager pour Java™> Niveau du journal du Manager Java (U_LOG_JAVA_LOG_LEVEL). Les traces sont enregistrées dans le fichier journal du Manager nommé par défaut mgrjava.log; il est situé dans le répertoire log de la Société. Pour afficher le fichier journal du Manager, dans UniViewer Console, en mode Administration, ouvrez le document Nœuds > Nœuds. Sélectionnez le nœud Dollar Universe v6 et cliquez sur Trace > Journal du Manager pour Java. Chapitre 5 UniViewer Console | 21 5 UniViewer Console UniViewer Console permet de gérer les Uprocs Java™ (EJB ou JMS) et les ressources JMS : Une Uproc de type EJB doit être créée dans Dollar Universe pour invoquer une méthode business d’un EJB. Une Uproc de type JMS doit être créée dans Dollar Universe pour émettre un message. Une ressource de type JMS doit être créée dans Dollar Universe pour consommer un message (file ou sujet). 5.1 Invoquer un EJB Créer une nouvelle Uproc requiert un minimum d'informations : le nom de l'Uproc, l'application associée et le type d'Uproc. Sélectionnez le type EJB puis appuyer sur Editer pour configurer l'invocation de l’EJB. 5.1.1 Uproc EJB Tous les paramètres nécessaires à l'invocation d'un EJB peuvent être saisis à partir de cette fenêtre. Pour alimenter les champs suivants, entrez le nom ou cliquez sur la flèche pour sélectionner un élément dans une liste ou sur l'aide aux valeurs pour afficher le détail des éléments disponibles. Cliquez sur OK pour enregistrer les paramètres et fermer la fenêtre, puis cliquez sur Enregistrer dans la fenêtre de l'Uproc pour enregistrer l'Uproc EJB. 5.1.1.1 Uproc EJB – Section Contexte Connexion JNDI: entrez le nom du service de connexion JNDI qui servira à invoquer l’EJB ou appuyez sur le bouton associé pour afficher la liste des services JNDI connus du Manager pour Java™. Objet JNDI EJB: entrez le nom de l’objet EJB à démarrer parmi ceux connu du JNDI sélectionné. L'étape suivante concerne la sélection de la méthode à utiliser pour invoquer l'EJB. 5.1.1.2 Uproc EJB – Section Méthode Business La sélection d'une méthode Business est obligatoire avant d'invoquer un EJB. Méthode EJB: cliquez sur la flèche pour sélectionner une méthode dans la liste ou sur le bouton de la fenêtre d’aide pour afficher la liste des méthodes Business disponibles. Dans la fenêtre d'aide : La première colonne affiche le nom de la méthode. La deuxième colonne fournit l’information sur le type de méthode ou la classe de la valeur retournée (s’il y en a). La troisième colonne affiche les paramètres de la méthode. La quatrième colonne indique la classe des exceptions que pourrait déclencher la méthode Business. Choisissez la méthode dans la liste et cliquez sur le bouton Sélectionner. 22 | Chapitre 5 UniViewer Console Liste des paramètres de la méthode: Tous les paramètres attendus par la méthode sont affichés dans cette liste. Ils apparaissent dans l’ordre appelé par le Java Bean. Pour changer l’ordre : Sélectionnez le paramètre Cliquez sur Déplacer vers le haut ou Déplacer vers le bas Chaque paramètre attendu aura par défaut la propriété « littéral ». Chaque paramètre de la méthode sélectionnée peut être : Ajouté : cliquez sur le bouton Ajouter. Mis à jour: cliquez deux fois sur le champ du paramètre à changer ((Type, Propriété ou Valeur). Supprimé: sélectionnez le paramètre et cliquez sur le bouton Supprimer. Pour ajouter ou modifier la valeur d'un paramètre, les informations suivantes doivent être saisies : Le Type (ou la classe) d'un paramètre peut être l'un des types de base du langage Java™ : o boolean o string o float o int o long o short o byte o double Ou une classe composée des types précédents : o java.lang.Character o java.lang.Byte o java.lang.Short o java.lang.Integer o java.lang.Long o java.lang.Float o java.lang.Double o java.lang.Boolean o java.lang.String o java.math.BigDecimal o java.math.BigInteger… La Propriété du paramètre peut être : o littéral (normal). o nul (pour spécifier la valeur Java™ "null"). La Valeur du paramètre est saisie dans un champ texte. Dans l'interface graphique, la valeur est toujours spécifiée comme une chaine de caractères (et sera interprétée ensuite par le Manager en fonction du type du paramètre). Cependant, des valeurs de certains types ou classes doivent respecter une syntaxe spécifique : true ou false pour les boolean ou java.lang.Boolean. Chapitre 5 UniViewer Console | 23 un nombre au format correct pour float, int, long, short, double. 5.1.2 Exécuter une invocation EJB à partir d'une Uproc EJB Pour exécuter une méthode d’EJB avec Dollar Universe, il suffit de créer un lancement de la nouvelle Uproc à partir d'UniViewer Console > mode Production > Suivi > Exécutions jobs. Comme pour les autres types d'Uprocs, les résultats d’exécution sont affichés dans le log de l'Uproc. 5.1.2.1 Exécution Uproc EJB terminée L'Uproc se termine correctement si aucune erreur n'est détectée. Le résultat retourné par la méthode est affiché dans le log d'exécution de l'Uproc (si la valeur retournée n'est ni nulle ni vide). Exemple : Log montrant l'exécution correcte d'une Uproc EJB _!================================================ _!** $!** PROCEDURE .. : SAYHELLO $!** VERSION .....: 000 $!** EXECUTION .. : 0000026 _!** _!** PROCESS DATE : 05/17/2013 _!** _!-----------------------------------------------$!** PARAMETERS. : None _!-----------------------------------------------_!** VARIABLES _!================================================ EJB submission successful. Return type: java.lang.String Return value: Hello John is Working! 5.1.2.2 Exécution Uproc EJB incidentée L'Uproc s'incidente si : La méthode EJB retourne une exception. Des paramètres invalides sont détectés lors de l'invocation. Exemple : Log montrant une exécution incidentée à cause d'une exception _!================================================ _!** $!** PROCEDURE .. : TEST $!** VERSION .....: 000 $!** EXECUTION .. : 0000032 _!** _!** PROCESS DATE : 05/17/2013 _!** _!-----------------------------------------------$!** PARAMETERS. : None _!-----------------------------------------------_!** VARIABLES _!================================================ EJB submission business error. Exception message: Invocation failed Exception stack: com.mgr4java.java.EjbException: Invocation failed at com.mgr4java.ejb.internal.EjbInvoker.invokeEjb(EjbInvoker.java:265) ... 24 | Chapitre 5 UniViewer Console Caused by: java.lang.NumberFormatException: For input string: "hello" at java.lang.NumberFormatException.forInputString(NumberFormatException.java:48 ) ... 5.2 Envoyer un a Message dans une file ou un sujet Pour envoyer un message dans une file ou dans un sujet à partir de Dollar Universe, créez une nouvelle Uproc. Saisissez le nom de l'Uproc, sa description, l'application associée et le type d'Uproc JMS_SEND. Puis cliquez sur Editer pour définir les caractéristiques du message. 5.2.1 Uproc JMS_SEND Cliquez sur OK pour enregistrer les paramètres et fermer la fenêtre, puis cliquez sur Enregistrer dans la fenêtre de l'Uproc pour enregistrer l'Uproc JMS. Tous les paramètres nécessaires à l'envoi d'un message peuvent être saisis à partir de cette fenêtre. Ces propriétés correspondent aux valeurs définies dans le stock d'objets du fournisseur JMS. 1. Service de nommage : o URL fournisseur : saisissez l'URL du service de nommage. Par exemple : "t3://mydesktop:7001" o "Initial Context Factory" : saisissez le nom complet de la classe Java™ utilisée pour accéder au service de nommage : Par exemple : "weblogic.jndi.WLInitialContextFactory" o Utilisateur : Optionnel, si aucun utilisateur n'est spécifié, la valeur par défaut (invité) est utilisée par le service de nommage. 2. Connexion et Destination : Ces propriétés spécifient l'objet de fabrique de connexions et la destination du message JMS. Elles correspondent aux objets administrés créés à l'aide de la console d'administration du fournisseur JMS. o Connexion : saisissez le nom de la fabrique de connexions créée dans la console d'administration. Par exemple : "MyConnectionFactory" o Destination : saisissez le nom de l'objet de destination qui recevra le message. Cette propriété correspond au nom de la destination créé dans la console d'administration du fournisseur JMS. Par exemple : "MyQueue" pour une file ou "MyTopic" pour un sujet o Utilisateur : Optionnel, si aucun utilisateur n'est spécifié la valeur par défaut (invité) est utilisée par le fournisseur JMS. 3. Message : Spécifiez les caractéristiques du message à envoyer. Les valeurs par défaut peuvent être conservées. Pour modifier ces valeurs et obtenir plus d'information à leur sujet, consultez les spécifications JMS. o Propriétés du message : pour ajouter des propriétés à un message, cliquez sur Ajouter. Les messages peuvent être sélectionnés pour la consommation selon leurs propriétés. Chapitre 5 UniViewer Console | 25 Les critères de sélection des messages sont définis au niveau de la ressource JMS. Si aucune sélection n'est effectuée, les consommateurs liront le premier message de la file. o Message : texte du message à envoyer. Si le message contient la syntaxe suivante : @INCLUDEFILE(<Nom complet de fichier (avec ou sans variables)>) et uniquement cela, le contenu du fichier est inclus dans le corps de la commande JMS. 4. Cliquez OK. Tous les champs de cette Uproc peuvent contenir une ou plusieurs variables au format !variable!. Lors de l’exécution de l’Uproc, la variable est remplacée par sa valeur dans l’environnement batch. La valeur peut être définie au niveau du nœud, de l’Unité de Gestion, de l’Uproc, de la tâche, du lancement ou par une variable d’environnement batch. 5.2.2 Envoyer un message à partir d'une Uproc JMS_SEND Pour envoyer un message : Vérifiez que le fournisseur JMS est démarré. Exécutez l'Uproc de type JMS_SEND à l'aide d'UniViewer Console, mode Production > Suivi > Exécutions Jobs > Nouvelle exécution. Comme pour les autres types d'Uprocs, les résultats d’exécution sont affichés dans le journal de l'Uproc. Vérifiez dans la console d'administration du fournisseur que le message a été envoyé. 5.2.2.1 Exécution Uproc JMS terminée L'Uproc se termine correctement si aucune erreur n'est détectée. Le résultat retourné par la méthode est affiché dans le log d'exécution de l'Uproc. Exemple : Log montrant l'exécution correcte d'une Uproc JMS _!================================================ _!** $!** PROCEDURE .. : JMS TOPIC $!** VERSION .....: 000 $!** EXECUTION .. : 0000030 _!** _!** PROCESS DATE : 05/17/2013 _!** _!-----------------------------------------------$!** PARAMETERS. : None _!-----------------------------------------------_!** VARIABLES _!================================================ JMS submission successful. 5.2.2.2 Exécution Uproc JMS incidentée L'Uproc s'incidente si : La méthode retourne une exception. Des paramètres invalides sont détectés lors de l'envoi du message. Exemple : Log montrant un Job incidenté à cause d'une exception _!================================================ _!** 26 | Chapitre 5 UniViewer Console $!** PROCEDURE .. : JMS BAD TOPIC $!** VERSION .....: 000 $!** EXECUTION .. : 0000033 _!** _!** PROCESS DATE : 05/17/2013 _!** _!-----------------------------------------------$!** PARAMETERS. : None _!-----------------------------------------------_!** VARIABLES _!================================================ JMS submission business error. Error log: Java exception while sending JMS message : froTopic3333 destination not found in the JNDI context com.UniverseException: froTopic3333 destination not found in the JNDI context at com.mgr4java.jms.internal.JndiService.lookupForDestination(JndiService.java: 169) ... at java.lang.Thread.run(Thread.java:619) Caused by: javax.naming.NameNotFoundException: Unable to resolve 'froTopic3333'. Resolved '' [Root exception is javax.naming.NameNotFoundException: Unable to resolve 'froTopic3333'. Resolved '']; remaining name 'froTopic3333' at weblogic.rjvm.ResponseImpl.unmarshalReturn(ResponseImpl.java:234) ... 5.3 Consommer un Message Pour consommer un message d'une queue ou d'un sujet à l'aide de Dollar Universe, créez une ressource de type JMS. Saisissez le nom de la ressource, sa description et sélectionnez le type JMS. Puis, dans la section Message Information JMS saisissez les caractéristiques de la ressource. 5.3.1 Message Information JMS Service de nommage : Fournisseur URL : par exemple "t3://mydesktop:7001" Initial context Factory : par exemple "weblogic.jndi.WLInitialContextFactory" Utilisateur JNDI : optionnel. Connexion et destination : Connexion : MyConnectionFactory Destination : MyQueue pour une file ou MyTopic pour un sujet Utilisateur : optionnel Message : Sélecteur de message : définit les caractéristiques du message JMS à consommer. Dans l'exemple ci-dessous, aucun critère de sélection n'est spécifié. Cette ressource détecte et consomme le premier message trouvé dans la file quelles que soient ses caractéristiques. Si le message envoyé avait les propriétés suivantes définies dans l'Uproc JMS, par exemple : o Nom : NOM o Type : String o Valeur : FOX Chapitre 5 UniViewer Console | 27 Alors le message peut être ciblé par une ressource selon ces critères en définissant "nom propriété"="valeur propriété" dans le champ Sélecteur de message de la ressource JMS. Par exemple : NOM="FOX" Tous les messages de la file qui ne possèdent pas les propriétés requises seront ignorés. 5.3.2 Conditionner une Uproc sur la ressource JMS Pour consommer le message, créez une Uproc de type CL_INT par exemple, ayant une condition de ressource sur la ressource JMS définie. Lorsque l'exécution de l'Uproc est terminée, vérifiez que le message a été consommé dans la console d'administration du fournisseur JMS, en utilisant l'outil d'affichage des propriétés. 28 | Chapitre 6 Commandes 6 Commandes Les Uprocs EJB peuvent également être gérées depuis l'interface commande. Plusieurs commandes sont disponibles pour créer et modifier des Uprocs d'invocation EJB. Reportez-vous au manuel de l'interface Commandes de Dollar Universe pour plus de détails sur les spécifications générales des commandes. 6.1 Créer une Uproc La commande uxadd UPR ajoute une Uproc à la liste des Uprocs. Les informations complémentaires doivent être saisies en modifiant l'Uproc à l'aide de la commande uxupd. Le type d'Uproc (UPT) doit être EJB. Item Format Défaut NODE= 64c S_NOEUD EXP | SIM | INT | APP 3c S_ESPEXE UPR= 64c VUPR= 3n LABEL= 64c UPT=EJB 10c FPERIOD=N | D | W | T | F | M | 2 | 3 | Q | S | Y 1c N CLFIL=file_name vide DOM= 1c APPL= 64c CLASS= 64c MEMO=N | O | A 1c N NBPER= 2n 0 CLFIL ne peut pas être utilisé si UPT est valorisé à EJB. Exemple : uxadd UPR EXP UPR=EJB_UPR LABEL=\"Ma méthode EJB\" UPT=EJB FPERIOD=D APPL=EJ MEMO=O NBPER=1 6.2 Modifier une Uproc Plusieurs commandes "uxupd UPR" sont nécessaires pour créer une Uproc EJB complète. La première partie de la commande est identique à la commande "uxupd UPR" standard (elle est utilisée pour sélectionner une Uproc particulière) : Item Format Défaut NODE= 64c S_NOEUD EXP | SIM | INT | APP 3c S_ESPEXE UPR= 64c * Chapitre 6 Commandes | 29 Item Format VUPR= 3n * Défaut La seconde partie de la commande est composée d'un verbe (ainsi que des compléments pour certains verbes) pour définir un ensemble de données spécifiques aux Uprocs EJB, et une liste de clés/valeurs pour définir cet ensemble de données. Un seul verbe peut être utilisé dans une commande uxupd. Verbe Complément Description EJB Informations générales EJB. EJB_PARAM add / dlt / ins / upd Paramètres pour la méthode EJB "Business". CREATE_PARAM add / dlt / ins / upd Paramètres pour la méthode EJB "Create". 6.2.1 Informations EJB générales EJB : Informations générales EJB. Item Valeur Défaut Description JNDI= Chaine libre Obligatoire. Nom de connexion JNDI. (correspondant à une URL/classe JNDI). EJBNAME= Chaine libre Obligatoire. Nom du JNDI de l'objet EJB, avec le chemin (contexte). EJBMETHOD= Chaine libre Obligatoire. Méthode EJB "Business" à invoquer. CREATEMETHOD= Chaine libre create Optionnel. Méthode EJB "Create" à invoquer (méthode technique). REMOVE= Y|N N Optionnel. Booléen. Invocation de la méthode "Remove" (yes/no). Exemple : uxupd UPR EXP UPR=EJB_UPR EJB JNDI=MY_JNDI_CONNECTION EJBNAME=ejb/myEjb EJBMETHOD=getAccount CREATEMETHOD=create REMOVE=Y Les items CREATEMETHOD et REMOVE ne sont pas pris en compte par le manager. Pour EJB 2.X : La méthode “create ()” sans argument est toujours appelée par le manager sur l’interface EJBHome Pour EJB 3.0 : Il n’y a pas d’interface EJBHome requise : on accède au bean session directement sans appel à la method “create ()”. 6.2.2 Informations EJB avancées Permet de définir les paramètres des deux méthodes EJB : les méthodes "Business" et "Create". EJB_PARAM add : nouveau paramètre de la méthode "Business". Item Valeur TYPE= Chaine libre PROPERTY= LITERAL | NULL VALUE= Chaine libre Défaut Description Obligatoire. Type ou classe du paramètre. LITERAL Optionnel. Propriété du paramètre. Si "NULL", aucune valeur ne doit être spécifiée. Obligatoire si la propriété "LITERAL" a été spécifiée. Valeur du paramètre de la méthode. Exemples : uxupd UPR EXP UPR=EJB_UPR EJB_PARAM add TYPE=char VALUE=a 30 | Chapitre 6 Commandes uxupd UPR EXP UPR=EJB_UPR EJB_PARAM add TYPE=java.lang.String PROPERTY=NULL EJB_PARAM upd : modifie un paramètre d'une méthode "Business". Item Valeur Défaut PARAM_NB= 001 à 999 Obligatoire. Index du paramètre à modifier. TYPE= Chaine libre Obligatoire. Type ou classe du paramètre. PROPERTY= LITERAL | NULL VALUE= Chaine libre LITERAL Description Optionnel. Propriété du paramètre. si "NULL", aucune valeur ne doit être spécifiée. Obligatoire si la propriété "LITERAL" a été spécifiée. Valeur du paramètre de la méthode. EJB_PARAM ins : insère un paramètre d'une méthode "Business". Item Valeur Défaut PARAM_NB= 001 à 999 Obligatoire. Index du paramètre à insérer. TYPE= Chaine libre Obligatoire. Type ou classe du paramètre. PROPERTY= LITERAL | NULL VALUE= Chaine libre LITERAL Description Optionnel. Propriété du paramètre. si "NULL", aucune valeur ne doit être spécifiée. Obligatoire si la propriété "LITERAL" a été spécifiée. Valeur du paramètre de la méthode. EJB_PARAM dlt : supprime un paramètre d'une méthode "Business". Item Valeur Description PARAM_NB= 001 à 999 Obligatoire. Index du paramètre à supprimer. Pour la méthode "Create", utiliser les verbes suivants (même mécanisme) : CREATE_PARAM add CREATE_PARAM upd CREATE_PARAM ins CREATE_PARAM dlt Le verbe CREATE_PARAM n’est pas pris en compte par le manager. Pour EJB 2.X : La méthode “create ()” sans argument est toujours appelée par le manager sur l’interface « EJBHome ». Pour EJB 3.0 : Il n’y a pas d’interface « EJBHome » requise : on accède au bean session directement sans appel à la method “create ()”. 6.3 Afficher une Uproc uxshw UPR : Pour les Uprocs de type EJB, la commande uxshw upr affiche (dans les catégories "ejb" et "ejb_param") toutes les informations relatives aux caractéristiques EJB. Exemples : uxshw UPR EXP UPR=EJB_UPR Command : uxshw upr upr=ejb_upr vupr=* partage TYPE | upr ITEMS | upr : EJB_UPR | vupr : 000 | class : | clfil : | label : my ejb uproc to display | dom : I Chapitre 6 Commandes | 31 | | | | | | | | | | | | | appl upt fperiod memo nbper incclass launchvar depcon inccon rescon termins formula ejb : : : : : U_ EJB n n 0 : : : : : : : : ( ) ( ) ( ) ( ) ( ) ( ) ( ) ( jndi ejbname ejbmethod createmethod remove ) : ( Param_Nb : 001 type property | ejb_param | | | | | | | | | | create_param sap_xbp2 sap_xbp2_step sap_xbp2_step_pr sap_xbp2_step_ar sap_pchain sap_ipack ftp_get ftp_put Param_Nb : 002 type property value ) : ( ) : ( ) : ( ) : ( ) : ( ) : ( ) : ( ) : ( ) : ( ) : : : : MYJNDI ejb/myEjbObject myMethod create : java.lang.String : NULL : int : literal : 10 6.4 Exécuter un EJB L'interface commande propose une commande permettant de déclencher un EJB directement sans avoir à créer préalablement une Uproc EJB. La commande uxstr peut être utilisée pour soumettre un EJB. Le format de la commande est le suivant : uxstr ejb Item Valeurs autorisées Valeur par défaut Description JNDI= Chaine libre Identifiant JNDI EJBNAME= Chaine libre Objet EJB (nom JNDI) EJBMETHOD= Chaine libre Méthode "Business" de l'EJB à invoquer CREATEMETHOD= Chaine libre "create" Méthode "Create" de l'EJB REMOVE= Y|N "N" Appel de la méthode "remove" de l'EJB 32 | Chapitre 6 Commandes Item Valeurs autorisées EJB_PARAMLIST= | EJB_PARAMFILE= Valeur par défaut Pas de paramètre pour la méthode "Business" EJB_PARAMFILE= Nom de fichier EJB_PARAMLIST= 2048c max ((<type>, Chaine libre <property>, LITERAL | NULL <value>),…) Chaine libre CREATE_PARAMLIST= | CREATE_PARAMFILE= Type ou class du paramètre LITERAL Propriété du paramètre Obligatoire si la propriété est LITERAL Pas de paramètre pour la méthode "Create" CREATE_PARAMFILE = CREATE_PARAMLIST=((<type>, <property>, <value>),…) Description Nom de fichier 2048c max (même syntaxe que le paramètre EJB_PARAMLIST) 6.4.1 Exemples Exemple 1 $UXEXE/uxstr EJB JNDI=JNDI_VAB EJBNAME=/ejb/MaCalculatriceBean EJBMETHOD=addition CREATEMETHOD=create REMOVE=N EJB_PARAMFILE =%uxexe%\paramfile.txt Le contenu du fichier paramfile.txt pourrait être : long,LITERAL,23 long,literal,123 Exemple 2 La commande suivante : $UXEXE/uxstr EJB JNDI=JNDI_SBU1 EJBNAME=/ejb/EJB_simpletype EJBMETHOD=calcul_int EJB_PARAMLIST=\(\(int,LITERAL,10\),\(int,LITERAL,10\),\(int,LITERAL,10\),\(i nt,LITERAL,15\)\) Exécutée dans le script d'une Uproc génère le log suivant : _!================================================ _!** $!** PROCEDURE .. : UPR_UXSTR $!** VERSION .....: 000 $!** EXECUTION .. : 0000022 _!** _!** PROCESS DATE : 00/00/0000 _!** _!-----------------------------------------------$!** PARAMETERS. : None _!-----------------------------------------------_!** VARIABLES _!================================================ ReturnType=int ReturnValue=5 Chapitre 6 Commandes | 33 6.5 Démarrer/Arrêter le Manager Dollar Universe Manager pour Java™ peut être démarré ou arrêté à l’aide de l’interface commandes de Dollar Universe. Exécutez tout d’abord l’environnement logique de Dollar Universe. Puis déplacezvous dans le répertoire des binaires. Par exemple : cd /var/opt/DUAS/UNIVER_saturn . ./unienv.ksh cd bin Le Manager ne peut être démarré que si Dollar Universe est démarré. 6.5.1 Démarrage La commande uxstr fnc fnc=JEE démarre le serveur du Manager. Exemple de démarrage du Manager : ./uxstr fnc fnc=JEE Command : uxstr fnc fnc=JEE exp 6.5.2 Arrêt La commande uxend fnc fnc=JEE arrête le serveur du Manager. Exemple d'arrêt du Manager : ./uxend fnc fnc=JEE Command : uxend fnc fnc=JEE exp L'arrêt de l'automate JEE impacte directement tous les Managers rattachés : Java, Web Services, Microsoft SQL Server, Oracle Database… Si vous arrêtez l'automate JEE vous pouvez interrompre l'activité de ces Managers. 6.5.3 Statut La commande uxlst fnc fnc=JEE vérifie le statut du serveur. Exemple de vérification du statut du Manager : ./uxlst fnc fnc=JEE Command : uxlst fnc fnc=JEE exp FNC COMPANY NODE AREA STATUS START AT STOP AT ACTIVE AT PID CYCLE --- ------- ------------------------------------------------------------------- ------- ------------------------------------------------- -------------------JEE UNIVER vmsdlora12.automic.com X Started 05/11/2012 1056 05/11/2012 1056 25700 0 Les commandes uxstr fnc, uxend fnc et uxlst fnc sont décrites dans le manuel d’installation de Dollar Universe et peuvent être utilisées pour tous les services de Dollar Universe : techniques ou fonctionnels. 34 | Chapitre 7 A propos d'Automic, de la communauté et des services 7 A propos d'Automic, de la communauté et des services Ce sujet présente la société Automic Software et comment tirer parti de toutes les solutions que nous vous proposons. Vous pouvez également accéder à la documentation en ligne d'Automic à l'adresse docs.automic.com. 7.1 La société Automic Software Automic Software est dédiée à l'automatisation de l'entreprise. Automic est la plateforme la plus complète pour l'automatisation de l'entreprise. Fondée en 1985, Automic a lancé la plate-forme d'automatisation indépendante la plus vaste, déployée à l'échelle mondiale qui renforce les applications l'infrastructure et l'entreprise. Maintenant que la consumérisation de l'informatique s'accélère, Automic ré-imagine comment les organisations s'intègrent dans les modèles de services de nouvelle génération comme le Cloud, Big Data et DevOps. Aujourd'hui, nos logiciels automatisent des dizaines de millions d'opérations par jour pour plus de 2000 clients dans le monde entier. Nous défions la pensée conventionnelle, permettant à nos clients d'être plus rapides, plus intelligents dans le contrôle des opérations. Automic – le standard dans l'automatisation de l'entreprise. Pour en savoir plus, visitez notre site web www.automic.com . 7.2 La communauté Automic Vous voulez communiquer avec d'autres utilisateurs Automic pour comparer des idées ou apprendre comment d'autres s'attaquent aux problèmes que vous rencontrez ? Partagez avec d'autres utilisateurs du monde entier pour apprendre comment ils optimisent l'automatisation de l'entreprise à l'aide d'Automic. Dialoguez avec l'équipe Automic pour obtenir des trucs et astuces directement de la source. Rejoignez la communauté Automic et devenez un initié Automic pour être parmi les premiers à recevoir des nouvelles sur les nouveaux produits et événements, parfois même avant qu'ils ne soient annoncés ! 7.3 Centre de téléchargement Assurez-vous que vous utilisez tout le potentiel de nos produits. Le Centre de téléchargement est l'emplacement où vous trouverez les téléchargements des produits, la documentation et les informations sur les nouvelles mises à jour et la résolution des problèmes de votre solution Automic. Tout est regroupé : les mises à jour, les release notes et tous les manuels utilisateurs. Vous trouverez également la description des patchs, les problèmes connus et les solutions de contournement. Chapitre 7 A propos d'Automic, de la communauté et des services | 35 7.4 Support technique Vous pouvez faire confiance à notre équipe de support. Notre équipe de professionnels est à votre service, n'importe où et n'importe quand. Plusieurs centres de supports situés en Europe, en Amérique du nord et en Asie Pacifique constituent le cœur de l'organisation du support Automic. Vos experts Automic de nos équipes de support technique sont au plus à quelques heures de vol, quel que soit le continent sur lequel vos filiales et vos centres de données sont situés. Automic Software est conçue pour fournir une connectivité mondiale à des entreprises internationales. Vous utilisez les logiciels Automic à l'échelle mondiale, vous pouvez donc vous attendre à un service mondial. 7.5 Formation et services Vous voulez en savoir plus sur les solutions Automic ? Nous proposons une gamme de formations sur la façon de tirer le meilleur parti de votre solution Automic. Selon votre localisation, vous pouvez participer aux sessions de formations organisées au centre de formation d'Automic ou nous pouvons organiser des sessions de formation personnalisées sur le site de votre entreprise, selon ce qui vous convient le mieux. Visitez le site du centre de formation pour obtenir des informations détaillées sur les cours proposés.