> 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

Référence de tous les paramètres de configuration du cluster VergeOS, y compris le type de processeur, l'allocation de RAM, les atténuations de sécurité, les politiques de ressources de calcul, le swap et la supervision de la température des nœuds.

Le *Paramètres du cluster* le 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 modifications des 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/reprise 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 du mode de maintenance**](/run-the-platform/fr/operations/maintenance-mode.md) **appropriées lors du redémarrage des nœuds afin d’éviter toute interruption des charges de travail.**
{% endhint %}

## Accès 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 ; cependant, 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 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 associées à ce cluster. Ce paramètre est automatiquement sélectionné lors de l’installation du cluster, en fonction du matériel CPU détecté. Lors de la configuration initiale, examinez ce paramètre pour vérifier que le bon type de CPU a été détecté.

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

{% hint style="warning" %}
**Tous les nœuds d’un cluster doivent contenir le même matériel CPU ; des types de CPU mixtes au sein d’un même cluster peuvent provoquer 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 la mise en cache des performances vSAN.

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

* Lorsqu’il reste de la RAM disponible, au-delà des besoins du système et des charges de travail virtuelles, envisagez d’augmenter ce paramètre
* L’augmentation du *Tampon de stockage par nœud* peut améliorer significativement les performances en 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/de désactiver diverses fonctionnalités et atténuations 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 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 lors de l’exécution de très petites machines virtuelles uniquement ou de systèmes d’exploitation invités anciens avec un support limité des hugepages.
2. **Désactiver les mitigations de sécurité du CPU :** Si cette option est sélectionnée, les mitigations 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 mitigations de sécurité du CPU puisse améliorer les performances, cela peut être risqué. Ne sélectionnez cette option que si vous faites entièrement confiance à tous les invités exécutés dans ce cluster et pouvez être certain 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 Speculative Store Bypass :** Si cette option est sélectionnée, désactive le Speculative Store Bypass (SSB) à l’exécution. La désactivation du SSB peut entraîner une baisse de performance faible à modérée, selon les charges de travail du système.
4. **Désactiver le SMT :** Si cette option est sélectionnée, désactive le multithreading simultané (SMT) à l’exécution.

{% hint style="info" %}

* La désactivation du SMT réduira considérablement les performances, car elle désactive le 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 au prix d’une baisse de performances
* La manière recommandée de 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 les états de veille de bas niveau. Cela peut éliminer les transitions inutiles d’état de veille dues à de courtes périodes d’inactivité, qui entraîneraient autrement une baisse notable des performances pour un gain 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éagir rapidement à mesure que la demande augmente
* La sélection de cette option peut entraîner des températures et une consommation électrique plus élevées, selon les charges de travail du système
  {% endhint %}

