> 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/node-replacement.md).

# Remplacement d’un nœud à l’aide de l’installateur ISO

Ce guide explique comment remplacer un nœud physique VergeOS en déplaçant les disques du serveur d’origine vers le matériel de remplacement et en utilisant l’installateur ISO de VergeOS **Remplacer le nœud** pour réenregistrer le nouveau châssis auprès du cluster existant.

## Vue d'ensemble

{% hint style="info" %}
**Points clés**

* Cette procédure remplace le châssis d’un nœud tout en **réutilisant les disques d’origine du nœud** dans le nouveau matériel
* Peut être utilisée pour remplacer un nœud défaillant ou retirer de manière proactive un matériel en fin de vie
* Nécessite l’installateur ISO de VergeOS correspondant à la version du système installée
* Un seul nœud doit être remplacé à la fois
  {% endhint %}

{% hint style="warning" %}
**Les disques doivent être déplacés depuis le nœud d’origine**

Cette procédure s’applique uniquement lorsque les disques d’origine sont transférés vers le nœud de remplacement. Si vous devez remplacer un nœud **et** ses disques, contactez [Support VergeOS](/overview/fr/support-and-services.md) pour obtenir de l’aide.
{% endhint %}

### Ce que vous apprendrez

* Comment mettre un nœud hors ligne en toute sécurité et préparer le matériel de remplacement
* Comment utiliser l’installateur ISO de VergeOS **Remplacer le nœud** option
* Comment vérifier que le nœud de remplacement est sain et le réintégrer au cluster

### Ce dont vous aurez besoin

* Un cluster VergeOS existant et sain (à l’exception d’un nœud défaillant en cours de remplacement)
* Serveur de remplacement avec tous les disques installés (transférés depuis le nœud d’origine)
  * Le matériel de remplacement doit être compatible avec les nœuds du cluster existant ; un matériel strictement identique est préférable
* Support de démarrage contenant l’installateur ISO de VergeOS correspondant à la version actuellement installée sur le système
* Identifiants de niveau administrateur pour le système VergeOS

## Avant de commencer

* **Ne remplacez qu’un seul nœud à la fois.** Vérifiez qu’aucun autre nœud n’est actuellement en mode maintenance avant de commencer.
* **Confirmez l’état de santé du système.** Assurez-vous que le cluster est en bon état (tous les niveaux vSAN sont verts, aucune alarme active) avant de continuer.
* **Prévoir la migration des charges de travail.** Si des ressources de calcul suffisantes existent sur les nœuds restants, le remplacement peut être effectué sans interruption. Les charges de travail peuvent être migrées vers d’autres nœuds pendant la procédure.
* **Assurez-vous que la conservation des instantanés système est suffisante pour un éventuel retour en arrière.** Prenez un instantané système immédiatement avant la procédure de remplacement ou vérifiez qu’un instantané système récent sera disponible si nécessaire.

## Procédure de remplacement

### Étape 1 : Mettre le nœud d’origine hors ligne

L’approche dépend du fait que le nœud d’origine soit encore fonctionnel ou non.

**Si le nœud est encore fonctionnel :**

1. Dans l’interface VergeOS, accédez à **Infrastructure** > **Nœuds**.
2. Double-cliquez sur le nœud pour ouvrir son tableau de bord.
3. Cliquez sur **Activer la maintenance** dans le menu de gauche et confirmez.
4. Attendez que toutes les charges de travail en cours soient migrées hors du nœud. Surveillez la section **Machines en cours d’exécution** jusqu’à ce qu’elle soit vide. Arrêtez toutes les charges de travail qui ne peuvent pas migrer.
5. Une fois le nœud en mode maintenance et sans charge de travail en cours, éteignez-le.
6. Déconnectez tous les câbles réseau du nœud d’origine.

**Si le nœud n’est plus fonctionnel (non détecté dans le système) :**

1. Éteignez le nœud s’il ne l’est pas déjà.
2. Déconnectez tous les câbles réseau du nœud d’origine.

### Étape 2 : Préparer le nœud de remplacement

1. Notez l’adresse MAC de chaque NIC du serveur de remplacement, en indiquant quel port physique correspond à quel rôle réseau (par exemple, core1, core2, external). Vous aurez besoin de ces informations lors de l’étape de confirmation des NIC de l’installateur.
2. Avec le nœud de remplacement **éteint**, connectez tous les câbles réseau. Le nouveau nœud doit être connecté aux mêmes réseaux que le nœud d’origine.

### Étape 3 : Démarrer depuis l’ISO VergeOS

1. Assurez-vous que le support d’installation (par exemple, la clé USB contenant l’ISO VergeOS) est connecté au nœud de remplacement.
2. Allumez le nœud et démarrez depuis l’ISO.

   <div data-gb-custom-block data-tag="hint" data-style="success" class="hint hint-success"><p><strong>Menu de démarrage</strong></p><p>Vous devrez peut-être accéder au menu de démarrage ponctuel du serveur (généralement <strong>F11</strong> ou <strong>F12</strong> au POST) pour sélectionner le périphérique USB.</p></div>
