Configure a multiuser environment

To use ArcGIS Pipeline Referencing in a multiuser environment, it must be published to an enterprise geodatabase. The following steps detail how to publish to an enterprise geodatabase to use a multiuser environment.

Set up an enterprise database

The following sections describe how to create an enterprise geodatabase and create the database connection files.

Sign in to ArcGIS Enterprise

If you have not added your portal connection to ArcGIS Pro, use the steps in the Use ArcGIS Pro with ArcGIS Enterprise help topic to sign in.

Create an enterprise geodatabase

Use the Create Enterprise Database tool to create an enterprise geodatabase to contain your Pipeline Referencing data.

1. In the Geoprocessing pane, expand Toolboxes, expand the Data Management Tools toolbox, and expand the Geodatabase Administration toolset. Click the Create Enterprise Geodatabase tool.
2. In the tool, set the following parameters:
   1. For Database Platform, select the database platform you will be using.
   2. For Instance, enter the instance connection information.
   3. For Database, specify a name of the database that will be created.
   4. For Username and Password, enter the credentials of a user who has privileges to create a database, or select Operating System Authentication if your Windows account has the appropriate permissions.
   5. For Authorization File, select the appropriate authorization file.
3. Click Run.

Create a database connection

Use the Create Database Connection tool to create a database connection to the enterprise geodatabase.

1. In the Geoprocessing pane, expand Toolboxes, expand the Data Management Tools toolbox, and expand the Workspace toolset. Click the Create Database Connection tool.
2. In the tool, set the following parameters:
   1. For Connection File Location, select a location to store the connection file. It is recommended that you use the project home folder.
   2. For Connection File Name, specify a name for the connection file. It is recommended that you use a format such as user@databasename.
   3. For Database Platform, select the database platform that is being used.
   4. For Instance/Server, enter the database connection information.
   5. For Username and Password, enter the credentials of the user that was used to create the enterprise database, and uncheck Database Authentication if using operating system authentication.
   6. For Database, select the database you created in the Create an enterprise geodatabase section above.

      Note:

      The Database parameter will populate the drop-down menu with databases that the user has access to after a valid username and password combination is entered. This user should be the schema owner.

   7. Expand Geodatabase Connection Properties. For Version Type, select Branch.
3. Click Run.

Copy the Pipeline Referencing configuration and data

This section walks you through copying the Pipeline Referencing configuration from a local geodatabase to an enterprise geodatabase.

Copy from a local geodatabase to an enterprise geodatabase

In the Configure Pipeline Referencing environment topic, you created a single-user geodatabase that contains your ArcGIS Pipeline Referencing configuration. In the following steps, you will use that geodatabase to load your data into the enterprise geodatabase that was prepared in previous steps.

1. Open the Catalog View by clicking Catalog View on the View tab.
2. Expand the Databases folder or the appropriate folder where you have stored your customized geodatabase that was created in the single-user configuration topic.
3. Double-click the geodatabase to list the contents.
4. Use Ctrl + A to select all contents, or create a partial selection by using the Ctrl key while clicking individual items to be copied.
The Pipeline Referencing configuration is in the feature dataset and will be selected and copied as part of that dataset.
5. Right-click the feature dataset containing the Pipeline Referencing configuration, and choose Copy.
6. In the same Catalog window, browse to the schema owner database connection file created in the previous section. Right-click the connection file and select Paste. All of your selected data will be copied to the enterprise geodatabase.

Post process

This section walks you through the post processing steps that are required prior to publishing the Pipeline Referencing feature service.

Note:

Closing maps improves performance. During geoprocessing, ArcGIS Pro will lock layers in the maps. For optimal performance, close all open maps, save your project, and restart ArcGIS Pro. The project will load without active maps. This will eliminate the need to lock layers when running the tools.

Set the versioning type

In previous steps, a database connection file was created and it was set to branch versioning. Ensure the database connection has Versioning Type set to Branch. If it does not, use the Update Geodatabase Connection Properties To Branch tool to update the versioning type.

1. In the Geoprocessing pane, expand Toolboxes, expand the Data Management Tools toolbox, and expand the Workspace toolset. Click the Update Geodatabase Connection Properties To Branch tool.
2. In the tool, set the following parameters:
   1. For Input Geodatabase Connection, select the connection file to update.
3. Click Run.

Note:

Alternatively, use the Catalog Pane or Catalog View, right-click the connection file and use the Geodatabase Connection Properties dialog box for the database connection to update Versioning Type to Branch.

