Installer ArcGIS Web Adaptor

ArcGIS Web Adaptor peut être installé via le programme d’installation fourni (en l’exécutant via l’utilitaire Setup.exe) ou en mode silencieux en utilisant les paramètres de ligne de commande Windows Installer.

ArcGIS Web Adaptor peut être installé via le programme d’installation fourni (en l’exécutant via l’utilitaire Setup.sh) ou en mode silencieux en utilisant les paramètres de ligne de commande.

Conditions à remplir pour l’installation

La version d’ArcGIS Web Adaptor doit correspondre à celle de votre site de serveur ou de votre portail.
Il est possible d’installer ArcGIS Web Adaptor parallèlement à d’autres versions. Il n’est pas nécessaire de désinstaller ArcGIS Web Adaptor, sauf si vous procédez à une mise à niveau vers une version plus récente.
Chaque instance ArcGIS Web Adaptor doit avoir un nom unique. Deux instances Web Adaptor du même nom ne peuvent pas coexister sur le même serveur Web. En présence d’un conflit d’attribution de nom pendant l’installation, un message d’avertissement apparaît. Vous devez désinstaller la version antérieure du même nom afin de résoudre le conflit. Vous pouvez également modifier le nom d’un des adaptateurs Web pour poursuivre l’installation.
Il n’est pas nécessaire d’installer ArcGIS Web Adaptor et Tomcat sur la même machine si vous pensez configurer Web Adaptor avec un site de serveur ou un portail via votre navigateur. Toutefois, si vous pensez configurer Web Adaptor à l’aide de l’outil configurewebadaptor.exe, Web Adaptor et Tomcat doivent être installés sur la même machine.

Remarque :

Veillez à démarrer Tomcat, ou tout serveur d’application sur lequel déployer une instance ArcGIS Web Adaptor, avec des autorisations d’administration. Si ce n’est pas le cas, l’opération d’inscription d’ArcGIS Web Adaptor auprès d’ArcGIS Server échouera.

Il n’est pas nécessaire d’installer ArcGIS Web Adaptor et Tomcat sur la même machine si vous pensez configurer Web Adaptor avec un site de serveur ou un portail via votre navigateur. Toutefois, si vous pensez configurer Web Adaptor à l’aide de l’outil configurewebadaptor.sh, Web Adaptor et Tomcat doivent être installés sur la même machine.

Remarque :

Veillez à démarrer Tomcat, ou tout serveur d’application sur lequel déployer une instance ArcGIS Web Adaptor, avec des autorisations d’administration. Si ce n’est pas le cas, l’opération d’inscription d’ArcGIS Web Adaptor auprès d’ArcGIS Server échouera.
Lors du déploiement d’ArcGIS Web Adaptor sur un serveur d’applications, la configuration de Web Adaptor est écrite dans le répertoire d’accueil de l’utilisateur. Vérifiez qu’un répertoire d’accueil est attribué à l’utilisateur et que ce dernier peut y accéder en lecture et en écriture avant de continuer.

Avant d’installer ArcGIS Web Adaptor

Avant d’installer ArcGIS Web Adaptor, effectuez les actions suivantes :

Vérifiez que votre système respecte la configuration requise. Vous pouvez uniquement configurer un adaptateur Web avec un site de serveur ou un portail.
Activez IIS et les composants requis.

Attention :

Pour installer et configurer correctement ArcGIS Web Adaptor, vous devez activer IIS et les composants requis avant d’installer les composants prérequis spécifiés à l’étape suivante.
Assurez-vous que les composants prérequis suivants sont installés sur la machine où ArcGIS Web Adaptor sera installé.
- Microsoft Web Deploy 4.0
- ASP.NET Core Runtime - Windows Hosting Bundle 10.x
Remarque :

Vous devez installer ASP.NET Core Runtime - Windows Hosting Bundle, qui inclut une prise en charge de .NET Runtime et IIS.

Attention :

Si vous avez installé ASP.NET Core Runtime - Windows Hosting Bundle avant d’activer IIS et les composants requis, vous devez réparer l’installation du lot à l’aide du programme d’installation du lot.
Connectez-vous à la machine sur laquelle vous installez ArcGIS Web Adaptor.

Remarque :

Vous devez vous connecter en tant qu’utilisateur disposant de privilèges d’administration.
Vérifiez que votre site Web s’exécute sur le port 80 et que le protocole HTTPS est activé sur le port 443. Cela permet de gérer les divers appels chiffrés et non chiffrés passés à ArcGIS Enterprise. Pour savoir comment créer un site Web, reportez-vous à la documentation produit IIS. Pour plus d’informations sur la configuration et l’utilisation du protocole HTTPS, reportez-vous à la rubrique Activer HTTPS sur votre serveur Web.

