Skip to main content
Version: 7.9

Remote Upgrade

New in 7.9.2

Agents can be upgraded remotely from the Controller. This involves uploading the required binary files for the desired architecture as a task. Once the files have been saved, the remote upgrade procedure may be initiated. Both the Agent to be upgraded, as well as the Controller, must be on 7.9.2 to execute a Remote Upgrade.

Upgrading Redundant Agents

When upgrading a redundant pair of agents, it is recommended that the backup be upgraded before the master.

Remote Agent Upgrade Task

This task will upgrade the agent(s) upon execution.

This task takes zipped binary files for a version of Ignition, and saves them for upgrades later. Multiple files may be saved for different versions and architectures. Additional modules may be included, allowing for upgrades of non-standard modules to occur simultaneously.


The zipped binary files differ from the installers. The binary files may be found on the Ignition downloads page, listed below the installers.

This task only needs to be executed once per version/architecture: multiple upgrades may be performed from the same files.

Creating the Remote Agent Upgrade Task

  1. From the Controller, navigate to the Configure > Enterprise Administration > Agent Tasks. Click on the Create new Gateway Task link.

  2. Select the Remote Agent Upgrade task from the list of tasks, and then click Next.

  3. On the Task Scheduling page, give the task a name. Like all tasks, you will specify either a group, or several agents, so providing a useful name will make the task easier to identify later. you can leave the schedule set to Execute Immediately.


    This task does not upgrade the agent, it only prepares the files for later. You may continue without worry that the agent will be restarted.

  4. On the Remote Agent Upgrade page, click the Choose File button, navigate to the files you wish to upload, and click OK. Note that this page will state the architecture of the Agents that were selected in the previous step. Once finished, click Next.

  5. Next, select any additional modules that should be included with this Task. Modules that are not included in the typical installation, including third party modules, may be added. Click the Choose File button, navigate to the module, and click OK. This step is optional, so regardless of whether you add custom modules, click Next when you're ready to move on.

  6. The Task Summary page will appear. Review the information, and click Finish. The new task will run, and pass the files to the agent. Once complete, the agent will be prepared for a remote upgrade.

Upgrading the Agent

Once the files have been passed to the Agent, a remote upgrade may be initiated from the Controller's web interface.


As with all upgrades, it is highly recommended to take a backup of the Agent before starting the upgrade process. Information on taking a backup from an Agent can be found on the Agent Task - Backup and Restore page.

Remotely Upgrading an Agent

  1. To begin a remote system upgrade, on the Controller, navigate to Gateway > Configure > Enterprise Administration > Remote Upgrades. Once the Remote Upgrades page appears, you may either click the Upgrade button next to the agent you wish to upgrade, or select multiple agents/groups and click the Upgrade Selected button.

  2. A confirmation page will appear. Click the Confirm button when ready to proceed.

  3. The Remote Upgrades page will appear again. This will report the status of the upgrade. Once complete, the Upgrade Status of the agent will show that the upgrade was successful