MID Server version compatibility

The version of the MID Server must be compatible with the version of the instance. Otherwise, the MID Server cannot process commands or communicate with the instance.

The instance determines which version of the MID Server is allowed. The MID Server version must at minimum belong to the same major release, such as Helsinki. If the MID Server version belongs to the same major release, it can, but does not have to, belong to the same minor version, such as Helsinki Patch 1. In this case, communication with the instance might still be possible, but it is always suggested that you upgrade to the latest version.

Caution: You can pin the MID Server to a specific version using the mid.version.override property, but you should be aware that the version might become out of date.

For more information on upgrades, see MID Server upgrade.

Version indicators

If the version is not compatible, the MID Server status is not changed to Down in the MID Server dashboard. So it might still appear to be processing commands when it actually is not doing so. You must check the MID Server Version on the dashboard, which is available starting with the Istanbul release.

The icons in the Version column indicates the following:
  • Red: Incompatible. The MID Server and instance do not belong to the same release. You must upgrade the MID Server and verify that it is not pinned to an older version with the mid.version.override property. The MID Server will not be upgraded until the parameter is cleared.
  • Yellow: Compatible, but an upgrade is recommended. This indicates that the MID Server version belongs to the same family as the instance, but not the same version.
  • Green: Compatible. No upgrade necessary.
  • Gray: Incompatible. The instance cannot detect the version.

See KB0535181 for additional MID Server troubleshooting information.