> 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/operations/sop-verge-install.md).

# Guide d’installation de VergeOS

Ce guide fournit des procédures standardisées et des bonnes pratiques pour les ingénieurs et administrateurs VergeOS réalisant une installation initiale du système à l'aide de la nouvelle interface d'installation.

{% hint style="info" %}
**Vue d'ensemble**

L'installation de votre système VergeOS nécessite une planification et une exécution minutieuses afin de garantir un déploiement réussi. Ce guide décompose le processus en phases principales :

1. **Préparation** - Étapes à suivre avant de planifier l'installation
2. **Préinstallation** - Vérifications finales dans les 24 heures précédant l'installation
3. **Installation** - Le processus d'installation et de configuration du système
4. **Après l'installation** - Vérification que l'installation a réussi
   {% endhint %}

{% hint style="info" %}
**Exigences spécifiques à l'environnement**

Ce guide couvre les bonnes pratiques générales. Vous devrez peut-être adapter ces étapes à votre environnement et à vos exigences spécifiques. Prévoyez de l'espace pour tenir compte du nombre de nœuds, des configurations réseau et d'autres besoins.
{% endhint %}

## Prérequis

* Accès physique aux nœuds matériels pour l'installation
* Infrastructure réseau configurée et prête
* Accès IPMI/gestion à distance à tous les nœuds
* Identifiants de licence VergeOS
* **Temps estimé :** 4 à 8 heures selon la complexité de la configuration

## Objectif

Réaliser l'installation initiale de Node1 et Node2+, le minimum requis pour la redondance du système et la prise en charge du système de production.

## Phase de préparation

Effectuez ces étapes avant de planifier l'installation :

### Exigences matérielles

* [ ] Confirmer que le matériel répond aux exigences minimales

{% hint style="info" %}
**Documentation matérielle**

Consultez la [documentation de dimensionnement VergeOS](/plan-and-deploy/fr/guide-de-mise-en-oeuvre/sizing.md) pour connaître les exigences actuelles et détaillées.

\[ ] **Exigences CPU :**

* [ ] CPU 64 bits avec prise en charge de la virtualisation matérielle \[ ] **Exigences mémoire :**
* [ ] 16 Go de RAM par nœud vSAN disponibles pour l'OS
* [ ] +1 Go de RAM par 1 To de stockage vSAN brut ; par exemple 16 Go+4 Go = 20 Go de RAM/nœud pour un nœud avec 4 To de stockage vSAN brut \[ ] **IPMI/Gestion à distance :**
* [ ] IPMI ; iDRAC, iLO ou équivalent \[ ] **Contrôleur de disque :**
* [ ] Contrôleur de disque HBA (préféré)
* [ ] si contrôleur RAID : assurez-vous qu'il prend en charge le mode JBOD/IT
* [ ] Assurez-vous que le contrôleur prend en charge le démarrage depuis NVME si vous les utilisez \[ ] **Exigences réseau :**
* [ ] 1 interface réseau physique/nœud pour l'interface VergeOS UI/'Externe'
* [ ] Deuxième paire liée du même type *Fortement* recommandé pour la redondance
* [ ] 1 interface réseau 10 Gbit/s ou plus /nœud pour le tissu central VergeOS
* [ ] Deuxième de même type *Fortement* recommandé pour la redondance (non lié) \[ ] **Exigences de stockage :**
* [ ] Stockage Tier0 (facultatif, recommandé)
  * [ ] Basé sur NVMe
  * [ ] Haute endurance en écriture (3+ écritures par jour sur le disque \[DWPD] recommandées)
  * [ ] 5 Go/1 To de disque utilisable dans vSAN (10 Go/1 To recommandés)
* [ ] Niveaux de stockage (1 requis, > facultatif)
  * [ ] Au moins un niveau de stockage NVMe relié en PCIe *Fortement recommandé*
  * [ ] Performant par rapport aux attentes de la charge de travail
* [ ] Chiffrement de disque au repos
  * [ ] Disque USB/nœud pour la clé de déchiffrement vSAN (si souhaité)
    {% endhint %}

### Support d'installation et documentation

* [ ] Créez le support d'installation selon la [documentation VergeOS](/plan-and-deploy/fr/guide-de-mise-en-oeuvre/install-media.md)
  * [ ] Testez le support de démarrage pour vérifier son fonctionnement
* [ ] Documentez et créez toutes les exigences réseau

{% hint style="info" %}
**Documentation réseau**

Consultez la [documentation de conception réseau VergeOS](/plan-and-deploy/fr/guide-de-mise-en-oeuvre/network-design.md) pour connaître les exigences réseau actuelles et détaillées.

\[ ] **Configuration du réseau principal :**

