Modify the configurations from ArcGIS GeoEvent Server from the configuration file

Summary

There may be times when the buttons for changing some settings might not work in ArcGIS GeoEvent Server. This issue can happen due to various reasons or errors, but this workflow may help in case it is necessary to replicate an already existing GeoEvent Server, perhaps with some small adjustments.

Procedure

Follow the steps below:

1. Open GeoEvent Manager.
2. Go to Site > Configuration Store > Export Configuration.
3. Choose Export Configuration or Selective Export, depending on whether it is necessary to modify all of the settings or just some of them, and select what to settings modify.
   • Even only services are selected, it is possible to modify the Inputs and Outputs in the .xml file.
4. In the next window, select what settings to modify, for example, Services, Inputs, etc.
5. Choose Export, this generates an XML file with the configurations of the selected settings.
6. Open the document with a text editor.
7. Depending on what you would like to modify, use the search function (CTRL + F) to look for it, or manually look for the setting, it should be named similarly to how they are named in the GeoEvent Manager. For example, Max Rate / Minimum Rate > geoEventReceivedRateRange.
   • It is also possible to change the state of the Service, and the path to the Data Stores. 

Below are some examples of some of the settings:

• Label: Name of the Service/Input/Output
• runningState: If the service is Started/Stopped
• clusterCommand: If the whole cluster of inputs/outputs will Start/Stop
• connectorLabel: The type of Input Connector chosen when it was created

<geoEventService name="d4b6fe15-e0bf-490d-80d2-ea89d4be2689" label="tcp-in-file-out" description="" lineStyle="Diagonal" runningState="STARTED" statusDetails="">
<inputs>
    <input clusterCommand="START" connector="esri-in-tcp-text-generictext" connectorLabel="Receive Text from a TCP Socket" label="tcp=text-in">
<geoEventsReceivedRateRange max="7.0" min="2.0"/>
<geoEventsSentRateRange max="7.0" min="2.0"/>

Please note that while tested, an issue was encountered where the settings for the service itself were not changed if the name of the service was not also modified in the configuration file (an extra letter was added at the end).

1. After modifying the settings, save the document and go back to the GeoEvent Manager > Site > Configuration Store.
2. Click Import Configuration and choose the file with the new configurations and press Next.
3. Depending on what was chosen in step 3, choose the same option.
4. If Selective Import was chosen, select the desired options, and press Next.
5. Select the GeoEvent Definitions, and press Import. This displays a pop-up informing that the existing components will be overwritten. 
6. Press X from the upper-right corner of the pop-up on the blue bar and press Import again.