Skip To Content

Publish the elevation geoprocessing services on ArcGIS for Server

If you want to create elevation profiles from the world elevation data, you need to publish the Elevation and ElevationSync geoprocessing services on ArcGIS 10.3 for Server or later with an Advanced license. You also must have either an ArcGIS 10.3 for Desktop or later Standard or Advanced license. Before publishing the services, you must repair the data paths of the source mosaic datasets to point to the Data Appliance path in your network.

Repair the paths to the image files referenced by the source mosaic datasets

When Data Appliance for ArcGIS is deployed in your network, the paths to the image files are changed, and the source mosaic datasets need to be repaired so that the new paths are used. The mosaic datasets consumed by the elevation geoprocessing services are found in the following file geodatabase:

\\<server-ip>\source_documents\data\WorldElevation\ElevationGP\MD\ElevationGP.gdb

where <server-ip> is the network IP or server name of the data appliance. You need ArcGIS for Desktop Standard or Advanced to perform this task.

List of available mosaic dataset names

The dataset names that begin with D_ are derived mosaic datasets. The dataset names that begin with R_ are referenced mosaic datasets. Derived mosaic datasets are used to merge multiple source mosaic datasets, primarily to enable different collections of imagery to be accessed via one source. A referenced mosaic dataset is a new mosaic dataset that references an existing mosaic dataset but can redefine some properties and also include additional functions such as Hillshade.

Repair the paths for the derived mosaic datasets

  1. Open the Catalog window in ArcMap, and browse to the file geodatabase (ElevationGP.gdb) that stores all the mosaic datasets used by the elevation services.
  2. In the Catalog window, right-click the D_DTM_30m mosaic dataset and click Modify > Repair.
  3. Cancel the search operation.

    The Repair Mosaic Dataset dialog box appears.

  4. Change the Folder Paths Depth setting to 1 and press Enter.
  5. In the Paths List, the Old Path column shows V:, which is the original path that needs to be repaired. For the New Path, insert the UNC path for the data appliance in the form of \\<server-ip>\source_documents\data, where <server-ip> is the network IP or server name of the data appliance. See the following for an example:

    Repair Mosaic Dataset window showing Folder Paths Depth, Old Path, and New Path

  6. Click OK to apply the changes.
  7. Repeat steps 1 through 6 for D_NED13_GEBCO_ZERO and D_SRTM_GEBCO_ZERO to repair their paths.

Repair the paths for the referenced mosaic datasets

  1. Open the Catalog window in ArcMap, and browse to the file geodatabase (ElevationGP.gdb) that stores all the mosaic datasets used by the elevation services.
  2. In the Catalog window, right-click R_1000m_GEBCO and click Modify > Repair.

    The Repair Mosaic Dataset Paths dialog box appears. In the Paths List, the Original Path column shows V:, which is the original path that needs to be repaired.

  3. Copy the path from Original Path and paste it to New Path, and replace the V: drive letter using \\<server-ip>\source_documents\data in New Path, where <server-ip> is the network IP or server name of the data appliance, for example, \\<server-ip>\source_documents\data\WorldElevation\ElevationGP\MD\ElevationGP.gdb\D_SRTM_GEBCO_ZERO.

    Repair Mosaic Dataset Paths window showing Original Path and New Path

    Note:

    The R_10m_GEBCO dataset references D_NED13_GEBCO_ZERO, the R_30m_GEBCO dataset references D_DTM_30m, and both the R_90m_GEBCO and R_1000m_GEBCO datasets reference D_SRTM_GEBCO_ZERO.

  4. Click OK to apply the changes.
  5. Repeat steps 1 through 4 for R_10m_GEBCO, R_30m_GEBCO, and R_90m_GEBCO to repair their paths.

