Skip to main content
Version: 8.3 Beta 🚧

Remote Upgrade

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.

caution

If attempting to update an Agent from Ignition 8.1 to Ignition 8.3, the Controller should itself be upgraded to Ignition 8.3 first. Additionally, Historian modules should be installed on the 8.1 Agent prior to upgrading to 8.3. See the 8.3 Upgrade Guide for more information.

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 by taking zipped binary files for a version of Ignition, and saving 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.

note

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 as multiple upgrades may be performed from the same files.

Creating the Remote Agent Upgrade Task​

  1. From the Controller, navigate to Network > Enterprise > Agent Tasks.

  2. Click Create Agent Task.

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

  4. On the Task Scheduling page, give the task a name for easy identification. Then, for this example we will select Execute Immediately to have the task run immediately.

  5. Click Next.

  6. Select the Agent you want to upgrade and click Next.

  7. Select how you want to upgrade your Controller. You can either choose to upload the Ignition upgrade zip files to dispatch to connected Agents, or specify an alternate URL that the Agent will use to download the required upgrade zip files. In this example, we will choose Upload to controller. Once you have made your choice, click Next.

  8. On the Selected Upgrade Files form, click Choose File. Navigate to the file 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.

  9. 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 Choose File, navigate to the module, and click OK. This step is optional, so regardless of whether or not you add custom modules, click Next when you're ready to move on.

  10. The Task Summary page will appear. Review the information, and click Finish. Because we selected Execute Immediately during the schedule portion, the new task will run and pass the files to the Agent, and begin upgrading.

Upgrading the Agent​

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

Collect an Agent Backup

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.

note

You will not be able to use the EAM Remote Upgrade Task for Agents in a Docker container. In lieu of the Remote Upgrade Task, upgrade the image the container is using.

Remotely Upgrading an Agent​

  1. To begin a remote system upgrade, on the Controller, navigate to the Gateway Webpage. Select Network > Enterprise > Remote Upgrades.

  2. If you are upgrading a single Agent, expand the three dots menu to select Upgrade for the Agent you wish to upgrade. If you want to upgrade multiple Agents/groups, use the check boxes to make your selections, and then click the Upgrade icon at the top of the list to upgrade all selected Agents.

  3. A confirmation popup will appear. Click Upgrade when ready to proceed.

The Remote Upgrades page will now report the status of the upgrade. Once complete, the Upgrade Status of the Agent(s) will show that the upgrade was successful.