> 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/knowledge-base/fr/virtual-machines/vm-advanced-options.md).

# Options avancées de VM

## Vue d’ensemble

Le champ Options avancées de la VM permet aux utilisateurs avancés d'affiner les paramètres de la machine virtuelle au-delà de ce qui est disponible dans l'interface utilisateur standard. Ces options offrent un contrôle granulaire sur les fonctionnalités du CPU, l'émulation matérielle et le comportement des périphériques.

{% hint style="warning" %}
**À utiliser avec prudence**

Les options avancées peuvent avoir un impact important sur les performances et la stabilité de la VM. Ne modifiez ces paramètres que si vous en comprenez les implications. Des valeurs incorrectes peuvent empêcher le démarrage de votre VM.
{% endhint %}

## Format

Les options avancées utilisent un format simple clé-valeur, avec une option par ligne :

```
option1=value1
option2=value2
option3=value3
```

## Options disponibles

### CPU et mémoire

#### Threads CPU

```
cpu.threads=2
```

Définit le nombre de threads CPU par cœur. La valeur par défaut est 1.

**Cas d’utilisation :** Activation du SMT (Simultaneous Multi-Threading) pour les applications qui tirent parti du multithreading simultané.

#### Préallocation de la mémoire

```
mem-prealloc=1
```

Préalloue toute la mémoire de la VM au démarrage au lieu de l'allouer à la demande.

**Cas d’utilisation :** Réduit la latence d'allocation mémoire pour les charges de travail critiques en termes de performances. Utile pour les applications en temps réel ou lors de l'utilisation de hugepages.

### Configuration de l'UUID

Vous pouvez personnaliser l'UUID (Identifiant Unique Universel) de la VM afin de répondre à des exigences spécifiques, comme la licence logicielle ou des scénarios de migration.

#### UUID système

```
smbios.type1.uuid=550e8400-e29b-41d4-a716-446655440000
```

Définit l'UUID système présenté au système d'exploitation invité. Il s'agit de l'UUID principal que la plupart des logiciels vérifient.

**Cas d'utilisation :**

* Migration de VM depuis d'autres plateformes tout en préservant la licence
* Logiciels qui valident un UUID spécifique
* Clonage de VM nécessitant des identifiants uniques

{% hint style="warning" %}
**Format de l'UUID**

Les UUID doivent être au format standard : `xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx` (8-4-4-4-12 caractères hexadécimaux). Les formats invalides empêcheront le démarrage de la VM.
{% endhint %}

{% hint style="success" %}
**Génération des UUID**

Sous Linux : `uuidgen` Sous Windows PowerShell : `[guid]::NewGuid()` En ligne : utilisez un outil de génération d'UUID
{% endhint %}

### Personnalisation SMBIOS

Les options SMBIOS (System Management BIOS) permettent de personnaliser les informations matérielles présentées au système d'exploitation invité.

#### Type 0 - Informations BIOS

```
smbios.type0.vendor=American Megatrends Inc.
smbios.type0.version=2.0
smbios.type0.date=01/01/2023
```

#### Type 1 - Informations système

```
smbios.type1.product=Serveur personnalisé
smbios.type1.version=1.0
smbios.type1.sku=SKU123
smbios.type1.family=Famille serveur
```

#### Type 2 - Informations de carte mère

```
smbios.type2.manufacturer=Fabricant personnalisé
smbios.type2.product=Carte personnalisée
smbios.type2.version=1.0
```

#### Type 3 - Informations de boîtier

```
smbios.type3.manufacturer=Châssis personnalisé
smbios.type3.version=1.0
smbios.type3.sku=CHASSIS123
```

#### Type 4 - Informations sur le processeur

```
smbios.type4.version=Intel(R) Xeon(R) CPU E5-2680 v4
smbios.type4.manufacturer=Intel
```

**Cas d'utilisation de SMBIOS :**

* Licences logicielles qui vérifient les signatures matérielles
* Applications attendant des configurations matérielles spécifiques
* Scénarios de test nécessitant une identification système spécifique

### Ajustement de l'interface réseau

Pour chaque NIC, vous pouvez ajuster les paramètres des files d'attente à l'aide de l'ID de l'actif de la NIC :

```
nic1.txqueuelen=2000
nic1.numtxqueues=4
nic1.numrxqueues=4
```

**Cas d'utilisation :**

* Applications réseau à haut débit
* Réduction de la latence réseau
* Optimisation pour des charges de travail réseau spécifiques

### Paramètres spécifiques à la machine

Personnalisez les paramètres de la machine QEMU :

```
machine.cap-cfpc=broken
machine.cap-sbbc=broken
machine.cap-ibs=broken
```

**Cas d'utilisation :**

* Contournement des problèmes liés à l'atténuation de sécurité du CPU
* Compatibilité avec des systèmes d'exploitation invités spécifiques
* Optimisation des performances pour les environnements de confiance

### Options RTC (horloge temps réel)

```
rtc.drift-fix=slew
```

**Cas d'utilisation :**

* Correction des problèmes de dérive de l'heure dans les VM
* Exigences de synchronisation pour les applications sensibles au temps

## Options spécifiques aux périphériques

Vous pouvez définir des paramètres pour n'importe quel périphérique à l'aide de son ID d'actif :

```
device1.guest-reset=true
device1.guest-resets-all=false
```

Pour les disques :

```
drive1.cache=writeback
drive1.detect-zeroes=on
```

## Cas d'utilisation courants

### Calcul haute performance

```
cpu.threads=2
mem-prealloc=1
nic1.numtxqueues=8
nic1.numrxqueues=8
```

### Conformité des licences Windows

```
smbios.type1.manufacturer=Dell Inc.
smbios.type1.product=PowerEdge R740
smbios.type1.serial=ABC123
```

### Préserver l'UUID après la migration

```
smbios.type1.uuid=550e8400-e29b-41d4-a716-446655440000
```

À utiliser lors de la migration d'une VM depuis une autre plateforme et lorsque le système d'exploitation invité contient un logiciel lié à l'UUID d'origine.

### Optimisation du réseau

```
nic1.txqueuelen=5000
nic1.numtxqueues=4
nic1.numrxqueues=4
```

## Bonnes pratiques

{% hint style="success" %}
**Recommandations de test**

1. Testez d'abord les options avancées dans un environnement hors production
2. Documentez toute option avancée que vous utilisez pour référence future
3. N'ajoutez que les options qui résolvent des problèmes ou des exigences spécifiques
4. Surveillez les performances de la VM après l'application des options avancées
   {% endhint %}

## Dépannage

Si votre VM ne démarre pas après l'ajout d'options avancées :

1. Supprimez toutes les options avancées et essayez de démarrer la VM
2. Réajoutez les options une par une pour identifier le paramètre problématique
3. Consultez les journaux de la VM pour des messages d'erreur spécifiques
4. Vérifiez la syntaxe - assurez-vous que chaque option se trouve sur sa propre ligne sans espaces supplémentaires

{% hint style="info" %}
**Compatibilité des versions**

Certaines options avancées peuvent ne pas être disponibles dans toutes les versions de VergeOS. Les options sont traitées dynamiquement, donc les options non prises en charge sont généralement ignorées plutôt que de provoquer des erreurs.
{% endhint %}

{% hint style="info" %}
**Informations sur le document**

* Dernière mise à jour : 2026-01-24
* Version de VergeOS : 26.1
  {% endhint %}


---

# 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/knowledge-base/fr/virtual-machines/vm-advanced-options.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.
