Prise en main d’ArcGIS Enterprise Builder

Votre université lance un nouveau programme SIG visant à doter ses étudiants des compétences dont ils ont besoin pour la réalisation de tâches web d’analyse spatiale et de cartographie. L’université a choisi ArcGIS Enterprise comme cours d’introduction. En tant que formateur auprès des étudiants, votre tâche consiste à les aider à construire un déploiement de base ArcGIS Enterprise.

Ce didacticiel a été testé pour la dernière fois le 26 septembre 2024 avec ArcGIS Enterprise 11.3. Si vous utilisez une version différente de ArcGIS Enterprise, vous pouvez disposer de fonctionnalités et de résultats différents.

Prérequis

• Licence pour ArcGIS Enterprise Standard ou Advanced (avec les fichiers d’autorisation pour ArcGIS Server et Portal for ArcGIS)
• Ordinateur doté de la configuration système minimale requise (y compris un système d’exploitation 64 bits)
• Privilèges d’administrateur sur votre ordinateur
• Un ordinateur sur lequel est installé Microsoft Web Deploy 3.6 et versions ultérieures
• Un ordinateur sur lequel est installé ASP.NET Core Runtime - Windows Hosting Bundle 8.x

Installer ArcGIS Enterprise

ArcGIS Enterprise Builder installe les quatre composants logiciels de ArcGIS Enterprise sur votre machine.

Le premier composant, ArcGIS Server, met vos informations géographiques à la disposition des autres utilisateurs de votre organisation et, éventuellement, de toute autre personne disposant d’une connexion à Internet. Cette opération seffectue par le biais de services Web qui permettent à un serveur puissant de recevoir et de traiter des demandes dinformations envoyées par dautres périphériques. ArcGIS Enterprise Builder installe une instance de ArcGIS Server en tant que serveur d’hébergement.

Portal for ArcGIS partage des cartes, des scènes, des applications et d’autres informations géographiques avec les membres de votre organisation. La structure faisant face au public avec laquelle les utilisateurs du portail ArcGIS Enterprise interagissent est gérée par l’infrastructure principale de Portal for ArcGIS. L’administrateur du portail peut personnaliser le portail ArcGIS Enterprise pour l’adapter aux éléments de présentation propres à votre organisation.

ArcGIS Data Store configure le stockage des données du serveur d’hébergement utilisé avec le portail ArcGIS Enterprise. Il fournit une expérience pratique de configuration. ArcGIS Enterprise Builder installe un répertoire de données relationnel pour héberger les données de couches d’entités et un répertoire de données de cache de tuiles pour héberger les caches destinés à accélérer les couches de scènes.

ArcGIS Web Adaptor intègre ArcGIS Server et votre portail ArcGIS Enterprise à votre serveur Web existant. Il s’exécute sur votre site Web et transmet des requêtes à vos machines. ArcGIS Web Adaptor facilite l’authentification au niveau du Web ainsi que les stratégies de sécurité et permet de faire bénéficier les utilisateurs d’une authentification unique. ArcGIS Enterprise Builder installe un adaptateur avec votre serveur d’hébergement et un autre avec votre portail.

Obtenir le générateur et vos fichiers d’autorisation

Pour exécuter l’assistant ArcGIS Enterprise Builder, vous avez besoin de fournir deux fichiers d’autorisation : un pour ArcGIS Server et un autre pour Portal for ArcGIS. Vous pouvez vous les procurer sur le site web My Esri.

1. Consultez la documentation actuelle pour connaître la configuration requise concernant le système d’exploitation et le matériel.
2. Si nécessaire, téléchargez vos fichiers d’autorisation sur My Esri.

Installer ArcGIS Enterprise Builder

Vous disposez maintenant de tous les éléments nécessaires à l’installation et allez lancer l’assistant du générateur. Pour ouvrir l’assistant, vous allez vous connecter à votre machine en tant qu’utilisateur disposant de privilèges d’administration.

Remarque :

Avant de commencer, les prérequis suivants doivent être installés sur la machine où sera installé ArcGIS Web Adaptor (IIS) :

• Microsoft Web Deploy 3.6 et versions ultérieures
• ASP.NET Core Runtime - Windows Hosting Bundle 8.x

Pour plus d’informations sur ces fichiers requis, consultez la rubrique prérequis.

