Install ArcGIS Linux Data Store

Setting Data Store is essential for making Notebook server work.

Step-by-Step Guide

  • Login Esri download website using NASA account.
  • Click My Organizations.
  • Click Downloads.
  • Select ArcGIS Enterprise (Linux) 10.8.
  • Select and download ArcGIS Notebook Server (1.4G).
  • Select and download ArcGIS Notebook Docker Standard Image (2.5G).
  • Install Docker Engine CE.
  • Update role as hosting server.
    • ssh as ubuntu user and become root.
    • apt-get update
    • apt-get install apt-transport-https ca-certificates curl gnupg-agent software-properties-common
    • curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo apt-key add -
    • apt-key fingerprint 0EBFCD88
    • add-apt-repository "deb [arch=amd64] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable"
    • apt-get update
    • apt-get install docker-ce docker-ce-cli containerd.io
    • docker run hello-world
    • Hello from Docker!This message shows that your installation appears to be working correctly.
  • sudo usermod -aG docker arcgis
  • ssh as arcgis and run docker run hello-world. (Lgout and login back if you see permission denied error.)
  • Become root again. Run
    • systemctl stop docker.service
    • mkdir -p /data/docker
    • chmod 755 /var/lib/docker
    • mv /var/lib/docker /data/docker
    • ln -s /data/docker /var/lib/docker
    • systemctl start docker.service
  • tar zxvf ArcGIS_Notebook_Server_Linux_108_173012.tar.gz
  • cd NotebookServer_Linux/
  • Run X server on your machine (e.g., Xming). Then run ./Setup.
  • Accept agreement and specify installation folder.
Diagram
  • Use license file (.prvc) to activate license. Once installation is complete, you will get the following dialog box.
  • At the end, it will run Firefox and Firefox may crash. Let the installer exit and launch firefox https://localhost:11443/arcgis/configure.
  • On ssh terminal with arcgis user, run cd /arcgis/notebookserver/tools/postInstallUtility.
  • ./PostInstallUtility.sh -l /home/arcgis/ArcGIS_Notebook_Docker_Standard_108_172942.tar.gz
  • Checking Docker health:[OK] Loading Docker image: /home/arcgis/ArcGIS_Notebook_Docker_Standard_108_172942.tar.gz. Apr 03, 2020 8:43:31 PM com.esri.arcgis.turing.tools.PostInstallUtility loadDockerImage INFO: Loading Docker image: /home/arcgis/ArcGIS_Notebook_Docker_Standard_108_172942.tar.gz. Done. Successfully loaded Docker Image /home/arcgis/ArcGIS_Notebook_Docker_Standard_108_172942.tar.gz. Apr 03, 2020 8:45:37 PM com.esri.arcgis.turing.tools.PostInstallUtility loadDockerImage INFO: Done. Successfully loaded Docker Image /home/arcgis/ArcGIS_Notebook_Docker_Standard_108_172942.tar.gz.
  • Go back to Firefox window and enter username and password for notebook server administrator.
  • Press Finish at the end.
  • Remember admin URL and get ready for federation.
  • Become root and run cp /arcgis/notebookserver/framework/etc/scripts/agsnotebook.service /etc/systemd/system
  • systemctl enable agsnotebook.service
  • systemctl stop agsnotebook.service
  • systemctl start agsnotebook.service
  • Open port 11443 of the EC2 instance that runs Notebook Server.
  • Create load balancer with certificate, forward 443 traffic to the EC2 target with port11443 and add it to Route 53 DNS (e.g., argis-n-8.gisdemo.net).
  • Federate with the portal.
    • Use load balancer DNS name for service URL: https://arcgis-n-8.gisdemo.net/arcgis
    • Use server name for admin URL: https://arcgis-server-8.gisdemo.net:11443/arcgis
    • Select Notebook server from drop down menu. The new entry https://arcgis-n-8.gisdemo.net/arcgis will appear.
    • Press Save.
    • Test server by creating a new notebook from portal.

    Docker uses the /var directory as its local registry for container images. During the upgrade process for subsequent releases, new images will be copied to the /var directory as well. To avoid running out of disk space during future upgrades, ensure that the /var directory has at least 50 GB of disk space.