Remarque :

L’utilisation du port HTTPS 443 par défaut convient à la grande majorité des utilisateurs. Dans de rares cas, il arrive qu’une instance d’ArcGIS Web Adaptor ne puisse pas utiliser le port 443 sur son serveur Web pour des raisons propres à l’organisation. Si votre organisation se trouve dans ce cas, consultez la rubrique Utiliser d’autres ports que ceux par défaut pour l’instance ArcGIS Web Adaptor du portail, qui décrit les étapes supplémentaires permettant de configurer une solution de remplacement.
Fermez toutes les applications.
Accédez au dossier téléchargé contenant le programme d’installation d’ArcGIS Web Adaptor. Vous pouvez également insérer le support d’ArcGIS Server ou de Portal for ArcGIS dans le lecteur approprié pour lancer automatiquement le programme d’installation.

Vous êtes maintenant prêt à installer ArcGIS Web Adaptor.

Attention :

Il est impossible de configurer ArcGIS Web Adaptor de manière à ce que l’URL comprenne des niveaux supplémentaires, et cette opération peut perturber les applications clientes.

Vérifiez que votre système respecte la configuration requise. Vous pouvez uniquement configurer un adaptateur Web avec un site de serveur ou un portail.
Connectez-vous à la machine sur laquelle vous installez ArcGIS Web Adaptor.

Remarque :

Vous devez vous connecter en tant qu’utilisateur disposant de privilèges d’administration.
Vérifiez que votre site Web s’exécute sur le port 80 et que le protocole HTTPS est activé sur le port 443. Cela permet de gérer les divers appels chiffrés et non chiffrés passés à ArcGIS Enterprise. Pour savoir comment créer un site Web, consultez la documentation produit spécifique à votre serveur d’applications Java. Pour plus d’informations sur la configuration et l’utilisation du protocole HTTPS, reportez-vous à la rubrique Activer HTTPS sur votre serveur Web.

Remarque :

L’utilisation du port HTTPS 443 par défaut convient à la grande majorité des utilisateurs. Dans de rares cas, il arrive qu’une instance d’ArcGIS Web Adaptor ne puisse pas utiliser le port 443 sur son serveur Web pour des raisons propres à l’organisation. Si votre organisation se trouve dans ce cas, consultez la rubrique Utiliser d’autres ports que ceux par défaut pour l’instance ArcGIS Web Adaptor du portail, qui décrit les étapes supplémentaires permettant de configurer une solution de remplacement.
Fermez toutes les applications.
Accédez au dossier téléchargé contenant le programme d’installation d’ArcGIS Web Adaptor. Vous pouvez également insérer le support d’ArcGIS Server ou de Portal for ArcGIS dans le lecteur approprié pour lancer automatiquement le programme d’installation.

Vous êtes maintenant prêt à installer ArcGIS Web Adaptor.

Vérifiez que votre système respecte la configuration requise. Vous pouvez uniquement configurer un adaptateur Web avec un site de serveur ou un portail.
Connectez-vous à la machine sur laquelle vous installez ArcGIS Web Adaptor.

Remarque :

Vous devez vous connecter en tant qu’utilisateur disposant de privilèges d’administration.
Vérifiez que votre site Web s’exécute sur le port 80 et que le protocole HTTPS est activé sur le port 443. Cela permet de gérer les divers appels chiffrés et non chiffrés passés à ArcGIS Enterprise. Pour savoir comment créer un site Web, consultez la documentation produit spécifique à votre serveur d’applications Java. Pour plus d’informations sur la configuration et l’utilisation du protocole HTTPS, reportez-vous à la rubrique Activer HTTPS sur votre serveur Web.

Remarque :

L’utilisation du port HTTPS 443 par défaut convient à la grande majorité des utilisateurs. Dans de rares cas, il arrive qu’une instance d’ArcGIS Web Adaptor ne puisse pas utiliser le port 443 sur son serveur Web pour des raisons propres à l’organisation. Si votre organisation se trouve dans ce cas, consultez la rubrique Utiliser d’autres ports que ceux par défaut pour l’instance ArcGIS Web Adaptor du portail, qui décrit les étapes supplémentaires permettant de configurer une solution de remplacement.
Accédez au dossier téléchargé contenant le programme d’installation d’ArcGIS Web Adaptor. Vous pouvez également insérer le support d’ArcGIS Server ou de Portal for ArcGIS dans le lecteur approprié pour lancer automatiquement le programme d’installation.

Vous êtes maintenant prêt à installer ArcGIS Web Adaptor.

