Colocação de um novo nó em serviço

Os clusters crescem com a adição de nós. A instalação do hardware, a instalação do sistema no nó e a admissão do nó no cluster acontecem fora do vStack Center, por meio do processo de instalação e do Cluster Manager. O vStack Center entra no procedimento depois, quando o nó já está visível para o cluster, mas ainda não executa cargas de trabalho, não foi inventariado e não disponibilizou seus discos.

As responsabilidades são estritamente divididas. O Cluster Manager mantém a composição do cluster e os status dos nós; o vStack Center exibe essa visão e encaminha comandos a ele. O agente do nó informa o hardware, as versões dos pacotes e as configurações do sistema. Esses dados são armazenados no banco de dados do vStack Center e exibidos no cartão do nó.

Por isso, todo o trabalho com um nó acontece em duas etapas. A coleta do inventário e das versões de software é um comando para o agente do nó, e o próprio comando não informa o resultado. O resultado aparece na tela mais tarde, quando o nó responde. Use a coluna Last_seen para verificar se os dados estão atualizados: ela mostra quando o nó se reportou pela última vez.

Os discos de um novo nó passam por duas etapas independentes, e confundi-las pode sair caro. Colocar um disco online o torna visível para todos os nós do cluster. Isso não o torna membro de um pool ZFS: o pool é montado no nó, e o vStack Center não oferece essa operação.

Etapa da colocação do nó em serviço	Executada por	Onde é executada
Instalação do hardware, instalação do sistema, admissão no cluster	Processo de instalação e Cluster Manager	Fora do vStack Center — consulte a documentação do vStack OS
Habilitação do nó para aceitar cargas de trabalho	Cluster Manager, por comando do vStack Center	Indisponível na interface web — use a API
Coleta do hardware e das versões de software	Agente do nó	Cartão do nó: seção Hardware, botão Software
Alinhamento das configurações do sistema	Agente do nó	Cartão do nó: botão Configure
Colocação dos discos online no cluster	Agente do nó	Indisponível na interface web — use a API
Montagem de um pool ZFS a partir dos discos do nó	Nó	Indisponível no vStack Center
Inicialização do serviço do pool no nó	Cluster Manager	Cartão do pool: Actions → Start pool
Verificação da capacidade do cluster	vStack Center	Telas Overview, Server Nodes, Storage Resources

Pré-requisitos

• O papel Cluster master (role_id=1), necessário para todas as operações deste procedimento, inclusive a coleta de dados do host;
• A flag feature.hardware_inventory: sem ela, o inventário coletado e a utilização dos núcleos não são exibidos;
• A flag feature.physical_disc_management: sem ela, as operações com discos físicos ficam indisponíveis, incluindo listar discos, acender indicadores, colocar um disco online no cluster e marcar um disco como spare;
• A flag feature.node_config_management: sem ela, as configurações do nó e a coleta das versões de software ficam indisponíveis;
• O nó já foi admitido no cluster e está visível na tabela Server Nodes;
• Uma lista dos números de série dos discos do novo nó: os discos são verificados pelo número de série;
• vStack Center versão 3.0.5.

As flags habilitadas estão listadas nas opções do cluster. Verifique-as lá.

Etapa 1. Certifique-se de que o nó está visível para o cluster

Comece lendo o estado atual. Até que o nó apareça na visão do Cluster Manager, qualquer comando para colocá-lo em serviço não terá destino.

1. Abra Provider Data Center → Server Nodes. O novo nó aparece como uma nova linha na tabela com as colunas ID, Name, Health, CPU (Cores) e RAM (GB), e como uma aba separada ao lado das conhecidas node01…node05.
2. Anote o ID do nó: você precisará dele mais tarde, tanto para os comandos quanto para a verificação.
3. Verifique Health. Um nó tem duas avaliações de status independentes: o que o administrador permite e o que realmente está acontecendo. Esse par é explicado em "Cluster, nós e serviços".

