Skip to main content

2026 年 9 月 15 日

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

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

Control Plane クラスタの初期化

手順:

  • 以下のインラインの指示に従って、Control Plane クラスタを初期化します。

    **注:**次のコマンドを実行します。<size_of_your_deployment> は、展開した OVA サイズに合わせて small、medium、または 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 ノード
コンポーネントIP アドレス
asset_serverすべてのインフラストラクチャ/プラットフォーム ノード
consul、vault、nomadすべてのインフラストラクチャ/プラットフォーム ノードと Omnissa Access ノード
kafka、opensearch、opensearch_leader、persistent_redis、postgres、general_computeすべてのインフラストラクチャ/プラットフォーム ノード
general_compute_access_linuxすべての Omnissa Access ノード
general_compute_nginx_httpすべての 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 に進みます。

このページは役に立ちましたか?

このトピックについてフィードバックを送信

このトピックは役に立ちましたか?

個人情報や機密情報は入力しないでください。

リンクを生成しています…