1. Le programme d’installation doit démarrer automatiquement une fois le téléchargement terminé. Si le programme d’installation ne démarre pas automatiquement, accédez à l’emplacement des fichiers d’installation téléchargés et double-cliquez sur Builder.exe. Si votre machine ne respecte pas la configuration système requise, le programme d’installation vous en informe.
2. Si nécessaire, cliquez sur Yes (Oui) pour permettre au générateur d’effectuer ces modifications sur votre appareil.

   La fenêtre ArcGIS Enterprise Builder apparaît. Ceci vous permet de configurer les composants Microsoft Internet Information Services (IIS) requis pour ArcGIS Enterprise. Les composants IIS vous permettent d’héberger un site Web depuis un serveur ou un ordinateur.

3. Dans la fenêtre ArcGIS Enterprise Builder, cliquez sur I Agree (J’accepte).

   

   L’installation des composants peut prendre plusieurs minutes.

   Remarque :

   Si vous n’avez pas installé les fichiers prérequis, il vous sera demandé de les installer. Une fois les fichiers requis installés, exécutez à nouveau Builder.exe.

   L’assistant ouvre la fenêtre Welcome to the ArcGIS Enterprise Builder (Bienvenue dans ArcGIS Enterprise Builder).

4. Cliquez sur Next (Suivant).

   

5. Lisez et acceptez le contrat principal. Cliquez sur Next (Suivant).
6. Spécifiez le dossier de destination pour installer les composants ArcGIS Enterprise de base.

   Remarque :

   L’emplacement que vous indiquez doit comporter au moins 30 Go d’espace disque disponible pour que vous puissiez continuer.

   L’emplacement par défaut est C:\Program Files\ArcGIS. Tous les composants de ArcGIS Enterprise seront installés dans des sous-répertoires situés à cet emplacement. Les styles Web Portal for ArcGIS et Portal for ArcGIS seront installés dans \ArcGIS\Portal, ArcGIS Server sera installé dans \ArcGIS\Server et ArcGIS Data Store sera installé dans \ArcGIS\DataStore.

   Les services de bases de données Portal for ArcGIS utilisent un répertoire pour stocker le contenu généré par l’utilisateur, ainsi que le contenu par défaut installé à l’origine. Le contenu reste sur la machine une fois ArcGIS Enterprise Builder désinstallé, ce qui permet aux installations de Portal for ArcGIS ultérieures d’utiliser le contenu existant. Un répertoire de contenu est également créé à cet emplacement racine (par exemple, C:\arcgis\arcgisportal).

   

   Si Python 2.7.18 ou Numerical Python 1.9.3 n’est pas installé sur votre machine, le programme les installe automatiquement à l’emplacement que vous avez spécifié sur le disque pour ArcGIS Enterprise Builder. L’emplacement d’installation est <destination folder>\Python27.

7. Cliquez sur Next (Suivant).
8. Spécifiez un nom de compte et un mot de passe pour exécuter ArcGIS Enterprise.

   Ce compte sera le propriétaire des différents processus et devant être employé par votre développement de base pour les fonctions, telles que l’accès aux emplacements du système d’exploitation. Le nom par défaut du compte est arcgis. Il peut être créé ou modifié de la façon suivante :

   • Le compte peut être un compte local ou un compte de domaine.
   • Le compte spécifié n'a pas besoin de faire partie du groupe des administrateurs.
   • Si vous utilisez un compte du système d’exploitation local, le compte est créé.
   • Si vous entrez un compte de domaine, il doit déjà exister dans le domaine et être saisi conformément au format suivant : mydomain\domainaccount.
   • La création d'un compte local pendant l'installation s'utilise avant tout pour accélérer l'installation de votre déploiement de base.
   • Le compte sera partagé sur tous les composants.
   • La stratégie de mot de passe pour ce compte est fonction de votre système d'exploitation et de la stratégie de sécurité de l'organisation. Si vous recevez un message d’erreur indiquant que le mot de passe fourni ne répond pas aux conditions requises définies pour votre machine en matière de longueur et de complexité, accédez à Local security policy (Stratégie de sécurité locale). Sélectionnez Security Settings (Paramètres de sécurité) et cliquez sur Account Policies (Stratégies de comptes) > Password Policy (Stratégie de mot de passe) pour les consulter.

