Publish the World Elevation services

The World Elevation services, Terrain and Terrain 3D image services, are available with most product options on Collections 1, 2, 3, 4, and 5. To use the Terrain and Terrain 3D services, you must publish the services on ArcGIS Server 10.9.1 or later with ArcGIS Image Server and ArcGIS Pro 2.9 or later with a Standard or Advanced license.

Note:

The Terrain service is not included with Collection 1.

Terrain

The components for setting up the Terrain image service are organized under the WorldElevation folder at \\<server-ip>\CollectionX_source_documents\data, where <server-ip> is the network IP or server name of the data appliance, and CollectionX is the collection where the World Elevation content is located: Collection2 (World Standard), Collection3 (World Advanced), Collection4 (North America Standard), or Collection5 (North America Advanced).

Note:

In the following steps, when the UNC path \\<server-ip>\CollectionX_source_documents\data is mentioned, <server-ip> denotes the network IP or server name of the data appliance, and CollectionX denotes the collection where the World Elevation content is located.

Prepare the Terrain content

The mosaic datasets and auxiliary files are prepared using the default path Y:\WorldElevation, which needs to be repaired based on the UNC path of the World Elevation content on ArcGIS Data Appliance.

Follow the steps below to repair the paths:

1. Start ArcGIS Pro. On the start page, under New Project, click Map, and provide a name for the project.
2. In Catalog pane, right-click Folders under the Project tab, and click Add Folder Connection. In the Add Folder Connection dialog, provide the UNC path of the WorldElevation folder, for example, \\<server-ip>\CollectionX_source_documents\data\WorldElevation.
3. Click OK.
4. Expand the the WorldElevation folder in the Catalog, and double-click the Repair mosaic dataset paths tool under WorldElevation.tbx .

   

   The Repair mosaic dataset paths dialog box appears.

5. In the GDB Full Path field, click browse and navigate to Folders - WorldElevation - MD - WorldElevation.gdb, and click OK.

   

The Old Path parameter is prepopulated with the default Y:; do not change it.
6. For the New Path, insert the UNC path, for example, \\<server-ip>\CollectionX_source_documents\data.

   

7. Click Run.

   The tool repairs paths for the S_EGM2008, D_HollandFix, R_WorldDTMHillshade and D_WorldDTM mosaic datasets.

   

8. In a text editor, open Terrain_ElevationTintedHillshade_HollandFix.rft.xml, located under .\WorldElevation\Parameter\RasterFunctionTemplates. Find and replace all occurrences of Y:\WorldElevation with the new path location, for example, \\<server-ip>\CollectionX_source_documents\data\WorldElevation, and save the changes.
9. Repeat the previous step for OrthometricToEllipsoidalHeightEGM2008.rft.xml, and save the changes.
10. From the Catalog window, browse to .\WorldElevation\MD\WorldElevation.gdb and expand the geodatabase. Drag the D_WorldDTM mosaic dataset to the Map window.

    It draws as elevation (DTM) for the whole world.

    

11. As a quick check, drag the R_WorldDTMHillshade mosaic dataset to the Map.

    You see the hillshade visualization of elevation.

    

Publish the Terrain image service

Once the mosaic dataset paths and raster function templates are fixed, the next step is to fix paths in the .json file that is used to publish the service.

1. In a text editor, browse to .\WorldElevation\Parameter\json and open Terrain.txt.
   1. Find and replace \\\\server-ip\\source_documents\\data with a UNC path, for example, \\\\user-server-ip\\CollectionX_source_documents\\data, where user-server-ip is the network IP or server name of the data appliance.

      Note:

      Ensure that the paths contain quadruple (\\\\) backslashes at the beginning of path and double backslashes (\\) afterward, otherwise the server throws an error during publishing.

      The paths for the mosaic dataset in "path": and the raster function templates in "rasterFunctions": update to the new path.

   2. Save the changes.
2. Open ArcGIS Server Manager (https://localhost:6443/arcgis/manager/index.html), and sign in with publisher or administrator credentials. Make sure ArcGIS Server has read permission on the WorldElevation folder and register the .\WorldElevation folder as Data Store.
   1. Click Site > GIS Server > Data Stores.
   2. Click the Register drop-down arrow and choose Folder.

      

   3. In the Register Folder window, fill out the Name and Publisher Folder Path. For Publisher Folder Path, provide the UNC path of the WorldElevation folder, for example, \\<server-ip>\CollectionX_source_documents\data\WorldElevation.
   4. For Publisher Folder Hostname, specify the machine that is hosting the publisher's folder. You can specify the machine name (for example, MyServer), fully qualified domain name (for example, MyServer.domain.com), IP address (for example, 12.34.56.789), or localhost (localhost).

      

   5. Click Create.

      This registers your folder with the server.

   6. Click the check box for the folder just registered, and click Validate.

      A green check mark under Status indicates that the UNC path is validated by the server.

      

3. Sign in to the ArcGIS Server Administrator Directory using the URL https://<server name>:6443/arcgis/admin.
   1. Click services to view the available services under the root folder.
   2. Click CreateService.

      

      The Create Service page appears.

   3. Copy and paste the contents of .\WorldElevation\Parameter\json\Terrain.txt into the Service (in JSON format) field.

      

   4. Click Create to complete the publishing of the Terrain service.

      The Terrain service is ready to use.

4. To use the Terrain service in ArcGIS Pro, follow these steps.
   1. In the ArcGIS Pro Catalog window, right-click New > New Server > New ArcGIS Server.

      

      The Add ArcGIS Server Connection window appears.

   2. Provide the Server URL, where the Terrain service was published and credentials (optional) to make the ArcGIS Server connection.

      A server connection is made.

   3. Drag the Terrain service to the Map from the recently made server connection in the catalog.
   4. By default, the service renders as an elevation (DTM) raster.
   5. From the Contents pane, right-click Terrain and click Properties > Processing Templates.
   6. From the Processing Template drop-down list, choose one of the functions defined on the service.

      

   7. Click OK.

      The Raster function dynamically renders the elevation derivative selected from the drop-down list.

   Note:

   Slope_Degrees, Slope_Degrees_Map, and Slope_Percent have known issues when published on ArcGIS Enterprise server 11.0 and 11.1. These functions do not return correct values or render correctly.

5. To use the Terrain service in ArcGIS Online Map Viewer, follow these steps.
   1. Go to the REST endpoint where the Terrain service is published, for example, http://localhost:6080/arcgis/rest/services/Terrain/ImageServer.
   2. Click ArcGIS Online Map Viewer.

      The Terrain service opens in Map Viewer Classic in a browser. By default, it renders as elevation (DTM).

   3. Click Terrain > More Options > Image Display > Renderer to choose from the server functions defined on the service.

      

      The Raster function dynamically renders the elevation derivative selected from the drop-down list.

Publish the Terrain 3D service

Follow the steps detailed under Publish basemap and reference layer services to publish the Terrain3D service on your ArcGIS Server installation.