O que é o vStack OS

O vStack OS é o sistema operacional dos nós da plataforma hiperconvergente vStack HCP. Trata-se de um build personalizado do FreeBSD: o sistema base, o kernel e um conjunto de controladores que transformam um servidor comum em um nó de cluster. Cada nó executa máquinas virtuais, armazenamento e rede ao mesmo tempo; o cluster não tem storage arrays nem controladores de rede separados.

O cluster é gerenciado pelo vStack Center. Ele é executado em uma VM de gerenciamento no mesmo cluster e tem sua própria documentação: vStack Center. Esta documentação trata da camada abaixo dele: os próprios nós, sua instalação, atualização e os utilitários que um administrador usa em um nó.

Do que um nó é composto

Camada	O que faz	O que o administrador vê
Hipervisor bhyve	Executa máquinas virtuais. O processo de cada VM é gerenciado pelo controlador vstack-vm	As VMs de um pool são executadas no nó que detém esse pool
Armazenamento ZFS	Cada pool é construído como um raidz a partir de um disco em cada nó. Um nó conecta seus próprios discos localmente e recebe os discos dos outros nós por iSCSI. Se uma VM é executada em um nó diferente do dono do seu pool, seus discos são entregues por NVMe-oF/TCP	Os pools se chamam z01, z02 e assim por diante. Um pool sobrevive à perda de tantos nós quanto o nível de redundância N+1…N+3 permitir
Rede definida por software	Redes de VMs, redes isoladas sobre VXLAN, pontos de acesso externos	Fisicamente, são dois agregados LACP, lagg10 e lagg20, com VLANs por cima
Cluster Manager	O framework do cluster: monitora os nós, decide qual nó detém qual pool e move pools quando um nó falha. Em um nó, é o daemon ccrd	Cada pool é representado por um serviço zpool_<pool>, por exemplo zpool_z01. O estado do cluster é exibido pela CLI do nó

No vStack Center esse componente tem o mesmo nome, Cluster Manager, então o termo não muda entre os dois conjuntos de documentação.

Quem gerencia o quê

O vStack Center não age diretamente sobre os nós. Quando um administrador habilita um nó, o desabilita ou move um pool, o Center passa o comando ao Cluster Manager, que o executa nos nós. Isso tem duas consequências.

Primeiro, o cluster não para quando o Center para. Se a VM de gerenciamento estiver fora do ar, as VMs em execução continuam em execução, e o Cluster Manager ainda move pools quando um nó falha. O que você perde é a interface web e a API e, junto com elas, o que inicia as VMs de um pool movido: a inicialização das máquinas após um failover de pool é feita pelo Center.

Segundo, a própria VM de gerenciamento fica em um dos pools do cluster, geralmente z01, e tem o número 0 na lista de VMs desse pool. Não é possível mover o pool com a VM de gerenciamento pela interface do Center: o Center se desligaria no meio da operação. Esse pool é movido a partir de um nó, com o utilitário do cluster. Como fazer isso está descrito na seção sobre atualização do nó.

Algumas funções ficam fora dessa divisão. A instalação dos nós e a montagem inicial do cluster são feitas pelo instalador do vStack OS; nesse momento o Center ainda não existe. Ele se implanta sozinho quando os nós inicializam pela primeira vez. A atualização do SO do nó também é realizada no próprio nó, com o script padrão vStack.update.sh.

Versões

A versão atual é a 3.2.0 (25.09.2026), baseada no FreeBSD 14.2. Releases anteriores da linha 3.x: 3.1.0 (09.09.2026) e 3.0.11 (31.08.2026). Os nós da linha 2.x são executados no FreeBSD 13.2 e passam para a 3.x por um procedimento separado, junto com o suporte técnico da vStack.

Mapa da documentação

Seção	O que contém
Requisitos de hardware e rede	Processadores, controladoras de disco e adaptadores de rede, layout dos discos de armazenamento, comutação e VLANs
Instalação do nó e montagem do cluster	Instalação a partir da mídia, diálogos do instalador, primeira inicialização do cluster
Atualização para a 3.2	Atualização dos nós um de cada vez com o script padrão, verificações e reversão
Backup da configuração do nó	Uma cópia da configuração do nó antes de uma atualização ou reinstalação
CLI do nó	O utilitário do cluster e o vStack.update.sh: comandos, opções, códigos de saída

Máquinas virtuais, VDCs, redes, usuários e papéis são configurados no vStack Center. Isso está descrito na documentação dele.