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

# Sustitución de un nodo usando el instalador ISO

Esta guía cubre la sustitución de un nodo físico de VergeOS trasladando las unidades del servidor original al hardware de reemplazo y utilizando la opción del instalador ISO de VergeOS **Reemplazar nodo** para volver a registrar el nuevo chasis con el clúster existente.

## Descripción general

{% hint style="info" %}
**Puntos clave**

* Este procedimiento reemplaza el chasis de un nodo mientras **se reutilizan las unidades originales del nodo** en el nuevo hardware
* Puede utilizarse para la sustitución de un nodo averiado o para la retirada proactiva de hardware al final de su vida útil
* Requiere el instalador ISO de VergeOS que coincida con la versión del sistema instalada
* Solo debe reemplazarse un nodo a la vez
  {% endhint %}

{% hint style="warning" %}
**Las unidades deben trasladarse desde el nodo original**

Este procedimiento solo aplica cuando las unidades originales se transfieren al nodo de reemplazo. Si necesita reemplazar un nodo **y** sus unidades, póngase en contacto con [Soporte de VergeOS](/overview/es/support-and-services.md) para obtener ayuda.
{% endhint %}

### Lo que aprenderás

* Cómo poner un nodo fuera de línea de forma segura y preparar el hardware de reemplazo
* Cómo usar la opción del instalador ISO de VergeOS **Reemplazar nodo** opción
* Cómo verificar que el nodo de reemplazo esté en buen estado y vuelva a unirse al clúster

### Lo que necesitará

* Un clúster de VergeOS existente y en buen estado (con la excepción del nodo averiado que se está reemplazando)
* Servidor de reemplazo con todas las unidades instaladas (transferidas desde el nodo original)
  * El hardware de reemplazo debe ser compatible con los nodos del clúster existente; se prefiere hardware idéntico
* Medio de arranque que contenga el instalador ISO de VergeOS que coincida con la versión actualmente instalada en el sistema
* Credenciales de nivel administrador para el sistema VergeOS

## Antes de empezar

* **Reemplace solo un nodo a la vez.** Verifique que no haya otros nodos actualmente en modo de mantenimiento antes de comenzar.
* **Confirme el estado del sistema.** Asegúrese de que el clúster esté en un estado saludable (todos los niveles de vSAN en verde, sin alertas activas) antes de continuar.
* **Planifique la migración de las cargas de trabajo.** Si existen recursos de cómputo suficientes en los nodos restantes, el reemplazo puede realizarse sin tiempo de inactividad. Las cargas de trabajo pueden migrarse a otros nodos durante el procedimiento.
* **Asegúrese de que la retención de instantáneas del sistema sea suficiente para una posible reversión.** Tome una instantánea del sistema inmediatamente antes del procedimiento de reemplazo o verifique que haya disponible una instantánea reciente del sistema si fuera necesario.

## Procedimiento de reemplazo

### Paso 1: Ponga fuera de línea el nodo original

El enfoque depende de si el nodo original sigue funcionando.

**Si el nodo sigue funcionando:**

1. En la interfaz de VergeOS, vaya a **Infraestructura** > **Nodos**.
2. Haga doble clic en el nodo para abrir su panel de control.
3. Haga clic en **Habilitar mantenimiento** en el menú izquierdo y confirme.
4. Espere a que todas las cargas de trabajo en ejecución se migren fuera del nodo. Supervise la sección **Máquinas en ejecución** hasta que quede vacía. Apague cualquier carga de trabajo que no pueda migrarse.
5. Una vez que el nodo esté en modo de mantenimiento sin cargas de trabajo en ejecución, apáguelo.
6. Desconecte todos los cables de red del nodo original.

**Si el nodo ya no funciona (no se detecta en el sistema):**

1. Apague el nodo si aún no está apagado.
2. Desconecte todos los cables de red del nodo original.

### Paso 2: Prepare el nodo de reemplazo

1. Registre la dirección MAC de cada NIC del servidor de reemplazo, indicando qué puerto físico corresponde a cada función de red (por ejemplo, core1, core2, externa). Necesitará esta información durante el paso de confirmación de NIC del instalador.
2. Con el nodo de reemplazo **apagado**, conecte todos los cables de red. El nuevo nodo debe estar conectado a las mismas redes que el nodo original.

### Paso 3: Arranque desde el ISO de VergeOS

1. Asegúrese de que el medio de instalación (por ejemplo, una unidad USB que contenga el ISO de VergeOS) esté conectado al nodo de reemplazo.
2. Encienda el nodo y arranque desde el ISO.

   <div data-gb-custom-block data-tag="hint" data-style="success" class="hint hint-success"><p><strong>Menú de arranque</strong></p><p>Puede que necesite acceder al menú de arranque único del servidor (comúnmente <strong>F11</strong> o <strong>F12</strong> en el POST) para seleccionar el dispositivo USB.</p></div>
3. Cuando aparezca el menú del instalador, seleccione **Reemplazar nodo**.
4. Se detecta el nodo a reemplazar. Confirme que el nodo correcto esté seleccionado y presione **Introduzca**.

