> 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/learn-the-platform/es/modulo-3-instalacion/01-pre-installation.md).

# Lista de verificación previa a la instalación

Una implementación exitosa de VergeOS comienza mucho antes de que se conecte la primera unidad USB. Esta página cubre todos los requisitos previos que debe verificar -- desde la configuración de BIOS y los modos del controlador de disco hasta la configuración de los switches y la preparación del medio de arranque -- para que el día de la instalación transcurra sin problemas y sin sorpresas.

```mermaid
graph LR
    A["Preparación del hardware"] --> B["BIOS y<br/>firmware"]
    B --> C["Creación del<br/>medio de arranque"]
    C --> D["Preparación<br/>de la red"]
    D --> E["Documentación<br/>y planificación"]
    E --> F["Listo<br/>para instalar"]

    style F fill:#e8f5e9,stroke:#2e7d32
```

## Preparación del hardware

Antes de programar la instalación, confirme que todo el hardware físico está montado en rack, cableado y cumple con los requisitos de VergeOS.

### Requisitos de CPU

* **procesador de 64 bits** con virtualización asistida por hardware (Intel VT-x o AMD-V)
* Todos los núcleos del procesador habilitados en BIOS
* Hyperthreading habilitado (recomendado para densidad de carga de trabajo)

### Requisitos de memoria

* **Reserva del sistema por nodo:** **16 GB del SO + 1 GB por cada 1 TB de almacenamiento bruto de vSAN** (p. ej., un nodo con 4 TB de almacenamiento bruto reserva al menos 20 GB en total)
* Planifique la RAM de las cargas de trabajo además de la reserva del sistema

### Configuración del controlador de disco

El controlador de disco es una de las fuentes más comunes de problemas de instalación. VergeOS requiere acceso directo a cada unidad individual -- no funciona con matrices RAID de hardware.

| Tipo de controlador                | Requisito                                                                                 |
| ---------------------------------- | ----------------------------------------------------------------------------------------- |
| **HBA (adaptador de bus de host)** | Preferido -- pasa las unidades directamente al SO                                         |
| **Controlador RAID**               | Debe configurarse en **modo JBOD / IT** (passthrough) -- sin matrices RAID                |
| **Unidades NVMe**                  | Verifique que el controlador admita el arranque desde NVMe si todas las unidades son NVMe |

{% hint style="warning" %}
**Error común**

Si las unidades están configuradas en una matriz RAID (incluso RAID 0), el instalador de VergeOS verá un único disco virtual en lugar de unidades individuales. Esto impide una asignación correcta de niveles de vSAN. Verifique siempre el modo JBOD antes del día de la instalación.
{% endhint %}

### Gestión remota (IPMI)

* Puertos IPMI / iDRAC / iLO parcheados, configurados y probados en cada nodo
* Firmware IPMI más reciente instalado (recomendado)
* Capacidad de consola remota verificada -- crítica para solucionar problemas de licencia o arranque durante la instalación

### Energía

* Fuentes de alimentación redundantes conectadas y configuradas (recomendado para producción)
* Protección UPS para todos los nodos y switches de red

## Configuración de BIOS

Cada nodo debe tener su BIOS configurada de forma coherente antes de comenzar la instalación. Las configuraciones de BIOS inconsistentes entre nodos son una causa común de retrasos en la instalación.

| Ajuste                               | Valor requerido                                                                       | Notas                                                                 |
| ------------------------------------ | ------------------------------------------------------------------------------------- | --------------------------------------------------------------------- |
| **Modo de arranque**                 | UEFI (preferido) o Legacy/Dual                                                        | **UEFI es obligatorio si todas las unidades son NVMe**                |
| **Virtualización de hardware**       | Habilitada (VT-x / AMD-V)                                                             | Requerida para el funcionamiento del hipervisor VergeHV               |
| **Hyperthreading**                   | Habilitado                                                                            | Recomendado para la densidad de carga de trabajo                      |
| **Todos los núcleos del procesador** | Habilitado                                                                            | No deshabilite núcleos para "ahorrar energía"                         |
| **Secure Boot**                      | **Deshabilitado**                                                                     | VergeOS implementa su propia verificación de integridad de arranque   |
| **Relojes del sistema**              | Configúrelos correctamente (todos los nodos con una diferencia de solo unos segundos) | El Nodo 1 controla NTP para todo el sistema después de la instalación |

### Por qué Secure Boot debe deshabilitarse

