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

# Reemplazo de una unidad defectuosa o al final de su vida útil

Reemplazar con prontitud una unidad vSAN defectuosa o al final de su vida útil es esencial para mantener la protección de los datos. Esta página explica cómo identificar las unidades problemáticas y completar el reemplazo de forma segura.

{% hint style="danger" %}
**Antes de empezar**

* **Use una unidad de reemplazo compatible.** El reemplazo debe ser el mismo modelo o equivalente, coincidiendo con el original en capacidad, tipo de interfaz y especificaciones. Usar una unidad de tamaño insuficiente o incompatible puede provocar pérdida de datos o inestabilidad de vSAN.
* **La unidad de reemplazo debe estar vacía.** Verifique que no contenga datos, especialmente ningún dato de VergeOS vSAN. Una unidad usada previamente en un VergeOS vSAN que no haya sido borrada puede causar problemas graves en el sistema si se reutiliza como reemplazo. En caso de duda, borre la unidad en otro sistema antes de usarla.
* **Coloque siempre el nodo en modo de mantenimiento antes de realizar cualquier acción de reemplazo de unidad.** Esto es fundamental para garantizar que vSAN pueda proteger correctamente los datos durante el proceso de reemplazo.
  {% endhint %}

## ¿Cuándo necesita reemplazarse una unidad?

La interfaz de VergeOS mostrará notificaciones cuando haya un problema con una unidad física. Las advertencias y errores de las unidades se indican en varias áreas de la interfaz de usuario de VergeOS.

### Alertas

Se genera una alarma cuando una unidad del nodo tiene advertencias o errores.

**Para ver los detalles:**

* Haga clic en el acceso rápido Alarmas en la parte superior derecha o vaya a **Sistema > Alarmas**.
* Haga doble clic en la entrada de advertencia o error de la unidad.
* Esto le llevará al panel del nodo. Haga clic en *Unidades* para acceder a la lista de unidades del nodo.
* Haga doble clic en una unidad con error/advertencia para ver su panel, que muestra más detalles.

### Panel del sistema

El *Unidades del nodo* La tarjeta del Panel del sistema muestra amarillo o rojo cuando cualquier unidad física está en estado de advertencia o error.

**Para ver los detalles:**

* Navegue a **Sistema > Panel**.
* Haga clic en cualquier lugar dentro de la *Unidades del nodo* tarjeta para acceder a la lista completa de unidades.
* Haga doble clic en una unidad con error/advertencia para ver su panel, que muestra más detalles.

### Ejemplos de estados de advertencia/error

* **Advertencia** - El nivel de desgaste superó el/los umbral(es) máximo(s)
* **Advertencia** - Los sectores reasignados superaron el/los umbral(es) máximo(s)
* **Error** - La unidad no responde; se alcanzó el umbral de error de lectura o escritura
* **Ausente** - El sistema ya no detecta la unidad (falló o fue retirada físicamente)

{% hint style="warning" %}
**Configure alertas proactivas de unidades**

Detectar los problemas de las unidades a tiempo es fundamental. Una unidad degradada o averiada que pase desapercibida puede escalar hasta convertirse en una falla que amenace la redundancia de vSAN. **Muy recomendable: configure al menos un método de notificación activo para que los administradores sean alertados tan pronto como VergeOS detecte un problema en una unidad.**

Hay varias opciones disponibles:

* **Panel y alarmas** — La interfaz de VergeOS genera una alarma y muestra las advertencias/errores de las unidades en el Panel del sistema. Revisar el panel con regularidad puede detectar problemas, pero esto depende de que alguien lo esté mirando activamente.
* **Motor de tareas + webhooks** — Use el motor de tareas de VergeOS para activar automáticamente acciones (webhooks, correos electrónicos, llamadas a la API) cuando ocurran eventos de las unidades. Esto permite enviar notificaciones push a sistemas externos como canales de Slack, Prometheus Alertmanager, Zluri o cualquier plataforma compatible con webhooks, proporcionando alertas casi instantáneas y automáticas.
* **Suscripciones** — Configure suscripciones para enviar notificaciones por correo electrónico bajo demanda cuando VergeOS detecte un problema en una unidad y/o programe informes periódicos (por ejemplo, resúmenes diarios del Panel del sistema) para visibilidad rutinaria. Consulte la [Resumen de suscripciones](/run-the-platform/es/administracion-del-sistema/subscriptions-overview.md) para obtener detalles de configuración.
  {% endhint %}

