Skip to content

Commit ad77d72

Browse files
deprecate warning about stt (#326)
* deprecate warning about stt Signed-off-by: Mengxin Liu <[email protected]> * Update docs/advance/performance-tuning.en.md Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com> * Update docs/advance/performance-tuning.en.md Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com> --------- Signed-off-by: Mengxin Liu <[email protected]> Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com> (cherry picked from commit 5b0ed95)
1 parent c783760 commit ad77d72

File tree

2 files changed

+18
-10
lines changed

2 files changed

+18
-10
lines changed

docs/advance/performance-tuning.en.md

Lines changed: 9 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@ The community will continue to iterate on the performance.
77
Some general performance optimizations have been integrated into the latest version,
88
so it is recommended to use the latest version to get better default performance.
99

10-
For more on the process and methodology of performance optimization, please watch the video [Kube-OVN 容器性能优化之旅](https://www.bilibili.com/video/BV1zS4y1T73m?share_source=copy_web).
10+
For more on the process and methodology of performance optimization, please watch the video [Kube-OVN 容器性能优化之旅](https://www.bilibili.com/video/BV1zS4y1T73m?share_source=copy_web){: target="_blank" }.
1111

1212
## Benchmarking
1313

@@ -119,7 +119,7 @@ ethtool -G eno1 tx 4096
119119

120120
### Optimize with tuned
121121

122-
[tuned](https://tuned-project.org/) can use a series of preconfigured profile files to perform system optimizations for a specific scenario.
122+
[tuned](https://tuned-project.org/){: target="_blank" } can use a series of preconfigured profile files to perform system optimizations for a specific scenario.
123123

124124
For latency-first scenarios:
125125

@@ -208,7 +208,7 @@ yum install -y gcc kernel-devel-$(uname -r) python3 autoconf automake libtool rp
208208
Compile the OVS kernel module and generate the corresponding RPM:
209209

210210
```bash
211-
git clone -b branch-2.17 --depth=1 https://github.com/openvswitch/ovs.git
211+
git clone -b branch-3.5 --depth=1 https://github.com/openvswitch/ovs.git
212212
cd ovs
213213
curl -s https://github.com/kubeovn/ovs/commit/2d2c83c26d4217446918f39d5cd5838e9ac27b32.patch | git apply
214214
./boot.sh
@@ -220,7 +220,7 @@ cd rpm/rpmbuild/RPMS/x86_64/
220220
Copy the RPM to each node and install:
221221

222222
```bash
223-
rpm -i openvswitch-kmod-2.15.2-1.el7.x86_64.rpm
223+
rpm -i openvswitch-kmod-3.5.1-1.el7.x86_64.rpm
224224
```
225225

226226
If you have previously started Kube-OVN and the older version of the OVS module has been loaded into the kernel.
@@ -237,7 +237,7 @@ apt install -y autoconf automake libtool gcc build-essential libssl-dev
237237
Compile the OVS kernel module and install:
238238

239239
```bash
240-
git clone -b branch-2.17 --depth=1 https://github.com/openvswitch/ovs.git
240+
git clone -b branch-3.5 --depth=1 https://github.com/openvswitch/ovs.git
241241
cd ovs
242242
curl -s https://github.com/kubeovn/ovs/commit/2d2c83c26d4217446918f39d5cd5838e9ac27b32.patch | git apply
243243
./boot.sh
@@ -261,6 +261,10 @@ It is recommended to reboot the machine to reload the new version of the kernel
261261

262262
### Using STT Type Tunnel
263263

264+
!!! warning
265+
266+
Open vSwitch upstream removed support for STT tunnels in version 3.6 [commit](https://github.com/openvswitch/ovs/commit/19b89416203f3b3b212fb01c30c81ea1b77624eb){: target="_blank" }. This solution will no longer receive upstream support in the future.
267+
264268
Common tunnel encapsulation protocols such as Geneve and Vxlan use the UDP protocol to encapsulate packets and are well supported in the kernel.
265269
However, when TCP packets are encapsulated using UDP, the optimization and offload features of modern operating systems and
266270
network cards for the TCP protocol do not work well, resulting in a significant drop in TCP throughput.

docs/advance/performance-tuning.md

Lines changed: 9 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@
55

66
社区会不断迭代控制面板和优化面的性能,部分通用性能优化已经集成到最新版本,建议使用最新版本获得更好的默认性能。
77

8-
更多关于性能优化的过程和方法论,可以观看视频分享:[Kube-OVN 容器性能优化之旅](https://www.bilibili.com/video/BV1zS4y1T73m?share_source=copy_web)
8+
更多关于性能优化的过程和方法论,可以观看视频分享:[Kube-OVN 容器性能优化之旅](https://www.bilibili.com/video/BV1zS4y1T73m?share_source=copy_web){: target="_blank" }
99

1010
## 基准测试
1111

@@ -113,7 +113,7 @@ ethtool -G eno1 tx 4096
113113

114114
### 使用 tuned 优化系统参数
115115

116-
[tuned](https://tuned-project.org/) 可以使用一系列预置的 profile 文件保存了针对特定场景的一系列系统优化配置。
116+
[tuned](https://tuned-project.org/){: target="_blank" } 可以使用一系列预置的 profile 文件保存了针对特定场景的一系列系统优化配置。
117117

118118
针对延迟优先场景:
119119

@@ -195,7 +195,7 @@ yum install -y gcc kernel-devel-$(uname -r) python3 autoconf automake libtool rp
195195
编译 OVS 内核模块并生成对应 RPM 文件:
196196

197197
```bash
198-
git clone -b branch-2.17 --depth=1 https://github.com/openvswitch/ovs.git
198+
git clone -b branch-3.5 --depth=1 https://github.com/openvswitch/ovs.git
199199
cd ovs
200200
curl -s https://github.com/kubeovn/ovs/commit/2d2c83c26d4217446918f39d5cd5838e9ac27b32.patch | git apply
201201
./boot.sh
@@ -207,7 +207,7 @@ cd rpm/rpmbuild/RPMS/x86_64/
207207
复制 RPM 到每个节点并进行安装:
208208

209209
```bash
210-
rpm -i openvswitch-kmod-2.15.2-1.el7.x86_64.rpm
210+
rpm -i openvswitch-kmod-3.5.1-1.el7.x86_64.rpm
211211
```
212212

213213
若之前已经启动过 Kube-OVN,旧版本 OVS 模块已加载至内核,建议重启机器重新加载新版内核模块。
@@ -225,7 +225,7 @@ apt install -y autoconf automake libtool gcc build-essential libssl-dev
225225
```bash
226226
apt install -y autoconf automake libtool gcc build-essential libssl-dev
227227

228-
git clone -b branch-2.17 --depth=1 https://github.com/openvswitch/ovs.git
228+
git clone -b branch-3.5 --depth=1 https://github.com/openvswitch/ovs.git
229229
cd ovs
230230
curl -s https://github.com/kubeovn/ovs/commit/2d2c83c26d4217446918f39d5cd5838e9ac27b32.patch | git apply
231231
./boot.sh
@@ -248,6 +248,10 @@ cp debian/openvswitch-switch.init /etc/init.d/openvswitch-switch
248248

249249
### 使用 STT 类型隧道
250250

251+
!!! warning
252+
253+
OpenVswitch 上游在 3.6 版本[移除对 STT 类型 Tunnel 的支持](https://github.com/openvswitch/ovs/commit/19b89416203f3b3b212fb01c30c81ea1b77624eb){: target="_blank" },该方案未来将无法得到上游支持。
254+
251255
常见的隧道封装协议例如 Geneve 和 Vxlan 使用 UDP 协议对数据包进行封装,在内核中有良好的支持。但是当使用 UDP 封装 TCP 数据包时,
252256
现代操作系统和网卡针对 TCP 协议的优化和 offload 功能将无法顺利工作,导致 TCP 的吞吐量出现显著下降。在虚拟化场景下由于 CPU 的限制,
253257
TCP 大包的吞吐量甚至可能只有宿主机网络的十分之一。

0 commit comments

Comments
 (0)