Skip to main content

Supported Version Interoperability

This page describes which components of InterSystems IRIS® data platform can be used across different release versions.

Note:

Throughout this page, “version 2018.1” refers to InterSystems IRIS version 2018.1.

For information about compatibility between InterSystems IRIS and other InterSystems software, see the InterSystems IRIS Migration Guide on the WRC distribution site under Docs.

Web Gateway Interoperability

The following table describes the version interoperability between the Web Gateway and InterSystems IRIS.

Web Gateway Version Compatible InterSystems IRIS Versions
2022.2 2018.1 through 2022.2
2022.1 2018.1 through 2022.1
2021.2 2018.1 through 2021.2
2021.1 2018.1 through 2021.1
2020.4 2018.1 through 2020.4
2020.3 2018.1 through 2020.3
2020.2 2018.1 through 2020.2
2020.1 2018.1 through 2020.1
2019.1 2018.1 through 2019.1
2018.1 2018.1

ECP Interoperability

ECP, the routine compiler, and the object compiler are backward and forward compatible between IRIS versions. This means that ECP connections can connect any IRIS servers. However, application code on both ends of an ECP connection must be compatible. For example, if your code performs different business logic on different ECP servers, then your overall application behavior will be unpredictable.

Backup Restore Interoperability

Backups should always be restored on an InterSystems IRIS instance that is at least the same version as the backup. This is because an older version of InterSystems IRIS may not be able to process newer features.

Journal Restore Interoperability

To guarantee a successful journal restore, make sure the InterSystems IRIS instance is the same (or newer) version as the instance that created the journal file. If the InterSystems IRIS instance is an older version than the journal file, the journal restore may have unexpected results.

Mirror Interoperability

All members of a mirror must run on the same version of InterSystems IRIS. There are two exceptions:

  • Mirror members may have different versions only for the duration of a mirror upgrade. For information, see Upgrading a MirrorOpens in a new tab in the “Upgrading InterSystems IRIS” chapter of the Installation Guide.

  • Async members may have a different version than the other members of the mirror, as shown in the following table:

    Mirror Version Compatible Async Versions
    2022.2 2018.1 through 2022.2
    2022.1 2018.1 through 2022.1
    2021.2 2018.1 through 2021.2
    2021.1 2018.1 through 2021.2
    2020.4 2018.1 through 2020.4
    2020.3 2018.1 through 2020.4
    2020.2 2018.1 through 2020.4
    2020.1 2018.1 through 2020.4
    2019.1 2018.1 through 2019.4
    2018.1 2018.1

Studio Interoperability

The following table describes the version interoperability between Studio and InterSystems IRIS.

Studio Version Compatible InterSystems IRIS Versions
2022.2 2018.1 through 2022.2
2022.1 2018.1 through 2022.1
2021.2 2018.1 through 2021.2
2021.1 2018.1 through 2021.1
2020.4 2018.1 through 2020.4
2020.3 2018.1 through 2020.3
2020.2 2018.1 through 2020.2
2020.1 2018.1 through 2020.1
2019.1 2018.1 through 2019.1
2018.1 2018.1

xDBC Interoperability

The following table describes the version interoperability between xDBC (ODBC and JDBC) clients and servers.

Client Version Server Version
2022.2 2018.1 through 2022.2
2022.1 2018.1 through 2022.1
2021.2 2018.1 through 2021.2
2021.1 2018.1 through 2021.1
2020.4 2018.1 through 2020.4
2020.3 2018.1 through 2020.3
2020.2 2018.1 through 2020.2
2020.1 2018.1 through 2020.1
2019.1 2018.1 through 2019.1
2018.1 2018.1
FeedbackOpens in a new tab