9. Cliquez sur Next (Suivant).

   Vous allez à présent définir des noms pour les deux instances ArcGIS Web Adaptor qui sont installées dans le cadre du déploiement de base.

   Le programme d’installation de ArcGIS Enterprise crée une instance ArcGIS Web Adaptor (IIS) pour le serveur d’hébergement et le portail ArcGIS Enterprise.

10. Acceptez les noms par défaut des instances ArcGIS Web Adaptor ou spécifiez des noms différents. Cliquez sur Next (Suivant).

    

    L’installation de ArcGIS Enterprise Builder requiert un fichier d’autorisation valide (.ecp ou .prvc) pour ArcGIS Server Standard ou Advanced et un fichier de licence valide (.json) pour Portal for ArcGIS. Vous devez disposer de ces deux fichiers avant de procéder à l’installation.

11. Cliquez sur Browse (Parcourir). Accédez à votre fichier d’autorisation ArcGIS Server, puis sélectionnez-le. Cliquez sur Open (Ouvrir).

    

    Remarque :

    Pour plus d’informations, reportez-vous à la rubrique Obtenir un fichier d’autorisation.

    Une fois l’installation terminée, Portal for ArcGIS sera autorisé. Pendant l’exécution de l’assistant de configuration de ArcGIS Enterprise, vous allez fournir votre fichier de licence (.json) pour autoriser Portal for ArcGIS.

12. Cliquez sur Next (Suivant).
13. Cliquez sur Installer.

    

    Le temps nécessaire à l’installation peut être important.

    Pendant que ArcGIS Enterprise Builder crée votre déploiement, il consigne des messages DEBUG dans vos lecteurs locaux. Ces messages offrent davantage de détails lors de la résolution de problèmes de configuration. Du début du déploiement jusqu’à la création du site de serveur, les journaux sont générés dans le dossier <Install location>\Server\usr\logs. Une fois le site de serveur créé, les journaux existants sont déplacés et de nouveaux journaux sont générés dans le dossier <Content directory location>\arcgisserver\server\logs\server. Lorsque le déploiement réussit, le niveau de consignation est défini sur  WARNING.

    Remarque :

    Si des problèmes inattendus se produisent au cours de l’installation de ArcGIS Enterprise Builder, des fichiers journaux de l’installation sont automatiquement créés sous C:\ProgramData\ArcGISBuilder<VersionNumber> et peuvent être communiqués au support technique Esri.

14. Cliquez sur Finish (Terminer).

    

    Si tous les composants sont installés correctement, l’assistant de configuration s’ouvre automatiquement dans votre navigateur Web par défaut.

    Avant de configurer votre déploiement ArcGIS Enterprise dans votre navigateur, vous allez vérifier que l’environnement d’hébergement Web de votre ordinateur utilise le procole HTTPS.

Créer et lier un certificat de domaine dans IIS

Internet Information Services (IIS) est un serveur web hébergeant des sites web, des applications et des services. Pour procéder au déploiement sécurisé de ArcGIS Enterprise, vous aurez besoin d’IIS afin de configurer un serveur HTTPS sécurisé. Lors de l’utilisation du protocole HTTPS, les communications de données entrantes et sortantes sont cryptées, ce qui renforce leur protection.

Remarque :

ArcGIS Enterprise Builder active automatiquement les composants IIS requis.

Pour que les utilisateurs bénéficient d’un accès sécurisé à votre portail, vous devez avoir un certificat de domaine sur votre machine, lié au port HTTPS 443. Dans la plupart des cas, votre administrateur informatique vous fournit des certificats et les lie au port HTTPS 443. Si ce n’est pas le cas, vous devez créer et lier vos propres certificats. Pour cela, utilisez l’application Gestionnaire des services Internet sur votre ordinateur Windows.

1. Si nécessaire, dans le menu Start (Démarrer) de Windows, tapez IIS et ouvrez l’application Internet Information Services Manager (Gestionnaire des services Internet).
2. Si nécessaire, autorisez le programme à apporter des modifications à la machine.
3. Dans la fenêtre Connections (Connexions), cliquez sur le nom de votre machine serveur. Sous IIS, double-cliquez sur Server Certificates (Certificats de serveur).

   

4. Dans le volet Actions, cliquez sur Créer un certificat de domaine.

   

   La fenêtre Create Certificate (Créer un certificat) s’ouvre.