* [ ] VLAN1 du réseau principal créé et documenté
* [ ] VLAN2 du réseau principal créé et documenté \[ ] **Configuration du réseau externe :**
* [ ] VLAN1 du réseau externe créé et documenté
* [ ] VLAN2 du réseau externe créé et documenté \[ ] **Configuration IP :**
* [ ] Adresse IP UI/gestion attribuée et documentée
* [ ] Configuration de la passerelle documentée
* [ ] Serveurs DNS identifiés et documentés \[ ] **Documentation de conception/construction du réseau**
* [ ] Carte des câbles A-B créée et documentée
* [ ] Élévation de baie documentée
* [ ] Document/dessin de conception de couche 2 réseau créé
* [ ] Document/dessin de conception de couche 3 réseau créé
  {% endhint %}

### Accès au système et configuration

* [ ] Vérifier l'accès IPMI à tous les nœuds
* [ ] Examiner les exigences des paramètres du BIOS
  * [ ] Méthode de démarrage appropriée sélectionnée (Legacy/Dual/UEFI) ***UEFI requis si tous les disques sont en NVMe***
  * [ ] Virtualisation assistée par matériel activée
  * [ ] Hyperthreading activé
  * [ ] Tous les cœurs du processeur activés
  * [ ] Horloges réglées correctement (tous les nœuds à quelques secondes près)

### Décisions de planification

* [ ] Passez en revue l'ensemble de la procédure décrite ici
* [ ] Préparez les informations nécessaires pour mener à bien l'ensemble du processus
* [ ] Décidez de la préférence de réservation de RAM : plus de *Mémoire utilisable* **OU** Plus *application du HA N+1*
* [ ] Planifiez le calendrier d'installation et la communication aux parties prenantes

## Phase de préinstallation

Effectuez ces vérifications dans les 24 heures précédant l'installation planifiée :

### Vérification de l'état actuel

* [ ] Vérifier l'état actuel
  * [ ] Tout le matériel est physiquement installé et sous tension
  * [ ] Tous les câbles réseau réussissent le « test de traction »
  * [ ] Configurations des commutateurs terminées et testées
  * [ ] La configuration réseau actuellement en cours d'exécution a été vérifiée et un « write mem » a été effectué
  * [ ] IPMI accessible sur tous les nœuds
  * [ ] Les IP requises sont disponibles et libres
  * [ ] Trames jumbo (MTU 9216+) configurées sur les commutateurs

### Vérification finale du matériel

* [ ] Tous les disques apparaissent dans le BIOS
* [ ] Toutes les cartes réseau apparaissent dans le BIOS
* [ ] Comparer les adresses MAC aux enregistrements
* [ ] Date et heure correctes dans le BIOS
* [ ] Paramètres de virtualisation activés

### Vérification finale du réseau

* [ ] Les commutateurs du réseau principal répondent
* [ ] Les commutateurs du réseau externe répondent
* [ ] Aucun serveur DHCP en conflit (si vous utilisez DHCP)
* [ ] Documentation disponible pour le dépannage

## Phase d'exécution

### Installation du contrôleur principal

Le processus d'installation proprement dit suivant l'ordre de l'installateur :

* [ ] Démarrer depuis l'installateur USB
* [ ] Sélectionner « Standard Install »
* [ ] Sélectionner « Controller »
* [ ] Sélectionner « New Install »

### Configuration du système

**Configuration NTP :**

* [ ] Saisissez une liste d'espaces de serveurs NTP, ou laissez la valeur par défaut

**Configuration date/heure :**

* [ ] Confirmez soigneusement la date actuelle
* [ ] Confirmez très soigneusement l'heure actuelle (le nœud 1 contrôle le NTP du système)

**Identification du système :**

