Omnissa Access Control Plane クラスタの初期化

ブートストラップ ノードから Omnissa Access Control Plane クラスタを初期化するには、次の手順を実行します。 すべてのコマンドはブートストラップ ノードから実行する必要があります。

Control Plane クラスタの初期化

手順：

• 以下のインラインの指示に従って、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.