arcopole Studio Annexe 7 Architectures Site du programme arcopole :

Transcription

1 4 arcopole Studio Annexe 7 Architectures Site du programme arcopole : Auteur du document : Esri France Version de la documentation : Date de dernière mise à jour : 02/12/2013

2 Sommaire I Introduction... 3 II Exemples d architecture simples... 4 II.1 ArcGIS Server et arcopole Studio sur un même serveur... 4 II.2 ArcGIS Server et arcopole Studio sur deux serveurs différents... 5 II.3 Configuration des rapports et de l impression... 7 II.3.1 Serveur arcopole... 7 II.3.2 Serveur SIG... 7 II.3.3 ArcGIS for Server... 7 II.3.4 Configuration.xml... 8 III Exemple d Architecture HTTPS III.1 Présentation III.2 Patch /12/2013 Version doc. : Page 2 sur 11

3 I INTRODUCTION La variété des utilisations d arcopole Studio nécessite que le logiciel puisse être installé dans différentes architectures techniques. Cette documentation présente les différentes architectures supportées suivantes et leurs implémentations : Architectures simples (HTTP) Architectures sécurisées (HTTPS) D autres architectures peuvent être mises en œuvre. Chaque cas étant particulier, cette documentation ne peut tous les traiter. Dans la mesure du possible, nous vous conseillons de suivre les préconisations de ce document pour bénéficier d un support efficace. Sachez également que les experts d Esri France peuvent vous accompagner dans la mise en œuvre d architectures différentes en fonction de vos besoins. Enfin, vous trouverez en dernière partie de document, des informations sur l architecture de génération des rapports et de l impression. 02/12/2013 Version doc. : Page 3 sur 11

4 II EXEMPLES D ARCHITECTURE SIMPLES Afin de vous aider dans votre installation d arcopole Studio, voici le schéma d une architecture habituelle HTTP et les valeurs des différentes variables à indiquer lors de l installation. Ces schémas sont proposés pour les versions 10.0, 10.1, 10.2 et d ArcGIS for Server supportées. II.1 ARCGIS SERVER ET ARCOPOLE STUDIO SUR UN MEME SERVEUR Dans le schéma ci-dessus, arcopole Studio et ArcGIS Server sont installés sur la même machine. Cette dernière porte le nom de SERVEUR_SIG sur le domaine et on y peut accéder en http à l adresse Tomcat a été installé sur le port 8080 et ArcGIS for Server, en fonction de sa version répond sur : en 10.0 : le port 80 (.net) ou 8099 (JAVA) en : le port 6080 L utilisateur User_SIG est local à SERVEUR_SIG et est un utilisateur ArcGIS (membre de AGS_User en 10.0 ; utilisateur arcgis créé lors de l installation en 10.1+). Dans ce contexte, les différentes variables à utiliser pendant l installation sont les suivantes : AGS_SERVER_VERSION = 10.0 WEB_SERVER_HOST : sig.macollectivite.org:8080 WEB_SERVER_PROTOCOL : http WEBAPP_NAME : studio AGS_HOST : SERVEUR_SIG AGS_WEBAPI_HOSTS : SERVEUR_SIG <!-- port 80 non précisé ou 8099 à indiquer --> AGS_USER : User_SIG AGS_PWD : Password_SIG AGS_DOMAIN : SERVEUR_SIG AGS_INPUT_10= C:/arcgisserver/arcgisinput AGS_JOBS_10= C:/arcgisserver/arcgisjobs Exemple de configuration en /12/2013 Version doc. : Page 4 sur 11

5 AGS_SERVER_VERSION = 10.1 ou 10.2 WEB_SERVER_HOST : sig.macollectivite.org:8080 WEB_SERVER_PROTOCOL : http WEBAPP_NAME : studio AGS_HOST : SERVEUR_SIG AGS_WEBAPI_HOSTS : SERVEUR_SIG:6080 AGS_USER : arcgis AGS_PWD : arcgis_password AGS_DOMAIN : SERVEUR_SIG AGS_INPUT_10_1: C:/arcgisserver/directories/arcgissystem/arcgisinput AGS_JOBS_10_1 : C:/arcgisserver/directories/arcgisjobs Exemple de configuration en II.2 ARCGIS SERVER ET ARCOPOLE STUDIO SUR DEUX SERVEURS DIFFERENTS Dans le schéma ci-dessus, arcopole Studio et ArcGIS Server sont installés sur deux machines différentes. Le serveur ArcGIS porte le nom de SERVEUR_SIG sur le domaine ; le serveur sur lequel arcopole Studio est installé porte le nom SERVEUR_ARCOPOLE sur le domaine, et on y peut accéder en http à l adresse Tomcat a été installé sur le port 8080 et ArcGIS for Server, en fonction de sa version répond sur : en 10.0 : le port 80 (.net) ou 8099 (JAVA) en : le port 6080 L utilisateur User_SIG est local à SERVEUR_SIG et est un utilisateur ArcGIS (membre de AGS_User en 10.0 ; utilisateur arcgis créé lors de l installation en 10.1+). 02/12/2013 Version doc. : Page 5 sur 11

