Skip to main content
Version: 7.9

Automated Agent Installation

Automated Agent Installation

The EAM allows an agent Gateway to be automatically configured from text files the first time the Gateway is started. This capability is enormously useful when installing multiple agent Gateways in your network, as otherwise you must install each Gateway, log in, and install and configure the EAM agent. To automatically configure an agent, 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 machines.

  • For, you are not required to use all the settings shown below. The Gateway will use its standard default settings instead.
  • 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

# SystemName: sets the Gateway name in Gateway Settings
# AutoDetectLocal: set 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.
# LocalInterface: manually sets the IP address of the Gateway. If set, the AutoDetectLocal setting must be set to false
# UseSSL: set to true to force all connecting web browsers to connect to the Gateway over SSL
# PingRate: how often in milliseconds to ping the remote machine
# Enabled: set to false to disable the gateway connection after it is created
# Host: the address of the remote machine
# Port: the port of the remote machine.
# Enable SSL: set to true to use SSL to connect to the remote machine. Note that you must change the Port setting to use the Gateway Network SSL port. This port is 8060 by default.
# PingTimeout: how long in milliseconds to wait for a ping request to be processed by the remote machine
# PingMaxMissed: the number of failed pings allowed before the connection state is set to Faulted.
# EnableWebSockets: set to true to allow faster asynchronous communications with the remote machine.
# WebsocketTimeout: how long to wait in milliseconds for a message to be processed over the web socket
# HttpConnectTimeout: how long to wait in milliseconds to initially connect the http data channel
# HttpReadTimeout: how long to wait in milliseconds to read data from the http data channel

# installSelection: always set this setting to Agent
# controllerServerName: the Gateway Network server name of the controller
# sendStatsInterval: the amount in seconds that the agent will wait before sending new metrics and configuration data to the controller. Note that if there are currently no interesting metrics or updated config data to send, the agent will not send any data.