Installer ArcGIS Web Adaptor via le programme d’installation

Pour installer ArcGIS Web Adaptor à l’aide du programme d’installation, procédez comme suit :

Le programme d’installation d’ArcGIS Web Adaptor doit démarrer automatiquement une fois le téléchargement terminé. Si le programme d’installation ne démarre pas automatiquement, accédez au dossier dans lequel vous avez téléchargé les fichiers d’installation et double-cliquez sur Setup.exe.
Lisez le contrat principal et acceptez-le si vous êtes d’accord. Cliquez sur Suivant pour poursuivre l’installation.
Choisissez un site Web s’exécutant sur le port 80 pour ArcGIS Web Adaptor. Les sites Web disponibles sont répertoriés sous la forme <nom du site Web (port)>. Si la boîte de dialogue Select website (Sélectionner un site Web) ne s’affiche pas, cela signifie que vous disposez d’un seul site Web. Si un seul site Web est trouvé sur votre machine, ArcGIS Web Adaptor est automatiquement placé dessus sans que la boîte de dialogue Select website (Sélectionner un site Web) ne s’affiche.
Attribuez un nom à l’instance Web Adaptor. La valeur par défaut est arcgis. Le nom de l’instance ne doit pas comporter d’espace.

Remarque :

Un message s’affiche si un répertoire virtuel portant le même nom que l’instance Web Adaptor existe déjà sur le site Web sélectionné. Cliquez sur OK pour fermer le message et donnez un autre nom à l’adaptateur Web.
Pour terminer l’installation, suivez les instructions à l’écran.

Remarque :

Chaque installation de Web Adaptor crée un pool d’applications avec la convention d’appellation par défaut ArcGISWebAdaptorAppPool<web adaptor name>.

Lancez le programme d’installation d’ArcGIS Web Adaptor, Setup.exe, puis prenez connaissance du contenu de l’écran de bienvenue et des conditions d’utilisation. Cliquez sur Suivant lorsque vous êtes prêt à poursuivre.
Lisez le contrat principal et acceptez-le si vous êtes d’accord. Cliquez sur Suivant pour poursuivre l’installation.
Cliquez sur Modifier pour spécifier le dossier d’installation ou sur Suivant pour accepter l’emplacement par défaut.
Cliquez sur Installer pour commencer l’installation.
Cliquez sur Terminer pour fermer l’assistant.
Accédez au dossier d’installation d’ArcGIS Web Adaptor. Déployez le fichier arcgis.war sur votre serveur d’application Java, sur un site Web exécuté sur le port 80. Pour obtenir des instructions sur le déploiement d'un fichier .war, reportez-vous à la documentation du serveur d'applications Java.
Si vous souhaitez déployer plusieurs instances Web Adaptor sur l’ordinateur hôte, redéployez le fichier arcgis.war, le cas échéant. N’oubliez pas que si vous déployez plusieurs instances Web Adaptor sur le même site Web (port), vous devez utiliser des noms différents. Par exemple, deux Adaptateurs Web nommés arcgis ne peuvent pas coexister sur le même site Web. Si vous souhaitez disposer de plusieurs instances Web Adaptor portant le même nom, vous devez les installer sur des sites Web différents (ports).
Connectez ArcGIS Web Adaptor avec un site de serveur ou un portail.

Une fois installé, ArcGIS Web Adaptor s’affiche dans la langue spécifiée par votre serveur d’applications Java. Pour changer la langue, reportez-vous à la documentation produit de votre serveur d’applications Java.

Lancez le programme d’installation d’ArcGIS Web Adaptor, puis lisez les informations affichées dans la boîte de dialogue Introduction. Cliquez sur Suivant lorsque vous êtes prêt à poursuivre.
Lisez le contrat principal et acceptez-le si vous êtes d’accord. Cliquez sur Suivant pour poursuivre l’installation.
Cliquez sur Suivant pour accepter l’emplacement par défaut ou cliquez sur Choisir pour spécifier le dossier d’installation.

Remarque :