6 Dans ce contexte, les différentes variables à utiliser pendant l installation sont les suivantes : AGS_SERVER_VERSION = 10.0 WEB_SERVER_HOST : sig.macollectivite.org:8080 WEB_SERVER_PROTOCOL : http WEBAPP_NAME : studio AGS_HOST : SERVEUR_SIG AGS_WEBAPI_HOSTS : SERVEUR_SIG <!-- port 80 non précisé ou 8099 à indiquer --> AGS_USER : User_SIG AGS_PWD : Password_SIG AGS_DOMAIN : SERVEUR_SIG AGS_INPUT_10= \\SERVEUR_DMZ\partage\arcgisserver\arcgisinput AGS_JOBS_10= \\SERVEUR_DMZ\partage\arcgisserver\arcgisjobs Exemple de configuration en 10.0 AGS_JOBS_10= C:/arcgisserver/arcgisjobs AGS_SERVER_VERSION = 10.1 ou 10.2 WEB_SERVER_HOST : sig.macollectivite.org:8080 WEB_SERVER_PROTOCOL : http WEBAPP_NAME : studio AGS_HOST : SERVEUR_SIG AGS_WEBAPI_HOSTS : SERVEUR_SIG:6080 AGS_USER : arcgis AGS_PWD : arcgis_password AGS_DOMAIN : SERVEUR_SIG AGS_INPUT_10_1: \\SERVEUR_DMZ\partage\arcgisserver\arcgisinput AGS_JOBS_10_1 : \\SERVEUR_DMZ\partage\arcgisserver\arcgisjobs Exemple de configuration en /12/2013 Version doc. : Page 6 sur 11

7 II.3 CONFIGURATION DES RAPPORTS ET DE L IMPRESSION Cette architecture nécessite l usage d un répertoire partagé entre les deux machines (SERVEUR_ARCOPOLE et SERVEUR_SIG) pour pouvoir générer et récupérer des rapports ainsi que pour l impression. Voici les étapes de configuration spécifiques. II.3.1 Serveur arcopole Créez les répertoires suivants sous un répertoire commun (ou bien sur les deux machines en respectant le même chemin d accès) : - arcgisjobs - arcgisoutput - arcgisinput : contiendra les fichiers XML générés par arcopole Studio - rapports : y copier les modèles de rapports jasper et xslt. - arcopoleprint Exemple : D:\partage\arcgisjobs D:\partage\arcgisoutput D:\partage\rapports D:\partage\arcgisinput D:\partage\arcOpolePrint D étant : o o soit un disque réseau sur les deux machines soit un second disque présent sur les deux machines et dont le répertoire «partage» est créé symétriquement sur les deux machines. Copiez le répertoire studio/web-inf/printtemplates dans arcopoleprint ainsi que le fichier studio/web-inf/orionconfig/printauth.xml. II.3.2 Serveur SIG Créez cinq répertoires virtuels arcgisjobs, arcgisoutput, arcgisinput, rapports et arcopoleprint correspondants aux cinq répertoires partagés précédemment sur serveur ARCOPOLE et y donner accès au compte arcgis et «tomcat». Exemple : \\SERVEUR_ARCOPOLE\partage\arcgisjobs \\SERVEUR_ARCOPOLE\partage\arcgisoutput \\SERVEUR_ARCOPOLE\partage\arcgisinput \\SERVEUR_ARCOPOLE\partage\rapports \\SERVEUR_ARCOPOLE\partage\arcOpolePrint II.3.3 ArcGIS for Server La configuration de votre ArcGIS Server doit également être modifiée : Dans votre Site ajoutez un nouveau répertoire arcgisjobsarcopole de type Tâches : arcgisjobsarcopole : \\SERVEUR_ARCOPOLE\partage\arcgisjobs 02/12/2013 Version doc. : Page 7 sur 11

