Omnissa Access Control Plane 클러스터 초기화

아래 절차에 따라 부트스트랩 노드에서 Omnissa Access Control Plane 클러스터를 초기화합니다. 모든 명령은 부트스트랩 노드에서 실행해야 합니다.

제어부 클러스터 초기화

절차:

• 아래의 인라인 지침에 따라 제어부 클러스터를 초기화합니다.

  참고: 배포한 OVA 크기와 일치하도록 <size_of_your_deployment>를, medium, small 또는 large로 대체하고 다음 명령을 실행합니다.

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

  이러한 명령 중 하나를 실행하면 출력이 다음과 유사하게 표시됩니다.

  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
  

결과:

이 명령은 다음 파일을 생성합니다.

• 클러스터 인벤토리 파일: /opt/wss/<cluster_name>/cp-cluster/cp-cluster.ini
• 배포 구성 파일: /opt/wss/<cluster_name>/profile.yml

클러스터 인벤토리 구성

cp-cluster.ini 파일은 다음 항목을 정의합니다.

• 인프라/플랫폼 노드
• Omnissa Access 노드

SSH 개인 키 파일 생성:

ansible_ssh_private_key_file을 사용하여 ansible_password 대신 클러스터 노드에 연결하려는 경우 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>

cp-cluster.ini 파일을 자동으로 채우는 절차:

다음 명령을 실행합니다.

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.

참고: 암호를 묻는 메시지가 표시되면 OVA 배포 시 configuser 계정에 사용되는 것과 동일한 암호를 입력합니다. 이 암호는 클러스터의 모든 부트스트랩, Omnissa Access 및 인프라/플랫폼 노드에서 동일해야 합니다.

cp-cluster.ini 파일을 업데이트하는 수동 절차:

1. cp-cluster.ini 파일을 엽니다. 예:

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

2. 아래의 인라인 지침에 따라 파일을 업데이트합니다.

   참고: ansible_user는 항상 configuser로 설정해야 합니다.

   그런 후 한 가지 인증 방법을 선택합니다.

   • ansible_password — 이 필드가 configuser 암호로 설정되어 있는지 확인합니다.
   • ansible_ssh_private_key_file — configuser에 대해 생성된 SSH 개인 키입니다(위의 SSH 개인 키 파일 생성 참조).

   둘 다 사용하지는 말고 둘 중 하나만 사용합니다.

   [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=
   

profile.yml 파일 업데이트

이 절차는 핵심 인프라 서비스만 처음에 배포되도록 합니다.

profile.yml 파일(/opt/wss/<cluster_name>/profile.yml)에는 클러스터 환경에 대한 배포 수준 구성 설정이 포함되어 있습니다. 주로 다음을 구성하는 데 사용됩니다.

• 시간 동기화(NTP)

• 공유 스토리지(NFS)

• 중앙 집중식 로깅 통합

  로깅 섹션을 사용하면 클러스터 서비스가 다음과 같은 중앙 집중식 로깅 플랫폼에 로그를 전달할 수 있습니다.

  • Loki
  • OpenSearch
  • Syslog

  구조 예:

  # 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  
  

중요 참고 사항

• 배포 후 로깅 구성 변경 사항을 적용하려면 다시 배포 또는 업그레이드가 필요할 수 있습니다.
• 주석 처리를 제거하고 필요한 섹션만 구성합니다.
• 클러스터 노드에서 모든 외부 서비스(NTP, NFS, 로깅 서버)에 연결할 수 있는지 확인합니다.
• 필수 절차는 아니지만 조직에 NTP 서버가 있는 경우 서버 주소로 NTP 서버 구성을 사용하도록 설정하고 업데이트할 수 있습니다.

절차:

1. profile.yml 파일을 엽니다. 예:

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

2. 클러스터에 대해 NFS 기반 공유 스토리지(원하는 경우) 및 NTP 서버(권장)를 구성하는 데 사용되는 설정의 주석 처리를 제거합니다.

   # 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. profile.yml 파일의 나머지 부분을 검토하고 로깅 및 메트릭과 같은 다른 필요한 섹션을 업데이트합니다.

4. profile.yml 파일을 저장합니다.

5. 다음 명령을 실행하여 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.
   

   참고: wso cp precheck가 로깅, 원격 분석 또는 NFS 백업 서버 정보가 설정되지 않았다고 보고하는 경우 이러한 선택적 설정을 구성하지 않았다면 이러한 오류는 예상되는 것입니다. 이러한 오류는 무시해도 안전하며 wso access validate를 계속 진행할 수 있습니다.

클러스터 인벤토리 파일 검증

• 인벤토리 파일(.ini)을 업데이트한 후 검증합니다. 예:

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

  참고: wso cp precheck가 이전에 구성 오류를 보고한 경우에도 wso access validate는 성공을 보고할 수 있습니다. 이것은 예상된 동작입니다. 사전 검사 주의와 관계없이 계속 wso access validate를 진행합니다.