3. Lorsque le menu de l’installateur apparaît, sélectionnez **Remplacer le nœud**.
4. Le nœud à remplacer est détecté. Confirmez que le bon nœud est sélectionné et appuyez sur **Saisissez**.

### Étape 4 : Confirmer les connexions réseau

L’installateur analyse le réseau et répertorie toutes les NIC détectées. Examinez chaque entrée et vérifiez que l’adresse MAC affichée correspond au bon rôle réseau (core1, core2, external, etc.).

{% hint style="success" %}
**Incohérence des NIC**

Si les affectations des NIC ne semblent pas être connectées aux bons réseaux, quittez l’installateur et revérifiez votre câblage ainsi que la configuration des commutateurs. Après avoir corrigé les connexions, redémarrez depuis le support d’installation et relancez l’installateur.
{% endhint %}

### Étape 5 : Terminer l’installation

1. Une boîte de dialogue vous demandera si vous remplacez les disques du nœud. Sélectionnez **Non** pour indiquer que les disques d’origine ont été déplacés dans ce nouveau châssis.

   <div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p><strong>Lors du remplacement d’un nœud avec ses disques, contactez</strong> <a href="/spaces/QmD3NiRv04lsvCD0lM5B/pages/435cfd547473c0b8f8e10a8178d7ba4d49dd159e"><strong>Support VergeOS</strong></a><strong>.</strong></p></div>
2. Attendez la fin complète de l’installation. L’installateur termine le remplacement du nœud et enregistre le nouveau châssis auprès du cluster existant. Un message indiquera lorsque l’installation sera terminée et le nœud redémarrera automatiquement. Ce processus prend généralement 5 à 15 minutes.

## Étapes après remplacement

### Vérification

1. **Confirmez l’état du nœud :** Accédez à **Infrastructure** > **Nœuds** et vérifiez que tous les nœuds, y compris le nœud de remplacement, apparaissent en ligne avec un état sain (vert).

{% hint style="success" %}
**Désactiver le mode maintenance**

Si le nœud remplacé affiche ***Mode maintenance*** comme état, sélectionnez le nœud et cliquez sur **Désactiver la maintenance** dans le menu de gauche.
{% endhint %}

2. **Vérifiez les alarmes :** Accédez à **Système** > **Alarmes** et confirmez qu’aucune nouvelle alarme n’a été déclenchée.
3. **Vérifiez les connexions réseau :** Ouvrez le tableau de bord du nœud de remplacement (**Infrastructure** > **Nœuds** > double-cliquez sur le nœud). Faites défiler jusqu’à **NICs** section. **Confirmez :**
   * Les connexions réseau cœur et externe affichent un état de ***UP***
   * Les connexions réseau cœur affichent un état de fabric de ***Confirmé***

### Démarrer les charges de travail sur le nœud remplacé

Une fois le remplacement entièrement vérifié, les charges de travail peuvent être migrées à nouveau vers le nœud de remplacement ou y être redémarrées selon les besoins.

## Résumé

Nous avons remplacé avec succès un nœud physique en transférant les disques d’origine vers un nouveau matériel et en utilisant l’option de l’installateur ISO de VergeOS **Remplacer le nœud** Le nœud de remplacement est maintenant enregistré auprès du cluster et prêt à exécuter des charges de travail.

## Dépannage

### Aucun nœud approprié trouvé

**Symptômes :**

* Erreur lors de l’installation indiquant qu’aucun nœud approprié n’a été trouvé pour le remplacement

**Résolution :**

* Le nœud d’origine doit être éteint/déconnecté. Un nœud simplement placé en mode maintenance ne peut pas être remplacé.
* Vérifiez que le nœud d’origine n’apparaît pas comme « En cours d’exécution » ou « Mode maintenance » dans l’interface VergeOS et démarrez à nouveau le nouveau nœud avec l’ISO d’installation VergeOS.

### L’installation de remplacement ne se termine pas comme prévu

**Symptômes :**

* Le processus s’arrête après l’affichage de « Stopping the appserver » et ne se termine pas
* L’installation revient à la ligne de commande en indiquant : « vergeos install cancelled »
* Entrées du journal système :

  ```
  ybsan: Error writing root key to node 'node2': (5) input/output error
  ```

**Résolution :**

* Ces conditions peuvent indiquer :
  * **Privilèges insuffisants :** Vérifiez que vous utilisez des identifiants disposant de permissions de niveau administrateur
  * **Erreurs de configuration réseau :** Confirmez que le nœud de remplacement est correctement connecté aux réseaux cœur et au(x) réseau(x) externe(s).
* Après avoir effectué les ajustements nécessaires, vous pouvez redémarrer l’installation sans redémarrage : `yb-install --restart`

## Ressources supplémentaires

* [Mode maintenance](/run-the-platform/fr/operations/maintenance-mode.md)
* [Vue d’ensemble des nœuds](/run-the-platform/fr/administration-systeme/nodes-overview.md)
* [Création d’un support d’installation amorçable](/plan-and-deploy/fr/guide-de-mise-en-oeuvre/install-media.md)

{% hint style="info" %}
**Besoin d'aide ?**

Si vous rencontrez des problèmes ou avez des questions, contactez [Support VergeOS](/overview/fr/support-and-services.md).
{% 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/node-replacement.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.
