Create an organization

After you've deployed ArcGIS Enterprise on Kubernetes on your Kubernetes cluster, you'll need to create an ArcGIS Enterprise organization. You can create an organization in one of two ways:

  • Use a browser to run the setup wizard
  • Use the configure.sh script to create an organization silently

The configuration script is included in the deployment package that is delivered as a .tar.gz file and available for download from My Esri.

Both options will do the following:

  • Download the Esri Docker images for ArcGIS Enterprise on Kubernetes
  • Deploy ArcGIS Enterprise on Kubernetes containers in your ArcGIS Enterprise on Kubernetes cluster
  • Create an ArcGIS Enterprise organization

Use the setup wizard

Once you've deployed ArcGIS Enterprise on Kubernetes, perform the following steps with the configuration wizard to complete your organization:

Open the Create New Organization link in a web browser. Browse to your load balancer URL and append /manager to the end of the URL. For example, if your load balancer context is arcgis, open the https://organization.example.com/arcgis/manager URL.

The page redirects to the ArcGIS Enterprise on Kubernetes setup wizard. Click Continue to begin. To complete the wizard, follow these steps:

  1. On the Architecture profiles page, select the profile that meets your organization's requirements.
    • Click Next.
  2. On the Provide licenses page, upload two files and specify a user type for the primary administrator account:
    • Choose the ArcGIS Enterprise portal license file (a .json file) that will license your organization's user types and apps. This file is obtained from My Esri.
    • Select the user type for the primary administrator account that you will create in the next step. You can change the administrator's user type in the portal after the organization is created.
    • Choose the GIS Server license file (an .ecp or .prvc file). This file is obtained from My Esri.
    • Click Next.
  3. On the Create administrator account page, create a primary administrator account for your ArcGIS Enterprise organization.
    • Provide a user name, password, email, first and last name, and a security question and answer.
    • Your user name must be at least six characters in length. The only special characters allowed are the at sign (@), dash (-), dot (.), and underscore (_).
    • Your password must be at least eight characters in length. It must contain at least one alphabet letter (uppercase or lowercase) and one number. All special characters are allowed.
    • Click Next.
  4. On the Set storage information page, there are two tabs; Set system storage and Set folder storage.
    1. On the Set system storage tab, specify storage specifications for your organization.

      • Choose Dynamic or Static to specify how you're provisioning persistent volumes (PVs).
      • If you choose Dynamic, specify the following for each storage volume:
      • Size (required)—The minimum and default size is 16 GiB. If you require larger storage volumes, increase the size accordingly.
      • Storage class name (required)—The default name for each storage volume is arcgis-storage-default. If desired, you can specify your own storage class names. Optionally, check the box to use the same storage class name (default or nondefault) for all storage volumes.
      • Label selector (optional)—If you want to label your PVs, provide the key value pairs accordingly. You can remove default key value pairs if you've specified custom labels.

      • If you choose Static, specify the following for each storage volume:

      • Size (required)—The minimum and default size is 16 GiB. If you've provisioned your storage with larger volumes, increase the size accordingly.
      • Storage class name (optional)—If you've set a storage class, specify the storage class name for each volume. Optionally, check the box to use the same storage class name (default or nondefault) for all storage volumes. The default name for each storage volume is arcgis-storage-default.
      • Label selector (required)—Pursuant to the system requirements, default labels are recommended but custom labels are also supported. If you're using custom labels, you can remove the default values and define your own as needed.

    2. On the Set folder storage tab, optionally provide a registered data folder or set of folders for your organization. Registered data folders must be accessible to all nodes in your deployment. Once the organization is in use, members with publishing privileges can create items that directly reference the data within these registered locations. To register more than one path, click Add more paths, specify the folder path, and repeat as needed.
    Note:

    It is strongly recommended that you register folders during this step, as the act of registering later is subject to system downtime.

    • Click Next.

    On the Configuration summary page, you're provided with a summary of configuration details.

  5. Review each item, and click Finish to start the setup.

While the wizard runs, it displays the current configuration status. Optionally, click View completed configuration steps to view a history of the setup tasks as they complete.

Use the configuration script

As an alternative to using the setup wizard, you can create an organization silently. Once you've deployed ArcGIS Enterprise on Kubernetes, you can run the configure.sh script.

Before you begin

The configure.sh script is available for download from My Esri and is delivered as a .tar.gz file. The script is bundled with a configure.properties file, which provides a set of parameters prompting for unique input to your ArcGIS Enterprise organization.

The configure.sh script does the following:

  • Verifies valid parameters in the configure.properties file
  • Creates a storage JSON based on provided storage properties found in the configure.properties file
  • Creates an ArcGIS Enterprise organization

To run the script, do the following:

  1. On your Kubernetes client machine, open a terminal as an administrator.
  2. Navigate to <ArcGIS Enterprise on Kubernetes install directory>/tools/configure.
  3. Open the configure.properties file.
  4. Provide values for each parameter listed in the file. The file is divided into the following sections:
    • Architecture profile
    • Organization
    • License
    • Administrator account
    • Storage
  5. Save the file. If desired, you can rename the file.
  6. In the terminal, run the configuration script using the following command format:
    ./configure.sh [options] -f <user_properties>
    

The contents of <user properties> are derived from the configure.properties file.

Once you've run the script, you'll be presented with a summary of configuration details and asked if you wish to continue.

  • If you specify y for yes, the script proceeds and creates an organization. This is the default input the script assumes.
  • If you specify n for no, the script immediately exits and does not create an organization.