Is there a Trick to Installing ArcGIS Urban on Enterprise Portal 11.5

[JohnRitsko1]

I'm trying to install ArcGIS Urban on my Enterprise Portal 11.5 Windows 2022 Server machine.  I've done every single step ESRI states and everything seems to be on track with installing docker, creating the group, etc. etc.  However, when I get done with all the steps ESRI states to just install ArcGIS-Urban so I simply run the exe as Administrator and then afterwards, no joy!   I'm getting the http.500: Failed to route request error shown here https://doc.arcgis.com/en/urban/11.5/get-started/get-started-enterprise-faq.htm#anchor2 .  However, this does "NOTHING" to help resolve why I'm seeing it.  Question: Is there something prior to running this install (ArcGIS_URBAN 11.5) that I'm supposed to do with docker that ESRI fails to mention?  I'm using docker version Docker version 27.5.1, build 9f9e405.  

[DominikAllemann]

Hi  @JohnRitsko1 ,

I'm sorry to hear that you are experiencing issues with installing Urban on Enterprise Portal 11.5.

Based on your post, it appears that you have already thoroughly followed the instructions outlined in the "Install ArcGIS Urban on Windows" user guide. If you are working with a multi-machine deployment, please ensure that ArcGIS Urban & Docker are installed on the same machine where Portal for ArcGIS is installed.

To further narrow down the issue, can you please check the following:

• Is Docker installed correctly? To check for that, please run the command below in a console (run as administrator):

docker run --rm hello-world

•  If yes to the above, is the ArcGIS Urban Docker container available? Check that by running the following command in a console, and check if an image called "arcgis-urban" gets listed:
  

docker image ls --all

•  If yes to the above, please verify that the arcgis-urban container is running. To do that, please run the following command in a console:

docker container ls --all​

This command will list all Docker containers available on your machine, including their status (running, stopped, or exited)

Please feel free to DM me screenshots of the outputs from the commands above.

I'm sure we'll get Urban running on your Enterprise 11.5 portal soon.

Thanks,

Dominik

[JohnRitsko1]

Dominik,

  Thank you so much for the reply.  Yes, I have followed ESRI's install to the letter, yes multi machine environment with Urban going on our ArcGIS Portal machine.  Had a call yesterday with ESRI as well to try and figure this out but our time ran out after 45 minutes so we couldn't continue so I figure worth a shot posting in community to see if others have run into this before.

Before I rant on what I've done and answer your questions I did have a question about docker.  ESRI documentation states "Download the Docker runtime and CLI binaries from the Docker website".  There is no CLI (Command LIne Interface) link only the link to docker to get the (docker, dockerd) executables in the zip  file from the link provided by ESRI.  If there is some assumption that I know how to find this CLI libraries file I think I missed how and where to get this installed.  I only downloaded the docker-27.5.1.zip file, which is missing the docker-proxy.exe file that ESRI says should be in there.  I tried version 28.0.0 but that didn't work either.  Anyway, if there is another file for this CLI then I'm missing that and perhaps that's my issue.

• Is Docker installed correctly? To check for that, please run the command below in a console (run as administrator):  YES, and I get the following:
  • Hello from Docker!
    This message shows that your installation appears to be working correctly. etc. etc.
•  If yes to the above, is the ArcGIS Urban Docker container available? Check that by running the following command in a console, and check if an image called "arcgis-urban" gets listed:
  • No arcgis-urban is listed.  In the documentation "NOTHING" states to how to fix this part if it's not listed, other than I'm guessing to run through all the steps again, which doesn't work.  Ports were configured as well per instructions as well.  Am I supposed to create a container for it?
  • REPOSITORY TAG IMAGE ID CREATED SIZE
    hello-world latest c16a0562ffc0 12 days ago 297MB
    hello-world nanoserver c16a0562ffc0 12 days ago 297MB
•  If yes to the above, please verify that the arcgis-urban container is running. To do that, please run the following command in a console:
  • CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
    • Nothing further is shown. 

I'd rather post in here in case others ever run into this issue as well.  After installing docker and setting up the local group and adding the c:\Program Files\docker to the PATCH in environmental variables I'm not sure what else could be going on so I very much appreciate any input.

