Installation de W4 BPMN+ ENGINE
Transcription
Installation de W4 BPMN+ ENGINE
Installation de W4 BPMN+ ENGINE Objectifs Niveau Installation de W4 BPMN+ Engine (Windows / UNIX standard / avancée installeur / ligne de commande) Expert Vérification des prérequis et conditions préalables Désinstallation Public Administrateurs Dernière mise à jour 18 / 1 / 2016 www.w4software.com W4 B P MN+ e mb arq u e de s lo gic ie ls t ie rs do nt l e s l ic en c es s o nt r e pr od uit e s c i - d es s o us ---- ---- --- ---- ---- --- ---- ---- ---- --- ---- ---- --- ---- ---- --- ---- ---- --- ---- ---- --- ---- ---- --- ---- ---- --- ---- ---- --- ---- ---- --- --- - ---- --- ---- ---JS O N . or g Cop y rig ht (c) 2 00 2 J S O N. or g Pe rmis s i on is h ere b y gra n te d, f re e o f c ha rg e, t o an y pe rso n o bt a in ing a c o p y of t his s o f t war e a nd a ss o c ia t ed do c umen t at io n fi les ( t he "S o ft wa re ") , t o d ea l in t he S of t wa re wit ho u t res t ri c ti on , in cl ud in g wi th o ut li mit at io n th e rig ht s t o us e , co py, mo dif y, me rge , pu bl ish, di str ibu t e, sub lice n se, an d/ o r sel l cop ies o f t h e S of t wa re, a nd to pe rmi t p er son s to w ho m t he So f t w ar e i s f urn i s h ed t o do s o, s ub j e c t t o t h e f o l l ow ing c on di ti on s : T he ab ove c op y rig ht no t ic e a nd t his p er mis s io n n ot ic e s h a ll be inc l ud ed in a ll co p ies o r s ub s t an t ial p or t ion s of t he S o f twa re . T he So f tw a re s ha l l b e use d f o r G oo d, no t Evi l . T HE SO F T W ARE I S P RO VI DE D " AS I S ", W IT H OU T WA RRA NTY O F A NY KI ND, EX P RES S O R I MP LI E D, I NCL UDI NG BUT NOT LIM ITE D T O THE WA RRA NTIES OF M ERC HAN TAB I LI T Y , F I T NE SS F O R A P A RT I CUL AR PU RPO S E AN D NON IN F RI NGE ME NT . I N NO E V ENT S HA LL T HE AUT H ORS O R C OP Y RI GH T H OL DE RS B E L I AB L E F O R ANY CL AIM, DA MAGE S OR OTHE R L I AB ILITY , W HE THE R IN A N A CTION OF CONTR ACT, TORT OR OTHE RWISE , AR IS I N G F R O M, OU T O F O R I N C O N N E C T I ON WI T H T H E SO F T WA RE OR T H E US E O R O T HE R DE AL I NGS I N T HE S O F T WA RE . ---- ---- --- ---- --- ---- --- ---- --- ---- --- ---- --- ---- ---- --- ---- --- ---- --- ---- --- ---- --- ---- --- ---- ---- --- ---- --- ---- --- ---- --- ---- --- ---- --- ---- -N an oH T T PD Cop y rig ht (c) 20 12 -2 01 3 b y Pa u l S. Ha wke, 2 00 1, 2 00 5 -20 1 3 b y J a rn o E lo ne n, 2 01 0 b y Ko n s ta nt in o s T og ias A ll r igh t s rese rve d. Red is t rib ut io n a nd use i n s ou rc e an d b ina ry f or ms , wi th or wi th o ut mod if ic a ti on , a re p e rmit t ed pr ovid ed t ha t t h e f ollowi ng c on dit io n s a re met : - Re d is t rib ut io ns of s ou rc e c o de mu s t r et ai n t he a bo v e c op y rig h t no t ic e , t his list o f c o nd it io ns an d t he f o llo win g dis cl aim er . - Re dist ri bu ti on s in bin ar y fo rm must re p rod u c e t he a bo v e c o py r igh t no t ic e, t h is lis t of c o nd it io ns a nd t he f oll owi ng dis c la ime r in th e d oc u me nt a t ion an d/ o r ot h er m at e ria ls pro v id ed wit h t he di s tr ibu t io n. - Ne it he r th e na me o f t he Na n oHt t pd o rg an iz a ti on n or t he n am es o f it s c o n tr ibu t or s ma y b e use d to e n do rs e or p rom ot e pro d uc t s de r i v e d f r o m t hi s s o ft w a r e w i t hout sp ecific p rio r written pe rm ission . T HI S S O F T WA RE I S P RO VI DE D B Y T HE CO P YRI G HT HOL DE RS A ND CO NTR IB UT O RS " AS I S " A ND AN Y EX P RES S OR IM PL IED WA RRA NTIES , INCL UDING, BU T NOT L IM ITE D T O, THE IMP L IE D W AR RAN TIE S OF ME RCHA NTA B ILI T Y A ND F I T NE SS F O R A PA RTI CUL A R P URP O S E A RE DI S CLA I ME D. I N NO EV E NT SHA L L T HE C OP Y RI GH T HOL DE R OR CONTR IB UTORS BE LIA BL E FOR A NY DIRE CT, IND IR ECT , INCIDE NTA L, SP E CIAL , E X EM PL AR Y, OR CON SE Q UE NTIAL DA MA GES (INCL UDING, B UT N OT LIM ITE D TO, P ROC URE ME NT OF SUB S TITUTE GOOD S OR SE RV IC ES ; LOS S OF US E, DA TA , OR P ROFITS; OR BU SINE SS INTE RRUP TION ) HOWE VE R CA US ED AND ON A NY THEORY OF L IA B I LITY , WH ETH ER IN CONTRA CT, S TRI CT LIA B IL I TY, OR TORT (INCL UDING NE GL IGE NCE OR OTH ERW IS E ) A RI SI NG I N A NY WA Y OUT OF T HE U SE O F T HI S SO F T W ARE , E VE N I F A DV IS E D O F T HE P OS S IBI L IT Y O F S U C H D AMA G E . ---- ---- --- ---- ---- --- ---- ---- ---- --- ---- ---- --- ---- ---- --- ---- ---- --- ---- ---- --- ---- ---- --- ---- ---- --- ---- ---- --- ---- ---- --- --- - ---- --- ---- ---- Installation de W4 BPMN+ ENGINE L ' acqu isition du p ré s en t do cume nt co nf èr e u n dr oit d ' u t i l i s a t i o n i n c e s s i b l e , n o n e x cl u s i f e t p e r s o n n e l e t n o n u n d r o i t d e p r o p r i ét é . L 'u t i l i s a t i o n , l a c o p i e , la re pr od uctio n e t la d ist rib ut i on d u pr é s ent do cum en t so nt pe rm ises à co nd it ion : 1 . qu e l a men ti on d e dr oi t s d 'a ut eu r c i -d es s u s f i gu re s u r to ute s l es c op i es e t q ue c e tte me nt i on de d ro i ts d'au te ur e t la p r ésen te m ent ion d'a uto r i sat i on ap pa ra issent co njoin te men t ; 2 . q ue le pr ése nt docu me nt n e so it ut ilisé qu 'à de s f i ns d ' info r mat ion et no n comm er ciale s ; 3 . qu e le p r ésen t do cum en t ne so it mo dif ié de q ue l que m ani è re q ue c e s oi t. Tous les produits et marques cités sont la propriété de leurs titulaires respectifs. Les informations contenues dans ce document pourront faire l’objet de modifications sans préavis. © 2014 - 2016 W4. Tous droits réservés. INSTALLATION DE W4 BPMN+ ENGINE TABLE DES MATIÈRES ContentsFINAL I Installer W4 BPMN+ Engine sur Windows et UNIX 6 Configuration système requise 7 Conditions préalables à l’installation 8 Installer W4 BPMN+ Engine via l’installeur 9 Installer W4 BPMN+ Engine en ligne de commande 19 Lancer et arrêter W4 BPMN+ Engine 25 Options d’installation avancées W4 BPMN+ Engine 28 Mise à jour de W4 BPMN+ Engine via l’installeur 30 Mise à jour de W4 BPMN+ Engine en ligne de commande 35 Désinstallation de W4 BPMN+ Engine via l’assistant 40 Désinstaller W4 BPMN+ Engine en ligne de commande 41 Configurer W4 BPMN+ Engine pour démarrer en mode debug 44 Illustrations 48 FINAL 53 of 50 Contents 5 INSTALLATION DE W4 BPMN+ ENGINE 1 [INSTAL . .] Installer W4 BPMN+ Engine sur Windows et UNIX 1 Si vous souhaitez effectuer une installation standard de W4 BPMN+ Engine sur Windows, l’installeur de W4 BPMN+ Engine est l’alternative la plus simple. Si vous fonctionnez sous Windows et nécessitez des options d’installation avancées, ou si vous fonctionnez sous AIX, Solaris, ou Linux, l’installation s’effectue en ligne de commande. Dans les rubriques suivantes nous allons passer en revue les prérequis système et les conditions préalables à respecter avant toute installation, décrire chaque étape de l’installation via l’installeur mais également en ligne de commande, étudier les options d’installation avancées, et aborder la mise à jour ainsi que la désinstallation. COMING UP TOPICS RUBRIQUES À CONSULTER AVANT L’INSTALLATION CONFIGURATION SYSTÈME REQUISE, PG 7 CONDITIONS PRÉALABLES À L’INSTALLATION, PG 8 RUBRIQUES DÉCRIVANT L’INSTALLATION INSTALLER W4 BPMN+ ENGINE VIA L’INSTALLEUR, PG 9 INSTALLER W4 BPMN+ ENGINE EN LIGNE DE COMMANDE, PG 19 OPTIONS D’INSTALLATION AVANCÉES W4 BPMN+ ENGINE, PG 28 RUBRIQUES À CONSULTER À L’ISSUE DE L’INSTALLATION LANCER ET ARRÊTER W4 BPMN+ ENGINE, PG 25 RUBRIQUES DÉCRIVANT LA MISE À JOUR MISE À JOUR DE W4 BPMN+ ENGINE VIA L’INSTALLEUR, PG 30 MISE À JOUR DE W4 BPMN+ ENGINE EN LIGNE DE COMMANDE, PG 35 RUBRIQUES DÉCRIVANT LA DÉSINSTALLATION DÉSINSTALLATION DE W4 BPMN+ ENGINE VIA L’ASSISTANT, PG 40 DÉSINSTALLER W4 BPMN+ ENGINE EN LIGNE DE COMMANDE, PG 41 ÉLÉMENTS DE CONFIGURATION CONFIGURER W4 BPMN+ ENGINE POUR DÉMARRER EN MODE DEBUG, PG 44 7 of 54 body [INSTAL . .] 1.1 Configuration système requise 2 Cette rubrique passe en revue les prérequis système à respecter avant toute installation de W4 BPMN+ Engine. HEADINGS IN THIS TOPIC JRE / JDK, PG 7 PRÉREQUIS SYSTÈME D’EXPLOITATION, PG 7 PRÉREQUIS BASE DE DONNÉES, PG 7 JRE / JDK Pour toute installation de W4 BPMN+ Engine via l’installeur, un JDK (Java Development Kit), ou au moins un JRE (Java Runtime Environment), de version 1.6.0 ou ultérieure, doit être présent sur votre machine. Prérequis système d’exploitation L’installeur de W4 BPMN+ Engine fonctionne sur les plateformes Windows suivantes : Microsoft Windows XP Pro. Microsoft Windows 2003 Server. Microsoft Windows 2008 Server R2 (X86) 64 bits. Microsoft Windows Vista & 7, 32 & 64 bits. W4 BPMN+ Engine peut également s’installer en ligne de commande sur les plateformes UNIX suivantes : AIX 6.1 et versions ultérieures. Solaris 2.8 et versions ultérieures. Linux kernel 2.6 et versions ultérieures. Prérequis base de données W4 BPMN+ Engine est compatible avec les systèmes de gestion de bases de données suivants : H2 SQL. H2 SQL 1.3 est embarqué dans l’installeur de W4 BPMN+ Engine. Microsoft SQL Server 2005 et versions ultérieures. MySQL 5.1 et versions ultérieures. Installation de W4 BPMN+ ENGINE 8 of 54 1.2 [INSTAL . .] Oracle 10g et versions ultérieures. PostgreSQL 8.4 et versions ultérieures. Conditions préalables à l’installation 3 Cette rubrique passe en revue les conditions préalables à respecter avant toute installation de W4 BPMN+ Engine. HEADINGS IN THIS TOPIC JAVA DEVELOPMENT KIT, PG 8 SYSTÈME DE GESTION DE BASES DE DONNÉES, PG 8 Java Development Kit W4 BPMN+ Engine est embarqué avec un JDK (Java Development Kit) 32 bits. Pour utiliser votre propre JDK : Vérifiez que le JDK à utiliser est déclaré dans le PATH. Vérifiez que la variable d’environnement JAVA_HOME est correctement positionnée. Si vous souhaitez utiliser un JDK 64 bits, installez ce JDK avant de procéder à l’installation de W4 BPMN+ Engine. Système de gestion de bases de données Quelle que soit la base de données utilisée, assurez-vous que le SGBD est actif et opérationnel. Au cours de l’installation, vous devrez renseigner l’identifiant et le mot de passe de l’utilisateur système de la base de données, soit : sa pour H2 SQL system pour Oracle sa pour Microsoft SQL Server postgres pour PostgreSQL root pour MySQL Si vous avez l’intention d’installer W4 BPMN+ Engine sur MySQL, vous devez télécharger le pilote JDBC officiel pour MySQL, les bibliothèques correspondantes n’étant pas livrées 9 of 54 avec W4 BPMN+ Engine. Le pilote est disponible au téléchargement sur le site officiel de MySQL. body Pour une installation via l’installeur, un écran spécifique vous demandera de copier le fichier à un emplacement précis. Pour une installation en ligne de commande, la rubrique consacrée à l’installation en ligne de commande indiquera la marche à suivre. 1.3 [INSTAL . .] Installer W4 BPMN+ Engine via l’installeur Cette rubrique concerne les plateformes Windows. 4 L’installeur W4 BPMN+ Engine est conçu pour installer en quelques clics W4 BPMN+ Engine sur les plateformes Windows. Pour les autres plateformes, utilisez la ligne de commande : INSTALLER W4 BPMN+ ENGINE EN LIGNE DE COMMANDE, PG 19 Avant de lancer l’installeur de W4 BPMN+ Engine vous devez avoir consulté les deux rubriques précédentes décrivant les prérequis système et les conditions préalables. Pour consulter les prérequis système : CONFIGURATION SYSTÈME REQUISE, PG 7 Pour consulter les conditions préalables : CONDITIONS PRÉALABLES À L’INSTALLATION, PG 8 Au cours de l’exécution de l’installeur vous pouvez utiliser les boutons Previous (Précédent) et Next (Suivant) si vous souhaitez vérifier ou modifier vos saisies, ou encore le bouton Quit (Quitter) si vous souhaitez abandonner l’installation. Pour installer W4 BPMN+ Engine via l’installeur 1 Lancez l’installeur W4 BPMN+ Engine en double-cliquant sur le fichier W4BPMNplusEngine_win32_setup.exe. L’écran d’accueil de l’installeur s’affiche à l’écran : Installation de W4 BPMN+ ENGINE 10 of 54 Fig 1.1 Installation de W4 BPMN+ Engine via l’installeur (1/12) 2 Cliquez sur Next. L’écran suivant de l’installeur s’affiche. 3 Lisez les informations consignées sur cet écran puis cliquez sur Next. L’écran suivant de l’installeur s’affiche à l’écran : Fig 1.2 4 Installation de W4 BPMN+ Engine via l’installeur (2/12) Prenez connaissance de l’accord de licence. Vous devez accepter les termes de l’accord de licence pour pouvoir poursuivre l’installation. 11 of 54 body 5 Acceptez les termes de l’accord de licence en sélectionnant I accept the terms of the license agreement (J’accepte les termes de l’accord de licence) puis cliquez sur Next. L’écran suivant de l’installeur s’affiche à l’écran : Fig 1.3 Installation de W4 BPMN+ Engine via l’installeur (3/12) L’installeur propose un emplacement par défaut pour l’installation de W4 BPMN+ Engine (C:\Program Files\W4\W4BPMNplusEngine). 6 Vérifiez cet emplacement par défaut, modifiez-le le cas échéant via le bouton Browse (Parcourir), puis cliquez sur Next. 7 Si une fenêtre flottante vous informe du fait que l’emplacement cible va être créé, cliquez sur OK. Si une fenêtre flottante vous informe du fait que l’emplacement cible existe déjà : cliquez sur Yes pour confirmer l’installation à cet endroit puis, de retour sur l’écran de l’installeur, cliquez sur Next. ou : cliquez sur No pour sélectionner un autre emplacement, sélectionnez l’emplacement souhaité puis, de retour sur l’écran de l’installeur, cliquez sur Next. L’écran suivant de l’installeur s’affiche à l’écran. Cet écran est dédié au choix du SGBD. Installation de W4 BPMN+ ENGINE 12 of 54 Fig 1.4 Installation de W4 BPMN+ Engine via l’installeur (4/12) Les cinq possibilités sont les suivantes : H2 SQL (embarqué avec W4 BPMN+ Engine) Oracle Microsoft SQL Server PostgreSQL MySQL 8 Sélectionnez le SGBD approprié puis cliquez sur Next. L’écran suivant de l’installeur s’affiche à l’écran : Fig 1.5 Installation de W4 BPMN+ Engine via l’installeur (5/12) Cet écran varie en fonction du type de base de données sélectionné. Cette illustration s’applique à PostgreSQL. 13 of 54 Cet écran comporte les champs suivants : body Database host name La machine hôte du SGBD sélectionné. Database port Le numéro de port, sur la machine hôte, dédié au SGBD sélectionné. 9 Vérifiez les valeurs proposées, adaptez-les le cas échéant, puis cliquez sur Next. L’écran suivant de l’installeur s’affiche à l’écran : Fig 1.6 Installation de W4 BPMN+ Engine via l’installeur (6/12) Cet écran varie en fonction du type de base de données sélectionné. Cette illustration s’applique à PostgreSQL. Cet écran comporte les champs suivants : Database system user name Le nom de connexion d’un utilisateur système disposant des privilèges de création d’une base de données. Database system password Le mot de passe de l’utilisateur système spécifié. NOTES Si le mot de passe de l’utilisateur système ne doit pas s’afficher en toutes lettres à l’écran, désélectionnez la case à cocher Show password (Afficher le mot de passe). Une puce noire sera affichée dans le champ pour chaque caractère saisi. Cela s’applique également à l’écran suivant. Aucune donnée renseignée pour cet écran ne sera stockée ou utilisée en dehors du contexte de cette installation. Cela s’applique également aux écrans suivants. 10 Vérifiez les valeurs proposées, adaptez-les le cas échéant, puis cliquez sur Next. of 54 L’écran suivant de l’installeur s’affiche à l’écran Cet écran est dédié à la création de la base de données W4 BPMN+ Engine. Fig 1.7 Installation de W4 BPMN+ Engine via l’installeur (7/12) Cet écran comporte les champs suivants : Database name Le nom de la base de données à créer Assurez-vous qu’aucune base de données existante ne possède le nom spécifié pour ce champ. Database user Le nom de l’utilisateur de base de données. Assurez-vous qu’aucun utilisateur ou rôle ne possède le nom spécifié pour ce champ. Si plusieurs instances de W4 BPMN+ sont présentes sur la même machine, chaque instance doit posséder sa propre base de données. Database password Le mot de passe de l’utilisateur spécifié. 11 Vérifiez les valeurs proposées, adaptez-les le cas échéant, puis cliquez sur Next. L’écran suivant de l’installeur s’affiche à l’écran. Cet écran est dédié au nommage de l’instance de W4 BPMN+ Engine. Installation de W4 BPMN+ ENGINE 14 15 of 54 body Fig 1.8 Installation de W4 BPMN+ Engine via l’installeur (8/12) Cet écran comporte les champs suivants : Instance name Le nom de l’instance W4 BPMN+ Engine à créer. Le nom de l’instance spécifié doit être unique sur votre machine. RMI registry port Le numéro de port pour l’accès aux API Java. REST HTTP listening port Le numéro de port pour l’accès aux API REST. / NOTE Les numéros de port spécifiés ne doivent pas être déjà utilisés. Si un conflit est détecté par l’installeur, il vous sera demandé de spécifier un autre numéro de port avant de pouvoir poursuivre l’installation. / 12 Vérifiez les valeurs proposées, adaptez-les le cas échéant, puis cliquez sur Next. L’écran suivant de l’installeur affiche la progression de l’installation : Installation de W4 BPMN+ ENGINE 16 of 54 Fig 1.9 Installation de W4 BPMN+ Engine via l’installeur (9/12) 13 Lorsque l’indicateur de progression est à 100%, cliquez sur Next. 14 [MySQL] Pour une installation sur MySQL, un écran spécifique de l’installeur vous demande de copier la bibliothèque Java MySQL comportant le pilote de base de données à un emplacement précis : 14.1 Si vous ne l’avez pas déjà fait, téléchargez la bibliothèque MySQL à partir du site officiel MySQL. / NOTE Une version 5.x ou ultérieure est requise. / Le fichier se nomme mysql-connector-java-X.X.Xbin.jar. Il est proposé au téléchargement dans la rubrique Downloads > MySQL Connectors > Connector / J. 14.2 Renommez le fichier par : mysql-connector-java.jar 14.3 Copiez le fichier renommé dans le dossier lib\ext\jdbc de votre installation W4 BPMN+ Engine. 14.4 [facultatif] Il est conseillé de copier ce fichier également dans le dossier /lib de W4 BPMN+ Admin, soit par exemple : Pour la version client lourd : sous admin/swing/lib dans le répertoire d’installation de W4 BPMN+ Engine. Pour la version client léger : sous WEB-INF\lib dans le répertoire de déploiement. Cela est nécessaire si vos applications ont vocation à gérer des données complexes. 14.5 De retour sur l’écran de l’installeur, cliquez sur Next. L’écran suivant de l’installeur affiche la progression de l’installation de la base de données. 17 of 54 body Fig 1.10 Installation de W4 BPMN+ Engine via l’installeur (10/12) Des messages du type Setup succeeded (Installation réussie) et Service started (Service démarré) indiquent une installation réussie. 15 Cliquez sur Next. L’écran suivant de l’installeur s’affiche à l’écran : Fig 1.11 16 Installation de W4 BPMN+ Engine via l’installeur (11/12) Sélectionnez un groupe de programmes dans le menu Démarrer de Windows pour la création d’un raccourci vers W4 BPMN+ Engine. Si aucun groupe n’est sélectionné, le raccourci sera créé à la racine du menu Démarrer. of 54 Le raccourci proposé par défaut est : W4/W4 BPMN+ Engine. Vous pouvez modifier cette valeur le cas échéant. Le raccourci est créé par défaut pour tous les utilisateurs de la machine hôte de W4 BPMN+ Engine. Vous pouvez choisir de créer le raccourci pour l’utilisateur courant uniquement. Pour ignorer cette étape, désélectionnez la case à cocher Create shortcuts in the Start menu (Créer les raccourcis dans le menu Démarrer). 17 Cliquez sur Next. Le dernier écran de l’installeur s’affiche à l’écran. Fig 1.12 Installation de W4 BPMN+ Engine via l’installeur (12/12) Le message Installation has completed successfully (L’installation a réussi) doit s’afficher. 18 Cliquez sur Done (Terminé) pour quitter l’installeur. 19 Demandez et installez votre clé de licence définitive : 19.1 Faites parvenir le fichier primary.key au Support W4 à l’adresse [email protected]. Ce fichier est situé à la racine de votre installation W4 BPMN+ Engine, soit par exemple : C:\Program Files\W4BPMNplusEngine\primary.key 19.2 Arrêtez W4 BPMN+ Engine. 19.3 Copiez le fichier license.key transmis par le Support W4 à ce même emplacement. 19.4 Redémarrez W4 BPMN+ Engine. ÉCHEC DU REDÉMARRAGE ? Si W4 BPMN+ Engine ne redémarrage pas, faites parvenir le fichier invalidLicense, situé à la racine de votre installation W4 BPMN+ Engine, soit par exemple : C:\Program Files\W4BPMNplusEngine\invalidLicense, au Support W4 à l’adresse [email protected]. Installation de W4 BPMN+ ENGINE 18 Pour plus d’informations sur le démarrage et l’arrêt de W4 BPMN+ Engine : LANCER ET ARRÊTER W4 BPMN+ ENGINE, PG 25 1.4 [INSTAL . .] Installer W4 BPMN+ Engine en ligne de commande Cette rubrique concerne toutes les plateformes. 5 Cette rubrique comporte des instructions pas à pas pour l’installation de W4 BPMN+ Engine en ligne de commande. Pour une installation sur Windows via l’installeur : INSTALLER W4 BPMN+ ENGINE VIA L’INSTALLEUR, PG 9 La procédure décrite ci-dessous concerne une installation standard. Si vous vous trouvez dans l’un des cas de figure suivants (liste non exhaustive) vous devez plutôt procéder à une installation en utilisant les options avancées : La base de données W4 BPMN+ Engine va être créée par l’administrateur. La base de données W4 BPMN+ Engine va être installée sur un schéma existant. [Windows] W4 BPMN+ Engine ne doit pas être installé en tant que service Windows. Le schéma de la trace d’audit (audit trail) ne doit pas être installé. Les scripts SQL scripts doivent être seulement générés et non exécutés. Les valeurs par défaut pour les options avancées seront modifiables via le menu setup avant de lancer l’installation (c.-à-d. avant de lancer la commande I - Install software). Pour passer en revue les options avancées : OPTIONS D’INSTALLATION AVANCÉES W4 BPMN+ ENGINE, PG 28 Avant de procéder à l’installation de W4 BPMN+ Engine vous devez vérifier les prérequis système. Pour vérifier les prérequis système : CONFIGURATION SYSTÈME REQUISE, PG 7 La procédure décrite ci-dessous s’applique à toutes les plateformes. Certaines étapes sont spécifiques à une plateforme. Ces étapes sont précédées par le nom de la plateforme correspondante entre crochets. Pour installer W4 BPMN+ Engine en ligne de commande 1 [Windows] Double-cliquez sur le fichier install.bat. [UNIX] Dans le répertoire d’extraction, exécutez le programme install. Le menu install s’affiche : of 54 1 - Software home: <not set> I - Install software X - Exit > Fig 1.13 Installation de W4 BPMN+ Engine en ligne de cmd (1/14) 2 Pour spécifier le répertoire d’installation, saisissez 1 puis validez par ENTRÉE. 3 À l’invite Enter software home, saisissez le chemin complet vers le répertoire souhaité ... > 1 Enter software home: > C:\Program Files\W4\W4BPMNplus Fig 1.14 Installation de W4 BPMN+ Engine en ligne de cmd (2/14) ... puis validez par ENTRÉE. 4 De retour dans le menu install, saisissez I puis validez par ENTRÉE. > I Copying files... ............................................................................... ............................................................................... ............................. Fig 1.15 5 Installation de W4 BPMN+ Engine en ligne de cmd (3/14) À l’invite Do you wish to perform the product setup (YES/no) ... ............................................................................... ............................. Do you wish to perform the product setup? (YES/no) > Fig 1.16 Installation de W4 BPMN+ Engine en ligne de cmd (4/14) [Tous serveurs de bases de données sauf MySQL] ... appuyez sur ENTRÉE. [MySQL] ... avant de poursuivre l’installation sur MySQL vous devez copier la bibliothèque Java MySQL contenant le pilote de base de données dans le répertoire d’installation : Saisissez no puis validez par ENTRÉE (à l’invite Do you wish to perform the product setup). Saisissez no à nouveau puis validez par ENTRÉE à l’invite Display information log?. Appuyez sur n’importe quelle touche pour quitter le menu install. Téléchargez la bibliothèque MySQL à partir du site officiel MySQL. / NOTE Une version 5.x ou ultérieure est requise. / Le fichier se nomme mysql-connector-java-X.X.Xbin.jar. Il est proposé au Installation de W4 BPMN+ ENGINE 20 21 of 54 téléchargement dans la rubrique Downloads > MySQL Connectors > Connector / J. Renommez le fichier par : mysql-connector-java.jar Copiez le fichier renommé dans le dossier lib\ext\jdbc de votre installation W4 BPMN+ Engine. [facultatif] Il est conseillé de copier ce fichier dans le dossier /lib de W4 BPMN+ Admin, soit par exemple : Pour la version client lourd : sous admin/swing/lib dans le répertoire d’installation de W4 BPMN+ Engine. Pour la version client léger : sous WEB-INF\lib dans le répertoire de déploiement. Cela est nécessaire si vos applications ont vocation à gérer des données complexes. Ouvrez le menu setup via le fichier setup situé dans le dossier setup du répertoire d’installation de W4 BPMN+ Engine. Le menu setup s’affiche. body 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 S J I W X - Instance name: default Database type: <not set> Data source class name: [auto] Database server name: <not set> Database port number: <not set> Database name: w4engine Database user name: w4engine Database user password: <not set> Definition file: <none> RMI registry port: 7707 REST HTTP listening port: 7705 Create user/database: yes Install the database: yes Upgrade the database: no Install as a service (windows only): no Create or upgrade database schema: yes Create or upgrade audit trail schema: yes Insert default data to database: yes Effectively run the database scripts: yes Install Document Storage Service: yes Save configuration Import definition file (does nothing more) Install software (saves configuration and imports definition file too) Uninstall software Exit > Fig 1.17 Installation de W4 BPMN+ Engine en ligne de cmd (5/14) MENU SETUP Les lignes numérotées de 1 à 11 correspondent aux options d’installation disponibles. Les lignes numérotées de 12 à 20 correspondent aux options avancées. Les lignes commençant par une lettre correspondent aux commandes disponibles. Pour renseigner ou modifier une valeur, saisissez le numéro de l’option correspondante puis validez par ENTRÉE et suivez les instructions qui s’affichent à l’écran. Pour les options attendant des valeurs booléennes, le fait de saisir le numéro de l’option et de valider par ENTRÉE fait automatiquement basculer la valeur de l’option entre les valeurs yes et no. Pour plus d’informations sur les options avancées : OPTIONS D’INSTALLATION AVANCÉES W4 BPMN+ ENGINE, PG 28 of 54 L’instance du moteur se nomme default par défaut. Modifiez le nom par défaut à votre convenance. Il est fortement recommandé de modifier le nom d’instance lorsque vous réinstallez W4 BPMN+ Engine sur une même machine. 6 Pour renseigner le nom de l’instance : 6.1 Saisissez 1 puis validez par ENTRÉE. 6.2 À l’invite Enter instance name, saisissez la valeur souhaitée ... > 1 Enter instance name: > bpmn04 Fig 1.18 Installation de W4 BPMN+ Engine en ligne de cmd (6/14) ... puis validez par ENTRÉE. Le menu setup s’affiche à nouveau. W4 BPMN+ Engine supporte les serveurs de bases de données suivants : Microsoft SQL Server Oracle PostgreSQL MySQL H2 7 Pour renseigner le serveur de bases de données : 7.1 Saisissez 2 puis validez par ENTER. 7.2 À l’invite Choose database type, saisissez le numéro correspondant au serveur de bases de données souhaité ... > 2 Choose database type: 1 - Microsoft SQL Server 2 - Oracle 3 - PostgreSQL 4 - MySQL 5 - H2 R - Return > 3 Fig 1.19 Installation de W4 BPMN+ Engine en ligne de cmd (7/14) ... puis validez par ENTRÉE. Le menu setup s’affiche à nouveau. 8 Pour renseigner le nom du serveur de bases de données : 8.1 Saisissez 4 puis validez par ENTRÉE. 8.2 À l’invite Enter server name, saisissez le nom ou l’adresse IP du serveur hôte... Installation de W4 BPMN+ ENGINE 22 23 of 54 body > 4 Enter server name: > localhost Fig 1.20 Installation de W4 BPMN+ Engine en ligne de cmd (8/14) ... puis validez par ENTRÉE. Le menu setup s’affiche à nouveau. 9 Vérifiez ou modifiez la valeur de l’option 5 - Database port number. Il s’agit du numéro de port dédié au serveur de bases de données sur la machine hôte. Cette option est automatiquement renseignée en fonction de la valeur sélectionnée pour l’option 2 - Database type. Les valeurs par défaut suivantes s’appliquent : [Microsoft SQL Server] 1433 [Oracle] 1521 [PostgreSQL] 5432 [MySQL] 3306 [H2] 7707 10 Vérifiez ou modifiez la valeur de l’option 6 - Database name. Il s’agit du nom de la base de données à créer. Assurez-vous qu’aucune base de données existante ne possède le même nom. 11 Vérifiez ou modifiez la valeur de l’option 7 - Database user name. Il s’agit du nom de l’utilisateur de base de données. Assurez-vous qu’aucun utilisateur ou rôle existant ne possède le même nom. Le mot de passe correspondant doit également être renseigné. 12 Renseignez le mot de passe de l’utilisateur de base de données : 12.1 Saisissez 8 puis validez par ENTRÉE. 12.2 À l’invite Enter database password, saisissez la valeur appropriée ... / NOTE Renseignez le mot de passe avec précaution car votre saisie ne s’affiche pas à l’écran. / > 8 Enter database password (keyboard input is hidden): > Fig 1.21 Installation de W4 BPMN+ Engine en ligne de cmd (9/14) ... puis validez par ENTRÉE. Le menu setup s’affiche à nouveau. 13 Saisissez I puis validez par ENTRÉE pour lancer l’installation. 14 À l’invite Start install ... of 54 > I Start install ? (YES/no) > Fig 1.22 Installation de W4 BPMN+ Engine en ligne de cmd (10/14) ... appuyez sur ENTRÉE. 15 À l’invite Enter database administrator username, saisissez le nom de connexion d’un utilisateur système disposant des privilèges de création d’une base de données ... Enter database administrator username: > postgres Fig 1.23 Installation de W4 BPMN+ Engine en ligne de cmd (11/14) ... puis validez par ENTRÉE. 16 À l’invite Enter database administrator password, saisissez le mot de passe de l’utilisateur système renseigné ... / NOTE Renseignez le mot de passe avec précaution car votre saisie ne s’affiche pas à l’écran. / Enter database administrator password (keyboard input is hidden): > Fig 1.24 Installation de W4 BPMN+ Engine en ligne de cmd (12/14) ... puis validez par ENTRÉE. 17 À l’invite Database must be running, continue ? <YES/no>... Database must be running, continue ? (YES/no) > Fig 1.25 Installation de W4 BPMN+ Engine en ligne de cmd (13/14) ... validez par ENTRÉE. Le programme ne rend la main à l’utilisateur qu’après quelques minutes. Un message du type Setup succeeded (Installation réussie) doit s’afficher : Installation de W4 BPMN+ ENGINE 24 25 of 54 body Setup succeeded Database script file: [C:\WINDOWS\TEMP\W4BPMN+Engine3711158956578192640.sql] Log file: [C:\WINDOWS\TEMP\W4BPMN+Engine661075023175444101.log] Display Setup log ? (yes/NO) > Fig 1.26 Installation de W4 BPMN+ Engine en ligne de cmd (14/14) 18 À l’invite Display setup log ? (yes/NO), choisissez d’afficher ou non les logs relatifs à l’installation : Pour afficher les logs, saisissez yes puis validez par ENTRÉE. Après avoir consulté les logs, appuyez sur ENTRÉE. Pour ne pas afficher les logs, appuyez sur ENTRÉE. 19 À l’invite Appuyez sur une touche pour continuer, appuyez sur n’importe quelle touche pour quitter le menu setup. 20 Demandez et installez votre clé de licence définitive : 20.1 Faites parvenir le fichier primary.key au Support W4 à l’adresse [email protected] Ce fichier est situé à la racine de votre installation W4 BPMN+ Engine, soit par exemple : C:\Program Files\W4BPMNplusEngine\primary.key 20.2 Arrêtez W4 BPMN+ Engine. 20.3 Copiez le fichier license.key transmis par le Support W4 à ce même emplacement. 20.4 Redémarrez W4 BPMN+ Engine. Pour plus d’informations sur le démarrage et l’arrêt de W4 BPMN+ Engine : LANCER ET ARRÊTER W4 BPMN+ ENGINE, PG 25 1.5 [INSTAL . .] Lancer et arrêter W4 BPMN+ Engine 6 Il existe plusieurs modes de lancement et d’arrêt de W4 BPMN+ Engine selon que vous fonctionnez sous Unix ou Windows. Sous Windows, vous pouvez utiliser les raccourcis du menu Démarrer de Windows, les services Windows, si ceux-ci ont été installés, ou encore les scripts dédiés. HEADINGS IN THIS TOPIC POUR LANCER W4 BPMN+ ENGINE SOUS UNIX, PG 26 POUR LANCER W4 BPMN+ ENGINE SOUS WINDOWS, PG 26 POUR ARRÊTER W4 BPMN+ ENGINE SOUS UNIX, PG 27 POUR ARRÊTER W4 BPMN+ ENGINE SOUS WINDOWS, PG 27 of 54 Pour lancer W4 BPMN+ Engine sous UNIX Suivez les étapes ci-dessous pour lancer W4 BPMN+ Engine sous UNIX. 1 Exécutez le fichier startup.sh, dans le dossier bin du répertoire d’installation de W4 BPMN+ Engine. Pour lancer W4 BPMN+ Engine sous Windows Suivez les étapes ci-dessous pour lancer W4 BPMN+ Engine sous Windows. VIA LE MENU DÉMARRER DE WINDOWS Sélectionnez W4 BPMN+ Engine W4 BPMN+ Engine Start Service dans votre menu Windows Démarrer. Cette possibilité s’applique si W4 BPMN+ Engine a été installé via l’installeur. / NOTE Le groupe du menu Démarrer dépend de la valeur renseignée à l’étape correspondante de l’installeur / VIA LE SERVICE WINDOWS Lancez le service correspondant dans les services Windows. Le nom du service est W4 BPMN+ Engine suivi du nom de l’instance et du numéro de port RMI entre parenthèses, soit par exemple : W4 BPMN+ Engine (default - 7707). Cette possibilité s’applique si W4 BPMN+ Engine a été installé via l’installeur, ou en ligne de commande si l’option de création du service Windows avait été activée. VIA UN SCRIPT Exécutez le fichier startupService.bat, dans le dossier bin du répertoire d’installation de W4 BPMN+ Engine. Un message du type Service W4_BPMN+Engine_instance* started doit s’afficher dans une fenêtre de commande : ************* STARTING W4_BPMN+Engine_bpmn08 *********************** Service W4_BPMN+Engine_bpmn08 started Appuyez sur une touche pour continuer . . . Fig 1.27 Démarrage de W4 BPMN+ Engine * où instance représente le nom de l’instance de W4 BPMN+ Engine. / NOTE Sous Windows 7, si le service ne parvient pas à démarrer (message Service [...] NOT started), exécutez le script en tant qu’administrateur : cliquez-droit sur le fichier startupService.bat et sélectionnez Exécuter en tant qu’administrateur. / VIA UN SCRIPT NON INTERACTIF Exécutez le fichier startupServiceNotInteractive.bat, dans le dossier bin du répertoire d’installation de W4 BPMN+ Engine. Installation de W4 BPMN+ ENGINE 26 27 of 54 EN MODE CONSOLE body Exécutez le fichier startupConsole.bat, dans le dossier bin du répertoire d’installation de W4 BPMN+ Engine. Pour arrêter W4 BPMN+ Engine sous UNIX Suivez les étapes ci-dessous pour arrêter W4 BPMN+ Engine sous UNIX. 1 Exécutez le fichier shutdown.sh, dans le dossier bin du répertoire d’installation de W4 BPMN+ Engine. Pour arrêter W4 BPMN+ Engine sous Windows Suivez les étapes ci-dessous pour lancer W4 BPMN+ Engine sous Windows. VIA LE MENU DÉMARRER DE WINDOWS Sélectionnez W4 BPMN+ Engine W4 BPMN+ Engine Shutdown via le menu Démarrer de Windows. Cette possibilité s’applique si W4 BPMN+ Engine a été installé via l’installeur. / NOTE Le groupe du menu Démarrer dépend de la valeur renseignée à l’étape correspondante de l’installeur. / VIA LE SERVICE WINDOWS Arrêtez le service correspondant dans les services Windows. Le nom du service est W4 BPMN+ Engine suivi du nom de l’instance et du numéro de port RMI entre parenthèses, soit par exemple : W4 BPMN+ Engine (default - 7707). Cette possibilité s’applique si W4 BPMN+ Engine a été installé via l’installeur, ou en ligne de commande si l’option de création du service Windows avait été activée. VIA UN SCRIPT Exécutez le fichier shutdown.bat, dans le dossier bin du répertoire d’installation de W4 BPMN+ Engine. Un message du type Done doit s’afficher dans une fenêtre de commandes : Done! Appuyez sur une touche pour continuer . . . Fig 1.28 Arrêt de W4 BPMN+ Engine VIA UN SCRIPT NON INTERACTIF Exécutez le fichier shutdownNotInteractive.bat, dans le dossier bin du répertoire d’installation de W4 BPMN+ Engine. of 54 1.6 [INSTAL . .] Options d’installation avancées W4 BPMN+ Engine Cette rubrique s’applique à l’installation en ligne de commande. 7 Les valeurs par défaut des options du programme d’installation conviennent pour une installation standard. Vous pouvez cependant être amenés à modifier les valeurs de certaines de ces options. Cette rubrique passe en revue les options avancées dans leur ordre d’apparition dans le menu setup. HEADINGS IN THIS TOPIC CREATE USER/DATABASE, PG 28 INSTALL THE DATABASE, PG 28 UPGRADE THE DATABASE, PG 29 INSTALL AS A SERVICE (WINDOWS), PG 29 CREATE OR UPGRADE DATABASE SCHEMA, PG 29 INSTALL OR UPGRADE AUDIT TRAIL SCHEMA, PG 29 INSERT DEFAULT DATA TO DATABASE, PG 30 EFFECTIVELY RUN THE DATABASE SCRIPTS, PG 30 INSTALL DOCUMENT STORAGE SERVICE, PG 30 Create user/database L’option 12 - Create user/database est par défaut positionnée sur yes. Vous pouvez être amené à positionner cette option sur no lorsque l’utilisateur et la base de données vont être créées par l’administrateur de base de données. Options connexes : INSTALL THE DATABASE, PG 28 EFFECTIVELY RUN THE DATABASE SCRIPTS, PG 30 Install the database L’option 13 - Install the database est par défaut positionnée sur yes. Vous pouvez être amené à positionner cette option sur no lorsque la base de données va être créée par l’administrateur de base de données. Options connexes : CREATE USER/DATABASE, PG 28 EFFECTIVELY RUN THE DATABASE SCRIPTS, PG 30 Installation de W4 BPMN+ ENGINE 28 29 of 54 body Upgrade the database L’option 14 - Upgrade the database est par défaut positionnée sur no. Pour une mise à jour, cette option doit être positionnée sur yes. Rubrique connexe : MISE À JOUR DE W4 BPMN+ ENGINE EN LIGNE DE COMMANDE, PG 35 Option connexe : CREATE OR UPGRADE DATABASE SCHEMA, PG 29 Install as a service (Windows) L’option 15 - Install as a Windows service est par défaut positionnée sur no. [Windows] Vous pouvez être amené à positionner cette option sur yes si vous voulez que W4 BPMN+ Engine soit installé en tant que service Windows. Create or upgrade database schema L’option 16 - Create or upgrade database schema est par défaut positionnée sur yes. Vous pouvez être amené à positionner cette option sur no lorsqu’une nouvelle version de W4 BPMN+ Engine doit être installée sur un schéma de base de données existant. Seules les colonnes ajoutées par rapport à la version installée sont créées, le cas échéant. Option connexe : UPGRADE THE DATABASE, PG 29 Install or upgrade audit trail schema L’option 17 - Install or upgrade audit trail schema est par défaut positionnée sur yes. Audit trail (trace d’audit) fait référence aux logs concernant les actions effectuées par W4 BPMN+ Engine, par exemple les événements que vous pouvez vouloir analyser, ou les appels système liés à la sécurité. Vous pouvez être amené à positionner cette option sur no si vous ne voulez pas que ces informations soient enregistrées en base. of 54 Insert default data to database L’option 18 - Insert default data to database est par défaut positionnée sur yes. Des données par défaut sont utilisées pour initialiser W4 BPMN+ Engine, les utilisateurs techniques par exemple. Effectively run the database scripts L’option 19 - Effectively run the database scripts est par défaut positionnée sur yes. Vous pouvez être amenés à positionner cette option sur no si vous souhaitez que les fichiers SQL soient générés et non exécutés. Cette option est généralement configurée conjointement avec les options 12 - Create user/database et / ou 13 - Install the database. Lorsque cette option est positionnée sur no: L’administrateur de base de données vérifiera les fichiers SQL générés et apportera les modifications nécessaires. En fin d’exécution, le programme d’installation fournira le nom et l’emplacement du fichier SQL à exécuter par l’administrateur de base de données. Après l’exécution des scripts SQL vous devrez initialiser les données par défaut du serveur. Options connexes : CREATE USER/DATABASE, PG 28 INSTALL THE DATABASE, PG 28 INSERT DEFAULT DATA TO DATABASE, PG 30 Install Document Storage Service L’option 20 - Install Document Storage Service est par défaut positionnée sur yes. Document Storage Service est un système ECM (Enterprise Content Management, gestion de contenu) embarqué avec W4 BPMN+ Engine. Vous pouvez être amenés à positionner cette option sur no si vous n’avez pas l’intention d’utiliser les fonctionnalités ECM ou si vous avez l’intention d’utiliser un système ECM tiers. 1.7 [INSTAL . .] Mise à jour de W4 BPMN+ Engine via l’installeur Cette rubrique s’applique aux plateformes Windows. 8 Installation de W4 BPMN+ ENGINE 30 31 of 54 body Pour les autres plateformes, utilisez la ligne de commande : MISE À JOUR DE W4 BPMN+ ENGINE EN LIGNE DE COMMANDE, PG 35 Via l’installeur de W4 BPMN+ Engine vous pouvez mettre à jour une instance de W4 BPMN+ Engine sur une plateforme Windows en quelques clics. Avant de procéder à la mise à jour : Assurez-vous que W4 BPMN+ Engine N’EST PAS actif, par exemple en vérifiant dans les services Windows. Assurez-vous que votre serveur de bases de données EST actif. Au cours de la mise à jour, vous devrez renseigner l’identifiant et le mot de passe de l’utilisateur système de la base de données, soit : sa pour H2 SQL system pour Oracle sa pour Microsoft SQL Server postgres pour PostgreSQL root pour MySQL Au cours de l’exécution de l’installeur vous pouvez utiliser les boutons Previous (Précédent) et Next (Suivant) si vous souhaitez vérifier ou modifier vos saisies, ou encore le bouton Quit (Quitter) si vous souhaitez abandonner la mise à jour. Pour mettre à jour W4 BPMN+ Engine via l’installeur 1 Exécutez l’installeur W4 BPMN+ Engine en double-cliquant sur le fichier W4BPMNplusEngine_win32_setup.exe. Une boîte de dialogue vous propose de choisir entre la mise à jour d’une instance déjà installée sur votre machine et l’installation d’une nouvelle instance. 2 Cliquez sur Yes pour mettre à jour une instance. L’écran d’accueil de l’installeur s’affiche à l’écran : Installation de W4 BPMN+ ENGINE 32 of 54 Fig 1.29 Mise à jour de W4 BPMN+ Engine via l’installeur (1/6) 3 Cliquez sur Next. L’écran Information de l’installeur s’affiche à l’écran. 4 Lisez les informations consignées sur cet écran puis cliquez sur Next. L’écran suivant de l’installeur s’affiche à l’écran : 1.1 Fig 1.30 IN Mise à jour de W4 BPMN+ Engine via l’installeur (2/6) 5 Sélectionnez l’instance à mettre à jour. 6 Cliquez sur Next. L’écran Processing de l’installeur s’affiche à l’écran. 33 of 54 body 7 Lorsque l’installeur rend la main, cliquez sur Next. L’écran Database configuration (Configuration de la base de données) de l’installeur s’affiche à l’écran. 1.2 Fig 1.31 IN Mise à jour de W4 BPMN+ Engine via l’installeur (3/6) Cet écran comporte les champs suivants : Database system user name Le nom de connexion d’un utilisateur système disposant des privilèges de création d’une base de données. Database system password Le mot de passe de l’utilisateur système spécifié. 8 Vérifiez les valeurs proposées, adaptez-les le cas échéant, puis cliquez sur Next. L’écran suivant de l’installeur s’affiche à l’écran : of 54 1.3 Fig 1.32 9 IN Mise à jour de W4 BPMN+ Engine via l’installeur (4/6) Lorsque l’installeur rend la main, cliquez sur Next. L’écran Processing de l’installeur s’affiche à l’écran. 1.4 Fig 1.33 IN Mise à jour de W4 BPMN+ Engine via l’installeur (5/6) Lorsque l’installeur rend la main, des messages du type Upgrade succeeded (Mise à jour réussie) et Service started (Service démarré) indiquent une installation réussie. 10 Cliquez sur Next. Le dernier écran de l’installeur s’affiche à l’écran. Installation de W4 BPMN+ ENGINE 34 35 of 54 body 1.5 Fig 1.34 IN Mise à jour de W4 BPMN+ Engine via l’installeur (6/6) Le message Installation has completed successfully (Installation réussie) doit s’afficher. 11 1.8 [INSTAL . .] Cliquez sur Done (Terminé) pour quitter l’installeur. Mise à jour de W4 BPMN+ Engine en ligne de commande Cette rubrique concerne toutes les plateformes. 9 Cette rubrique comporte des instructions pas à pas pour la mise à jour de W4 BPMN+ Engine en ligne de commande. Pour une mise à jour sur Windows via l’installeur : MISE À JOUR DE W4 BPMN+ ENGINE VIA L’INSTALLEUR, PG 30 La procédure décrite ci-dessous concerne une mise à jour standard. Vous avez toutefois la possibilité d’utiliser les options avancées pour répondre à des situations particulières. Les valeurs par défaut pour les options avancées sont modifiables via le menu setup avant de lancer la mise à jour (c.-à-d. avant de lancer la commande I - Upgrade software). Pour passer en revue les options avancées : OPTIONS D’INSTALLATION AVANCÉES W4 BPMN+ ENGINE, PG 28 Avant de procéder à la mise à jour : Assurez-vous que W4 BPMN+ Engine N’EST PAS actif. Assurez-vous que votre serveur de base de données EST actif. Au cours de la mise à jour il vous sera demandé de renseigner le nom d’utilisateur et le mot de passe de l’utilisateur système de base de données, soit : of 54 sa pour H2 SQL system pour Oracle sa pour Microsoft SQL Server postgres pour PostgreSQL root pour MySQL La procédure décrite ci-dessous s’applique à toutes les plateformes. Certaines étapes sont spécifiques à une plateforme en particulier. Ces étapes sont précédées par le nom de la plateforme correspondante entre crochets. Pour mettre à jour W4 BPMN+ Engine via la ligne de commande 1 [Windows] Double-cliquez sur le fichier install.bat. [UNIX] Dans le répertoire d’extraction de la version cible, exécutez le programme install. Le menu install s’affiche : 1 - Software home: <not set> I - Install software X - Exit > Fig 1.35 Mise à jour de W4 BPMN+ Engine en ligne de cmd (1/15) 2 Pour renseigner le répertoire d’installation, saisissez 1 puis validez par ENTRÉE. 3 À l’invite Enter software home, saisissez le chemin complet du répertoire de l’installation W4 BPMN+ Engine à mettre à jour ... > 1 Enter software home: > C:\Programs\W4\W4BPMNplus90 Fig 1.36 Mise à jour de W4 BPMN+ Engine en ligne de cmd (2/15) ... puis validez par ENTRÉE. 1 - Software home: C:\Programs\W4\W4BPMNplus90 I - Install software X - Exit Fig 1.37 4 Mise à jour de W4 BPMN+ Engine en ligne de cmd (3/15) Saisissez I puis validez par ENTRÉE. À l’invite Given software home is not empty, do you wish to continue ? <yes/NO> ... Installation de W4 BPMN+ ENGINE 36 37 of 54 body > I Given software home is not empty, do you wish to continue ? (yes/NO) > Fig 1.38 5 Mise à jour de W4 BPMN+ Engine en ligne de cmd (4/15) ... saisissez yes puis validez par ENTRÉE. > yes Installation folder exists, backuping... ................................................................................. ................................................................................. Copying files... ................................................................................. ................................................................................. Fig 1.39 Mise à jour de W4 BPMN+ Engine en ligne de cmd (5/15) À l’invite Do you wish to perform the product setup <YES/no> ... ................................................................................. ................................................................................. Do you wish to perform the product setup? (YES/no) > Fig 1.40 6 Mise à jour de W4 BPMN+ Engine en ligne de cmd (6/15) ... validez par ENTRÉE. Le menu setup s’affiche : of 54 Do you wish to perform the product setup? (YES/no) > 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 S J I W X - Instance name: accept02 Database type: MYSQL Data source class name: com.mysql.jdbc.jdbc2.optional.MysqlConnectionPool Database server name: localhost Database port number: 3306 Database name: accept02 Database user name: engusr Database user password: ****** Definition file: <none> RMI registry port: 47707 REST HTTP listening port: 47705 Create user/database: yes Install the database: yes Upgrade the database: no Install as a service (windows only): no Create or upgrade database schema: yes Create or upgrade audit trail schema: yes Insert default data to database: yes Effectively run the database scripts: yes Install Document Storage Service: yes Save configuration Import definition file (does nothing more) Install software (saves configuration and imports definition file too) Uninstall software Exit > Fig 1.41 7 Saisissez 14 puis validez par ENTRÉE. Cette action provoque les changements suivants : L’option 12 - Create user/database est désormais positionnée sur no (précédemment : yes). L’option 13 - Install the database est désormais positionnée sur no (précédemment : yes). L’option 14 - Upgrade the database est désormais positionnée sur yes (précédemment : no). Le libellé de la commande I est désormais Upgrade software (précédemment : Install software). 12 13 14 15 16 17 18 19 20 S J I W X > - Fig 1.42 8 Mise à jour de W4 BPMN+ Engine en ligne de cmd (7/15) Create user/database: no Install the database: no Upgrade the database: yes Install as a service (windows only): no Create or upgrade database schema: yes Create or upgrade audit trail schema: yes Insert default data to database: yes Effectively run the database scripts: yes Install Document Storage Service: yes Save configuration Import definition file (does nothing more) Upgrade software (saves configuration and imports definition file too) Uninstall software Exit Mise à jour de W4 BPMN+ Engine en ligne de cmd (8/15) Saisissez I puis validez par ENTRÉE pour lancer la mise à jour. À l’invite Start upgrade ... Installation de W4 BPMN+ ENGINE 38 39 of 54 body > I Start upgrade ? (YES/no) > Fig 1.43 Mise à jour de W4 BPMN+ Engine en ligne de cmd (9/15) 9 ... validez par ENTRÉE. 10 À l’invite Enter database administrator username, saisissez le nom de connexion d’un utilisateur système disposant des privilèges de création d’une base de données ... Enter database administrator username: > root Fig 1.44 Mise à jour de W4 BPMN+ Engine en ligne de cmd (10/15) ... puis validez par ENTRÉE. 11 À l’invite Enter database administrator password, saisissez le mot de passe de l’utilisateur système ... / NOTE Renseignez le mot de passe avec précaution car votre saisie ne s’affiche pas à l’écran. / Enter database administrator password (keyboard input is hidden): > Fig 1.45 Mise à jour de W4 BPMN+ Engine en ligne de cmd (11/15) ... puis validez par ENTRÉE. À l’invite Database must be running, continue ? <YES/no> ... Database must be running, continue ? (YES/no) > Fig 1.46 Mise à jour de W4 BPMN+ Engine en ligne de cmd (12/15) 12 ... validez par ENTRÉE. Le programme ne rend la main à l’utilisateur qu’après quelques minutes. Un message du type Upgrade succeeded (Mise à jour réussie) s’affiche. 13 À l’invite Display upgrade log ? (yes/NO), choisissez d’afficher ou non les logs : Pour afficher les logs, saisissez yes puis validez par ENTRÉE. Après avoir consulté les logs, appuyez sur ENTRÉE. Pour ne pas afficher les logs, appuyez sur ENTRÉE. Installation de W4 BPMN+ ENGINE 40 of 54 > Upgrade succeeded Database script file: [C:\Windows\TEMP\W4BPMN+Engine7600546127768532025.sql] Log file: [C:\Windows\TEMP\W4BPMN+Engine3014529248010172661.log] Display Upgrade log? (yes/NO) > Fig 1.47 Mise à jour de W4 BPMN+ Engine en ligne de cmd (13/15) Un message du type Setup complete (Installation terminée) s’affiche. À l’invite Press <enter> to go back to the installation ... > Setup complete. Press <enter> to go back to the installation... Fig 1.48 14 Mise à jour de W4 BPMN+ Engine en ligne de cmd (14/15) ... appuyez sur ENTRÉE. Un message du type Installation succeeded (Installation réussie) s’affiche. Installation succeeded Log file: [C:\Windows\TEMP\W4BPMN+Engine9108509901370867413.log] Display Installation log? (yes/NO) > Fig 1.49 1.9 [INSTAL . .] Mise à jour de W4 BPMN+ Engine en ligne de cmd (15/15) 15 À l’invite Display installation log ? (yes/NO), choisissez d’afficher ou non les logs : Pour afficher les logs, saisissez yes puis validez par ENTRÉE. Après avoir consulté les logs, appuyez sur ENTRÉE. Pour ne pas afficher les logs, appuyez sur ENTRÉE. 16 À l’invite Appuyez sur une touche pour continuer, appuyez sur n’importe quelle touche pour quitter le menu setup. / NOTE Suite à une mise à jour, il est normal de voir s’afficher une boîte de dialogue vous proposant la mise à jour de vos bibliothèques à l’ouverture d’une application dans W4 BPMN+ Composer. / Désinstallation de W4 BPMN+ Engine via l’assistant Cette rubrique concerne les plateformes Windows. Pour les autres plateformes, utilisez la ligne de commande: DÉSINSTALLER W4 BPMN+ ENGINE EN LIGNE DE COMMANDE, PG 41 10 41 of 54 Lorsque W4 BPMN+ Engine a été installé via l’installeur, un assistant de désinstallation est disponible pour désinstaller W4 BPMN+ Engine en quelques clics. body Vérifiez les points suivants avant de lancer l’assistant de désinstallation : Le système de gestion de base de données doit être actif. W4 BPMN+ Engine doit être arrêté et aucun processus ne doit tourner. Pour désinstaller W4 BPMN+ Engine via l’assistant 1 Sélectionnez W4 BPMN+ Engine W4 BPMN+ Engine uninstaller dans le menu Démarrer de Windows. / NOTE Le groupe du menu Démarrer dépend de la valeur renseignée à l’étape correspondante de l’installeur. / 2 Cliquez sur Uninstall dans la fenêtre qui s’affiche. Le premier écran de l’assistant de désinstallation s’affiche. 3 Cet écran comporte les champs suivants : Database system user name Le nom de connexion d’un utilisateur système disposant des privilèges de suppression d’une base de données. Database system password Le mot de passe de l’utilisateur système spécifié. 1.10 [INSTAL . .] 4 Vérifiez les valeurs proposées, adaptez-les le cas échéant, puis cliquez sur Next. Le second écran de l’assistant de désinstallation s’affiche. Une série de messages et une jauge indiquent la progression de la désinstallation. Un message du type Service uninstalled, database uninstalled (Service désinstallé, base de données désinstallée) indique une désinstallation réussie. 5 Cliquez sur Next. Le dernier écran de l’assistant de désinstallation s’affiche. 6 Cliquez sur Done. Désinstaller W4 BPMN+ Engine en ligne de commande Cette rubrique concerne toutes les plateformes. 11 of 54 Pour une désinstallation sous Windows via l’assistant de désinstallation : DÉSINSTALLATION DE W4 BPMN+ ENGINE VIA L’ASSISTANT, PG 40 Vérifiez les points suivants avant de procéder à la désinstallation : Le système de gestion de base de données doit être actif. W4 BPMN+ Engine doit être arrêté et aucun processus ne doit tourner. Pour désinstaller W4 BPMN+ Engine en ligne de commande 1 [Windows] Double-cliquez sur le fichier setup.bat dans le dossier setup de votre installation de W4 BPMN+ Engine. [UNIX] Exécutez le fichier setup.sh. Le menu setup s’affiche : 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 S J I W X - Instance name: bpmn07 Database type: MYSQL Data source class name: com.mysql.jdbc.jdbc2.optional.MysqlConnectionPool Database server name: localhost Database port number: 3306 Database name: w4 Database user name: w4 Database user password: ****** Definition file: <none> RMI registry port: 7707 REST HTTP listening port: 7705 Create user/database: yes Install the database: yes Upgrade the database: no Install as a service (windows only): no Create or upgrade database schema: yes Create or upgrade audit trail schema: yes Insert default data to database: yes Effectively run the database scripts: yes Install Document Storage Service: yes Save configuration Import definition file (does nothing more) Install software (saves configuration and imports definition file too) Uninstall software Exit > Fig 1.50 2 DésInstallation de W4 BPMN+ Engine en ligne de cmd (1/7) Saisissez W puis validez par ENTRÉE. À l’invite Start uninstall (YES/no) ... > W Start uninstall ? (YES/no) > Fig 1.51 3 DésInstallation de W4 BPMN+ Engine en ligne de cmd (2/7) ... validez par ENTRÉE. À l’invite Uninstall database (all data will be lost) > (YES/no) ... Installation de W4 BPMN+ ENGINE 42 43 of 54 body Uninstall database (all data will be lost) ? (YES/no) > Fig 1.52 DésInstallation de W4 BPMN+ Engine en ligne de cmd (3/7) 4 ... validez par ENTRÉE. 5 À l’invite Enter database administrator username, saisissez le nom de connexion d’un utilisateur système disposant des privilèges de suppression d’une base de données ... Enter database administrator username: > root Fig 1.53 DésInstallation de W4 BPMN+ Engine en ligne de cmd (4/7) 6 ... puis validez par ENTRÉE. 7 À l’invite Enter database administrator password, saisissez le mot de passe de l’utilisateur système spécifié ... / NOTE Renseignez le mot de passe avec précaution car votre saisie ne s’affiche pas à l’écran / Enter database administrator password (keyboard input is hidden): > Fig 1.54 8 DésInstallation de W4 BPMN+ Engine en ligne de cmd (5/7) ... puis validez par ENTRÉE. À l’invite Database must be running, continue ? <YES/no> ... Database must be running, continue ? (YES/no) > Fig 1.55 9 DésInstallation de W4 BPMN+ Engine en ligne de cmd (6/7) ... validez par ENTRÉE. Un message du type Uninstallation succeeded (Désinstallation réussie) doit s’afficher : Installation de W4 BPMN+ ENGINE 44 of 54 ******* *** *** To complete uninstall, remove the software home folder: [C:\Programs \bpmn07] *** *** ******* Uninstallation succeeded Database script file: [C:\Windows\TEMP\W4BPMN+Engine5253350358658625457.sql] Log file: [C:\Windows\TEMP\W4BPMN+Engine2784980945943696391.log] Display Uninstallation log? (yes/NO) > Fig 1.56 1.11 [INSTAL . .] DésInstallation de W4 BPMN+ Engine en ligne de cmd (7/7) 10 À l’invite Display uninstallation log ? (yes/NO), choisissez d’afficher ou non les logs relatifs à la désinstallation : Pour afficher les logs, saisissez yes puis validez par ENTRÉE. Après avoir consulté les logs, appuyez sur ENTRÉE. Pour ne pas afficher les logs, appuyez sur ENTRÉE. 11 À l’invite Appuyez sur une touche pour continuer, appuyez sur n’importe quelle touche pour quitter le menu setup. 12 Supprimez le répertoire d’installation de W4 BPMN+ Engine. Configurer W4 BPMN+ Engine pour démarrer en mode debug 12 Pour pouvoir déboguer les tâches de service, les modules et les applications déployées côté serveur via Eclipse IDE (à l’aide de remote debug), il est nécessaire de démarrer W4 BPMN+ Engine de telle sorte qu’il autorise le débogage à distance. HEADINGS IN THIS TOPIC CONFIGURATION POUR DÉMARRAGE EN MODE DEBUG VIA LA CONSOLE, PG 44 CONFIGURATION POUR DÉMARRAGE EN MODE DEBUG VIA LES SERVICES, PG 45 Configuration pour démarrage en mode debug via la console Suivez les étapes ci-dessous pour configurer W4 BPMN+ Engine pour démarrer en mode debug, via la console. Éditez le fichier ...\bin\startupConsole.bat, ou une copie de ce fichier. 45 of 54 body Ajouter la ligne ci-dessous, immédiatement après %java% %W4_ENGINE_JAVA_OPTS% : -Xdebug -Xrunjdwp:transport=dt_socket,server=y,suspend=n,address=8701 Le paramètre address correspond au port d’écoute pour le débogage. Modifiez sa valeur (8701 dans l’exemple ci-dessus) au besoin. Configuration pour démarrage en mode debug via les services Suivez les étapes ci-dessous pour configurer W4 BPMN+ Engine pour démarrer en mode debug, via les services Windows. Éditez le fichier ...\conf\service_common.conf Remplacez la ligne ... wrapper.java.additonal.1=-Dcom.sun.management.jmxremote ... par les lignes : wrapper.java.additional.1=-Xdebug wrapper.java.additional.2=-Xrunjwp\:transport\=dt_socket\,server\=y\,suspend\=n\, address\=8701 wrapper.java.additional.3=-Dcom.sun.management.jmxremote 46 FINAL Installation de W4 BPMN+ ENGINE of 54 47 of 54 body INSTALLATION DE W4 BPMN+ ENGINE ILLUSTRATIONS illustration end of file I Illustrations Fig 1.1 Fig 1.2 Fig 1.3 Fig 1.4 Fig 1.5 Fig 1.6 Fig 1.7 Fig 1.8 Fig 1.9 Fig 1.10 Fig 1.11 Fig 1.12 Fig 1.13 Fig 1.14 Fig 1.15 Fig 1.16 Fig 1.17 Fig 1.18 Fig 1.19 Fig 1.20 Fig 1.21 Fig 1.22 Fig 1.23 Fig 1.24 Fig 1.25 Fig 1.26 Fig 1.27 Fig 1.28 Fig 1.29 Fig 1.30 Fig 1.31 Fig 1.32 Fig 1.33 Fig 1.34 Fig 1.35 Fig 1.36 Fig 1.37 Fig 1.38 Fig 1.39 Fig 1.40 Fig 1.41 Illustrations Installation de W4 BPMN+ Engine via l’installeur (1/12) Installation de W4 BPMN+ Engine via l’installeur (2/12) Installation de W4 BPMN+ Engine via l’installeur (3/12) Installation de W4 BPMN+ Engine via l’installeur (4/12) Installation de W4 BPMN+ Engine via l’installeur (5/12) Installation de W4 BPMN+ Engine via l’installeur (6/12) Installation de W4 BPMN+ Engine via l’installeur (7/12) Installation de W4 BPMN+ Engine via l’installeur (8/12) Installation de W4 BPMN+ Engine via l’installeur (9/12) Installation de W4 BPMN+ Engine via l’installeur (10/12) Installation de W4 BPMN+ Engine via l’installeur (11/12) Installation de W4 BPMN+ Engine via l’installeur (12/12) Installation de W4 BPMN+ Engine en ligne de cmd (1/14) Installation de W4 BPMN+ Engine en ligne de cmd (2/14) Installation de W4 BPMN+ Engine en ligne de cmd (3/14) Installation de W4 BPMN+ Engine en ligne de cmd (4/14) Installation de W4 BPMN+ Engine en ligne de cmd (5/14) Installation de W4 BPMN+ Engine en ligne de cmd (6/14) Installation de W4 BPMN+ Engine en ligne de cmd (7/14) Installation de W4 BPMN+ Engine en ligne de cmd (8/14) Installation de W4 BPMN+ Engine en ligne de cmd (9/14) Installation de W4 BPMN+ Engine en ligne de cmd (10/14) Installation de W4 BPMN+ Engine en ligne de cmd (11/14) Installation de W4 BPMN+ Engine en ligne de cmd (12/14) Installation de W4 BPMN+ Engine en ligne de cmd (13/14) Installation de W4 BPMN+ Engine en ligne de cmd (14/14) Démarrage de W4 BPMN+ Engine Arrêt de W4 BPMN+ Engine Mise à jour de W4 BPMN+ Engine via l’installeur (1/6) Mise à jour de W4 BPMN+ Engine via l’installeur (2/6) Mise à jour de W4 BPMN+ Engine via l’installeur (3/6) Mise à jour de W4 BPMN+ Engine via l’installeur (4/6) Mise à jour de W4 BPMN+ Engine via l’installeur (5/6) Mise à jour de W4 BPMN+ Engine via l’installeur (6/6) Mise à jour de W4 BPMN+ Engine en ligne de cmd (1/15) Mise à jour de W4 BPMN+ Engine en ligne de cmd (2/15) Mise à jour de W4 BPMN+ Engine en ligne de cmd (3/15) Mise à jour de W4 BPMN+ Engine en ligne de cmd (4/15) Mise à jour de W4 BPMN+ Engine en ligne de cmd (5/15) Mise à jour de W4 BPMN+ Engine en ligne de cmd (6/15) Mise à jour de W4 BPMN+ Engine en ligne de cmd (7/15) 10 10 11 12 12 13 14 15 16 17 17 18 20 20 20 20 21 22 22 23 23 24 24 24 24 25 26 27 32 32 33 34 34 35 36 36 36 37 37 37 38 Fig 1.42 Fig 1.43 Fig 1.44 Fig 1.45 Fig 1.46 Fig 1.47 Fig 1.48 Fig 1.49 Fig 1.50 Fig 1.51 Fig 1.52 Fig 1.53 Fig 1.54 Fig 1.55 Fig 1.56 Mise à jour de W4 BPMN+ Engine en ligne de cmd (8/15) Mise à jour de W4 BPMN+ Engine en ligne de cmd (9/15) Mise à jour de W4 BPMN+ Engine en ligne de cmd (10/15) Mise à jour de W4 BPMN+ Engine en ligne de cmd (11/15) Mise à jour de W4 BPMN+ Engine en ligne de cmd (12/15) Mise à jour de W4 BPMN+ Engine en ligne de cmd (13/15) Mise à jour de W4 BPMN+ Engine en ligne de cmd (14/15) Mise à jour de W4 BPMN+ Engine en ligne de cmd (15/15) DésInstallation de W4 BPMN+ Engine en ligne de cmd (1/7) DésInstallation de W4 BPMN+ Engine en ligne de cmd (2/7) DésInstallation de W4 BPMN+ Engine en ligne de cmd (3/7) DésInstallation de W4 BPMN+ Engine en ligne de cmd (4/7) DésInstallation de W4 BPMN+ Engine en ligne de cmd (5/7) DésInstallation de W4 BPMN+ Engine en ligne de cmd (6/7) DésInstallation de W4 BPMN+ Engine en ligne de cmd (7/7) 38 39 39 39 39 40 40 40 42 42 43 43 43 43 44 illustration end of file 53 52 Installation de W4 BPMN+ ENGINR of 54 Installation de W4 BPMN+ ENGINE Merci de penser à l’environnement. N’imprimez ce document que si nécessaire. Préférez l’impression par sélection d’une plage de pages à l’impression du document complet. Da ns la version aid e en ligne , vous pouvez également imprimer par rubrique d’aide ou par chapitre PDF (via la page d’accueil du document dans le système d’aide en ligne W4 Docs). Ce document fait partie de W4 Docs, le système d’aide en ligne de W4 BPMN+. Flashez le QR code ci-contre pour afficher W4 Docs sur votre mobile. Si vous souhaitez nous faire part de toute erreur ou omission, ou nous signaler toute difficulté rencontrée à l’utilisation du présent document, merci de nous contacter à l’adresse [email protected] illustration end of file :zzixmarker FINAL