> 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/sop-verge-install.md).

# Guía de instalación de VergeOS

Esta guía proporciona procedimientos estandarizados y mejores prácticas para los Ingenieros y Administradores de VergeOS que realizan una instalación inicial del sistema usando la interfaz actualizada del instalador.

{% hint style="info" %}
**Resumen**

La instalación de su sistema VergeOS requiere una planificación y ejecución cuidadosas para garantizar una implementación exitosa. Esta guía divide el proceso en fases principales:

1. **Preparación** - Pasos a seguir antes de programar la instalación
2. **Preinstalación** - Verificaciones finales dentro de las 24 horas previas a la instalación
3. **Instalación** - El proceso de instalación y configuración del sistema
4. **Posinstalación** - Verificación de que la instalación fue exitosa
   {% endhint %}

{% hint style="info" %}
**Requisitos específicos del entorno**

Esta guía cubre las mejores prácticas generales. Es posible que deba adaptar estos pasos a su entorno y requisitos específicos. Deje espacio para acomodar la cantidad de nodos, configuraciones de red y otras necesidades.
{% endhint %}

## Requisitos previos

* Acceso físico a los nodos de hardware para la instalación
* Infraestructura de red configurada y lista
* Acceso IPMI/administración remota a todos los nodos
* Credenciales de licencia de VergeOS
* **Tiempo estimado:** 4-8 horas según la complejidad de la configuración

## Objetivo

Completar la instalación inicial de Node1 y Node2+, el mínimo requerido para la redundancia del sistema y el soporte del sistema en producción.

## Fase de preparación

Complete estos pasos antes de programar la instalación:

### Requisitos de hardware

* [ ] Confirme que el hardware cumple los requisitos mínimos

{% hint style="info" %}
**Documentación de hardware**

Consulte la [documentación de dimensionamiento de VergeOS](/plan-and-deploy/es/guia-de-implementacion/sizing.md) para conocer los requisitos actuales y detallados.

\[ ] **Requisitos de CPU:**

* [ ] CPU de 64 bits con compatibilidad de virtualización por hardware \[ ] **Requisitos de memoria:**
* [ ] 16 GB de RAM por nodo vSAN disponibles para el SO
* [ ] +1 GB de RAM por cada 1 TB de almacenamiento bruto vSAN; por ejemplo, 16 GB+4 GB = 20 GB de RAM/nodo para un nodo con 4 TB de almacenamiento bruto vSAN \[ ] **IPMI/Administración remota:**
* [ ] IPMI; iDRAC, iLO o similar \[ ] **Controladora de disco:**
* [ ] Controladora de disco HBA (preferida)
* [ ] si es una controladora RAID: asegúrese de que admita modo JBOD/IT
* [ ] Asegúrese de que la controladora admita arranque desde NVMe si los utiliza \[ ] **Requisitos de red:**
* [ ] 1 interfaz de red física/nodo para la interfaz de VergeOS UI/'Externa'
* [ ] Segundo par enlazado del mismo tipo *Muy* recomendado para redundancia
* [ ] 1 interfaz de red de 10 Gbps o superior/nodo para la Core Fabric de VergeOS
* [ ] Segundo del mismo tipo *Muy* Recomendado para redundancia (no enlazado) \[ ] **Requisitos de almacenamiento:**
* [ ] Almacenamiento Tier0 (opcional, recomendado)
  * [ ] Basado en NVMe
  * [ ] Alta resistencia de escritura (se recomiendan 3+ escrituras de unidad por día, DWPD)
  * [ ] 5 GB/1 TB de disco utilizable en vSAN (se recomiendan 10 GB/1 TB)
* [ ] Niveles de almacenamiento (1 requerido, > opcional)
  * [ ] Mínimo 1 nivel de almacenamiento NVMe conectado por PCIe *Muy recomendado*
  * [ ] Rendimiento acorde con la carga de trabajo esperada
* [ ] Cifrado de disco en reposo
  * [ ] Disco USB /nodo para la clave de descifrado de vSAN (si se desea)
    {% endhint %}

### Medios de instalación y documentación

* [ ] Cree el medio de instalación según la [documentación de VergeOS](/plan-and-deploy/es/guia-de-implementacion/install-media.md)
  * [ ] Pruebe el medio de arranque para verificar su funcionalidad
* [ ] Documente y cree todos los requisitos de red

{% hint style="info" %}
**Documentación de red**

Consulte la [documentación de diseño de red de VergeOS](/plan-and-deploy/es/guia-de-implementacion/network-design.md) para conocer los requisitos actuales y detallados de red.

\[ ] **Configuración de la red principal:**

