Skip to main content
Version: 8.1

Agent Recovery

Inductive University

Agent Recovery

Watch the video

Once the Controller is up and running, you can use it to perform recoveries on Agents. For example, if one of your computers crashed that is running Ignition, you can do a fresh install from a previous backup collection that was performed on your Agent. When the recovery is complete, the Agent will immediately pick up where it left off like nothing ever happened.

Backup Required to Perform Agent Recovery

Agent recovery requires that a backup collection on the Agent was performed, otherwise, you will not be able to use this procedure to recover your Agent’s instance of Ignition.

Perform an Agent Recovery​

Let's assume that the Agent computer crashed. To check the status, go to your Controller, navigate to Enterprise Administration > Agent Management and check the status of the Gateway Agent. In this example, you can see that Ignition-TR-0690157-SB is disconnected.

  1. On the Agent computer, install Ignition and make sure the EAM Module is also installed (it is added by default if you use the 'Typical' selection during installation).

  2. On your Agent, go to the Configure tab and select the Enterprise Administration Setup. The EAM wizard will walk you through each step of the Agent recovery process. Select Agent to configure and click Next.

  3. In order to continue with the Agent Recovery procedure, you must have a backup collection of the Agent. When you initially set up your Agent on the Controller, you created an Archive Path where the backup files are stored. EAM will automatically know where to retrieve the backup files. Click on Agent Recovery and click Next.

  4. Since Agent99 existed previously, the EAM remembered the Agent’s prior settings. Select from the list of names in the dropdown lists for the Controller and Agent (or you can type it in). Click Finish.

  5. The Agent will go through a series of steps:

    1. Check the Agent status on the Controller.
    2. Retrieve the Ignition license file.
    3. Download Ignition modules
    4. Copy the latest Gateway backup to the Agent.

    When you get a message that the setup is complete, press Apply Files. Once you press the Apply Files button, you will see a message stating the Gateway is starting. It will take about a minute to bring the Gateway up.

    Once the files have been applied, you will see a message stating the Gateway is starting. It will take about a minute to bring the Gateway up.

  6. The screen will refresh once the Gateway is up and running. Go to the Config tab of the the Gateway webpage, and click on Projects. You will notice that all your projects were recovered.

  7. It's also a good idea to verify that all your modules are installed and running by going to the Config tab, and selecting Modules.