3ノード構成の導入準備

ご使用のシステムで使用可能なデバイスを確認するには、 node0 および node1:

lsblk
 

以下に、 node0の出力例を示します。

NAME                      MAJ:MIN RM   SIZE RO TYPE MOUNTPOINTS
loop0                       7:0    0  63.5M  1 loop /snap/core20/2015
loop1                       7:1    0    87M  1 loop /snap/lxd/27037
loop3                       7:3    0 111.9M  1 loop /snap/lxd/24322
loop4                       7:4    0  63.9M  1 loop /snap/core20/2182
loop5                       7:5    0  40.9M  1 loop /snap/snapd/20290
loop6                       7:6    0  40.4M  1 loop /snap/snapd/20671
vda                       252:0    0   250G  0 disk
├─vda1                    252:1    0     1M  0 part
└─vda2                    252:2    0   248G  0 part
   └─ubuntu--vg-ubuntu--lv 253:0    0   248G  0 lvm  /
vdb                       252:16   0  1000G  0 disk
 

node1の出力例を以下に示します。

NAME                      MAJ:MIN RM   SIZE RO TYPE MOUNTPOINTS
loop0                       7:0    0  63.5M  1 loop /snap/core20/2015
loop1                       7:1    0    87M  1 loop /snap/lxd/27037
loop3                       7:3    0 111.9M  1 loop /snap/lxd/24322
loop4                       7:4    0  63.9M  1 loop /snap/core20/2182
loop5                       7:5    0  40.9M  1 loop /snap/snapd/20290
loop6                       7:6    0  40.4M  1 loop /snap/snapd/20671
vda                       252:0    0   250G  0 disk
├─vda1                    252:1    0     1M  0 part
└─vda2                    252:2    0   248G  0 part
   └─ubuntu--vg-ubuntu--lv 253:0    0   248G  0 lvm  /
vdb                       252:16   0  1000G  0 disk
vdc                       252:32   0   500G  0 disk
vdd                       252:48   0   1200G  0 disk
 

node0 および node1で追加したディスクごとに、ファイル・システムを作成する必要があります。

ディスクに適した任意のファイル・システムを使用できます。 Ext4 と XFS は、2 つの一般的な Linux ファイル・システムです。 Ext4 と XFS のどちらを選択するかは、ユーザーの好みとシステムの具体的なニーズによって異なります。 ほとんどのシステムでは Ext4 を選択することをお勧めしますが、より信頼性の高いファイル・システムが必要な場合は、XFS を使用することをお勧めします。

• ここでは、 ext4 ファイル・システムの使用例を示します。

  • node0 (instana-0) では、以下のコマンドを使用して単一のファイル・システムを作成できます。

    for disk in vdb ; do
        echo "make filesystem for $disk"
        mkfs.ext4 -m 0 -E lazy_itable_init=0,lazy_journal_init=0,discard /dev/$disk
    done
     

  • node1 (instana-1) では、以下のコマンドを使用して 3 つのファイル・システムを作成できます。

    for disk in vdb vdc vdd ; do
        echo "make filesystem for $disk"
        mkfs.ext4 -m 0 -E lazy_itable_init=0,lazy_journal_init=0,discard /dev/$disk
    done
     

• ここでは、 xfs ファイル・システムの使用例を示します。

  • node0 (instana-0) では、以下のコマンドを使用して単一のファイル・システムを作成できます。

    for disk in vdb; do
        echo "make filesystem for $disk"
        mkfs.xfs -f -i size=1024 -L $disk /dev/$disk
    done
     

  • node1 (instana-1) では、以下のコマンドを使用して 3 つのファイル・システムを作成できます。

    for disk in vdb vdc vdd; do
        echo "make filesystem for $disk"
        mkfs.xfs -f -i size=1024 -L $disk /dev/$disk
    done
     

ホスト上で、必ず 4 つのディレクトリーを作成してください。 ハードウェア要件を参照してください。

以下のコマンド例では、デフォルトのディレクトリー・パスを使用しています。 任意の場所にディレクトリーを作成することができます。 ただし、ディレクトリーをマウントするときには、必ず正しいパスを使用してください。

• node0 (instana-0) で、 objects ディレクトリーを作成します。

  mkdir -p /mnt/instana/stanctl/objects
   

• node1 (instana-1) で、以下の 3 つのディレクトリーを作成します。

  mkdir -p /mnt/instana/stanctl/data
  mkdir -p /mnt/instana/stanctl/metrics
  mkdir -p /mnt/instana/stanctl/analytics
   

作成したディレクトリーにマウント・パスを追加する必要があります。 ホスト上のディスクを特定するで、デバイスの一覧を確認できます。