* [ ] VLAN1 de la red principal creada y documentada
* [ ] VLAN2 de la red principal creada y documentada \[ ] **Configuración de la red externa:**
* [ ] VLAN1 de la red externa creada y documentada
* [ ] VLAN2 de la red externa creada y documentada \[ ] **Configuración de IP:**
* [ ] Dirección IP de UI/administración asignada y documentada
* [ ] Configuración de puerta de enlace documentada
* [ ] Servidores DNS identificados y documentados \[ ] **Documentación de diseño/implementación de red**
* [ ] Mapa de cableado A-B creado y documentado
* [ ] Elevación del rack documentada
* [ ] Documento/dibujo de diseño de red de capa 2 creado
* [ ] Documento/dibujo de diseño de red de capa 3 creado
  {% endhint %}

### Acceso y configuración del sistema

* [ ] Verifique el acceso IPMI a todos los nodos
* [ ] Revise los requisitos de configuración de BIOS
  * [ ] Método de arranque correcto seleccionado (Legacy/Dual/UEFI) ***UEFI requerido si todas las unidades son NVMe***
  * [ ] Virtualización asistida por hardware habilitada
  * [ ] Hyperthreading habilitado
  * [ ] Todos los núcleos del procesador habilitados
  * [ ] Relojes configurados correctamente (todos los nodos dentro de segundos)

### Decisiones de planificación

* [ ] Revise todo el procedimiento descrito aquí
* [ ] Prepare la información necesaria para completar todo el proceso
* [ ] Decida la preferencia de reserva de RAM: Más *Memoria utilizable* **O** Más *aplicación de la HA N+1*
* [ ] Planifique el cronograma de instalación y la comunicación a las partes interesadas

## Fase de preinstalación

Realice estas comprobaciones dentro de las 24 horas previas a la instalación programada:

### Verificación del estado actual

* [ ] Verificar el estado actual
  * [ ] Todo el hardware instalado físicamente y encendido
  * [ ] Todos los cables de red superan una "prueba de tirón"
  * [ ] Configuraciones del switch completadas y probadas
  * [ ] Configuración de red en ejecución actual revisada y completada una "write mem"
  * [ ] IPMI accesible en todos los nodos
  * [ ] Las IP requeridas están disponibles y libres
  * [ ] Tramas jumbo (MTU 9216+) configuradas en los switches

### Comprobación final del hardware

* [ ] Todas las unidades visibles en BIOS
* [ ] Todas las NIC visibles en BIOS
* [ ] Confirmar MACs frente a los registros
* [ ] Hora y fecha correctas en BIOS
* [ ] Configuración de virtualización habilitada

### Comprobación final de red

* [ ] Switches de la red principal respondiendo
* [ ] Switches de la red externa respondiendo
* [ ] No hay servidores DHCP en conflicto (si se usa DHCP)
* [ ] Documentación disponible para resolución de problemas

## Fase de ejecución

### Instalación del controlador primario

El proceso real de instalación siguiendo el orden del instalador:

* [ ] Arranque desde el instalador USB
* [ ] Seleccione "Standard Install"
* [ ] Seleccione "Controller"
* [ ] Seleccione "New Install"

### Configuración del sistema

**Configuración de NTP:**

* [ ] Introduzca una lista de servidores NTP separados por espacios, o deje el valor predeterminado

**Configuración de fecha/hora:**

* [ ] Confirme cuidadosamente la fecha actual
* [ ] Confirme con mucho cuidado la hora actual (Node 1 controla NTP para el sistema)

**Identificación del sistema:**

* [ ] Introduzca el nombre de su sistema. (Se puede cambiar después de la instalación)

### Configuración de la cuenta de administrador

* [ ] Introduzca el nombre de usuario del administrador, o deje el valor predeterminado
* [ ] Introduzca la contraseña de su cuenta de administrador (debe generarse y almacenarse en su repositorio de contraseñas)
* [ ] Establezca la dirección de correo electrónico de la cuenta de administrador (opcional, pero recomendable)

### Configuración de la interfaz de red

**Interfaces de la red principal:**

* [ ] Seleccione la interfaz de red Core1
* [ ] Configure el nombre de la interfaz Core1, MTU, Core (deje "Yes") y VLAN según sea necesario
* [ ] Seleccione la interfaz de red Core2
* [ ] Configure el nombre de la interfaz Core2, MTU, Core (deje "Yes") y VLAN según sea necesario

**Interfaz de red externa:**

* [ ] Seleccione la interfaz de red externa
* [ ] Configure el nombre de la red externa, MTU (generalmente 1500), Core (cámbielo a "No").
* [ ] Configure la VLAN externa (si es necesario)
* [ ] Establezca la IP externa (formato CIDR)
* [ ] Establezca la puerta de enlace externa
* [ ] Establezca los servidores DNS externos

### Configuración de licencia

* [ ] Seleccione el servidor de licencias (producción o prueba/NFR)
* [ ] Introduzca las credenciales del usuario de licencia
* [ ] Introduzca la contraseña de licencia (guárdela de forma segura en el repositorio de contraseñas)

### Configuración de almacenamiento

