arcOpole Studio · arcOpole Studio – Annexe 7 – Architectures 02/12/2013 Version doc. : 1.0.0.0 Page 5 sur 11 II.2 ARCGIS SERVER ET ARCOPOLE STUDIO SUR DEUX SERVEURS DIFFERENTS

Site du programme arcOpole : www.arcopole.fr Auteur du document : Esri France Version de la documentation : 1.0.0.0 Date de dernière mise à jour : 02/12/2013

4

arcOpole Studio

Annexe 7

Architectures

arcOpole Studio – Annexe 7 – Architectures

02/12/2013 Version doc. : 1.0.0.0 Page 2 sur 11

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 ......................................................................... 10

III.1 Présentation ................................................................................................................................... 10

III.2 Patch ............................................................................................................................................... 11



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.



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 10.2.1 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 http://sig.macollectivite.org.

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 10.1+ : 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  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 10.0

http://sig.macollectivite.org/



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 http://sig.macollectivite.org.

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 10.1+ : 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+).

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 10.1+




Dans ce contexte, les différentes variables à utiliser pendant l’installation sont les suivantes :

AGS_SERVER_VERSION = 10.0





AGS_WEBAPI_HOSTS : SERVEUR_SIG 

AGS_USER : User_SIG

AGS_PWD : Password_SIG


AGS_INPUT_10= \\SERVEUR_DMZ\partage\arcgisserver\arcgisinput

AGS_JOBS_10= \\SERVEUR_DMZ\partage\arcgisserver\arcgisjobs

AGS_JOBS_10= C:/arcgisserver/arcgisjobs

Exemple de configuration en 10.0







AGS_USER : arcgis



AGS_INPUT_10_1: \\SERVEUR_DMZ\partage\arcgisserver\arcgisinput

AGS_JOBS_10_1 : \\SERVEUR_DMZ\partage\arcgisserver\arcgisjobs

Exemple de configuration en 10.1+



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 soit un disque réseau sur les deux machines o 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



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 :

2. puis configurer l’emplacement des modèles de rapports :

<urlfilter startwith="/arcgisjobsarcopole" handler-class="com.esrifrance.restfmksrv.handlers.securedownload.SD">

<handler-configuration root_folder="${AgsJobs}" >

</handler-configuration>

</urlfilter>



<urlfilter startwith="/report" handler-class="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/GPServer/jasper"

tmpPath="${AgsInput}" />

<engine name="xslt"

alias="Xslt"

modelXmlPath=": "\\SERVEUR_ARCOPOLE\partage\rapports\xslt\models.xml"

geoprocessingURL="${orionHost}/arcgis/rest/services/arcopole/Rapports/GPServer/xslt"

tmpPath="${AgsInput}" />

</engines>

</handler-configuration>

</urlfilter>



3. puis l’emplacement des répertoires arcgisjobs et 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 :

<var name="AgsJobs" value=" \\SERVEUR_ARCOPOLE\partage\arcgisjobs" />

<var name="AgsInput" value=" \\SERVEUR_ARCOPOLE\partage\arcgisinput" />



<var

name="PrintAuthPath"

value="\\SERVEUR_ARCOPOLE\partage\arcOpolePrint\PrintAuth.xml"/>

<var

name="PrintTemplateFolder" value="\\SERVEUR_ARCOPOLE\partage\arcOpolePrint\printTemplates"/>



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 http://sig.macollectivite.org ou en HTTPS à l’adresse https://sig.macollectivite.org.

ArcGIS Server répond sur le port 6080 et Tomcat a été installé sur le port 8080. 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.


https://sig.macollectivite.org/



Dans ce contexte, les différentes variables à utiliser pendant l’installation sont les suivantes :

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)


WEB_SERVER_HOST : sig.macollectivite.org

WEB_SERVER_PROTOCOL : https




AGS_USER : arcgis



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

Documents

arcOpole Studio · arcOpole Studio – Annexe 7 – Architectures 02/12/2013 Version doc. : 1.0.0.0 Page 5 sur 11 II.2 ARCGIS SERVER ET ARCOPOLE STUDIO SUR DEUX SERVEURS DIFFERENTS