Register as versioned

To support the Web GIS model, allowing multiuser editing scenarios and long transactions through feature services, the classes need to be registered as branch versioned. You can use the Register As Versioned tool to register your data as versioned.

1. In the Geoprocessing pane, expand Toolboxes, expand the Data Management Tools toolbox, and expand the Versions toolset. Click the Register As Versioned tool.
2. In the tool, set the following parameters:
   1. For Input Dataset, select the feature dataset that contains the Pipeline Referencing dataset.
3. Click Run.

Note:

Alternatively, use the Catalog Pane or Catalog View, browse to the database connection file and right-click the feature dataset or feature class and select Manage. On the Manage dialog box, check the box next to Versioning and select Branch.

Enable replica tracking (optional)

Enabling replica tracking on your dataset allows your data to work with offline maps that have branch versioned data, with the option of creating a version for each downloaded map. You can use the Enable Replica Tracking tool to register your data as versioned.

1. In the Geoprocessing pane, expand Toolboxes, expand the Data Management Tools toolbox, and expand the Distributed Geodatabase toolset. Click the Enable Replica Tracking tool.
2. In the tool, set the following parameters:
   1. For Input Dataset, select the feature dataset that contains the Pipeline Referencing dataset.
3. Click Run.

Publish services

This section walks you through the steps to publish the services that support the Pipeline Referencing solution.

Prepare to publish

Publish a Pipeline Referencing feature service

The Pipeline Referencing map is designed to be published to ArcGIS Enterprise and provides the definition of a feature service to support a multiuser editing environment.

Note:

For more information about publishing services see the data and publishing in ArcGIS Enterprise help topic.

1. Select all layers in your map and right-click. Select Sharing / Share as Web Layer.
2. On the Share As Web Layer dialog box, set the following settings under the General tab:
   1. For Name, provide the name of the service to be published.
   2. For Summary, provide a short summary about the service that is being published.
   3. For Tags, provide any tags that will help identify the published service.
   4. For Data and Layer Type, select Map Image which is under Reference registered data, and check Feature.
   5. For Location, select or type a name for the folder where the service will be stored in Portal and ArcGIS Server.
3. On the Share As Web Layer dialog box, set the following settings under the Configuration tab.
   1. Check Version Management.

      Note:

      If you do not see Version Management, ensure your data is registered as versioned and the connection that was used to build your publishing map was using branch versioning.

   2. Check Linear Referencing.
   3. Click the edit button next to Feature to configure the properties.
   4. (Optional) On the Feature Properties dialog box, for Operations, select Enable Sync. Also select Create a version for each downloaded map in the now visible Sync section under Version Creation, if you want to allow offline access.
   5. On the Feature Properties dialog box, in the Properties section, in addition to the defaults, select Apply default to features with z-values and Allow geometry updates without m-value.
   6. Click the Configure Parameters button, expand the Advanced options and set Max number of coded domains to 1,000,000.
   7. Click the Configure Pooling button and verify the Instance Type is set to Dedicated instance.
4. Click Analyze.
5. Review the errors and warnings.

   Note:

   If you receive the error Layer data source must be registered with the server, it requires you to expand the error and right-click one of the layers and select Register Data Source With Service. This only has to be done on one layer.

   Note:

   Warnings about feature templates not set are to be expected; you can ignore these warnings.
6. Click Analyze again after resolving any issues.
7. Click Publish.

Adjust the editor map

The Pipeline Referencing editor map will need to be adjusted to use the newly created Portal feature service. This section walks you through how to make those adjustments.

Update data sources

Use the Update Data Sources tool in the Utility Data Management Support toolbox to update the layer's data source.

1. In the Geoprocessing pane, expand the Project toolbox section, expand the Utility Data Management Support toolbox, and expand the Map toolset. Double-click the Update Data Sources tool.
2. In the tool, set the following parameters:
   1. For Target Workspace, select the published feature service created in the previous section.

      Note:

      You will need to use a Catalog pane or Catalog view to drag the published feature service onto the Target Workspace parameter. Feature services are not currently supported on the browse dialog box of this tool.

   2. For Maps, check the check box next to the name of your editing map.
   3. Check Update Map Spatial Reference if you want to update the map's spatial reference. Otherwise, leave it unchecked.
3. Click Run.
4. Review any warnings and manually correct the layers using their properties page.