O Cluster Manager fornece o conteúdo da tabela. Se a tabela estiver vazia e a tela informar um erro ao obter os status, os dados de composição do cluster estão indisponíveis. Verifique a disponibilidade do Cluster Manager e não inicie a colocação do nó em serviço.

Etapa 2. Habilite o nó para aceitar cargas de trabalho

Colocar um nó em serviço concede uma permissão administrativa; isso não inicia o nó. O vStack Center encaminha o comando de habilitação ao Cluster Manager e, depois disso, o nó começa a aceitar cargas de trabalho.

A habilitação e a desabilitação de um nó não estão disponíveis na interface web. Um administrador executa a operação pela API — consulte a referência da API. Verifique o resultado na tabela Server Nodes: um nó habilitado deixa de ser marcado como proibido de operar, e a coluna Health mostra seu estado real.

Um comando aceito significa que o Cluster Manager o recebeu, e não que o nó já mudou de estado. Health mostra a mudança real e é atualizada quando o nó responde. O identificador do nó é um número: o cluster rejeita um valor com caracteres estranhos com o código -20122 antes de enviar o comando.

Etapa 3. Colete o inventário de hardware

Você precisa do inventário imediatamente para conferir o hardware entregue com a lista de remessa e localizar os discos no gabinete. Isso funciona em duas etapas: coleta e, depois, leitura.

1. Inicie um inventário do novo nó. A coleta pode ter como alvo um único nó ou o cluster inteiro e pode ser limitada a uma classe de dispositivos. Ao colocar um nó em serviço, uma varredura completa é adequada: não selecione uma classe e deixe o agente coletar tudo.

   Classe de dispositivos	Dados coletados
   ifnet	Interfaces de rede
   ses	Gabinetes de discos
   cam	Subsistema de discos
   nvme	Dispositivos NVMe
   smbios	Dados SMBIOS
   Nenhuma classe selecionada	Inventário completo

2. Abra o cartão do nó e expanda a seção Hardware. A aba Inner view mostra o hardware do nó na tabela Manufacturer / Description / Product / Serial number / Version. As abas aninhadas Node data, CPU e RAM alternam entre as visualizações.

3. Verifique o hardware da CPU na aba Utilization: ela mostra a utilização dos núcleos por domínio NUMA, com dados de no máximo dez minutos atrás. A aba Portgroup mostra as informações de rede nas colunas Name, Hash, Last_seen, MAC, Proto e Status.

4. Verifique a localização dos discos na seção Disks, na aba Placement. As colunas Enclosure_device, Enclosure_id, Dev_index e Device fornecem as informações que você usará depois para localizar um disco no gabinete.

Uma aba Utilization vazia em um nó recém-habilitado é normal: o agente ainda não se reportou. Abra o cartão novamente mais tarde.

Etapa 4. Alinhe as versões de software com o restante do cluster

Diferenças de versão entre os nós frequentemente causam comportamento inesperado do cluster. Um novo nó chega com a versão da sua imagem, e essa versão quase sempre precisa ser verificada.

1. Clique em Software. O botão está disponível tanto na lista de nós quanto no cartão do nó. A tabela Name / Version / Last_seen é aberta, mostrando a versão de cada pacote e o momento em que ela foi detectada pela última vez. As versões dos pacotes do nó e as versões do cluster são exibidas separadamente.
2. Verifique Last_seen. Um valor antigo significa que o nó não se reporta há algum tempo, e a versão exibida pode ser diferente da versão instalada. Nesse caso, inicie a coleta das versões de software e abra a tabela novamente.
3. Compare o novo nó com qualquer nó já em serviço. Se as versões dos pacotes obrigatórios forem diferentes, interrompa a colocação do nó em serviço e atualize-o.

Alguns pacotes são opcionais: vStack-vm-prio, vStack-storage-san e vStack-zpool podem não constar da tabela. A ausência deles em um novo nó não indica uma falha na coleta e não é motivo para reverter a colocação do nó em serviço.

