Configuração inicial do cluster

O instalador entrega um cluster funcional: os nós estão ativos, os pools da camada de armazenamento estão criados, os agregados estão montados, e o ID do cluster e a redundância estão definidos. Em seguida começa o trabalho do administrador, com duas partes distintas: verificar o que foi montado e definir os parâmetros que a plataforma deliberadamente deixa a cargo do administrador.

As configurações do cluster se dividem em dois grupos que se comportam de forma diferente. O vStack Center armazena os parâmetros de nível de cluster, como a política de login, e os aplica imediatamente. Os parâmetros de nível de nó ele envia aos nós: a interface confirma que o valor foi enviado, mas se o nó o aplicou só fica visível na próxima leitura. A implicação prática é ler novamente os parâmetros dos nós depois de gravá-los.

Alguns recursos do cluster são controlados por feature flags. Um flag determina se uma operação está disponível ou não: a configuração de nós só funciona quando node_config_management está ativado. Verifique o flag antes de procurar um problema de permissões.

A sequência abaixo é o mínimo necessário: verificar a composição do cluster, definir os parâmetros dos nós, garantir que os nós e os serviços de pool estejam ativados e finalizar a política de login. A criação de usuários, redes e do primeiro VDC faz parte da operação contínua e está descrita na seção "Administração".

Quando usar

Imediatamente depois que os nós formam um cluster e a interface web fica disponível. Este procedimento não é necessário ao conectar-se a um cluster já configurado.

Pré-requisitos

• O cluster está montado e a interface web responde — consulte Verificar a implantação do vStack Center. A instalação dos nós está descrita na documentação do vStack OS.
• Uma conta com o papel Cluster master: todas as operações desta seção, exceto a leitura das configurações de segurança, estão disponíveis apenas para esse papel.
• Para a configuração de nós, o feature gate node_config_management está ativado.
• vStack Center versão 3.0.5.

Verifique a composição e a integridade do cluster

As verificações de aceitação respondem a uma pergunta: o cluster enxerga exatamente o hardware planejado, e todo ele está operacional? As discrepâncias são mais fáceis de encontrar antes de adicionar máquinas virtuais ao cluster.

1. Expanda Provider Data Center na árvore de navegação e abra a página do cluster pelo nome. Na guia Resources (recursos), a tabela com as colunas Node name, Node health e Consuming deve ter uma linha para cada nó planejado, e Node health deve estar normal para todos os nós.

   Uma conta com o privilégio View Cluster Status Map (full) pode ver a composição completa do cluster. Com o privilégio View Cluster Status Map (dashboard), os dados são os mesmos, mas a interface exibe apenas um resumo.

2. Compare a capacidade total com o projeto. Na mesma guia, o cluster mostra o total e o uso de núcleos, memória e espaço em disco.

   Essas métricas estão disponíveis para os papéis Cluster master e Resource viewer.

   Em um cluster novo, quase nada está em uso, e o total de núcleos, memória e capacidade deve corresponder ao cálculo baseado nas configurações dos nós.

3. Vá para a guia Storage Resources (recursos de armazenamento). Na tabela ZFS pools, com as colunas GUID, Name, Health, Consuming, Scrubbing, Resilvering, Current node e Capacity (RAW), cada pool deve ter Health definido como ONLINE e Current node preenchido.

   Esta seção está disponível apenas para o papel Cluster master. O cluster coleta os dados dos pools a partir dos nós, por isso a tabela é preenchida com um pequeno atraso. Se ela estiver vazia, atualize a página.

Defina os parâmetros dos nós

O vStack Center não escolhe os parâmetros dos nós: o administrador os define, e o cluster envia os valores aos nós. Uma configuração se destina ao cluster inteiro ou a um único nó; neste último caso, apenas esse nó recebe o valor.

A confirmação na interface significa que o valor foi enviado ao nó, e não que o nó já o aplicou. Leia os parâmetros novamente depois de gravá-los.

