サポートOS
Instanaバックエンドプラットフォームは次のLinuxディストリビューションがサポートされています。- Ubuntu 16.04
- Debian 9.x
- RedHat 7.2以降
- CentOS 7.x
- Amazon Linux 2.x
サポートされているDockerバージョン
最小限の要件
Instanaをインストールするマシンには、16 CPUと64 GBの使用可能なメモリが必要です。必須条件
- Dockerリポジトリに対して認証するには、サーバが auth-infra.instana.io:8443 に接続できることを確認してください
- すべてのインストールおよび移行コマンドは、root ユーザーとして実行する必要があります
- Dockerがインストールされている必要があります。Dockerのインストール方法については、Docker CEまたはDocker EEのドキュメントを参照してください。
- マウントポイントと外部ボリュームをセットアップします
- データストア(デフォルトは /mnt/data)。
- Cassandraは、実稼働インストールと同じボリュームを使用しないでください(デフォルトは/mnt/metrics)
- ClickHouseは、実稼働インストールと同じボリュームを使用しないでください(デフォルトは/mnt/traces)。
ログのデフォルトは /var/log/instanaですが、必要に応じて別のディレクトリを作成できます。新規インストール:単一ホスト
1. Instanaパッケージのインストール
Instanaパッケージのインストール手順は以下の通りです。Ubuntu / Debian
rootで次の行を実行します。はご使用のエージェントキーに置き換えます。echo "deb [arch=amd64] https://_:@packages.instana.io/release/product/deb generic main" > /etc/apt/sources.list.d/instana-product.list
wget -qO - "https://packages.instana.io/Instana.gpg" | apt-key add -
apt-get update
apt-get install instana-console
RedHat / CentOS
rootで次の行を実行します。はご使用のエージェントキーに置き換えます。
cat >/etc/yum.repos.d/Instana-Product.repo <<EOF
[instana-product]
name=Instana-Product
baseurl=https://_:@packages.instana.io/release/product/rpm/generic/x86_64
enabled=1
gpgcheck=1
repo_gpgcheck=1
gpgkey=https://packages.instana.io/Instana.gpg
priority=5
sslverify=1
#proxy=http://x.x.x.x:8080
#proxy_username=
#proxy_password=
EOF
yum makecache -y fast
yum install -y instana-console --nogpgcheck
2. Instanaのインストール
- Instanaをインストールするには、次のコマンドを実行します。
instana init
注:settings.hcl ファイルは、instana init コマンドを実行したディレクトリに生成されます。 - single (単一ホストインストール)を選択します
- 次の情報を入力します
- 表示された資格情報を使用して、Instanaにサインインできるようになりました
- Instanaがデプロイされたら、ライセンスのアクティブ化をします
エアギャップ(隔離)環境のホストへのインストール
前提条件:インターネットに接続されていないターゲットホストにDockerがインストールされていることを確認してください。- インターネットに接続できるホストで、前のセクションの説明に従ってinstana-console をインストールします
- バイナリをダウンロードします。2つのファイルが必要です
- instana-console バイナリ Ubuntu/Debianでは、apt-get download instana-console を実行 RedHat/CentOSでは、yum install –downloadonly instana-console を実行 もしくはミラーレポジトリを利用
- Instana Dockerコンテナを含むアーカイブを作成する instana images export を実行して、export-{version}.tar を実行したディレクトリに作成
- インターネット接続のないターゲットホストにファイルをコピーする
- ダウンロードしてアーカイブしたパッケージを使ってinstana-console をインストールする
- Dockerがインストールされていることを確認します
- instana images import -f <path/to/export-{version}.tar> でコンテナをインポートする
- 前のセクションの手順でインストールする
必須のコンテナを確認するには、instana images version を実行します。このコマンドは全てのDockerコンテナと対応するバージョンをリストアップします。新規インストール:マルチホスト
マルチホストインストールの場合、ClickHouseはZooKeeperがインストールされたホストとは明確に別のホストに移動されました。1. instana-consoleのインストール
- Dockerデーモンのポートを公開
- ClickHouseとZookeeperをファーストボックスにインストール
対話形式
Instana init を実行し、タイプに dual-clickhouse を選択します非対話形式
Settings.hclファイルに以下の通りに記入します。 type = "dual-clickhouse"
Instanaのインストールinstana init -y
IPtablesを使ったClickHouseサーバ保護
マルチホスト環境でClickHouseサーバを保護するには次のようにします。この例では、Instanaバックエンドホストから発信されるI/OのみがClickHouseホストにアクセスできるようにします。InstanaバックエンドサーバからClickHouseホストにアクセスするにはsshするか、sshするボックスから追加のIPを提供する必要があることに注意してください。iptables -A INPUT -s $(instana backend host IP) -j ACCEPT
iptables -A OUTPUT -d $(instana backend host IP) -j ACCEPT
iptables -A INPUT -d $(ssh host IP) -j ACCEPT #optional
iptables -A OUTPUT -d $(ssh host IP) -j ACCEPT #optional
iptables -A INPUT -j REJECT
iptables -A OUTPUT -j REJECT
残りのInstanaのセカンドボックスへのインストール
対話形式 Instana initを実行し、dual-instanaを選択してダイアログボックスの表示に従います 非対話形式 setting.hclファイルのtypeを設定し、ClickHouseのIPを追加します type = "dual-instana"
clickhouse_bind_address =
Instanaのインストール instana init -y
パッケージベースからコンテナベースインストールへのアップグレード
データのバックアップを作成します。 現在のインストールベースからアップグレードするには次のようにします。- サポートされているバージョンのDockerをインストールします
- instana-console をインストールします
- 移行コマンド containerize を実行します
apt-get update
apt-get install instana-console
instana containerize
5. このコマンドは、パッケージベースのインストールからコンテナベースのインストールに移行するときにだけ必要です。 次の手順が自動的に実行されます。- Dockerが利用可能かどうかを確認
- Instanaを停止
- パッケージを削除
- Dockerイメージのダウンロード
- Instanaをスタート
マルチホストパッケージベースからマルチホストコンテナベースへのアップグレード
データのバックアップを作成します。- サポートされているバージョンのDockerを両方のホストにインストールします
- instana-consoleを両方のホストにインストールします
移行コマンドcontainerizeをClickHouseホストで実行しますinstana containerize -t dual-clickhouse
このコマンドは、パッケージベースのインストールからコンテナベースのインストールに移行するときにだけ必要です。instana containerize -t dual-instana
https://docs.instana.io/quick_start/on_prem_containers/container_based_installation/ から取得したコンテンツ