まず、 node0 (instana-0) および node1 (instana-1) にあるファイルシステムテーブル（fstab）ファイル内のデバイス名を、それぞれのUUID（一意の識別子）に置き換えてください。

再起動後、特に複数のディスクを接続している場合、デバイス名が変更されることがあります。 このような状況では、ディスクと元のマウントパスとの間に不一致が生じる可能性があります。 これらの問題を回避するには、ファイル fstab 内のデバイス名をUUID（一意の識別子）に置き換えてください。

ディレクトリーが正しいディスクにマウントされていることを確認してください。 デバイス名を取得するには、 追加ディスクの準備 を参照してください。

lsblk <device name>
 

すべてのファイル・システムをマウントします。 node0 (instana-0) および node1 (instana-1) で以下のコマンドを実行します。

mount -a
 

アプリケーションのページがスワップ領域に移動されないように 0vm.swappiness 設定します。

sh -c 'echo vm.swappiness=0 >> /etc/sysctl.d/99-stanctl.conf' && sysctl -p /etc/sysctl.d/99-stanctl.conf
 

システムが最大8192個のinotifyインスタンスを許可するように 8192fs.inotify.max_user_instances 設定してください。

sh -c 'echo fs.inotify.max_user_instances=8192 >> /etc/sysctl.d/99-stanctl.conf' && sysctl -p /etc/sysctl.d/99-stanctl.conf
 

メモリ管理のため、Transparent Huge Pages（THP）を恒久的に無効にします。

• Ubuntu または Debian のホストをお持ちの場合は、以下のコマンドを実行してください：

  sed -i "s/\(GRUB_CMDLINE_LINUX=\".*\)\"/\1 transparent_hugepage=never\"/" "/etc/default/grub"
  update-grub
   

• Red Hat® Enterprise Linux®、 CentOS Stream、 Amazon Linux、または Oracle Linux のホストをお持ちの場合は、次のコマンドを実行してください：

  grubby --args="transparent_hugepage=never" --update-kernel ALL
   

• SUSE Linux Enterprise Server （SLES）ホストをお持ちの場合は、以下のコマンドを実行してください：

  sed -i "s/\(GRUB_CMDLINE_LINUX=\".*\)\"/\1 transparent_hugepage=never\"/" "/etc/default/grub"
  grub2-mkconfig -o /boot/grub2/grub.cfg
   

これらの変更を有効にするには、システムの再起動が必要です。

再起動後、THPが無効になっていることを確認してください。

cat /sys/kernel/mm/transparent_hugepage/enabled
 

以下の出力は、THPが無効になっていることを示しています。

always madvise [never]
 

Amazon Linux 2023 では、 container-selinux および k3s-selinux パッケージが見つかりません。 これらの設定は、 Standard Edition インストーラーが Instana を中断することなくインストールするために必要です。

• パッケージ container-selinux をインストールしてください。

  dnf install -y container-selinux
   

• パッケージ k3s-selinux をインストールしてください。

  dnf install -y https://rpm.rancher.io/k3s/stable/common/centos/8/noarch/k3s-selinux-1.6-1.el8.noarch.rpm
   

Red Hat Enterprise Linux および CentOS Stream のホストでは、デフォルトでは /usr/local/bin ディレクトリは 環境 PATH 変数に含まれません。 Standard Edition のインストーラーは、インストール中にいくつかのコマンドを実行するために、この PATH ディレクトリを必要とします。

ディレクトリを環境 /usr/local/binPATH 変数に追加するには、以下の手順を実行してください：

1. コマンド export PATH を または .bash_profile ファイル .bashrc に追加します。

   echo 'export PATH=$PATH:/usr/local/bin' >> ~/.bashrc
    

   OR

   echo 'export PATH=$PATH:/usr/local/bin' >> ~/.bash_profile
    

2. 変更を適用します。 前のコマンドで更新したファイル名を使用してください。

   source ~/.bashrc
    

   OR

   source ~/.bash_profile
    

3. ディレクトリ /usr/local/bin が環境変数 PATH に含まれていることを確認してください。

   echo $PATH
    

パスの更新が成功すると、出力に /usr/local/bin が表示されます。

Instana 環境用に、ドメイン名と DNS ゾーンが設定されていることを確認してください。 次に、以下のドメインについて、ゾーンに DNS のAレコードを追加してください：

DNS のAレコードを追加する詳細な手順については、ご利用のドメイン登録業者のドキュメントをご参照ください。

特定の Linux ディストリビューションでは、ファイアウォールによって競合や制限が課される可能性があります。 これらの競合は、インストールに必要なネットワーク通信およびサービス・ディスカバリーに影響を与える可能性があります。 したがって、ファイアウォールが開いている場合は、必要なポートそしてそれにルールを課します。

外部ファイアウォールを使用している場合は、ポートを開く方法についてはファイアウォールのドキュメントを参照してください。

