Skip to main content

Configure an ArcGIS Reality Server site

For members of your organization to use reality service tools in ArcGIS Enterprise, you must set up a base ArcGIS Enterprise deployment, an image hosting server, a reality server, and raster store. Reality Server license includes the "image basic" license that allows creation/sharing of image services, so reality server and image hosting server functionality can be combined on the Reality Server site. However, we recommend separating distributed reality server and image service hosting roles for better resource allocation and performance.

Review the best practices for setting up a reality server

The following instructions may require changes to the way you've deployed ArcGIS in your organization; review them carefully before proceeding.

  1. If you do not already have a base ArcGIS Enterprise deployment configured, set one up.

    See Tutorial: Set up a base ArcGIS Enterprise deployment for more details.

  2. Set up a second ArcGIS Server site by installing ArcGIS Server on one or more machines. License this site with both ArcGIS Server license (Standard or Advanced) and Reality Server license.

  3. Begin configuring ArcGIS Reality Server by signing in to ArcGIS Server Manager and browse to Site > Data Stores.

  4. Register a raster data store with ArcGIS Reality Server.

    Reality services store processed rasters in a data store, referred to as raster store. This can be either of the following:

    • Cloud store with enterprise geodatabase types of raster store—In this configuration, the analysis output will be stored in the cloud raster store and the mosaic dataset will be stored in the enterprise geodatabase raster store.

      Tip:

      This type of configuration is recommended for better scalability for hosted imagery layers.

    • File share type of raster data store—In this configuration, both the analysis output and the mosaic dataset will be stored at the file share raster store.

    • Cloud store with file share type of raster data store—In this configuration, the analysis output will be stored at the cloud raster store and the mosaic dataset will be stored at the file share raster store.

    Important:

    Additional steps are needed to set up the file share raster store for Reality Server on Linux.

  5. Sign in to the portal as a member with administrative privileges.

    The URL is in the format https://webadaptorhost.domain.com/<webadaptorname>/home.

  6. Browse to Organization > Settings > Servers.

  7. Federate your Reality Server site with your portal.

    Important:

    All ArcGIS Reality Server sites that are federated with the ArcGIS Enterprise deployment must match the version of the ArcGIS Enterprise deployment.

  8. Configure Reality Server role.

    • Sign in to the Portal Admin Directory as an administrator https://webadaptorhost.domain.com/<webadaptorname>/portaladmin.

    • Navigate to: Federation > Servers.

    • Click on the Reality Server.

    • Click update.

    • In the Server function field, enter Reality Server

    • Click Update Server to apply the change.

    Configure Reality Server role in Portal Admin

  9. Optionally, install the Reality Server runtime to use ArcGIS API for Python as a client for accessing ArcGIS Reality Server tools.