Home › Technical articles

Đọc bằng tiếng Việt

Upgrading Citect SCADA to AVEVA Plant SCADA 2026: offline or online, Migration Tool, licensing, server order

TDL Industrial Automation · Last updated:

From AVEVA's Plant SCADA 2026 documentation: offline upgrade of projects from any Citect SCADA version from 5.21, online upgrade only from 2023 or 2023 R2 on a redundant server pair, the files to back up, Sentinel keys and AVEVA Enterprise Licensing, the Project Migration Tool, deployment servers and what the release notes removed.

Citect SCADA has been called AVEVA Plant SCADA since release 2020 R2, and the current release is Plant SCADA 2026. AVEVA's documentation allows an offline upgrade of a project from any Citect SCADA version from 5.21 onwards, and an online upgrade, with the plant kept running on redundant servers, only from Plant SCADA 2023 or 2023 R2. This article follows the upgrade chapter and release notes of the Plant SCADA 2026 documentation, and adds the checks we make before touching a running system. How a Plant SCADA system is built: AVEVA Plant SCADA architecture, clusters and redundancy.

Upgrading Citect SCADA to Plant SCADA 2026Top: two upgrade methods by the version now running. Offline for a project from any Citect SCADA version from 5.21; online, with runtime kept on a redundant server pair, only from Plant SCADA 2023 or 2023 R2. Both apply the latest update to the old version, upgrade to 2026, then apply the 2026 updates. Middle: four steps on each computer: prepare, install, project, runtime. Bottom: the online order: primary server, clients one by one, standby server, switchover test. Based on AVEVA's Plant SCADA 2026 documentation.Upgrading Citect SCADA to Plant SCADA 2026By the version now runningOfflineruntime stopped during the upgradeOnlineruntime kept on a redundant pairfrom any Citect SCADA 5.21 or laterproject upgraded directly to 2026from Plant SCADA 2023 or 2023 R2older versions: to 2023 or 2023 R2 firstBoth: latest update on the old version, then 2026, then the 2026 updatesOn each computer (offline procedure)1. Preparebefore removingthe old versionback up projects to .ctz, with included projectssave Citect.ini, alarm and trend data, driversuninstall the old version2. InstallPlant SCADA 2026install 2026 and its updatesConfigurator: System Management Server,encryption, server password3. Projectin Plant SCADA Studiorestore .ctz: automatic project upgraderun the Project Migration Toolmerge Citect.ini, then compile4. Runtimebefore going liverun the Setup Wizardrestore runtime files, alarm and trend datatest I/O, alarms and trendsOnline: order on a redundant server pair1. Primary server2. Clients,one by one3. Standby server4. Test switchoverto standbyBased on AVEVA, Plant SCADA 2026 documentation: Upgrade Path, Offline Upgrade,Online Upgrade from Plant SCADA 2023 R2 (read 13 November 2026). Figure: drawn by TDL.
Figure 1: Upgrading Citect SCADA to Plant SCADA 2026. On a phone, swipe sideways to see the whole figure.

1. Offline or online: which path fits your version

The 2020 R2 release notes describe the rename, which also changed installation folders and Start menu paths; files such as Citect.ini keep the old name. AVEVA describes two upgrade methods:

Method Runtime during the upgrade Starting version and conditions
Offline shut down for the whole upgrade; suits a system that can do without history for that period any Citect SCADA from 5.21 onwards, project upgraded directly
Online keeps running on the redundant partner Plant SCADA 2023 or 2023 R2, from the release or a later update, in mainstream support; at least one pair of redundant servers

Online from an older version means first upgrading temporarily to 2023 or 2023 R2. In both cases AVEVA asks for the latest update on the version you leave, the upgrade to 2026, and then the latest 2026 updates.

2. Prepare: backups, files and the licence

  • Projects: back up each project to a .ctz file with Save sub-directories and Save configuration files selected. The Save Included Projects option puts included projects in an "_IncludeProjects" sub-folder; system projects such as Library_Controls are not added. Since 2023 R2, CSV_Include is no longer a system project: if a project is based on the CSV_Include templates, back it up separately, restore it by hand and include it as a user project.
  • From 2016 or earlier to 2018 R2 or later: check the [CtEdit]ANSIToOEM parameter in Citect.ini, then run Update Pages with Fast Update Pages disabled before the backup, so that the correct ANSI characters are saved.
  • Other files to save: Citect.ini, deployment files, the alarm database of each alarm server, trend files (.HST and .00X), report files, custom ActiveX controls (.OCX), Process Analyst views, specialty drivers in the bin folder, device logs and runtime files named in the [Path] section.
  • Licence: the upgrade needs a valid support agreement or a purchased licence upgrade. AVEVA recommends updating the production keys before any project is updated, because the updated key still licenses the previous version.
  • Uninstall: remove the old version, and delete its installation folder by hand if it remains.

