Classic Edition から Standard Edition への移行

Classic Edition のデータを、 Standard Edition がすでにインストールされているホストへ移行することはできません。 新しいホストを使用する必要があります。

以下の前提条件をすべて満たしてください。

• 「シングルノード環境の準備」 または 「マルチノード環境の準備」 に記載されている手順に従って、新しいホストを準備してください。
  • DNS の設定については、以前の環境のテナント名とユニット名を使用してください。 テナント名とユニット名はユニットドメイン名の一部であるため、これらの名前は Standard Edition 環境の DNS レコードに含まれている必要があります。 また、 LDAP の設定も移行されるため、 LDAP 認証を使用して Standard Edition にログインする場合にも、これが必要です。
• バイナリ stanctl をインストールしてください。 詳細については、 「stanctl コマンドラインツールのインストール」 を参照してください。
• 旧ホストと新ホストの Instana バックエンドのバージョンが同じであることを確認してください。 必要に応じて、バックエンドをアップグレードしてください：
  • Classic Edition で Instana バックエンドをアップグレードするには、 「Classic Edition のアップグレード」 を参照してください。 Classic Edition における Instana のバックエンドは、ビルド 271 以降である必要があります。
  • Standard Edition 上の Instana バックエンドをアップグレードするには、 「 Standard Edition のアップグレード」 を参照してください。
• エアギャップ環境への移行を行うには、 バスティオンホスト上でエアギャップ用パッケージを作成し、 そのパッケージをエアギャップホストに転送し、 エアギャップホストにstanctlをインストールし、 エアギャップホスト上でパッケージをインポートします。

データを移行するには、以下の手順を実行してください：

1. Postgres データストアからテナントユニットの構成データを抽出します。

   • Classic Edition ホストで次のコマンドを実行します：

     instana dump config-data
      

   ディレクトリ ./dump 内にファイル dump.tar.gz が作成されます。 このファイルには、実行可能なSQLクエリの形式でテナントユニットの構成データが含まれています。

2. 以下のいずれかのステップを行います。

   • オンライン移行：パッケージ dump.tar.gz を旧ホストから新しい Standard Edition ホストへ移行します。
   • エアギャップ移行：バスティオンホストを使用して、パッケージ dump.tar.gz を古いホストから新しい Standard Edition のエアギャップホストへ転送します。

3. 新しい Standard Edition ホスト上で、ファイル dump.tar.gz からデータを移行してください。

   移行パラメータ

   パラメーター	使用法	例
   --volume-data =<カスタムディレクトリ>	Elasticsearch、 PostgreSQL,、および Kafka のデータストア用の構成データおよび運用データを保存するディレクトリを指定します デフォルト: /mnt/instana/stanctl/data	--volume-data =/custom/data/path
   --volume-metrics =<カスタムディレクトリ>	Cassandra および BeeInstana のデータストア向けに、メトリクスおよび時系列データを保存するディレクトリを指定します デフォルト: /mnt/instana/stanctl/metrics	--volume-metrics =/custom/metrics/path
   --volume-analytics =<カスタムディレクトリ>	ClickHouse のデータストア用の分析データを保存するディレクトリを指定します デフォルト: /mnt/instana/stanctl/analytics	--volume-analytics =/custom/analytics/path
   --volume-objects =<カスタムディレクトリ>	トレースや監視データを含むオブジェクトストレージデータを保存するディレクトリを指定します デフォルト: /mnt/instana/stanctl/objects	--volume-objects =/custom/objects/path

   • シングルノードでのデプロイを行うには、以下のコマンドを実行してください：
     • オンライン・マイグレーション

       stanctl migrate -f </path/to/tar.gz>
        

     • エアギャップ環境への移行

       stanctl migrate --air-gapped -f </path/to/tar.gz>
        

   • マルチノード環境での展開を行うには、以下のコマンドを実行してください：
     • オンライン・マイグレーション

       stanctl migrate --file=</path/to/tar.gz> --multi-node-enable --multi-node-ips=<node0IPaddress,node1IPaddress,node2IPaddress>
        

     • エアギャップ環境への移行

       stanctl migrate --air-gapped --file=</path/to/tar.gz> --multi-node-enable --multi-node-ips=<node0IPaddress,node1IPaddress,node2IPaddress>
        

   次のダイアログが表示されます。

   Are you migrating from the Classic offering?

