fixed warnings and made edits

diannegali · diannegali · commit b1e21e7b814a · 2024-12-20T15:48:13.000Z
diff --git a/defender-endpoint/linux-deploy-defender-for-endpoint-with-chef.md b/defender-endpoint/linux-deploy-defender-for-endpoint-with-chef.md
@@ -15,7 +15,7 @@ ms.collection:
 ms.topic: conceptual
 ms.subservice: linux
 search.appverid: met150
-ms.date: 12/16/2024
+ms.date: 12/20/2024
 ---
 
 # Deploy Defender for Endpoint on Linux with Chef
@@ -29,33 +29,34 @@ ms.date: 12/16/2024
 
 ## Introduction
 
-This article talks about how to deploy Defender for Endpoint on Linux at scale with chef using two methods, installer script and by manually configuring the repositories for more granular control over the deployment.
+This article talks about how to deploy Defender for Endpoint on Linux at scale with Chef using two methods:
 
-## Prerequisites and system requirements
+1. Install using installer script
+2. Manually configuring the repositories for more granular control over the deployment
+
+## Prerequisites
 
 For a description of prerequisites and system requirements, see [Microsoft Defender for Endpoint on Linux](/defender-endpoint/microsoft-defender-endpoint-linux).
 
 ## Download the onboarding package
 
