Skip To Content

Configuration de ArcGIS Enterprise Builder après l’installation

Une fois que ArcGIS Enterprise Builder a installé le logiciel, un navigateur s’ouvre et présente l’assistant de configuration de ArcGIS Enterprise. Vous pouvez utiliser l’assistant de configuration pour déployer ArcGIS Enterprise, ou fermer le navigateur et utiliser l’utilitaire de ligne de commande configurebasedeployment pour achever le déploiement de base.

Si vous n’avez pas encore installé le logiciel avec ArcGIS Enterprise Builder, reportez-vous à la rubrique Installation avec ArcGIS Enterprise Builder pour savoir comment procéder.

Remarque :

Les configurations ArcGIS Enterprise nécessitent l’activation du protocole HTTPS sur la machine sur laquelle le déploiement de base est installé. Avant de procéder à la configuration, vous devez créer un certificat de domaine et activer HTTPS.

Utiliser l'assistant de configuration

Après avoir installé le logiciel avec ArcGIS Enterprise Builder, procédez comme suit avec l’assistant de configuration pour réaliser votre déploiement de base :

  1. S’il n’est pas encore ouvert, accédez à l’URL de l’assistant de configuration (http://mymachine.mydomain.com:6080/arcgis/enterprise). Vous pouvez également rechercher l’assistant de configuration de ArcGIS Enterprise sur votre machine et le lancer à l’aide du raccourci.
  2. Sur la page d’accueil qui apparaît, avec un message expliquant que l’assistant doit utiliser une connexion sécurisée, 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é. Passez l’avertissement (cela varie selon le navigateur).
  3. Dans le volet License File (Fichier de licence), accédez au fichier de licence de votre portail (.json). Ce fichier contient le type d’utilisateur du portail et les informations de licence de l’application. Ce fichier est disponible dans My Esri. Cliquez sur Next (Suivant).

  4. Dans le volet Compte d’administrateur initial, entrez les informations d'identification du compte de l'administrateur initial. Sélectionnez un type d’utilisateur dans le menu déroulant, qui répertorie les types d’utilisateur compatibles avec le compte d’administrateur initial qui sont inclus dans votre fichier de licence. 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 de serveur et de portail. Cliquez sur Next (Suivant).
  5. Dans le volet Informations de compte supplémentaires, entrez les informations du compte de l'administrateur initial supplémentaires et cliquez sur Suivant.
  6. Dans le volet Répertoire du contenu racine, spécifiez l'emplacement dans lequel le répertoire de contenu doit stocker les journaux et 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. L’emplacement par défaut est /home/linux/arcgis.

    Remarque :

    Des répertoires système supplémentaires seront créés hors du répertoire du contenu racine spécifié.

  7. Dans le volet Web Adaptor URLs (URL pour Web Adaptor), entrez les URL des instances Web Adaptor (https://webadaptorhost.domain.com/webadaptorname) qui seront configurées avec les composants de portail et de serveur de votre déploiement. Ces instances Web Adaptor doivent être déjà installées sur la machine sur laquelle vous avez exécuté ArcGIS Enterprise Builder pour pouvoir être référencées dans les étapes de configuration après l’installation. Pour obtenir des instructions d’installation complètes de Web Adaptor, reportez-vous au guide d’installation de Web Adaptor. Pour faciliter votre tâche, vous trouverez ci-après un bref récapitulatif de la procédure d’installation de Web Adaptor.
    1. Exécutez le programme de configuration de Web Adaptor.
    2. Déployez le fichier arcgis.war depuis l’emplacement d’installation de l’instance Web Adaptor récemment installée sur votre serveur d’applications Web Java. Vous devez déployer un fichier WAR pour ArcGIS Server et un autre pour Portal for ArcGIS. Par exemple, si vous utilisez Tomcat, placez vos fichiers WAR dans le dossier ./webapps comme server.war et portal.war.

      Le nom du fichier WAR copié dans le dossier webapps correspond au nom du composant webapp et au chemin d’URL correspondant permettant d’y accéder. Par exemple, le chemin de server.war est https://webadaptorhost.domain.com/server. Le fichier portal.war est disponible dans https://webadaptorhost.domain.com/portal. Pour connaître les détails de déploiement propres à votre serveur, consultez votre serveur d’applications Java.

  8. Dans le volet Configuration Summary (Récapitulatif de configuration), vérifiez le compte d’administrateur initial, le type d’utilisateur, l’emplacement du répertoire de contenu et les URL de Web Adaptor. Cliquez sur Finish (Terminer).

Lorsque la configuration commence, un ensemble d’étapes de configuration accompagnées d’un indicateur de progression apparaît. Une coche verte s’affiche au terme de chaque étape.

Remarque :

Au cours de l’étape 3 de l’assistant de configuration concernant la création du site de serveur SIG, si un message d’erreur indiquant que la création du site ArcGIS Server a échoué, consultez les journaux situés dans le dossier /home/linux/arcgis/server/usr pour en savoir plus.

Une fois les composants configurés, un volet ArcGIS Enterprise Configuration Status (Statut de la configuration) indique que tous les composants ont été correctement configurés.

Utiliser l’utilitaire de ligne de commande

Une fois que vous avez installé le logiciel avec ArcGIS Enterprise Builder, terminez la configuration de votre déploiement de base à l’aide de l’utilitaire de ligne de commande. Pour exécuter l’utilitaire de ligne de commande, vous devez choisir le mode administrateur.

Lorsque vous utilisez l’utilitaire pour configurer le site de votre portail ArcGIS Enterprise, vous avez la possibilité de spécifier des paramètres et des valeurs de deux manières distinctes :

  • Spécifier des paramètres directement dans la ligne de commande : <location of utility>\configurebasedeployment -fn <first name> -ln <last name> -u <user name> -p <password> -e <email> -qi <question> -qa <answer> -ws <server web adaptor> -wp <portal web adaptor> -d <directory> -lf <license file> -ut <user type ID>

  • Spécifier des paramètres à partir d’un fichier de propriétés : <location of utility>\configurebasedeployment -f <properties file>
L’utilitaire de ligne de commande configurebasedeployment se trouve dans <ArcGIS Server installation directory>/tools/configurebasedeployment. Par défaut, cet emplacement est /home/linux/arcgis/server/tools/configurebasedeployment.

Les paramètres suivants sont utilisés dans l’utilitaire de ligne de commande :

  • -fn : votre prénom.
  • -ln : votre nom.
  • -u : nom d’utilisateur de votre compte avec des droits d’administration sur le portail ArcGIS Enterprise. Vous utiliserez normalement le compte d’administrateur de site principal pour créer le site.
  • -p : mot de passe du compte que vous avez spécifié pour le paramètre de nom d’utilisateur. Vous utiliserez normalement le compte d’administrateur de site principal pour créer le portail.
  • -e : adresse e-mail de votre compte avec des privilèges d’administration sur le portail ArcGIS Enterprise.
  • -qi : indique le numéro d’index de la question que vous souhaitez utiliser. Cette question permet de récupérer un mot de passe oublié. Chaque question est associée à un numéro d’index. Par exemple, la liste ci-dessous spécifie le numéro d’index suivi de sa question respective :
    • 1 - Dans quelle ville êtes-vous né ?
    • 2 - Quelle était la mascotte de votre lycée ?
    • 3 - Quel est le nom de jeune fille de votre mère ?
    • 4 - De quelle marque était votre première voiture ?
    • 5 - Dans quel lycée êtes-vous allé ?
    • 6 - Quel est le nom de famille de votre meilleur(e) ami(e)?
    • 7 - Quel est le deuxième prénom de votre sœur ou frère le plus jeune ?
    • 8 - Quel est le nom de la rue où vous avez grandi ?
    • 9 - Quel est le nom de votre personnage de fiction préféré ?
    • 10 - Quel est le nom de votre animal de compagnie préféré ?
    • 11 - Quel est le nom de votre restaurant préféré ?
    • 12 - Quel est le titre de votre livre préféré ?
    • 13 - Quel est le métier de vos rêves ?
    • 14 - Où êtes-vous allé(e) pour votre premier rendez-vous ?

  • -qa : réponse à la question secrète que vous avez choisie pour le paramètre qi.
  • -ws : URL de Web Adaptor à configurer avec le serveur.
    • Exemple : https://webadaptorhost.domain.com/<webadaptorname>
  • -wp : URL de Web Adaptor à configurer avec le portail.
    • Exemple : https://webadaptorhost.domain.com/<webadaptorname>
  • -d : chemin absolu et nom de votre répertoire de contenu pour le stockage des données et des fichiers de configuration.
  • -lf : chemin d’accès au fichier de licence du portail.
  • -ut : ID du type d’utilisateur de l’administrateur initial. Ce paramètre est facultatif. La valeur de l’ID du type d’utilisateur est le nom du type d’utilisateur auquel est ajouté le suffixe UT. Voici quelques exemples de valeurs d’ID de type d’utilisateur pour les types d’utilisateur standard : viewerUT, editorUT, fieldworkerUT, creatorUT, GISProfessionalBasicUT, GISProfessionalStdUT et GISProfessionalAdvUT.
    Remarque :
    Pour générer une liste de types d’utilisateurs compatibles disponibles dans votre organisation pour le paramètre -ut, exécutez l’utilitaire listadministratorusertypes. Si aucun ID de type d’utilisateur n’est spécifié et que le fichier de licence du portail contient un seul type d’utilisateur compatible, celui-ci est attribué. Si le fichier de licence contient plusieurs types d’utilisateurs compatibles, un type d’utilisateur temporaire est attribué et l’administrateur initial est tenu de sélectionner un type d’utilisateur après s’être connecté.
  • -f : fichier de propriétés de l’utilitaire configurebasedeployment.
    Remarque :

    Par défaut, le fichier configurebasedeployment.properties peut se trouver dans /home/linux/arcgis/server/tools/configurebasedeployment.

  • -h : affiche ce message d’aide de l’outil et ferme l’application.

Exemple d’utilisation des paramètres

  1. Ouvrez une invite de commande.
  2. Dans l’invite de commande, redéfinissez le répertoire de travail sur l’emplacement de l’utilitaire configurebasedeployment.

    Par exemple : <ArcGIS Server installation directory>\tools\configurebasedeployment.

  3. Saisissez la commande configurebasedeployment, les paramètres et leurs valeurs dans l’invite de commande.
configurebasedeployment -fn jane -ln smith -u jsmith -p mIpassword -e jsmith@myemail.com -qi 1 -qa Redlands -ws https://jsmith.myemail.com/server -wp https://jsmith.myemail.com/portal -d home/linux/arcgis/usr -lf home/linux/arcgis/usr/MyFile.json -ut creatorUT

Exemple d’utilisation d’un fichier

Au lieu de taper les paramètres et les valeurs dans l’invite de commande, vous pouvez modifier le contenu du fichier configurebasedeployment.properties et spécifier le fichier lorsque vous exécutez l’utilitaire configurebasedeployment.

  1. Accédez à l’emplacement du fichier configurebasedeployment.properties. Par défaut, le fichier configurebasedeployment.properties est installé dans /home/linux/arcgis/server/tools/configurebasedeployment.
  2. Ouvrez le fichier configurebasedeployment.properties dans un éditeur de texte et fournissez des valeurs pour chaque paramètre :

    Propriétés de déploiement pour la configuration d’un déploiement de base

    
    # First name for initial administrator account
    WEBGIS_ADMIN_FIRSTNAME = 
    # Last name for initial administrator account
    WEBGIS_ADMIN_LASTNAME =
    # Username for initial administrator account
    # Can only have the numbers 0-9, the ASCII letters a-z, A-Z, and the dot character (.)
    WEBGIS_ADMIN_USERNAME = 
    # Password for primary site administrator
    # Can only have the numbers 0-9, the ASCII letters a-z, A-Z, and the dot character (.)
    WEBGIS_ADMIN_PASSWORD = 
    # Initially, leave PORTAL_ADMIN_PASSWORD_ENCRYPTED set to false.
    # When you run the tool the first time, the password will be
    # encrypted and PORTAL_ADMIN_PASSWORD_ENCRYPTED will change to true.
    WEBGIS_ADMIN_PASSWORD_ENCRYPTED = false
    # Email address for initial administrator account
    # for example, username@domain.com
    WEBGIS_ADMIN_EMAIL =
    # This is the index of the secret questions to retrieve a forgotten password. 
    # The list of questions with their respective index numbers is as follows:
    # 1, What city were you born in?
    # 2, What was your high school mascot?
    # 3, What is your mother's maiden name?
    # 4, What was the make of your first car?
    # 5, What high school did you go to?
    # 6, What is the last name of your best friend?
    # 7, What is the middle name of your youngest sibling?
    # 8, What is the name of the street on which you grew up?
    # 9, What is the name of your favorite fictional character?
    # 10, What is the name of your favorite pet?
    # 11, What is the name of your favorite restaurant?
    # 12, What is the title of your favorite book?
    # 13, What is your dream job?
    # 14, Where did you go on your first date?
    WEBGIS_ADMIN_SECURITY_QUESTION_INDEX = 
    # Answer to the secret question
    # e.g \"My Answer\"
    WEBGIS_ADMIN_SECURITY_QUESTION_ANSWER = 
    # AcGIS Enterprise content directory for storing data and configuration files.
    # By default, the content directory will be created locally.
    # e.g./<ArcGIS Enterprise Builder installation directory>/usr
    WEBGIS_CONTENT_DIRECTORY =
    # Specify the Portal Web Adaptor URL on Linux only.
    # Example: https://webadaptorhost.domain.com/<webadaptorname>
    WEBGIS_PORTAL_WEBADAPTOR_URL =
    # Specify the Server Web Adaptor URL on Linux only.
    # Example: https://webadaptorhost.domain.com/<webadaptorname>
    WEBGIS_SERVER_WEBADAPTOR_URL = 
    # The path to the Portal license file
    PORTAL_LICENSE_FILE =
    # The id of the user type for the Initial Administrator
    PORTAL_USER_TYPE_ID =

  3. Enregistrez le fichier configurebasedeployment.properties.
  4. Ouvrez une invite de commande.
  5. Dans l’invite de commande, redéfinissez le répertoire de travail sur l’emplacement de l’utilitaire configurebasedeployment.

    Par exemple : /home/linux/arcgis/server/tools/configurebasedeployment.

  6. Tapez la commande configurebasedeployment et spécifiez le fichier configurebasedeployment.properties.

    configurebasedeployment -f configurebasedeployment.properties

Remarque :

Certains paramètres admettent des réponses à plusieurs mots, tels que -fn, -ln, or –qa. Dans ce cas, placez les paramètres entre guillemets.

Pour la valeur du mot de passe, évitez d’utiliser des caractères spéciaux (par exemple, &, \, etc.), qui peuvent avoir une signification spéciale pour l’invite de commande.

Une fois les composants entièrement configurés, un message s’affiche indiquant que ArcGIS Enterprise Builder Site a été créé avec succès.

Utiliser l’utilitaire de ligne de commande listadministratorusertypes pour identifier les types d’utilisateur compatibles

Pour identifier une liste d’ID de type d’utilisateur disposant d’une licence pour votre organisation et compatibles avec le rôle Administration, exécutez l’utilitaire de ligne de commande listadministratorusertypes, qui se trouve au même emplacement que l’utilitaire configurebasedeployment. Cela permet de générer une liste d’entrées pour le paramètre -ut dans l’outil configurebasedeployment. Exécutez l’outil listadministratorusertypes avec -la et le fichier de licence du portail en entrée.

Composants configurés

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

  • Un portail et un site ArcGIS Server configuré avec le même compte d’administrateur initial
  • Un site ArcGIS Server concédé sous licence en tant que serveur SIG
  • Des data stores relationnels et de cache tuilé inscrits auprès du site ArcGIS Server
Remarque :

Le générateur installera deux instances Web Adaptor avec les noms par défaut portail et serveur. Lors de l’installation, si vous choisissez d’indiquer d’autres noms d’instance Web Adaptor, ils seront utilisés pour les composants configurés.

Le site de serveur SIG est fédéré avec le portail et défini comme serveur d’hébergement du portail.

Exemple de portail et d’URL ArcGIS Server Manager après la configuration

A l'aide des liens fournis dans le récapitulatif de la configuration, vous pouvez commencer à personnaliser votre portail, à ajouter des membres et du contenu, et à configurer la sécurité. Utilisez en outre ArcGIS Server Manager pour gérer les services publiés. Pour accéder à ArcGIS Server Manager une fois que le générateur a terminé, utilisez l’URL entière, au format https://gisserver.domain.com:6443/arcgis/manager/.

Conseil :

Il est recommandé d’utiliser les scripts serverScan.py et portalScan.py pour vérifier les pratiques conseillées liées à votre nouvelle installation de portail ArcGIS Server et ArcGIS Enterprise.