> For the complete documentation index, see [llms.txt](https://docs.verge.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.verge.io/run-the-platform/fr/administration-systeme/cluster-settings.md).

# Paramètres du cluster

Le *Paramètres du cluster* ce formulaire vous permet de configurer les paramètres clés liés aux performances, à la sécurité, à l’allocation, à la surveillance thermique et au swap. Bien que la majorité des paramètres par défaut conviennent à la plupart des environnements, il est recommandé de les examiner lors de la création d’un nouveau cluster, puis périodiquement par la suite, afin de garantir leur conformité avec les politiques et les exigences opérationnelles de votre organisation.

{% hint style="success" %}
**La plupart des changements de paramètres du cluster nécessiteront un redémarrage de chaque nœud du cluster. Un message apparaîtra en haut du tableau de bord du cluster lorsqu’un redémarrage est nécessaire. Sélectionnez l’option&#x20;*****Redémarrage requis*****&#x20;(dans le message de redémarrage en haut du tableau de bord du cluster ou dans l’option du menu de gauche) pour gérer les redémarrages des nœuds du cluster. Suivez toujours les procédures appropriées du** [**mode de maintenance**](/run-the-platform/fr/operations/maintenance-mode.md) **lors du redémarrage des nœuds afin d’éviter toute perturbation des charges de travail.**
{% endhint %}

## Accéder aux paramètres du cluster

* Dans le menu supérieur, accédez à **Infrastructure** > **Clusters** > **double-cliquez sur le cluster souhaité**
* Cliquez sur **Modifier** dans le menu de gauche.

## Cluster

Cette section définit les propriétés fondamentales de votre cluster.

1. **Activé :** Par défaut, le cluster sera activé. En général, il n’y a aucune raison de le désactiver ; toutefois, cela peut être utile dans certaines situations, par exemple lors d’une reconfiguration complète du cluster.
2. **Nom :** Un cluster est généralement nommé lors de l’installation, mais il peut être renommé sans problème.
3. **Description :** Zone de texte facultative permettant de fournir une brève description du rôle ou des caractéristiques du cluster.
4. **Type de CPU par défaut :** Définit le type de CPU par défaut/recommandé pour les machines virtuelles auxquelles ce cluster est attribué. Ce paramètre est sélectionné automatiquement lors de l’installation du cluster, en fonction du matériel CPU détecté. Lors de la configuration initiale, vérifiez le paramètre pour confirmer que le type de CPU détecté est correct.

{% hint style="success" %}
**Pour permettre la migration/prise de relais de machines virtuelles vers un autre cluster utilisant une catégorie inférieure de processeur,&#x20;*****Le type de CPU par défaut*****&#x20;peut être modifié vers un type de catégorie inférieure afin de permettre le transfert des machines virtuelles vers l’ancien matériel de processeur sans problème.**
{% endhint %}

{% hint style="warning" %}
**Tous les nœuds d’un cluster doivent disposer du même matériel CPU ; des types de CPU mélangés au sein d’un même cluster peuvent entraîner des problèmes de performances et de migration des charges de travail.**
{% endhint %}

5. **Tampon de stockage par nœud (2 Go par défaut) :** Quantité de RAM supplémentaire à allouer par nœud pour le cache de performance vSAN.

{% hint style="info" %}
**Considérations**

* Lorsqu’il y a de la RAM disponible, au-delà des besoins du système et des charges de travail virtuelles, envisagez d’augmenter ce paramètre
* Augmenter le *tampon de stockage par nœud* peut améliorer considérablement les performances de lecture/écriture
* En règle générale, visez une utilisation de la RAM ne dépassant pas 80 % en fonctionnement normal
  {% endhint %}

### Sécurité/performances du cluster

Cette sous-section vous permet d’activer/désactiver diverses fonctionnalités et mesures d’atténuation liées aux performances et à la sécurité pour tous les nœuds du cluster.

1. **Allouer des hugepages pour le stockage (activé par défaut) :** L’activation des hugepages est fortement recommandée dans la plupart des cas, car elle améliore les performances de stockage en mémoire pour les charges de travail. La désactivation de ce paramètre est généralement déconseillée, sauf dans de rares cas, par exemple lorsqu’on exécute uniquement de très petites machines virtuelles ou des systèmes d’exploitation invités hérités avec une prise en charge limitée des hugepages.
2. **Désactiver les mesures d’atténuation de sécurité du CPU :** Si cette option est sélectionnée, les mesures d’atténuation de sécurité du CPU au niveau du noyau sont désactivées pour le cluster.

{% hint style="warning" %}
**IMPORTANT : bien que la désactivation des mesures d’atténuation de sécurité du CPU puisse améliorer les performances, cela peut être risqué. Ne sélectionnez cette option que si vous avez une confiance totale dans tous les invités exécutés dans ce cluster et que vous pouvez garantir que les charges de travail ne présentent aucune vulnérabilité externe (par exemple, systèmes isolés du réseau).**
{% endhint %}

3. **Désactiver le contournement spéculatif du stockage :** Si cette option est sélectionnée, le contournement spéculatif du stockage (SSB) est désactivé à l’exécution. La désactivation du SSB peut entraîner une baisse de performances légère à modérée, selon les charges de travail du système.
4. **Désactiver le SMT :** Si cette option est sélectionnée, le multithreading simultané (SMT) est désactivé à l’exécution.

{% hint style="info" %}

* La désactivation du SMT nuira considérablement aux performances, car elle désactive l’hyper-threading
* Bien que les logiciels modernes et les mises à jour du microcode atténuent généralement de nombreuses vulnérabilités liées au SMT, certains environnements hautement sensibles peuvent choisir de le désactiver, même si cela a un coût en termes de performances
* La méthode recommandée pour désactiver le SMT est dans le BIOS. Le nom exact du paramètre peut varier selon le fabricant ; consultez la documentation de votre matériel en cas de doute
  {% endhint %}

5. **Désactiver les états de veille pour les CPU :** Si cette option est sélectionnée, VergeOS désactive automatiquement le ou les états de veille de bas niveau. Cela peut éliminer les transitions d’état de veille inutiles dues à de courtes périodes d’inactivité, qui entraîneraient autrement une baisse notable des performances avec un bénéfice minimal en efficacité énergétique.

{% hint style="info" %}

* La désactivation des états de veille du CPU peut être particulièrement bénéfique sur les systèmes nouvellement déployés, où les charges de travail sont ajoutées progressivement. Dans ces cas, les nœuds inactifs doivent répondre rapidement à mesure que la demande augmente
* La sélection de cette option peut entraîner des températures et une consommation d’énergie plus élevées, selon les charges de travail du système
  {% endhint %}

6. **Activer la détection des split lock :** Détecte les événements de split lock au sein des charges de travail et les consigne dans le journal système. L’activation de cette option peut avoir un impact sur les performances des machines virtuelles qui déclenchent un split lock.
7. **Politique énergie-performance (par défaut=*****Performance*****):** Paramètre de politique qui guide la logique interne du processeur afin d’équilibrer les performances et l’efficacité énergétique. Il est généralement préférable de laisser ce paramètre sur sa valeur par défaut, ce qui permet au système d’optimiser dynamiquement les performances à l’exécution. Des options alternatives d’énergie et de performance sont disponibles pour prendre en charge les environnements non professionnels tels que les systèmes grand public, les laboratoires à domicile ou les déploiements de preuve de concept (POC).
8. **Gouverneur de fréquence du CPU (par défaut=*****Performance*****):** Politique d’ajustement dynamique de la fréquence du CPU au niveau du noyau, en fonction de la charge du système. Il est généralement préférable de laisser ce paramètre sur sa valeur par défaut, ce qui permet au système d’optimiser dynamiquement les performances à l’exécution. Des options alternatives d’énergie et de performance sont disponibles pour prendre en charge les environnements non professionnels tels que les systèmes grand public, les laboratoires à domicile ou les déploiements de preuve de concept (POC).

### Filtre du journal système

1. **Filtre du journal système (par défaut `*:3,ipmievd:5,rasdaemon,!ntpd,!postfix`):** Une liste de filtres séparés par des virgules, au format rsyslog, qui détermine quelles entrées du journal afficher dans l’interface utilisateur. Les entrées correspondant à ces filtres sont affichées ; toutes les autres sont exclues de la vue dans l’interface utilisateur. Cette syntaxe prend en charge les filtres de facility et de priorité, ainsi que les inclusions ou exclusions spécifiques aux programmes.

{% hint style="success" %}
**Les journaux non filtrés restent accessibles via&#x20;*****Diagnostics des nœuds*****&#x20;(Accédez à&#x20;*****Nœuds*****&#x20;> double-cliquez sur le nœud souhaité > sélectionnez&#x20;*****Diagnostics*****&#x20;dans le menu de gauche.)**
{% endhint %}

## Calcul

Cette section configure les politiques de ressources de calcul pour votre cluster. Ces paramètres ne s’appliqueront pas aux clusters de stockage uniquement.

1. **RAM maximale par machine :** Spécifie la quantité maximale de RAM pouvant être allouée à une seule charge de travail (comme une machine virtuelle, un nœud locataire ou un service NAS).

{% hint style="success" %}
**Considérations**

* Si des charges de travail en cours d’exécution (par ex. des VM) utilisent plus de RAM que cette limite, elles ne pourront pas être migrées une fois le paramètre abaissé.
* La limite affecte le démarrage et la migration des charges de travail (c.-à-d. leur démarrage sur un nouveau nœud). Elle n’interdit pas de créer une charge de travail avec plus de RAM, mais empêche seulement son démarrage si la limite est dépassée.
* En règle générale, choisissez la valeur de RAM la plus faible qui réponde encore aux besoins de votre plus grande charge de travail attendue. Des allocations de RAM plus faibles pour les charges de travail individuelles maximiseront la flexibilité pour les migrations, les basculements et la portabilité des charges de travail, et permettront des temps de basculement plus rapides.
* **Soyez prudent lorsque vous définissez cette limite à proximité de la capacité de RAM physique d’un nœud**. Si vous définissez cette limite pour qu’elle corresponde à la RAM totale d’un nœud (par ex. 128 Go), puis créez une VM utilisant cette quantité totale, la VM ne pourra pas démarrer ni migrer parce que :
  * VergeOS réserve de la RAM pour les opérations système et la fonctionnalité vSAN
  * Lors de la maintenance ou d’un basculement, les charges de travail doivent migrer vers d’autres nœuds disponibles
  * Une VM consommant presque toute la RAM disponible ne peut pas migrer avec succès vers un autre nœud
* **Approche recommandée :** Définissez cette limite à au plus 70 à 80 % de la RAM physique de votre plus petit nœud, afin de garantir que les VM puissent toujours migrer pendant les scénarios de maintenance ou de basculement.
  {% endhint %}

2. **Nombre maximal de cœurs par machine :** Spécifie le nombre maximal de cœurs CPU pouvant être alloués à une seule charge de travail (comme une machine virtuelle, un nœud locataire ou un service NAS)

{% hint style="success" %}
**Considérations**

* Si des charges de travail en cours d’exécution (par ex. des VM) utilisent plus de cœurs que cette limite, elles ne pourront pas être migrées une fois le paramètre abaissé.
* Dans presque tous les cas, cette valeur **ne devrait pas dépasser** le nombre de cœurs disponibles dans un **seul socket CPU**.
* **Cette valeur ne devrait jamais dépasser le nombre total de cœurs physiques dans un seul nœud**
  {% endhint %}

3. **Pourcentage maximal de RAM cible (80 par défaut) :** Spécifie le pourcentage maximal de RAM physique qu’un nœud du cluster devrait utiliser dans des conditions normales. Ce seuil aide à éviter la surallocation due à de nouvelles charges de travail. Cependant, il peut être dépassé dans des circonstances particulières, comme lors d’un basculement ou d’une migration de charge de travail, afin de maintenir la continuité du service.

{% hint style="info" %}
**Exemple de&#x20;*****pourcentage maximal de RAM cible***

* Un nœud du cluster dispose de **252 Go de RAM physique disponible** (256 Go dont 252 Go après la surcharge BIOS/carte graphique)
* ***pourcentage maximal de RAM cible*** est défini sur la valeur par défaut de **80**
* 252G \* 80 % = **environ 200G** utilisables dans des conditions normales
* **Surcharge mémoire système/vSAN 16G** (note : la surcharge vSAN variera selon la quantité de stockage du cluster)
* **Disponible pour les nouvelles charges de travail :** 184 Go (utilisable moins la surcharge), tout en restant dans la cible d’utilisation de 80 %
* **Lors d’un basculement ou d’une migration :** L’utilisation de la RAM par les charges de travail **peut temporairement dépasser 184 Go** pour prendre en charge les charges de travail déplacées
  {% endhint %}

4. **% de la RAM de réserve à utiliser pour les machines :** définit une portion (en pourcentage) du swap réservée spécifiquement pour simuler de la RAM supplémentaire pour les charges de travail lorsque la RAM physique est épuisée. Cette RAM virtuelle peut être configurée comme solution de secours pour la surallocation de RAM.

{% hint style="warning" %}
**Précautions concernant la surallocation de RAM**

* L’utilisation de cette fonctionnalité de RAM de réserve est généralement prévue uniquement comme solution de secours pour la surallocation de RAM
* Évitez la surallocation sur les clusters avec une utilisation mémoire élevée des charges de travail ou des charges critiques
* Envisagez d’adapter la taille des VM en réduisant les allocations de RAM lorsque l’utilisation reste constamment faible
* Si trop de VM demandent simultanément leur allocation mémoire complète, les performances des charges de travail peuvent être dégradées, car la RAM virtuelle est des ordres de grandeur plus lente que la RAM physique (millisecondes contre nanosecondes)
  {% endhint %}

5. **Virtualisation imbriquée :** Permet d’utiliser une machine virtuelle à l’intérieur d’une autre machine virtuelle grâce à l’accélération matérielle de l’hôte.

{% hint style="info" %}
**La virtualisation imbriquée peut entraîner des implications de sécurité et des problèmes de répartition équitable/mesure de l’utilisation.**
{% endhint %}

6. *Autoriser la migration à chaud de la virtualisation imbriquée :*\* Autorise la migration à chaud des machines virtuelles avec virtualisation imbriquée.
7. *Autoriser la migration à chaud du vGPU :*\* Autorise la migration à chaud des machines virtuelles équipées de périphériques vGPU (expérimental). Bien que cela n’ait pas été entièrement vérifié par les tests, la migration à chaud des charges de travail vGPU s’est généralement révélée fiable lorsque les derniers pilotes NVIDIA sont utilisés à la fois sur l’hôte et sur l’invité.

{% hint style="info" %}
**Si suffisamment de périphériques vGPU ne sont pas disponibles, les charges de travail peuvent être temporairement arrêtées pendant la maintenance.**
{% endhint %}

{% hint style="success" %}
\***Migrations à chaud**

Le paramètre de machine virtuelle : *Méthode de migration* permet de définir le comportement de migration par VM (par ex. exiger un arrêt manuel, tenter une migration à chaud)
{% endhint %}

## Stockage (paramètres de swap)

{% hint style="warning" %}
**Les paramètres de swap sont spécifiés lors de l’installation du cluster. Les modifications des paramètres de swap ne s’appliqueront qu’aux disques nouvellement formatés.**
{% endhint %}

1. **Niveau utilisé pour le swap :** Niveau de stockage à utiliser pour l’espace de swap. Le swap est désactivé lorsque la valeur est 0
2. **Swap par disque :** Quantité d’espace de swap à allouer par disque

## Température des nœuds

Cette section vous permet de définir les paramètres du comportement d’alerte de VergeOS liés aux températures CPU élevées sur les nœuds du cluster. Une notification rapide, avant d’atteindre les températures maximales du CPU, peut permettre de prendre des mesures pour éviter des interruptions de service et des dommages au matériel physique ; laisser le matériel CPU atteindre ses limites de température maximales peut provoquer l’arrêt automatique du CPU ou des blocages complets, ainsi que d’éventuels dommages matériels.

1. **Température maximale des cœurs (Celsius)** Établit une température de pic à utiliser pour la surveillance de température de VergeOS (utilisée en combinaison avec le paramètre suivant : *Seuil d’avertissement de température maximale des cœurs %*).

   * ***interrogation du matériel*****&#x20;(par défaut)** - récupère la température maximale définie par le matériel depuis le CPU

   <div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p><strong>Le matériel non serveur et certains serveurs hérités peuvent ne pas prendre en charge cette interrogation ; dans ce cas, le paramètre </strong><em><strong>personnalisé</strong></em><strong> peut être sélectionné pour établir une température maximale sur laquelle fonder les avertissements de VergeOS.</strong></p></div>

   * ***personnalisé*** - permet de définir manuellement une température de pic spécifique. Consultez la documentation de votre matériel pour vérifier la température maximale de votre CPU.
   * ***désactiver*** - cette sélection peut être utilisée lorsque vous ne souhaitez pas surveiller la température dans VergeOS (lorsque vous n’êtes pas responsable de la surveillance du matériel, par exemple chez un fournisseur bare metal, ou lorsque VergeOS s’exécute dans un environnement virtuel)
2. **Seuil d’avertissement de température maximale des cœurs %** Définit une limite en pourcentage par rapport à la température maximale des cœurs (ci-dessus) à laquelle déclencher un état d’avertissement. Un état d’avertissement entraînera un statut de nœud jaune et une entrée d’avertissement sera créée dans le journal système. En général, un seuil d’au moins 10 % ou plus est recommandé afin de laisser le temps de prendre les mesures appropriées en réaction à un problème thermique.

{% hint style="info" %}
**Exemple**

Si *Température maximale des cœurs (Celsius)* est définie à 80 degrés et *Seuil d’avertissement de température maximale des cœurs %* est définie à 10, l’état d’avertissement se déclenchera lorsque le matériel CPU indiquera 72 degrés.
{% endhint %}

3. **Température critique des cœurs (Celsius) :** Définit la température à laquelle déclencher un état d’erreur dans VergeOS. Lorsque les températures matérielles signalées atteignent cette température, le statut du nœud passe au rouge et une entrée d’erreur apparaîtra dans le journal système.

   * ***interrogation du matériel*****&#x20;(par défaut)** - récupère la température critique définie par le matériel depuis le CPU

   <div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p><strong>Le matériel non serveur et certains serveurs hérités peuvent ne pas prendre en charge cette interrogation ; dans ce cas, le paramètre </strong><em><strong>personnalisé</strong></em><strong> peut être sélectionné pour établir une température maximale sur laquelle fonder les avertissements de VergeOS.</strong></p></div>

   * ***personnalisé*** - permet de définir manuellement une température critique. Consultez la documentation de votre matériel pour vérifier la température maximale de votre CPU.
   * ***désactiver*** - cette sélection peut être utilisée lorsque vous ne souhaitez pas surveiller la température dans VergeOS (lorsque vous n’êtes pas responsable de la surveillance du matériel, par exemple chez un fournisseur bare metal, ou lorsque VergeOS s’exécute dans un environnement virtuel)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.verge.io/run-the-platform/fr/administration-systeme/cluster-settings.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
