次の方法で共有

パッケージ アプリケーションの問題のトラブルシューティング

注

コミュニティの関心グループが Yammer から Microsoft Viva Engage に移行されました。 Viva Engage コミュニティに参加し、最新のディスカッションに参加するには、「 Finance and Operations Viva Engage Community へのアクセスを要求する 」フォームに入力し、参加するコミュニティを選択します。

この記事は、階層 1 または階層 2 から階層 5 の環境でパッケージを適用するときに発生する可能性がある問題のトラブルシューティングに役立ちます。 パッケージの適用方法の詳細については、クラウド環境への更新の適用を参照してください。

一般的なトラブルシューティングと診断

パッケージが正常に適用されていない場合は、2 つのオプションがあります。

  • 失敗した操作を再試行します。
  • ログを使用します。

失敗した操作の再試行

パッケージ アプリケーションが失敗した場合で、操作を再実行したい場合は、再開を選択してください。

ログの使用

パッケージ アプリケーションが失敗し、ログを使用する場合は、次の手順に従います。

  1. ログ ファイルをダウンロードして解凍します。

  2. AOS や BI など、ステップが失敗したロールを選択します。

  3. ステップが失敗した場合は仮想マシン (VM) を選択します。 この情報は 環境の更新 セクションの コンピューター名 列で見つけることができます。

  4. VM ログで、問題が発生したステップに対応するフォルダーを選択します。 フォルダー名は、各フォルダーが対応するステップを識別します。

    たとえば、この手順の過程で問題が発生した場合は、 ExecuteRunbook フォルダーを選択します。 ステップ番号は、GUID（グローバル一意識別子）の後に強調表示されている番号です。

パッケージ アプリケーションの問題

問題: 適用したパッケージが無効です

説明

適用したパッケージが有効でないため、サービスの状態は [失敗] です。 [ 環境の更新] セクションには、更新プログラムは一覧表示されません。 パッケージが有効かどうかを確認するには、次の手順に従います。

  1. ログをダウンロードして解凍します。

  2. アプリケーション オブジェクト サーバー (AOS) マシンのログに移動します。

  3. DownloadFilesAndSlipstreamTools-xxx フォルダーと GenerateRunbook-xxx フォルダーが存在することを確認します。

  4. GenerateRunbook-xxx フォルダーを開き、出力の種類のファイルを開きます。

    ファイルが見つからないか、Runbook のステップを生成できなかったことを示すエラー メッセージまたは例外が見つかると、パッケージは有効ではありません。

操作

現在のパッケージを取り消すには、[ 中止] を選択します。 新しいパッケージをアップロードし、サービス フローを再起動します。

問題: 失敗したステップはありませんが、パッケージの展開に失敗します

説明

パッケージをマシンにダウンロードすると、タイムアウトが発生します。 サービスの準備段階では、このプロセスは Runbook の手順を行う前にいくつかの準備手順を完了します。 事前サービスの一環として、プロセスはすべてのマシンにパッケージをダウンロードする必要があります。 ダウンロードする時間は、環境が存在するデータ センターによって若干異なる場合があります。 30 分以内に発生しないダウンロードは、サービスの状態の障害と見なされ、停止します。

操作

  1. 再開 を選択し、問題を解決することができるかどうかを確認します。 この手順で動作しない場合は、手順 2 に進みます。
  2. ログを環境ページからダウンロードします。
  3. すべてのマシンでパッケージのダウンロードに、 DownloadFilesAndSlipstreamTools フォルダーを含むログがあることを確認します。
  4. ログ ファイルを確認します。 ログ ファイルの末尾に次のテキストが表示されない場合は、パッケージのダウンロードが完了していないために問題が発生しました:"ファイルのダウンロードとスリップストリームが正常に完了しました"。

問題: 失敗したステップはありませんが、パッケージの展開に失敗します

説明

このプロセスには、パッケージをダウンロードするための十分なディスク領域がありません。 すべてのマシンを確認します。 この問題は、マシンのサービス ドライブがいっぱいの場合に発生します。

この状況で [再開 ] を選択した場合、問題は解決されません。

スペースの問題が原因でデプロイが失敗したことを確認するには、次の手順に従います。

  1. DownloadFilesAndSlipstreamTools-xxx フォルダーに移動します。
  2. 出力ファイルを開き、エラー メッセージを確認して、領域の問題が原因でステップが失敗したかどうかを確認します。

操作