Etapa 5. Aplique a configuração do nó

As configurações do sistema são agrupadas, e cada uma tem uma classe: um perfil dentro do qual o valor se aplica. O novo nó recebe os mesmos valores já configurados nos nós em serviço; portanto, leia primeiro a configuração de referência e depois aplique-a.

1. Abra o cartão de um nó em serviço e clique em Configure. As configurações são exibidas em grupos, com seus valores atuais e os momentos da última detecção. Anote os valores que devem coincidir no novo nó.
2. Antes de editar um valor, verifique se a configuração é numérica ou uma string: isso determina o que o formulário aceita.
3. Abra Configure no cartão do novo nó, insira os valores e selecione a classe em que eles devem se aplicar. Direcione a alteração a um único nó: não é necessário enviá-la ao cluster inteiro ao colocar um nó em serviço.
4. Confirme a alteração. O comando é encaminhado ao agente do nó, portanto o resultado não fica visível imediatamente. Abra as configurações novamente: o valor da configuração alterada e o momento da detecção serão atualizados.

O próprio vStack Center verifica o intervalo das configurações numéricas: um valor abaixo do mínimo é rejeitado com o código -23124, e um valor acima do máximo, com o código -23125. Esses valores não são enviados aos nós. Uma configuração desconhecida é rejeitada com o código -23121, e uma configuração sem a classe solicitada, com o código -23123.

Etapa 6. Coloque os discos do nó online no cluster

Os discos do novo nó são inicialmente "brutos": o nó os vê, mas o cluster não. Colocar um disco online o torna visível para todos os nós. A operação é destrutiva e não idempotente: colocar online novamente um disco que já está online é rejeitado com o código -24706.

Colocar um disco online no cluster, marcá-lo como spare e removê-lo do cluster não estão disponíveis na interface web. Um administrador executa essas operações pela API — consulte a referência da API. O tamanho do bloco e o número de série com que o disco aparecerá no cluster também são especificados lá.

1. Verifique o que o nó detectou. Abra a seção Disks do cartão do nó. As abas mostram visões diferentes da mesma lista: Disk props — ID, Model, Size (GB), Status; ZFS props — Pool name, Vdev_pool_name, Vdev_guid, Vdev_pool_guid; Placement — localização no gabinete; LED on panel — Led_fault e Led_locate.
2. Distinga três atributos independentes: Status, a integridade do disco; o papel do disco (livre, particionado, membro de pool, spare); e a flag "online no cluster". Nenhum deles pode ser deduzido de outro. Somente a API mostra a flag de colocação do disco online no cluster.
3. Coloque online os discos necessários e leia a lista novamente. O papel do disco não muda: colocá-lo online no cluster não afeta seu papel.
4. Considere marcar alguns discos como spare imediatamente para que uma substituição de emergência possa encontrar um disco substituto. Marcar um disco como spare grava um rótulo de serviço no disco; por isso, o nó recusa essa operação em um disco com dados ativos, a menos que a operação seja forçada.

cuidado

Colocar um disco online no cluster não o adiciona a um pool ZFS. Um pool é montado a partir de discos online no nó; o vStack Center não oferece essa operação. Até que exista um pool, os discos do nó não acrescentarão um único byte de capacidade ao cluster.

Você pode acender os indicadores de um disco no gabinete diretamente pela interface: as abas Front view e Inner view da seção Disks oferecem botões de indicador de localização e de falha para cada disco. O resultado fica visível na aba LED on panel.

Etapa 7. Inicie o serviço do pool no novo nó

Um pool é executado em um nó como um serviço do cluster. Até que o serviço seja habilitado e iniciado, o pool não fornece capacidade, mesmo que os discos estejam online e o pool tenha sido montado.