3. Licensing: Sentinel keys and AVEVA Enterprise Licensing

Plant SCADA 2026 supports two licensing technologies, and the two cannot run on the same computer. Sentinel Licensing, which AVEVA calls legacy, uses USB keys holding the licence type and point count; for a new version the key is updated with CiUSAFE, from the Licensing activity in Plant SCADA Studio, with an authorization code from AVEVA's License Activation page. AVEVA Enterprise Licensing is software based: a browser-based License Manager, a License Server and an online Activation Server. Schneider Electric's Floating License Manager is not supported from Plant SCADA 2023; its users must move to AVEVA Enterprise Licensing.

Licences follow the computer role: server, control client, view-only client or standalone HMI. Both technologies use a Dynamic Point Count of the I/O device addresses used at runtime. The 2026 release notes record a change that can raise it: variable tags from real I/O used in time-stamped digital and analog alarms are now counted.

4. On each computer: install, upgrade, migrate, compile

AVEVA's offline procedure, which an online upgrade also uses on each server:

  1. Install Plant SCADA 2026 and check for 2026 updates first, since an update can fix the automated project migration.
  2. In Configurator, confirm the System Management Server, encryption and the server password, then close Configurator and restart if asked.
  3. Restore the .ctz backups in the Projects activity. Studio forces a project upgrade; [CtEdit]Upgrade set to 1 upgrades all projects.
  4. Run the Project Migration Tool (see the table below).
  5. Merge project-specific and driver parameters from the old Citect.ini into the new one.
  6. Compile. Errors are likely: Cicode functions may have changed or been removed, and the compiler is stricter. Coming from 2018 R2, warning W1041 flags a network address entered as an IP address; for encryption, enter the computer's DNS Name in Topology, Computers.
  7. Run the Setup Wizard.
  8. Restore runtime files and historical data: delete legacy alarm files such as ALMSAVE.DAT when coming from 2015 or later, keep trend files in the same folder structure, and upgrade a copy, because upgraded files may not work with the old version.
  9. Run the project and test I/O communication, alarms and trends before production.

The automatic upgrade only updates database field definitions and copies new files; the Project Migration Tool, under Home in the Project activity, makes the functional changes. The options that matter most on an old project:

Option What it does
Migrate included projects processes the master project and each included project in one run, because tags can point to I/O devices in another project
Create unique IDs for Variables and Equipment IDs added to variable tags in 2023 and to equipment in 2023 R2; apply to every migrated project
Migrate Equipment database, Types and Parameters moves custom parameters to the configuration parameters of 2023, without the 256-character limit
Remove obsolete Memory and Alarm devices not on the first run if an included project is shared by several master projects; use a second run
Migrate ABCLX to OPCLX moves selected ABCLX devices to the OPCLX driver, which must be installed
Delete Industrial Graphics content removes content of AVEVA Industrial Graphics, which 2026 no longer contains

An aborted migration is not rolled back; the project is restored from the backup. AVEVA's safety message on these pages: the upgrade alters communication settings, so every I/O device must be checked and adjusted afterwards.

5. Online upgrade of a redundant pair

For an online upgrade from 2023 R2, AVEVA's sequence is:

  • On every server, add [LAN]EarliestLegacyVersion = 8500 (8400 when coming from 2023) to Citect.ini and restart, so upgraded servers accept connections from the old version.
  • Stop runtime on the primary server and upgrade it as above. Encryption is on by default in 2026: if the old system was not encrypted, set 2026 to Mixed Mode until the upgrade is complete.
  • Place the backed-up alarm database in the [CtEdit]Data folder, restart the primary, and wait until its alarm database has synchronised with the running old server.
  • Upgrade the clients one by one, with the same server password.
  • Stop runtime on the standby server, upgrade it and restart it. When the upgraded server takes the primary role, it converts the whole alarm database to the new format.
  • Check the whole system, then switch off the primary to test that the standby takes over.