5. Dans Nom commun, saisissez le nom complet du domaine de la machine (tel que portail.domaine.com) et spécifiez les autres informations propres à votre organisation et emplacement.

   

6. Cliquez sur Next (Suivant).
7. Dans la boîte de dialogue Online Certification Authority (Autorité de certification en ligne), cliquez sur Select (Sélectionner) et choisissez l’autorité de certification dans votre entreprise qui doit signer le certificat, puis cliquez sur OK.

   Si l’autorité n’apparaît pas, consultez votre administrateur système.

8. Attribuez un nom convivial au certificat de domaine, puis cliquez sur Terminer.

   Vous allez ensuite lier le nouveau certificat à HTTPS.

9. Dans la fenêtre Connections (Connexions), cliquez sur le nom de votre machine. Développer les sites. Cliquez sur Default Web Site.

   

10. Dans la fenêtre Actions, cliquez sur Liaisons.

    

    La fenêtre Site Bindings (Liaisons des sites) s’affiche.

11. Dans la fenêtre Site Bindings (Liaisons des sites), dans la liste Bindings (Liaisons), cliquez sur Port 443 puis cliquez sur Edit (Modifier).
12. Si le port 443 n’apparaît pas dans la liste, cliquez sur Add (Ajouter). Dans la fenêtre Add Site Binding (Ajouter une liaison de site), depuis le menu Type, sélectionnez https. Vérifiez que le port est défini sur 443.

    

13. Dans la liste déroulante SSL certificate (Certificat SSL), sélectionnez le nom de votre certificat. Cliquez sur OK et sur Fermer.

    

    Une fois votre certificat lié, vous allez redémarrer votre site Web hébergeant ArcGIS Enterprise.

14. Dans la fenêtre Actions, sous Manage Website (Gérer le site Web), cliquez sur Restart (Redémarrer).

    

15. Fermez la fenêtre Internet Information Services (IIS) Manager [Gestionnaire des services Internet (IIS)].

    Vous êtes maintenant prêt à procéder à l’installation du déploiement de base ArcGIS Enterprise.

Vous avez téléchargé ArcGIS Enterprise à l’aide de ArcGIS Enterprise Builder et installé les quatre composants de ArcGIS Enterprise sur votre machine. Vous allez ensuite utiliser l’assistant de configuration pour terminer la configuration du déploiement de base de votre université.

Configurer un déploiement de base

Par le passé, vous avez utilisé ArcGIS Enterprise Builder pour installer le logiciel. Ensuite, vous allez ouvrir l’assistant de configuration qui permet de configurer votre déploiement de base. Cet assistant nécessite que le protocole HTTPS soit activé sur l’ordinateur.

Utiliser l'assistant de configuration

Après avoir installé le logiciel avec ArcGIS Enterprise Builder, vous allez procéder au déploiement de base à l’aide de l’assistant.

1. Si besoin, dans votre navigateur Web, accédez à l’URL de l'assistant de configuration (http://mymachine.mydomain.com:6080/arcgis/enterprise or https://localhost:6443/arcgis/enterprise).

   Remarque :

   Vous pouvez également rechercher l’assistant de configuration de ArcGIS Enterprise sur votre machine et l’ouvrir à l’aide du raccourci.

   Une page d’accueil indique que l’assistant doit utiliser une connexion sécurisée.

2. Cliquez sur Next (Suivant).

   

   Vous êtes redirigé vers le port sécurisé 6443. Votre navigateur affiche un avertissement de sécurité ; ceci est normal la première fois que vous accédez à l’assistant de sécurité.

3. Passez l’avertissement (cela varie selon le navigateur). Par exemple, dans Chrome, cliquez sur Advanced (Avancé) puis sur Continue to localhost (Continuer vers l’hôte local).
4. Dans le volet License File (Fichier de licence), cliquez sur Choose File (Choisir un fichier) puis accédez au fichier .json de licence de votre portail et sélectionnez-le. Cliquez sur Open (Ouvrir).

   

   Ce fichier .json contient le type d’utilisateur, l’application et la licence de groupe d’applications de votre portail et s’obtient via My Esri.