トポロジの自動クリーンアップの一環として、システムは 30 日を超える %ServiceVolume%\DeployablePackages 内の展開可能なパッケージを削除します。 システムは、サービス関連のログを削除するために同じタイムラインを使用します。 これらのログは通常、 C:\Dynamicsにあります。

ただし、開発用または 1 箱型のマシンでは、柔軟性が高くなります。 保持日数と ServiceVolume ドライブとログ ドライブの最小ディスク領域をカスタマイズできます。

  • HKLM:\SOFTWARE\Microsoft\Dynamics\Deployment レジストリ キーの下に次のキーを作成して、クリーンアップを行うタイミングをカスタマイズします。 自動クリーンアップ タスクでは、これらの値が考慮されます。

    • CutoffDaysForCleanup - 古いパッケージとログが保持される日数。 既定値は 30 です。
    • CutoffDiskSpaceLimitForPackages - パッケージ フォルダーがあるサービス ボリューム ドライブ上 (ギガバイト単位 [GB]) の最小空きディスク容量。 たとえば、ディスク領域が 200 GB の場合、クリーンアップ タスクは日数に基づいてパッケージを削除します。
    • CutoffDiskSpaceLimitForLogs - ログのフォルダーがあるシステム ドライブの最小空きディスク容量 (GB 単位)。 たとえば、ディスク領域が 100 GB の場合、クリーンアップ タスクは日数に基づいてサービス関連のログを削除します。

問題: ステップがエラーで失敗しました

説明

ステップは、次のいずれかの理由により、エラーで失敗する可能性があります。

  • パッケージにカスタマイズの問題がある、または依存関係がありません。
  • サービス スクリプトに問題があります。
  • ステップの実行時にランダムエラーが発生しました。

問題を確認するには、次の手順に従います。

  1. ステップ ログをダウンロードして参照します。
  2. ステップの出力ファイルを開き、エラーがないか確認します。
  3. 追加のログファイルがある場合は、それらをエラーの有無について調査します。

操作

  1. ログをダウンロードします。
  2. ステップの再実行 を選択し、失敗したステップを再試行します。

ステップが再度失敗し、同じエラーが発生した場合は、ログに戻り、詳細情報を確認します。

  • カスタマイズに問題がある場合は、このパッケージをキャンセルし、新しいパッケージを使用して再試行してください。
  • 問題の修正プログラムが問題検索で利用できるかどうかを確認します。
  • 次の手順の失敗が表示された場合は、データベース同期の問題が発生している可能性、またはレポート展開に失敗した可能性のいずれかです "サービス モデルの GlobalUpdate スクリプト: AOSService"
  • DBSync.err ファイルを探し、エラーの内容を確認します。 DBSync.log ファイルを検査します。 DB 同期手順中の特定のエラーについては、「 一般的なデータベース同期の問題 」セクションを参照してください。

問題: 展開状況は「サービス中」ですが、サービス状況は「失敗」です。

説明

組み込みのメカニズムにより、システムは放棄する前に何度も再試行します。 システムは、次の準備手順を複数回再試行できます。

  • マシンにパッケージをダウンロードします。
  • サービス パッケージをスリップ ストリームします。
  • Runbook の生成

操作

ログをダウンロードしてエラーを表示し、すべての再試行が終了する前にアクションを実行します。 再試行の仕組みが準備段階を超えない場合、失敗のステータスが表示された場合は、チケットを開いて Microsoft チームが問題をさらに調査できるようにします。

問題: パッケージの展開が完了した後にダッシュボードが開きません

説明

パッケージのデプロイが完了した後にダッシュボードが開かない場合は、AOS マシンの起動時に実行時エラーが発生する可能性があります。

操作

  1. イベント ビューアーを起動します。
  2. Applications and Services Logs>Microsoft>Dynamics>Ax-SystemRuntime>Operational Filter by errors に移動します。 エラーがあるかどうかを確認し、必要に応じてエラーを調査します。

問題: パッケージ アプリケーションがエラー コードで失敗しました: DSU

説明

要求の処理中に重要なコンポーネントでエラーが発生したことを示すエラー メッセージが表示される場合があります。エラー コード: DSU #####、または同様のメッセージ。 エラー コード DSU ##### は、 基になる Microsoft API の一時的な停止を示します。 この種の停止は、データベースの移動機能にも影響する可能性があります。

操作

Microsoft はサービスの状態を事前に監視しており、この種の停止を間もなく解決する予定です。

この停止は、環境の状態や正常性には影響しません。

サービス要求をスケジュールするとき、またはデータベース移動タスクを実行するときにこのエラーが表示される場合は、後でもう一度やり直してください。

