Install ArcGIS Urban

ArcGIS Urban on ArcGIS Enterprise 11.3 is supported on Windows and Linux operating systems.

Install ArcGIS Urban on Microsoft Windows

The following section explains how to install Urban on a Windows machine.

Note:

Run all the commands listed in this section using the Run as administrator option in PowerShell.

Prerequisites

Before installing Urban, ensure that the following prerequisites are met:

  • Verify your environment meets the minimum system requirements.
  • Prior to installing ArcGIS Urban, you must install ArcGIS Enterprise as a base deployment.
  • You must use a Windows Active Directory account to install ArcGIS Enterprise and ArcGIS Urban. The installation will not succeed if you use a Local User account.
  • You must install ArcGIS Urban on the machine where Portal for ArcGIS is installed.
  • You can access and use a system account user with administrative-level access.
  • Ensure that the Web Styles component is installed with ArcGIS Enterprise. See Portal for ArcGIS Web Styles installation for details.
Note:

ArcGIS Urban is currently not supported in the following Portal for ArcGIS setups:

  • Portal for ArcGIS installations that use public key infrastructure (PKI)-based client certificate authentication.
  • Portal for ArcGIS installations that use Lightweight Directory Access Protocol (LDAP) to secure portal access.
  • Portal for ArcGIS installations that use Integrated Windows Authentication (IWA) to secure portal access.
  • Disconnected deployments of ArcGIS Enterprise.

Enable containerization on Windows

To enable containerization on Windows, complete the following steps:

  1. Open PowerShell or the Server Management UI and enable the Container feature.
  2. Restart your machine.

Install Docker

To install Docker on Windows, complete the following steps:

Note:

Use the Docker command line. Do not use Docker Desktop.

  1. Download the Docker runtime and CLI binaries from the official Docker website.  It is recommended that you download the latest available patch for Docker version 24.

    The downloaded zip file containing Docker runtime and CLI binaries is available on your disk.

  2. Create the following directory: C:\Program Files\docker.
  3. Move and extract the downloaded zip file to the location created in the previous step. 

    The following files are available: dockerd.exe, docker.exe, and docker-proxy.exe.

  4. Include the Docker installation location to the systemwide path environment variables.
  5. Restart your machine.

    The new environment variable is picked up.

  6. Open PowerShell and go to the Docker installation location.
  7. Register the Docker service by running the following command: dockerd.exe --register-service.
  8. Start the Dockerservice by running the following command: Start-Service docker.
  9. Ensure that the service is running by running the following command: Get-Service docker.

    The returned service status is Running.

  10. Check whether the set up was successful by running the following command: docker run --rm hello-world.

    The resulting message indicates that the Docker installation appears to be working correctly.

Configure access to Docker

To configure access to Docker for the Portal for ArcGIS system account, complete the following steps:

  1. Create a local user group on the Windows machine called docker-users.
  2. Add the account that is running the Portal for ArcGIS service to the docker-users group.
  3. Check whether the following JSON file exists: C:\ProgramData\docker\config\daemon.json

     If the location and the file do not exist, create it.

  4. Add the following line to the deamon.json file: { "group" : "docker-users" }

Install Urban

To install Urban, do the following:

Run the ArcGIS Urban installer. No additional configuration is required during installation.

Install ArcGIS Urban on Linux

The following section explains how to install Urban on a Linux machine.

Prerequisites

Before installing Urban on ArcGIS Enterprise 11.3, ensure that the following prerequisites are met:

Install Docker

To install Docker on Linux, complete the following steps:

  1. Ensure that Docker is available on your Linux distribution. If Docker is not available, continue with the substeps:
    1. Install Podman by following the instructions on the official Podman website.
    2. Add the following alias: alias docker="podman".
  2. Use your package manager to install the Docker package.
  3. Ensure that Docker is started as a service by running the following command: systemctl status docker.
  4. If Docker is not enabled, enable it by running the following commands: sudo systemctl enable docker and sudo systemctl start docker.

Configure access to Docker

To configure access to Docker for the Portal for ArcGIS system account, do the following:

Add the account that is running the Portal for ArcGIS service to the Docker user group.

Install Urban

To install Urban, do the following:

Run the ArcGIS Urban installer. No additional configuration is required during installation.