Créer une organisation

Après avoir déployé ArcGIS Enterprise on Kubernetes sur votre agrégat Kubernetes, vous devez créer une organisation ArcGIS Enterprise. Vous pouvez créer une organisation de l’une des deux manières suivantes :

  • Utiliser un navigateur pour exécuter l’assistant de configuration
  • Utiliser le script configure.sh pour créer une organisation en mode silencieux

Le script de configuration est inclus dans le paquetage de déploiement livré sous forme de fichier .tar.gz, disponible en téléchargement sur My Esri.

Les deux options permettent les opérations suivantes :

  • Télécharger les images Esri Docker pour ArcGIS Enterprise on Kubernetes
  • Déployer les conteneurs ArcGIS Enterprise on Kubernetes dans votre cluster ArcGIS Enterprise on Kubernetes
  • Créer une organisation ArcGIS Enterprise

Utiliser l’assistant de configuration

Après avoir déployé ArcGIS Enterprise on Kubernetes, procédez comme suit avec l’assistant de configuration pour finaliser votre organisation :

Ouvrez le lien Create New Organization (Créer une organisation) dans un navigateur Web. Accédez à l’URL d’équilibrage de la charge et ajoutez /manager à la fin de l’URL. Si, par exemple, le contexte d’équilibrage de la charge est arcgis, ouvrez l’URL https://organization.example.com/arcgis/manager.

La page vous redirige vers l’assistant de configuration ArcGIS Enterprise on Kubernetes. Cliquez sur Continue (Poursuivre) pour commencer. Pour suivre les instructions de l’assistant, procédez comme suit :

  1. Sur la page Architecture profiles (Profils d’architecture), sélectionnez le profil qui répond aux critères de votre organisation, puis cliquez sur Next (Suivant).
  2. Dans la page Provide license (Fournir des licences), chargez un fichier de licence ArcGIS Enterprise on Kubernetes et spécifiez un type d’utilisateur pour le compte d’administrateur principal :
    • Choisissez le fichier de licence (un fichier .json) qui concède une licence aux types d’utilisateur et applications de votre organisation. Vous pouvez vous procurer ce fichier sur My Esri.
    • Sélectionnez le type d’utilisateur pour le compte d’administrateur principal que vous allez créer à l’étape suivante. Vous pouvez changer le type d’utilisateur de l’administrateur dans le portail une fois l’organisation créée.
    • Cliquez sur Next (Suivant).
  3. Dans la page Create administrator account (Créer un compte d’administrateur), créez un compte d’administrateur principal pour votre organisation ArcGIS Enterprise. Spécifiez un nom d’utilisateur, un mot de passe, une adresse email, un prénom et un nom, ainsi qu’une question de sécurité et sa réponse, puis cliquez sur Next (Suivant).

    Le nom d’utilisateur doit comporter au moins six caractères. Les seuls caractères spéciaux autorisés sont l’arobase (@), le trait d’union (-), le point (.) et le trait de soulignement (_).

    Votre mot de passe doit inclure au moins huit caractères. Il doit contenir au moins une lettre (en minuscules ou en majuscules) et un chiffre. Tous les caractères spéciaux sont autorisés.

  4. Sur l’onglet Set system storage (Définir le stockage système), définissez les spécifications de stockage de votre organisation.
    1. Choisissez Dynamic (Dynamique) ou Static (Statique) pour spécifier la manière dont vous provisionnez les volumes persistants.

      • Si vous optez pour Dynamic (Dynamique), spécifiez les paramètres suivants pour chaque volume de stockage :
        • Size (Taille) (obligatoire) : spécifiez la taille minimale requise. Si vous avez besoin de volumes de stockage plus importants, augmentez la taille.
        • Storage class name (Nom de la classe de stockage) (obligatoire) : spécifiez vos propres noms de classes de stockage. Vous êtes libre également de cocher la case visant à utiliser le même nom de classe de stockage pour tous les volumes de stockage.
        • Label selector (Sélecteur d’étiquette) (facultatif) : si vous voulez étiqueter vos volumes persistants, indiquez les paires de valeurs de clés correspondantes.
      • Si vous optez pour Static (Statique), spécifiez les paramètres suivants pour chaque volume de stockage :
        Remarque :

        Lors de la liaison à un volume persistant existant pour lequel aucune classe de stockage n’a été définie, laissez le nom de la classe de stockage vide. Si une classe de stockage par défaut est configurée dans le cluster, le contrôleur d’admission DefaultStorageClass ajoute la classe de stockage par défaut et empêche la liaison de la réclamation de volume persistant. En pareil cas, les administrateurs doivent ajouter la spécification de classe de stockage au volume existant ou supprimer la configuration de la classe de stockage par défaut.

        • Size (Taille) (obligatoire) : spécifiez la taille minimale requise. Si vous avez provisionné des volumes de stockage plus importants, augmentez la taille.
        • Storage class name (Nom de la classe de stockage) (facultatif) : si vous avez défini une classe de stockage, spécifiez la nom de la classe de stockage pour chaque volume. Vous êtes libre également de cocher la case visant à utiliser le même nom de classe de stockage pour tous les volumes de stockage.
        • Label selector (Sélecteur d’étiquette) (facultatif) : définissez les étiquettes en saisissant les paires de valeurs de clés correspondantes. Vous trouverez des exemples d’étiquettes dans la configuration du système.

    2. Sous l’onglet Set user managed storage (Définir un stockage géré par l’utilisateur), vous pouvez également indiquer un dossier de données inscrites ou un ensemble de dossiers pour votre organisation. Une fois l’organisation en cours d’utilisation, les membres dotés des privilèges de publication peuvent créer des éléments qui font directement référence aux données au sein de ces emplacements inscrits.

      • File server host name (Nom d’hôte du serveur de fichiers) : indiquez le nom de la machine dans laquelle les données sont conservées et peuvent être consultées via un chemin NFS (Network File System, système de fichiers réseau).
      • File server shared path (Chemin d’accès partagé au serveur de fichiers) : indiquez un chemin d’accès NFS sur la machine hôte dans laquelle les données peuvent être conservées et sont accessibles dans toute l’organisation.
      • Client path (Chemin d’accès au client) : indiquez des emplacements individuels (lecteur ou partagés) dans lesquels les données source sont accessibles et peuvent être publiées par les clients, tels que ArcGIS Pro.

      Pour inscrire plusieurs chemins, cliquez sur Add more paths (Ajouter d’autres chemins), spécifiez le nom d’hôte, le chemin d’accès partagé et le chemin d’accès au client et répétez cette opération autant de fois que nécessaire.

    Remarque :

    Il est fortement recommandé d’inscrire les dossiers au cours de cette étape, car toute inscription ultérieure peut provoquer un temps d’arrêt pour le système.

    • Cliquez sur Next (Suivant).

    Dans la page Configuration Summary (Récapitulatif de configuration), vous obtenez un récapitulatif des détails de la configuration.

  5. Passez en revue chaque point et cliquez sur Finish (Terminer) pour lancer la configuration.

