> 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/02-controller-installation.md). # Instalación del controlador Instalar los dos nodos controladores es el núcleo de cada implementación de VergeOS. El Nodo 1 inicia un sistema completamente nuevo: define el nombre del sistema, la cuenta de administrador, la red, la licencia, el cifrado y los niveles de almacenamiento. El Nodo 2 se une al sistema existente y replica esos ajustes, proporcionándole un clúster redundante de inmediato. Esta página recorre ambas instalaciones en detalle. ## Resumen del flujo de instalación ```mermaid graph LR A["Arrancar el Nodo 1
desde USB"] --> B["Instalación estándar →
Controlador → Nuevo"] B --> C["Configuración del
sistema y la red"] C --> D["Licencia y
cifrado"] D --> E["Selección de discos
& asignación de niveles"] E --> F["Reiniciar y
verificar el Nodo 1"] F --> G["Arrancar el Nodo 2
desde USB"] G --> H["Instalación estándar →
Controlador → Unirse"] H --> I["Detección automática
de redes"] I --> J["Coincidir cifrado
& niveles"] J --> K["Reiniciar y
verificar el clúster"] style F fill:#e8f5e9,stroke:#2e7d32 style K fill:#e8f5e9,stroke:#2e7d32 ``` *** ## Nodo 1: Instalación del controlador principal El Nodo 1 crea el sistema VergeOS. Cada decisión de configuración que tome aquí establece la base que seguirán el Nodo 2 y todos los nodos posteriores. {% hint style="warning" %} **Operación destructiva** VergeOS se instala como un sistema operativo completo en cada nodo. Las unidades seleccionadas se formatean y **se perderán todos los datos existentes en esas unidades**. Verifique dos veces las unidades seleccionadas antes de confirmar. {% endhint %} ### Paso 1: Arranque y tipo de instalación 1. **Arrancar desde USB** -- Inserte el medio de instalación de VergeOS y arranque el servidor. El instalador completo se carga en memoria; el tiempo de carga varía según la velocidad del medio. 2. **Seleccione "Instalar (estándar)"** -- Esta es la opción predeterminada. Las opciones no estándar solo deben usarse cuando se trabaje directamente con el Soporte de VergeOS. 3. **Seleccione "Controlador"** -- Los dos primeros nodos de cualquier sistema deben ser nodos controladores. 4. **Seleccione "Sí"** para confirmar que se trata de una **Instalación nueva** (nuevo vSAN). ### Paso 2: Hora e identidad 5. **Zona horaria** -- Seleccione la zona horaria del sistema (la ubicación geográfica de los servidores). 6. **Configuración de NTP** -- Introduzca una lista de servidores NTP separada por espacios (por ejemplo, `pool.ntp.org time.google.com`), o acepte los valores predeterminados. 7. **Fecha y hora** -- Confirme cuidadosamente la fecha y la hora actuales. El Nodo 1 controla NTP para todo el sistema después de la instalación, por lo que la precisión aquí es crítica. > **La hora importa:** Una fecha u hora incorrecta puede causar problemas operativos en vSAN. Verifique ambas cuidadosamente, especialmente la fecha, que es fácil pasar por alto. 8. **Nombre del sistema** -- Introduzca un nombre descriptivo para su sistema VergeOS (por ejemplo, "Clúster HCI de producción"). Este nombre aparece en el panel, las alertas, los informes y las configuraciones de sincronización entre sitios. Puede cambiarse después de la instalación en Configuración del sistema. ### Paso 3: Cuenta de administrador 9. **Nombre de usuario del administrador** -- Acepte el valor predeterminado (`admin`) o introduzca un nombre de usuario personalizado. 10. **Contraseña** -- Introduzca una contraseña segura (mínimo 8 caracteres). Guárdela inmediatamente en su repositorio de contraseñas. 11. **Dirección de correo electrónico** -- Introduzca el correo del administrador. Se usa para restablecer contraseñas y recibir alertas de suscripción. Se requiere una dirección de correo electrónico durante la instalación. ### Paso 4: Configuración de la interfaz de red Aquí es donde su documentación previa a la instalación de las NIC resulta útil. Configurará todas las NIC detectadas en el nodo. #### Interfaces de red principales 12. **Seleccione la NIC Core1** -- Elija la NIC física conectada a su switch Core Fabric 1. 13. **Configure los ajustes de Core1:** * **Nombre** -- Un nombre descriptivo (por ejemplo, el nombre de host del switch o su convención de nomenclatura) * **MTU** -- El valor predeterminado en la NIC es 9192; la MTU del puerto físico del switch debe ser al menos 9216 para acomodar la MTU de la NIC más la sobrecarga de VXLAN * **Core** -- Déjelo configurado en **"Sí"** * **VLAN** -- Introduzca el ID de VLAN de Core1, o deje en blanco/0 para puertos PVID (sin etiquetar) 14. **Seleccione la NIC Core2** -- Elija la NIC física conectada a su switch Core Fabric 2. 15. **Configure los ajustes de Core2** -- El mismo patrón que Core1, pero usando el ID de VLAN de Core2. {% hint style="success" %} **Navegación con teclado** En el instalador, `[Tab]` se mueve entre elementos de acción (Finalizar/Editar/Cancelar), no entre campos. Presione `[Enter]` para alternar el modo de edición en un campo. Cuando el modo de edición está DESACTIVADO, use las flechas para moverse entre los campos. {% endhint %} #### Interfaz de red externa 16. **Seleccione la(s) NIC(s) externa(s)** -- Elija la(s) NIC(s) conectada(s) a su switch externo/de administración. Aquí se admite el enlace de puertos (LACP) para redundancia. 17. **Configure los ajustes externos:** * **Nombre** -- Nombre descriptivo de la red externa * **MTU** -- Normalmente 1500 (Ethernet estándar) * **Core** -- Cambiar a **"No"** * **VLAN** -- Introduzca el ID de VLAN de administración si corresponde (se prefiere PVID) * **Dirección IP** -- Dirección estática en formato CIDR (por ejemplo, `10.0.0.2/24`), o introduzca `dhcp` para DHCP (adecuado para sistemas de prueba/evaluación o solo de almacenamiento) * **Puerta de enlace** -- Dirección IP de la puerta de enlace predeterminada * **DNS** -- Direcciones de los servidores DNS 18. **Configure las NIC restantes** -- Cualquier NIC no utilizada o desconectada debe recibir igualmente un nombre (por ejemplo, "sin uso") durante la instalación. Seleccione **\[Done]** cuando todas las NIC estén configuradas. {% hint style="info" %} El enlace de puertos (LAG/LACP) debería **no** usarse para las redes Core Fabric. VergeOS construye la redundancia mediante varias redes centrales separadas en switches separados. El enlace es apropiado solo para las interfaces de red externas. {% endhint %} ### Paso 5: Configuración de licencias 19. **Seleccione el servidor de licencias** -- Elija entre servidor de Producción o de Prueba/NFR. 20. **Introduzca las credenciales** -- Proporcione el nombre de usuario y la contraseña de licencia de su equipo de cuenta de VergeOS. Guárdelos de forma segura. ### Paso 6: Configuración de almacenamiento #### Cifrado de vSAN 21. **Activar o desactivar el cifrado** -- VergeOS admite cifrado AES-256 en reposo para el vSAN. * Si lo activa, introduzca una frase de contraseña de la clave de cifrado (8--64 caracteres) * Opcionalmente, escriba la clave de cifrado en una **unidad USB** (muy recomendado para producción) * Verifique que el dispositivo USB correcto esté seleccionado antes de confirmar {% hint style="warning" %} **El cifrado es permanente** La selección de cifrado **no es reversible** después de la instalación. Cambiar de cifrado a no cifrado (o viceversa) requiere una reinstalación completa del sistema. Tome esta decisión con cuidado. {% endhint %} #### Selección de discos y asignación de niveles 22. **Seleccione las unidades vSAN** -- Todas las unidades detectadas se muestran y están seleccionadas de forma predeterminada (marcadas con un asterisco). Desmarque las unidades que deban excluirse: * Dispositivos extraíbles (unidades USB) * Unidades dedicadas a almacenar una clave de cifrado * Cualquier unidad no destinada a usarse con vSAN 23. **Asignar niveles de almacenamiento** -- El instalador detecta automáticamente un nivel para cada unidad. Seleccione **"Sí"** para revisar y, opcionalmente, cambiar las asignaciones de nivel: * **Nivel 0** -- Almacenamiento de metadatos (NVMe, se recomienda alta resistencia a escrituras; planifique \~5 GB mínimo / 10 GB recomendados por cada 1 TB utilizable de vSAN) * **Nivel 1** -- Cargas de trabajo de alto rendimiento y muchas escrituras (NVMe de alta resistencia) * **Nivel 2** -- Cargas de trabajo mixtas, VMs de uso general (SSD de gama media) * **Nivel 3** -- HDD o híbrido de alta velocidad (convencional; no obligatorio) * **Nivel 4** -- HDD estándar / capacidad (convencional; no obligatorio) * **Nivel 5** -- Archivo / almacenamiento en frío (HDD de archivo) Selecciona **\[Done]** cuando las asignaciones de nivel sean correctas. {% hint style="info" %} **El nivel 0 es solo para metadatos** El nivel 0 almacena el mapa hash de vSAN y el índice del sistema de archivos. No es una caché de rendimiento y no almacena datos de cargas de trabajo. Se recomiendan unidades NVMe con alta resistencia a escrituras (3+ DWPD). {% endhint %} #### Configuración de swap 24. **Seleccione el nivel de swap** -- Elija qué nivel de almacenamiento usar para el espacio de swap. Evite las unidades de nivel 0 cuando sea posible; seleccione el siguiente nivel más rápido. Nunca seleccione unidades HDD para swap salvo que el nodo solo contenga HDD. 25. **Introduzca el swap por unidad** -- Especifique el swap en MB por unidad (por ejemplo, `2048` en 8 unidades = 16 GB en total). En general, no debería configurarse más de **16 GB de swap por nodo** . 26. **Confirme** el resumen de swap y seleccione **"Sí"**. ### Paso 7: Finalización y reinicio 27. El instalador formatea cada unidad seleccionada (las unidades grandes pueden tardar varios minutos) e inicializa el vSAN. 28. Cuando finalice la instalación, **retire el medio USB** y presione **\[Enter]** para reiniciar. ### Verificación del Nodo 1 Después de reiniciar, verifique que el controlador principal esté en buen estado antes de continuar con el Nodo 2: | Compruebe | Resultado esperado | | ------------------------- | ---------------------------------------------------------------------------------------------------------- | | **Pantalla de consola** | Aparece el menú de usuario azul de VergeOS | | **Acceso a la interfaz** | Navegue hasta la dirección IP configurada en un navegador; inicie sesión con credenciales de administrador | | **Indicadores de estado** | Todos los indicadores en verde en el panel principal | | **Salud de vSAN** | vSAN montado y en buen estado (mostrado en el panel) | {% hint style="success" %} Si el nodo no arranca correctamente, presione `Esc` en la consola para obtener un símbolo del sistema. Escriba `yb-install` para reanudar o `yb-install --restart` para volver a iniciar la instalación desde el principio. {% endhint %} *** ## Nodo 2: Instalación del controlador secundario El Nodo 2 se une al sistema creado por el Nodo 1. El instalador detectará automáticamente la mayoría de la configuración de red, haciendo este proceso más rápido que en el Nodo 1. {% hint style="info" %} El controlador principal (Nodo 1) debe estar **completamente instalado y arrancado** antes de iniciar la instalación del Nodo 2. No comience con el Nodo 2 hasta haber verificado que el Nodo 1 está en buen estado. {% endhint %} ### Pasos de instalación 1. **Arrancar desde USB** -- Inserte el medio de instalación de VergeOS en el segundo servidor y arranque. 2. **Seleccione "Instalación estándar"** (predeterminado). 3. **Seleccione "Controlador"** (predeterminado). 4. **Seleccione "No"** -- Esto NO es una instalación nueva. Está uniéndose al sistema ya creado en el Nodo 1. > **Precaución:** Si selecciona "Sí" aquí, el instalador creará un **sistema independiente y separado** en lugar de unirse al clúster del Nodo 1. Este es el error de instalación más común del Nodo 2. 5. **Introduzca las credenciales de administrador** -- Proporcione el nombre de usuario y la contraseña de administrador creados durante la instalación del Nodo 1. 6. **Detección automática de red** -- Seleccione **"Sí"** para detectar automáticamente la configuración de red. El instalador descubrirá ambas redes centrales desde el Nodo 1. Este es el enfoque recomendado, ya que evita una mala configuración manual de la red. 7. **Verificar las redes detectadas** -- Para cada red central detectada, revise la configuración mostrada y presione **\[Enter]** para confirmar. 8. **Configurar el cifrado** -- Los ajustes de cifrado **deben coincidir** con los del Nodo 1. Si el Nodo 1 usa cifrado, el Nodo 2 también debe usar cifrado con la misma frase de contraseña. 9. **Seleccione las unidades vSAN y asigne niveles** -- La selección de unidades y niveles debe coincidir con el patrón establecido en el Nodo 1 (las mismas asignaciones de nivel para tipos de unidad equivalentes). 10. **Configurar swap** -- Haga coincidir la configuración de swap con la del Nodo 1. 11. Cuando el instalador termine, **retire el medio USB** y presione **\[Enter]** para reiniciar. ### Verificación del Nodo 2 | Compruebe | Resultado esperado | | ----------------------------------- | ----------------------------------------------------------------------------------------- | | **Pantalla de consola** | Aparece el menú de usuario azul de VergeOS | | **Inicio de sesión en la interfaz** | Acceda a la misma dirección IP utilizada para el Nodo 1; ambos nodos visibles en el panel | | **Estado del nodo** | Ambos nodos muestran un estado saludable (verde) en el panel de Nodos | | **Redundancia de vSAN** | vSAN muestra estado redundante (N+1) con ambos nodos aportando almacenamiento | ```mermaid graph TB subgraph cluster["Clúster de controladores (N+1 redundante)"] N1["Nodo 1 — Controlador principal
vSAN + Cómputo"] N2["Nodo 2 — Controlador secundario
vSAN + Cómputo"] end subgraph fabric["Red troncal"] C1["Core 1"] C2["Core 2"] end N1 --- C1 N1 --- C2 N2 --- C1 N2 --- C2 EXT["Red externa
(interfaz de administración)"] --- N1 EXT --- N2 style cluster fill:#e8f5e9,stroke:#2e7d32 style fabric fill:#f0f4ff,stroke:#336 ``` *** ## Redundancia N+2 (tercer controlador opcional) Dos nodos controladores proporcionan la **redundancia N+1** predeterminada: dos copias de cada bloque de datos. Para entornos que requieran mayor resiliencia, VergeOS también admite **redundancia N+2** con tres nodos controladores, manteniendo tres copias de cada bloque de datos. Para configurar N+2: 1. Instale un tercer nodo controlador siguiendo el mismo proceso del Nodo 2 (unirse al sistema existente). 2. Durante la instalación del tercer controlador, el instalador advierte que el sistema cambiará a redundancia N+2 (3 copias de los datos, \~33% de almacenamiento utilizable) y requiere que escriba `N+2` para confirmar. 3. Después de instalar los tres nodos controladores, **reinicie los tres nodos** para activar la redundancia N+2. 4. La incorporación de un tercer nodo controlador para lograr redundancia N+2 debe realizarse en coordinación con el Soporte de VergeOS. {% hint style="warning" %} Cambiar entre N+1 y N+2 en un sistema existente requiere un proceso completo de reequilibrio de datos que puede implicar **un tiempo de inactividad significativo** , especialmente en sistemas con grandes volúmenes de datos. Este cambio solo debe realizarse en coordinación con el Soporte de VergeOS. {% endhint %} *** ## Resumen de decisiones de instalación ### Decisiones irreversibles **Cifrado** (Sí/No) no puede cambiarse después de la instalación sin una reinstalación completa. Decida antes de comenzar. ### Modificable después de la instalación El nombre del sistema, las credenciales de administrador, el correo electrónico, la configuración de swap y los nombres de red pueden modificarse en la interfaz después de la instalación. ### Debe coincidir entre nodos Los ajustes de cifrado y los patrones de asignación de niveles deben ser coherentes entre el Nodo 1 y el Nodo 2 (y todos los nodos controladores posteriores). ### Solución de problemas Presione `Esc` para obtener un símbolo del sistema. Use `yb-install` para reanudar o `yb-install --restart` para reiniciar la instalación. *** ## Referencia rápida: navegación del instalador | Paso | Selección del Nodo 1 | Selección del Nodo 2 | | ------------------------ | --------------------------- | --------------------------------------- | | Tipo de instalación | Instalación estándar | Instalación estándar | | Rol | Controlador | Controlador | | ¿Instalación nueva? | **Sí** (nuevo vSAN) | **No** (unirse al existente) | | Zona horaria / NTP | Configurar manualmente | No se solicita (se hereda del Nodo 1) | | Nombre del sistema | Introducir nombre | No se solicita (se hereda del Nodo 1) | | Cuenta de administrador | Crear nueva | Introducir credenciales existentes | | Configuración de red | Manual por NIC | Se recomienda detección automática | | Licencia | Introduzca las credenciales | No se solicita (se hereda del Nodo 1) | | Cifrado | Elegir Sí/No | Debe coincidir con el Nodo 1 | | Selección de disco/nivel | Selección completa | Debe coincidir con el patrón del Nodo 1 | | Swap | Configurar | Configurar (coincidir con el Nodo 1) | ## Siguientes pasos Con ambos nodos controladores instalados y verificados, puede continuar para añadir capacidad adicional: * [**Añadir nodos →**](/learn-the-platform/es/modulo-3-instalacion/03-adding-nodes.md) -- Instalación de nodos de expansión, solo cómputo y solo almacenamiento * [**Verificación posterior a la instalación →**](/learn-the-platform/es/modulo-3-instalacion/04-post-install-verification.md) -- Comprobaciones de salud completas del sistema y tareas de configuración --- # 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/02-controller-installation.md?ask=&goal= ``` `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.