English

How To: Determine the proper heap size setting for large trace results in an enterprise deployment of the utility network

Summary

The heap size setting controls the maximum payload that can be traversed by the client, it is set at the service level.  This is important to be aware of when working with ArcGIS Pro in an enterprise deployment of the utility network and executing a trace operation that traverses a large number of features.
Network errors such as the following can be encountered if the payload of a trace operation is larger than what can be accommodated by the default heap size of 64 MB.

“Error 16023: A networking error occurred.”

Procedure

Review the topic Geoprocessing service setting: Advanced properties for information on how to update the heap size setting for a utility network service.

To determine the proper heap size setting for a utility network service needed to estimate the total number of junction and edge elements traversed by a trace, consider the following:

  • The default payload size of a trace without results is ~750 bytes
  • Each additional junction element introduces ~150 bytes
  • Each additional edge element introduces ~175 bytes

The following baselines can be used to estimate the proper heap size setting for a utility network service.

  • 64 MB (default) should be sufficient to return ~200,000 edge elements and ~200,000  junction elements.
  • 128 MB should be sufficient to return ~400,000 edge elements and ~400,000 junction elements.
  • 256 MB should be sufficient to return ~800,000 edge elements and ~800,000 junction elements.

It is important to understand that the existence of midspan connectivity along a line creates multiple edge elements for a single feature.  

  • For example, an edge feature with nine midspan junctions consists of ten edge elements, requiring 2500 bytes: 750 + 10 * 175 = 2500.
  • Similarly, terminal devices return a junction element for each terminal defined.

Related Information

Last Published: 5/4/2021

Article ID: 000025326

Software: ArcGIS Pro 2.7.3, 2.7.2, 2.7.1, 2.7, 2.6.5, 2.6.4, 2.6.3, 2.6.2, 2.6.1, 2.6, 2.5.2, 2.5.1, 2.5