VergeOS no utiliza el Secure Boot tradicional de UEFI. En su lugar, VergeOS implementa su **propia verificación de integridad de arranque** que impide que imágenes manipuladas arranquen. Este enfoque proporciona una protección práctica contra manipulaciones sin las limitaciones de UEFI Secure Boot (que requiere que los sistemas operativos estén firmados con claves registradas en el firmware -- un proceso controlado por un pequeño número de autoridades de certificación).

La diferencia clave:

* **UEFI Secure Boot** opera a nivel de firmware y bloquea por completo los sistemas operativos no firmados
* **Integridad de arranque de VergeOS** valida la imagen de VergeOS durante el arranque y se niega a completarlo si la imagen ha sido modificada o manipulada

Para entornos de producción, esto proporciona una seguridad práctica equivalente. Cualquier intento de modificar los archivos del sistema de VergeOS será detectado e impedirá el arranque. Los controles de seguridad física deben complementar la verificación de integridad a nivel de software.

### Burn-in de hardware

Antes de la instalación, complete un burn-in de hardware para identificar fallos tempranos:

* Verifique que todas las unidades sean visibles en BIOS
* Confirme que todas las NIC se detecten y muestren las direcciones MAC esperadas
* Ejecute diagnósticos del fabricante (Dell BIST, HPE Insight Diagnostics, etc.) si están disponibles
* Verifique que las direcciones MAC coincidan con su documentación

## Creación del medio de arranque

La instalación de VergeOS se entrega como una única imagen ISO que contiene todos los paquetes para el sistema completo (hipervisor, almacenamiento, red y gestión). Necesitará una unidad USB de arranque para cada nodo que se instale.

{% hint style="info" %}
Póngase en contacto con el soporte de VergeOS o con su equipo de cuenta para obtener el enlace de descarga de la ISO. La ISO no está disponible públicamente.
{% endhint %}

### Windows -- Rufus

