The EAM allows an agent Gateway to be automatically configured from text files when the Gateway is started. This capability is enormously useful when installing multiple agent Gateways in your network, as it saves time from manually making this configurations. To automatically configure an agent or controller, you must add two files to the Ignition /data folder before startup: and Example contents are below. After the files have been read, they are renamed to and A typical application for this capability would be a script that creates the init files and adds them to an that is distributed to many systems.

For both types of files, settings omitted from the file will use their default values. 

Note: When using our Docker image, variables defined in docker environment variables will take precedent over the settings listed on this page.

Multiple Gateway Network connection settings are managed by numbering each setting. The first set of connection settings must contain “0” in the setting name after “” For example, you can create two outgoing connections with different IP addresses like so:

Gateway Network Addresses
Property NameDescription
SystemNameSets the Gateway name in Gateway Settings.
AutoDetectLocalSet to true to check the first found network interface to determine local IP address. Set to false to manually set the IP address of the Gateway. Expects true or false
LocalInterfaceManually sets the IP address of the Gateway. If set, the AutoDetectLocal setting must be set to false.
UseSSLSet to true to force all connecting web browsers to connect to the Gateway over SSL. Expects true or false often in milliseconds to ping the remote machine. to false to disable the gateway connection after it is created. Expects true or false address of the remote machine. port of the remote machine. to true to use SSL to connect to the remote machine. You must change the Port setting to use the Gateway Network SSL port (which defaults to port 8060). Expects true or false long in milliseconds to wait for a ping request to be processed by the remote machine. number of failed pings allowed before the connection state is set to Faulted. to true to allow faster asynchronous communications with the remote machine. Expects true or false long to wait in milliseconds for a message to be processed over the web socket. long to wait in milliseconds to initially connect the http data channel. long to wait in milliseconds to read data from the http data channel.


Before creating an file, it's important to understand that each property is prepended by a key that determines the category for the property. The three categories are listed below.

agent.Indicates the property pertains to an agent. 
controller.Indicates the property pertains to a controller.
setup.Generic key used for settings that don't uniquely apply to either agents or controller.
Property NameDescription
setup.installSelectionDetermines what the gateway will be configured as. Expects either Agent or Controller
agent.controllerServerNameSets the name of the gateway in the Gateway Network that will be the controller for this gateway. 
agent.sendStatsIntervalThe amount in seconds that the agent will wait before sending new metrics and configuration data to the controller. If there are currently no interesting metrics or updated config data to send, the agent will not send any data.
controller.archivePathWhen controller.archivePath is set to Manual, this property defines the path to use. 
controller.archiveLocationDetermines if the archive location should be set manually, or if the system should automatically pick a location. Expects a value of either Manual or Automatic.
controller.lowDiskThresholdMBSets the low disk space threshold property. Excepts an integer value. 

Specifies which database connection the controller should use to record agent history. 

Note: The database specified by this property must first exist on the gateway for this property to do anything. If the specified database does not exist, then the setting will default to "none". 

Example Agent Configuration

Example Controller Configuration
controller.archivePath=path/to my backups

  • No labels