Skip to content

Commit

Permalink
doc: Add documentation on MTU settings for Neutron.
Browse files Browse the repository at this point in the history
JIRA:OSPC-610
  • Loading branch information
awfabian-rs committed Sep 18, 2024
1 parent f7e09a5 commit c2f1078
Showing 1 changed file with 5 additions and 6 deletions.
11 changes: 5 additions & 6 deletions docs/openstack-compute-kit-neutron.md
Original file line number Diff line number Diff line change
Expand Up @@ -99,9 +99,9 @@ kubectl --namespace openstack apply -f /etc/genestack/gateway-api/routes/custom-

## Neutron MTU settings / Jumbo frames / overlay networks on instances

!!! warning You will likely need to increase the MTU as described here if you want to support creating L3 overlay networks (via any software that creates nested networks, such as _Genestack_ itself, VPN, etc.) on your nova instances. Your physical L2 network will need jumbo frames to support this. You will likely end up with a an MTU of 1280 for overlay networks on instances if you don't, and the abnormally small MTU can cause various problems, perhaps even reaching a size too small for the software to support).
!!! warning You will likely need to increase the MTU as described here if you want to support creating L3 overlay networks (via any software that creates nested networks, such as _Genestack_ itself, VPN, etc.) on your nova instances. Your physical L2 network will need jumbo frames to support this. You will likely end up with an MTU of 1280 for overlay networks on instances if you don't, and the abnormally small MTU can cause various problems, perhaps even reaching a size too small for the software to support).

You might want to reference [Neutron documentation on MTU considerations](https://docs.openstack.org/neutron/latest/admin/config-mtu.html)
[Neutron documentation on MTU considerations](https://docs.openstack.org/neutron/latest/admin/config-mtu.html)

As an example of changing some values of interest, in a file for your Neutron
Helm overrides, you can use a stanza like:
Expand All @@ -124,11 +124,10 @@ but you can supply this information with a second `-f` switch in a separate
overrides file for your environment if desired. If so, place your second
`-f` after the first.)

With settings in the example, physical networks get a default MTU of 9000 in
With the settings in the example, physical networks get a default MTU of 9000 in
`global_physnet_mtu`. You can override this for specific networks in
`physical_network_mtus`, which shows `physnet1` with an MTU of 1500 here,
which handles public Internet traffic in this case, which shouldn't get jumbo
frames.
`physical_network_mtus`, which shows `physnet1` with an MTU of 1500 here, which
handles public Internet traffic in this case, which shouldn't get jumbo frames.

`path_mtu` sets the MTU for tenant or project networks. For `path_mtu` 4000 in
the example, nova instances will get an MTU of 3942 after 58 bytes of overhead.

0 comments on commit c2f1078

Please sign in to comment.