1. Abra a configuração de nós e defina o parâmetro necessário. O cluster aceita nomes de sua lista de referência: os tunables do ZFS vfs.zfs.* e os limites de vCPU hw.vmm.vcpu_limit.*. Ele rejeita qualquer outro nome com o código -23122. Para enviar a alteração ao cluster inteiro, deixe o nó sem seleção; para enviá-la a apenas um nó, selecione esse nó.

   A operação está disponível para o papel Cluster master quando o feature gate node_config_management está ativado.

2. Leia os parâmetros novamente e verifique se o cluster retorna os valores que você definiu.

Se uma gravação falhar, o motivo é um dos seguintes: a conta não tem o papel Cluster master (-403); o feature gate node_config_management está desativado (-23110); o conjunto de parâmetros está em formato inválido (-23108); foi especificado um parâmetro desconhecido (-23121) ou um parâmetro não suportado pelo vStack Center (-23122); o parâmetro não tem a classe solicitada (-23123); o parâmetro não é escalar (-23120); o valor numérico está abaixo do mínimo (-23124) ou acima do máximo (-23125); o cluster não conseguiu obter o mapa de parâmetros (-23109); ou o comando não pôde ser enviado ao agente do nó (-23133). A lista para leituras é menor: -403, -23110, -23108, -23121, -23122, -23123, -23109 e -23133. O cluster verifica se o valor é escalar e está dentro dos limites numéricos apenas nas gravações, portanto -23120, -23124 e -23125 são retornados pelas gravações. A lista de parâmetros tem seu próprio código: quando o feature gate está desativado, ela retorna -23301.

Ative nós e serviços

Um nó ou serviço tem duas dimensões de estado: administrativa e operacional. O administrador define o estado administrativo, que também é usado para retirar um nó de serviço para manutenção. O estado operacional mostra o que de fato está acontecendo com o objeto. As verificações de aceitação examinam ambos: eles devem coincidir. Os serviços do cluster incluem os serviços de pool da camada de armazenamento, com nomes como zpool_ssd01, e os serviços de sistema, como svc_unbound.

Todas as operações deste grupo estão disponíveis apenas para o papel Cluster master e são executadas imediatamente.

1. Se um nó estiver desativado, ative-o: abra a página do cluster, selecione o nó e ative-o. A operação inversa retira o nó de serviço e também é necessária antes de uma manutenção.
2. Ative o serviço de pool e inicie-o no nó necessário. As operações inversas são parar o serviço e desativá-lo.
3. Volte à composição do cluster e verifique se os estados administrativo e operacional do objeto modificado coincidem: o nó está em serviço, e o serviço de pool está em execução.

Se uma mudança de estado falhar, o motivo é um dos seguintes: a conta não tem o papel Cluster master — tanto nós quanto serviços retornam o mesmo erro, -403; o número do nó está em formato inválido (-20122 ao ativar ou desativar um nó, -20522 ao iniciar um serviço em um nó); ou o cluster rejeitou o comando (-713). O cluster também retorna -713 para um comando endereçado a um nó ou serviço que não existe no cluster.

Finalize a política de login

As configurações de login são as únicas configurações do cluster que devem ser alteradas antes da criação dos primeiros usuários: elas se aplicam a todas as contas imediatamente. A configuração tem duas partes: a complexidade da senha e a proteção contra ataques de força bruta (o número de tentativas malsucedidas, a janela de contagem e a duração do bloqueio).

Parâmetro	Restrição	O que define
Máximo de tentativas de login malsucedidas	Inteiro, no mínimo 1	Quantas tentativas malsucedidas são permitidas antes do bloqueio
Janela de contagem de tentativas, minutos	Inteiro, no mínimo 1	O intervalo durante o qual o cluster conta as tentativas malsucedidas
Duração do bloqueio, minutos	Inteiro, no mínimo 0	Quanto tempo dura o bloqueio; 0 significa que ele só pode ser removido manualmente
Comprimento mínimo da senha	Inteiro, no mínimo 1	Uma senha mais curta que isso não pode ser definida
Exigir uma letra maiúscula	Alternância	Uma senha sem letra maiúscula não é aceita
Exigir uma letra minúscula	Alternância	Uma senha sem letra minúscula não é aceita
Exigir um dígito	Alternância	Uma senha sem dígito não é aceita
Exigir um caractere especial	Alternância	Uma senha sem caractere especial não é aceita

