OIEAUVW Manuel d’installation et d’exploitation Réf : OIEAUVW-MIE001.V1.0 Auteurs : Thomas Valloo Version : 1.0 Le : 05/11/2010 _______________________________________________________________________________________________________________________________________________________ Paris – Siège social : 10, rue Lincoln – 75008 Paris – Tél. +33 (0)1 76 69 16 00 – Fax +33 (0)1 43 59 41 97 – [email protected] Agence de Grenoble : 34, avenue Félix Viallet – 38000 Grenoble – Tél. +33 (0)4 76 53 72 72 – Fax +33 (0)4 76 53 72 77 Agence de Lyon : 1, cours Albert Thomas – 69003 Lyon – Tél. +33 (0)4 72 33 78 30 – Fax +33 (0)4 72 33 68 67 www.objetdirect.com _______________________________________________________________________________________________________________________________________________________ SAS au capital de 160 000 € - RCS Paris B 420 798 100 – Code NAF 6202A – TVA intracommunautaire FR34420798100 Suivi des changements Date Version 1.0 Description Auteurs Version initiale Thomas Valloo Liste de diffusion Personne Etienne Marchand Maxime Bonnet Thomas Valloo Société Sandre Objet Direct Objet Direct Visas Personne Date Visa/Observations Maxime Bonnet _______________________________________________________________________________________________________________________________________________________ Paris – Siège social : 10, rue Lincoln – 75008 Paris – Tél. +33 (0)1 76 69 16 00 – Fax +33 (0)1 43 59 41 97 – [email protected] Agence de Grenoble : 34, avenue Félix Viallet – 38000 Grenoble – Tél. +33 (0)4 76 53 72 72 – Fax +33 (0)4 76 53 72 77 Agence de Lyon : 1, cours Albert Thomas – 69003 Lyon – Tél. +33 (0)4 72 33 78 30 – Fax +33 (0)4 72 33 68 67 www.objetdirect.com _______________________________________________________________________________________________________________________________________________________ SAS au capital de 160 000 € - RCS Paris B 420 798 100 – Code NAF 6202A – TVA intracommunautaire FR34420798100 Sommaire 1 ELEMENTS A RECUPER ..........................................................ERROR! BOOKMARK NOT DEFINED. 2 INSTALLATION ENVIRONNEMENT SOUS LINUX (CENTOS) ....................................................... 5 3 INSTALLATION LOCALE (SOUS WINDOWS) .................................................................................... 7 4 FICHIER DE CONFIGURATION ............................................................................................................. 8 _______________________________________________________________________________________________________________________________________________________ Paris – Siège social : 10, rue Lincoln – 75008 Paris – Tél. +33 (0)1 76 69 16 00 – Fax +33 (0)1 43 59 41 97 – [email protected] Agence de Grenoble : 34, avenue Félix Viallet – 38000 Grenoble – Tél. +33 (0)4 76 53 72 72 – Fax +33 (0)4 76 53 72 77 Agence de Lyon : 1, cours Albert Thomas – 69003 Lyon – Tél. +33 (0)4 72 33 78 30 – Fax +33 (0)4 72 33 68 67 www.objetdirect.com _______________________________________________________________________________________________________________________________________________________ SAS au capital de 160 000 € - RCS Paris B 420 798 100 – Code NAF 6202A – TVA intracommunautaire FR34420798100 1 RECUPERATION DES ELEMENTS 1. openejb.war : sur Codendi : https://extranet.objetdirect.com/file/showfiles.php?group_id=258 2. oieauvw.war : dernière version disponible sur Codendi : https://extranet.objetdirect.com/file/showfiles.php?group_id=258 3. localProjet.zip : en utilisant le lien fourni par Objet Direct. _______________________________________________________________________________________________________________________________________________________ Paris – Siège social : 10, rue Lincoln – 75008 Paris – Tél. +33 (0)1 76 69 16 00 – Fax +33 (0)1 43 59 41 97 – [email protected] Agence de Grenoble : 34, avenue Félix Viallet – 38000 Grenoble – Tél. +33 (0)4 76 53 72 72 – Fax +33 (0)4 76 53 72 77 Agence de Lyon : 1, cours Albert Thomas – 69003 Lyon – Tél. +33 (0)4 72 33 78 30 – Fax +33 (0)4 72 33 68 67 www.objetdirect.com _______________________________________________________________________________________________________________________________________________________ SAS au capital de 160 000 € - RCS Paris B 420 798 100 – Code NAF 6202A – TVA intracommunautaire FR34420798100 2 INSTALLATION ENVIRONNEMENT SOUS LINUX (CENTOS) 2.1 OpenEJB L’installation du container EJB OpenEJB est nécessaire pour permettre à l’application de fonctionner. Son installation est décrite sur le site officiel : http://openejb.apache.org/ dans la rubrique « Integrations », « Tomcat ». Le processus d’installation est le suivant : 1. Copy openejb.war to ${catalina.base}/webapps/openejb.war (Note: the file must be named openejb.war) 2. Start Tomcat if it is not already running 3. (optional) Visit http://localhost:8080/openejb/installer and click the 'install' button 2.2 SoapUI Il est nécessaire de configurer dans catalina.bat (ou catalina.sh) le fonctionnement de soapUI : Catalina.bat : Définition du chemin des librairies externes nécessaires à soapUI : set JAVA_OPTS=%JAVA_OPTS% -Dsoapui.ext.libraries="<CHEMIN>" Option permettant de masquer les rapports d’erreur à l’utilisateur lors d’un appel par service web : set JAVA_OPTS=%JAVA_OPTS% -Dcom.sun.xml.ws.fault.SOAPFaultBuilder.disableCaptureStackTrace=false Catalina.sh : Définition du chemin des librairies externes nécessaires à soapUI : JAVA_OPTS=""-Dsoapui.ext.libraries=<CHEMIN>" $JAVA_OPTS" Option permettant de masquer les rapports d’erreur à l’utilisateur lors d’un appel par service web : JAVA_OPTS=""Dcom.sun.xml.ws.fault.SOAPFaultBuilder.disableCaptureStackTrace=false" $JAVA_OPTS" _______________________________________________________________________________________________________________________________________________________ Paris – Siège social : 10, rue Lincoln – 75008 Paris – Tél. +33 (0)1 76 69 16 00 – Fax +33 (0)1 43 59 41 97 – [email protected] Agence de Grenoble : 34, avenue Félix Viallet – 38000 Grenoble – Tél. +33 (0)4 76 53 72 72 – Fax +33 (0)4 76 53 72 77 Agence de Lyon : 1, cours Albert Thomas – 69003 Lyon – Tél. +33 (0)4 72 33 78 30 – Fax +33 (0)4 72 33 68 67 www.objetdirect.com _______________________________________________________________________________________________________________________________________________________ SAS au capital de 160 000 € - RCS Paris B 420 798 100 – Code NAF 6202A – TVA intracommunautaire FR34420798100 2.3 Projet Déposer le fichier oieauvw.war dans ${catalina.base}/webapps/. Redémarrer le serveur Tomcat, l’application est alors accessible. _______________________________________________________________________________________________________________________________________________________ Paris – Siège social : 10, rue Lincoln – 75008 Paris – Tél. +33 (0)1 76 69 16 00 – Fax +33 (0)1 43 59 41 97 – [email protected] Agence de Grenoble : 34, avenue Félix Viallet – 38000 Grenoble – Tél. +33 (0)4 76 53 72 72 – Fax +33 (0)4 76 53 72 77 Agence de Lyon : 1, cours Albert Thomas – 69003 Lyon – Tél. +33 (0)4 72 33 78 30 – Fax +33 (0)4 72 33 68 67 www.objetdirect.com _______________________________________________________________________________________________________________________________________________________ SAS au capital de 160 000 € - RCS Paris B 420 798 100 – Code NAF 6202A – TVA intracommunautaire FR34420798100 3 INSTALLATION LOCALE (SOUS WINDOWS) Dézipper le projet dans un répertoire. Le chemin de ce répertoire ne doit pas contenir d’espace. Il est nécessaire de modifier le fichier dans le répertoire : « localProject\apache-tomcat.5.30\webapps\oieauvw\WEB-INF\classes\config.properties». Les adresses absolues doivent être indiquées pour pointer correctement les répertoires cibles : directory.projects : répertoire contenant l’arborescence des projets soapui. directory.results : répertoire contenant les résultats des tests de services web. directory.xsl : répertoire contenant les fichiers xsl. Aucune configuration supplémentaire n’est nécessaire. Pour lancer Tomcat, double cliquer sur le fichier « startup.bat » situé à la racine du répertoire. Vous pouvez ensuite accéder à l’application à l’adresse : http://localhost:8080/oieauvw/ Pour arrêter Tomcat, double cliquer sur le fichier « shutdown.bat » situé à la racine du répertoire. _______________________________________________________________________________________________________________________________________________________ Paris – Siège social : 10, rue Lincoln – 75008 Paris – Tél. +33 (0)1 76 69 16 00 – Fax +33 (0)1 43 59 41 97 – [email protected] Agence de Grenoble : 34, avenue Félix Viallet – 38000 Grenoble – Tél. +33 (0)4 76 53 72 72 – Fax +33 (0)4 76 53 72 77 Agence de Lyon : 1, cours Albert Thomas – 69003 Lyon – Tél. +33 (0)4 72 33 78 30 – Fax +33 (0)4 72 33 68 67 www.objetdirect.com _______________________________________________________________________________________________________________________________________________________ SAS au capital de 160 000 € - RCS Paris B 420 798 100 – Code NAF 6202A – TVA intracommunautaire FR34420798100 4 FICHIER DE CONFIGURATION Cette partie décrit les différentes propriétés configurables dans le fichier de configuration. « ${Catalina.home}\webapps\oieauvw\WEB-INF\classes\config.properties». Nom de la propriété directory.projects directory.results directory.xsl mail.enabled smtp.host smtp.port smtp.username smtp.password fonc.fromAdresse mail.encours.objet mail.encours.corps mail.fini.objet mail.fini.corps report.xsl.name report.name project.soapui.name results.list.name certificat.xsl.name list.reports.xsl.name testsuite.obligatory.name testsuite.optional.name results.url Description Répertoire contenant l’arborescence des projets soapui. L’adresse doit être absolue. Répertoire contenant les résultats des demandes de test de service web. L’adresse doit être absolue. Répertoire contenant les fichiers xsl. L’adresse doit être absolue. Variable configurant l’envoi de mail. Doit prendre les valeurs « true » ou « false ». Nom du serveur smtp. Port à utiliser pour l’envoi de mail. Nom d’utilisateur pour se connecter à la boîte mail. Mot de passe pour se connecter à la boîte mail. Adresse à utiliser pour l’envoi du mail Objet du mail envoyé lors de la demande de test Corps du mail envoyé lors de la demande de test Objet du mail envoyé une fois le traitement terminé Corps du mail envoyé une fois le traitement terminé Nom du fichier xsl responsable de la transformation du rapport xml de demande de test vers le bilan du test Nom du fichier xml contenant le rapport du test Nom du projet soapUI Nom du fichier xml contenant la liste des services web conformes Nom du fichier xsl responsable de la transformation xsl du rapport xml de demande de test vers le certificat de conformité Nom du ficher xsl responsable de la transformation xsl de la liste de service web conformes Nom de la suite de test obligatoire, nécessaire pour certifier de la conformité du service web Nom de la suite de test facultative Url des résultats, utilisée dans l’envoi de mail. _______________________________________________________________________________________________________________________________________________________ Paris – Siège social : 10, rue Lincoln – 75008 Paris – Tél. +33 (0)1 76 69 16 00 – Fax +33 (0)1 43 59 41 97 – [email protected] Agence de Grenoble : 34, avenue Félix Viallet – 38000 Grenoble – Tél. +33 (0)4 76 53 72 72 – Fax +33 (0)4 76 53 72 77 Agence de Lyon : 1, cours Albert Thomas – 69003 Lyon – Tél. +33 (0)4 72 33 78 30 – Fax +33 (0)4 72 33 68 67 www.objetdirect.com _______________________________________________________________________________________________________________________________________________________ SAS au capital de 160 000 € - RCS Paris B 420 798 100 – Code NAF 6202A – TVA intracommunautaire FR34420798100