5. Cliquez sur Next (Suivant).

   

   Vous allez ensuite configurer le compte administrateur de votre organisation. Ceci comprend le nom d’utilisateur, le mot de passe et le type d’utilisateur. Ce compte permet de vous connecter à votre déploiement ArcGIS Enterprise pour la première fois et pour les tâches d’administration initiales, telles que la création de comptes supplémentaires. Ce compte s’applique aux composants ArcGIS Server et Portal.

6. Dans la fenêtre Initial Administrator Account (Compte d’administrateur initial), spécifiez les informations de connexion du compte de l’administrateur initial. Sélectionnez un type d’utilisateur dans la liste déroulante, qui répertorie les types d’utilisateurs compatibles avec le compte d’administrateur initial qui sont inclus dans le fichier de licence.

   

7. Cliquez sur Next (Suivant).
8. Dans la fenêtre Additional Account Information (Informations de compte supplémentaires), saisissez les informations de votre compte.

   

9. Cliquez sur Next (Suivant).
10. Dans la fenêtre Root Content Directory (Répertoire du contenu racine), indiquez l’emplacement du répertoire de contenu dans lequel stocker les journaux et les fichiers de configuration. Votre déploiement est amené à croître. Vous devriez donc indiquer un emplacement de répertoire disposant d’au moins 10 Go d’espace libre pour commencer.

    Remarque :

    L’emplacement par défaut est c:\arcgis. Des répertoires système supplémentaires seront créés hors du répertoire du contenu racine spécifié.

11. Cliquez sur Next (Suivant).
12. Dans la fenêtre Configuration Summary (Récapitulatif de configuration), vérifiez le compte d’administrateur initial et l’emplacement du répertoire de contenu. Cliquez sur Terminer.

    

    Lorsque la configuration commence, la fenêtre Configuration Deployment (Déploiement de configuration) s’ouvre. Une série d’étapes de configuration apparaît, accompagnées d’un indicateur de progression montrant une coche verte au terme de chaque étape. Cette opération peut prendre plusieurs minutes.

    

    Remarque :

    Si vous obtenez un message d’erreur indiquant que la création du site ArcGIS Server a échoué, consultez les fichiers journaux situés dans le dossier C:\<ArcGIS Server installation directory>\ArcGIS\Server\usr\logs pour en savoir plus.

    Si un message d’erreur s’affiche à l’étape Data Stores registered with GIS Server site (Data stores enregistrés auprès du site GIS Server), réinstallez les installateurs Microsoft Web Deploy et ASP.NET Core Runtime - Windows Hosting Bundle. Pour chacun d’eux, choisissez l’option Repair (Réparer). Puis, redémarrez votre site Web dans IIS.

    Une fois les composants configurés, la fenêtre ArcGIS Enterprise Configuration Status (État de la configuration ArcGIS Enterprise) s’affiche, indiquant que tous les composants ont été correctement configurés.

    

    Au terme de l’assistant de configuration, vous disposez des éléments suivants :

    • Un portail ArcGIS Enterprise et un site ArcGIS Server configurés avec le même compte de l’administrateur initial.
    • Un site ArcGIS Server doté d’une licence de serveur SIG. Le site GIS Server est fédéré avec le portail et défini comme serveur d’hébergement du Portal.
    • Des répertoires de données relationnels et du cache de tuiles inscrits auprès du site ArcGIS Server.
    • Une instance Web Adaptor nommée portal (portail) pour le Portal.
    • Une instance Web Adaptor nommée server (serveur) pour le site ArcGIS Server. Un accès administratif au site ArcGIS Server via l’instance Web Adaptor a été activé. Vous pouvez afficher le statut de votre serveur et de ses services en accédant au gestionnaire ArcGIS Server, à l’aide de l’URL au format suivant : https://gisserver.domain.com:6443/arcgis/manager/.

    Pour configurer le Portal, cliquez sur l’hyperlien en regard du Portal Website (Site Web du portail).

Dans ce didacticiel, vous avez utilisé ArcGIS Enterprise Builder pour installer et configurer les quatre composants de ArcGIS Enterprise. Pour commencer à utiliser ArcGIS Enterprise, essayez l’un des didacticiels suivants :

• Configurer un portail ArcGIS Enterprise
• Créer une carte stratégique pour gérer les problèmes de santé

Vous trouverez d’autres didacticiels dans la bibliothèque des didacticiels.

Crédits

• Les images de bannière et de carte proviennent de dawnydawny sur Pixabay.