4. 「はい」と入力してください。 すべてのサービスにおいて、シングルドメインが維持されます。
   コマンドを実行すると、次のようなプロンプトが表示されます：

   ? Choose installation type:
   demo <
   production
    

5. ご希望のインストール方法をお選びください。 マルチノードクラスタの場合、サポートされているのは production インストールタイプのみです。

   移行が正常に完了すると、次のような確認メッセージが表示されます：

   
      ╭──────────────────────────────────────────────╮ 
      │                                              │ 
      │ Migration completed successfully!            │ 
      │ You can now install Instana Standard Edition.│ 
      │                                              │ 
      ╰──────────────────────────────────────────────╯ 
      

6. 以前のホストから移行したテナント単位の設定データを使用して、 Standard Edition をインストールします。 詳細については、 「オンライン環境での Standard Edition のインストール」 または 「エアギャップ環境での Standard Edition のインストール」 を参照してください。

   注： カスタム証明書、SMTP設定、プロキシ、その他の設定など、追加の設定を行う場合は、『 Instana 』のバックエンド設定を参照してください。 この stanctl up コマンドでは、設定フラグを使用できます。

インストールが正常に完了すると、次のようなメッセージが表示されます：

*****************************************************************
* Successfully installed Instana Self-Hosted Standard Edition! *
*                                                               *
* URL: https://instana.example.com                              *
* Username: admin@instana.local                                 *
*****************************************************************
 

従来のClassic Edition 環境で使用していたのと同じテナントパスワードを使用して、新しい Standard Edition UIにサインインできます。

必要に応じて、以前のホストで行っていた設定の一部をやり直す必要があるかもしれません。 以下のリストにあるように設定を変更することができます：

• 新しい Standard Edition インスタンスは、デフォルトではどのエージェントにも接続されていません。 エージェントを新旧のバックエンドに接続するには、 「複数のバックエンドの設定」を参照してください。

• 移行後、新旧両方の環境がエージェントに接続されると、 Instana の環境の両方からアラートが生成されます。 アラートの重複を防ぐために、 Instana インスタンスのいずれかにメンテナンスウィンドウを設定することができます。 詳細については、 「メンテナンス期間のスケジュール設定」 を参照してください。

• 以前の環境で有効にされていたフィーチャーフラグは移行されません。 新しい環境では、機能フラグを手動で再度有効にする必要があります。 詳細については、 「オプション機能」 を参照してください。

• Classic Edition から Standard Edition へ移行すると、エージェント、UI、 API のトラフィックを含むすべてのIngressトラフィックは、単一のドメイン（ベースドメイン）で処理されるようになります。 この機能はデフォルトで有効になっています。 この動作を元に戻すには、移行が完了した後、次のコマンドを実行してください：

  stanctl backend apply \
  --core-use-tu-url-path=false \
  --core-acceptors-agent-host=<desired-agent-acceptor-domain> \
  --core-acceptors-agent-port=<desired-agent-acceptor-port>
   

2つの Instana バックエンドへの同時レポート送信には、以下の制限が適用されます：

• Instana エージェントの Kubernetes センサーは、2つの Instana バックエンド構成をサポートしていません。 Kubernetes の監視については、「複数のバックエンドへのレポート」 を参照してください。
• EUM（エンドユーザー監視）クライアントは、2つの Instana バックエンドへのレポート送信に対応していません。
• サーバーレスのクライアント実装では、2つの Instana バックエンドへのレポート送信はサポートされていません。
• 移行後に変更された設定は、2つの Instana バックエンド間で自動的に同期されません。

移行後に問題が発生する可能性があります。 これらの問題が解決しない場合は、 IBM サポートまでお問い合わせください。