From 423807b7f8122d22065552b5f2f1439daab8756a Mon Sep 17 00:00:00 2001 From: ThibautOVH Date: Fri, 7 Nov 2025 23:35:22 +0100 Subject: [PATCH 1/4] feat(opcp): create guide how to setup lacp on a node --- .../how-to-setup-lacp-on-node/guide.en-gb.md | 366 +++++++++++++++++ .../how-to-setup-lacp-on-node/guide.fr-fr.md | 367 ++++++++++++++++++ .../opcp/how-to-setup-lacp-on-node/meta.yaml | 2 + pages/index.md | 1 + 4 files changed, 736 insertions(+) create mode 100644 pages/hosted_private_cloud/opcp/how-to-setup-lacp-on-node/guide.en-gb.md create mode 100644 pages/hosted_private_cloud/opcp/how-to-setup-lacp-on-node/guide.fr-fr.md create mode 100644 pages/hosted_private_cloud/opcp/how-to-setup-lacp-on-node/meta.yaml diff --git a/pages/hosted_private_cloud/opcp/how-to-setup-lacp-on-node/guide.en-gb.md b/pages/hosted_private_cloud/opcp/how-to-setup-lacp-on-node/guide.en-gb.md new file mode 100644 index 00000000000..2433dceae79 --- /dev/null +++ b/pages/hosted_private_cloud/opcp/how-to-setup-lacp-on-node/guide.en-gb.md @@ -0,0 +1,366 @@ +--- +title: "OPCP - How to setup LACP on a Node" +excerpt: "Learn how to setup a node in OpenStack to use LACP (Link Aggregation Control Protocol)" +updated: 2025-11-07 +--- + +## Objective + +This guide explains how to configure a **node** (physical server) in **OPCP** to enable **LACP (Link Aggregation Control Protocol)**. +LACP configuration must be applied to the node before deploying an instance so that the network interfaces are properly aggregated. +We will also see how to configure **bonding** (logical grouping of multiple network interfaces into a single virtual interface) within your instance to fully leverage **LACP**. + +> [!warning] +> A standard user cannot setup LACP by themselves. +> You must be an **admin**, or have **available nodes** in your OpenStack project. +> +> It is recommended to setup LACP **before** deploying an instance. +> This guide **does not cover** configuring a node that is already in production. + +## Why Use LACP? + +LACP can be used in two specific use cases: + +- **Increase network capacity.** By aggregating multiple network cards, you can add the bandwidth of each NIC to the aggregate, for the same networks. +- **Increase resilience.** Each OPCP server has 4×25 G interfaces and is connected to two network switches (A & B) to ensure resilience in case of hardware failure. LACP allows you to create virtual interfaces that remain available in the event of hardware failure by aggregating two NICs connected to different switches. + +## Requirements + +Before starting, make sure you have the following: + +- An active [OPCP service](https://www.ovhcloud.com/en/hosted-private-cloud/onprem-cloud-platform/). +- **[Configured OpenStack CLI access](/pages/hosted_private_cloud/opcp/how-to-use-api-and-get-credentials)** with the necessary permissions (`clouds.yaml` or environment variables). +- The **admin** role and/or transferred nodes within your project. +- LACP is an advanced networking configuration requiring system and networking expertise. Apply this guide only if you are already familiar with: configuring nodes in OpenStack Ironic, managing ports in OpenStack Neutron, and using the OpenStack CLI. + +## Instructions + +### Node Configuration + +#### 1. List Nodes + +The list of available nodes in your project can be displayed with the following command: + +```bash +openstack baremetal node list +``` + +**Example output:** + +```bash ++--------------------------------------+----------------+--------------------------------------+-------------+--------------------+-------------+ +| UUID | Name | Instance UUID | Power State | Provisioning State | Maintenance | ++--------------------------------------+----------------+--------------------------------------+-------------+--------------------+-------------+ +| 88830859-5b16-4935-8f41-d381b754cbe5 | SERVER-1 | None | power off | available | False | +| 726bb7e9-3b20-4a44-99d7-2af747983781 | SERVER-2 | None | power off | available | False | +| af711edf-a579-491e-b474-3c03639ed99b | SERVER-3 | 83b7083b-bbdd-4327-941c-ee91197818c5 | None | active | True | ++--------------------------------------+----------------+--------------------------------------+-------------+--------------------+-------------+ +``` + +--- + +#### 2. Transfer Node Ownership (Admin Only) + +An admin can transfer node ownership to a specific project: + +```bash +openstack baremetal node set --owner +``` + +--- + +#### 3. List Network Ports + +Each physical network interface card (NIC) of a node is represented in OpenStack as a port. + +To list the ports associated with a node: + +```bash +openstack baremetal port list --node +``` + +**Example output:** + +```bash ++--------------------------------------+-------------------+ +| UUID | Address | ++--------------------------------------+-------------------+ +| 068a06b2-ebf9-48c9-a3c3-94016ca5e3da | 85:32:f2:87:29:da | +| 4937d704-7517-4525-86d1-abecb94a7ce9 | 85:32:f2:87:29:db | +| 422eece6-dcfa-40cd-975d-ba8bb11c774e | 85:32:f2:89:66:f8 | +| 34073903-92ad-47d1-a751-15aa96991415 | 85:32:f2:89:66:f9 | ++--------------------------------------+-------------------+ +``` + +To view detailed information about a port, including physical connection info: +This is particularly useful if you plan to configure a **2x2 LACP bonding**, distributing NICs across two switches for **better redundancy and fault tolerance**. + +```bash +openstack baremetal port show +``` + +**Example output:** + +```bash +openstack baremetal port show 71899d54-546d-4fdd-8d8b-52ad986bf425 ++-----------------------+------------------------------------------------------------------------------------------------+ +| Field | Value | ++-----------------------+------------------------------------------------------------------------------------------------+ +| address | 85:32:f2:89:66:f9 | +| created_at | 2025-01-06T10:43:38.020574+00:00 | +| extra | {} | +| internal_info | {} | +| is_smartnic | False | +| local_link_connection | {'switch_id': 'c0:00:15:8c:33:78', 'port_id': 'Ethernet25/2', 'switch_info': 'demo-tor1b-a70'} | +| node_uuid | ddc7c763-74fc-4900-b9e6-5463233836b0 | +| physical_network | None | +| portgroup_uuid | c3d3fcb3-7a92-4257-b944-736d222e8c4a | +| pxe_enabled | False | +| updated_at | 2025-11-06T09:52:46.355883+00:00 | +| uuid | 71899d54-546d-4fdd-8d8b-52ad986bf425 | ++-----------------------+------------------------------------------------------------------------------------------------+ +``` + +--- + +#### 4. Enable Maintenance Mode + +Before any network configuration change, the node must be placed in **maintenance mode** to prevent deployment during the operation: + +```bash +openstack baremetal node maintenance set +``` + +--- + +#### 5. Create a Port Group (LACP Bond) + +A **port group** allows enabling LACP aggregation between multiple network interfaces. + +Use the `--mode 802.3ad` parameter to enable LACP. +If you don’t specify a MAC address with `--address`, one of the ports’ addresses will be used automatically. + +> [!note] +> You can create: +> - a **single port group** for a 1×4 bond, or +> - two **port groups** for 2×2 bonds. + +**Example:** + +```bash +openstack baremetal port group create \ + --node 88830859-5b16-4935-8f41-d381b754cbe5 \ + --name portgroup-lacp \ + --mode 802.3ad \ + --address 00:00:00:20:00:01 +``` + +**Example output:** + +```bash ++----------------------------+-------------------------------------------+ +| Field | Value | ++----------------------------+-------------------------------------------+ +| uuid | d082c2ab-5960-44e3-920d-3d6dfb6811e9 | +| address | 00:00:00:20:00:01 | +| node_uuid | 88830859-5b16-4935-8f41-d381b754cbe5 | +| name | portgroup-lacp | +| mode | 802.3ad | +| standalone_ports_supported | True | ++----------------------------+-------------------------------------------+ +``` + +--- + +#### 6. Associate Ports to the Group + +Each port on the node must be linked to the created port group: + +```bash +openstack baremetal port set --port-group +``` + +**Example:** + +```bash +openstack baremetal port set --port-group d082c2ab-5960-44e3-920d-3d6dfb6811e9 068a06b2-ebf9-48c9-a3c3-94016ca5e3da +openstack baremetal port set --port-group d082c2ab-5960-44e3-920d-3d6dfb6811e9 4937d704-7517-4525-86d1-abecb94a7ce9 +openstack baremetal port set --port-group d082c2ab-5960-44e3-920d-3d6dfb6811e9 422eece6-dcfa-40cd-975d-ba8bb11c774e +openstack baremetal port set --port-group d082c2ab-5960-44e3-920d-3d6dfb6811e9 34073903-92ad-47d1-a751-15aa96991415 +``` + +--- + +#### 7. Disable Maintenance Mode + +Once configuration is complete, disable maintenance mode: + +```bash +openstack baremetal node maintenance unset +``` + +--- + +#### 8. Create an Instance on the configured Node + +After configuring your node with LACP, you can deploy an instance. + +By default, OpenStack selects a host based on the **flavor** and **scheduler rules**, which doesn’t guarantee it will use the node you just configured. + +To ensure your instance is deployed on that specific node, target it using its **availability zone**: + +```bash +openstack server create --availability-zone "nova::" +``` + +**Example:** + +```bash +openstack server create --image \ + --nic net-id=NETWORK1,v4-fixed-ip=198.18.56.200 \ + --flavor \ + --key-name \ + --availability-zone "nova::" \ + +``` + +--- + +#### Summary of Steps + +| Step | Action | Command | +|------|---------|----------| +| 1 | List nodes | `openstack baremetal node list` | +| 2 | Transfer ownership | `openstack baremetal node set --owner ` | +| 3 | List ports | `openstack baremetal port list --node ` | +| 4 | Enable maintenance mode | `openstack baremetal node maintenance set ` | +| 5 | Create LACP group | `openstack baremetal port group create --node --name --mode 802.3ad` | +| 6 | Associate ports | `openstack baremetal port set --port-group ` | +| 7 | Disable maintenance mode | `openstack baremetal node maintenance unset ` | +| 8 | Create instance | `openstack server create --image --nic net-id= --flavor --key-name --availability-zone "nova::" ` | + +### Instance Operating System Configuration + +After configuring your node in OpenStack and deploying an OS, you need to configure networking to leverage **bonding**, which aggregates multiple NICs for higher performance and redundancy. + +#### Check Bonding Configuration + +On some images (like **Debian 12** or **Ubuntu 22.04**), **bonding** is automatically detected and configured. +However, other distributions may require manual adjustments. + +##### 1. Check Active Bonds + +```bash +ls /proc/net/bonding/ +bond0 +``` + +##### 2. Check Member Interfaces + +```bash +cat /proc/net/bonding/bond0 | grep Interface +Slave Interface: ens22f1np1 +Slave Interface: ens22f0np0 +Slave Interface: ens21f1np1 +Slave Interface: ens21f0np0 +``` + +--- + +##### 3. Check Transmit Hash Policy + +```bash +cat /proc/net/bonding/* | grep Trans +Transmit Hash Policy: layer2 (0) +``` + +> [!warning] +> To fully utilize available bandwidth, configure the policy to `layer3+4` (some OSes default to `layer2`, which is less efficient). +> More info: [Ubuntu Bonding Documentation](https://help.ubuntu.com/community/UbuntuBonding) + +--- + +#### Modify Configuration + +##### 1. Temporary Change (Non-Persistent) + +To test your configuration manually: + +```bash +sudo ip link set bond0 type bond xmit_hash_policy layer3+4 +``` + +Note: This configuration will reset on reboot. + +##### 2. Persistent Change (Example with Netplan and cloud-init) + +Create the configuration file (e.g. `/etc/cloud/cloud.cfg.d/99-custom-network.cfg`) and include: + +```yaml +network: + version: 2 + ethernets: + ens21f0np0: {} + ens21f1np1: {} + ens22f0np0: {} + ens22f1np1: {} + bonds: + bond0: + dhcp4: true + interfaces: + - ens21f0np0 + - ens21f1np1 + - ens22f0np0 + - ens22f1np1 + macaddress: 00:00:00:20:00:23 + parameters: + mode: 802.3ad + transmit-hash-policy: layer3+4 + lacp-rate: fast + mii-monitor-interval: 100 +``` + +Then apply the configuration by rebooting the instance. + +--- + +#### 3. Test Bandwidth with `iperf3` + +To properly test LACP, you need **two nodes** in the **same network**, both configured with LACP. + +##### Iperf3 Server (Node 1) + +```bash +iperf3 -s +``` + +##### Iperf3 Client (Node 2) + +Use `-P` to generate multiple parallel streams to reach maximum throughput. + +```bash +iperf3 -c -P 64 +``` + +##### Example Result + +```bash +[SUM] 0.0000-10.0121 sec 110 GBytes 94.0 Gbits/sec +``` + +With a 4×25 Gbps link, you should achieve around **100 Gbps**. +Some system tuning might be required to fully reach this capacity. + +--- + +## Conclusion + +You have successfully configured: + +- **LACP (802.3ad)** at the OpenStack Baremetal node level, +- **Bonding configuration** within the guest OS, +- And validated **network performance** using `iperf3`. + +Your instance is now ready to leverage the full available bandwidth of the aggregated link. + +--- diff --git a/pages/hosted_private_cloud/opcp/how-to-setup-lacp-on-node/guide.fr-fr.md b/pages/hosted_private_cloud/opcp/how-to-setup-lacp-on-node/guide.fr-fr.md new file mode 100644 index 00000000000..cc174a360dc --- /dev/null +++ b/pages/hosted_private_cloud/opcp/how-to-setup-lacp-on-node/guide.fr-fr.md @@ -0,0 +1,367 @@ +--- +title: "OPCP - Comment configurer LACP sur un noeud" +excerpt: "Apprenez à configurer un noeud dans OpenStack pour utiliser LACP (Link Aggregation Control Protocol)" +updated: 2025-11-07 +--- + + +## Objectif + +Ce guide explique comment configurer un **noeud** (serveur physique) dans **OPCP** pour activer **LACP (Link Aggregation Control Protocol)**. +La configuration de LACP doit être appliquée sur le noeud avant de déployer une instance, afin que les interfaces réseau soient correctement agrégées. +Nous verrons également comment configurer le **bonding** (association logique de plusieurs interfaces réseau pour former une seule interface virtuelle) au niveau de votre instance, afin de tirer pleinement parti du **LACP**. + +> [!warning] +> Un utilisateur standard ne peut pas configurer LACP lui-même. +> Vous devez être **admin**, ou disposer de **noeud disponible** dans votre projet OpenStack. +> +> Il est recommandé de configurer LACP **avant** le déploiement d’une instance. +> Ce guide **ne couvre pas** la configuration d'un noeud déjà en production. + +## Pourquoi utiliser LACP ? + +LACP peut être utilisé dans deux cas d'usage précis : + +- **Augmenter la capacité réseau.** En agrégeant plusieurs cartes réseau, vous pourrez ajouter la bande passante de chaque carte réseau ajoutée à cet agrégat, pour les mêmes réseaux. +- **Augmenter la résilience.** Chaque serveur de OPCP bénéficie de 4 interfaces 25G. Chaque serveur est relié à deux switchs réseau (A&B) pour assurer la résilience en cas de panne matérielle de l'un d'entre eux. LACP permet de créer des interfaces virtuelles résilientes en cas de panne matérielle en aggrégant deux cartes réseau reliées sur des switchs distincts. + +## Prérequis + +Avant de commencer, assurez-vous de disposer des éléments suivants : + +- Disposer d'un service [OPCP](https://www.ovhcloud.com/en/hosted-private-cloud/onprem-cloud-platform/) actif. +- Un accès **[OpenStack CLI configuré](/pages/hosted_private_cloud/opcp/how-to-use-api-and-get-credentials)** avec les droits nécessaires (`clouds.yaml` ou variables d’environnement). +- Le rôle **admin** et/ou ou des noeuds transférés dans votre projet. +- LACP est une configuration réseau spécifique, nécessitant des connaissances réseau et système avancées. Nous vous conseillons d'appliquer ce guide si vous connaissez déjà l'un ou plusieurs des concepts suivants : configuration de noeuds au sein de OpenStack Ironic, gestion des ports au sein de OpenStack Neutron, et la connaissance de la CLI OpenStack + +## En pratique + +### Configuration du noeud + +#### 1. Lister les noeuds + +La liste des noeuds disponibles dans votre projet peut être affichée avec la commande suivante : + +```bash +openstack baremetal node list +``` + +**Exemple de sortie :** + +```bash ++--------------------------------------+----------------+--------------------------------------+-------------+--------------------+-------------+ +| UUID | Name | Instance UUID | Power State | Provisioning State | Maintenance | ++--------------------------------------+----------------+--------------------------------------+-------------+--------------------+-------------+ +| 88830859-5b16-4935-8f41-d381b754cbe5 | SERVER-1 | None | power off | available | False | +| 726bb7e9-3b20-4a44-99d7-2af747983781 | SERVER-2 | None | power off | available | False | +| af711edf-a579-491e-b474-3c03639ed99b | SERVER-3 | 83b7083b-bbdd-4327-941c-ee91197818c5 | None | active | True | ++--------------------------------------+----------------+--------------------------------------+-------------+--------------------+-------------+ +``` + +--- + +#### 2. Transférer la propriété d’un noeud (admin uniquement) + +Un admin peut transférer la propriété d’un noeud à un projet donné : + +```bash +openstack baremetal node set --owner +``` + +--- + +#### 3. Lister les ports réseau + +Chaque carte réseau physique, appelée Network Interface Card (NIC), d’un nœud est représentée dans OpenStack par un port. + +Pour afficher la liste des ports associés à un noeud : + +```bash +openstack baremetal port list --node +``` + +**Exemple de sortie :** + +```bash ++--------------------------------------+-------------------+ +| UUID | Address | ++--------------------------------------+-------------------+ +| 068a06b2-ebf9-48c9-a3c3-94016ca5e3da | 85:32:f2:87:29:da | +| 4937d704-7517-4525-86d1-abecb94a7ce9 | 85:32:f2:87:29:db | +| 422eece6-dcfa-40cd-975d-ba8bb11c774e | 85:32:f2:89:66:f8 | +| 34073903-92ad-47d1-a751-15aa96991415 | 85:32:f2:89:66:f9 | ++--------------------------------------+-------------------+ +``` + +Pour visualiser les détails d'un port, y compris les informations sur la connexion physique. +Cela est particulièrement utile si vous souhaitez configurer un **bonding LACP 2x2**, en répartissant les NIC sur deux switches différents pour assurer une **meilleure redondance et tolérance aux pannes**. + +```bash +openstack baremetal port show +``` + +**Exemple de sortie :** + +```bash +openstack baremetal port show 71899d54-546d-4fdd-8d8b-52ad986bf425 ++-----------------------+------------------------------------------------------------------------------------------------+ +| Field | Value | ++-----------------------+------------------------------------------------------------------------------------------------+ +| address | 85:32:f2:89:66:f9 | +| created_at | 2025-01-06T10:43:38.020574+00:00 | +| extra | {} | +| internal_info | {} | +| is_smartnic | False | +| local_link_connection | {'switch_id': 'c0:00:15:8c:33:78', 'port_id': 'Ethernet25/2', 'switch_info': 'demo-tor1b-a70'} | +| node_uuid | ddc7c763-74fc-4900-b9e6-5463233836b0 | +| physical_network | None | +| portgroup_uuid | c3d3fcb3-7a92-4257-b944-736d222e8c4a | +| pxe_enabled | False | +| updated_at | 2025-11-06T09:52:46.355883+00:00 | +| uuid | 71899d54-546d-4fdd-8d8b-52ad986bf425 | ++-----------------------+------------------------------------------------------------------------------------------------+ +``` + +--- + +#### 4. Activer le mode maintenance + +Avant toute modification de configuration réseau, le noeud doit être placé en **mode maintenance**. Cela assure que ce noeud ne puisse pas être déployé durant toute l'opération : + +```bash +openstack baremetal node maintenance set +``` + +--- + +#### 5. Créer un groupe de ports (LACP Bond) + +Le **groupe de ports** permet d’activer l’agrégation LACP entre plusieurs interfaces réseau. + +Utilisez le paramètre `--mode 802.3ad` pour activer LACP. +Si vous n’indiquez pas d’adresse MAC avec `--address`, l’adresse d’un des ports sera utilisée automatiquement. + +> [!note] +> Vous pouvez créer : +> - un **groupe de ports unique** pour un bond 1×4, ou +> - deux **groupes de ports** pour des bonds 2×2. + +**Exemple :** + +```bash +openstack baremetal port group create \ + --node 88830859-5b16-4935-8f41-d381b754cbe5 \ + --name portgroup-lacp \ + --mode 802.3ad \ + --address 00:00:00:20:00:01 +``` + +**Exemple de sortie :** + +```bash ++----------------------------+-------------------------------------------+ +| Champ | Valeur | ++----------------------------+-------------------------------------------+ +| uuid | d082c2ab-5960-44e3-920d-3d6dfb6811e9 | +| address | 00:00:00:20:00:01 | +| node_uuid | 88830859-5b16-4935-8f41-d381b754cbe5 | +| name | portgroup-lacp | +| mode | 802.3ad | +| standalone_ports_supported | True | ++----------------------------+-------------------------------------------+ +``` + +--- + +#### 6. Associer les ports au groupe + +Chaque port du noeud doit être associé au groupe de ports créé : + +```bash +openstack baremetal port set --port-group +``` + +**Exemple :** + +```bash +openstack baremetal port set --port-group d082c2ab-5960-44e3-920d-3d6dfb6811e9 068a06b2-ebf9-48c9-a3c3-94016ca5e3da +openstack baremetal port set --port-group d082c2ab-5960-44e3-920d-3d6dfb6811e9 4937d704-7517-4525-86d1-abecb94a7ce9 +openstack baremetal port set --port-group d082c2ab-5960-44e3-920d-3d6dfb6811e9 422eece6-dcfa-40cd-975d-ba8bb11c774e +openstack baremetal port set --port-group d082c2ab-5960-44e3-920d-3d6dfb6811e9 34073903-92ad-47d1-a751-15aa96991415 +``` + +--- + +#### 7. Désactiver le mode maintenance + +Une fois la configuration terminée, désactivez le mode maintenance : + +```bash +openstack baremetal node maintenance unset +``` + +--- + +#### 8. Créer une instance sur le noeud configuré + +Une fois votre noeud configuré avec LACP, vous pouvez déployer une instance. + +Par défaut, OpenStack sélectionne un hôte en fonction du **flavor** choisi et des **règles du scheduler**, ce qui ne garantit pas que le noeud que vous venez de configurer sera utilisé. + +Pour vous assurer que votre instance sera déployée sur ce nœud précis, vous pouvez cibler ce dernier utilisant sa **zone de disponibilité** : + +```bash +openstack server create --availability-zone "nova::" +``` + +**Exemple :** + +```bash +openstack server create --image \ + --nic net-id=NETWORK1,v4-fixed-ip=198.18.56.200 \ + --flavor \ + --key-name \ + --availability-zone "nova::" \ + +``` + +--- + +#### Résumé des étapes + +| Étape | Action | Commande | +|-------|---------|-----------| +| 1 | Lister les noeuds | `openstack baremetal node list` | +| 2 | Transférer la propriété | `openstack baremetal node set --owner ` | +| 3 | Lister les ports | `openstack baremetal port list --node ` | +| 4 | Activer le mode maintenance | `openstack baremetal node maintenance set ` | +| 5 | Créer un groupe LACP | `openstack baremetal port group create --node --name --mode 802.3ad` | +| 6 | Associer les ports | `openstack baremetal port set --port-group ` | +| 7 | Désactiver le mode maintenance | `openstack baremetal node maintenance unset ` | +| 8 | Créer une instance | `openstack server create --image --nic net-id= --flavor --key-name --availability-zone "nova::" ` | + +### Configuration du système d’exploitation de l’instance + +Après avoir configuré votre noeud dans OpenStack et déployé un système d’exploitation, il reste à configurer le réseau afin de bénéficier du network **bonding**, qui permet d’agréger plusieurs interfaces réseau pour plus de performance et de redondance. + +#### Vérifier la configuration du bonding + +Sur certaines images (comme **Debian 12** ou **Ubuntu 22.04**), la configuration du **bonding** est automatiquement détectée et configurée. +Cependant, d’autres distributions peuvent nécessiter un ajustement manuel. + +##### 1. Vérifier les bonds actifs + +```bash +ls /proc/net/bonding/ +bond0 +``` + +##### 2. Vérifier les interfaces membres + +```bash +cat /proc/net/bonding/bond0 | grep Interface +Slave Interface: ens22f1np1 +Slave Interface: ens22f0np0 +Slave Interface: ens21f1np1 +Slave Interface: ens21f0np0 +``` + +--- + +##### 3. Vérifier la politique de hachage (`Transmit Hash Policy`) + +```bash +cat /proc/net/bonding/* | grep Trans +Transmit Hash Policy: layer2 (0) +``` + +> [!warning] +> Pour exploiter toute la bande passante, configurez la politique `layer3+4` (par défaut, certains OS utilisent `layer2`, moins performante). +> Plus de détails : [Ubuntu Bonding Documentation](https://help.ubuntu.com/community/UbuntuBonding?utm_source=chatgpt.com) + +--- + +#### Modifier la configuration + +##### 1. Changement à chaud (non persistant) + +Si vous souhaitez tester votre configuration manuellement, vous pouvez utiliser la commande suivante : + +```bash +sudo ip link set bond0 type bond xmit_hash_policy layer3+4 +``` + +Attention, cette configuration sera réinitialisée si votre machine redémarre. + +#### 2. Changement persistant (exemple via Netplan et cloud-init) + +Créez votre fichier de configuration (ex. `/etc/cloud/cloud.cfg.d/99-custom-network.cfg`) pour y inclure : + +```yaml +network: + version: 2 + ethernets: + ens21f0np0: {} + ens21f1np1: {} + ens22f0np0: {} + ens22f1np1: {} + bonds: + bond0: + dhcp4: true + interfaces: + - ens21f0np0 + - ens21f1np1 + - ens22f0np0 + - ens22f1np1 + macaddress: 00:00:00:20:00:23 + parameters: + mode: 802.3ad + transmit-hash-policy: layer3+4 + lacp-rate: fast + mii-monitor-interval: 100 +``` + +Puis appliquez la configuration en rédémarrant l'instance. + +--- + +#### 3. Tester la bande passante avec `iperf3` + +Pour tester correctement LACP, vous devez disposer de **2 noeuds** dans le **même réseau**, tous deux configurés avec LACP. + +##### noeud Iperf3 (noeud 1) + +```bash +iperf3 -s +``` + +##### Client Iperf3 (noeud 2) + +Utilisez `-P` pour générer plusieurs flux parallèles, afin d’atteindre la bande passante maximale. + +```bash +iperf3 -c -P 64 +``` + +##### Exemple de résultat + +```bash +[SUM] 0.0000-10.0121 sec 110 GBytes 94.0 Gbits/sec +``` + +Avec un lien 4×25 Gbps, vous devriez atteindre environ **100 Gbps**. +Il peux être nécessaire d'ajuster certains paramètres système pour exploiter pleinement cette capacité. + +--- + +## Conclusion + +Vous avez configuré : + +- Le **LACP (802.3ad)** au niveau du noeud Baremetal OpenStack, +- Le **paramétrage du bonding** dans l’OS invité, +- Et validé la **performance réseau** via `iperf3`. + +Votre instance est désormais prête à exploiter toute la bande passante disponible du lien agrégé. + +--- diff --git a/pages/hosted_private_cloud/opcp/how-to-setup-lacp-on-node/meta.yaml b/pages/hosted_private_cloud/opcp/how-to-setup-lacp-on-node/meta.yaml new file mode 100644 index 00000000000..4b5934d6826 --- /dev/null +++ b/pages/hosted_private_cloud/opcp/how-to-setup-lacp-on-node/meta.yaml @@ -0,0 +1,2 @@ +id: 0339bbc9-0794-431e-bbad-88f58c70bdbb +full_slug: opcp-setup-lacp-on-node \ No newline at end of file diff --git a/pages/index.md b/pages/index.md index eddcf75a0c0..787758f7bcc 100644 --- a/pages/index.md +++ b/pages/index.md @@ -553,6 +553,7 @@ + [OPCP](hosted-private-cloud-opcp) + [Getting started](hosted-private-cloud-opcp-getting-started) + [How to use API and get credentials](hosted_private_cloud/opcp/how-to-use-api-and-get-credentials) + + [How to setup LACP on node](hosted_private_cloud/opcp/how-to-setup-lacp-on-node) + [Nutanix on OVHcloud](products/hosted-private-cloud-nutanix-on-ovhcloud) + [Getting started](hosted-private-cloud-nutanix-on-ovhcloud-getting-started) + [Nutanix global high-level documentation](hosted_private_cloud/nutanix_on_ovhcloud/01-global-high-level-doc) From 56865d7c2e74a21e50325e597fb9033372d5d9e1 Mon Sep 17 00:00:00 2001 From: Montrealhub <89825661+Jessica41@users.noreply.github.com> Date: Mon, 10 Nov 2025 11:06:48 -0500 Subject: [PATCH 2/4] first proof guide.en-gb.md --- .../how-to-setup-lacp-on-node/guide.en-gb.md | 97 ++++++++----------- 1 file changed, 38 insertions(+), 59 deletions(-) diff --git a/pages/hosted_private_cloud/opcp/how-to-setup-lacp-on-node/guide.en-gb.md b/pages/hosted_private_cloud/opcp/how-to-setup-lacp-on-node/guide.en-gb.md index 2433dceae79..87b8c0c8e68 100644 --- a/pages/hosted_private_cloud/opcp/how-to-setup-lacp-on-node/guide.en-gb.md +++ b/pages/hosted_private_cloud/opcp/how-to-setup-lacp-on-node/guide.en-gb.md @@ -1,37 +1,40 @@ --- title: "OPCP - How to setup LACP on a Node" -excerpt: "Learn how to setup a node in OpenStack to use LACP (Link Aggregation Control Protocol)" -updated: 2025-11-07 +excerpt: Learn how to setup a node in OpenStack to use LACP (Link Aggregation Control Protocol) +updated: 2025-11-10 --- ## Objective + +LACP configuration must be applied to the node before deploying an instance so that the network interfaces are properly aggregated. + +**This guide explains how to configure a node (physical server) in OPCP to enable LACP (Link Aggregation Control Protocol)**. -This guide explains how to configure a **node** (physical server) in **OPCP** to enable **LACP (Link Aggregation Control Protocol)**. -LACP configuration must be applied to the node before deploying an instance so that the network interfaces are properly aggregated. We will also see how to configure **bonding** (logical grouping of multiple network interfaces into a single virtual interface) within your instance to fully leverage **LACP**. > [!warning] -> A standard user cannot setup LACP by themselves. +> A standard user cannot setup LACP by themselves. > You must be an **admin**, or have **available nodes** in your OpenStack project. > -> It is recommended to setup LACP **before** deploying an instance. +> It is recommended to setup LACP **before** deploying an instance. > This guide **does not cover** configuring a node that is already in production. ## Why Use LACP? -LACP can be used in two specific use cases: +LACP can be used in two specific use cases: -- **Increase network capacity.** By aggregating multiple network cards, you can add the bandwidth of each NIC to the aggregate, for the same networks. -- **Increase resilience.** Each OPCP server has 4×25 G interfaces and is connected to two network switches (A & B) to ensure resilience in case of hardware failure. LACP allows you to create virtual interfaces that remain available in the event of hardware failure by aggregating two NICs connected to different switches. +- **Increase network capacity:** By aggregating multiple network cards, you can add the bandwidth of each NIC to the aggregate, for the same networks. +- **Increase resilience:** Each OPCP server has 4×25 G interfaces and is connected to two network switches (A & B) to ensure resilience in case of hardware failure. LACP allows you to create virtual interfaces that remain available in the event of hardware failure by aggregating two NICs connected to different switches. ## Requirements Before starting, make sure you have the following: -- An active [OPCP service](https://www.ovhcloud.com/en/hosted-private-cloud/onprem-cloud-platform/). -- **[Configured OpenStack CLI access](/pages/hosted_private_cloud/opcp/how-to-use-api-and-get-credentials)** with the necessary permissions (`clouds.yaml` or environment variables). -- The **admin** role and/or transferred nodes within your project. -- LACP is an advanced networking configuration requiring system and networking expertise. Apply this guide only if you are already familiar with: configuring nodes in OpenStack Ironic, managing ports in OpenStack Neutron, and using the OpenStack CLI. +- An active [OPCP service](/links/hosted-private-cloud/onprem-cloud-platform). +- **[Configured OpenStack CLI access](/pages/hosted_private_cloud/opcp/how-to-use-api-and-get-credentials)** with the necessary permissions (`clouds.yaml` or environment variables). +- The **admin** role and/or transferred nodes within your project. + +LACP is an advanced networking configuration requiring system and networking expertise. Apply this guide only if you are already familiar with: configuring nodes in OpenStack Ironic, managing ports in OpenStack Neutron, and using the OpenStack CLI. ## Instructions @@ -57,8 +60,6 @@ openstack baremetal node list +--------------------------------------+----------------+--------------------------------------+-------------+--------------------+-------------+ ``` ---- - #### 2. Transfer Node Ownership (Admin Only) An admin can transfer node ownership to a specific project: @@ -67,8 +68,6 @@ An admin can transfer node ownership to a specific project: openstack baremetal node set --owner ``` ---- - #### 3. List Network Ports Each physical network interface card (NIC) of a node is represented in OpenStack as a port. @@ -92,7 +91,8 @@ openstack baremetal port list --node +--------------------------------------+-------------------+ ``` -To view detailed information about a port, including physical connection info: +To view detailed information about a port, including physical connection info: + This is particularly useful if you plan to configure a **2x2 LACP bonding**, distributing NICs across two switches for **better redundancy and fault tolerance**. ```bash @@ -121,8 +121,6 @@ openstack baremetal port show 71899d54-546d-4fdd-8d8b-52ad986bf425 +-----------------------+------------------------------------------------------------------------------------------------+ ``` ---- - #### 4. Enable Maintenance Mode Before any network configuration change, the node must be placed in **maintenance mode** to prevent deployment during the operation: @@ -131,18 +129,15 @@ Before any network configuration change, the node must be placed in **maintenanc openstack baremetal node maintenance set ``` ---- - #### 5. Create a Port Group (LACP Bond) A **port group** allows enabling LACP aggregation between multiple network interfaces. -Use the `--mode 802.3ad` parameter to enable LACP. -If you don’t specify a MAC address with `--address`, one of the ports’ addresses will be used automatically. +Use the `--mode 802.3ad` parameter to enable LACP. If you don’t specify a MAC address with `--address`, one of the ports’ addresses will be used automatically. -> [!note] +> [!success] > You can create: -> - a **single port group** for a 1×4 bond, or +> - a **single port group** for a 1×4 bond, or > - two **port groups** for 2×2 bonds. **Example:** @@ -170,8 +165,6 @@ openstack baremetal port group create \ +----------------------------+-------------------------------------------+ ``` ---- - #### 6. Associate Ports to the Group Each port on the node must be linked to the created port group: @@ -189,8 +182,6 @@ openstack baremetal port set --port-group d082c2ab-5960-44e3-920d-3d6dfb6811e9 4 openstack baremetal port set --port-group d082c2ab-5960-44e3-920d-3d6dfb6811e9 34073903-92ad-47d1-a751-15aa96991415 ``` ---- - #### 7. Disable Maintenance Mode Once configuration is complete, disable maintenance mode: @@ -199,8 +190,6 @@ Once configuration is complete, disable maintenance mode: openstack baremetal node maintenance unset ``` ---- - #### 8. Create an Instance on the configured Node After configuring your node with LACP, you can deploy an instance. @@ -224,8 +213,6 @@ openstack server create --image \ ``` ---- - #### Summary of Steps | Step | Action | Command | @@ -245,17 +232,16 @@ After configuring your node in OpenStack and deploying an OS, you need to config #### Check Bonding Configuration -On some images (like **Debian 12** or **Ubuntu 22.04**), **bonding** is automatically detected and configured. -However, other distributions may require manual adjustments. +On some images (like **Debian 12** or **Ubuntu 22.04**), **bonding** is automatically detected and configured. However, other distributions may require manual adjustments. -##### 1. Check Active Bonds +**1. Check Active Bonds** ```bash ls /proc/net/bonding/ bond0 ``` -##### 2. Check Member Interfaces +**2. Check Member Interfaces** ```bash cat /proc/net/bonding/bond0 | grep Interface @@ -265,9 +251,7 @@ Slave Interface: ens21f1np1 Slave Interface: ens21f0np0 ``` ---- - -##### 3. Check Transmit Hash Policy +**3. Check Transmit Hash Policy** ```bash cat /proc/net/bonding/* | grep Trans @@ -275,14 +259,12 @@ Transmit Hash Policy: layer2 (0) ``` > [!warning] -> To fully utilize available bandwidth, configure the policy to `layer3+4` (some OSes default to `layer2`, which is less efficient). -> More info: [Ubuntu Bonding Documentation](https://help.ubuntu.com/community/UbuntuBonding) - ---- +> To fully utilize available bandwidth, configure the policy to `layer3+4` (some OSes default to `layer2`, which is less efficient). +> For more information: [Ubuntu Bonding Documentation](https://help.ubuntu.com/community/UbuntuBonding). #### Modify Configuration -##### 1. Temporary Change (Non-Persistent) +**1. Temporary Change (Non-Persistent)** To test your configuration manually: @@ -292,7 +274,7 @@ sudo ip link set bond0 type bond xmit_hash_policy layer3+4 Note: This configuration will reset on reboot. -##### 2. Persistent Change (Example with Netplan and cloud-init) +**2. Persistent Change (Example with Netplan and cloud-init)** Create the configuration file (e.g. `/etc/cloud/cloud.cfg.d/99-custom-network.cfg`) and include: @@ -322,19 +304,17 @@ network: Then apply the configuration by rebooting the instance. ---- - #### 3. Test Bandwidth with `iperf3` To properly test LACP, you need **two nodes** in the **same network**, both configured with LACP. -##### Iperf3 Server (Node 1) +**Iperf3 Server (Node 1)** ```bash iperf3 -s ``` -##### Iperf3 Client (Node 2) +**Iperf3 Client (Node 2)** Use `-P` to generate multiple parallel streams to reach maximum throughput. @@ -342,25 +322,24 @@ Use `-P` to generate multiple parallel streams to reach maximum throughput. iperf3 -c -P 64 ``` -##### Example Result +**Example Result:** ```bash [SUM] 0.0000-10.0121 sec 110 GBytes 94.0 Gbits/sec ``` -With a 4×25 Gbps link, you should achieve around **100 Gbps**. -Some system tuning might be required to fully reach this capacity. - ---- +With a 4×25 Gbps link, you should achieve around **100 Gbps**. Some system tuning might be required to fully reach this capacity. ## Conclusion You have successfully configured: -- **LACP (802.3ad)** at the OpenStack Baremetal node level, -- **Bonding configuration** within the guest OS, +- **LACP (802.3ad)** at the OpenStack Baremetal node level; +- **Bonding configuration** within the guest OS; - And validated **network performance** using `iperf3`. Your instance is now ready to leverage the full available bandwidth of the aggregated link. ---- +## Go further + +Join our [community of users](/links/community). From 60f61e7ea5fcf119d05bab8af01315e5757c7d3d Mon Sep 17 00:00:00 2001 From: Montrealhub <89825661+Jessica41@users.noreply.github.com> Date: Mon, 10 Nov 2025 11:15:01 -0500 Subject: [PATCH 3/4] first proofread guide.fr-fr.md --- .../how-to-setup-lacp-on-node/guide.fr-fr.md | 89 +++++++------------ 1 file changed, 34 insertions(+), 55 deletions(-) diff --git a/pages/hosted_private_cloud/opcp/how-to-setup-lacp-on-node/guide.fr-fr.md b/pages/hosted_private_cloud/opcp/how-to-setup-lacp-on-node/guide.fr-fr.md index cc174a360dc..07f55bbbc7d 100644 --- a/pages/hosted_private_cloud/opcp/how-to-setup-lacp-on-node/guide.fr-fr.md +++ b/pages/hosted_private_cloud/opcp/how-to-setup-lacp-on-node/guide.fr-fr.md @@ -1,38 +1,40 @@ --- title: "OPCP - Comment configurer LACP sur un noeud" excerpt: "Apprenez à configurer un noeud dans OpenStack pour utiliser LACP (Link Aggregation Control Protocol)" -updated: 2025-11-07 +updated: 2025-11-10 --- - ## Objectif -Ce guide explique comment configurer un **noeud** (serveur physique) dans **OPCP** pour activer **LACP (Link Aggregation Control Protocol)**. La configuration de LACP doit être appliquée sur le noeud avant de déployer une instance, afin que les interfaces réseau soient correctement agrégées. + +**Ce guide explique comment configurer un noeud (serveur physique) dans OPCP pour activer LACP (Link Aggregation Control Protocol)**. + Nous verrons également comment configurer le **bonding** (association logique de plusieurs interfaces réseau pour former une seule interface virtuelle) au niveau de votre instance, afin de tirer pleinement parti du **LACP**. > [!warning] -> Un utilisateur standard ne peut pas configurer LACP lui-même. +> Un utilisateur standard ne peut pas configurer LACP lui-même. > Vous devez être **admin**, ou disposer de **noeud disponible** dans votre projet OpenStack. > -> Il est recommandé de configurer LACP **avant** le déploiement d’une instance. +> Il est recommandé de configurer LACP **avant** le déploiement d’une instance. > Ce guide **ne couvre pas** la configuration d'un noeud déjà en production. ## Pourquoi utiliser LACP ? -LACP peut être utilisé dans deux cas d'usage précis : +LACP peut être utilisé dans deux cas d'usage précis : -- **Augmenter la capacité réseau.** En agrégeant plusieurs cartes réseau, vous pourrez ajouter la bande passante de chaque carte réseau ajoutée à cet agrégat, pour les mêmes réseaux. -- **Augmenter la résilience.** Chaque serveur de OPCP bénéficie de 4 interfaces 25G. Chaque serveur est relié à deux switchs réseau (A&B) pour assurer la résilience en cas de panne matérielle de l'un d'entre eux. LACP permet de créer des interfaces virtuelles résilientes en cas de panne matérielle en aggrégant deux cartes réseau reliées sur des switchs distincts. +- **Augmenter la capacité réseau:** En agrégeant plusieurs cartes réseau, vous pourrez ajouter la bande passante de chaque carte réseau ajoutée à cet agrégat, pour les mêmes réseaux. +- **Augmenter la résilience:** Chaque serveur de OPCP bénéficie de 4 interfaces 25G. Chaque serveur est relié à deux switchs réseau (A&B) pour assurer la résilience en cas de panne matérielle de l'un d'entre eux. LACP permet de créer des interfaces virtuelles résilientes en cas de panne matérielle en aggrégant deux cartes réseau reliées sur des switchs distincts. ## Prérequis Avant de commencer, assurez-vous de disposer des éléments suivants : -- Disposer d'un service [OPCP](https://www.ovhcloud.com/en/hosted-private-cloud/onprem-cloud-platform/) actif. +- Disposer d'un service [OPCP](/links/hosted-private-cloud/onprem-cloud-platform) actif. - Un accès **[OpenStack CLI configuré](/pages/hosted_private_cloud/opcp/how-to-use-api-and-get-credentials)** avec les droits nécessaires (`clouds.yaml` ou variables d’environnement). - Le rôle **admin** et/ou ou des noeuds transférés dans votre projet. -- LACP est une configuration réseau spécifique, nécessitant des connaissances réseau et système avancées. Nous vous conseillons d'appliquer ce guide si vous connaissez déjà l'un ou plusieurs des concepts suivants : configuration de noeuds au sein de OpenStack Ironic, gestion des ports au sein de OpenStack Neutron, et la connaissance de la CLI OpenStack + +LACP est une configuration réseau spécifique, nécessitant des connaissances réseau et système avancées. Nous vous conseillons d'appliquer ce guide si vous connaissez déjà l'un ou plusieurs des concepts suivants : configuration de noeuds au sein de OpenStack Ironic, gestion des ports au sein de OpenStack Neutron, et la connaissance de la CLI OpenStack. ## En pratique @@ -58,8 +60,6 @@ openstack baremetal node list +--------------------------------------+----------------+--------------------------------------+-------------+--------------------+-------------+ ``` ---- - #### 2. Transférer la propriété d’un noeud (admin uniquement) Un admin peut transférer la propriété d’un noeud à un projet donné : @@ -68,8 +68,6 @@ Un admin peut transférer la propriété d’un noeud à un projet donné : openstack baremetal node set --owner ``` ---- - #### 3. Lister les ports réseau Chaque carte réseau physique, appelée Network Interface Card (NIC), d’un nœud est représentée dans OpenStack par un port. @@ -93,8 +91,8 @@ openstack baremetal port list --node +--------------------------------------+-------------------+ ``` -Pour visualiser les détails d'un port, y compris les informations sur la connexion physique. -Cela est particulièrement utile si vous souhaitez configurer un **bonding LACP 2x2**, en répartissant les NIC sur deux switches différents pour assurer une **meilleure redondance et tolérance aux pannes**. +Pour visualiser les détails d'un port, y compris les informations sur la connexion physique.
+Cela est particulièrement utile si vous souhaitez configurer un **bonding LACP 2x2**, en répartissant les NIC sur deux switches différents pour assurer une **meilleure redondance et tolérance aux pannes**. ```bash openstack baremetal port show @@ -122,8 +120,6 @@ openstack baremetal port show 71899d54-546d-4fdd-8d8b-52ad986bf425 +-----------------------+------------------------------------------------------------------------------------------------+ ``` ---- - #### 4. Activer le mode maintenance Avant toute modification de configuration réseau, le noeud doit être placé en **mode maintenance**. Cela assure que ce noeud ne puisse pas être déployé durant toute l'opération : @@ -132,16 +128,13 @@ Avant toute modification de configuration réseau, le noeud doit être placé en openstack baremetal node maintenance set ``` ---- - #### 5. Créer un groupe de ports (LACP Bond) Le **groupe de ports** permet d’activer l’agrégation LACP entre plusieurs interfaces réseau. -Utilisez le paramètre `--mode 802.3ad` pour activer LACP. -Si vous n’indiquez pas d’adresse MAC avec `--address`, l’adresse d’un des ports sera utilisée automatiquement. +Utilisez le paramètre `--mode 802.3ad` pour activer LACP. Si vous n’indiquez pas d’adresse MAC avec `--address`, l’adresse d’un des ports sera utilisée automatiquement. -> [!note] +> [!success] > Vous pouvez créer : > - un **groupe de ports unique** pour un bond 1×4, ou > - deux **groupes de ports** pour des bonds 2×2. @@ -171,8 +164,6 @@ openstack baremetal port group create \ +----------------------------+-------------------------------------------+ ``` ---- - #### 6. Associer les ports au groupe Chaque port du noeud doit être associé au groupe de ports créé : @@ -190,8 +181,6 @@ openstack baremetal port set --port-group d082c2ab-5960-44e3-920d-3d6dfb6811e9 4 openstack baremetal port set --port-group d082c2ab-5960-44e3-920d-3d6dfb6811e9 34073903-92ad-47d1-a751-15aa96991415 ``` ---- - #### 7. Désactiver le mode maintenance Une fois la configuration terminée, désactivez le mode maintenance : @@ -200,8 +189,6 @@ Une fois la configuration terminée, désactivez le mode maintenance : openstack baremetal node maintenance unset ``` ---- - #### 8. Créer une instance sur le noeud configuré Une fois votre noeud configuré avec LACP, vous pouvez déployer une instance. @@ -225,8 +212,6 @@ openstack server create --image \ ``` ---- - #### Résumé des étapes | Étape | Action | Commande | @@ -246,17 +231,17 @@ Après avoir configuré votre noeud dans OpenStack et déployé un système d’ #### Vérifier la configuration du bonding -Sur certaines images (comme **Debian 12** ou **Ubuntu 22.04**), la configuration du **bonding** est automatiquement détectée et configurée. +Sur certaines images (comme **Debian 12** ou **Ubuntu 22.04**), la configuration du **bonding** est automatiquement détectée et configurée.
Cependant, d’autres distributions peuvent nécessiter un ajustement manuel. -##### 1. Vérifier les bonds actifs +**1. Vérifier les bonds actifs** ```bash ls /proc/net/bonding/ bond0 ``` -##### 2. Vérifier les interfaces membres +**2. Vérifier les interfaces membres** ```bash cat /proc/net/bonding/bond0 | grep Interface @@ -266,24 +251,20 @@ Slave Interface: ens21f1np1 Slave Interface: ens21f0np0 ``` ---- - -##### 3. Vérifier la politique de hachage (`Transmit Hash Policy`) +**3. Vérifier la politique de hachage (`Transmit Hash Policy`)** ```bash cat /proc/net/bonding/* | grep Trans Transmit Hash Policy: layer2 (0) ``` -> [!warning] -> Pour exploiter toute la bande passante, configurez la politique `layer3+4` (par défaut, certains OS utilisent `layer2`, moins performante). +> [!warning] +> Pour exploiter toute la bande passante, configurez la politique `layer3+4` (par défaut, certains OS utilisent `layer2`, moins performante). > Plus de détails : [Ubuntu Bonding Documentation](https://help.ubuntu.com/community/UbuntuBonding?utm_source=chatgpt.com) ---- - #### Modifier la configuration -##### 1. Changement à chaud (non persistant) +**1. Changement à chaud (non persistant)** Si vous souhaitez tester votre configuration manuellement, vous pouvez utiliser la commande suivante : @@ -293,7 +274,7 @@ sudo ip link set bond0 type bond xmit_hash_policy layer3+4 Attention, cette configuration sera réinitialisée si votre machine redémarre. -#### 2. Changement persistant (exemple via Netplan et cloud-init) +**2. Changement persistant (exemple via Netplan et cloud-init)** Créez votre fichier de configuration (ex. `/etc/cloud/cloud.cfg.d/99-custom-network.cfg`) pour y inclure : @@ -323,19 +304,17 @@ network: Puis appliquez la configuration en rédémarrant l'instance. ---- - -#### 3. Tester la bande passante avec `iperf3` +**3. Tester la bande passante avec `iperf3`** Pour tester correctement LACP, vous devez disposer de **2 noeuds** dans le **même réseau**, tous deux configurés avec LACP. -##### noeud Iperf3 (noeud 1) +**noeud Iperf3 (noeud 1)** ```bash iperf3 -s ``` -##### Client Iperf3 (noeud 2) +**Client Iperf3 (noeud 2)** Utilisez `-P` pour générer plusieurs flux parallèles, afin d’atteindre la bande passante maximale. @@ -343,25 +322,25 @@ Utilisez `-P` pour générer plusieurs flux parallèles, afin d’atteindre la b iperf3 -c -P 64 ``` -##### Exemple de résultat +**Exemple de résultat** ```bash [SUM] 0.0000-10.0121 sec 110 GBytes 94.0 Gbits/sec ``` -Avec un lien 4×25 Gbps, vous devriez atteindre environ **100 Gbps**. +Avec un lien 4×25 Gbps, vous devriez atteindre environ **100 Gbps**. Il peux être nécessaire d'ajuster certains paramètres système pour exploiter pleinement cette capacité. ---- - ## Conclusion Vous avez configuré : -- Le **LACP (802.3ad)** au niveau du noeud Baremetal OpenStack, -- Le **paramétrage du bonding** dans l’OS invité, +- Le **LACP (802.3ad)** au niveau du noeud Baremetal OpenStack ; +- Le **paramétrage du bonding** dans l’OS invité ; - Et validé la **performance réseau** via `iperf3`. Votre instance est désormais prête à exploiter toute la bande passante disponible du lien agrégé. ---- +## Aller plus loin + +Échangez avec notre [communauté d'utilisateurs](/links/community). From 0c3b9e1a386333091851371423a4553f3229bc95 Mon Sep 17 00:00:00 2001 From: Montrealhub <89825661+Jessica41@users.noreply.github.com> Date: Mon, 10 Nov 2025 12:38:54 -0500 Subject: [PATCH 4/4] Update guide.fr-fr.md --- .../opcp/how-to-setup-lacp-on-node/guide.fr-fr.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/pages/hosted_private_cloud/opcp/how-to-setup-lacp-on-node/guide.fr-fr.md b/pages/hosted_private_cloud/opcp/how-to-setup-lacp-on-node/guide.fr-fr.md index 07f55bbbc7d..f62a5aa4e56 100644 --- a/pages/hosted_private_cloud/opcp/how-to-setup-lacp-on-node/guide.fr-fr.md +++ b/pages/hosted_private_cloud/opcp/how-to-setup-lacp-on-node/guide.fr-fr.md @@ -105,7 +105,7 @@ openstack baremetal port show 71899d54-546d-4fdd-8d8b-52ad986bf425 +-----------------------+------------------------------------------------------------------------------------------------+ | Field | Value | +-----------------------+------------------------------------------------------------------------------------------------+ -| address | 85:32:f2:89:66:f9 | +| address | 85:32:f2:89:66:f9 | | created_at | 2025-01-06T10:43:38.020574+00:00 | | extra | {} | | internal_info | {} | @@ -304,11 +304,11 @@ network: Puis appliquez la configuration en rédémarrant l'instance. -**3. Tester la bande passante avec `iperf3`** +#### 3. Tester la bande passante avec `iperf3` Pour tester correctement LACP, vous devez disposer de **2 noeuds** dans le **même réseau**, tous deux configurés avec LACP. -**noeud Iperf3 (noeud 1)** +**Noeud Iperf3 (noeud 1)** ```bash iperf3 -s