Verificar o hardware e a rede do cluster
Os requisitos dos nós, as configurações de cluster recomendadas e os requisitos de switching e de segmentos de rede pertencem ao vStack OS e estão descritos na documentação dele: Requisitos de hardware e rede.
O vStack Center mostra o hardware que o cluster realmente enxerga: o inventário de hardware e os dados dos discos vêm dos nós, e o status dos agregados de portas vem do subsistema de rede. Após a instalação, use esses dados para verificar se os nós foram montados conforme o planejado.
Onde procurar
Após a instalação, você pode comparar a configuração especificada com o que o cluster realmente enxerga. O inventário de hardware vem dos nós e está disponível tanto na interface web quanto pela API.
Na interface web, as contagens de núcleos e memória por nó ficam em Server Nodes (nós), em uma tabela com as colunas ID, Name, Health, CPU (Cores) e RAM (GB). Os discos e módulos de memória de um nó específico ficam na página dele, em Hardware e Disk props. Os pools da camada de armazenamento ficam em Storage Resources, na tabela ZFS pools com as colunas GUID, Name, Health, Consuming, Scrubbing, Resilvering, Current node e Capacity (RAW).
pd-list
Lista os discos físicos do cluster. Mostra o modelo, o tamanho e a associação a pools. Use-o para verificar se os pools contêm apenas unidades SSD ou NVMe com a capacidade necessária.
Acesso: somente Cluster master. O feature flag feature.physical_disc_management
deve estar ativado.
{
"jsonrpc": "2.0",
"method": "pd-list",
"params": {
"auth": { "cookie": "..." }
},
"id": "1"
}
A resposta é um mapa indexado pelo número de série do disco:
{
"jsonrpc": "2.0",
"id": "1",
"result": {
"code": 1,
"data": {
"S3Y1NX0M900XXX": {
"node_id": 1,
"device": "da0",
"model": "INTEL SSDSC2KB480G8",
"size": 480103981056,
"vdev_pool_name": "tank",
"pool_name": "tank",
"status": 0,
"lifecycle": 2,
"online_in_cluster": true
}
}
}
}
Esperado: cada disco da camada de armazenamento tem online_in_cluster definido como
true, e size é pelo menos a capacidade necessária. O campo lifecycle mostra a
função do disco: 0 — livre, 1 — particionado, 2 — em um pool, 3 — spare,
-1 — erro. Até que o nó informe a função, o campo fica vazio (null).
Erros: -403 — falta o privilégio necessário; -24201 — Physical disc management
não está ativado.
node-hw-list
Inventário de hardware do nó a partir dos dados SMBIOS: fabricante, contagem de núcleos e módulos de memória. Use-o para comparar o modelo do processador e a capacidade de memória com os requisitos.
Acesso: somente Cluster master. O feature flag feature.hardware_inventory deve estar
ativado.
{
"jsonrpc": "2.0",
"method": "node-hw-list",
"params": {
"auth": { "cookie": "..." }
},
"id": "1"
}
A resposta é um mapa de node_id → dispositivo → propriedade:
{
"jsonrpc": "2.0",
"id": "1",
"result": {
"code": 1,
"data": {
"1": {
"0": {
"dev_id": 1,
"dev_name": "Processor",
"dev_serial": 0,
"3": { "prop_id": 3, "prop_name": "Manufacturer", "prop_value": "Intel" },
"4": { "prop_id": 4, "prop_name": "Core Count", "prop_value": 8 }
}
}
}
}
}
Erros: -403 — o método está disponível apenas para Cluster master; -26001 —
Hardware inventory não está ativado.
portgroup-list
Grupos de portas (agregados) do nó: protocolo de agregação, portas membros e seus sinalizadores. O método mostra se o LACP foi estabelecido com ambos os switches.
Acesso: somente Cluster master. O feature flag feature.network_ports_management
deve estar ativado.
{
"jsonrpc": "2.0",
"method": "portgroup-list",
"params": {
"auth": { "cookie": "..." },
"node_id": 1
},
"id": "1"
}
Resposta para o nó 1 com dois agregados:
{
"jsonrpc": "2.0",
"id": "1",
"result": {
"code": 1,
"data": {
"1": {
"lagg10": {
"portgroup_name": "lagg10",
"portgroup_status": 1,
"portgroup_proto": "lacp",
"ports": {
"ix0": { "port_name": "ix0", "port_flag_active": 1, "port_status": 1 },
"ix1": { "port_name": "ix1", "port_flag_active": 0, "port_status": 0 }
}
}
}
}
}
}
Esperado: portgroup_proto é lacp, e port_flag_active e port_status são 1 para
todas as portas do agregado. No exemplo acima, a porta ix1 está inativa: o link com
o segundo switch não está ativo.
Erros: -403 — o método está disponível apenas para Cluster master; -25001 —
Network ports management não está ativado.
Veja também
- Requisitos de hardware e rede — documentação do vStack OS.
- Verificar a implantação do vStack Center — o que verificar imediatamente após a montagem do cluster.
- Configuração inicial do cluster — verificações de aceitação da composição do cluster e configurações básicas após a instalação.