Skip to content

Commit d156bb5

Browse files
authored
Merge pull request #2031 from lakshmyav/docs-editor/linux-support-ebpf-1732697199
Add documentation about ksplice issue
2 parents c4371bf + 42e1244 commit d156bb5

File tree

1 file changed

+19
-11
lines changed

1 file changed

+19
-11
lines changed

defender-endpoint/linux-support-ebpf.md

Lines changed: 19 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -15,7 +15,7 @@ ms.collection:
1515
ms.topic: conceptual
1616
ms.subservice: linux
1717
search.appverid: met150
18-
ms.date: 10/11/2024
18+
ms.date: 12/02/2024
1919
---
2020

2121
# Use eBPF-based sensor for Microsoft Defender for Endpoint on Linux
@@ -116,7 +116,9 @@ Post reboot, run the following command to check if audit rules were cleared:
116116
The output of previous command should show no rules or any user added rules. In case where the rules weren't removed, do the following steps to clear the audit rules file:
117117

118118
1. Switch to ebpf mode.
119+
119120
2. Remove the file `/etc/audit/rules.d/mdatp.rules`.
121+
120122
3. Reboot the machine.
121123

122124
### Troubleshooting and Diagnostics
@@ -131,23 +133,29 @@ uname -a
131133

132134
1. Enabling eBPF on RHEL 8.1 version with SAP might result in kernel panic. To mitigate this issue, you can take one of the following steps:
133135

134-
- Use a distro version higher than RHEL 8.1.
135-
- Switch to AuditD mode if you need to use RHEL 8.1 version.
136+
- Use a distro version higher than RHEL 8.1.
137+
- Switch to AuditD mode if you need to use RHEL 8.1 version.
136138

137139
2. Using Oracle Linux 8.8 with kernel version **5.15.0-0.30.20.el8uek.x86_64, 5.15.0-0.30.20.1.el8uek.x86_64** might result in kernel panic. To mitigate this issue, you can take one of the following steps:
138140

139-
- Use a kernel version higher or lower than **5.15.0-0.30.20.el8uek.x86_64, 5.15.0-0.30.20.1.el8uek.x86_64** on Oracle Linux 8.8 if you want to use eBPF as supplementary subsystem provider. The minimum kernel version for Oracle Linux is RHCK 3.10.0 and Oracle Linux UEK is 5.4.
140-
- Switch to AuditD mode if you need to use the same kernel version
141+
- Use a kernel version higher or lower than **5.15.0-0.30.20.el8uek.x86_64, 5.15.0-0.30.20.1.el8uek.x86_64** on Oracle Linux 8.8 if you want to use eBPF as supplementary subsystem provider. The minimum kernel version for Oracle Linux is RHCK 3.10.0 and Oracle Linux UEK is 5.4.
142+
- Switch to AuditD mode if you need to use the same kernel version
141143

142-
```bash
143-
sudo mdatp config ebpf-supplementary-event-provider --value disabled
144-
```
144+
```bash
145+
sudo mdatp config ebpf-supplementary-event-provider --value disabled
146+
```
147+
148+
- The following two sets of data help analyze potential issues and determine the most effective resolution options.
149+
150+
1. Collect a diagnostic package from the client analyzer tool by using the following instructions: [Troubleshoot performance issues for Microsoft Defender for Endpoint on Linux](linux-support-perf.md).
145151

146-
The following two sets of data help analyze potential issues and determine the most effective resolution options.
152+
2. Collect a debug diagnostic package when Defender for Endpoint is utilizing high resources by using the following instructions: [Microsoft Defender for Endpoint on Linux resources](linux-resources.md#collect-diagnostic-information).
147153

148-
1. Collect a diagnostic package from the client analyzer tool by using the following instructions: [Troubleshoot performance issues for Microsoft Defender for Endpoint on Linux](linux-support-perf.md).
154+
3. System hangs on Oracle Linux 7.9 running Defender for Linux when ksplice is used for live kernel patching.
149155

150-
2. Collect a debug diagnostic package when Defender for Endpoint is utilizing high resources by using the following instructions: [Microsoft Defender for Endpoint on Linux resources](linux-resources.md#collect-diagnostic-information).
156+
- Auto-install patching of ksplice simply adds a cron job to the endpoint.
157+
- To mitigate the hang issue, you can create a cron job which will first stop the mdatp service, apply ksplice based patching, then start the service.
158+
- As kernel patching is few seconds activity so this will not have major exposure in terms of security.
151159

152160
#### Troubleshooting performance issues
153161

0 commit comments

Comments
 (0)