Editing the gateway.config file

From Build 2024-03-15, you can now configure the settings defined in the gateway.config file. It is an XML file that lies in the ProgramData folder of the Neuron®, and is defined by namespace https://waher.se/Schema/GatewayConfiguration.xsd.

Access to the contents of the gateway.config file has previously only been available by editing the file manually on the Neuron® directly. The reason is that it is part of the configuration of the IoT Gateway on which the TAG Neuron® is hosted. But from Build 2024-03-15, the Neuron® published a harmonized data source to administrators of the Neuron®. This data source contains nodes representing all information in the file. The contents of the file, and the nodes in the data source are synchronized. This means, that edits you do in the file are mirrored in the data source, and vice-versa; edits you do in the nodes in the data source are saved to the file.

Note: Changes done in the gateway.config data source may not take effect until after you restart the Neuron®. In such cases, the property dialogs will clearly state that this is the case.

Once you have an XMPP client supporting harmonized interfaces connected with the Neuron®, you find the gateway.config data source in the list, if you’re an Administrator of the Neuron®:

gateway.config data source
gateway.config data source

Some of the nodes contain themselves child nodes, like the WebServer node in the following example:

WebServer Node
WebServer Node

Press the Properties button to edit the properties of a node (parent node or child nodes).

Properties Button
Properties Button

For the WebServer node, you can edit properties for mutual TLS (mTLS), as an example:

WebServer Properties
WebServer Properties

Some nodes can receive new nodes. For example, by pressing the Add Button, with the WebServer node selected, will show you options for new types of nodes you can add to the selected node. The following example shows you how you can define a new web folder on the server, mapping to a network folder accessible from the Neuron®:

Create New Node
Create New Node

Select the node, and a dialog appears with the properties you need to provide, before the node can be properly added:

Parameters For New Node
Parameters For New Node

This article is being written.

#neuron, #new, #features, #admin