Standard 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 データストアからテナントユニットの構成データを抽出します。 古い Standard Edition ホストで次のコマンドを実行してください：

   stanctl dump config-data

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

2. オプション：フラグ --include-sensitive を設定して、次のダイアログをスキップ ....Do you want to include sensitive information?します。

   機密情報には、SMTPパスワード、プロキシパスワード、およびダウンロードキーが含まれます。

   が --include-sensitive 設定されていない場合、次のダイアログが表示されます。

   This operation may include sensitive information (for example, SMTP credentials, proxy credentials, and download key).
   Do you want to include sensitive information?
   Note: Excluding it will require you to reconfigure SMTP and proxy settings in the destination environment during installation.

3. 以下のステップのいずれかを実行します。
   • バックアップに機密情報を含める場合は、「はい」と入力してください。
   • バックアップから機密情報を除外するには、「いいえ」と入力してください。

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

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

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

5. 新しい 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>
        

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

   Are you migrating from the Classic offering?

7. 「いいえ」と入力すると、元のマルチドメインまたはシングルドメインの設定が維持されます。
   コマンドを実行すると、次のようなプロンプトが表示されます：

   ? Choose installation type:
   demo <
   production
    

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

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

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

9. 以前のホストから移行したテナント単位の設定データを使用して、 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                                 *
*****************************************************************
 

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

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

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

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

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

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

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