Il est recommandé de ne pas installer ArcGIS Web Adaptor sur un lecteur réseau distant. Si le lecteur distant n’est pas accessible au moment de la désinstallation, le processus risque d’échouer et de laisser des fichiers sur le disque.
Cliquez sur Installer pour commencer l’installation.
Lorsque vous avez terminé, cliquez sur Done (Terminé) pour fermer l’assistant.
Accédez au dossier d’installation d’ArcGIS Web Adaptor. Déployez le fichier arcgis.war sur votre serveur d’application Java, sur un site Web exécuté sur le port 80. Pour obtenir des instructions sur le déploiement d’un fichier .war, reportez-vous à la documentation du serveur d’applications Java.
Si vous souhaitez déployer plusieurs instances Web Adaptor sur l’ordinateur hôte, redéployez le fichier arcgis.war, le cas échéant. N’oubliez pas que si vous déployez plusieurs instances Web Adaptor sur le même site Web (port), vous devez utiliser des noms différents. Par exemple, deux Adaptateurs Web nommés arcgis ne peuvent pas coexister sur le même site Web. Si vous souhaitez disposer de plusieurs instances Web Adaptor portant le même nom, vous devez les installer sur des sites Web différents (ports).
Connectez ArcGIS Web Adaptor avec un site de serveur ou un portail.

Répétez les mêmes étapes pour installer plusieurs instances ArcGIS Web Adaptor sur la même machine simultanément ou sur plusieurs machines. Pour installer plusieurs instances de Web Adaptor sur le même site Web (port), vous devez utiliser des noms différents. Par exemple, deux Adaptateurs Web nommés arcgis ne peuvent pas coexister sur le même site Web. Si vous souhaitez disposer de plusieurs instances Web Adaptor portant le même nom, vous devez les installer sur des sites Web différents (ports).

Remarque :

Le programme d’installation détecte et prévient tout conflit avec le nom de l’instance Web Adaptor. Si un message s’affiche indiquant que le répertoire virtuel existe déjà, spécifiez un nom différent pour l’adaptateur Web ou sélectionnez un site Web différent.

Remarque :

Pour appliquer un Service Pack Web Adaptor, l’instance de base ne peut pas être supprimée.

Installer ArcGIS Web Adaptor en mode silencieux

Les lignes de commande suivantes sont des paramètres à utiliser lors de l’installation d’ArcGIS Web Adaptor en mode silencieux. Si ces paramètres de ligne de commande ne sont pas appelés lors d’une installation en mode silencieux, l’application Web ArcGIS Web Adaptor est créée sous le site Web par défaut avec le nom arcgis par défaut.

ACCEPTEULA=yes

Cette propriété est requise pour accepter le contrat de licence d’utilisateur final pendant une installation en mode silencieux. Spécifiez yes pour accepter le CLUF et installer le logiciel. Le fait de spécifier no (non) ou d’omettre cette propriété entraînera l’échec de l’installation. Le téléchargement contient une version PDF du contrat de licence d’utilisateur final (CLUF). Le fichier EULA.pdf se trouve dans le dossier \Documentation.
WEBSITE_ID=<valeur numérique du site Web>

Le paramètre WEBSITE_ID permet de spécifier le site Web où l’application Web ArcGIS Web Adaptor sera créée. La valeur de WEBSITE_ID est un nombre spécifique attribué par IIS à chaque site Web sur votre serveur. Les identifiants pour les sites Web sur votre serveur se trouvent dans le gestionnaire de services Internet (IIS). Le site Web par défaut possède un identifiant de site Web égal à 1. Par défaut, le paramètre WEBSITE_ID est défini sur le site Web par défaut (même si plusieurs sites Web existent). Le paramètre WEBSITE_ID respecte la casse.
PORT=<numéro de port>

En outre, si votre site Web dispose de plusieurs ports, utilisez le paramètre PORT pour effectuer l'installation sur le port spécifié WEBSITE_ID.

Par exemple, le chemin est le suivant : <path to ArcGIS Web Adaptor (IIS) setup download>\setup.exe /qb VDIRNAME=arcgis_external WEBSITE_ID=4059640 PORT=82.
VDIRNAME=<nom d'ArcGIS Web Adaptor>

Ce paramètre de ligne de commande est facultatif. Par défaut, la propriété VDIRNAME est définie sur arcgis. Si vous n’activez pas le paramètre VDIRNAME dans votre ligne de commande, l’instance Web Adaptor est créée en tant qu’arcgis. Le paramètre VDIRNAME respecte la casse. Le nom du Web Adaptor ne doit pas comporter d’espace.

Par exemple, le chemin est le suivant : <path to ArcGIS Web Adaptor (IIS) setup download>\setup.exe /qb ACCEPTEULA=yes VDIRNAME=arcgis_external WEBSITE_ID=4059640.
CONFIGUREIIS=TRUE

Ce paramètre facultatif permet au programme d’installation d’effectuer l’installation et la configuration en mode silencieux de tous les composants Microsoft IIS manquants requis par ArcGIS Web Adaptor.

Les paramètres suivants sont les paramètres de ligne de commande de Windows Installer à utiliser lors de l’installation d’ArcGIS Web Adaptor en mode silencieux.

ACCEPTEULA=yes