1. Descargue y abra [Rufus](https://rufus.ie/en/)
2. Inserte una unidad USB (será sobrescrita)
3. Seleccione su dispositivo USB en **Dispositivo**
4. Haga clic en **Selecciona** y elija la ISO de VergeOS
5. Haga clic en **Iniciar**
6. **Cuando se le solicite, seleccione el modo DD** -- esto es crítico

{% hint style="warning" %}
**El modo DD es obligatorio**

Rufus usa por defecto el modo ISO, pero **debe seleccionar el modo DD** para VergeOS. Si selecciona el modo ISO, el resultado será una **unidad USB no booteable**. Este es, con diferencia, el error más común con el medio de arranque.
{% endhint %}

### macOS -- BalenaEtcher

1. Descargue e instale [BalenaEtcher](https://www.balena.io/etcher/)
2. Inserte una unidad USB (será sobrescrita)
3. Haga clic en **Flash from file** y seleccione la ISO de VergeOS
4. Seleccione el disco USB de destino (verifique que haya seleccionado la unidad correcta)
5. Haga clic en **¡Grabar!** para iniciar el proceso

### Linux -- Escritor de imágenes USB

1. Navegue hasta el archivo ISO descargado en su explorador de archivos
2. Haga clic derecho sobre la ISO y elija **Crear memoria USB de arranque** (o use `dd` desde la línea de comandos)
3. Seleccione la unidad USB como destino
4. Autentíquese y escriba la imagen

### Pruebas del medio de arranque

Pruebe siempre el medio de arranque antes del día de la instalación:

* Arranque un nodo de prueba (o uno de los nodos de producción) desde la USB
* Verifique que el instalador de VergeOS se cargue en memoria y llegue al menú de instalación
* Puede cancelar el instalador de forma segura sin realizar cambios en el sistema

## Preparación de la red

La configuración de red es la tarea previa a la instalación más compleja. VergeOS requiere dos tipos distintos de red, y los switches físicos deben configurarse antes de que comience la instalación.

### Descripción general de la arquitectura de red

```mermaid
graph TB
    subgraph switches["Infraestructura física de switches"]
        SW1["Switch A"]
        SW2["Switch B"]
    end

    subgraph node1["Nodo 1"]
        N1C1["NIC 1<br/>Malla principal 1"]
        N1C2["NIC 2<br/>Malla principal 2"]
        N1E["NIC 3+4<br/>Externa (bond)"]
    end

    subgraph node2["Nodo 2"]
        N2C1["NIC 1<br/>Malla principal 1"]
        N2C2["NIC 2<br/>Malla principal 2"]
        N2E["NIC 3+4<br/>Externa (bond)"]
    end

    N1C1 --> SW1
    N1C2 --> SW2
    N1E --> SW1
    N1E --> SW2

    N2C1 --> SW1
    N2C2 --> SW2
    N2E --> SW1
    N2E --> SW2

    style switches fill:#f0f4ff,stroke:#336
```

### Red de la malla principal

La malla principal es una red privada de alta velocidad que transporta tráfico de almacenamiento vSAN, coordinación del clúster y migración de VM. Es la columna vertebral del sistema VergeOS.

**Requisitos de puertos de switch para la malla principal:**

| Ajuste             | Valor                                                               | Motivo                                                                     |
| ------------------ | ------------------------------------------------------------------- | -------------------------------------------------------------------------- |
| **Modo de puerto** | Access (sin etiquetar, una sola VLAN)                               | Una VLAN por cada red principal                                            |
| **VLAN**           | VLANs dedicadas e aisladas (p. ej., 900 para Core1, 901 para Core2) | Debe estar aislada de TODO el resto del tráfico                            |
| **MTU**            | **9216** (jumbo frames)                                             | Requerido para la eficiencia del almacenamiento y la sobrecarga de tenants |
| **Spanning Tree**  | Deshabilitado en los puertos principales                            | No es necesario para enlaces principales punto a punto dedicados           |
| **Velocidad**      | 10 Gbps o superior                                                  | Recomendación mínima para producción                                       |

{% hint style="warning" %}
**Crítico: no agrupe las NIC de la malla principal**

El agrupamiento de puertos (LAG/LACP) **no** no debe usarse en las redes de la malla principal. VergeOS construye redundancia utilizando dos redes separadas de malla principal (Core1 y Core2) en switches distintos. El bonding interferiría con este modelo de redundancia integrado.
{% endhint %}

**Cada switch principal debe usar una VLAN dedicada** -- por ejemplo, VLAN 900 para la Malla Principal 1 y VLAN 901 para la Malla Principal 2. Estas VLAN deben estar completamente aisladas del tráfico externo.

### Red externa

Las redes externas conectan las VM y las cargas de trabajo con los usuarios, Internet y la infraestructura existente.

**Requisitos de puertos de switch para redes externas:**

| Ajuste             | Valor                                                   | Motivo                                                   |
| ------------------ | ------------------------------------------------------- | -------------------------------------------------------- |
| **Modo de puerto** | Trunk (múltiples VLAN)                                  | Compatible con VLAN de gestión y de cargas de trabajo    |
| **VLANs**          | VLAN de gestión + cargas de trabajo según sea necesario | Haga trunk solo con las VLAN necesarias                  |
| **MTU**            | 1500 (estándar)                                         | A menos que las cargas de trabajo requieran jumbo frames |
| **Bonding**        | LACP o Active-Backup (opcional)                         | Recomendado para redundancia                             |

### Identificación de NIC

Antes de la instalación, mapee cada NIC física a su función prevista:

* **Mínimo absoluto:** 2 NIC por nodo -- 1 malla principal + 1 externa (se recomienda mucho una segunda NIC de malla principal, pero no es obligatoria)
* **Recomendado:** 4+ NIC por nodo (2 de malla principal + 2 externas para bonding)
* Documente la dirección MAC y la ubicación física del puerto de cada NIC
* Verifique que los módulos SFP sean compatibles tanto con la NIC como con el switch

### Planificación de direcciones IP

Asigne y documente lo siguiente antes de la instalación:

* **Dirección IP de IU/gestión** (estática, formato CIDR -- p. ej., `10.0.0.2/24`)
* **Puerta de enlace predeterminada** Dirección IP (pruebe que sea accesible / responda a ping)
* **Direcciones del servidor DNS** (al menos una, se recomiendan dos)
* **VLAN de la malla principal** (dos VLAN dedicadas, documentadas)
* **VLAN de red externa** (gestión + cualquier VLAN de carga de trabajo)

## Requisitos de documentación

Una documentación exhaustiva antes de la instalación evita retrasos y simplifica la resolución de problemas. Prepare lo siguiente:

### Mapa de cableado A-B

Documente qué NIC de cada nodo se conecta a qué switch y puerto. Etiquete ambos extremos de cada cable.

### Elevación del rack

Registre la posición física de cada nodo, switch y PDU en el rack.

### Diagramas de diseño de red

Diagramas de Capa 2 (asignaciones VLAN, puertos trunk/access) y Capa 3 (subredes IP, gateways, enrutamiento).

### Hoja de cálculo de asignación de IP

Todas las direcciones IP, máscaras CIDR, gateways, servidores DNS e IDs de VLAN en un único documento de referencia.

## Decisiones de planificación

Hay varias decisiones que deben tomarse antes de la instalación porque no se pueden cambiar fácilmente después:

### Cifrado (no reversible)

VergeOS admite **cifrado AES-256 en reposo** para el vSAN. Esta decisión se toma durante la instalación y **no se puede cambiar después de la instalación** -- cambiar de cifrado a no cifrado (o viceversa) requiere una reinstalación completa.

Si habilita el cifrado:

* Prepare una frase de contraseña de clave de cifrado (8--64 caracteres)
* Prepare **una unidad USB para cada nodo controlador** (Nodos 1--2 en un sistema N+1; Nodos 1--3 en N+2) para almacenar la clave de cifrado (muy recomendable). Los demás nodos (scale-out) no requieren una unidad de clave. En su lugar, un operador puede introducir la frase de contraseña en el prompt de arranque del nodo controlador.
* Almacene la frase de contraseña de forma segura en su sistema de gestión de contraseñas

### Preferencia de reserva de RAM

Durante la planificación de la instalación, decida entre dos enfoques:

| Enfoque                    | Compensación                                                                                                          |
| -------------------------- | --------------------------------------------------------------------------------------------------------------------- |
| **Más memoria utilizable** | Asigne más RAM a las cargas de trabajo, aceptando una capacidad de conmutación por error HA ligeramente reducida      |
| **HA N+1 más estricta**    | Reserve más RAM para escenarios de conmutación por error, reduciendo la memoria disponible para las cargas de trabajo |

Esta configuración es configurable después de la instalación, pero debe planificarse con antelación para ajustarse a los requisitos de su SLA.

### Cronograma de instalación

* **Tiempo estimado:** 4--8 horas según el número de nodos y la complejidad de la configuración
* Programe una ventana de mantenimiento con las partes interesadas
* Asegúrese de que haya acceso IPMI/remoto y personal en sitio durante toda la ventana
* Tenga a mano la información de contacto del soporte de VergeOS

## Comprobaciones finales previas a la instalación (24 horas antes)

Dentro de las 24 horas previas a la instalación programada, realice estas verificaciones finales:

* [ ] Todo el hardware instalado físicamente, encendido y superando el burn-in
* [ ] Todos los cables de red conectados y superando una "prueba de tirón"
* [ ] Configuraciones de switches completadas, probadas y guardadas (`write mem`)
* [ ] IPMI accesible en todos los nodos
* [ ] Direcciones IP requeridas disponibles y sin conflictos con la infraestructura existente
* [ ] Jumbo frames (MTU 9216+) verificados en los puertos de switch de la malla principal
* [ ] Medio de arranque probado y listo
* [ ] Todas las unidades visibles en BIOS en cada nodo
* [ ] Todas las NIC visibles en BIOS en cada nodo
* [ ] Direcciones MAC confirmadas con la documentación
* [ ] Fecha/hora correctas en BIOS en todos los nodos
* [ ] Ajustes de virtualización habilitados en todos los nodos
* [ ] Sin servidores DHCP en conflicto en la red de gestión (si usa DHCP)

## Resumen

| Categoría             | Elementos clave                                                                                                |
| --------------------- | -------------------------------------------------------------------------------------------------------------- |
| **Hardware**          | CPU de 64 bits con VT-x/AMD-V, 16 GB+ de RAM, modo HBA o JBOD, IPMI configurado                                |
| **BIOS**              | UEFI (obligatorio para todo NVMe), virtualización habilitada, Secure Boot deshabilitado, relojes sincronizados |
| **Medio de arranque** | ISO del soporte de VergeOS, Rufus (modo DD) o BalenaEtcher, probado antes del día de la instalación            |
| **Red**               | Malla principal: VLAN dedicadas, MTU 9216, sin bonding. Externa: puertos trunk, bonding LACP opcional          |
| **Documentación**     | Mapa de cables, elevación del rack, diagramas de red, hoja de cálculo de asignación de IP                      |
| **Decisiones**        | Cifrado (sí/no, no reversible), preferencia de reserva de RAM, cronograma de instalación                       |

## Siguientes pasos

Con todos los requisitos previos verificados y la documentación en mano, está listo para continuar con la instalación del controlador: [**Instalación del controlador →**](/learn-the-platform/es/modulo-3-instalacion/02-controller-installation.md)


---

# 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/learn-the-platform/es/modulo-3-instalacion/01-pre-installation.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.