Installation Guide

  • 2022.3
  • 09/08/2022
  • Public Content


Integration into Visual Studio* fails for oneAPI 2022.1 and lower versions of toolkits

During installation of 2022.1 and lower versions of toolkits, integration into Visual Studio* fails on systems with Visual Studio* 2022 installed.
: Incompatibility between oneAPI installers and recent changes in the
library provided by Microsoft as part of the Visual Studio 2022 installation.
: Upgrade to the latest version of the oneAPI toolkit. Alternatively, before installing 2022.1 and lower toolkit packages, remove Visual Studio* 2022 from your system. For more information about the available workarounds, refer to Known Microsoft* Visual Studio 2022 and oneAPI Toolkits Installation Issue.

Integrity check fails

During installation, you may get an error message about failed integrity check of downloaded files.
: Downloaded files are corrupted because of the hard drive corruption.
: Check hard drive health and restart the installation.

2021.x installation overwrites existing 2022.x installer

If you launch the installer for the 2021.x version of a toolkit on a system with the 2022.x version installed, your existing 2022.x installer will be downgraded to the 2021.x version. The 2021.x installer does not recognize installed 2022.x packages.
: Compatibility issue between 2022.x and 2021.x versions of the installer.
: Restore the latest installer by launching the installer for the 2022.x version of the toolkit. In future, when you need to install 2021.x on a system with 2022.x installed, before launching the installer, back up the following installer directories by renaming them:
  • 32-bit system:
    C:\Program Files\Intel\oneAPI\Installer
    C:\Program Files\Intel\PackageManager\1.0
  • 64-bit system:
    C:\Program Files (x86)\Intel\oneAPI\Installer
    C:\Program Files (x86)\Intel\PackageManager\1.0
When you are done with 2021.x, you can change back the directory names to restore the 2022.x installer.

Product and Performance Information


Performance varies by use, configuration and other factors. Learn more at