Cette propriété est requise pour accepter le contrat de licence d’utilisateur final pendant une installation en mode silencieux. Spécifiez yes pour accepter le CLUF et installer le logiciel. Le fait de spécifier no (non) ou d’omettre cette propriété entraînera l’échec de l’installation. Le téléchargement contient une version PDF du contrat de licence d’utilisateur final (CLUF). Le fichier EULA.pdf se trouve dans le dossier \Documentation.
INSTALLDIR=<emplacement d’installation>

Cette propriété vous permet de spécifier l’emplacement d’installation d’ArcGIS Web Adaptor à partir de la ligne de commande. Si vous ne définissez pas cette propriété, l’emplacement d’installation par défaut C:\Program Files\ArcGIS\WebAdaptor12.0\java\ est utilisé.

Par exemple :

<path to ArcGIS Web Adaptor (Java Platform) setup download>\setup.exe ACCEPTEULA=yes INSTALLDIR="C:\NewInstallDir" /qb
Utilisez la commande suivante pour installer ArcGIS Web Adaptor en mode silencieux sans spécifier l’emplacement d’installation :

<path to ArcGIS Web Adaptor (Java Platform) setup download>\setup.exe ACCEPTEULA=yes /qb

Après l’installation d’ArcGIS Web Adaptor, vous pouvez le configurer via un site de serveur ou un portail.

Remarque :

Pour installer ArcGIS Web Adaptor en mode silencieux, procédez comme suit :

Avant de commencer l’installation, lisez le contrat principal disponible sous <CD_ROOT or untar directory>/Documentation/EULA.pdf et, si vous êtes d’accord, acceptez-en les termes.
Exécutez le fichier d’installation en mode silencieux à l’invite. Exemple de syntaxe :

<CD_ROOT or untar directory>/Setup -m silent -l yes

Utilisation : Setup [Options]

Option	Description
-m; --mode MODE	Facultatif. Prend par défaut la valeur GUI. MODE peut prendre les valeurs silent ou gui.
-l; --license-agreement CHOICE	Obligatoire pour le mode silencieux. CHOICE peut prendre la valeur Yes ou No. Yes indique que vous avez lu et accepté le contrat principal Esri (E204, E300). Rendez-vous sur https://www.esri.com/legal/licensing-translations pour prendre connaissance du contrat.
-d; --directory DIRECTORY	Facultatif. Par défaut, ArcGIS Web Adaptor est installé dans votre répertoire $HOME. DIRECTORY spécifie un répertoire d’installation différent. Le chemin /arcgis/webadaptor12.0/ est ajouté au répertoire d’installation. Le nom du répertoire d’installation doit être en lettres minuscules. Pour les exemples et les données installés, le chemin d’accès aux données doit être indiqué en lettres minuscules. Il est recommandé de ne pas installer ArcGIS Web Adaptor sur un lecteur réseau distant. Si le lecteur distant n’est pas accessible au moment de la désinstallation, le processus risque d’échouer et de laisser des fichiers sur le disque.
-v; --verbose	Le programme d’installation est exécuté en mode Commentaires.
-h; --help	Affiche l’aide sur la ligne de commande et ferme l’outil.
-e; --examples	Affiche des exemples d’utilisation de ces options et quitte.

Accédez au dossier d’installation d’ArcGIS Web Adaptor et déployez le fichier .war approprié sur votre serveur d’application Java sur un site Web exécuté sur le port 80. Si vous utilisez Apache Tomcat 10.1.x, vous devez déployer le fichier arcgis_tomcat10.war. Pour Tomcat 9.0.x et tous les autres serveurs d’applications Java, vous devez déployer le fichier arcgis.war. Pour obtenir des instructions sur le déploiement d’un fichier .war, reportez-vous à la documentation du serveur d’applications Java.
Si vous souhaitez déployer plusieurs instances Web Adaptor sur l’ordinateur hôte, redéployez le fichier .war, le cas échéant. Si vous déployez plusieurs instances Web Adaptor sur le même site Web (port), vous devez utiliser des noms différents ; par exemple, deux instances Web Adaptor nommées arcgis ne peuvent pas coexister sur le même site Web. Si vous souhaitez disposer de plusieurs instances Web Adaptor portant le même nom, vous devez les installer sur des sites Web différents (ports).
Après l’installation d’ArcGIS Web Adaptor, vous pouvez le configurer via un site de serveur ou un portail.

Vous pouvez installer plusieurs adaptateurs web en exécutant le programme d’installation à l’aide des paramètres de ligne de commande. Aucun paramètre de ligne de commande supplémentaire n’est nécessaire pour installer plusieurs Adaptateurs Web.