* [ ] Saisissez le nom de votre système. (Cela pourra être modifié après l'installation)

### Configuration du compte administrateur

* [ ] Saisissez le nom d'utilisateur de votre administrateur, ou laissez la valeur par défaut
* [ ] Saisissez le mot de passe de votre compte administrateur (il doit être généré et stocké dans votre dépôt de mots de passe)
* [ ] Définissez l'adresse e-mail du compte administrateur (facultatif mais conseillé)

### Configuration des interfaces réseau

**Interfaces du réseau principal :**

* [ ] Sélectionnez l'interface réseau Core1
* [ ] Configurez le nom de l'interface Core1, le MTU, Core (laissez « Yes ») et le VLAN selon les besoins
* [ ] Sélectionnez l'interface réseau Core2
* [ ] Configurez le nom de l'interface Core2, le MTU, Core (laissez « Yes ») et le VLAN selon les besoins

**Interface réseau externe :**

* [ ] Sélectionnez l'interface réseau externe
* [ ] Configurez le nom du réseau externe, le MTU (généralement 1500), Core (modifiez en « No »).
* [ ] Configurez le VLAN externe (si nécessaire)
* [ ] Définissez l'IP externe (format CIDR)
* [ ] Définissez la passerelle externe
* [ ] Définissez les serveurs DNS externes

### Configuration de la licence

* [ ] Sélectionnez le serveur de licences (production ou essai/NFR)
* [ ] Saisissez les identifiants de l'utilisateur de licence
* [ ] Saisissez le mot de passe de licence (stockez-le en toute sécurité dans le dépôt de mots de passe)

### Configuration du stockage

**Chiffrement vSAN :**

* [ ] Choisissez le paramètre de chiffrement vSAN (Oui/Non)
* [ ] Documentez la clé de chiffrement, si elle est activée (stockez-la en toute sécurité dans le dépôt de mots de passe)
* [ ] Créez un disque USB de chiffrement (fortement recommandé si vous utilisez le chiffrement vSAN)

**Sélection des disques vSAN et attribution des niveaux :**

* [ ] Sélectionnez les disques vSAN pour l'installation
* [ ] Attribuez les disques aux niveaux de stockage appropriés (comme prévu lors de la préparation de l'installation)

**Configuration du swap :**

* [ ] Configurez l'attribution du swap selon les besoins
* [ ] Une fois l'installation terminée, retirez le support USB
* [ ] Redémarrer

### Vérification du nœud principal

* [ ] Le système démarre sur un écran « bleu » sur la console
* [ ] L'UI est accessible à l'adresse IP configurée
* [ ] Tous les indicateurs d'état sont verts dans l'UI
* [ ] vSAN monté et sain

## Installation du contrôleur secondaire

* [ ] Démarrez le nœud secondaire depuis l'installateur USB
* [ ] Sélectionner « Controller »
* [ ] Sélectionnez « No » pour une nouvelle installation
* [ ] Saisissez les identifiants d'administrateur du contrôleur principal
* [ ] Confirmez la détection automatique du réseau (ARRÊTEZ si une IP ou une interface détectée n'est pas conforme aux attentes !)
* [ ] Faites correspondre les paramètres de chiffrement à ceux du contrôleur principal
* [ ] Faites correspondre les attributions de niveaux de disque à celles du contrôleur principal

### Vérification du nœud secondaire

* [ ] Le système démarre sur un écran « bleu » sur la console
* [ ] Node2 visible dans l'UI principale
* [ ] Tous les indicateurs d'état sont verts
* [ ] État vSAN vert sur les deux nœuds

## Vérification après installation

Une fois l'installation terminée, vérifiez que le système fonctionne correctement :

### Vérifications de l'état du système

* [ ] Tous les indicateurs du tableau de bord sont verts
* [ ] Aucune alerte ou avertissement inattendu dans les journaux du tableau de bord
* [ ] Tous les nœuds affichent la bonne version
* [ ] Tous les nœuds sont à l'état « Running » (vérifiez chaque nœud individuellement)
* [ ] Aucun redémarrage de nœud en attente
* [ ] État de santé vSAN vert sur tous les niveaux
* [ ] Connectivité du tissu principal vérifiée
* [ ] Connectivité du réseau externe vérifiée

### Validation de la configuration du système

* [ ] Niveau de stockage VM par défaut défini
* [ ] Pourcentage maximal de RAM cible du cluster configuré
* [ ] Synchronisations de site configurées (si nécessaire)
* [ ] Système activé et à jour
* [ ] Configuration du serveur SMTP (fortement recommandée)
* [ ] Notifications par e-mail de l'utilisateur administrateur configurées

### Tests finaux

* [ ] Tester la création de VM et les opérations de base
* [ ] Vérifier la connectivité réseau depuis la VM de test
* [ ] Confirmer la fonctionnalité des instantanés
* [ ] Tester la sauvegarde/restauration du système si applicable

## Dépannage

### Problèmes courants

**Problèmes de démarrage :**

* Vérifiez que les paramètres de démarrage du BIOS correspondent au type de support d'installation
* Vérifiez le fonctionnement du support USB sur un système connu comme fonctionnel
* Confirmez la compatibilité matérielle avec VergeOS

**Problèmes de configuration réseau :**

* Vérifiez que les configurations VLAN correspondent à la conception réseau
* Vérifiez les connexions physiques des câbles et les configurations des commutateurs
* Confirmez que l'adressage IP n'entre pas en conflit avec l'infrastructure existante

**Problèmes de configuration du stockage :**

* Vérifiez que le contrôleur de disque est en mode JBOD/IT
* Vérifiez la visibilité des disques dans le BIOS
* Confirmez que les attributions des niveaux de stockage correspondent à la documentation de planification

**Problèmes de jonction du nœud secondaire :**

* Vérifiez la connectivité réseau entre les nœuds
* Vérifiez que les identifiants d'administrateur sont corrects
* Confirmez que le nœud principal est pleinement opérationnel avant d'ajouter le secondaire

## Étapes suivantes

Après la réussite de l'installation :

* [ ] Planifiez la sauvegarde initiale du système
* [ ] Configurez la surveillance et les alertes
* [ ] Mettez à jour la documentation réseau avec la configuration finale
* [ ] Planifiez la création des locataires et l'allocation des ressources
* [ ] Planifiez une formation des administrateurs si nécessaire
* [ ] Documentez la configuration finale du système pour l'équipe d'exploitation

{% hint style="danger" %}
**Support d'urgence**

Si vous rencontrez des problèmes avec votre installation VergeOS, veuillez contacter [notre équipe support](/overview/fr/support-and-services.md) pour une assistance immédiate.
{% 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/run-the-platform/fr/operations/sop-verge-install.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.
