Release notes overview

This section contains release notes for Itential Automation Gateway (IAG) versions 4.3, 2023.3, and 2023.2. Each changelog entry lists the bug fixes, improvements, and security updates included in that version.

IAG versioning practices

All supported versions of IAG are assigned unique identifiers (version numbers) to help manage different versions and releases of the software to ensure customers can access the correct version they need.

Here’s an explanation of how Itential names IAG versions to help you understand the nature of changes between versions:

  • Component version — This identifies the build version of the Platform application (i.e., IAG) distributed in a maintenance release. For each change made to the source code as part of a development build, whether it’s a bug fix or improvement, there is a component version bump. Components are versioned independently of product release versions. Also, multiple builds can be created for a single release version.

  • Release version — This identifies the Platform release version of IAG made available to customers in a maintenance release. Release versioning helps to track different iterations of the software and increments each month as part of the maintenance release.

Each versioning scheme is purposely designed to provide a structured mechanism of releasing and tracking Itential’s product versions, enabling developers to identify bugs more efficiently and maintain code integrity.

If you need additional support or require more information about Itential’s versioning, contact our Product Support Team.

Release types

As of IAG 4.3, Itential uses semantic versioning in the format MAJOR.MINOR.MTCE:

  • Major releases introduce breaking changes or significant architectural updates that may require action before upgrading.
  • Minor releases introduce new capabilities and enhancements. They increment the minor version number (for example, 4.3.0 → 4.4.0 → 4.5.0).
  • Maintenance releases deliver bug fixes and security patches. They increment the patch version number (for example, 4.3.0 → 4.3.1 → 4.3.2).

Tags

Each changelog entry is tagged to help you quickly identify what kind of changes the release contains.

TagMeaning
feature-releaseIntroduces new features or significant enhancements
maintenance-releaseContains bug fixes, security patches, or minor improvements
bug-fixIncludes one or more resolved defects
securityIncludes one or more security fixes
breaking-changeContains a change that may require action before upgrading
iag/4.3Affects IAG version 4.3
iag/2023.3Affects IAG version 2023.3
iag/2023.2Affects IAG version 2023.2

Upgrading

Before upgrading, review the release notes for every version between your current version and your target version. Pay particular attention to any releases tagged breaking-change.

IAG compatibility with Itential Platform

All supported versions of Itential Automation Gateway (IAG) are tested for compatibility with all supported versions of Itential Platform. New features added in various versions of IAG might not be available in all versions of Itential Platform because a specific version of the Platform may lack the functionality to make use of that feature.

Refer to the following table to identify the IAG versions compatible with Itential Platform versions.

Itential Platform versionIAG/2022.1IAG/2023.1IAG/2023.2IAG/2023.3IAG/4.3IAG/5.1IAG/5.2IAG/5.3
Itential CloudYesYesYesYesYesYesYesYes
Platform 6YesYesYesYesYesYesYesYes
2023.2YesYesYesYesYesYesYesYes
2023.1YesYesYesYesYesNoNoNo
2022.1YesYesYesYesYesNoNoNo

If a version of Itential Platform does not provide support for a feature in a version of IAG, the versions remain compatible, but Itential Platform will not be able to use that feature in IAG.