For some context I also installed the Web Styles for Windows 11.5 prior to Urban.

ESRI states to enable the container feature but doesn't provide the commands so this is what I ran:

Install-WindowsFeature -Name Containers

• Success Restart Needed Exit Code Feature Result
  ------- -------------- --------- --------------
  True No NoChangeNeeded {}

Added the "C:\Program Files\docker" to the Path in Environmental Variables.

Created the docker-users AS A LOCAL GROUP.

• Added the User that is running ArcGIS Portal to the group.

Docker Version

• PS C:\program files\docker> docker --version
  Docker version 27.5.1, build 9f9e405

Then I simply run the executable for Urban as Administrator and then get the error shown above.  I just feel like I'm missing one simple step somewhere in this process.  Thank you all for the input.

[DominikAllemann]

Hi @JohnRitsko1 

Thank you very much for sharing all those details. 

Re your question about CLI binaries & the missing "docker-proxy.exe"
I will double-check with one of our developers to verify if there's something missing in the downloaded zips accessible from the link in the documentation, or if the documentation would need to be adapted. 

Re your comment about the FAQ section
Thanks for your input. I agree that it would be beneficial if the documentation states what to do if the "arcgis-urban" image/the "arcgis-urban" container is not listed. We will review how to improve that part of the documentation to add more value to our customers. 

Re getting Urban on your server running
From afar, it's difficult to determine exactly what didn't go as it should have. To avoid re-installing the entire system, I suggest trying to load the "arcgis-urban" image manually into Docker. 

You can complete the following steps to achieve that:

• Sign in to the server using the account that also runs the Portal service. 
• Locate the file called "urban.tar" (this is the Docker image for Urban; it might be suffixed with the Windows Server version e.g. "urban2022.tar"). On Windows servers, it's usually located at "C:\Program Files\ArcGIS\Portal\framework\etc\urban"
• Open PowerShell as administrator and navigate to the folder of "urban.tar".
• Load the image using the command below:
  

docker load -i urban.tar

Loading the image can take a while on Windows Servers (usually anything between 15mins and 30mins)

• Verify if the image was loaded successfully by running the command below:

docker image ls​

Once the image is available, it will be picked up by the "Portal service" which will create a container out of it. This might take another couple of minutes. Consider restarting the portal service manually to speed things up a bit. 

• Double-check for the creation of the "arcigs-urban" container by running the following command:

docker container ls --all​

The "arcgis-urban" container should now be listed and you can access ArcGIS Urban from the Enterprise Portal.

Please don't hesitate to reach out if you have any further questions. 
Thanks, 
Dominik

[JohnRitsko1]

Argh, looks like found my issue wasn't using a domain account from AD to install Portal and as such I would venture a guess this is causing most if not all my issues.

[JohnRitsko1]

Well that hasn't solved my problem.  arcgis-urban shows up but still no joy.  I had to run the "RUN" command to create the container for the arcgis-urban image.  S

PS C:\Program Files\ArcGIS\Portal\framework\etc\urban> docker image ls
REPOSITORY TAG IMAGE ID CREATED SIZE
hello-world latest c16a0562ffc0 13 days ago 297MB
arcgis-urban latest 0ae93cb10049 6 months ago 832MB

PS C:\Program Files\ArcGIS\Portal\framework\etc\urban> docker container ls --all
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
419df04c51d4 arcgis-urban "node dist/app/src/s…" 3 minutes ago Exited (1) 2 minutes ago objective_heisenberg

PS C:\Program Files\ArcGIS\Portal\framework\etc\urban> docker run arcgis-urban
preventAutoInstrumentationFor => {}
info: 🔓 Using insecure HTTP for hosting...
error: Fatal exception when starting HTTP server: Error: Unable to start Urban: URBAN_API_PORTAL_URL is not defined.

[DominikAllemann]

Hi @JohnRitsko1 

Could you locate the file called "urban.env" on your server, open it with a text editor, and share its content via DM (as it contains information that you may not want to share with the entire world-wide-web)?

Thanks,
Dominik