User Manual









Sepasoft - MES Modules
Cirrus Link - MQTT Modules


Inductive University
Ignition Demo Project
Knowledge Base Articles
IA Support


Ignition 8.1. Offline Version (04/2021)
Ignition 8 Online Version
Ignition 7.9 Online Version
Ignition 7.8 Online Version

Deprecated Pages

SDK Documentation


Sign In

Skip to end of metadata
Go to start of metadata

To set up the EAM, you must first designate one machine as the controller. Keep track of the IP address of this machine because you must enter this IP address on each agent during agent installation.

Install the EAM module in the Gateway if it has not already been installed. After module installation, you must designate a database connection that will be used by the controller to store agent event history. Navigate to Config > Databases > Connections, and set up a connection to the database that you intend to use.

Tips for Configuring Controllers and Agents

  • If you have any existing installations of Ignition running, it's a good idea to perform a backup before you begin this process.
  • If you have two or more Gateway Webpages open in your browser, you may want to have the Controller and Agents on separate monitors so you don't get confused which one you are working on.
  • It's always a good idea to verify that all your modules are loaded correctly. Go to Config > Modules to check which modules you have installed.

On this page ...


Creating a Controller

Set Up a Controller

  1. Navigate to Config > Enterprise Administration > Setup . You will now enter the EAM Setup Wizard.
  2. Since you are installing the controller, select Controller  on this screen. Click Next

  3. Next you need to set up the controller.

    1. Default Database - For the default database, you must select the database connection that you created before entering the EAM Setup Wizard. If you forgot to create the database connection, you can do so now and return to the EAM Setup Wizard later.
    2. Archive Path - This is a file path on the Gateway’s local machine where all archived files will be stored. You can use a locally mounted network share for archiving. Use a value such as E:\eam-archive . It is strongly recommended that you put a system into place to externally monitor the free size of the disk that contains the archive. Gateway backups can potentially be many megabytes in size, and can eat up large volumes of space when using many agents.

  4. After you have determined your settings, click the Finish button to save the controller settings and exit the wizard. This machine is now ready to accept agents.

  5. Once you set up your Controller, the Setup  option disappears in the menu and is replaced with a list of Enterprise Administration menu options.  

Remove a Controller

  1. To remove a Controller, from the Gateway, go to  Config  section
  2. Scroll down and select  Enterprise Administration > Controller Settings .  
  3. Click the Uninstall Controller link.

  4.  A confirmation window will appear. Click Confirm to complete uninstalling the controller.  

Controller Settings

The table below lists the main properties found in the Controller Settings:

Default DatabaseThe database connection to use for recording agent history.

The table below lists the archiving properties found in the Controller Settings:

Archive LocationChoose between "Automatic" and "Manual". If "Automatic", the system will manage the location of the Agent archive. If "Manual", the path from the  "Archive Path" setting will be used.
Archive PathThe file path to save Gateway backups, archived modules, and other files. Disabled if the "Archive Location" setting is set to "Automatic".
Low Disk Space ThresholdValue is in megabytes. Default value is 1024. Errors will be reported in this Gateway when the disk used for archiving drops below this value.
Maximum Retention Count

The following feature is new in Ignition version 8.1.19
Click here to check out the other new features
Maximum number of backups that will be retained. If the number of backups exceeds this number, the oldest backups will be deleted first until the number of backups equals this number. A value less than or equal to zero disables this feature, effective allowing an unlimited number of backups. Default is 0.

Maximum Retention Age

The following feature is new in Ignition version 8.1.19
Click here to check out the other new features
Maximum age of backups that will be retained. Any backup older than the age specified here will be deleted. A value less than or equal to zero disables this feature, effectively retaining backups no matter their age. 

Note: if the "Maximum Retention Count" setting is enabled, and if the count of backups exceeds the max retention count, the oldest backups will be deleted until the count of backups is equal to the max retention count, even if the oldest backups are younger than the "Max Retention Age" setting. Similarly, if "Max Retention Count" is enabled, and if the count of backups is less than or equal to the max retention count, any backup older than the max retention age will be deleted.

Maximum Retention Age Time Unit

The following feature is new in Ignition version 8.1.19
Click here to check out the other new features
The time unit to use when specifying the "Maximum Retention Age" setting. Choose between Days, Weeks, Months, or Years. Default is Days.

  • No labels