## ¿Qué procedimiento de reemplazo debo usar?

El procedimiento de reemplazo depende del estado actual de la unidad:

| Estado de la unidad                                        | Condición                                                 | Procedimiento                                                                                                              |
| ---------------------------------------------------------- | --------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------- |
| **Ausente** o **Error** (sin respuesta) o **Sin conexión** | La unidad ya falló y no responde                          | [Escenario 1: reemplazar una unidad averiada/ausente](#scenario-1-replace-a-failedmissing-drive)                           |
| **Advertencia** o **Degradada**                            | La unidad sigue funcionando, pero muestra signos de fallo | [Escenario 2: reemplazar de forma proactiva una unidad en funcionamiento](#scenario-2-proactively-replace-a-working-drive) |

{% hint style="success" %}
**Cómo saber si una unidad está ausente**

Una unidad ausente mostrará un estado de **Ausente** en la lista de unidades. Esto ocurre cuando la unidad ha fallado por completo, ha perdido la conexión o ya ha sido retirada físicamente. La entrada de la unidad permanece en la interfaz para permitirle iniciar el proceso de reemplazo.
{% endhint %}

## Determine la unidad física correcta para el reemplazo

1. Vaya al **panel del nodo**.
2. Localice el *estado del LED* campo en la tarjeta de Estado.
3. Intente **activar el LED de la unidad**:

   * Si ***estado del LED*** indica **Desactivado**, haga clic **Encender LED** en el menú de la izquierda.
   * Si ***estado del LED*** indica **No compatible**, haga clic **Localizar LED** en el menú de la izquierda. Aparecerá la ventana de Diagnósticos con los ajustes ya completados; haga clic en **Enviar ->** para activar el LED de la unidad.

   <div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p><strong>La localización por LED requiere compatibilidad de hardware</strong></p><p>La localización por LED solo está disponible cuando el hardware la admite. Si el estado del LED aparece como no compatible y la función de localización no responde, utilice en su lugar los consejos de identificación siguientes.</p></div>
4. Una vez activado el LED, localice la unidad física encontrando la que tenga una luz de localización fija o intermitente.
5. Después de identificar la unidad, **desactive el LED**: seleccione **Apagar LED** o **Localizar LED**; cambie el estado a Desactivado; Enviar.

### Si la localización por LED no está disponible

Si su hardware no admite la localización por LED, utilice estos consejos para identificar la unidad física correcta:

* **Para una unidad averiada** (estado **Ausente** o **Sin conexión**): Una unidad averiada normalmente no muestra actividad: no hay luz de actividad intermitente. Las unidades que funcionan tendrán una luz de actividad parpadeante; una unidad muerta estará apagada o mostrará un indicador de error fijo.
* **Compare los números de serie**: El número de serie de la unidad que se muestra en el panel de la unidad de VergeOS puede compararse con la etiqueta de la unidad física.

## Reemplazo en caliente frente a reemplazo con apagado

**La mayoría de los sistemas de producción** usan bahías de unidades hot-swap, que permiten retirar y reemplazar una unidad mientras el nodo sigue encendido (en modo de mantenimiento). Los procedimientos siguientes asumen capacidad hot-swap.

**Algunos sistemas** — como entornos POC, laboratorios domésticos o nodos con unidades en ranuras PCIe — requieren que el nodo esté apagado antes de poder intercambiar las unidades. Si su sistema no admite hot-swap:

1. Coloque el nodo en **Modo de mantenimiento** como se indica.
2. **Apague el nodo de forma ordenada** desde la interfaz de VergeOS (no un apagado forzado) antes de retirar cualquier unidad.
3. Realice el intercambio físico de la unidad.
4. Vuelva a encender el nodo y espere a que vuelva a unirse al clúster.
5. Continúe con los pasos restantes.

{% hint style="warning" %}
**Si retira la unidad equivocada**

Si retira accidentalmente la unidad equivocada, vuelva a insertarla de inmediato. En los sistemas hot-swap, no es necesario reiniciar. En los sistemas que requieren apagar el nodo, vuelva a encenderlo después de volver a insertar la unidad. En cualquiera de los dos casos, como el nodo está en modo de mantenimiento (como se indica), el vSAN está protegido y no habrá pérdida de datos. Una vez que el nodo vuelva a estar en línea, puede comenzar de nuevo el procedimiento y retirar la unidad correcta.
{% endhint %}

## Misma ranura frente a ranura diferente: qué esperar

Los pasos para completar un reemplazo en VergeOS difieren según si inserta la nueva unidad en la **misma ranura** que la original o en una **ranura diferente**. Esto se aplica a ambos escenarios siguientes.

| Ranura de reemplazo  | Lo que muestra la interfaz                                                                                                    | Pasos requeridos                                                                                             |
| -------------------- | ----------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------ |
| **Misma ranura**     | VergeOS reconoce la ranura e informa de la nueva unidad como **Sin conexión** (tratándola como el miembro original sin datos) | Seleccione la nueva unidad (sin conexión) → **Formatear** → **Inicializar**                                  |
| **Ranura diferente** | La entrada de la unidad original permanece (como **Ausente** o **Sin conexión**) y la nueva unidad aparece por separado       | Seleccione la **entrada de la unidad original** → **Reemplazar** → seleccione la nueva unidad como reemplazo |

***

## Escenario 1: reemplazar una unidad averiada/ausente

Use este procedimiento cuando una unidad ya ha fallado y ya no responde, o cuando la unidad muestra un estado de **Ausente** en la interfaz de usuario.

{% hint style="danger" %}
**PRECAUCIÓN: Antes de iniciar una operación de reparación de unidad, verifique:**

1. El nodo que contiene la unidad fallida está en **modo de mantenimiento**. Todos los demás nodos deben estar en línea y funcionando completamente.

2. No hay otras reparaciones de unidades en ejecución en otros nodos dentro del mismo nivel de almacenamiento *(las reparaciones en el mismo nodo físico son aceptables)*.

3. Ha identificado correctamente la unidad física adecuada (vea [Determine la unidad física correcta para el reemplazo](#determine-the-correct-physical-drive-for-replacement) arriba).

4. La unidad de reemplazo está vacía y es compatible (vea las advertencias al inicio de esta página).
   {% endhint %}

5. **Coloque el nodo** que tiene la unidad fallida **en modo de mantenimiento.**

6. Si la unidad fallida sigue físicamente presente, **retírela** del nodo.

7. **Inserte la unidad de reemplazo.** (Si su sistema requiere primero apagar el nodo, siga los pasos de [Reemplazo en caliente frente a apagado](#hot-swap-vs-shutdown-replacement) anteriores.)

8. **Espere** a que el sistema detecte la nueva unidad.

9. Desde el panel del nodo, haga clic en **Unidades**.

10. Complete el reemplazo usando el método que coincida con el lugar donde instaló la unidad:

    **Si la unidad está en la misma ranura que la original:**

    1. Haga clic para **seleccione la nueva unidad (sin conexión)**.
    2. Haga clic en **Formatear** en el menú izquierdo y confirme.
    3. **Espere** hasta que el formateo se complete.
    4. Haga clic en **Inicializar** en el menú izquierdo y confirme.

    **Si la unidad está en una ranura diferente:**

    1. Haga clic para **seleccione la entrada de la unidad original fallida/ausente** en la lista.
    2. Haga clic en **Reemplazar** en el menú de la izquierda.
    3. En el cuadro de diálogo, **seleccione la nueva unidad** de la lista de unidades disponibles.
    4. Haga clic en **Enviar** para confirmar.

{% hint style="success" %}
El sistema iniciará el proceso de reparación. El estado de la unidad cambiará a "Reparando" y el panel mostrará una **fecha y hora estimadas de finalización de la reparación.**
{% endhint %}

***

## Escenario 2: reemplazar de forma proactiva una unidad en funcionamiento

Use este procedimiento cuando una unidad siga funcionando, pero muestre señales de advertencia (como advertencias de nivel de desgaste o sectores reasignados) y desee reemplazarla antes de que falle.

{% hint style="danger" %}
**PRECAUCIÓN: Antes de iniciar una operación de reparación de unidad, verifique:**

1. El nodo que contiene la unidad que se va a reemplazar está en **modo de mantenimiento**. Todos los demás nodos deben estar en línea y funcionando completamente.

2. No hay otras reparaciones de unidades en ejecución en otros nodos dentro del mismo nivel de almacenamiento *(las reparaciones en el mismo nodo físico son aceptables)*.

3. Ha identificado correctamente la unidad física adecuada (vea [Determine la unidad física correcta para el reemplazo](#determine-the-correct-physical-drive-for-replacement) arriba).

4. La unidad de reemplazo está vacía y es compatible (vea las advertencias al inicio de esta página).
   {% endhint %}

5. **Coloque el nodo** que tiene la unidad defectuosa **en modo de mantenimiento.**

6. Desde el panel del nodo, haga clic en **Unidades**.

7. **Haga doble clic en la unidad** que se va a reemplazar. Esto le lleva al panel de la unidad.

8. Haga clic en **Cerrar/Poner fuera de línea** en el menú de la izquierda. Confirme haciendo clic en *Sí*.

9. Cuando el estado de la unidad muestre **Sin conexión**, **retire físicamente** la unidad.

10. **Verifique** la interfaz muestra la unidad como *Ausente*, confirmando que se retiró la unidad correcta.

11. **Inserte la unidad de reemplazo.** (Si su sistema requiere primero apagar el nodo, siga los pasos de [Reemplazo en caliente frente a apagado](#hot-swap-vs-shutdown-replacement) anteriores.)

12. **Espere** a que se detecte la nueva unidad. La nueva unidad aparecerá como "Sin conexión".

13. Complete el reemplazo usando el método que coincida con el lugar donde instaló la unidad:

    **Si la unidad está en la misma ranura que la original:**

    1. Haga clic para **seleccione la nueva unidad (sin conexión)**.
    2. Haga clic en **Formatear** en el menú izquierdo y confirme.
    3. **Espere** hasta que el formateo se complete.
    4. Haga clic en **Inicializar** en el menú izquierdo y confirme.

    **Si la unidad está en una ranura diferente:**

    1. Haga clic para **seleccione la entrada de la unidad original** (mostrándose como **Ausente** o **Sin conexión**).
    2. Haga clic en **Reemplazar** en el menú de la izquierda.
    3. En el cuadro de diálogo, **seleccione la nueva unidad** de la lista de unidades disponibles.
    4. Haga clic en **Enviar** para confirmar.

{% hint style="success" %}
Después de que vSAN haya completado un recorrido completo, comenzará el proceso de reparación y el estado de la unidad cambiará a "Reparando". El panel de la unidad indicará una **fecha y hora estimadas de finalización de la reparación.**
{% endhint %}

***

## Durante el proceso de reparación

{% hint style="warning" %}
**Importante**

Lo siguiente se aplica a **tanto** escenarios de reemplazo:

* **NO reinicie, restablezca ni apague ningún nodo** hasta que la unidad muestre un estado de "En línea". Todos los demás nodos deben permanecer completamente operativos durante el proceso de reparación.
* **No inicie operaciones adicionales de reemplazo/reparación de unidades** hasta que esta se haya completado por completo, a menos que la otra unidad esté en el mismo nodo o en un nivel de almacenamiento diferente.
* **Considere mantener el modo de mantenimiento:** El nodo puede salir del modo de mantenimiento una vez que la unidad haya comenzado la reparación; sin embargo, dejarlo activado durante todo el proceso puede acelerar la reparación.
  {% endhint %}

## Solución de problemas

Si la **Reemplazar** la opción no funciona o el proceso de reemplazo falla:

1. **Cicle la alimentación del nodo** - Esto puede ayudar al sistema a detectar correctamente la nueva unidad y limpiar cualquier estado obsoleto.
2. **Verifique la compatibilidad de la unidad** - Asegúrese de que la unidad de reemplazo cumpla las mismas especificaciones que la original (capacidad, tipo de interfaz, clase de rendimiento).
3. **Compruebe el asiento de la unidad** - Asegúrese de que la nueva unidad esté correctamente insertada en la ranura.
4. **Contacte con soporte** - Si los problemas persisten después de ciclar la alimentación, póngase en contacto con el soporte de VergeOS para obtener ayuda.


---

# 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/drive-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.