Installing ArcGIS Linux Portal on AWS

GIS How-To for 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. POTAL_CONTENT_DIRECTORY cannot be empty. Enter /arcgis/portal/usr/arcgisportal/.
  4. PORTAL_USER_TYPE_ID is mysterious. Use creatorUT based on the license json file.
  5. Run /arcgis/portal/startportal.sh
  6. Run ./createportal.sh -f createportal.properties
  7. 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:
  8. Run./listadministratorusertypes.sh -lf /home/arcgis/ArcGIS_Enterprise_Portal_107_283791_20190814.json. You'll get the following output.
  9. 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.
  10. Install firefox from super user. #apt install firefox.
  11. sudo apt-get install dbus-x11
  12. ssh -Y to the server to establish Xwindow session.
  13. Run firefox with the internal URL.
  14. Login with the username and password that you specified in createportal.properties.
  15. Open the (arcgis portal URL) in Firefox.
  16. Click System > Properties to allow the portal access using public DNS entry.
  17. Update Properties using JSON after entering the DNS information (WebContextURL is required):
  18. Open web browser from your machine and enter (arcgis portal URL). You should be able to access portal.
  19. 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.
  20. 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.
  21. It is OK to use load balancer URL for System Properties in Step 14.
  22. Check /arcgis/portal/usr/arcgisportal/logs for any error log.
  23. Federate with ArcGIS Server.
  24. If you federate Portal with Server, accessing server admin page redirects to Portal. Use Portal username and password to login server manager page.
  25. Become root and run # systemctl enable arcgisportal.service
  26. 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.

Last Updated