Omnissa Access Control Plane 클러스터 초기화

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

제어부 클러스터 초기화

절차:

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

참고: 배포한 OVA 크기에 따라 다음 명령 중 하나를 실행해야 합니다. 예:

• 소형 OVA를 배포한 경우:
  wso access init -n cp-cluster -s small

• 중형 OVA를 배포한 경우: wso access init -n cp-cluster -s medium

• 대형 OVA를 배포한 경우: wso access init -n cp-cluster -s large

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

cd /root/<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: /root/<cluster_name>/telegraf_plugin/prometheus_remote_write.conf.example
<timestamp> Successfully initialized

결과

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

• 클러스터 인벤토리 파일(cp-cluster.ini)
• profile.yml 파일

클러스터 인벤토리 구성

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

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

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

다음 명령을 실행합니다.

update-cluster-ini.sh INI_FILE=/root/<cluster_name>/cp-cluster/cp-cluster.ini

# Output

[root@bootstrap configuser]# ./update-cluster-ini.sh INI_FILE=/root/<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 /root/<cluster_name>/cp-cluster/cp-cluster.ini to /root/<cluster_name>/cp-cluster/cp-cluster.ini.bkp.20260714_052152
Written /root/<cluster_name>/cp-cluster/cp-cluster.ini (small): access=2, infra=3, asset=2.

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

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

   vi /root/<cluster_name>/cp-cluster/cp-cluster.ini
   

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

   참고: ansible_password 또는 ansible_ssh_private_key_file 옵션을 사용할 수 있습니다.

   ansible_ssh_private_key_file을 사용하는 경우 3단계가 필요합니다.

   ansible_password를 사용하는 경우 OVA 배포 시 사용한 것과 동일한지 확인합니다.

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

3. 아래의 인라인 지침에 따라 ansible_ssh_private_key_file 파일을 생성하고 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 /root/<cluster_name>/cp-cluster/private-key
   
   # Copy the private key to PATH
   cp /home/configuser/.ssh/id_<cipher> /root/<cluster_name>/cp-cluster/private-key
   
   # change the permission of file
   chmod 400 /root/<cluster_name>/cp-cluster/private-key/id_<cipher>
   

/root/<cluster_name>/profile.yml 파일 업데이트

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

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 /root/<cluster_name>/profile.yml
   

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

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

3. profile.yml 파일의 나머지 부분을 검토하고 로깅 및 메트릭과 같은 다른 필요한 섹션을 업데이트합니다.

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

5. 다음 명령을 실행하여 profile.yml 파일을 검증합니다. wso cp precheck

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

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

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