Configure and Troubleshoot an ArcGIS Enterprise Geodatabase Provider

Trimble Business Center uses the following software components to enable GIS connections to an ArcGIS Enterprise geodatabase and file geodatabases:

  • ArcGIS Enterprise Geodatabase provider - The provider file ArcGISEnterpriseGeodatabase.dps.dll is installed along with TBC and is stored in C:\Program Files\Trimble\Trimble Business Center\DataProviders (in a typical installation). It uses an additional application called a "Geodatabase Connector" (see next bullet), to connect to and manage the exchange of data with ArcGIS enterprise geodatabases or file geodatabases.
  • Geodatabase Connector - The GeodatabaseConnector.exe file is also installed along with TBC and is stored in C:\Program Files\Trimble\Trimble Business Center\DataProviders (in a typical installation). The Geodatabase Connector, which runs in a separate 32-bit process, connects to and manages the downloading of schema and uploading of features from and to ArcGIS enterprise geodatabases or file geodatabases.
  • ArcGIS assemblies - These files are installed as part of either ArcGIS for Desktop or ArcGIS Engine with a proper license. The ArcGISEnterpriseGeodatabase.dps.dll provider file supports ArcGIS versions 10.1 and later. To write data into geodatabases, either of the following licenses are required:
    • ArcGIS for Desktop Standard or Advanced license
    • ArcGIS Engine Runtime with Geodatabase Update license

      Notes:
      - The ArcGIS Enterprise Geodatabase provider will not be available for selection if an applicable ArcGIS product is not installed on the same computer.
      - See your ArcGIS user documentation to determine which versions of the product are supported on the various versions of the Windows operating system.

Preparing to use an ArcGIS Enterprise Geodatabase provider

Before using an ArcGIS Enterprise Geodatabase provider, you must complete the following steps:

  1. Install the appropriate ArcGIS product on the same computer where TBC is or will be installed. Then set up and verify an ArcGIS license.

    For more information, see the ArcGIS product documentation.

    Note: It is recommended that you use a local license. Using a network license may affect performance or, when network latency is large, it may prevent operation of the ArcGIS Enterprise geodatabase provider. (See (http://support.esri.com/en/knowledgebase/techarticles/detail/35659 for more information.)

  2. Optionally, using the GeodatabaseConnector.exe.config file (located in C:\Program Files\Trimble\Trimble Business Center\DataProviders), do the following:
    • Specify the name of the Geodatabase Connector log file. If no file name is specified, a log file with the name GeodatabaseConnector.log will be created in the folder C:\Users\<username>\AppData\Roaming.

      <!-- ========= LOG4NET ====== --><log4net>

      <appender name="RollingLogFileAppender" type="log4net.Appender.RollingFileAppender">

      <threshold value="DEBUG"/>

      <File value=""/>

      <!-- Note: Change the above filepath if you wish a specific path and a name of the log file -->

    • Set logging information levels (ERROR, INFO, WARNING, DEBUG).

      <!-- For “level value =”, specify the logging information level (ERROR, INFO, WARNING, or DEBUG) -->

      <logger name="Trimble.GeodatabaseConnector">

      <level value="DEBUG"/>

      </logger>

  3. If you want to connect to ArcGIS enterprise geodatabases, you must first create the connections in ArcGIS for Desktop. See your ArcGIS documentation for more information.

Note: As described above, before each ArcGIS Enterprise Geodatabase provider operation can run, (1) a new process must be started and then bound to ArcGIS assemblies, and (2) an ArcGIS license must be tested. As a result, a delay in software response is likely. Therefore, it is recommended that you eliminate all potential causes for ArcGIS software latency, such as the use of remote licenses or database servers.

Troubleshooting

The TBC software component that loads data providers and the data provider assemblies themselves emit trace statements that can be viewed and recorded with the Microsoft DebugView utility (https://technet.microsoft.com/en-us/library/bb896647.aspx ). This enables you to verify that the ArcGIS Enterprise Geodatabase provider is loaded.

To monitor operation of the Geodatabase Connector, you can use the logging infrastructure described above in step 4 of the "Preparing to use an ArcGIS Enterprise geodatabase provider." When experiencing a problem, you can set the logging level to "DEBUG." However, once troubleshooting is finished, you should reset the logging level to "INFO" to avoid recording a large amount of information that may negatively affect the software performance.

Note: To understand how coordinate systems are handled when working with GIS connections, see Working with Coordinates Systems in GIS Connections.

Related topics

Work with GIS Data Sources

Manage GIS Connections

Download (Get) a GIS Schema and Export It to an FXL File

Upload (Write) Processed Features to a GIS Data Source

Working with Coordinates Systems in GIS Connections