Create the data source map document

  1. Open ArcMap as a blank document.
  2. In the Catalog window, browse to \\<server-ip>\source_documents\data\WorldElevation\ElevationGP\Layers, where <server-ip> is the network IP or server name of the data appliance. Drag the following two layers to ArcMap:
    • footprints103090_credit.lyr
    • footprints103090prf.lyr
    Note:

    When you perform this step (and the next step), make sure you drag the layers or datasets from a full UNC path, and do not use any mapped network drive. If the map document contains any mapped network drive letter in the data source paths, it may cause problems for the geoprocessing services. The best practice is to disconnect any mapped network drives before you perform these steps and reconnect them after you are done setting up the geoprocessing services.

  3. Browse to the elevation tools source data file geodatabase: \\<server-ip>\source_documents\data\WorldElevation\ElevationGP\MD\ElevationGP.gdb, where <server-ip> is the network IP or server name of the data appliance. Drag the following referenced mosaic datasets to ArcMap:
    • R_1000m_GEBCO
    • R_10m_GEBCO
    • R_30m_GEBCO
    • R_90m_GEBCO

    If a Geographic Coordinate System Warning message appears during this process, click the Close button to close the dialog box and ignore the message. After this step, the ArcMap table of contents should look similar to the following:

    ArcMap table of contents listing layers and tools

  4. Click the ArcMap Save button to save the map document as ElevationGP.mxd to a local folder (for example, in the folder C:\temp), and close ArcMap.
  5. Open Windows Explorer and copy ElevationGP.mxd from your local machine to the following location: \\<server-ip>\source_documents\data\WorldElevation\ElevationGP\MapDocuments, where <server-ip> is the network IP or server name of the data appliance.

Publish the elevation geoprocessing services

The elevation geoprocessing services are created by publishing their service definition files to ArcGIS for Server using ArcGIS Server Manager.

  1. Open ArcGIS Server Manager and sign in.
  2. Click Services > Manage Services > Publish Service.
  3. Browse to source_documents > service_definitions on the Data Appliance data collection, for example, \\ARCGISDATAAPP\source_documents\service_definitions.

    The following two service definition files for the elevation geoprocessing services are in this folder:

    • Elevation_GP_Sync.sd
    • Elevation_GP_Async.sd

    Elevation_GP_Sync.sd is for publishing a synchronous elevation geoprocessing service, and Elevation_GP_Async.sd is for publishing an asynchronous elevation geoprocessing service.

  4. Select the service definition for the synchronous elevation geoprocessing service, Elevation_GP_Sync.sd, and click Open.
  5. Click Next.
  6. Accept the default service name in the Publish Service window. Accept the default folder to publish the service to the site root folder.

    Publish service window for ElevationSync service

  7. Click Next.
  8. Optionally, choose the GIS server cluster that will host the published service definition. To learn more, see About GIS server clusters for Windows.
  9. Click Publish to publish the service definition as a service.
  10. Repeat steps 2 through 9 to publish the Elevation_GP_Async.sd file to ArcGIS for Server as a geoprocessing service.

The new Elevation and ElevationSync geoprocessing services appear in the list of available services under the root folder.

Add a mapFile property to the geoprocessing service properties

The new geoprocessing service needs to be associated with a map document that contains all the source data layers to function properly. This is done by adding a mapFile property to its service properties.

  1. Sign in to the ArcGIS Server Administrator Directory using the URL http://<server name>:6080/arcgis/admin.

    ArcGIS Server Administrator Directory

  2. Click services to view the available services under the root folder.
  3. Click the ElevationSync geoprocessing services that you published to this folder.

    This takes you to the service properties page.

    ArcGIS Server Administrator Directory

  4. Scroll down to the bottom of the page and click Edit.
  5. On the Edit GPServer page, scroll down and locate the properties section.
  6. Append a comma (,) after the maximumRecords line in the properties section, and press Enter to begin a new line.
  7. Add a mapFile property to the new line. The mapFile property points to the data source map document (ElevationGP.mxd) that you created earlier, which is available in the following data appliance folder: \\<server-ip>\source_documents\data\WorldElevation\ElevationGP\MapDocuments\ElevationGP.mxd, where <server-ip> is the network IP or server name of the data appliance.

    The following is an example of the text to insert:

    "mapFile": "\\\\ARCGISDATAAPP\\source_documents\\data\\WorldElevation\\ElevationGP\\MapDocuments\\ElevationGP.mxd"

    Notice that two backslashes are used to separate folders from subfolders.

    Edit GPServer with highlighted text example

  8. Click Save Edits to save and restart the geoprocessing service.
  9. Repeat steps 3 through 8 for the Elevation asynchronous geoprocessing service to set up the mapFile property.