> 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/03-adding-nodes.md). # Agregar nodos ## Resumen Una vez que su clúster de controladores de dos nodos esté operativo, VergeOS admite tres métodos para expandir la capacidad: **nodos de escalado horizontal** (agregar tanto cómputo como almacenamiento a un clúster HCI existente), **nodos solo de almacenamiento** (expansión dedicada de almacenamiento), y **nodos solo de cómputo** (expansión dedicada de cómputo). Cada tipo de nodo sigue un flujo de instalación USB simplificado que autodetecta el sistema existente en la infraestructura central. Esta página cubre los requisitos previos, los pasos de instalación y los procedimientos de verificación para los tres tipos de nodos. ## Requisitos previos Antes de agregar cualquier nodo a su sistema VergeOS, asegúrese de que se cumplan las siguientes condiciones: | Requisito | Detalle | | -------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Clúster operativo de 2 nodos** | Los nodos de controlador primario y secundario de la [Guía de instalación](/learn-the-platform/es/modulo-3-instalacion/02-controller-installation.md) deben estar completamente instalados y en buen estado | | **Preparación de la red** | Las VLAN, las asignaciones físicas de NIC y el cableado de la infraestructura central deben coincidir con la configuración documentada durante la instalación inicial | | **Hardware coincidente** | Los nodos de escalado horizontal y solo de almacenamiento deben tener especificaciones de hardware idénticas (CPU, almacenamiento, NIC, RAM) a las de los nodos existentes en el clúster de destino | | **instalador USB** | Medios de instalación de VergeOS que coincidan con la versión que se ejecuta en su clúster existente | | **Clúster creado en la interfaz de usuario** | Si agrega un **nuevo tipo de clúster** (solo de almacenamiento o solo de cómputo) por primera vez, cree el clúster en la interfaz de usuario de VergeOS **antes de** iniciar el instalador | {% hint style="warning" %} **Cree clústeres antes de instalar nodos** Si este es el primer nodo solo de almacenamiento o solo de cómputo que agrega, usted **debe** crear primero el clúster correspondiente en la interfaz de usuario de VergeOS: 1. Vaya a **Sistema → Clústeres** 2. Haga clic en **Nuevo clúster** 3. Establezca el rol del clúster con los controles independientes de **Cómputo** y **Almacenamiento** interruptores — no se trata de una sola opción de sí o no. Habilite **Almacenamiento** solo (Cómputo desactivado) para un clúster solo de almacenamiento, o **Cómputo** solo (Almacenamiento desactivado) para un clúster solo de cómputo. (Un clúster HCI tiene *ambos* habilitados). 4. Guarde la configuración del clúster El instalador no puede agregar un nodo a un clúster que aún no existe. {% endhint %} ## Comparación de tipos de nodo Comprender las diferencias entre los tipos de nodo le ayuda a elegir la estrategia de expansión adecuada: ```mermaid flowchart TD A["¿Necesita expandir la capacidad?"] --> B{"¿Qué recurso\nes el cuello de botella?"} B -->|"Tanto cómputo\ncomo almacenamiento"| C["Nodo de escalado horizontal\n(expansión HCI)"] B -->|"Solo almacenamiento"| D["Nodo solo de almacenamiento\n(almacenamiento dedicado)"] B -->|"Solo cómputo"| E["Nodo solo de cómputo\n(cómputo dedicado)"] C --> F["Tipo de instalador: Scale-Out\nvSAN: Sí\nEjecuta VM: Sí"] D --> G["Tipo de instalador: Scale-Out\nvSAN: Sí\nEjecuta VM: No"] E --> H["Tipo de instalador: Solo cómputo\nvSAN: No\nEjecuta VM: Sí"] style C fill:#e3f2fd,stroke:#1565c0 style D fill:#e8f5e9,stroke:#2e7d32 style E fill:#fff3e0,stroke:#e65100 ``` | Característica | Escalado horizontal | Solo almacenamiento | Solo cómputo | | ---------------------------------------- | --------------------------------------------------- | --------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------- | | **Selección del instalador** | "Escalado horizontal" | "Escalado horizontal" | "Solo cómputo" | | **Participación en vSAN** | Sí — los discos se agregan a los niveles existentes | Sí — los discos se agregan a los niveles existentes | No — se instala sin configurar almacenamiento local (los nodos solo de cómputo arrancados por PXE no necesitan unidad de arranque local) | | **Ejecuta cargas de trabajo de VM** | Sí | No | Sí | | **Requiere creación previa del clúster** | No (se une al clúster HCI existente) | Sí (si es el primer nodo de almacenamiento) | Sí (si es el primer nodo de cómputo) | | **Caso de uso típico** | Crecimiento HCI equilibrado | Expansión de almacenamiento UCI | Expansión de cómputo para GPU/ML/VDI | ## Instalación de nodo de escalado horizontal Los nodos de escalado horizontal son la forma más sencilla de ampliar un clúster HCI. Agregan capacidad de cómputo y almacenamiento de forma proporcional, usando hardware idéntico al de los nodos controladores existentes. ### Pasos de instalación 1. **Arranque desde el instalador USB de VergeOS** * Inserte el instalador USB en el servidor designado como nodo de escalado horizontal * Reinicie y seleccione la unidad USB como dispositivo de arranque en el menú de arranque BIOS/UEFI 2. **Seleccione el tipo de nodo → "Escalado horizontal"** * Cuando el instalador muestre el menú de tipo de nodo, seleccione **Escalado horizontal** * Esto indica al instalador que se una a un clúster existente con roles de cómputo y almacenamiento 3. **Introduzca las credenciales de administrador** * Proporcione el nombre de usuario y la contraseña de administrador creados durante la instalación del controlador primario * Estas credenciales autentican el nuevo nodo frente al sistema existente 4. **Autodetección de red** * El instalador autodetecta la configuración de la infraestructura central escuchando paquetes UDP de los nodos existentes * Verifique que las NIC detectadas coincidan con su mapa de cableado documentado > **Consejo:** El instalador puede pedirle que identifique qué NIC se usa para la **Externa** red si no puede autodetectarla. Tenga lista la documentación de asignación de NIC a puerto. 5. **Selección del clúster** (si existen varios clústeres) * Si su sistema tiene más de un clúster, el instalador le pide que seleccione a cuál clúster debe unirse este nodo * Seleccione el nodo del clúster de destino al que este nuevo nodo más se parezca en hardware 6. **Configuración de discos vSAN** * El instalador muestra los discos detectados y sus asignaciones de nivel propuestas * Confirme que los niveles de almacenamiento coincidan con la configuración del clúster existente — **la uniformidad es fundamental** * Revise y finalice las selecciones de disco 7. **Completar instalación** * El instalador formatea las unidades, instala VergeOS e integra el nodo en el clúster * El nodo se reinicia automáticamente cuando finaliza la instalación * Retire el medio del instalador USB cuando se le indique 8. **Verifique en la interfaz de usuario** * Inicie sesión en la interfaz web de VergeOS * Vaya a **Infraestructura → Nodos** y confirme que el nuevo nodo aparezca con un estado operativo * Compruebe **Sistema → vSAN** para verificar que los nuevos discos estén integrados y que los niveles estén en buen estado {% hint style="info" %} Después de que el nodo se una, vSAN redistribuirá los datos para incluir los nuevos discos. El estado de los niveles puede mostrarse **amarillo** durante la fase de reconstrucción — esto es normal. Espere a que todos los niveles vuelvan a **verde** antes de agregar otro nodo o realizar mantenimiento. {% endhint %} ## Instalación de nodo solo de almacenamiento Los nodos solo de almacenamiento amplían la capacidad de vSAN sin agregar recursos de cómputo. Se usan en arquitecturas UCI (Unified Compute Infrastructure) donde el almacenamiento y el cómputo escalan de forma independiente. ### Antes de la instalación: crear clúster de almacenamiento Si este es su **primer** nodo solo de almacenamiento, cree el clúster de almacenamiento en la interfaz de usuario: 1. Vaya a **Sistema → Clústeres** 2. Haga clic en **Nuevo clúster** 3. Active el **Almacenamiento** interruptor y deje **Cómputo** desactivado 4. Guarde la configuración ### Pasos de instalación La instalación del nodo solo de almacenamiento usa la **misma opción del instalador "Scale-Out"** que un nodo de escalado horizontal normal. La diferencia clave es que el nodo se une a un clúster solo de almacenamiento en lugar de un clúster HCI. 1. **Arranque desde el instalador USB** — igual que en el escalado horizontal 2. **Seleccione el tipo de nodo → "Escalado horizontal"** — el instalador usa "Scale-Out" tanto para nodos HCI como para nodos solo de almacenamiento 3. **Introduzca las credenciales de administrador** — autentíquese frente al sistema existente 4. **Autodetección de red** — verifique las asignaciones de NIC 5. **Selección del clúster** — seleccione el **clúster de almacenamiento** que creó en la interfaz de usuario; seleccione el nodo al que este nuevo nodo más se parezca 6. **Configuración de discos vSAN** — confirme que las asignaciones de niveles coincidan con la configuración prevista del clúster de almacenamiento 7. **Completar instalación** — las unidades se formatean, VergeOS se instala y el nodo se reinicia 8. **Verifique en la interfaz de usuario** — confirme que el nodo aparezca bajo el clúster de almacenamiento correcto en la página Nodos {% hint style="success" %} Debido a que los nodos solo de almacenamiento usan la opción del instalador "Scale-Out", el factor diferenciador es el **clúster que seleccione** durante el paso 5. El tipo de clúster (solo de almacenamiento) determina el rol del nodo en el sistema. {% endhint %} ## Instalación de nodo solo de cómputo Los nodos solo de cómputo proporcionan recursos adicionales de CPU, RAM y, opcionalmente, GPU sin participar en el almacenamiento vSAN. Son ideales para cargas de trabajo que necesitan gran capacidad de procesamiento — aprendizaje automático, renderizado, VDI o análisis de datos. ### Antes de la instalación: crear clúster de cómputo Si este es su **primer** nodo solo de cómputo, cree el clúster de cómputo en la interfaz de usuario: 1. Vaya a **Sistema → Clústeres** 2. Haga clic en **Nuevo clúster** 3. Active el **Cómputo** interruptor y deje **Almacenamiento** desactivado 4. Guarde la configuración ### Pasos de instalación 1. **Arranque desde el instalador USB** — igual que en otros tipos de nodo 2. **Seleccione el tipo de nodo → "Solo cómputo"** — esta es una opción distinta del instalador, diferente de "Scale-Out" 3. **Introduzca las credenciales de administrador** — autentíquese frente al sistema existente 4. **Autodetección de red** — verifique las asignaciones de NIC 5. **Selección del clúster** (opcional) — si se le solicita, seleccione el **clúster de cómputo** y el nodo al que este nuevo nodo más se parezca 6. **Completar instalación** — el instalador configura los ajustes de red y **instala sin configurar almacenamiento local**. Los nodos solo de cómputo también pueden arrancarse por PXE, en cuyo caso no se requiere una unidad de arranque local. El nodo se reinicia automáticamente. 7. **Verifique en la interfaz de usuario** — confirme que el nodo aparezca bajo el clúster de cómputo correcto en la página Nodos {% hint style="info" %} Los nodos solo de cómputo tienen **ningún paso de configuración de discos vSAN**. Acceden al almacenamiento a través de la infraestructura central desde nodos en clústeres HCI o solo de almacenamiento. Esta es la diferencia clave frente a las instalaciones de escalado horizontal y solo de almacenamiento. {% endhint %} ## Mejores prácticas para el orden de instalación Al implementar un sistema de múltiples clústeres (arquitectura UCI), siga este orden recomendado: ```mermaid flowchart LR A["1. Nodos de controlador\n(Clúster 1)"] --> B["2. Nodos de almacenamiento\n(Clúster 2)"] B --> C["3. Nodos de cómputo\n(Clúster 3)"] style A fill:#e3f2fd,stroke:#1565c0 style B fill:#e8f5e9,stroke:#2e7d32 style C fill:#fff3e0,stroke:#e65100 ``` 1. **Instale primero los nodos de controlador** — forman el clúster base con almacenamiento de metadatos de nivel 0 2. **Agregue los nodos de almacenamiento en segundo lugar** — garantiza que la capacidad de almacenamiento vSAN esté disponible antes de que los nodos de cómputo la necesiten 3. **Agregue los nodos de cómputo al final** — pueden acceder inmediatamente al almacenamiento a través de la infraestructura central Dentro de cualquier clúster, **agregue los nodos secuencialmente** — espere a que cada nodo complete la instalación y aparezca en buen estado en la interfaz de usuario antes de iniciar el siguiente. Esto evita que se superpongan las operaciones de redistribución/reconstrucción de vSAN a medida que se incorpora cada nuevo nodo. ## Solución de problemas Si surgen problemas durante la instalación de cualquier nodo: | Acción | Comando | Descripción | | ------------------------ | ---------------------- | ---------------------------------------------------- | | **Cancelar instalador** | Presione `Esc` | Abre una consola de comandos | | **Reanudar instalación** | `yb-install` | Continúa donde lo dejó el instalador | | **Reiniciar desde cero** | `yb-install --restart` | Restablece y reinicia todo el proceso de instalación | ### Problemas comunes **El nodo no aparece en la interfaz de usuario después del reinicio:** * Verifique la conectividad de red — asegúrese de que las NIC de la infraestructura central estén correctamente cableadas * Compruebe que la versión del instalador USB coincida con la versión de VergeOS que se ejecuta en los controladores * Revise los registros de instalación del nodo a través de la consola **El nivel vSAN permanece amarillo durante un tiempo prolongado:** * Esto es normal durante la redistribución de datos — supervise el progreso en **Sistema → vSAN** * Asegúrese de que haya suficiente ancho de banda entre los nodos en la infraestructura central * Póngase en contacto con el soporte de VergeOS si la reconstrucción se detiene más allá de los plazos previstos **El instalador no puede autodetectar la red:** * Verifique que los puertos del switch de la infraestructura central estén configurados correctamente (tramas jumbo, STP deshabilitado) * Compruebe que el cableado físico coincida con la asignación documentada de NIC a puerto * Pruebe la configuración manual de red si la autodetección falla repetidamente **"No hay clústeres disponibles" durante la selección del clúster:** * Asegúrese de haber creado el clúster de destino (Almacenamiento o Cómputo) en la interfaz de usuario antes de iniciar el instalador * Verifique que el tipo de clúster coincida con el tipo de nodo del instalador ## Lista de verificación de validación Después de agregar cualquier nodo, confirme lo siguiente: * [ ] El nodo aparece en la **Infraestructura → Nodos** página con un estado operativo * [ ] El nodo muestra la asignación de clúster correcta * [ ] Para nodos de escalado horizontal/almacenamiento: **Sistema → vSAN** muestra todos los discos nuevos con las asignaciones de nivel correctas * [ ] Para nodos de escalado horizontal/almacenamiento: los niveles vSAN vuelven a **verde** estado (en buen estado) una vez finalizada la reconstrucción * [ ] Conectividad de la infraestructura central confirmada: **Diagnóstico del nodo → Configuración de la infraestructura** informa `confirmado: true` para todas las rutas * [ ] No hay eventos de error en el registro del sistema relacionados con el nuevo nodo {% hint style="info" %} **Puente con VMware** ¿Viene de VMware? VergeOS usa un único instalador USB que autodetecta la infraestructura central y se autentica con credenciales de administrador — los roles de controlador, escalado horizontal, solo almacenamiento y solo cómputo son todas selecciones de menú, sin ningún paso de preconfiguración por host del lado de VergeOS. {% endhint %} {% hint style="info" %} **Puente con Nutanix** ¿Viene de Nutanix? VergeOS no tiene CVM — el servicio de almacenamiento es un demonio integrado del SO — y los roles de escalado horizontal, solo almacenamiento y solo cómputo son roles de nodo de primera clase, seleccionados mediante la opción del instalador y el clúster de destino; un único instalador USB cubre los tres. {% endhint %} ## Puntos clave | Concepto | Resumen | | ------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------- | | **Tres tipos de nodo** | Escalado horizontal (HCI), solo almacenamiento y solo cómputo — cada uno con un rol específico | | **Instalador único** | Un único medio instalador USB maneja todos los tipos de nodo mediante selección de menú | | **Autodetección** | Los nodos detectan automáticamente el sistema en la infraestructura central | | **Creación previa del clúster** | Los clústeres de almacenamiento y cómputo deben crearse en la interfaz de usuario antes de agregar el primer nodo de ese tipo | | **Instalación secuencial** | Agregue los nodos de uno en uno dentro de un clúster para evitar que se superpongan la redistribución/reconstrucción de vSAN | | **Almacenamiento antes que cómputo** | En implementaciones UCI, agregue los nodos de almacenamiento antes que los nodos de cómputo | | **Reconstrucción de vSAN** | Después de agregar nodos que aportan almacenamiento, espere a que los niveles de vSAN vuelvan a verde antes de continuar | ## Siguientes pasos Con los nodos agregados y verificados, continúe con la verificación posterior a la instalación para confirmar el estado general del sistema: [**Verificación posterior a la instalación →**](/learn-the-platform/es/modulo-3-instalacion/04-post-install-verification.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/03-adding-nodes.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.