Lorsque l’assistant s’exécute, il affiche le statut actuel de la configuration.

Utiliser le script de configuration

Si vous ne souhaitez pas utiliser l’assistant de configuration, vous pouvez créer une organisation en mode silencieux. Une fois que vous avez déployé ArcGIS Enterprise on Kubernetes, vous pouvez exécuter le script configure.sh.

Remarque :
Il est recommandé d’exécuter l’outil password-encrypt.sh pour générer des mots de passe chiffrés à utiliser dans le fichier configure.properties.

Exécuter le script

Le script configure.sh est disponible en téléchargement sur My Esri et est livré sous forme d’un fichier .tar.gz. Le script est associé à un fichier configure.properties qui fournit un jeu de paramètres vous invitant à une entrée unique vers votre organisation ArcGIS Enterprise et un outil password-encrypt.sh permettant de générer des mots de passe chiffrés selon le protocole AES-256.

Le script configure.sh effectue les opérations suivantes :

  • Vérification des paramètres valides dans le fichier configure.properties
  • Création d’un stockage JSON basé sur les propriétés de stockage spécifiées qui se trouvent dans le fichier configure.properties
  • Création d’une organisation ArcGIS Enterprise

Remarque :

Le poste de travail client utilisé pour exécuter ce script doit avoir accès à https://<FQDN>/<context>/admin.

Pour exécuter le script, procédez comme suit :

  1. Sur votre machine cliente Kubernetes, ouvrez un terminal en tant qu’administrateur.
  2. Accédez à <ArcGIS Enterprise on Kubernetes install directory>/tools/configure.
  3. Ouvrez le fichier configure.properties.
  4. Fournissez une valeur pour chaque paramètre répertorié dans le fichier. Le fichier contient les sections suivantes :
    • Profil d’architecture
    • Organisation
    • Licence
    • Fichier de clé de chiffrement
    • Compte d’administrateur
    • Paramètres des journaux
    • Stockage
  5. Enregistrez le fichier. Vous pouvez aussi renommer le fichier.
  6. Sur le terminal, exécutez le script de configuration sous le format de commande suivant :
    ./configure.sh [options] -f <user_properties>
    

    • L’une des options que vous pouvez choisir pour qu’elle s’exécute avec le script de configuration est l’option d’inscription des répertoires de données gérés par l’utilisateur. Si vous choisissez d’inscrire un data store géré par l’utilisateur, vous devez spécifier un dossier de données, ou un ensemble de dossiers de données, pour votre organisation dans un fichier .json au format suivant :
      Remarque :

      L’exemple de fichier JSON ci-dessous spécifie les détails d’un partage de système NFS (système de fichiers réseau) avec un chemin d’accès client désignant un partage réseau, ainsi que d’un système NFS avec un chemin d’accès désignant un lecteur local.

      [
        {
          "clientPath": "\\\\sample_server\\SharedPath\\Data",
          "type": "folder",
          "info": {
            "fileServerHost": "nfsHost.domain.com",
            "fileServerType": "nfs",
            "fileServerPath": "/SharedPath/Data"
          }
        },
        {
          "clientPath": "C:\\data",
          "type": "folder",
          "info": {
            "fileServerHost": "nfsHost.domain.com",
            "fileServerType": "nfs",
            "fileServerPath": "/data",
            "hostName": "yourclienthost.domain.com"
          }
        }
      ]
      
    • Vous devez également ajouter le chemin d’accès au fichier .json au format de la commande comme suit :
      % ./configure.sh -f my.properties -u /path/to/my_data_stores.json
      

Le contenu du fichier <user properties> provient du fichier configure.properties.

Une fois que vous avez exécuté le script, un récapitulatif des détails de la configuration apparaît et vous êtes invité à indiquer si vous désirez poursuivre.

  • Si vous spécifiez « y » pour « oui », le script poursuit les opérations et crée une organisation. Il s’agit de la saisie par défaut qu’attend le script.
  • Si vous spécifiez « n » pour « non », le script s’interrompt sur le champ et ne crée pas d’organisation.