After you install ArcGIS Enterprise on Kubernetes Web Adaptor, you must configure it to work with your organization. You can configure it using a wizard or command line utility.
Note:
The configuration wizard and command line utility can only be accessed from the machine hosting ArcGIS Enterprise on Kubernetes Web Adaptor.Steps to configure
To configure your organization with ArcGIS Enterprise on Kubernetes Web Adaptor, you'll need to do the following:
- Deploy ArcGIS Enterprise on Kubernetes.
- Create an organization.
- Install ArcGIS Enterprise on Kubernetes Web Adaptor.
- Obtain the Web Adaptor registration token.
- Use the configuration wizard or command line tool to provide the registration token to Web Adaptor.
Obtain the registration token
Once you've deployed ArcGIS Enterprise on Kubernetes and created an organization, you can obtain a registration token from ArcGIS Enterprise Manager.
The registration token is a unique set of letters and numbers that is decoded by ArcGIS Enterprise on Kubernetes Web Adaptor and used to register a web or application server with your organization.
- Sign in to ArcGIS Enterprise Manager as an administrator.
- Click Settings, and click Web Adaptor.
- Click Copy.
Next, you'll use the registration token to configure with ArcGIS Enterprise on Kubernetes Web Adaptor.
Use the configuration wizard
To configure ArcGIS Enterprise on Kubernetes Web Adaptor from the configuration wizard, do the following:
- Open the configuration wizard in a browser.
The URL is in the format https://organization.example.com/context/webadaptor.
- On the Welcome page, click Continue.
- On the Configure page, paste your registration token in the text box and click Configure.
ArcGIS Enterprise on Kubernetes Web Adaptor is now configured. You can access ArcGIS Enterprise Manager and the organization at the URLs provided on the page. When you are finished, close the browser window.
Use the command line
A command line utility is available to configure ArcGIS Enterprise on Kubernetes Web Adaptor silently. Steps to run the command line utility are provided for each installation type (IIS and Java).
ArcGIS Enterprise on Kubernetes Web Adaptor (IIS)
The ArcGIS Enterprise on Kubernetes Web Adaptor (IIS) command line utility is located in the same location where the Web Adaptor file was extracted.
Note:
The default location is C:\Program Files (x86)\Common Files\ArcGIS\WebAdaptorKubernetes\IIS\<version>\Tools\ConfigureWebAdaptor.exe.The available parameters are as follows:
-t <WebAdaptorRegistrationToken> -h <help>
- <WebAdaptorRegistrationToken>—The registration token is used to configure ArcGIS Web Adaptor with your organization and can be obtained from ArcGIS Enterprise Manager or ArcGIS Enterprise Administrator API.
- <help>—Displays help for the utility (optional).
Example:
C:\Program Files (x86)\Common Files\ArcGIS\WebAdaptorKubernetes\IIS\<version>\Tools>ConfigureWebAdaptor.exe -t abCdeFGhIJKLMNopQrIstuV1wX2YzA3BCDeFGHI4jkLMnOpQrSTU5V678WXyZABcde9fgHIJKlmN0PQrstuvwX1Yza2BCd3E4fghiJkL4MNOpQRStu5WXyzA6BcDeFGHiJKLmNOp7QrStuvwxY89zAB0cdeFgHIJklMNopQr1stu2vWXyZa3bCDE4FGHiJkl5MN6op7QrStUvwX8yzABcdefgh9ijklM0nOPqrstuVWXYZABCdEfgHIjKlMnOP1qrST2UVwxYZaBCDEFGH3ijKLMNOp4qRSTUVwXyZAB5c6d7EFghi890jKL1MNoPQRStUvW2xYzaBCDef34ghiJ5KLM6NOP7QRS8TUVwXy9zA0lbCdefGHIjK2M3Nop4QRSTU5VWXyZ6
After running the command, the ArcGIS Enterprise on Kubernetes Web Adaptor is configured with your organization.
ArcGIS Enterprise on Kubernetes Web Adaptor (Java) for Windows
The ArcGIS Enterprise on Kubernetes Web Adaptor (Java) command line utility is in the same location where the Web Adaptor file was extracted.
The available parameters are as follows:
-t <WebAdaptorRegistrationToken> -h <help>
- <WebAdaptorRegistrationToken>—The registration token is used to configure ArcGIS Web Adaptor with your organization and can be obtained from ArcGIS Enterprise Manager or ArcGIS Enterprise Administrator API.
- <help>—Displays help for the utility (optional).
Example:
ConfigureWebAdaptor.bat -t abCdeFGhIJKLMNopQrIstuV1wX2YzA3BCDeFGHI4jkLMnOpQrSTU5V678WXyZABcde9fgHIJKlmN0PQrstuvwX1Yza2BCd3E4fghiJkL4MNOpQRStu5WXyzA6BcDeFGHiJKLmNOp7QrStuvwxY89zAB0cdeFgHIJklMNopQr1stu2vWXyZa3bCDE4FGHiJkl5MN6op7QrStUvwX8yzABcdefgh9ijklM0nOPqrstuVWXYZABCdEfgHIjKlMnOP1qrST2UVwxYZaBCDEFGH3ijKLMNOp4qRSTUVwXyZAB5c6d7EFghi890jKL1MNoPQRStUvW2xYzaBCDef34ghiJ5KLM6NOP7QRS8TUVwXy9zA0lbCdefGHIjK2M3Nop4QRSTU5VWXyZ6
After running the command, the ArcGIS Enterprise on Kubernetes Web Adaptor is configured with your organization.
ArcGIS Enterprise on Kubernetes Web Adaptor (Java) for Linux
You can configure ArcGIS Enterprise on Kubernetes Web Adaptor (Java) using the command line utility in the location where the Web Adaptor file was extracted.
The available parameters are as follows:
-t <WebAdaptorRegistrationToken> -h <help>
- <WebAdaptorRegistrationToken>—The registration token is used to configure ArcGIS Web Adaptor with your organization and can be obtained from ArcGIS Enterprise Manager or ArcGIS Enterprise Administrator API.
- <help>—Displays help for the utility (optional).
Note:
To run the command line utility, the Java Runtime Environment (JRE) must be present on the machine hosting ArcGIS Web Adaptor. If the JRE is not present on the machine, an error occurs when running the utility. See the Java Downloads site for instructions on how to download and install the JRE on your machine.
- <WebAdaptorRegistrationToken>—The registration token is used to configure ArcGIS Web Adaptor with your organization and can be obtained from ArcGIS Enterprise Manager or ArcGIS Enterprise Administrator API.
- <help>—Displays help for the utility (optional).
Example:
./ConfigureWebAdaptor.sh -t abCdeFGhIJKLMNopQrIstuV1wX2YzA3BCDeFGHI4jkLMnOpQrSTU5V678WXyZABcde9fgHIJKlmN0PQrstuvwX1Yza2BCd3E4fghiJkL4MNOpQRStu5WXyzA6BcDeFGHiJKLmNOp7QrStuvwxY89zAB0cdeFgHIJklMNopQr1stu2vWXyZa3bCDE4FGHiJkl5MN6op7QrStUvwX8yzABcdefgh9ijklM0nOPqrstuVWXYZABCdEfgHIjKlMnOP1qrST2UVwxYZaBCDEFGH3ijKLMNOp4qRSTUVwXyZAB5c6d7EFghi890jKL1MNoPQRStUvW2xYzaBCDef34ghiJ5KLM6NOP7QRS8TUVwXy9zA0lbCdefGHIjK2M3Nop4QRSTU5VWXyZ6
After running the command, the ArcGIS Enterprise on Kubernetes Web Adaptor is configured with your organization.