Configurer ArcGIS Enterprise on Kubernetes Web Adaptor

Après avoir installé ArcGIS Enterprise on Kubernetes Web Adaptor, vous devez le configurer pour qu’il fonctionne avec votre organisation. Vous pouvez le configurer avec un assistant ou un utilitaire de ligne de commande.

Remarque :
L’assistant de configuration et l’utilitaire de ligne de commande ne sont accessibles qu’à partir d’une machine hébergeant ArcGIS Enterprise on Kubernetes Web Adaptor.

Configurer votre organisation avec ArcGIS Enterprise on Kubernetes Web Adaptor

Pour configurer votre organisation avec ArcGIS Enterprise on Kubernetes Web Adaptor, procédez comme suit :

  1. Déployez ArcGIS Enterprise on Kubernetes.
  2. Créez une organisation.
  3. Installer ArcGIS Enterprise on Kubernetes Web Adaptor
  4. Procurez-vous le jeton d’inscription du Web Adaptor.
  5. Utilisez l’assistant de configuration ou l’outil de ligne de commande pour transmettre le jeton d’inscription à ArcGIS Web Adaptor.

Obtenir le jeton d’inscription

Le jeton d’inscription est un ensemble unique de lettres et de chiffres qui est décodé par ArcGIS Enterprise on Kubernetes Web Adaptor et qui permet d’inscrire un serveur Web ou d’application auprès de votre organisation.

Une fois que vous avez déployé ArcGIS Enterprise on Kubernetes et créé une organisation, vous pouvez obtenir un jeton d’inscription auprès de ArcGIS Enterprise Manager ou au moyen d’un utilitaire de ligne de commande.

Obtenir le jeton d’inscription auprès de ArcGIS Enterprise Manager

Pour obtenir le jeton d’inscription auprès de ArcGIS Enterprise Manager, procédez comme suit :

  1. Connectez-vous à ArcGIS Enterprise Manager en tant qu’administrateur.
  2. Cliquez sur Settings (Paramètres) et sur Web Adaptor.
  3. Cliquez sur Copier.
    Remarque :

    Si vous souhaitez inscrire plusieurs instances de ArcGIS Enterprise on Kubernetes Web Adaptor, un jeton d’inscription unique est nécessaire pour chacune. Un nouveau jeton est généré chaque fois que vous cliquez sur Copy (Copier).

Vous allez ensuite utiliser le jeton d’inscription pour une configuration avec ArcGIS Enterprise on Kubernetes Web Adaptor.

Obtenir le jeton d’inscription au moyen de la ligne de commande

Si ArcGIS Enterprise Manager n’est pas disponible via le port de nœud sur un nœud worker dans un navigateur, le jeton d’inscription peut s’obtenir à l’aide d’un utilitaire de ligne de commande.

Pour obtenir le jeton d’inscription, procédez comme suit :

  1. Sur votre machine cliente Kubernetes, ouvrez un terminal.
  2. Exécutez l’outil get-registration-token.sh à l’aide du format de commande suivant, en saisissant le nom d’utilisateur et le mot de passe à l’invite :
    ./get-registration-token.sh -w node.example.com -c context -n 31443
    
  3. Copiez le jeton d’inscription et transférez-le sur la machine hôte du Web Adaptor.

Vous allez ensuite utiliser le jeton d’inscription pour une configuration avec ArcGIS Enterprise on Kubernetes Web Adaptor.

Utiliser l'assistant de configuration

Pour configurer ArcGIS Enterprise on Kubernetes Web Adaptor dans l’assistant de configuration, procédez comme suit :

  1. Ouvrez l’assistant de configuration dans un navigateur.

    L’URL est au format suivant : https://organization.example.com/context/webadaptor.

  2. Sur la page Welcome (Bienvenue), cliquez sur Continue (Continuer).
  3. Sur la page Configure (Configurer), collez votre jeton d’inscription dans la zone de texte et cliquez sur Configure (Configurer).

    ArcGIS Enterprise on Kubernetes Web Adaptor est maintenant configuré. Vous pouvez accéder à ArcGIS Enterprise Manager et à l’organisation par le biais des URL spécifiées sur la page. Lorsque vous avez terminé, fermez la fenêtre du navigateur.

