Skip To Content

Utility network dataset administration

After a utility network is created and configured in a geodatabase, administration tasks are necessary, depending on your organizational needs. Dataset administration tasks for a utility network can include the need to migrate the dataset between geodatabases, upgrade, or update the portal utility network owner. It is also important to be aware of the supported compatibility between ArcGIS clients and geodatabase datasets, such as a utility network.

Migrate a utility network dataset

Once a utility network is created and configured, there are data management tasks that may require migration. Migration of a utility network dataset and its related feature classes may be needed to transfer data between enterprise geodatabases or to stage a test environment. The Utility Network Package Tools toolbox can be used to migrate a utility network. An asset package can be created from an established utility network and applied against a staged utility network created in another geodatabase. Asset packages support cross-database platform use. To import data into a utility network, the core Append tool can be used.

Note:
The utility network dataset does not currently support migration between geodatabases using core data transfer tools such as copy in ArcGIS Pro.

Upgrade a utility network

A utility network dataset must be upgraded to take advantage of new functionality by applying schema changes in the information model. The ArcGIS Pro client release version determines if an upgrade is necessary. To upgrade a utility network dataset, use the Upgrade Dataset tool. Before the upgrade is attempted, however, the following requirements must be met:

  • The geodatabase must be upgraded to the latest version.
  • An exclusive lock must be obtained; any active connections must be closed, including services.
  • The Dataset to upgrade value must be from a database connection established as the database utility network owner.
  • The connected ArcGIS Enterprise portal account must be the portal utility network owner.
  • The network topology must be disabled.

After the utility network dataset is upgraded, the utility network release can be viewed in the general section of the network properties.

To review the details of the upgrade operation, see Utility network upgrade history.

Update the portal utility network owner

Due to its service-based architecture, a utility network dataset has two owners that are used to control access for administrative tasks. In addition to the database user that creates a utility network, the active portal user account is recorded as the portal dataset owner. When a utility network is created, these owners are determined based on the user accounts for the database connection and active ArcGIS Enterprise portal.

While the data owner (database user) cannot be updated without re-creating the data, the portal dataset owner can be updated for a utility network. If the existing portal dataset owner leaves the organization, it is necessary to change the portal owner to another user. This user should comply with the same user type and privilege as the original owner. Reference the Update Portal Dataset Owner tool.

After the portal owner is updated for the dataset, it is also necessary to change item ownership for any existing portal items for map image and feature layers.

Learn more about how to manage content

ArcGIS platform compatibility

As an administrator, it is important to be aware of the compatibility between ArcGIS clients, the geodatabase, and utility network dataset when working with mixed releases. Since the utility network follows a web GIS model, it is dependent on both the ArcGIS Pro and ArcGIS Enterprise client versions to enable new functionality.

Learn more about client and geodatabase compatibility

When a utility network is created, the version of ArcGIS Pro is recorded in the network properties in the General section for the Created with ArcGIS Pro Release property. The Utility Network Release value is determined by the version of ArcGIS Pro used to create or upgrade a utility network dataset.

Utility Network Properties

As geodatabases and client software are designed to work together, it is recommended to keep these versions in sync when possible. As a general rule for working with mixed releases, ArcGIS client applications (such as ArcGIS Pro and ArcGIS Enterprise) are backward compatible when working with the utility network:

  • Later versions of ArcGIS Enterprise can share earlier versions of the utility network
  • Later versions of ArcGIS Pro can be used to view and edit earlier versions of the utility network
This also means that earlier client software releases cannot open utility network datasets that participate in newer functionality. For example, ArcGIS Enterprise 10.6 cannot be used for sharing a utility network that has a Utility Network Release 2.

The following table outlines the ArcGIS platform compatibility for a utility network:

  • ArcGIS Pro release—The version used to create or upgrade a utility network. This determines the Utility Network Release value.
  • Utility Network Release—The release version of a utility network dataset.
  • ArcGIS Enterprise release—The version of ArcGIS Enterprise to which the utility network can be shared.

ArcGIS Pro releaseUtility Network ReleaseArcGIS Enterprise release

2.1

1

10.6 and later

2.2

2

10.6.1 and later

2.3

2

10.6.1 and later

2.4

3

10.7 and later

ArcGIS platform compatibility for a utility network