一般的なデータベース同期の問題

次の手順の失敗が表示された場合は、データベース同期の問題が発生している可能性があります: "サービス モデルの GlobalUpdate スクリプト: AOSService"

DBSync.err ファイルを検索し、エラーを検出し、および DBSync.log ファイルを検査するには、これらの手順に従います。

  1. ステップ ログをダウンロードして参照します。

  2. ステップの出力ファイルを開き、エラーがないか確認します。

  3. 追加のログ ファイルがある場合は、エラーのログを検査します。

  4. 次のテーブルは、最も頻繁に表示されるエラーと、実行する必要のあるアクションを示しています。 問題列には、dbsync.err ファイルに表示されるエラー メッセージが表示されます。 パーセント記号 (%) は、テーブル、フィールド、インデックスなどのメタデータの名前に置き換えできます。

    問題 アクション
    % テーブルでテーブル同期に失敗しました % 一意のインデックスを作成します % この問題は通常、ユニークなインデックスが作成されたが、データが一意でない場合に発生します。 手順をもう一度実行する前に、データを修正します。
    % アプリケーション構成の同期に失敗しました。% カスタム アクションの同期がエラーにより失敗しました。% エラー メッセージと呼び出し履歴の情報を表示して、問題の原因となっているアプリケーション コードを特定します。
    %基になるクエリのテーブルから見つけることができません% この問題は修正されました。 詳細については、KB 4018815を参照してください。
    %テーブルの同期が失敗しました%フィールドの変換中% エラー メッセージに従って、問題を修正し、ステップを再度実行します。
    % 1 つ以上のオブジェクトがこの列にアクセスしているため失敗しました % インデックスがメタデータにあるかどうかを確認します。 インデックスがメタデータ内にある場合は、この問題は SyncEngine 製品問題です。 インデックスがメタデータにない場合、ステップを再度実行する前に、SQL データベースからインデックスを削除します。
    %基になるデータ ソースのテーブルから見つけることができません% この問題は修正されました。 詳細については、KB 4018815を参照してください。
    '%テーブル同期がテーブルで失敗しました%' および errorMessage like '%すでに名前が付けられたオブジェクトが存在します%' 内部 SqlDictionary テーブルおよび SQL スキーマが同期されていません。この状態に到達する方法を理解するのに十分な情報がログにありません。
    % テーブルでテーブル同期が失敗しました % 各テーブルの列名は一意である必要があります % テーブルの SqlDictionary エントリが破損しており、フィールドがありません。 この状態にどのように達したかを理解するには、ログに十分な情報がありません。
    %Column 名前 'LOAD_' がターゲット テーブルまたはビューに存在しません。 インデックスの作成% この問題は、SyncEngine の問題のようです。 Microsoft サポートにチケットを作成します。
    インデックス 'VENDREQUESTPROFILEQUESTIONNAIRE.I_1301PROFILEQUESTIONNAIRE' を削除できません。存在しないか、アクセス許可がありません。 この問題は、SyncEngine の問題のようです。 Microsoft サポートにチケットを作成します。
    %The インデックス 'I_65750INDEX1' の長さ 2,046 バイトのインデックス エントリが、非クラスター化インデックスの最大長 1,700 バイトを超えています% 手順をもう一度実行する前に、インデックスを変更します。
    % 付近に正しくない構文があります % この問題は、SyncEngine の問題です。 Microsoft サポートにチケットを作成します。
    'TEMPDB.DBO.T_TRVREQUISITIONLINE_C4C3569DD5A14CDABAE71A341743FB61' というデータベースやサーバーの参照は、このバージョンの SQL Server ではサポートされていません。 この問題は、SyncEngine の問題です。 Microsoft サポートにチケットを作成します。
    % エラー: タイムアウトが発生しました。 pool.% から接続を取得するまでに経過したタイムアウト時間。 ステップを再試行します。
    データベースの実行に失敗しました: 'DEFAULTDIMENSION' は無効な列名です。 ビューを作成 この問題は、SyncEngine の問題のようです。 Microsoft サポートにチケットを作成します。
    データベースの実行に失敗しました: 'PMBI_DEPROJECTTIMESHEET' は無効なオブジェクト名です。 ビューの作成 この問題は、SyncEngine の問題のようです。 Microsoft サポートにチケットを作成します。
    %provider: 名前付きパイプ プロバイダー、エラー: 40 - SQL Server% への接続を開くことができませんでした この問題は、プラットフォーム更新プログラム 3 で修正する必要があります。 ステップを再試行します。
  • Last updated on