arcopole Studio Version 3.3 Documentation d installation Mise à jour depuis une version antérieure Site du programme arcopole : www.arcopole.fr Auteur du document : Esri France Version de la documentation : 3.3.0.7 Date de dernière mise à jour : 07/07/2015
Sommaire I Introduction... 3 I.1 Le programme arcopole... 3 I.2 Qu est-ce qu arcopole Studio?... 3 I.3 Quoi de neuf dans cette version d arcopole Studio?... 3 I.4 Contenu de ce document... 3 II Mise à jour depuis la version 3.2... 4 II.1 Configuration de Tomcat... 5 II.2 Sauvegarde de la version précédente... 5 II.3 Mise à jour de la webapp... 6 II.4 Vidage du cache des postes clients... 12 II.5 Vidage du cache Tomcat... 12 II.6 Ouverture d arcopole Studio... 12 III Mise à jour depuis une version antérieure à la 3.2... 13 III.1 Sauvegarde de la version précédente... 13 III.2 Installation de la nouvelle version... 13 III.3 Vidage du cache des postes clients... 13 III.4 Récupération de la configuration précédente... 14 07/07/2015 Version doc. : 3.3.0.7 Page 2 sur 15
I INTRODUCTION I.1 LE PROGRAMME ARCOPOLE Le programme arcopole, initiative lancée par Esri France, ambitionne de rassembler une communauté de professionnels des secteurs publics et privés et d animer des projets collaboratifs. L objectif est de mettre à disposition des «outils métiers» et «templates» (exemples de modèles de données, d applications et d'utilisations) pour répondre à certains besoins récurrents et simples des collectivités. Il doit vous permettre de tirer le meilleur parti des technologies SIG proposées par Esri. I.2 QU EST-CE QU ARCOPOLE STUDIO? ArcOpole Studio est un des templates disponibles sur le site www.arcopole.fr. Il s agit d un générateur d applications Flex pour ArcGIS for Server. ArcOpole Studio propose des interfaces modernes pour configurer des applications facilement et gérer des droits d accès par utilisateurs. En plus des fonctionnalités rendues disponibles dans le noyau d arcopole Studio, d autres sont proposées sous la forme d extensions. A l heure de la rédaction de ce document, les extensions disponibles sont les suivantes : Cadastre PLU Connecteur ADS Operis Localisation XY Identification Multicouche (IMC) Rapports Géotraitements (bêta) Cartographie des données décisionnelles Symbologie I.3 QUOI DE NEUF DANS CETTE VERSION D ARCOPOLE STUDIO? La liste complète des nouveautés est disponible sur l espace contributif du programme arcopole. Si vous ne l avez pas encore fait, contactez l équipe arcopole pour accéder à cet espace d information et d échanges entre Collectivités. I.4 CONTENU DE CE DOCUMENT Vous trouverez dans ce document toutes les informations nécessaires à la mise à jour d arcopole Studio. La mise à jour d arcopole Studio est aisée si vous disposez de la version juste antérieure (3.2). Les pages suivantes vous guident dans cette mise à jour pas-à-pas. Si vous disposez d une version plus ancienne, vous devez réaliser une installation vierge puis y copier vos fichiers de configuration d applications. Les mêmes conventions que celles de la documentation d installation sont conservées ici. 07/07/2015 Version doc. : 3.3.0.7 Page 3 sur 15
II MISE A JOUR DEPUIS LA VERSION 3.2 La mise à jour d arcopole Studio est possible depuis une version antérieure et se fait manuellement. Voici les étapes à suivre : Note importante : cette procédure de mise à jour a été rédigée pour les utilisateurs d arcopole Studio qui disposent d une version standard de l outil. Si vous avez développé (ou fait développer) des fonctionnalités spécifiques, des extensions personnelles ou modifié l interface de l outil (skin), ne mettez pas à jour votre application sans avoir validé techniquement que vos développement fonctionneront (la création d une plateforme de test est fortement conseillée). 07/07/2015 Version doc. : 3.3.0.7 Page 4 sur 15
II.1 CONFIGURATION DE TOMCAT Cette nouvelle version d arcopole Studio requiert l utilisation du JDK 1.7.0. Après avoir arrêté Tomcat : 1. Téléchargez 1 et installez le JDK 1.7.0 sur votre serveur. 2. Cliquez sur le bouton «Démarrer» de Windows 3. Dans la liste des programmes sélectionnez le programme «Configure Tomcat» du dossier «Apache Tomcat xxx». 4. Dans la fenêtre des propriétés d Apache Tomcat, ouvrez l onglet «Java» 5. Modifiez la Java Virtual Machine en sélectionnant le fichier jvm.dll du jre7 installée précédemment. Exemple : II.2 SAUVEGARDE DE LA VERSION PRECEDENTE Faites une sauvegarde complète du répertoire d installation de la version précédente d arcopole Studio ( \webapps\studio par défaut) en l archivant sous la forme d un fichier ZIP par exemple. Ne dupliquez pas simplement le répertoire en le laissant dans \webapps, cela aurait comme conséquence de déployer une nouvelle application Web. 1 Concernant le JDK : Le packaging de téléchargement du JDK proposé par défaut sur le site d ORACLE a changé et peut poser problème. Il faut veiller à télécharger un JDK 1.7 sans le serveur GlassFish (sur le site www.oracle.com, rubrique Downloads > Java for Developers > Java SE > Downloads > Java SE 7). A l heure de la rédaction de cette documentation, le nom exact du composant à télécharger est «Java SE Development Kit 7u71» et peut être téléchargé ici. 07/07/2015 Version doc. : 3.3.0.7 Page 5 sur 15
II.3 MISE A JOUR DE LA WEBAPP L objectif de cette étape est de 1. supprimer les fichiers qui ont été mis à jour dans cette nouvelle version, 2. copier les nouveaux fichiers, 3. modifier légèrement la configuration pour profiter des nouveautés II.3.1 Suppression des anciens fichiers II.3.1.1 Anciennes librairies du serveur Supprimez le répertoire WEB-INF/lib. II.3.1.2 Ancienne gestion des logs Dans le répertoire WEB-INF/logs, supprimez les fichiers : II.3.1.3 log4j.configuration log4j.properties log4j-replica.configuration log4j-replica.properties (ce fichier est présent seulement si vous avez utilisé le script de réplication) Fichiers samples Supprimez le répertoire studio\samples. II.3.1.4 Fichiers des extensions Toutes les extensions ont fait l objet de mises à jour. Chacune de ces extensions dispose de sa propre documentation d installation que vous devez suivre pour sa mise à jour (notamment l extension Cadastre). II.3.2 Copie des nouveaux fichiers Copiez l ensemble des fichiers de l archive «migration-depuis-3.2.zip» dans la webapp existante et acceptez tous les remplacements des fichiers existants. II.3.3 Modification des fichiers de configuration Attention lors des copier/coller depuis le fichier PDF. Il arrive que des espaces impromptus se glissent ou que des caractères soient tronqués pendant l opération. II.3.3.1 Modification des librairies du serveur Si votre serveur ArcGIS est < 10.1, ajoutez la librairie arcobject.jar dans /WEB-INF/lib. Si vous utilisiez l extension Cadastre, ajoutez la librairie du driver jdbc requis pour se connecter à la base de données Cadastre. II.3.3.2 Modification de la gestion des logs Cette version d arcopole Studio utilise log4j2. La configuration par défaut ne génère que des logs de niveau ERROR. Si vous souhaitez rétablir votre ancienne gestion de logs, il est nécessaire de modifier les fichiers log4j2.configuration et log4j2-replica.configuration. 07/07/2015 Version doc. : 3.3.0.7 Page 6 sur 15
II.3.3.3 Modification de la configuration du serveur 1. Créez une archive de votre ancien fichier de configuration. Pour cela, renommez le fichier studio\web-inf\configuration.xml en studio\web- INF\configuration.xml.avantmigration3.3.0.0. 2. La configuration du serveur a été modifiée. Nous livrons désormais une version pour chaque version d ArcGIS. Selon votre version d ArcGIS for Server, dans le répertoire studio\web-inf\, faites une copie du fichier correspondant à votre version et renommez-la en configuration.xml. Exemple : si vous disposez d ArcGIS 10.2, faites une copie de configuration.xml-10.2.autoconf.xml et renommez-la en en configuration.xml. 3. Nous allons à présent rétablir les points de configuration spécifique à votre plateforme. Si votre serveur ArcGIS est < 10.1 : Supprimez les lignes suivantes : <var name="server" value="@server@" /> <var name="agshost" value="@agshost@"/> <var name="webappname" value="@webappname@" /> <var name="orionhost" value="@orionhost@" /> <var name="webserverprotocol" value="@webserverprotocol@" /> <var name="agsuser" value="@agsuser@" /> <var name="agspassword" value="@agspassword@" /> <var name="agsdomain" value="@agsdomain@" /> <var name="agsdcomhost" value="@agsdcomhost@" /> <var name="agsjobs" value="@agsjobs10@" /> <var name="agsinput" value="@agsinput10@" /> Recopiez le bloc de variables correspondant de l ancien fichier configuration.xml.avantmigration3.3.0.0 à la place des lignes supprimées dans configuration.xml. Modifiez le nom de la variable name="agshosts" en name="agshost" (suppression du «s») Si votre serveur ArcGIS est >= 10.1 : Supprimez les lignes suivantes : <var name="server" value="@server@" /> <var name="agshosts" value="@agshost@"/> <var name="webappname" value="@webappname@" /> <var name="orionhost" value="@orionhost@" /> <var name="webserverprotocol" value="@webserverprotocol@" /> <var name="agsjobs" value="@agsjobs10_1@" /> <var name="agsinput" value="@agsinput10_1@" /> Recopiez le bloc de variables correspondant de l ancien fichier configuration.xml.avantmigration3.3.0.0 à la place des lignes supprimées dans configuration.xml. Modifiez le nom de la variable name="agshosts" en name="agshost" (suppression du «s») 07/07/2015 Version doc. : 3.3.0.7 Page 7 sur 15
Vérifiez les points de configuration suivants (vous pouvez comparer ces paramètres avec ceux de la sauvegarde configuration.xml.avantmigration3.3.0.0) : o Url du service d impression : <urlfilter startwith="/mxdprint" handler-class="com.esrifrance.restfmksrv.handlers.print.mxd.printmxdhandler3"> <handler-configuration> <Redirect absoluteurl="/arcgis/rest/services/arcopole/arcopoleprint/mapserver/exts/soemxdprinter"/> </handler-configuration> </urlfilter> o Configuration des rapports : <urlfilter startwith="/report" handler-class="com.esrifrance.restfmksrv.handlers.arcopole.report.reporthandler"> <handler-configuration> <engines> <engine name="jasper" alias="ireport" modelxmlpath="${apppath}\rapports\jasper\models.xml" geoprocessingurl="${orionhost}/arcgis/rest/services/arcopole/rapports/gpserver/jasper" tmppath="${agsinput}" /> <engine name="xslt" alias="xslt" modelxmlpath="${apppath}\rapports\xslt\models.xml" geoprocessingurl="${orionhost}/arcgis/rest/services/arcopole/rapports/gpserver/xslt" tmppath="${agsinput}" /> </engines> </handler-configuration> </urlfilter> 4. Si vous utilisiez l extension Cadastre : Recherchez le terme «ICadastreService» et décommentez la balise <override-class> : <override-class service-class="com.esrifrance.restfmksrv.handlers.arcopole.cadastre2.icadastreservice" implementation-class="com.esrifrance.restfmksrv.handlers.arcopole.cadastre2.cadastreservice" /> Puis recherchez le terme «CadastreResourceBuilder» et décommentez la balise <ResourceBuilder> : <configuration name="resources"> <ResourceBuilder class="com.esrifrance.restfmksrv.kernel.rightmanagement.cadastre.resource.cadastreresourcebuilder" /> </configuration> Puis recherchez le terme «CadastreHandler» et décommentez la balise <urlfilter> : <urlfilter startwith="/cadastre" handler-class="com.esrifrance.restfmksrv.handlers.arcopole.cadastre2.cadastrehandler"> <handler-configuration> </handler-configuration> </urlfilter> Puis recherchez le terme «CadastreConfiguration», supprimez l attribut filter-nominativinfo et rétablissez la valeur des attributs on-demand-cache et cache-path (comme dans dans l ancien fichier de configuration.xml.avantmigration3.3.0.0). Puis décommentez les deux balises <TableSearchHandler> : <configuration name="cadastre" AppPath="${AppPath}"> <CadastreConfiguration on-demand-cache="false"> <TableSearchHandler classname="com.esrifrance.restfmksrv.handlers.arcopole.cadastre2.model.tools.tablesearch.initializer.jdbctablesearchinitializ er"> 07/07/2015 Version doc. : 3.3.0.7 Page 8 sur 15
</TableSearchHandler> </CadastreConfiguration> </configuration> Dans la balise <TableSearchHandler> recopiez le paramétrage de la connexion jdbc active dans l ancien fichier de configuration.xml.avantmigration3.3.0.0 (balise <jdbc database>). 5. Si vous accédez à des services sécurisés de votre serveur ArcGIS : Recherchez la connexion «ags0» et remplacer AGSConnection par AGSTokenConnection Rajoutez les balises <token> et <referer> et spécifiez les valeurs utilisées dans votre ancienne configuration dans les variables AgsToken et AgsTokenReferer : <!-- Connexion au serveur ArcGIS --> <connection name="ags0" class="com.esrifrance.orion.connections.ags.agstokenconnection"/> <token>bovanwf7r3kmespnpz4qmpraxre- V64SGCZDy4rVOXFFhgU2jSLsEE73MzCyvxnSn2vsRKXnJo_mfLkGQUuqwQ..</token> <referer>http://mon_serveur:8080/studio</referer> <http hosts="localhost:6080" scheme="http" /> </connection> II.3.3.4 Modification de la configuration du studio La configuration du studio a été modifiée. Nous livrons désormais une version pour chaque version d ArcGIS. Selon votre version d ArcGIS for Server, dans le répertoire studio\web-inf\applications\tfa, supprimez l actuel configuration.xml puis faites une copie du fichier correspondant à votre version et renommez-la en configuration.xml. Exemple : si vous disposez d ArcGIS for Server 10.2, supprimez configuration.xml, faites une copie de configuration.xml-10.2.autoconf.xml et renommez-le en en configuration.xml. Pour bénéficier de la nouvelle fonctionnalité permettant de gérer l étendue d ouverture des applications, il est nécessaire de modifier le fichier studio\web- INF\applications\TFA\client.xml. Recherchez la balise <components/> et complétez cette balise pour disposer de : <components> <component id="extentwizard" p_basemap="http://services.arcgisonline.com/arcgis/rest/services/world_topo_map/mapserver" p_defaultextent="" p_mapservice=" "/> </components> II.3.3.5 Vous pouvez définir les variables p_defaultextent et p_mapservice tel que décrit au IV.6 de la documentation principale d installation. Une documentation concernant l utilisation de cette fonctionnalité est disponible ici. Modification de la configuration du template d application Le template d application a été modifié. Nous livrons désormais une version pour chaque version d ArcGIS. Selon votre version d ArcGIS for Server, dans le répertoire studio\web-inf\applications, supprimez l actuel templateapplication.xml puis faites une copie du modèle d application correspondant à votre version et renommez-la en templateapplication.xml. 07/07/2015 Version doc. : 3.3.0.7 Page 9 sur 15
Exemple : si vous disposez d ArcGIS for Server 10.2, supprimez templateapplication.xml, faites une copie de templateapplication.xml-10.2.autoconf.xml et renommez-la en en templateapplication.xml. 07/07/2015 Version doc. : 3.3.0.7 Page 10 sur 15
II.3.3.6 Modification de la configuration des applications Après avoir suivi la procédure décrite dans la section précédente Modification de la configuration du template d application, dupliquer le fichier studio\web- INF\applications\templateApplication.xml en studio\web- INF\applications\configuration.xml Copier ce fichier configuration.xml dans tous les répertoires de studio\web- INF\applications à l exception de _templatebase et de TFA. Acceptez de remplacer le fichier du dossier de destination par ce fichier. Supprimer le fichier studio\web-inf\applications\configuration.xml. II.3.3.7 Référencement des nouvelles extensions De nouvelles extensions sont livrées avec la version 3.3. Il s agit des extensions suivantes : Extension XY : elle affiche les coordonnées courantes de la souris et permet de localiser des points à partir de leurs coordonnées Extension Symbologie : elle permet à l utilisateur de retoucher la symbologie d une sélection d objets. Pour pouvoir les utiliser, vous devez les référencer dans le fichier studio\web- INF\applications\TFA\client.xml : <service id="externallibrairiesloader"> <module>extensions/extensionidentificationmc.swf</module> <module>extensions/extensionrapport.swf</module> <module>extensions/extensiongeotraitement.swf</module> <module>extensions/extensionsymbologie.swf</module> <module>extensions/extensionlocalisationxy.swf</module> </service> II.3.3.8 Configuration des droits d accès aux données cadastre Avec la nouvelle version d arcopole Studio, la gestion des droits d accès aux données cadastrales a été modifiée. 1. Dans le fichier studio\web-inf\orionconfig\repository_fmk.xml, recherchez la balise </Applications> et ajoutez à la suite, la ligne suivante : </Applications> <Path></Path> 2. Reportez-vous ensuite au document PDF intitulé «5 - Extension Cadastre - Script de Migration des droits» qui est disponible dans le téléchargement de l extension Cadastre. Il vous guidera dans l utilisation du script de migration des droits d accès aux données cadastrales pour transférer les droits dans le fichier repository_fmk.xml. 07/07/2015 Version doc. : 3.3.0.7 Page 11 sur 15
II.4 VIDAGE DU CACHE DES POSTES CLIENTS La mise à jour de l application nécessite que les fichiers qui ont été sauvegardés dans les caches des navigateurs soient mis à jour. Pour cela, il vous faut vider le cache de votre navigateur afin de provoquer le téléchargement de la nouvelle version des fichiers. Note : cette étape est à réaliser sur les postes de vos utilisateurs également II.5 VIDAGE DU CACHE TOMCAT Dans %TOMCAT%/work/Catalina/localhost/ supprimez le répertoire de votre application (studio par défaut). II.6 OUVERTURE D ARCOPOLE STUDIO Accédez à la page d accueil et connectez-vous en tant qu administrateur (admin / arcopole). 07/07/2015 Version doc. : 3.3.0.7 Page 12 sur 15
III MISE A JOUR DEPUIS UNE VERSION ANTERIEURE A LA 3.2 La mise à jour depuis une version 3.1.1 ou antérieure nécessite de : sauvegarder votre version actuelle, installer la nouvelle version de zéro, Ensuite, pour les applications deux solutions se présentent : o Soit les recréer de toute pièce o Soit récupérer la configuration des applications que vous aviez créées. III.1 SAUVEGARDE DE LA VERSION PRECEDENTE Après avoir arrêté Tomcat, faites une sauvegarde complète du répertoire d installation de la version précédente d arcopole Studio ( \webapps\studio par défaut) en l archivant sous la forme d un fichier ZIP par exemple. Ne dupliquez pas simplement le répertoire en le laissant dans \webapps, cela aurait comme conséquence de déployer une nouvelle application Web. III.2 INSTALLATION DE LA NOUVELLE VERSION Pour connaître toutes les étapes de l installation de la nouvelle version, reportez-vous à la documentation d installation et de configuration. Pour valider votre installation, essayez de créer une ou deux applications et, une fois cela confirmé, passez à l étape suivante de la récupération des applications. III.3 VIDAGE DU CACHE DES POSTES CLIENTS La mise à jour de l application nécessite que les fichiers qui ont été sauvegardés dans les caches des navigateurs soient mis à jour. Pour cela, il vous faut vider le cache de votre navigateur afin de provoquer le téléchargement de la nouvelle version des fichiers. Note : cette étape sera à réaliser sur les postes de vos utilisateurs également 07/07/2015 Version doc. : 3.3.0.7 Page 13 sur 15
III.4 RECUPERATION DE LA CONFIGURATION PRECEDENTE III.4.1 Fichier des utilisateurs Le fichier des utilisateurs est le fichier \WEB-INF\orionConfig\repository_fmk.xml. Il vous faut : </Applications> <Path></Path> Archiver le fichier de la nouvelle installation, Copier votre ancien fichier à la place du nouveau Dans ce fichier \WEB-INF\orionConfig\repository_fmk.xml, rechercher la balise </Applications> et ajouter, à la suite, la ligne suivante : III.4.2 Copie des applications III.4.2.1 Copie de la configuration Copiez le dossier correspondant à l application «monappli» situé dans le répertoire des applications (par exemple \ancienstudio\web-inf\applications) dans la nouvelle installation (par exemple webapps\nouveaustudio\web-inf\applications). III.4.2.2 Modification des fichiers de configuration Si la nouvelle version d arcopole Studio est installée sous la forme d une webapp différente (le nom du répertoire dans Tomcat est différent, par exemple avant \webapp\studiov3-1-1 et maintenant \webapp\studiov3-2), il vous faut rechercher et remplacer l ancien nom par le nouveau dans les fichiers suivants : \WEB-INF\applications\monAppli\client.xml \WEB-INF\applications\monAppli\configuration.xml Notez que si vous en avez profité pour changer de plateforme, il vous faut également adapter les noms des serveurs / ports dans ces fichiers de configuration Puis dupliquez le fichier studio\web-inf\applications\templateapplication.xml en studio\web- INF\applications\configuration.xml Copier ce fichier configuration.xml dans tous les répertoires de studio\web-inf\applications à l exception de _templatebase et de TFA. Acceptez de remplacer le fichier du dossier de destination par ce fichier. Supprimer le fichier studio\web-inf\applications\configuration.xml. 07/07/2015 Version doc. : 3.3.0.7 Page 14 sur 15
III.4.2.3 Ajout des droits d accès à l application Ouvrez le fichier \WEB-INF\orionConfig\repository_fmk.xml de l ancienne installation et recherchez la balise XML Resource contenant le nom de votre application. <Resource cn="application:\2f\2fmonappli"dn="cn=application:\2f\2ftestldap,ou=ressourcebasedn"> <Role name="userrole_gurvan"> <Right name="select">true</right> </Role> <Role name="grouprole_toutlemonde"> <Right name="select">true</right> </Role> </Resource> Copiez cette configuration dans le nouveau fichier repository_fmk.xml entre les balises <Applications> et </Applications>. Rejouez les étapes précédentes pour toutes les applications à migrer. Redémarrez Tomcat pour prendre en compte cette configuration. 07/07/2015 Version doc. : 3.3.0.7 Page 15 sur 15