Amazon Web Services （ AWS ）での Standard Edition のデプロイにおいては、ファイアウォールが無効になっている場合でも、セキュリティグループのすべてのポートを開く必要があります。

必要なポートを開くには、次の手順を実行します。

• の上Ubuntuホストの場合は、すべてのノードで次のコマンドを実行します。 コマンドではノードの IP アドレスを使用します。

  ufw allow 22/tcp
  ufw allow 80/tcp
  ufw allow 443/tcp
  ufw allow 8443/tcp
  ufw allow from <node0 (instana-0) IP> to any port 22 proto tcp
  ufw allow from <node0 (instana-0) IP> to any port 6443,10250,2379,2380,5001,9443,53 proto tcp
  ufw allow from <node0 (instana-0) IP> to any port 8472,53 proto udp
  ufw allow from <node1 (instana-1) IP> to any port 6443,10250,2379,2380,5001,9443,53 proto tcp
  ufw allow from <node1 (instana-1) IP> to any port 8472,53 proto udp
  ufw allow from <node2 (instana-2) IP> to any port 6443,10250,2379,2380,5001,9443,53 proto tcp
  ufw allow from <node2 (instana-2) IP> to any port 8472,53 proto udp
  ufw allow from 10.42.0.0/16 to any
  ufw allow from 10.43.0.0/16 to any
  ufw allow in on lo
  ufw allow out on lo
  ufw reload
   

• Debian、 Red Hat Enterprise Linux、 CentOS Stream、 Amazon Linux、 Oracle Linux、および SUSE Linux Enterprise Server (SLES) ホストでは、すべてのノードで以下のコマンドを実行してください。 コマンドではノードの IP アドレスを使用します。

  firewall-cmd --permanent --add-port=22/tcp
  firewall-cmd --permanent --add-port=80/tcp
  firewall-cmd --permanent --add-port=443/tcp
  firewall-cmd --permanent --add-port=8443/tcp
  firewall-cmd --new-zone=internal-access --permanent
  firewall-cmd --permanent --zone=internal-access --add-source=<node0 (instana-0) IP>
  firewall-cmd --permanent --zone=internal-access --add-source=<node1 (instana-1) IP>
  firewall-cmd --permanent --zone=internal-access --add-source=<node2 (instana-2) IP>
  firewall-cmd --permanent --zone=internal-access --add-port=22/tcp
  firewall-cmd --permanent --zone=internal-access --add-port=6443/tcp
  firewall-cmd --permanent --zone=internal-access --add-port=10250/tcp
  firewall-cmd --permanent --zone=internal-access --add-port=2379/tcp
  firewall-cmd --permanent --zone=internal-access --add-port=2380/tcp
  firewall-cmd --permanent --zone=internal-access --add-port=5001/tcp
  firewall-cmd --permanent --zone=internal-access --add-port=8472/udp
  firewall-cmd --permanent --zone=internal-access --add-port=9443/tcp
  firewall-cmd --permanent --zone=internal-access --add-port=53/udp
  firewall-cmd --permanent --zone=internal-access --add-port=53/tcp
  firewall-cmd --permanent --zone=trusted --add-source=10.42.0.0/16
  firewall-cmd --permanent --zone=trusted --add-source=10.43.0.0/16
  firewall-cmd --permanent --zone=trusted --add-interface=lo
  firewall-cmd --reload
   

HTTP_PROXY、 HTTPS_PROXY、および NO_PROXY 環境変数を定義します。

Standard Edition をインストールするコマンド stanctl up --multi-node-enable を実行すると、インストール処理では自動的に現在のシェルから環境変数の値が読み込まれます。

次のコマンドを使用して、環境変数を設定してください：

HTTP_PROXY=http://your-proxy.example.com:<port_number>
 

HTTPS_PROXY=http://your-proxy.example.com:<port_number>
 

NO_PROXY=127.0.0.0/8,10.0.0.0/8,172.16.0.0/12,192.168.0.0/16
 

Red Hat Enterprise Linux および CentOS Stream ホストにおいて、が有効になっている nm-cloud-setup 場合は、各ノードでこれを無効にし、ノードを再起動する必要があります。

以下のコマンドを使用します。

1. が有効になっている nm-cloud-setup か確認してください。

   systemctl is-enabled nm-cloud-setup.service
    

   サービスが無効になっている場合、コマンドは を返します disabled。そうでない場合は を返します enabled。

2. が無効になっている nm-cloud-setup 場合は、次のセクションに進んでください。 が有効になっている nm-cloud-setup 場合は、無効にしてください。

   systemctl disable nm-cloud-setup.service nm-cloud-setup.timer
    

3. ノードをリブートします。

   systemctl reboot