-Download the onboarding package from Microsoft Defender portal.
-
-In the [Microsoft Defender portal](https://security.microsoft.com/), go to **Settings** > **Endpoints** > **Device management** > **Onboarding**.
+1. Sign in to the [Microsoft Defender portal](https://security.microsoft.com/) then navigate to **Settings** > **Endpoints** > **Device management** > **Onboarding**.
 
-In the first drop-down menu, select **Linux Server** as the operating system. In the second drop-down menu, select **Your preferred Linux configuration management tool** as the deployment method.
+2. In the first drop-down menu, select **Linux Server** as the operating system. In the second drop-down menu, select **Your preferred Linux configuration management tool** as the deployment method.
 
-1. Select **Download onboarding package**. Save the file as `WindowsDefenderATPOnboardingPackage.zip`.
+3. Select **Download onboarding package** and save the file as `WindowsDefenderATPOnboardingPackage.zip`.
 
-   ![The option to download the onboarded package.](https://learn.microsoft.com/en-us/defender-endpoint/media/portal-onboarding-linux-2.png)
+   ![The option to download the onboarded package.](https://learn.microsoft.com/defender-endpoint/media/portal-onboarding-linux-2.png)
    
-1. Extract the contents of the archive:
+4. Extract the contents of the archive using the following command:
 
    Command:
    
    ```
    unzip WindowsDefenderATPOnboardingPackage.zip
    ```
    
-   Output:
+   The expected output is:
    
    ```
    Archive:  WindowsDefenderATPOnboardingPackage.zip
@@ -64,75 +65,70 @@ In the first drop-down menu, select **Linux Server** as the operating system. In
    
 ## Create a directory structure
 
-Before you begin, make sure the Chef components are already installed and a Chef repository exists (chef generate repo <reponame>) to store the cookbook that's used to deploy to Defender for Endpoint on Chef managed Linux servers.
+Before you begin, ensure the Chef components are already installed and a Chef repository (chef generate repo &lt;reponame&gt;) exists to store the cookbook that's used to deploy to Defender for Endpoint on Chef-managed Linux servers.
 
-This command creates a new folder structure for the new cookbook called mdatp. You can also use an existing cookbook if you already have one you'd like to use to add the Defender for Endpoint deployment into.
+The following command creates a new folder structure for the new cookbook called **mdatp**. You can also use an existing cookbook if you already have one you'd like to use to add the Defender for Endpoint deployment into.
 
 ```bash
 chef generate cookbook mdatp
 ```
 
-After the cookbook is created, create a files folder inside the cookbook folder that just got created:
+After the cookbook is created, create a files folder inside the cookbook folder that you created:
 
 ```bash
 mkdir mdatp/files
 ```
 
 Copy `mdatp_onboard.json` to the `/tmp` folder.
 
-On the Chef Workstation, navigate to the mdatp/recipes folder. This folder is created when the cookbook was generated. Use your preferred text editor (like vi or nano) to add the following instructions to the end of the default.rb file:
+On the Chef Workstation, navigate to the **mdatp/recipes** folder, which is automatically created when the cookbook is generated. Use your preferred text editor (like vi or nano) to add the following instructions to the end of the **default.rb** file then save and close the file:
 
 - include_recipe '::install_mdatp'
 
-Then save and close the default.rb file.
-
 ## Create a cookbook 
 
-Cookbook can be created via two methods:
-
-1. create a  cookbook using installer script
+A cookbook can be created through any of the following methods:
 
-1. create a cookbook by manually configuring repositories
+- [Using an installer script](linux-deploy-defender-for-endpoint-with-chef.md#create-a-cookbook-using-installer-script)
+- [Manually configuring repositories](linux-deploy-defender-for-endpoint-with-chef.md#create-a-cookbook-by-manually-configuring-repositories)
 
-### Create a cookbook using Installer script
+### Create a cookbook using installer script
 
-1. Download the installer bash script. Pull the [installer bash script](https://github.com/microsoft/mdatp-xplat/blob/master/linux/installation/mde_installer.sh) from Microsoft GitHub Repository or use the following command to download it.
+1. Download the installer bash script. Pull the [installer bash script](https://github.com/microsoft/mdatp-xplat/blob/master/linux/installation/mde_installer.sh) from Microsoft GitHub Repository or use the following command to download it:
 
+   ```bash
+   wget https://raw.githubusercontent.com/microsoft/mdatp-xplat/refs/heads/master/linux/installation/mde_installer.sh /tmp
+   ```
 
-```bash
-  wget https://raw.githubusercontent.com/microsoft/mdatp-xplat/refs/heads/master/linux/installation/mde_installer.sh /tmp
-```
-
-2. Next create a new recipe file named install_mdatp.rb in the recipes folder `~/cookbooks/mdatp/recipes/install_mdatp.rb` and add this text to the file. You can also download the file directly from [GitHub](https://github.com/microsoft/mdatp-xplat/blob/master/linux/installation/third_party_installation_playbooks/chef.install_mdatp_simplified.rb)
+2. Create a new recipe file named **install_mdatp.rb** in the recipes folder `~/cookbooks/mdatp/recipes/install_mdatp.rb` and add the following text to the file. You can also download the file directly from [GitHub](https://github.com/microsoft/mdatp-xplat/blob/master/linux/installation/third_party_installation_playbooks/chef.install_mdatp_simplified.rb).
 
-```bash
-mdatp = "/etc/opt/microsoft/mdatp"
+   ```bash
+   mdatp = "/etc/opt/microsoft/mdatp"
 
-#Download the onboarding json from tenant, keep the same at specific location
-onboarding_json = "/tmp/mdatp_onboard.json"
+   #Download the onboarding json from tenant, keep the same at specific location
+   onboarding_json = "/tmp/mdatp_onboard.json"
 
-#Download the installer script from: https://github.com/microsoft/mdatp-xplat/blob/master/linux/installation/mde_installer.sh
-#Place the same at specific location, edit this if needed
-mde_installer= "/tmp/mde_installer.sh"
+   #Download the installer script from: https://github.com/microsoft/mdatp-xplat/blob/master/linux/installation/mde_installer.sh
+   #Place the same at specific location, edit this if needed
+   mde_installer= "/tmp/mde_installer.sh"
 
 
-## Invokve the mde-installer script 
-bash 'Installing mdatp using mde-installer' do
-  code <<-EOS
-  chmod +x #{mde_installer}
-  #{mde_installer} --install --onboard #{onboarding_json}
-  EOS
-end
-```
+   ## Invoke the mde-installer script 
+   bash 'Installing mdatp using mde-installer' do
+       code <<-EOS
+       chmod +x #{mde_installer}
+       #{mde_installer} --install --onboard #{onboarding_json}
+       EOS
+   end
+   ```
 
->[!Note]
->Installer script also supports other parameters such as channel, realtime protection, version, etc. To select from the list of available options, check help.
+> [!NOTE]
+> The installer script also supports other parameters such as channel, realtime protection, version, etc. To select from the list of available options, check help through the following command:
 >```./mde_installer.sh --help```
 
-
 ### Create a cookbook by manually configuring repositories
 
-Create a new recipe file named install_mdatp.rb in the recipes folder `~/cookbooks/mdatp/recipes/install_mdatp.rb` and add this text to the file. You can also download the file directly from [Github](https://github.com/microsoft/mdatp-xplat/blob/master/linux/installation/third_party_installation_playbooks/chef.install_mdatp_manual.rb)
+Create a new recipe file named **install_mdatp.rb** in the recipes folder `~/cookbooks/mdatp/recipes/install_mdatp.rb` and add the following text to the file. You can also download the file directly from [Github](https://github.com/microsoft/mdatp-xplat/blob/master/linux/installation/third_party_installation_playbooks/chef.install_mdatp_manual.rb).
 
 ```powershell
 #Add Microsoft Defender
@@ -187,19 +183,18 @@ file "#{mdatp}/mdatp_onboard.json" do
 end
 ```
 
->[!Note]
-> You can modify the os distribution, distribution version number, channel (prod/insider-fast, insiders-slow) and repo name to match the version you're deploying to and the channel you'd like to deploy to.. 
-Run `chef-client --local-mode --runlist  'recipe[mdatp]'` to test the cookbook on the Chef workstation.
+>[!NOTE]
+> You can modify the os distribution, distribution version number, channel (prod/insider-fast, insiders-slow) and repo name to match the version you're deploying to and the channel you'd like to deploy to. Run `chef-client --local-mode --runlist  'recipe[mdatp]'` to test the cookbook on the Chef workstation.
 
 ## Troubleshoot installation issues
 
-For self-troubleshooting, do the following
+To troubleshoot issues:
 
 1. For information on how to find the log that's generated automatically when an installation error occurs, see [Log installation issues](linux-resources.md#log-installation-issues).
 
 2. For information about common installation issues, see [Installation issues](/defender-endpoint/linux-support-install).
 
-3. If health of the device is `false`, see [Defender for Endpoint agent health issues](/defender-endpoint/health-status).
+3. If the health of the device is `false`, see [Defender for Endpoint agent health issues](/defender-endpoint/health-status).
 
 4. For product performance issues, see [Troubleshoot performance issues](/defender-endpoint/linux-support-perf).
 
@@ -209,15 +204,14 @@ To get support from Microsoft, open a support ticket, and provide the log files
 
 ## How to configure policies for Microsoft Defender on Linux
 
-You can configure antivirus or EDR settings on your endpoints using following methods:
+You can configure antivirus or EDR settings on your endpoints using any of the following methods:
 
 - See [Set preferences for Microsoft Defender for Endpoint on Linux](/defender-endpoint/linux-preferences).
 - See [security settings management](/mem/intune/protect/mde-security-integration) to configure settings in the Microsoft Defender portal.
 
-
 ## Uninstall MDATP cookbook
 
-To uninstall Defender, save the following as cookbook `~/cookbooks/mdatp/recipes/uninstall_mdatp.rb`. 
+To uninstall Defender, save the following as a cookbook `~/cookbooks/mdatp/recipes/uninstall_mdatp.rb`.
 
 ```powershell
 #Uninstall the Defender package
@@ -240,6 +234,6 @@ then
 end
 ```
 
-To include this step as part of the recipe just add `include_recipe ':: uninstall_mdatp` to your `default.rb` file within the recipe folder. Also make sure to remove the `include_recipe '::install_mdatp'` from the `default.rb` file.
+To include this step as part of the recipe, add `include_recipe ':: uninstall_mdatp` to your `default.rb` file within the recipe folder. Ensure that you have removed the `include_recipe '::install_mdatp'` from the `default.rb` file.
 
 [!INCLUDE [Microsoft Defender for Endpoint Tech Community](../includes/defender-mde-techcommunity.md)]
