Inicializar o cluster do Omnissa Access Control Plane

Siga os procedimentos abaixo para inicializar o cluster do Omnissa Access Control Plane pelo nó de bootstrap. Todos os comandos devem ser executados pelo nó de bootstrap.

Inicializar o cluster do Control Plane

Procedimento:

• Siga as instruções abaixo para inicializar o cluster do Control Plane.

  Nota: execute o seguinte comando, substituindo <size_of_your_deployment> por small, medium ou large para corresponder ao tamanho do OVA que você implantou:

  cd /opt/wss/<cluster_name>
  wso access init -n cp-cluster -s <size_of_your_deployment>
  

  Ao este comandos, a saída será semelhante à seguinte:

  cd /opt/wss/<cluster_name>
  wso access init -n cp-cluster -s small
  
  # Output
  <timestamp> Control Plane name: cp-cluster
  <timestamp> Created a sample profile.yml file
  <timestamp> Sample Control Plane inventory file created
  <timestamp> Created a sample telemetry config file: /opt/wss/<cluster_name>/telegraf_plugin/prometheus_remote_write.conf.example
  <timestamp> Successfully initialized
  

Resultados:

Esse comando cria os seguintes arquivos:

• Arquivo de inventário do cluster: /opt/wss/<cluster_name>/cp-cluster/cp-cluster.ini
• Arquivo de configuração de implantação: /opt/wss/<cluster_name>/profile.yml

Configurar o inventário do cluster

O arquivo cp-cluster.ini define os seguintes itens:

• Nós de infraestrutura/plataforma
• Nós do Omnissa Access

Gerar um arquivo de chave privada SSH:

Se você planeja usar ansible_ssh_private_key_file para se conectar aos nós do cluster (em vez de ansible_password), gere o arquivo de chave abaixo antes de preencher o arquivo cp-cluster.ini.

# On bootstrap node follow below steps
# change to configuser
su configuser

# Generate Public and private keys
ssh-keygen -t <cipher>

# Copy public Key to all other machines (Access+Infra+platform)
ssh-copy-id configuser@10.0.0.X 
# Repeat this for all cluster VMs from bootstrap VM

# Test login work with other machines without password
ssh configuser@10.0.0.X
# You should be able to login to 10.0.0.X from bootstrap without credentials

# Exit from 10.0.0.X by using exit command, so that you are in bootstrap machine. 
exit 
# Exit as configuser; run again to return to root

# create a directory in bootstrap machine
mkdir -p /opt/wss/<cluster_name>/cp-cluster/private-key

# Copy the private key to PATH
cp /home/configuser/.ssh/id_<cipher> /opt/wss/<cluster_name>/cp-cluster/private-key

# change the permission of file
chmod 400 /opt/wss/<cluster_name>/cp-cluster/private-key/id_<cipher>

Procedimento para preencher automaticamente o arquivo cp-cluster.ini:

Execute o seguinte comando:

update-cluster-ini INI_FILE=/opt/wss/<cluster_name>/cp-cluster/cp-cluster.ini

# Output

[root@bootstrap configuser]# update-cluster-ini INI_FILE=/opt/wss/<cluster_name>/cp-cluster/cp-cluster.ini
Enter User (this is the user created at OVA deployment): configuser
Use (1) password or (2) ssh_private_key_file?
Enter 1 or 2: 1
Enter password:
Deployment size: (1) small  (2) medium  (3) large
Enter 1, 2, or 3: 1
Enter Omnissa Access Node IPs (2 IPs required, comma or space separated): 10.0.0.x 10.0.0.x
Enter infra and platform node IPs (3 IPs required, comma or space separated): 10.0.0.x 10.0.0.x 10.0.0.x 
Moved existing /opt/wss/<cluster_name>/cp-cluster/cp-cluster.ini to /opt/wss/<cluster_name>/cp-cluster/cp-cluster.ini.bkp.20260714_052152
Written /opt/wss/<cluster_name>/cp-cluster/cp-cluster.ini (small): access=2, infra=3, asset=2.

Nota: quando solicitado a digitar a senha, insira a mesma senha usada para a conta configuser na implantação do OVA. Essa senha deve ser idêntica em todos os nós de Bootstrap, Omnissa Access e Infraestrutura/Plataforma do cluster.

Procedimento manual para atualizar o arquivo cp-cluster.ini:

1. Abra o arquivo cp-cluster.ini. Por exemplo:

   vi /opt/wss/<cluster_name>/cp-cluster/cp-cluster.ini
   

