Skip To Content

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 need to install ArcGIS Enterprise as a base deployment.
  • 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.

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 to 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 system-wide 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 if the set up was successful by running the following command: docker run --rm hello-world.

    The resulting message indicates that 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 if 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, complete the following steps:

  1. 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:

  • Verify your environment meets the minimum system requirements.
  • Prior to installing ArcGIS Urban, you need to install ArcGIS Enterprise as a base deployment.
  • You must install ArcGIS Urban on the machine where Portal for ArcGIS is installed.

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 sub-steps:
    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, complete the following steps:

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

Install Urban

To install Urban, complete the following steps:

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