1. Abra Provider Data Center → Storage Resources. A tabela ZFS pools mostra os pools do cluster com as colunas GUID, Name, Health, Consuming, Scrubbing, Resilvering, Current node e Capacity (RAW). Current node indica qual nó hospeda o pool no momento.
2. Abra o pool a partir da tabela e, no menu Actions, selecione Start pool.
3. Volte para Storage Resources e certifique-se de que o pool é exibido como em execução e que Current node aponta para o novo nó.

Um serviço tem dois atributos independentes: a permissão, ou seja, se ele pode operar, e o estado, ou seja, se ele está em execução agora. Um serviço desabilitado não será iniciado, não importa quantas vezes você tente iniciá-lo. A habilitação e a desabilitação de um serviço não estão disponíveis na interface web; um administrador executa essas operações pela API. A sequência de operações e as falhas comuns são explicadas em "Gerenciamento dos serviços do cluster".

Um comando aceito confirma que o Cluster Manager o recebeu, e não que o serviço realmente foi iniciado. O nome de um serviço de pool é composto de letras, dígitos e sublinhados, por exemplo zpool_ssd01; o cluster não aceita hífens, pontos nem espaços.

Etapa 8. Verifique a capacidade do cluster

A etapa final responde se o nó está realmente em serviço ou apenas habilitado. Os recursos do nó devem aparecer tanto na visão por nó quanto nos totais do cluster.

1. Abra Provider Data Center → Overview. A tela agrega a capacidade, o provisionamento e o consumo real de CPU, memória e armazenamento. Os totais devem aumentar com os recursos do novo nó.
2. Vá para a aba Resources: a tabela mostra os nós com as colunas Node name, Node health e Consuming. O novo nó deve aparecer na lista.
3. Verifique a visão por nó em Server Nodes usando as colunas CPU (Cores) e RAM (GB), e os pools do nó em Storage Resources.

Valores vazios em CPU (Cores) e RAM (GB) em um nó recém-habilitado significam que as métricas dele ainda não estão disponíveis. Os valores provisionados continuam corretos. Os pools do nó também estarão ausentes até que o pool seja montado e seu serviço iniciado.

Conclusão do trabalho

1. Apague todos os indicadores que você acendeu durante a instalação: cartão do nó → seção Disks → abas Front view ou Inner view. Verifique o resultado na aba LED on panel, nas colunas Led_fault e Led_locate.
2. Execute o inventário novamente após as últimas alterações físicas, usando as classes ses e cam.
3. Registre a configuração de referência: abra Configure e Software do novo nó. Esse é o estado com o qual você comparará o nó na próxima vez.
4. Se você estiver revertendo a colocação do nó em serviço, revogue a permissão dele para aceitar cargas de trabalho e remova seus discos do cluster. As duas operações usam a API. Um disco que pertence a um pool ativo não pode ser removido dessa forma: o pool ficaria degradado, e o nó recusará a operação.

Verificação do resultado

O que verificar	Onde ver	Resultado esperado
O nó é membro do cluster	Server Nodes	Uma nova linha com o ID e o Name do nó
O nó está habilitado e em execução	Server Nodes, coluna Health	O nó não está marcado como proibido de operar e é exibido como em execução
O hardware foi inventariado	Cartão do nó, seção Hardware	A aba Inner view está preenchida, e Last_seen é recente
As versões coincidem com as do cluster	Botão Software	A versão do kernel e os pacotes obrigatórios coincidem com os de um nó em serviço
A configuração foi aplicada	Cartão do nó, Configure	Os valores coincidem com a configuração de referência, e os momentos de detecção são recentes
Os discos estão visíveis para o cluster	Cartão do nó, seção Disks	Os discos necessários aparecem na lista; a API mostra a flag "online no cluster"
O serviço do pool está em execução	Storage Resources	O pool aparece na tabela ZFS pools, Current node é o novo nó, e Health = ONLINE
A capacidade foi contabilizada	Overview	Os totais de CPU, memória e armazenamento aumentaram

Se algo der errado