Utiliser la ligne de commande

Un utilitaire de ligne de commande est disponible pour configurer ArcGIS Enterprise on Kubernetes Web Adaptor en mode silencieux. Les étapes d’exécution de l’utilitaire de ligne de commande sont fournies pour chaque type d’installation (IIS et Java).

ArcGIS Enterprise on Kubernetes Web Adaptor (IIS)

L’utilitaire de ligne de commande ArcGIS Enterprise on Kubernetes Web Adaptor (IIS) se trouve au même emplacement que celui où le fichier Web Adaptor a été extrait.

Remarque :
L’emplacement par défaut est C:\Program Files (x86)\Common Files\ArcGIS\WebAdaptorKubernetes\IIS\<version>\Tools\ConfigureWebAdaptor.exe.

Les paramètres disponibles sont les suivants :

-t <WebAdaptorRegistrationToken> -w <WebAdaptorMachineName> -h <help>

  • <WebAdaptorRegistrationToken> : le jeton d’inscription permet de configurer ArcGIS Web Adaptor avec votre organisation et peut s’obtenir auprès de ArcGIS Enterprise Manager, de API ArcGIS Enterprise Administrator ou au moyen d’un utilitaire de ligne de commande.
  • <WebAdaptorMachineName> : (facultatif) nom de la machine hébergeant ArcGIS Enterprise on Kubernetes Web Adaptor. Incluez le nom de domaine complet de la machine, par exemple, webadaptorhost.domain.com. Vous pouvez également utiliser l’URL de l’instance Web Adaptor à configurer. C’est l’URL à utiliser pour accéder à la page de configuration de Web Adaptor dans un navigateur Web.
  • <help> : (facultatif) affiche l’aide de l’utilitaire.

Exemple :

C:\Program Files (x86)\Common Files\ArcGIS\WebAdaptorKubernetes\IIS\<version>\Tools>ConfigureWebAdaptor.exe -t abCdeFGhIJKLMNopQrIstuV1wX2YzA3BCDeFGHI4jkLMnOpQrSTU5V678WXyZABcde9fgHIJKlmN0PQrstuvwX1Yza2BCd3E4fghiJkL4MNOpQRStu5WXyzA6BcDeFGHiJKLmNOp7QrStuvwxY89zAB0cdeFgHIJklMNopQr1stu2vWXyZa3bCDE4FGHiJkl5MN6op7QrStUvwX8yzABcdefgh9ijklM0nOPqrstuVWXYZABCdEfgHIjKlMnOP1qrST2UVwxYZaBCDEFGH3ijKLMNOp4qRSTUVwXyZAB5c6d7EFghi890jKL1MNoPQRStUvW2xYzaBCDef34ghiJ5KLM6NOP7QRS8TUVwXy9zA0lbCdefGHIjK2M3Nop4QRSTU5VWXyZ6 -w https://<webadaptorhost.domain.com>/arcgis/webadaptor

Après l’exécution de la commande, ArcGIS Enterprise on Kubernetes Web Adaptor est configuré avec votre organisation.

ArcGIS Enterprise on Kubernetes Web Adaptor (Java) pour Windows

L’utilitaire de ligne de commande ArcGIS Enterprise on Kubernetes Web Adaptor (Java) figure dans le même emplacement que celui où le fichier Web Adaptor a été extrait.

Les paramètres disponibles sont les suivants :

-t <WebAdaptorRegistrationToken> -w <WebAdaptorMachineName> -h <help>

  • <WebAdaptorRegistrationToken> : le jeton d’inscription permet de configurer ArcGIS Web Adaptor avec votre organisation et peut s’obtenir auprès de ArcGIS Enterprise Manager, de API ArcGIS Enterprise Administrator ou au moyen d’un utilitaire de ligne de commande.
  • <WebAdaptorMachineName> : (facultatif) nom de la machine hébergeant ArcGIS Enterprise on Kubernetes Web Adaptor. Incluez le nom de domaine complet de la machine, par exemple, webadaptorhost.domain.com. Vous pouvez également utiliser l’URL de l’instance Web Adaptor à configurer. C’est l’URL à utiliser pour accéder à la page de configuration de Web Adaptor dans un navigateur Web.
  • <help> : (facultatif) affiche l’aide de l’utilitaire.