1. Abra Settings (configurações) e clique em Security policy (política de segurança). O formulário é aberto com os valores atuais.

   Todos os usuários autenticados podem ver o bloco de complexidade da senha. Somente o papel Cluster master pode ver as configurações de proteção contra força bruta.

2. Altere os parâmetros necessários e salve o formulário. Os campos que você não alterou mantêm seus valores.

3. Reabra o formulário e verifique se ele mostra os novos valores.

Verifique o resultado

O cluster passa nas verificações de aceitação se cinco condições forem atendidas:

• a guia Resources na página do cluster tem uma linha para cada nó, e Node health está normal para todos os nós;
• todo pool na tabela ZFS pools da guia Storage Resources tem Health definido como ONLINE;
• o total de núcleos, memória e capacidade corresponde ao cálculo baseado nas configurações dos nós;
• a configuração de nós retorna os valores de parâmetros que você definiu;
• o formulário Security policy mostra a política de login que você configurou.

Se não funcionar

• A configuração de nós está indisponível (-23110 em leituras e gravações, -23301 para a lista de parâmetros). O feature gate node_config_management está desativado: os parâmetros dos nós não podem ser definidos até que ele seja ativado. Verifique o estado do flag na configuração do cluster.
• O comando não pôde ser enviado ao agente do nó (-23133). Não há agente para receber a configuração. Aguarde a inicialização dos nós e verifique a composição do cluster na guia Resources.
• A interface confirmou o salvamento, mas o valor no nó não mudou. A confirmação significa apenas que o valor foi enviado ao nó. Leia os parâmetros novamente; se o valor antigo for retornado, repita a gravação.
• O valor não é aceito (-23124 abaixo do mínimo, -23125 acima do máximo). O parâmetro numérico está fora do intervalo permitido. Verifique os limites e tente novamente.
• Um nó ou serviço não muda de estado (-713). O cluster rejeitou o comando: não há nó ou serviço com esse número ou nome, ou o comando não pôde ser enviado aos nós. Verifique o número do nó e o nome do serviço na guia Resources e repita a operação.
• A composição do cluster ou a tabela ZFS pools está incompleta. O cluster coleta os dados de nós e pools a partir dos nós e os retorna com atraso. Atualize a página depois que todos os nós terminarem de inicializar. Se a seção nem abrir (-403), a conta não tem o privilégio necessário.
• A conta fica bloqueada até que um administrador intervenha (-123). Uma duração de bloqueio zero se comporta assim: o bloqueio só pode ser removido manualmente. Defina um valor maior que zero se o desbloqueio automático for necessário. O código -124 indica um bloqueio temporário e é retornado junto com o horário até o qual ele permanece em vigor.
• O login falha (-119). A senha está incorreta ou o usuário não existe. Se o usuário existir, o erro inclui a contagem de tentativas malsucedidas: quantas tentativas foram contadas e quantas restam antes do bloqueio.

Métodos de API

As operações desta página estão disponíveis pela API: get-statusmap, cluster-totals, pools-list, node-config-set, node-config-get, cluster-node-enable, cluster-node-disable, cluster-service-enable, cluster-service-disable, cluster-service-start, cluster-service-stop, auth-security-settings-get, auth-security-settings-set — consulte a referência da API.

Veja também

• Requisitos de hardware e rede — documentação do vStack OS: a referência para verificar a configuração aceita.
• Verificar o hardware e a rede do cluster — como verificá-los pelo vStack Center.
• Criar um VDC com Unified Storage — a próxima etapa após as verificações de aceitação do cluster.