2. Siga as instruções abaixo para atualizar o arquivo.

   Nota: ansible_user deve estar sempre definido como configuser.

   Escolha um método de autenticação:

   • ansible_password: confirme se o campo está preenchido com a senha de configuser.
   • ansible_ssh_private_key_file: a chave privada SSH gerada para configuser (consulte Gerar um arquivo de chave privada SSH acima).

   Use uma ou outra, não ambas.

   [linux:children]
   asset_server_linux
   consul_server_linux
   general_compute_linux
   kafka_controller_linux
   kafka_server_linux
   nomad_server_linux
   opensearch_leader_linux
   opensearch_data_linux
   postgres_linux
   vault_server_linux
   general_compute_nginx_http
   general_compute_access_linux
   
   # This template includes sample IPs. Please update these to match your specific environment settings.
   
   # Provide IPs to asset server nodes
   [asset_server_linux]
   10.0.0.1
   10.0.0.2
   
   # Provide IPs to all Infrastructure/Platform and Omnissa Access nodes
   [consul_server_linux]
   10.0.0.1
   10.0.0.2
   10.0.0.3
   10.0.0.4
   10.0.0.5
   
   # Provide IPs to all Infrastructure/Platform and Omnissa Access nodes
   [vault_server_linux]
   10.0.0.1
   10.0.0.2
   10.0.0.3
   10.0.0.4
   10.0.0.5
   
   # Provide IPs to all Infrastructure/Platform and Omnissa Access nodes
   [nomad_server_linux]
   10.0.0.1
   10.0.0.2
   10.0.0.3
   10.0.0.4
   10.0.0.5
   
   # Provide IPs to kafka controller nodes
   [kafka_controller_linux]
   10.0.0.1
   10.0.0.2
   10.0.0.3
   
   # Provide IPs to kafka server nodes
   [kafka_server_linux]
   10.0.0.1
   10.0.0.2
   10.0.0.3
   
   # Provide IPs to postgres server nodes
   [postgres_linux]
   10.0.0.1
   10.0.0.2
   10.0.0.3
   
   # Provide IPs to Opensearch leader nodes
   [opensearch_leader_linux]
   10.0.0.1
   10.0.0.2
   10.0.0.3
   
   # Provide IPs to Opensearch data nodes
   [opensearch_data_linux]
   10.0.0.1
   10.0.0.2
   10.0.0.3
   
   # Provide IPs to General compute nodes
   [general_compute_linux]
   10.0.0.1
   10.0.0.2
   10.0.0.3
   
   # Provide IPs to access compute nodes
   [general_compute_access_linux]
   10.0.0.4
   10.0.0.5
   
   # Provide IPs to Nginx HTTP server nodes
   [general_compute_nginx_http]
   10.0.0.4
   10.0.0.5
   
   [linux:vars]
   # Uncomment ansible_user, ansible_password or ansible_ssh_private_key_file below to provide common credentials to connect to each of the specified nodes
   # Only one of password or ssh private key can be provided
   #ansible_user=
   #ansible_password=
   #ansible_ssh_private_key_file=
   

Atualizar o arquivo profile.yml

Este procedimento garante que apenas os serviços essenciais de infraestrutura sejam implantados inicialmente.

O arquivo profile.yml (/opt/wss/<cluster_name>/profile.yml) contém definições de configuração no nível da implantação para o ambiente do cluster. Ele é usado principalmente para configurar:

• Sincronização de tempo (NTP)

• Armazenamento compartilhado (NFS)

• Integração de log centralizada

  A seção de registro em log permite que os serviços de cluster encaminhem logs para plataformas de log centralizadas, como:

  • Loki
  • OpenSearch
  • Syslog

  Exemplo de estrutura:

  # logging:
  # loki_server:
  #    url:
  #    username:
  #    password:
  # opensearch:
  #    url: https://10.0.0.x:<port>
  #    username: host-logging-writer
  #    password: *******
  #    index_prefix: access_logs
  # syslog_servers:
  #    host:
  #    protocol: udp
  #    port: 514
  #    syslog_cert_passphrase:   # only if your syslog client key in the logging directory is passphrase-protected  
  

Notas importantes

• As alterações de configuração de registro em log após a implantação podem exigir que a reimplantação ou a atualização entre em vigor.
• Remova o comentário e configure apenas as seções necessárias.
• Certifique-se de que todos os serviços externos (NTP, NFS, servidores de log) estejam acessíveis por meio dos nós de cluster.
• Este não é um procedimento obrigatório, mas se sua organização tiver um servidor NTP, você poderá habilitar e atualizar a configuração do servidor NTP com o endereço do servidor.

Procedimento:

1. Abra o arquivo profile.yml. Por exemplo:

   vi /opt/wss/<cluster_name>/profile.yml
   

2. Remova o comentário das configurações utilizadas para definir o armazenamento compartilhado baseado em NFS (se desejado) e o servidor NTP (recomendado) para o cluster, da seguinte forma:

   # Uncomment and provide NTP server to configure for time synchronization on the cluster nodes
   # ntp_server:
   
   # Uncomment and provide NFS server to configure Network File Share on the cluster nodes
   # nfs_host: 10.0.0.x
   # nfs_path:
   # nfs_version: 4
   

3. Revise o restante do arquivo profile.yml e atualize outras seções necessárias, como log e métricas.

4. Salve o arquivo profile.yml.

5. Execute o comando a seguir para validar o arquivo profile.yml.

   wso cp precheck
   
   # Output
   Cluster Size is (small)...
   The following errors were found in the cluster configuration:
   logging configuration is not set
   telemetry configuration is not set
   nfs backup server info is not set
   
   Please fix the above errors and validate the cluster configuration again.
   

   Nota: se wso cp precheck relatar que as informações de registro, telemetria ou servidor de backup NFS não estão definidas, esses erros são esperados caso você não tenha configurado essas opções opcionais. Você pode ignorá-los com segurança e prosseguir para wso access validate.

Validar o arquivo de inventário do cluster

• Depois de atualizar o arquivo de inventário (.ini), valide-o. Por exemplo:

  wso access validate
  
  # OUTPUT
  <timestamp> Inventory file validated successfully.
  

  Nota: wso access validate pode relatar sucesso mesmo que wso cp precheck tenha relatado erros de configuração anteriormente. Este é o comportamento esperado: prossiga com wso access validate independentemente de qualquer aviso de pré-verificação.