Resolving the Microsoft ODBC Driver 18 Prerequisite Error During Configuration Manager 2503 Upgrade

Upgrading to Microsoft Configuration Manager (ConfigMgr) version 2503 is a critical step for IT administrators aiming to leverage the latest security enhancements and bug fixes. However, many have encountered a recurring issue during the prerequisite check

[Failed]: Install the Microsoft ODBC driver 18 for SQL setup from https://go.microsoft.com/fwlink/?linkid=2220989.

This error often appears even when the ODBC Driver 18 is already installed. This article delves into the root cause of this problem and provides a comprehensive solution.

Understanding the Issue

The Configuration Manager 2503 prerequisite checker mandates the installation of the Microsoft ODBC Driver 18 for SQL Server. However, the link provided in the error message (https://go.microsoft.com/fwlink/?linkid=2220989) directs users to an outdated version of the driver. Consequently, even if a version of the driver is installed, the prerequisite check may fail if it’s not the expected version.

Administrators have reported that installing the driver from the provided link results in a message indicating that a newer version is already present, yet the prerequisite check continues to fail. This inconsistency stems from the prerequisite checker not recognizing newer versions of the driver – Reddit – System Center Dudes

To resolve this issue, it’s essential to ensure that the correct version of the Microsoft ODBC Driver 18 for SQL Server is installed. The recommended version is 18.5.1.1 or later.

Step 1: Uninstall Existing ODBC Driver 18 Versions

Before installing the correct version, remove any existing installations of the ODBC Driver 18:

  1. Open Control Panel.
  2. Navigate to Programs and Features.
  3. Locate Microsoft ODBC Driver 18 for SQL Server.
  4. Right-click and select Uninstall.

Step 2: Download and Install the Correct Version

Download the latest version of the ODBC Driver 18 for SQL Server (version 18.5.1.1 or later) from the official Microsoft website:

Choose the appropriate installer based on your system architecture (e.g., x64).

Step 3: Re-run the Prerequisite Check

After installing the correct version:

  1. Open the Configuration Manager Console.
  2. Navigate to Administration > Updates and Servicing.
  3. Right-click on the Configuration Manager 2503 update and select Run prerequisite check.

The check should now pass without errors related to the ODBC driver.

Additional Considerations

  • Multiple ODBC Versions: Some administrators have multiple versions of the ODBC driver installed (e.g., versions 17, 18, and 19). While multiple versions can coexist, ensure that version 18.5.1.1 or later is present, as it’s the one recognized by the prerequisite checker.
  • Silent Installation: For automated deployments, the ODBC driver can be installed silently using the following command: bashCopyEditmsiexec /i msodbcsql18.msi /quiet /norestart

Replace msodbcsql18.msi with the actual filename of the downloaded installer.

  • Verify Installation: After installation, verify the driver version:
    1. Open ODBC Data Source Administrator.
    2. Navigate to the Drivers tab.
    3. Ensure that ODBC Driver 18 for SQL Server is listed with version 18.5.1.1 or later.

Conclusion

The prerequisite check failure during the Configuration Manager 2503 upgrade, related to the Microsoft ODBC Driver 18 for SQL Server, is primarily due to version discrepancies. By uninstalling outdated versions and installing the recommended version 18.5.1.1 or later, administrators can ensure a smooth upgrade process.

References

Leave a Reply

This site uses Akismet to reduce spam. Learn how your comment data is processed.