Skip to main content

Supported Version Interoperability

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

Note:

Throughout this topic, “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.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 version interoperability depends on the use case:

  • To run object-based applications over ECP, the server and the clients must use the same product version (to ensure the data dictionary is the same).

  • To run routine code over ECP, the code must be compiled on the oldest version in use. The code can be compiled either client- or server-side.

    The compiler is backwards compatible in most cases, but not forwards compatible. This means that if the client and server run different product versions and both need to run the routine code, that code must be compiled on the oldest product version in use.

The following table describes ECP interoperability for all other situations.

ECP Database Server Version ECP Application Server Version
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

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 Mirror 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.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.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.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
Feedback