AVEVA warns against shutting down the upgraded primary before the standby is upgraded, stopping both servers, or starting the old standby while the upgraded primary runs. A side-by-side set of new servers and clients is the other option; it doubles PLC data requests. If the hardware alarm "Redundant Server not found" appears, AVEVA points to that parameter, Networked mode on both servers, the same server password and Mixed Mode. Afterwards remove [LAN]EarliestLegacyVersion.

6. Deployment, drivers and Windows

The deployment architecture changed in Plant SCADA 2023. A 2026 deployment server cannot deploy to computers on 2020 R2 or earlier, so the old deployment server stays until every computer is upgraded.

Since 2020 R2 the installation media carries a reduced set of core drivers; the others come as driver packs from the AVEVA Knowledge & Support Center, installed on the I/O server and on every computer that compiles the project. Plant SCADA 2026 runs on 64-bit Windows 11 LTSC 2024, 25H2 and 24H2, and Windows Server 2025, 2022 and 2019, with .NET Framework 4.8.

7. What the release notes removed

Version No longer supported or removed
2020 R2 EcoStruxure Web Services; Vijeo Web Gate and Pelco ActiveX controls no longer installed
2023 Floating License Manager; legacy ActiveX Web Client, IIS Web Client, Internet Display Client
2023 R2 CSV_Include as a system project
2026 AVEVA Industrial Graphics; Open Factory Server no longer on the media; .dxf, .eps and .wpg graphics; Cicode UserCreate and Fuzzy Logic functions

Also in the 2026 notes: AVEVA Historian Plant SCADA Connector 4.0 or earlier cannot log in with a Plant SCADA user password set in 2026; AVEVA recommends Windows authentication there.

What TDL checks before an upgrade

These are our working steps, not AVEVA requirements:

  • We read the installed version and update on every computer, and list servers, clients and the deployment server.
  • We back up every project, its included projects and the files in AVEVA's list, and restore them on a test computer.
  • We list the I/O devices and drivers on each I/O server, including specialty drivers and ABCLX devices.
  • We check the licence type, the support agreement and the point count, and each computer's Windows against the 2026 list.
  • We upgrade, migrate and compile on the test computer, then choose offline or online for the plant.

When the plant moves to another platform

Some plants replace the PLCs and the SCADA together. At Pha Lai II Thermal Power Plant, TDL migrated the PLC-5 and Citect control systems of the subsidiary plants to ControlLogix and FactoryTalk View SE. Options for older HMI and SCADA: Legacy HMI/SCADA migration paths.

How TDL approaches it

TDL Industrial Automation is a System Integrator in the AVEVA Partner Ecosystem, and builds, extends and maintains applications on AVEVA Plant SCADA (formerly Citect) among other AVEVA platforms. More: AVEVA system integrator in Vietnam, other control system migration and What is AVEVA.

Frequently asked questions

Can a Citect SCADA 7.x project be upgraded directly to Plant SCADA 2026?

Yes, offline: AVEVA allows a project from any Citect SCADA version from 5.21 onwards to be upgraded directly. An online upgrade is possible only from Plant SCADA 2023 or 2023 R2.

Can Plant SCADA be upgraded without stopping the plant?

Yes, with an online upgrade from Plant SCADA 2023 or 2023 R2, which needs at least one pair of redundant servers. The primary server is upgraded first, then the clients one by one, then the standby server.

Do Sentinel USB keys still work in Plant SCADA 2026?

Sentinel Licensing is still described as a legacy option, and the keys are updated for a new version with CiUSAFE. The Floating License Manager is not supported from 2023, and Sentinel and AVEVA Enterprise Licensing cannot run on the same computer.

Why does the project not compile after the upgrade?

AVEVA names Cicode functions that changed or were removed and a stricter compiler as common causes. The Project Migration Tool has to be run after the automatic upgrade and before compiling.

What happens to AVEVA Industrial Graphics screens?

Industrial Graphics was removed from Plant SCADA 2026. The Project Migration Tool can delete Industrial Graphics content from a project folder.

Sources

Read 13 November 2026. This article paraphrases the sources and does not quote them; read the original documents before designing or working on a system.

Related services:
AVEVA (Wonderware) GE Fanuc, Siemens and older ControlLogix migration