### Paso 4: Confirme las conexiones de red

El instalador escanea la red y enumera todas las NIC detectadas. Revise cada entrada y verifique que la dirección MAC mostrada coincida con la función de red correcta (core1, core2, externa, etc.).

{% hint style="success" %}
**Desajuste de NIC**

Si las asignaciones de NIC no parecen estar conectadas a las redes correctas, salga del instalador y vuelva a comprobar el cableado y las configuraciones del switch. Después de corregir cualquier conexión, reinicie desde el medio de instalación y vuelva a iniciar el instalador.
{% endhint %}

### Paso 5: Complete la instalación

1. Un cuadro de diálogo preguntará si está reemplazando las unidades del nodo. Seleccione **No** para indicar que las unidades originales se han trasladado a este nuevo chasis.

   <div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p><strong>Al reemplazar un nodo junto con sus unidades, póngase en contacto con</strong> <a href="/spaces/yj8JovQN0DuGOoi1frJ7/pages/011f6a45f9b7a9008ddfbcaae27c3d1bade4e62f"><strong>Soporte de VergeOS</strong></a><strong>.</strong></p></div>
2. Espere a que la instalación se complete por completo. El instalador finaliza el reemplazo del nodo y registra el nuevo chasis con el clúster existente. Un mensaje indicará cuándo se haya completado la instalación y el nodo se reiniciará automáticamente. Este proceso suele tardar entre 5 y 15 minutos.

## Pasos posteriores al reemplazo

### Verificación

1. **Confirme el estado del nodo:** Navegue a **Infraestructura** > **Nodos** y verifique que todos los nodos, incluido el de reemplazo, aparezcan en línea con un estado saludable (verde).

{% hint style="success" %}
**Deshabilitar el modo de mantenimiento**

Si el nodo reemplazado muestra ***Modo de mantenimiento*** estado, seleccione el nodo y haga clic en **Deshabilitar mantenimiento** en el menú de la izquierda.
{% endhint %}

2. **Compruebe si hay alertas:** Navegue a **Sistema** > **Alertas** y confirme que no se hayan activado nuevas alertas.
3. **Verifique las conexiones de red:** Abra el panel de control del nodo de reemplazo (**Infraestructura** > **Nodos** > haga doble clic en el nodo). Desplácese hasta **NICs** sección. **Confirmar:**
   * Las conexiones de red core y externa muestran un estado de ***ACTIVO***
   * Las conexiones de red core muestran un estado de tejido de ***Confirmado***

### Iniciar cargas de trabajo en el nodo reemplazado

Después de que el reemplazo haya sido verificado por completo, las cargas de trabajo pueden migrarse de vuelta o reiniciarse en el nodo de reemplazo según sea necesario.

## Resumen

Hemos reemplazado con éxito un nodo físico trasladando las unidades originales al nuevo hardware y utilizando la opción del instalador ISO de VergeOS **Reemplazar nodo** opción. El nodo de reemplazo ahora está registrado con el clúster y listo para ejecutar cargas de trabajo.

## Solución de problemas

### No se encontró ningún nodo adecuado

**Síntomas:**

* Error durante la instalación que indica que no se encontró ningún nodo adecuado para el reemplazo

**Resolución:**

* El nodo original debe estar apagado/desconectado. Un nodo que simplemente se haya puesto en modo de mantenimiento no puede reemplazarse.
* Verifique que el nodo original no aparezca como "En ejecución" o "Modo de mantenimiento" en la interfaz de VergeOS y vuelva a arrancar el nuevo nodo con el ISO de instalación de VergeOS.

### La instalación de reemplazo no finaliza como se esperaba

**Síntomas:**

* El proceso se detiene después de mostrar "Deteniendo el appserver" y no se completa
* La instalación pasa a la línea de comandos informando: "vergeos install cancelled"
* Entradas del registro del sistema:

  ```
  ybsan: Error al escribir la clave raíz en el nodo 'node2': (5) error de entrada/salida
  ```

**Resolución:**

* Estas condiciones pueden indicar:
  * **Privilegios insuficientes:** Verifique que está usando credenciales con permisos de nivel administrador
  * **Configuraciones incorrectas de red:** Confirme que el nodo de reemplazo tenga conexiones correctas a las redes core y a la(s) red(es) externa(s).
* Después de realizar los ajustes necesarios, puede reiniciar la instalación sin reiniciar el sistema: `yb-install --restart`

## Recursos adicionales

* [Modo de mantenimiento](/run-the-platform/es/operaciones/maintenance-mode.md)
* [Resumen de nodos](/run-the-platform/es/administracion-del-sistema/nodes-overview.md)
* [Creación de medios de instalación de arranque](/plan-and-deploy/es/guia-de-implementacion/install-media.md)

{% hint style="info" %}
**¿Necesita ayuda?**

Si encuentra problemas o tiene preguntas, póngase en contacto con [Soporte de VergeOS](/overview/es/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/es/operaciones/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.
