Qué es vStack OS
vStack OS es el sistema operativo del nodo de la plataforma hiperconvergente vStack HCP. Es una compilación propia de FreeBSD: el sistema base, el kernel y un conjunto de controladores que convierten un servidor común en un nodo del clúster. En cada nodo funcionan simultáneamente las máquinas virtuales, el almacenamiento y la red; el clúster no tiene sistemas de almacenamiento ni controladores de red independientes.
El clúster se gestiona con vStack Center. Se ejecuta en la VM de gestión de ese mismo clúster y tiene su propia documentación: vStack Center. Aquí se describe lo que está por debajo: los propios nodos, su instalación, su actualización y las utilidades con las que el administrador trabaja en el nodo.
De qué se compone un nodo
| Capa | Qué hace | Cómo lo ve el administrador |
|---|---|---|
| Hipervisor bhyve | Ejecuta las máquinas virtuales. El proceso de cada VM lo gestiona el controlador vstack-vm | Las VM de un pool se ejecutan en el nodo que tiene ese pool |
| Almacenamiento en ZFS | Cada pool se construye como raidz a partir de un disco de cada nodo. El nodo conecta sus propios discos localmente y recibe los de los demás por iSCSI. Si una VM no se ejecuta en el nodo propietario de su pool, sus discos llegan por NVMe-oF/TCP | Los pools se llaman z01, z02, etc. Un pool sobrevive a la pérdida de tantos nodos como indique el nivel de redundancia N+1…N+3 |
| Red definida por software | Redes de las VM, redes aisladas sobre VXLAN, puntos de acceso al exterior | Físicamente son dos agregados LACP, lagg10 y lagg20, con VLAN encima |
| Cluster Manager | Framework de clúster: supervisa los nodos, decide qué nodo tiene cada pool y conmuta los pools cuando falla un nodo. En el nodo es el demonio ccrd | Cada pool está representado por el servicio zpool_<pool>, por ejemplo zpool_z01. El estado del clúster lo muestra la CLI del nodo |
En vStack Center este componente se llama igual, Cluster Manager, por lo que el término no cambia entre ambas documentaciones.
Quién gestiona qué
vStack Center no actúa directamente sobre los nodos. Cuando el administrador habilita un nodo, lo deshabilita o conmuta un pool, Center envía el comando a Cluster Manager, y este lo lleva a los nodos. De ello se derivan dos consecuencias.
Primera. El clúster no se detiene junto con Center. Si la VM de gestión está caída, las VM en ejecución siguen funcionando y Cluster Manager sigue conmutando los pools cuando falla un nodo. Se pierden la interfaz web y la API, y también el responsable de arrancar las VM del pool conmutado: el arranque de las máquinas tras la conmutación lo realiza Center.
Segunda. La propia VM de gestión reside en uno de los pools del clúster, normalmente en
z01, y en la lista de VM del pool tiene el número 0. El pool con la VM de gestión no se puede
conmutar desde la interfaz de Center: Center se apagaría a sí mismo en mitad de la operación.
Ese pool se conmuta desde el nodo, con la utilidad del clúster. Cómo hacerlo se describe en
la sección sobre la actualización del nodo.
También hay funciones fuera de esta división. La instalación del nodo y el ensamblaje inicial
del clúster los realiza el instalador de vStack OS; en ese momento Center todavía no existe.
Se despliega por sí solo en el primer arranque de los nodos. La actualización del sistema operativo del nodo también
se realiza en el propio nodo, con el script estándar vStack.update.sh.
Versiones
La versión actual es la 3.2.0 (25.09.2026), con base FreeBSD 14.2. Versiones anteriores de la línea 3.x: 3.1.0 (09.09.2026) y 3.0.11 (31.08.2026). Los nodos de la línea 2.x funcionan sobre FreeBSD 13.2 y migran a 3.x mediante un procedimiento aparte, junto con el soporte técnico de vStack.
Mapa de la documentación
| Sección | Contenido |
|---|---|
| Requisitos de hardware y red | Procesadores, controladoras de disco y tarjetas de red, distribución de los discos de almacenamiento, conmutación y VLAN |
| Instalación del nodo y ensamblaje del clúster | Instalación desde el medio, diálogos del instalador, primer arranque del clúster |
| Actualización a 3.2 | Actualización de los nodos uno a uno con el script estándar, comprobaciones y reversión |
| Copia de seguridad de la configuración del nodo | Copia de la configuración del nodo antes de una actualización o reinstalación |
| CLI del nodo | Utilidad del clúster y vStack.update.sh: comandos, opciones, códigos de salida |
Las máquinas virtuales, los VDC, las redes, los usuarios y los roles se configuran en vStack Center. Esto se describe en su documentación.