Skip to content

Commit

Permalink
Merge pull request kmesh-net#565 from Okabe-Rintarou-0/docs/enhance_k…
Browse files Browse the repository at this point in the history
…ernel

add document about using enhanced kernel
  • Loading branch information
kmesh-bot authored Jul 12, 2024
2 parents de74f6b + 18b35d4 commit 8dce347
Show file tree
Hide file tree
Showing 3 changed files with 32 additions and 2 deletions.
4 changes: 2 additions & 2 deletions docs/kmesh_deploy_and_develop_in_kind.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# Kmesh Deploy and Develop in Kind

[Kind](https://github.com/kubernetes-sigs/kind) is a convenient tool for quickly deploying kubernetes cluster locally. We can use `kind` to create an `istio` cluster and deploy `kmesh` on it.
[Kind](https://github.com/kubernetes-sigs/kind) is a convenient tool for quickly deploying kubernetes cluster locally. We can use `kind` to create an `istio` cluster and deploy `kmesh`.

## Deploy Kmesh in Kind

Expand Down Expand Up @@ -143,7 +143,7 @@ You can follow the steps below to develop in kind:
make clean
```
to cleanup this changes before you execute `git add` command.
to cleanup these changes before you execute `git add` command.
## Reference
+ Getting Started: https://istio.io/latest/docs/ambient/getting-started/
Expand Down
30 changes: 30 additions & 0 deletions docs/kmesh_use_enhanced_kernel.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,30 @@
# Use Enhanced Kernel in Kmesh

Some features of kmesh depend on enhanced kernel (e.g., L7 traffic control in ads mode). To utilize it, you can use `openEuler 23.03`, which natively supports all features.

You can follow the steps below to use enhanced kernel:

+ Download `openEuler 23.03` image on: https://repo.openeuler.org/openEuler-23.03/ISO/.
+ Install the operation system: Here, we take [VMware](https://www.vmware.com/products/workstation-pro/html.html) for example (you can also use other VM management tools).

![](./pics/install_openEuler.png)

Notice that `openEuler 23.03`'s kernel version is **6.1.19**. So you should select `其他 Linux 6.x 内核 64位`(`Linux 6.x kernel 64bit`).

Then, you can follow the [official blog](https://www.openeuler.org/zh/blog/20240306vmware/20240306vmware.html) to install it.

+ Install kernel headers: Kmesh determines whether the enhanced kernel is utilized according to some kernel headers(e.g., `bpf.h`). So, you should install kernel headers by:

```shell
yum install kernel-headers
```

Then, you should be able to find the kernel headers in the path `/usr/include/linux`.

+ Check whether you are ready to use enhanced kernel:

```shell
grep -q "FN(parse_header_msg)" /usr/include/linux/bpf.h && echo "enhanced" || echo "unenhanced"
```

Now you can follow the [deploy and develop guide](./kmesh_deploy_and_develop_in_kind.md) to explore kmesh's full features.
Binary file added docs/pics/install_openEuler.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.

0 comments on commit 8dce347

Please sign in to comment.