Merge pull request #6952 from dbyrdaquent/dbyrdaquent_copyedit_itpro-docs_4068142

Edit pass for Update mac-support-install.md. DO NOT MERGE.
This commit is contained in:
Tina Burden 2020-06-26 14:55:54 -07:00 committed by GitHub
commit fe116470b8
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23

View File

@ -25,9 +25,9 @@ ms.topic: conceptual
## Installation failed ## 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. For manual installation, the Summary page of the installation wizard 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 displays 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: While we do not display an 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 ```bash
$ sed -n 'H; /^preinstall com.microsoft.wdav begin/h; ${g;p;}' /Library/Logs/Microsoft/mdatp/install.log $ sed -n 'H; /^preinstall com.microsoft.wdav begin/h; ${g;p;}' /Library/Logs/Microsoft/mdatp/install.log
@ -39,13 +39,13 @@ correlation id=CB509765-70FC-4679-866D-8A14AD3F13CC
preinstall com.microsoft.wdav end [2020-03-11 13:08:49 -0700] 804 => 1 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]`. In this example, the actual reason is prefixed with `[ERROR]`.
The installation failed because a downgrade between these versions is not supported. The installation failed because a downgrade between these versions is not supported.
## No MDATP's install log ## MDATP install log missing or not updated
In rare cases installation leaves no trace in MDATP's /Library/Logs/Microsoft/mdatp/install.log file. 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; You can verify that an installation happened and analyze possible errors by querying macOS logs (this is helpful in case of MDM deployment, when there is no client UI). We recommend that you use a narrow time window to run a query, and that you filter by the logging process name, as there will be a huge amount of information.
```bash ```bash
grep '^2020-03-11 13:08' /var/log/install.log grep '^2020-03-11 13:08' /var/log/install.log