カスタム版から Standard Edition への移行

オンラインで編集

カスタムエディションを Standard Edition に移行できます。 移行可能なデータにはテナントユニット構成データが含まれます。 テナントユニット構成データには、ユーザー設定、ダッシュボード、イベント、アラート、アプリケーション視点、EUMウェブサイトおよびモバイルアプリ、その他の data.Focus センチネルが含まれます

以下の項目が移行されます：

  • Email およびSMTP設定：
    • SMTPサーバー（ホスト、ポート）
    • 送信者の E メール・アドレス
    • SSL / TLS の設定
    • SMTPの認証情報（機密データが含まれる場合）
  • プロキシ設定；
    • プロキシサーバー（ホスト、ポート）
    • プロキシを使用しないホスト一覧
    • プロキシの認証情報（機密データが含まれる場合）
  • アクセプタの構成：
    • エージェント受信側（ホスト、ポート）
    • EUM受信側（ホスト、ポート）
    • 合成受容体（ホスト、ポート）
    • サーバーレス・アクセプター（ホスト、ポート）
    • OpAmp 受信側（ホスト、ポート）
    • OTLP HTTP 受信側（ホスト、ポート）
    • OTLP GRPC受信側（ホスト、ポート）
  • 機能フラグ：有効または無効に設定された機能のフラグとその値
  • ドメイン設定：ベースドメインおよびテナントまたはユニット「 URL 」のパス設定
注：Instana エージェントからの分析およびメトリクスデータは移行できません。
注： 重要カスタムエディションのライセンスをそのまま使用して、. Standard Edition NET Framework 6.0 への移行が可能です。

前提条件

オンラインで編集

以下の前提条件が満たされていることを確認してください：

  • 「シングルノード環境の準備」、「 3ノード展開の準備 」、または「 5ノード展開のシステム要件 」に記載されている手順に従って、新しいホストを準備してください。
    • DNS の設定では、古い環境のテナント名とユニット名を使用してください。 テナント名とユニット名はユニットドメイン名の一部であるため、これらの名前は環境 Standard Edition の DNS レコードに存在する必要があります。 これは、 LDAP 認証を使用した Standard Edition ログインにも必要です。 LDAP の設定も移行されるためです。
  • バイナリ stanctl をインストールしてください。 詳細については、 「stanctl コマンドラインツールのインストール」 を参照してください。
  • 古いホストと新しいホストの Instana バックエンドのバージョンが同じであることを確認してください。

手順

オンラインで編集

データを移行するには、次の手順を完了してください：

  1. カスタムエディションのホスト上で、 Postgres データストアからテナントユニット構成データを抽出してください。

    kubectl-instana dump config-data --unit <unitname> --unit-namespace <namespace>

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

    表 1. 抽出パラメータ
    パラメーター 説明
    --unit-namespace ユニット名前空間（デフォルト: instana-units）
    --postgres-namespace 名前空間 (デフォルト: instana-postgres)
    --unit ユニット名（デフォルト： unit0-tenant0 ）
    --include-sensitive このフラグを設定すると、バックアップ設定にSMTPパスワード、プロキシパスワード、およびダウンロードキーが含まれます
    --help 対応しているオプションを確認する

  2. 新しい Standard Edition ホストで、次のいずれかの手順を完了してください：

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

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

    表 2. 移行パラメータ
    パラメーター 使用法 例
    --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 タイプのみがサポートされます。

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

移行後の設定

オンラインで編集

必要に応じて、古いホストで行っていた設定の一部を再設定する必要があるかもしれません。 以下のリストで提案されているように再構成できます：

  • 新しい Standard Edition インスタンスはデフォルトではどのエージェントにも接続されていません。 以下のステップのいずれかを実行します。
    • エージェントを新旧のバックエンドに接続するには、 複数バックエンドの設定を参照してください。
    • エージェントを新しいバックエンドに接続し、既存の DNS レコードを更新して新しい Standard Edition インスタンスを指すようにしてください。 エージェントは自動的に新しいバックエンドへの報告を開始します。

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