diff --git a/windows/security/threat-protection/TOC.md b/windows/security/threat-protection/TOC.md index 2ac8e45d32..469233f242 100644 --- a/windows/security/threat-protection/TOC.md +++ b/windows/security/threat-protection/TOC.md @@ -315,6 +315,7 @@ ###### [Set preferences](microsoft-defender-atp/mac-preferences.md) ###### [Detect and block Potentially Unwanted Applications](microsoft-defender-atp/mac-pua.md) ##### [Troubleshoot]() +###### [Troubleshoot installation issues](microsoft-defender-atp/mac-support-install.md) ###### [Troubleshoot performance issues](microsoft-defender-atp/mac-support-perf.md) ###### [Troubleshoot kernel extension issues](microsoft-defender-atp/mac-support-kext.md) ##### [Privacy](microsoft-defender-atp/mac-privacy.md) diff --git a/windows/security/threat-protection/microsoft-defender-atp/mac-support-install.md b/windows/security/threat-protection/microsoft-defender-atp/mac-support-install.md new file mode 100644 index 0000000000..564bfecdbd --- /dev/null +++ b/windows/security/threat-protection/microsoft-defender-atp/mac-support-install.md @@ -0,0 +1,54 @@ +--- +title: Troubleshoot installation issues for Microsoft Defender ATP for Mac +description: Troubleshoot installation issues in Microsoft Defender ATP for Mac. +keywords: microsoft, defender, atp, mac, install +search.product: eADQiWindows 10XVcnh +search.appverid: met150 +ms.prod: w10 +ms.mktglfcycl: deploy +ms.sitesec: library +ms.pagetype: security +ms.author: dansimp +author: dansimp +ms.localizationpriority: medium +manager: dansimp +audience: ITPro +ms.collection: M365-security-compliance +ms.topic: conceptual +--- + +# Troubleshoot installation issues for Microsoft Defender ATP for Mac + +**Applies to:** + +- [Microsoft Defender Advanced Threat Protection (Microsoft Defender ATP) for Mac](microsoft-defender-atp-mac.md) + +## Installation failed + +For manual installation, it is Summary page of the installation wizard that says "An error occurred during installation. The Installer encountered an error that caused the installation to fail. Contact the software manufacturer for assistance". For MDM deployments it would be exposed as a generic installation failure as well. + +While we do not expose exact error to the end user, we keep a log file with installation progress in `/Library/Logs/Microsoft/mdatp/install.log`. Each installation session appends to this log file, you can use `sed` to output the last installation session only: + +```bash +$ sed -n 'H; /^preinstall com.microsoft.wdav begin/h; ${g;p;}' /Library/Logs/Microsoft/mdatp/install.log + +preinstall com.microsoft.wdav begin [2020-03-11 13:08:49 -0700] 804 +INSTALLER_SECURE_TEMP=/Library/InstallerSandboxes/.PKInstallSandboxManager/CB509765-70FC-4679-866D-8A14AD3F13CC.activeSandbox/89FA879B-971B-42BF-B4EA-7F5BB7CB5695 +correlation id=CB509765-70FC-4679-866D-8A14AD3F13CC +[ERROR] Downgrade from 100.88.54 to 100.87.80 is not permitted +preinstall com.microsoft.wdav end [2020-03-11 13:08:49 -0700] 804 => 1 +``` + +In the example above the actual reason is prefixed with `[ERROR]`. +The installation failed because a downgrade between these versions is not supported. + +## No MDATP's install log + +In rare cases installation leaves no trace in MDATP's /Library/Logs/Microsoft/mdatp/install.log file. +You can verify that installation happened and analyze possible errors by querying macOS logs (this can be helpful in case of MDM deployment, when there is no client UI). It is recommended to have a narrow time window to query and filter by the logging process name, as there will be huge amount of information; + +```bash +grep '^2020-03-11 13:08' /var/log/install.log + +log show --start '2020-03-11 13:00:00' --end '2020-03-11 13:08:50' --info --debug --source --predicate 'processImagePath CONTAINS[C] "install"' --style syslog +```