6. **Activer la détection de split lock :** Détecte les événements de split lock au sein des charges de travail et les signale 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/performances (par défaut =*****Performances*****):** 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 à sa valeur par défaut, afin de permettre au système d’optimiser dynamiquement les performances à l’exécution. Des options alternatives d’énergie et de performances sont disponibles pour prendre en charge des environnements non professionnels tels que les systèmes grand public, les labs domestiques ou les déploiements de démonstration de faisabilité (POC).
8. **Gestionnaire d’échelle CPU (par défaut =*****Performances*****):** Politique d’ajustement dynamique de la fréquence 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 à sa valeur par défaut, afin de permettre au système d’optimiser dynamiquement les performances à l’exécution. Des options alternatives d’énergie et de performances sont disponibles pour prendre en charge des environnements non professionnels tels que les systèmes grand public, les labs domestiques ou les déploiements de démonstration de faisabilité (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 de journal afficher dans l’interface utilisateur. Les entrées correspondant à ces filtres sont affichées ; toutes les autres sont exclues de la vue de l’interface. Cette syntaxe prend en charge les filtres de facility et de priorité, ainsi que les inclusions ou exclusions spécifiques à un programme.

{% hint style="success" %}
**Les journaux non filtrés restent accessibles via&#x20;*****Diagnostics du nœud*****&#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 de 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 migrer une fois le paramètre abaissé.
* La limite affecte le démarrage et la migration des charges de travail (c.-à-d. le démarrage sur un nouveau nœud). Elle ne vous interdit pas de créer une charge de travail avec davantage de RAM, mais empêche seulement son démarrage si la limite est dépassée.
* En règle générale, choisissez la plus faible valeur de RAM qui répond tout de même aux besoins de votre plus grande charge de travail attendue. Des allocations de RAM plus faibles pour chaque charge de travail 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 car :
  * VergeOS réserve de la RAM pour les opérations système et les fonctionnalités vSAN
  * Pendant la maintenance ou le 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 correctement vers un autre nœud
* **Approche recommandée :** Réglez 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 de 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 migrer 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 d’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 en conditions normales. Ce seuil aide à éviter la surallocation par de nouvelles charges de travail. Cependant, il peut être dépassé dans des circonstances particulières telles que le basculement ou la migration de charge de travail afin de maintenir la continuité de service.

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

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

4. **% de 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" %}
**Mises en garde concernant la surallocation de RAM**

* L’utilisation de cette 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 présentant une utilisation mémoire élevée des charges de travail ou des charges de travail critiques
* Envisagez de redimensionner les VM en réduisant les allocations de RAM lorsque l’utilisation est systématiquement 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 en utilisant l’accélération matérielle de l’hôte.

{% hint style="info" %}
**La virtualisation imbriquée peut impliquer des implications de sécurité et des problèmes de file d’attente/comptabilisation équitable.**
{% 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 de 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é lors des 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 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 la 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 %}

### Activation de la virtualisation imbriquée

La virtualisation imbriquée nécessite deux paramètres ; elle doit être activée à la fois au niveau du cluster et au niveau de la VM :

1. **Niveau du cluster :** Activez le **Virtualisation imbriquée** paramètre dans la liste ci-dessus. Si un message de redémarrage apparaît en haut du tableau de bord du cluster, redémarrez les nœuds du cluster en utilisant les procédures de [procédures du mode de maintenance](/run-the-platform/fr/operations/maintenance-mode.md).
2. **Niveau de la VM :** Depuis le tableau de bord de la VM, cliquez sur **Modifier** et activez **Virtualisation imbriquée** dans les paramètres de la VM.

Redémarrez la VM après avoir activé les deux paramètres. La fonctionnalité CPU est appliquée au démarrage de la VM.

{% hint style="info" %}
Le **Autoriser la migration à chaud de la virtualisation imbriquée** paramètre est distinct. Il contrôle uniquement si les VM avec virtualisation imbriquée peuvent migrer à chaud entre les nœuds ; il n’est pas requis pour exécuter la virtualisation imbriquée.
{% endhint %}

{% hint style="success" %}
**Cas d’usage Hyper-V**

L’exécution d’Hyper-V dans un invité Windows est une raison courante d’activer la virtualisation imbriquée. Lorsque la virtualisation imbriquée n’est pas activée aux deux niveaux, le rôle Hyper-V peut faire entrer l’invité dans une boucle de démarrage peu après l’apparition du logo Windows. Si le rôle Hyper-V échoue encore après un redémarrage, éteignez complètement la VM puis rallumez-la. L’exécution d’Hyper-V en tant qu’invité imbriqué convient aux scénarios de laboratoire et de test ; ce n’est pas une configuration certifiée pour la production.
{% 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 swap. Le swap est désactivé lorsque la valeur est 0
2. **Swap par lecteur :** Quantité d’espace swap à allouer par lecteur

## Température du nœud

Cette section vous permet de définir les paramètres du comportement d’alerte de VergeOS liés à des températures CPU plus é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 les pannes et les dommages au matériel physique ; laisser le matériel CPU atteindre ses limites de température maximales peut provoquer son arrêt automatique ou des blocages complets, ainsi que des dommages matériels potentiels.

1. **Température maximale des cœurs (Celsius)** Définit une température de pointe à utiliser pour la surveillance de température VergeOS (utilisée avec le paramètre suivant : *Pourcentage du seuil d’avertissement de température maximale des cœurs*).

   * ***interroger le 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 anciens peuvent ne pas prendre en charge cette requête ; dans de tels cas, le paramètre </strong><em><strong>personnalisé</strong></em><strong> peut être sélectionné pour définir une température maximale sur laquelle baser les avertissements VergeOS.</strong></p></div>

   * ***personnalisé*** - permet de définir manuellement une température de pointe spécifique. Reportez-vous à 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 ex. fournisseur bare metal, ou lorsque VergeOS s’exécute dans un environnement virtuel)
2. **Pourcentage du seuil d’avertissement de température maximale des cœurs** Définit une limite de 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éponse à un problème thermique.

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

Si *Température maximale des cœurs (Celsius)* est défini à 80 degrés et *Pourcentage du seuil d’avertissement de température maximale des cœurs* est défini à 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 rapportées atteignent cette température, l’état du nœud devient rouge et une entrée d’erreur apparaît dans le journal système.

   * ***interroger le 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 anciens peuvent ne pas prendre en charge cette requête ; dans de tels cas, le paramètre </strong><em><strong>personnalisé</strong></em><strong> peut être sélectionné pour définir une température maximale sur laquelle baser les avertissements VergeOS.</strong></p></div>

   * ***personnalisé*** - permet de définir manuellement une température critique. Reportez-vous à 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 ex. 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.
