Upgrade from SCOM 2022 UR3 to SCOM 2025 Fails Due to Unix MP Compatibility Issue

Customers upgrading from System Center Operations Manager (SCOM) 2022 UR3 to SCOM 2025 RTM may encounter a setup failure during the management pack import phase. In affected environments, setup rolls back the entire upgrade after detecting compatibility issues in the Microsoft.Unix.Library management pack.

Symptoms

During the upgrade, setup attempts to replace the existing Microsoft.Unix.Library management pack in the Operations Manager database with the version shipped in the SCOM 2025 RTM installation media.

The upgrade may fail with an error similar to:

Version 10.25.1005.0 of the management pack is not upgrade compatible with older version 10.22.1330.0. Compatibility check failed with 6 errors.

Setup retries the import several times and eventually enters rollback mode:

StartingRollBack

The upgrade then fails.

What Causes the Failure?

Although SCOM 2025 is a newer product release, the issue is caused by differences between the Microsoft.Unix.Library management pack included in SCOM 2022 UR3 and the version included in SCOM 2025 RTM.

An update that was introduced in SCOM 2022 UR3 is not present in the SCOM 2025 RTM code line which was released a few months earlier than SCOM 2022 UR3. As a result, the in-box Microsoft.Unix.Library management pack shipped with SCOM 2025 RTM is missing some elements that exist in the SCOM 2022 UR3 version.

When the upgrade validator compares the customer’s installed management pack against the version being imported from the SCOM 2025 media, it detects these missing elements as breaking changes and blocks the upgrade.

Validation Errors Reported

The compatibility validator reports six errors.

Missing Module Definitions

The SCOM 2022 UR3 version of Microsoft.Unix.Library contains the following module definitions that are not present in the SCOM 2025 RTM in-box management pack:

Microsoft.Unix.ShellCommand.ProbeAction
Microsoft.Unix.TimedShellCommand.DataSource
Microsoft.Unix.ShellCommand.MatchesRegExp.TwoState.MonitorType

From the validator’s perspective, removing these public management pack elements is not upgrade compatible.

ValidityYears Parameter Regression

The remaining validation errors are related to the ValidityYears overrideable parameter used by certificate-related write actions:

Microsoft.Unix.SCXCert.WriteAction
Microsoft.Unix.SSHBased.Cert.Signing.WriteAction

The validator reports that:

  • Schema validation fails on the <ValidityYears> element.
  • The public overrideable parameter ValidityYears is no longer available in the SCOM 2025 RTM version.

Because overrideable parameters are part of the management pack’s public interface, their removal is treated as a compatibility violation.

Root Cause

The root cause is that changes delivered in SCOM 2022 UR3 does not exist in SCOM 2025 RTM branch. Consequently, customers upgrading from SCOM 2022 UR3 are effectively attempting to import a Microsoft.Unix.Library management pack that lacks functionality and public definitions present in their currently installed version.

The management pack upgrade validator correctly identifies these regressions and blocks the import, causing setup to roll back.

Resolution

Microsoft Product Group is aware of the issue and working on a solution. Further information can be accessed through a support case with Microsoft CSS

Conclusion

If you are upgrading from SCOM 2022 UR3 to SCOM 2025 RTM and encounter Microsoft.Unix.Library compatibility errors followed by a rollback, the issue is likely caused by management pack content that exists in SCOM 2022 UR3 but is missing from the SCOM 2025 RTM in-box version. Microsoft is working on the issue and will be publishing a solution soon. To have more information on the subject please raise a support ticket in Microsoft CSS before proceeding with the upgrade.

Leave a Comment