This article provides common troubleshooting steps when encountering issues integrating WaterGEMS or SewerGEMS with ArcGIS Pro. For example:
Note: if you are using ArcMap, please see: Troubleshooting ArcMap Integration
First, ensure that you are using a compatible version of ArcGIS Pro for the version of WaterGEMS or SewerGEMS that you are running. You can check your version by opening the Standalone version (for example the shortcut that just says "WaterGEMS") and going to File > Help > About. The version number will be shown in the lower-left corner. Your ArcGIS Pro version can be found in the ArcGIS Pro "about" window or in the Windows "Programs and Features" list.
For information on compatible versions, see:
For information on upgrading, see: Downloading OpenFlows Software
Ensure that ArcMap, WaterGEMS and SewerGEMS are closed, then locate and run the "Integrate WaterGEMS with..." or "Integrate SewerGEMS with..." shortcut found in the WaterGEMS or SewerGEMS Start menu folder. It is recommended that you run this tool as Administrator by right clicking on the shortcut and choosing "Run as Administrator". (administrative permissions required)
Note: re-running the integrator is required after upgrading your ArcGIS version (assuming it is still a compatible version).
Another common cause of problems in ArcGIS Pro is the assembly cache. To locate the folder, open File Explorer and paste the following into the address bar and press enter
Within this folder you will find another folder with the following name:
Delete the folder and then re-open the "...for ArcGIS Pro" shortcut.
Note: If the above folder does not exist, it means ArcGIS Pro failed to extract the files from the WaterGISPro.proConfigX file which is located in C:\Program Files (x86)\Bentley\WaterGEMS\x64.
This should work when you see the WaterGEMS/SewerGEMS splash screen displayed when opening the shortcut. If you see the regular ArcGIS Pro splash screen, then WaterGEMS/SewerGEMS is not being loaded.
If after trying to run it and it still doesn’t load, you can try the following:
Open ArcGIS Pro. At the bottom-left, click on Settings. Along the left side, click on Add-In Manager.
Go to the options tab. Look at the setting below the Add Folder button.
If it is set to “Load only Esri provided Add-Ins (Most Secure)”. WaterGEMS for ArcGIS Pro will not load. Make sure it is set to “Load all Add-Ins without restrictions (least secure)” then it should load.
If your menus/toolbars are appearing but you're experiencing other problems while working on the model in ArcMap integrated mode, there are a number of possible reasons. One possibility is that the intermediate geodatabase (.GDB)has become corrupted. This file acts as a "middle man" between ArcGIS Pro and the OpenFlows product. If the model was working and has stopped working, in most cases the culprit is the geodatabase. Try deleting this file and reopening your project. Ensure that ArcMap and the OpenFlows product are closed first before deleting this file. See more here: How does the intermediate geodatabase (.MDB or .GDB) file function with ArcMap and ArcGIS Pro integration?
If the above does not help, try repairing the installation:
If it doesn't work, try a clean reinstallation of the program using these instructions. When you reinstall, the integration should happen automatically. *Note that you need full administrative rights to install the program correctly.
During the process of reinstalling, please be sure to temporarily disable antivirus/security software as they have been known to interfere and block the scripting action executed by the installation routine which performs the integration. Starting with CONNECT Edition Update 3 (10.03.XX.XX+) if the integration step fails due to the script being blocked, it will skip that part and you will not see new integrated-version icons on your desktop/start menu.
Try temporarily disabling any antivirus/antimalware/security software (or try the integration in Safe Mode) to make sure it is not interfering with the integration process, then repeat option 2. Check any antivirus/antimalware logs to see if any false positives occurs and quarantined files needed for integration.
Starting with CONNECT Edition Update 3 (10.03.XX.XX) if the integration step (during installation) fails due to the script being blocked, it will skip that part and you will not see new integrated-version icons on your desktop/start menu.
You may need to re-reun the Integrator after doing this.
1. Open the "For ArcGIS" shortcut and reproduce the problem but leave the window open.2. Open the Task Manager3. Select the Processes tab4. Right-click on the crashed process5. Select Create Dump File6. Locate the file WaterGISPro.proConfigX, which is located at path similar to this: "C:\Program Files (x86)\Bentley\WaterGEMS\x64".7. Contact Bentley Technical Support by posting to the forum or by creating a service request using the CONNECTION Center.8. Provide the Crash Dump file and the two .ecfg files.
WaterGEMS and SewerGEMS do not require ArcGIS Pro to operate. A "standalone" version is always available and you can work on an existing model even if it was created in ArcGIS Pro integrated mode. This is the shortcut called "WaterGEMS or "SewerGEMS" in the respective Start menu folder.
The Standalone version can work with GIS files as well. For example you can import Shapefiles in ModelBuilder to convert to model elements, and you can display a number of different types of background layers.
Troubleshooting ArcMap Integration
WaterGEMS for ArcGIS Pro and WaterGEMS for ArcMap FAQs
How does the intermediate geodatabase (.MDB or .GDB) file function with ArcMap and ArcGIS Pro integration?