1. Learn
  2. Geographic Information Systems (GIS)
  3. GIS Tutorials/How-Tos
  4. Installing ArcGIS Linux Portal on AWS

Installing ArcGIS Linux Portal on AWS

This Esri installation instruction has some missing or wrong information. For example, the setup program is located at /arcgis/portal if you install it from AWS Marketplace. Shell script argument is -lf, not -la for listadministratorusertypes.sh.

Step-by-step guide

  1. cd /arcgis/portal/tools/createportal
  2. edit createportal.properties and fill in the property values such as PORTAL_ADMIN_USERNAME, PORTAL_ADMIN_PASSWORD, and PORTAL_LICENSE_FILE.
  3. The 'password' field can only have the numbers 0-9, the ASCII letters a-z, A-Z and the dot character (.).
  4. POTAL_CONTENT_DIRECTORY cannot be empty. Enter /arcgis/portal/usr/arcgisportal/.
  5. PORTAL_USER_TYPE_ID is mysterious. Use creatorUT based on the license json file.
  6. Run /arcgis/portal/startportal.sh
  7. Run ./createportal.sh -f createportal.properties
  8. Unable to connect to https://URL. Check the URL and restart the portal if necessary.
    Exiting the createportal utility.
  9. The above command will encrypt password in creatportal.properties. It takes a long time so please be patient. At the end, it will show the following output:
  10. ==================================================
    Starting the createportal utility.
    Checking if the portal is initialized.
    The portal is not initialized.
    Configuring the portal.
    The portal is created successfully.
    Waiting for the portal to restart.
    Populating the portal license.
    You may access the portal by navigating to:
    The createportal utility completed successfully.
    Stopping the createportal utility.
  11. Run./listadministratorusertypes.sh -lf /home/arcgis/ArcGIS_Enterprise_Portal_107_283791_20190814.json. You'll get the following output.
  12. ==================================================
    Starting the listadministratorusertypes utility.
    Checking if the portal is initialized.
    Checking if the portal is configured.
    The portal has already been configured.
    You may access the portal by navigating to:
    Stopping the listadministratorusertypes utility.
  13. Open a web browser and connects to the server URL using public IP. Portal redirects to internal IP address, which is not accessible from outside.
  14. Install firefox from super user. #apt install firefox.
  15. sudo apt-get install dbus-x11
  16. ssh -Y to the server to establish Xwindow session.
  17. Run firefox with the internal URL.
  18. ArcGIS Portal Firefox

  19. Login with the username and password that you specified in createportal.properties.
  20. ArcGIS Portal After Login

  21. Open the (arcgis portal URL) in Firefox.
  22. Click System > Properties to allow the portal access using public DNS entry.
  23. Update Properties using JSON after entering the DNS information (WebContextURL is required):
  24. ArcGIS Portal System Properties

  25. Open web browser from your machine and enter (arcgis portal URL). You should be able to access portal.
  26. You can put portal behind load balancer with AWS certificate manager. Target group should use HTTP1. In that case, change WebContextURL to load balancer listener name like (arcgis portal URL). Path based forwarding rule will (e.g., /portal/ forwards to 7443) not work since both server and portal uses /arcgis as context.
  27. ArcGIS Portal Load Balancer

  28. If you don't want to specify port 7443, one possibility is to have create another load balancer with a different DNS entry like arcgis-p.gisdemo.net.
  29. It is OK to use load balancer URL for System Properties in Step 14.
  30. Check /arcgis/portal/usr/arcgisportal/logs for any error log.
  31. Federate with ArcGIS Server.
  32. Federation Data Store Is Not Registered

  33. If you federate Portal with Server, accessing server admin page redirects to Portal. Use Portal username and password to login server manager page.
  34. Become root and run # systemctl enable arcgisportal.service
  35. If you run portal on different machine from datastore server, become root and disable datastore service. This will lower system load.
    1. systemctl disable arcgisdatastore.service

Running Multiple Portals

It is OK to run multiple portals with the same license.

Page Last Updated: Jul 9, 2021 at 9:44 PM EDT