**Cifrado vSAN:**

* [ ] Elija la configuración de cifrado vSAN (Sí/No)
* [ ] Documente la clave de cifrado, si está habilitada (guárdela de forma segura en el repositorio de contraseñas)
* [ ] Cree un disco USB de cifrado (muy recomendado si usa cifrado vSAN)

**Selección de discos vSAN y asignación de niveles:**

* [ ] Seleccione los discos vSAN para la instalación
* [ ] Asigne los discos a los niveles de almacenamiento apropiados (según lo planificado durante la preparación de la instalación)

**Configuración de intercambio:**

* [ ] Configure la asignación de swap según sea necesario
* [ ] Después de que el instalador haya terminado, retire el medio USB
* [ ] Reiniciar

### Verificación del nodo primario

* [ ] El sistema arranca en una pantalla 'azul' en la consola
* [ ] La UI es accesible en la dirección IP configurada
* [ ] Todos los indicadores de estado en verde en la UI
* [ ] vSAN montado y saludable

## Instalación del controlador secundario

* [ ] Arranque del nodo secundario desde el instalador USB
* [ ] Seleccione "Controller"
* [ ] Seleccione "No" para una nueva instalación
* [ ] Introduzca las credenciales de administrador del controlador primario
* [ ] Confirme la autodetección de red (¡DETÉNGASE si alguna IP o interfaz detectada no es la esperada!)
* [ ] Coincida la configuración de cifrado con la del primario
* [ ] Coincida la asignación de niveles de unidades con la del primario

### Verificación del nodo secundario

* [ ] El sistema arranca en una pantalla 'azul' en la consola
* [ ] Node2 visible en la UI primaria
* [ ] Todos los indicadores de estado en verde
* [ ] Estado de vSAN en verde en ambos nodos

## Verificación posinstalación

Una vez completada la instalación, verifique que el sistema esté funcionando correctamente:

### Comprobaciones de estado del sistema

* [ ] Todos los indicadores del panel en verde
* [ ] Sin alertas o advertencias inesperadas en los registros del panel
* [ ] Todos los nodos muestran la versión correcta
* [ ] Todos los nodos en estado "Running" (revise cada nodo individualmente)
* [ ] No hay reinicios de nodos pendientes
* [ ] Estado de salud de vSAN en verde en todos los niveles
* [ ] Conectividad de la red principal verificada
* [ ] Conectividad de la red externa verificada

### Validación de la configuración del sistema

* [ ] Nivel de almacenamiento VM predeterminado establecido
* [ ] Porcentaje máximo de RAM objetivo del clúster configurado
* [ ] Sincronizaciones de sitio configuradas (si es necesario)
* [ ] Sistema activado y actualizado
* [ ] Configuración del servidor SMTP (muy recomendada)
* [ ] Notificaciones por correo electrónico del usuario administrador configuradas

### Pruebas finales

* [ ] Pruebe la creación de VMs y las operaciones básicas
* [ ] Verifique la conectividad de red desde la VM de prueba
* [ ] Confirme la funcionalidad de instantáneas
* [ ] Pruebe la copia de seguridad/restauración del sistema si corresponde

## Solución de problemas

### Problemas comunes

**Problemas de arranque:**

* Verifique que la configuración de arranque del BIOS coincida con el tipo de medio de instalación
* Compruebe la funcionalidad del medio USB en un sistema que se sepa que funciona correctamente
* Confirme la compatibilidad del hardware con VergeOS

**Problemas de configuración de red:**

* Verifique que las configuraciones de VLAN coincidan con el diseño de red
* Compruebe las conexiones físicas de los cables y las configuraciones de los switches
* Confirme que la asignación de IP no entre en conflicto con la infraestructura existente

**Problemas de configuración de almacenamiento:**

* Verifique que la controladora de disco esté en modo JBOD/IT
* Compruebe la visibilidad de los discos en BIOS
* Confirme que las asignaciones de niveles de almacenamiento coincidan con la documentación de planificación

**Problemas al unirse el nodo secundario:**

* Verifique la conectividad de red entre nodos
* Compruebe que las credenciales de administrador sean correctas
* Confirme que el nodo primario esté totalmente operativo antes de añadir el secundario

## Próximos pasos

Después de completar correctamente la instalación:

* [ ] Programe la copia de seguridad inicial del sistema
* [ ] Configure la supervisión y las alertas
* [ ] Actualice la documentación de red con la configuración final
* [ ] Planifique la creación de inquilinos y la asignación de recursos
* [ ] Programe la capacitación de administradores si es necesario
* [ ] Documente la configuración final del sistema para el equipo de operaciones

{% hint style="danger" %}
**Soporte de emergencia**

Si tiene algún problema con su instalación de VergeOS, póngase en contacto con [nuestro equipo de soporte](/overview/es/support-and-services.md) para asistencia inmediata.
{% 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/sop-verge-install.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.