Exemple :

ConfigureWebAdaptor.bat -t abCdeFGhIJKLMNopQrIstuV1wX2YzA3BCDeFGHI4jkLMnOpQrSTU5V678WXyZABcde9fgHIJKlmN0PQrstuvwX1Yza2BCd3E4fghiJkL4MNOpQRStu5WXyzA6BcDeFGHiJKLmNOp7QrStuvwxY89zAB0cdeFgHIJklMNopQr1stu2vWXyZa3bCDE4FGHiJkl5MN6op7QrStUvwX8yzABcdefgh9ijklM0nOPqrstuVWXYZABCdEfgHIjKlMnOP1qrST2UVwxYZaBCDEFGH3ijKLMNOp4qRSTUVwXyZAB5c6d7EFghi890jKL1MNoPQRStUvW2xYzaBCDef34ghiJ5KLM6NOP7QRS8TUVwXy9zA0lbCdefGHIjK2M3Nop4QRSTU5VWXyZ6 - w https://<webadaptorhost.domain.com>/arcgis/webadaptor

Après l’exécution de la commande, ArcGIS Enterprise on Kubernetes Web Adaptor est configuré avec votre organisation.

ArcGIS Enterprise on Kubernetes Web Adaptor (Java) pour Linux

Vous pouvez configurer ArcGIS Enterprise on Kubernetes Web Adaptor (Java) à l’aide de l’utilitaire de ligne de commande à l’emplacement où le fichier Web Adaptor a été extrait.

Les paramètres disponibles sont les suivants :

-t <WebAdaptorRegistrationToken> -w <WebAdaptorMachineName> -h <help>

  • <WebAdaptorRegistrationToken> : le jeton d’inscription permet de configurer ArcGIS Web Adaptor avec votre organisation et peut s’obtenir auprès de ArcGIS Enterprise Manager, de API ArcGIS Enterprise Administrator ou au moyen d’un utilitaire de ligne de commande.
  • <WebAdaptorMachineName> : (facultatif) nom de la machine hébergeant ArcGIS Enterprise on Kubernetes Web Adaptor. Incluez le nom de domaine complet de la machine, par exemple, webadaptorhost.domain.com. Vous pouvez également utiliser l’URL de l’instance Web Adaptor à configurer. C’est l’URL à utiliser pour accéder à la page de configuration de Web Adaptor dans un navigateur Web.
  • <help> : (facultatif) affiche l’aide de l’utilitaire.
Remarque :

Pour exécuter l’utilitaire de ligne de commande, l’environnement d’exécution Java (JRE) doit être présent sur la machine qui héberge ArcGIS Web Adaptor. Si le JRE n’est pas présent sur la machine, une erreur se produit lors de l’exécution de l’utilitaire. Reportez-vous à la rubrique Téléchargements de Java pour savoir comment télécharger et installer l’environnement d’exécution Java sur votre machine.

Exemple :

./ConfigureWebAdaptor.sh -t abCdeFGhIJKLMNopQrIstuV1wX2YzA3BCDeFGHI4jkLMnOpQrSTU5V678WXyZABcde9fgHIJKlmN0PQrstuvwX1Yza2BCd3E4fghiJkL4MNOpQRStu5WXyzA6BcDeFGHiJKLmNOp7QrStuvwxY89zAB0cdeFgHIJklMNopQr1stu2vWXyZa3bCDE4FGHiJkl5MN6op7QrStUvwX8yzABcdefgh9ijklM0nOPqrstuVWXYZABCdEfgHIjKlMnOP1qrST2UVwxYZaBCDEFGH3ijKLMNOp4qRSTUVwXyZAB5c6d7EFghi890jKL1MNoPQRStUvW2xYzaBCDef34ghiJ5KLM6NOP7QRS8TUVwXy9zA0lbCdefGHIjK2M3Nop4QRSTU5VWXyZ6 -w https://<webadaptorhost.domain.com>/arcgis/webadaptor

Après l’exécution de la commande, ArcGIS Enterprise on Kubernetes Web Adaptor est configuré avec votre organisation.