8 Ajoutez également un nouveau répertoire arcgisoutputarcopole de type Sortie : arcgisoutputarcopole : \\SERVEUR_ARCOPOLE\partage\arcgisoutput Configurez le service Rapports : - Répertoire des tâches : \\SERVEUR_ARCOPOLE\partage\arcgisjobs - Répertoire en sortie : \\SERVEUR_ARCOPOLE\partage\arcgisoutput Si vous utilisez ArcGIS 10.1 ou 10.2 configurez la fonctionnalité SOEMxdPrinter du service arcopoleprint : - templates : \\SERVEUR_ARCOPOLE\partage\arcOpolePrint\printTemplates - authentification : \\SERVEUR_ARCOPOLE\partage\arcOpolePrint\PrintAuth.xml II.3.4 Configuration.xml Dans le fichier configuration.xml : 1. remplacer le pattern de filtre /arcgisjobs par /arcgisjobsarcopole : <urlfilter startwith="/arcgisjobsarcopole" handlerclass="com.esrifrance.restfmksrv.handlers.securedownload.sd"> <handler-configuration root_folder="${agsjobs}" > </handler-configuration> </urlfilter> 2. puis configurer l emplacement des modèles de rapports : <!-- Rapports--> <urlfilter startwith="/report" handlerclass="com.esrifrance.restfmksrv.handlers.arcopole.report.reporthandler"> <handler-configuration> <engines> <engine name="jasper" alias="ireport" ModelXmlPath=""\\SERVEUR_ARCOPOLE\partage\rapports\jasper\models.xml" geoprocessingurl="${orionhost}/arcgis/rest/services/arcopole/rapports/gpser ver/jasper" tmppath="${agsinput}" /> <engine name="xslt" alias="xslt" modelxmlpath=": "\\SERVEUR_ARCOPOLE\partage\rapports\xslt\models.xml" geoprocessingurl="${orionhost}/arcgis/rest/services/arcopole/rapports/gpser ver/xslt" tmppath="${agsinput}" /> </engines> </handler-configuration> </urlfilter> 02/12/2013 Version doc. : Page 8 sur 11

9 3. puis l emplacement des répertoires arcgisjobs et arcgisinput : <var name="agsjobs" value=" \\SERVEUR_ARCOPOLE\partage\arcgisjobs" /> <var name="agsinput" value=" \\SERVEUR_ARCOPOLE\partage\arcgisinput" /> Si vous utilisez ArCGIS Server 10.0 il faut également définir où se trouve le répertoire contenant les gabarits d impression et le fichier PrintAuth.xml : <!-- impression MXD --> <var <var name="printauthpath" value="\\serveur_arcopole\partage\arcopoleprint\printauth.xml"/> name="printtemplatefolder" value="\\serveur_arcopole\partage\arcopoleprint\printtemplates"/> 02/12/2013 Version doc. : Page 9 sur 11

10 III EXEMPLE D ARCHITECTURE HTTPS III.1 PRESENTATION Dans le schéma ci-dessus, arcopole Studio est installé sur une machine en DMZ tandis qu ArcGIS Server se trouve sur une machine du LAN. Cette dernière porte le nom de SERVEUR_SIG sur le domaine tandis que la machine de DMZ, qu on appellera SERVEUR_A, est accessible en HTTP à l adresse ou en HTTPS à l adresse ArcGIS Server répond sur le port 6080 et Tomcat a été installé sur le port Apache est utilisé comme reverse proxy et écoute sur les ports 80 (HTTP) et 443 (HTTPS) les requêtes puis les redirigent sur le port 8080 de Tomcat en HTTP. L utilisateur arcgis est le gestionnaire d ArcGIS Server et le compte a été créé comme un compte local à la machine au moment de l installation d ArcGIS Server. Cet utilisateur peut donc se connecter à ArcGIS Server Manager en utilisant son couple login / mot de passe suivant : arcgis / arcgis_password. 02/12/2013 Version doc. : Page 10 sur 11

11 Dans ce contexte, les différentes variables à utiliser pendant l installation sont les suivantes : AGS_SERVER_VERSION = 10.1 ou 10.2 WEB_SERVER_HOST : sig.macollectivite.org WEB_SERVER_PROTOCOL : https WEBAPP_NAME : studio AGS_HOST : SERVEUR_SIG AGS_WEBAPI_HOSTS : SERVEUR_SIG:6080 AGS_USER : arcgis AGS_PWD : arcgis_password AGS_DOMAIN : SERVEUR_SIG AGS_INPUT_10_1: \\SERVEUR_ARCOPOLE\partage\arcgisinput (cf. III.2) AGS_JOBS_10_1 : \\SERVEUR_ARCOPOLE\partage\arcgisjobs (cf. III.2) Exemple de configuration Pour la configuration des fonctionnalités de rapports et d impression, se référer au paragraphe II.3. III.2 PATCH Afin de pouvoir utiliser cette configuration il est nécessaire d installer un patch. La procédure à suivre est la suivante : - dé-zipper Patch-HTTPS.zip dans /studio - redémarrer Tomcat Si par la suite, le protocole HTTPS est désactivé dans Apache, il faut redéfinir les urls d accès au studio avec le protocole http et le port correspondant ; et aussi désinstaller ce patch (supprimer le contenu du répertoire studio/web-inf/classes) 02/12/2013 Version doc. : Page 11 sur 11