CAPI からパターンへの移行:CAPI ベースのクラウドディスカバリーからパターンベースのクラウドディスカバリーへの切り替え手順Summaryこの記事では、特定のクラウドディスカバリーに使用する方法を Cloud API プローブ (CAPI) から新しいパターンベースのディスカバリーに変えるための移行プロセスについて説明します。 現在、これは Amazon Web Services (AWS) ディスカバリーと Azure ディスカバリーで使用できます。Releaseこの CAPI からパターンへの移行プロセスは、次のお客様に対してのみサポートされています。 Parisリリース以降を使用している。ディスカバリープラグインまたはクラウド管理プラグインがインストールされている。以下のバージョンのディスカバリーおよびサービスマッピングパターンストアアプリケーションがインストールされている。 Amazon Web Services (AWS):バージョン 1.0.66 以降。Azure: バージョン1.0.71 以降。 Instructionsこの移行プロセスでは次のことを行います。 特定のクラウド環境に対する適切な CAPI ステップを無効にして、クラウドディスカバリー中にトリガーされないようにします。今後のクラウドディスカバリーを実行するために使用される特定のクラウド環境に対する適切なクラウドパターンを有効にします。 この移行を UI を使用して実行する手順は次のとおりです 1.[パターンデザイナー] -> [CPG をパターンに移行] に移動します。 (一部の古いインスタンスリリースのメニューは [パターンデザイナー] -> [CAPI をパターンに移行 (Migrate CAPI to Pattern)] です。) 2.ロードされると、最初の UI ページは次のようになります。 3.ステップ 1 (Step One) で [前提条件チェックを実行] ボタンをクリックすると、前提条件スクリプトがトリガーされ、環境で移行を実行する準備ができていることを確認し、どの移行を実行できるかもチェックできます。 この前提条件プロセスの詳細については、後述の「前提条件」セクションを参照してください。 4.前提条件チェックの実行後、これが正常に完了すると、次のようにスキャン合格 (scan PASSED) メッセージが表示されます。 これは、スキャンが正常に完了したことを意味します。この前提条件チェックのログレコードへのリンクもあり、次のような probe_to_pattern_log レコードを参照します。 注意 : スキャンが正常に完了しなかった場合は、前提条件スキャンが失敗しました (Prerequisite scan FAILED) というメッセージが表示され、ログに失敗の原因が記録されます。詳細については、後述の「トラブルシューティング」セクションを参照してください。 5.前提条件スキャンが完了すると、ステップ 2 (Step Two) セクションも表示されます。 表示される各ボタンは、指定されたクラウドタイプの対応する移行をトリガーします。(すべての移行を順番にトリガーする [すべて移行 (Migrate ALL)] ボタンを除く。) 6.ボタンを選択すると、顧客が選択した移行を実行するかどうかを確認するポップアップ ウィンドウが表示されます。 [OK] ボタンを選択すると、移行が開始されます。これにより、それぞれの移行ボタンがグレー表示され、移行が実行中であることが示されます。また、ログレコードに移行が処理中と表示されます。 7移行が完了すると、移行合格 (migration PASSED)メッセージが表示され、ログのステータスに完了 (Completed) と記載されます。 Related Links前提条件 CAPI からパターンへの移行を開始する前に、いくつかの前提条件を満たす必要があります。 この [前提条件チェックを実行] では、これらの前提条件チェックを実行し、CAPI からパターンに変換する前に対処する必要がある問題を特定するのに役立ちます。 このプロセスでは、以下をチェックします。 インスタンスに、ディスカバリープラグインを保有し、Paris 以降のリリースを使用しているお客様向けにインストールされている適切なスクリプトインクルードがあることを確認します。現在の CAPI スクリプトをチェックして、それらが存在することを確認し、どのスクリプトがすでに無効になっている可能性があるかもチェックします。ディスカバリーおよびサービスマッピングパターンストア アプリケーションからインストールする必要がある新しいパターンが存在するかどうか、また、これらのパターンのいずれかがすでにアクティブであるかどうかもチェックします。 これらのチェックにすべて合格すると、CAPI 移行前提条件チェックの probe_to_pattern_log レコードに次のような結果が表示されます。 これらのチェックのいずれかが失敗した場合や警告メッセージが表示された場合は、以下の「トラブルシューティング」セクションを確認して、これらの問題に対処する方法を確認してください。前提条件チェック失敗後は、前提条件スキャンを再度実行し、成功するまで [移行] ボタンが表示されません。 既知の問題 ディスカバリーおよびサービスマッピングパターンアプリケーションをバージョン 1.0.71-74 にアップグレードすると、Azure Cloud Events が米国西部のデータセンターとの関係を作成するという既知の問題があります。これは PRB1478229 で対処されています。 トラブルシューティング 1.前提条件の結果 前提条件チェックに関して、UI ページや probe_to_pattern_log レコードに表示されるメッセージの一部を以下に示します。 A.前提条件スキャンが失敗しました (Prerequisite scan FAILED) 理由:これは主に、CAPI からパターンへの移行プロセスの一環として必要なスクリプトインクルードレコードが不足しているか非アクティブである場合、またはアクティブな同じ名前の重複レコードがある場合に発生します。 この前提条件スクリプトがチェックするスクリプトインクルードファイルについては、以下のリストを参照してください。 DiscoveryPatternOrchestratorEventHandler (sys_id:4eea4e860f3580106dc4fe39b4767ef3)DiscoveryPatternOrchestratorFlowLauncher (sys_id: b0b205820ff180106dc4fe39b4767e4b)DiscoveryPatternOrchestratorFlowManager (sys_id: baf9b6b00f9040106dc4fe39b4767e5e)DiscoveryPatternOrchestratorUtil (sys_id: 9c3d828a0f3580106dc4fe39b4767eb1)PatternPayloadUtil (sys_id: c9f7ed010ff140106dc4fe39b4767ec8)DiscoveryPageManager (sys_id: 5b5dbf100f2700106dc4fe39b4767e17)AbstractDiscoveryMigrationHelper (sys_id: 650e9815dbee3300ef28f3e51d961972)DiscoveryAwsMigrationHelper (sys_id: c1865899dbae3300ef28f3e51d961966)DiscoveryAzureMigrationHelper (sys_id: 7b8f5895dbee3300ef28f3e51d961966) 解決策: probe_to_pattern_log レコードを調べて、どのスクリプトインクルードがこのエラーの原因となっているかを確認し、それに応じて対処します。 B.前提条件スキャンに合格しましたが、一部のパターンや CAPI スクリプトが不足している可能性があります (Prerequisite scan PASSED, but some patterns and/or CAPI scripts may be missing) 理由: これは主に、CAPI からパターンへの移行プロセスの一環として必要とされるパターンや CAPI スクリプトレコードが不足している場合に発生します。probe_to_pattern_log レコードでは、これが発生すると警告メッセージが 1 つ以上表示されます。 解決策: 前提条件チェックは合格するはずですが、probe_to_pattern ログの結果をチェックして、どのパターンまたは CAPI スクリプトが不足しているのかを確認することをお勧めします。ご参考までに、パターンレコードは [sa_pattern] テーブルに、CAPI スクリプトは [sn_cmp_rb_op_impl_step] テーブルに存在する必要があります。 C.別の名前のパターンレコードが見つかりました (Found pattern record with different name) 理由: これは、sys_id に基づいて検索しているパターンが見つかったが、名前の値が異なる場合に発生します。 解決策:前提条件チェックには合格するはずですが、どのパターンの名前が変更されたのか、なぜ変更されたのかを確認することをお勧めします。 D.パターンはすでにアクティブです、CAPI ステップはすでに無効です (Pattern already active, CAPI step already disabled) 理由: これは、チェック対象のパターンがすでにアクティブ化されている場合、またはチェック対象の CAPI ステップがすでに無効になっている場合に発生します。 解決策:前提条件チェックには合格するはずで、有効にするパターンレコードが少なくとも 1 つ、または無効にする CAPI ステップが少なくとも 1 つある限り、移行を実行できるはずです。 チェック対象のパターンがすべてすでにアクティブで、チェック対象の CAPI ステップがすべてすでに無効になっている場合、特定のクラウドタイプの [移行] ボタンは表示されません。 2.移行結果 クラウド移行に関して、UI ページや probe_to_pattern_log レコードに表示されるメッセージの一部を以下に示します。 A. 移行が失敗しました (migration FAILED)、または移行実行中に移行が停止しました (5 分超) (migration stalled in migration running (>5 minutes)) 理由: これは、移行の実行中に何か問題が発生した場合、またはこの挙動が発生するような変更が何かに加えられた場合にのみ発生します。 解決策:可能であれば、移行を再試行します。(場合により、UI ページを再読み込みし、前提条件チェックを再度実行する必要があります。) 問題が解決しない場合は、テクニカルサポートのケースをオープンし、調査してもらってください。 B. 移行はすでに完了しています (Migration has already been completed) 理由:このポップアップウィンドウは、すでに完了している移行を実行しようとしている場合に表示されます。これは、移行がすでに実行された後に、誰かがパターンの 1 つを非アクティブ化するか、いずれかの CAPI ステップを再度有効にした場合に発生する可能性があります。 解決策:この移行を繰り返す必要があるかどうかを確認してから、[OK] をクリックして続行するか、[キャンセル] をクリックしてこの移行を再度実行しないようにします。 C. 移行はすでに処理中です (Migration is already in progress) 理由:これは、現在実行中の移行がすでにあるクラウドタイプに対して移行を実行しようとしている場合に表示されます。 解決策 : 現在実行中の移行を引き続き監視して、移行が完了するかどうか、いつ完了するかを確認します。 数分経っても移行が完了しない場合は、テクニカルサポートのケースをオープンし、調査してもらってください。 D.移行はまだ処理中です (Migrations are still in progress) 理由:これは、あるクラウドタイプに対する移行を実行する際に、異なるクラウドタイプに対して別の移行が実行されている場合に、確認のために表示される可能性があるポップアップウィンドウです。 解決策:複数の移行を同時に実行することはお勧めしませんが、このポップアップウィンドウでは必要に応じてそれを実行できる選択肢を提供します。