O que você vê	Causa	O que fazer
O nó não aparece na tabela Server Nodes	O Cluster Manager ainda não admitiu o nó no cluster	Não inicie a colocação do nó em serviço no vStack Center; volte à etapa de instalação
A tabela de nós está vazia, código de erro -2	A comunicação com o Cluster Manager falhou	Verifique a disponibilidade do Cluster Manager: os dados de composição do cluster estão indisponíveis
Código de erro -713 em comandos de nó e de serviço	Não foi possível encaminhar o comando ao Cluster Manager	O mesmo que acima; o comando não chegou aos nós
Código de erro -20122	A validação do identificador do nó falhou	Especifique o identificador do nó como um número, sem caracteres estranhos
Código de erro -20512, -20522	A validação do nome do serviço ou do identificador do nó falhou	Use o nome do serviço da coluna Name da tabela ZFS pools e o nó de Server Nodes
Código de erro -403 "Access denied"	A operação está disponível apenas para o papel Cluster master	Entre com um papel de nível de cluster
Código de erro -26001, -26101	A flag feature.hardware_inventory está desabilitada	Habilite a flag nas opções do cluster
Código de erro -23110 ou -23301	A flag feature.node_config_management está desabilitada	Faça o mesmo para o gerenciamento de configuração
Código de erro -24201	A flag feature.physical_disc_management está desabilitada	Faça o mesmo para o gerenciamento de discos físicos
Código de erro -200	O mapa de status do cluster está indisponível, e não há nós dos quais coletar dados	Aguarde até que os nós voltem ao estado ONLINE e tente novamente
Código de erro -23203	Foi selecionada uma classe de dispositivos inválida	Selecione uma classe da tabela da etapa 3
Código de erro -23124 ou -23125	O valor da configuração numérica está abaixo do mínimo ou acima do máximo	Defina o valor dentro dos limites da configuração
Código de erro -24702, -24704	A validação do formato do caminho do dispositivo ou do número de série do disco falhou	Confira o caminho e o número de série com a seção Disks
Código de erro -24703	Tamanho de bloco inválido	Especifique 512 ou 4096
Código de erro -24706	O disco já está online no cluster	Não é necessário repetir; verifique a flag de colocação do disco online no cluster
Código de erro -24707	O número de série solicitado já é usado por outro disco no nó	Escolha outro valor ou omita-o para que o nó atribua um
Código de erro -24504	Uma operação destrutiva já está em andamento no disco	Aguarde a resposta do nó ao comando anterior
Código de erro -24503	O disco já está marcado como spare	Não é necessário repetir
O comando é aceito, mas os dados não mudaram	A coleta e a gravação são assíncronas: o comando apenas foi encaminhado ao agente do nó	Abra a tela novamente; verifique Last_seen para saber se os valores estão atualizados
O disco está online, mas a capacidade do cluster não aumentou	Colocar um disco online no cluster não monta um pool ZFS	Monte o pool no nó e depois habilite e inicie seu serviço
O nó está habilitado, mas CPU (Cores) e RAM (GB) estão vazios	O armazenamento de métricas ainda não tem dados do nó	Aguarde a coleta de métricas e verifique a seção Perfdata no cartão do nó

Veja também

• A arquitetura do cluster, o par de status de cada objeto e as feature flags — "Cluster, nós e serviços".
• O conjunto completo de operações com nós — "Gerenciamento dos nós do cluster".
• Os serviços de pool e suas atribuições a nós — "Gerenciamento dos serviços do cluster".
• Substituição planejada de disco em um nó em serviço — "Substituição planejada de disco em um nó".

Métodos da API

Operações da API nesta página: node-list, get-statusmap, cluster-node-enable, cluster-node-disable, node-inventory, host-inventory, node-hw-list, node-cpu-cores, node-software-inventory, node-software, node-config-map, node-config-get, node-config-set, pd-list, pd-status-map, pd-use, pd-unuse, pd-spare, pd-led, cluster-service-enable, cluster-service-start, cluster-overview, cluster-totals — consulte a referência da API.