Quick Start Installation de MDweb version 2.3
Contents
1. Quick Start Installation de MDweb version 2 3 Date 2011 08 26 nstitut de recherche our le d veloppement Quick Start Installation de MDweb version 2011 1 Quickstart Installation T l chargement et Installation des logiciels requis D ploiement D ploiement de Mdweb dans le container JEE Setup Premier d marrage et configuration de Mdweb au premier d marrage Annexes e Annexe A Installation d un serveur Tomcat e Annexe B Installation d un serveur Glassfish e Annexe C Gestion d un serveur Glassfish e Annexe D R initialisation D sinstallation de Mdweb REE Institut de recherche pour le d veloppement Quick Start Installation de MDweb version 2011 2 Logiciels Requis e Java Development Kit 1 6 0 JDK 1 6 0 e Java Advanced Imaging 1 1 3 JAI 1 1 3 e Java Advanced Imaging Image IO 1 1 JAI Image IO 1 1 Serveur d applications en choisir un seul e Apache Tomcat 6 0 ou plus la derniere realease de tomcat 7 0 21 n est pas conseill e pour MDweb Dans le cas d une installation classique l utilisation de Tomcat est recommand e e Sun Glassfish v3 0 1 MDweb ne fonctionne pas sur la nouvelle version de GlassFish 3 1mais uniquement sur la version GlassFish 3 0 1 utilisez le lien suivant pour la t l charger Systeme de Gestion de Base de Donn es SGBD e PostgreSQL 8 1 ou sup rieur e SGBD embarqu Derby L utilisateur q2. placer ces pilotes dans le repertoire jre lib ext de la JVM au m me endroit que les extensions Java Creation d un nouvel utilisateur Afin de pouvoir utiliser Tomcat via sa console d administration nous Tomcat devons cr er un utilisateur qui aura le r le d administrateur Tomcat Pour cela vous devez diter le fichier tomcat users xml du repertoire tomcat conf en y ajoutant la ligne suivante al WIN lt user username admin password admin roles tomcat manager gui gt Deploiement de MDweb Demarche Manipulation Lancer le serveur Tomcat e Aller dans le repertoire de d marrage de bin de Tomcat cd tomcat bin e D marrer Tomcat en tapant la ligne de commande catalina sh start Vous pouvez contr ler l ex cution de la commande et le fonctionnement de Tomcat messages d erreur et d informations avec le fichier de log tomcat logs catalina out Pour visualiser en temps r el les logs de Tomcat tapez dans un autre terminal la commande tail f catalina out Acc s la console D marrez un navigateur web et connectez vous la page d accueil du serveur d administration de Tomcat Tomcat http localhost 8080 IRD 8 Institut de recherche pour le d veloppement Quick Start Installation de MDweb version 2011 D marche Manipulation La console d administration est accessible via le menu gauche de la page d accueil en cliquant sur le lien Tomcat Manager Le mot de passe de
3. t tre lanc 4 4 Cr ation de l utilisateur Administrateur Cet utilisateur tous les droits au niveau de MDweb Pour le cr er e Lancez MDweb depuis le navigateur http adresselP de votre serveur 8080 nom de votre application e Loguez vous en tant que configurateu e S lectionnez le module Administrer e Depuis l onglet Utilisateurs cr ez un nouvel utilisateur en s lectionnant le r le d Administrateur En se loguant en tant qu administrateur vous pouvez maintenant diter des fiches de m tadonn es ou encore cr er de nouveaux utilisateurs IRD F 7 Institut de recherche pour le d veloppement Quick Start Installation de MDweb version 2011 Annexe A D ploiement d un serveur Tomcat Installation de Apache Tomcat 6 X Installation de Tomcat Pour installer le serveur d application Java Tomcat d compressez le fichier t l charg dans un r pertoire de votre choix Allocation de m moire Tomcat Afin d augmenter la m moire allou e a Tomcat vous devez diter le fichier catalina sh Pour cela ouvrez le fichier tomcat bin catalina shet ajouter l option suivante export JAVA OPTS XX MaxPermSize 256m Xmx1024m Dfile encoding UTF 8 qui permet au syst me d allouer 1Go de m moire vive la JVM Ajout des pilotes de connexion Copier les fichiers derby 10 5 3 0 1 jar et postgresql JDBC 8 4 701 jdbc4 jar dans le r pertoire tomcat lib Note Pour Tomcat 7 0 21
4. l utilisateur que vous avez cr e pr c demment est demande D ploiement de l archive Dans Tomcat Manager allez dans la rubrique situ e cf copie d cran en bas de la War de mdweb page d accueil charger le war mdweb t l charg http www mdweb project org files releases mdweb 2011 09 2 3 war mdweb war puis cliquez sur d ployer pour qu il soit install dans le serveur Tomcat Choisir le fichier WAR t l verser L application mdweb appara t dans la liste des applications e Ouverture de MDweb Saisissez l adresse http localhost 8080 mdweb dans le navigateur Vous arrivez sur la page d accueil MDweb aT WAT NS RD 9 Institut de recherche pour le d veloppement Quick Start Installation de MDweb version 2011 Annexe B D ploiement d un serveur Glassfish 1 Installation de Glassfish http glassfish java net downloads 3 1 final html T l chargez l installeur de GlassFish Server Open Source Edition Web Profile Attention La version FullPlatform n est pas support e R cup rer le fichier t l charg Dans un terminal modifier les droits du fichier en le rendant ex cutable sudo chmod R x nom_du_fichier sh Lancez l installeur depuis le m me terminal sudo nom_du_fichier sh Suivez les instructions en pr cisant durant l installation le r pertoire par d faut de Java JDK usr lib jvm java 6 sun 1 6 0 22 sur ma machine Sous Windows l installa
5. recherche pour le d veloppement Quick Start Installation de MDweb version 2011 e Cliquez sur Deploy e Dans la boite de dialogue choisissez le fichier t l charger partir de Packaged File toBe Uploaded to the Server e Une fois le d ploiement termin cliquez sur launch MDweb se lance IRD F 12 Institut de recherche pour le d veloppement Quick Start Installation de MDweb version 2011 Annexe C Gestion d un serveur Glassfish Il existe une tr s bonne documentation sur la gestion des serveurs d applications Glassfish sur les sites web de Oracle http www oracle com technetwork middleware glassfish documentation index html Ceci n est qu une br ve introduction 1 Cr ation d un domaine Optionnel Depuis le terminal de commande cd votreRacine glassfish bin Ex cutez la commande asadmin create domain portbase 9000 mdweb Note 9000 est ici donn en exemple Le num ro de portbase prend la forme xx00 xx d pendant du choix de l utilisateur Les ports inf rieur a 1024 tant r serv s il faudra choisir un portbase de 2000 ou plus D finissez un administrateur du domaine et un mot de passe ou laissez les param tres par d faut Vous disposez maintenant d un domaine mdweb avec comme ports e Port 9048 gt Configuration e Port 9080 gt HTTP e Port9081 gt HTTPS 2 Gestion du domaine D marrage du domaine Depuis le terminal se pl
6. acer dans la r pertoire bin votreRacine glassfish bin et ex cuter la commande asadmin start domain nom de votre domaine exemple asadmin start domain mdweb Arr t du domaine Depuis le m me r pertoire asadmin login nom de votre domaine si le domaine est prot g par un mot de passe asadmin stop domain nom de votre domaine Suppression d un domaine Depuis le m me r pertoire asadmin delete domain nom de votre domaine Pour Windows la commande asadmin devient asadmin IRD 13 Institut de recherche pour le d veloppement Quick Start Installation de MDweb version 2011 Annexe D R initialisation D sinstallation de MDweb 1 D sinstallation Lors de son d ploiement MDweb e Se d ploie sur le serveur d applications e Cr e un r pertoire de configuration e G nere de nouvelles tables dans le SGBD e Cr e des fichiers dans le dossier de travail La d sinstallation complete de MDweb s effectue donc en 3 tapes 1 1 Undeploy MDweb Depuis le navigateur acc der l espace de configuration de Glassfish http adresseIP de votre serveur 4848 Par d faut http 127 0 0 1 4848 ou http localhost 4848 Cliquer Applications S lectionner l application MDweb puis cliquer sur Undeploy 1 2 Supprimer le r pertoire de configuration Ce r pertoire se trouve par d faut la racine de votre r pertoire utilisateur Pour windows un r
7. ateur de la base de donn es par d faut postgres e Mot de passe Votre mot de passe postgreSQL e Nom de la base de donn es Nom d une base MDweb existante dans le SGBD PostgreSQL o les tables MDweb vont tre cr es Si une base comprenant les tables MDweb existe d ja dans PostgreSQL changement de version de MDweb avec r cup ration de la base existante cliquez sur Enregistrer la configuration seulement Si une nouvelle base MDweb doit tre cr e cliquez sur Cr er les tables et enregistrer la configuration 4 3 Creation de l utilisateur Configurateur Au lancement de MDweb vous devez cr er un utilisateur qui deviendra le configurateurr de MDweb Remplissez IRD 6 Institut de recherche pour le d veloppement Quick Start Installation de MDweb version 2011 e son Nom le nom qui s affichera sur MDweb e son login l identifiant qui lui permettra de s authentifier en tant que configurateur e son mot de passe Cliquez sur Cr er un nouvel utilisateur L utilisateur ainsi cr e a acc s au module MDweb Configurer et Administrer en plus du module Rechercher qui ne n cessite pas de s authentifier En revanche il ne pourra pas Editer MDweb peut tre relanc et la configuration peut tre achev e Vous pouvez cliquez sur le bouton Use MDvweb et vous authentifier avec les identifiants du configurateur MDweb est maintenant pr
8. igateur acc dez l interface de configuration de Glassfish http adresseIP de votre serveur 4848 Par d faut http 127 0 0 1 4848 ou http localhost 4848 e Cliquez sur Configuration puis JVM Settings e Cliquez sur l onglet JVM option Effectuez les diff rentes modifications e Remplacement du param tre client par server e Modification du param tre XX MaxPermSize 192m par e _ XX MaxPermSize 256m e Modification du param tre Xmx512m par Xmx1024m e Cliquez sur le bouton Add JVM option et ajouter le param tre Dfile encoding UTF S Sauvez les modifications e Stoppez Glassfish e Depuis le terminal stoppez l application asadmin du serveur d application L application se trouve dans le r pertoire bin du serveur d application racine glassfish bin e Dans l application asadmin ex cutez la commande asadmin stop domain nom de votre domaine pour linux et mac exemple asadmin start domain domain 1 asadmin start domain nom de votre domaine pour windows exemple asadmin start domain domain 1 Relancez l application Glassfish 4 D ploiement sur le serveur Glassfish http www mdweb project org files releases mdweb 2011 09 2 3 war e T l chargez le fichier war e Depuis le navigateur se connectez a http adresseIP de votre serveur 4848 e Cliquez sur Applications RD 11 institut de
9. lation en 32 bit en choisissant le fichier se Mi AVANT terminant 1586 jdk exe L extension JAI 1 1 3 est d ja install e par d faut sous Mac OS Snow Leopard Pour linux privil gier le t l chargement des fichiers zip avec extraction des fichiers jar vers les 4 r pertoires JVM de la machine r pertoire JRE jar dans lib ext et so dans 1ib i386 Le fichier bin semble d fectueux 3 1 3 JAI Image lO 1 1 http download java net media jai imageio builds release 1 1 e T l chargez l installeur JAI Image IO 1 1 contenant JDK dans le nom du fichier e Lancez et suivez l installeur Il n existe pas d extension Image IO pour windows 64 bit Poursuivez l installation en 32 bit en choisissant le fichier se terminant par windows 1586 jdk exe Pour Mac T l chargez le fichier pour linux tar gz D zippez le Puis copiez les fichiers du r pertoire lib dans le r pertoire extension du dossier Java Library Java Extensions IRD 4 institut de recherche pour le d veloppement Quick Start Installation de MDweb version 2011 Pour Linux privil gier le t l chargement des fichiers zip avec extraction des fichiers jar vers les 4 r pertoires JVM de la _ r pertoire JRE jar dans lib ext et so dans 1ib 1386 Le fichier bin semble d fectueux 3 2 Serveur d application La description de l installation du serveur d application se trouve en annexe Selon q
10. pertoire mdweb se trouve dans le r pertoire utilisateur C Document and settings Nom d utilisateur Application Data Pour mac et linux un r pertoire mdweb se trouve dans le r pertoire utilisateur Users Nom d utilisateur 1 3 Supprimer la base de donn es PosgreSQL Depuis PgAdmin supprimer la base MDweb Derby Les bases de donn es sont stock es dans le dossier de travail IRD 14 Institut de recherche pour le d veloppement Quick Start Installation de MDweb version 2011 1 4 Supprimer le dossier de travail Il se trouve l endroit sp cifi lors de l installation 2 R initialisation La r initialisation des param tres de configuration de MDweb n cessite de supprimer le r pertoire de configuration cf D sinstallation 2 Supprimer le r pertoire de configuration IRD F 15 Institut de recherche pour le d veloppement Mail list et forum http mdweb project 8699 Contacts IRD jean christophe desconnets ird fr dorian ginane ird fr Geomatys vincent heurteaux geomatys fr Sites web Mdweb http www mdweb project org IRD http www espace 1rd fr GEOMATYS http www geomatys com
11. serveur d application d crire dans le dossier de travail et d enregistrer des fichiers de configuration dans son r pertoire utilisateur 4 1 Cr ation du r pertoire de travail Au premier lancement MDweb requiert la cr ation d un r pertoire de travail o seront stock es les ressources associ es aux fiches de m tadonn es cr es Le syst me d exploitation sous lequel est d ploy MDweb doit poss der les droits d criture et de lecture Sur ce r pertoire Le r pertoire peut devenir d une taille volumineuse En effet c est ici que se trouveront les donn es du SGBD Derby les fichiers associ s aux fiches de m tadonn es e Ecrivez le chemin o vous souhaitez cr er ce r pertoire dans le champ Directory e Cliquez sur Configure the storage directory 4 2 Choix de la base Ensuite MDweb propose de choisir entre la configuration entre la base de donn e embarqu Derby et le SGBD PostgreSQL base distante Ce choix d pend de l installation effectu e Derby Derby sera install si vous cliquez sur le bouton Cr e une base de donn es embarqu e Cependant ce SGBD ne convient que pour des bases peu volumineuses SGBD PostgeSQL Cliquez sur Configurer MDweb puis sur Se connecter a une base de donn es existante Si le SGBD PostgreSQL est install sur la m me machine les param tres par d faut sont e SGBD serveur localhost e port 5432 e Nom de l utilis
12. tion peut chou e si la racine du r pertoire d installation de Glassfish est modifi e Il est donc conseill de garder le chemin de cette racine par d faut C Glassfishv3 Note Le serveur Glassfish est install avec un domaine par d faut domain 1 dans laquelle MDweb peut tre d ploy Cependant il est possible de cr er un autre domaine sp cifique a MDweb les tapes suivre se trouvent dans l annexe A L acc s au domaine domain se fait par les ports e Port 4848 gt Configuration e Port8080 gt HTTP Il y a 2 autres ports pour JMX et HTTPS 2 Glassfish d marrage du domaine Depuis le terminal lancez l application asadmin du serveur d application L application se trouve dans le r pertoire bin du serveur d application racine glassfish bin Dans l application asadmin ex cutez la commande asadmin start domain nom de votre domaine pour linux et mac exemple asadmin start domain domain RDS 10 institut de recherche pour le d veloppement Quick Start Installation de MDweb version 2011 asadmin start domain nom de votre domaine pour windows exemple asadmin start domain domain 1 3 Glassfish Configuration du domaine Les modifications et ajout des parametres suivants am lioreront les performances des applications qui seront d ploy es sur le domaine Ils modifient la configuration de la machine virtuelle Java JVM Depuis le nav
13. ue vous choisissez d installer Tomcat ou Glassfish reportez vous en annexe A ou B 3 2 1 Installation des pilotes JDBC 2 pilotes doivent tre install s Pilote PostgreSQL http www mdweb project org files longterm postgresql 9 0 801 jdbc4 jar Pilote Derby http www mdweb project org files longterm derby jar T l chargez les fichiers e Placez les fichiers sous le r pertoire Racine de glassfish glassfish lib ou Racine de tomcat lib e Attribuez aux fichiers les m mes droits que les autres fichiers du dossier 3 3 SGBD Syst me de Gestion de Base de Donn es MDweb stocke ses informations dans une base de donn es relationnelle PostgreSQL ou le SGBD embarqu Derby Ceci n cessite que l utilisateur installe PostgreSQL et cr e une base de donn es PostgreSQL pour chaque instance MDweb d ploy e 3 3 1 PostgreSQL http www enterprisedb com products services training pgdownload e T l chargez PostgreSQL Installez e PostgreSQL 8 4 e PgAdmin Depuis PgAdmin e Cr ez une nouvelle base avec un codage UTF 8 mdweb test par exemple la laisser vide Les tables n cessaires a MDweb seront cr es lors du premier lancement RD 5 Institut de recherche pour le d veloppement VAN NS Quick Start Installation de MDweb version 2011 4 D ploiement de MDweb Le d ploiement de MDweb doit se faire par l utilisateur ayant les droits de lancer le
14. ui lance le serveur d applications devra disposer des droits d critures sur les r pertoires cr s par le serveur d applications sur son r pertoire utilisateur et sur les r pertoires de travail Note Les mots de passe d acc s aux bases de donn es seront stock s dans les fichiers de configuration sur le serveur Il faut donc contr ler l acc s au dossier de configuration r pertoire utilisateur mdweb ou r pertoire utilisateur application data mdweb windows aT MANS IRD 3 Institut de recherche pour le d veloppement Quick Start Installation de MDweb version 2011 3 Installation 3 1 Java 3 1 1 JDK 1 6 0 http java sun com javase downloads widget jdk6 jsp e T l chargez la JDK 1 6 0 correspondant votre Syst me d exploitation e Double cliquez sur le fichier t l charg e Suivez l installeur Sur les syst mes d exploitation Windows il est n cessaire d installer la JDK en version 32 bit T l chargez le fichier se terminant par windows i586 exe En effet les extensions JAI et Image IO ne sont pas disponibles pour les Windows 64 bit La JDK 1 6 0 est d ja install e par d faut sous Mac OS Snow Leopard 3 1 2 JAI 1 1 3 http download java net media jai builds release 1_1_3 e T l chargez l installeur de JAI 1 1 3 contenant JDK dans le nom du fichier e Lancez et suivez l installeur Note Il n existe pas de JAI pour windows 64 bit Continuez l instal
Download Pdf Manuals
Related Search