オンプレミス展開への更新プログラムの適用

[アーティクル]
03/23/2023

この記事では、Dynamics 365 Finance + Operations (on-premises) にサポートされている更新プログラムを適用する方法について説明します。設置型環境でのすべての更新は Microsoft Dynamics Lifecycle Services (LCS) を通じて行われます。

更新プログラムの検索とダウンロード

オンプレミス環境に適用できる更新プログラムを検索する方法の詳細については、Lifecycle Services (LCS) での問題検索を参照してください。 LCS の環境の詳細ページの更新セクションで、タイルから更新プログラムをダウンロードする方法の詳細については、Lifecycle Services (LCS) から更新プログラムをダウンロードを参照してください。

メモ

オンプレミス環境を更新するときは、常に環境詳細ページの更新タイルから更新プログラムを選択します。別の場所からの更新を選択した場合、更新が機能しない場合があります。

オンプレミス配置の更新

展開中または展開の完了後のいずれかのオンプレミス環境に対して、更新プログラムを適用することができます。

オンプレミス環境が展開されているときは、カスタムパッケージの展開を詳細設定で選択することができます。カスタマイズまたはアプリケーション X++ の更新を適用する方法の詳細については、カスタムモデルの開発とオンプレミス環境への配置を参照してください。

オンプレミス環境の展開後にオンプレミス環境に更新を適用するには、環境の 環境の詳細 ページにある管理で 更新プログラムを適用 を選択します。

メモ

財務と運用のプラットフォーム更新プログラム 12 以降の環境でのみ、展開後に更新プログラムを適用することができます。環境には、LCS で使用可能なローカルエージェントの最新バージョンも必要です。詳細については、「ローカルエージェントの更新」を参照してください。プラットフォーム更新プログラム 12 よりも古いプラットフォームのバージョンを使用している場合は、すでに展開されている環境を再構成して、カスタマイズを更新したり、最新のプラットフォームリリースに更新したりすることができます。環境を再配置する方法の詳細については、オンプレミス環境の再配置を参照してください。

アプリケーションまたは LCS を通じてバイナリ更新プログラムを適用します

次の手順を使用すると、X++、すべてのバイナリ、またはプラットフォームバイナリの更新プログラムを適用できます。

重要

更新のアプリケーションには、環境のダウンタイムが必要です。したがって、更新中に環境内でビジネストランザクションを実行することはできません。次の手順を完了したら、システムが使用されていないことと、公式ダウンタイム通知システムがすべてのシステムユーザーに通知済みであることを確認します。

重要

最新のプラットフォームに移動するには、常に、環境詳細ページのプラットフォームバイナリ更新プログラムタイルからプラットフォーム更新プログラムを選択します。別の場所からの更新を選択した場合、更新が機能しない場合があります。

前提条件

開始する前に、Management Reporter (MR)、Microsoft Dynamics AX、および Microsoft SQL Server Reporting Services (SSRS データベース) の完全バックアップを完了してください。コードは LCS を通じて復元されますが、データが失われないよう保証するためにデータベースを手動で復元する必要があります。
環境をプラットフォーム更新プログラム 12 の最新ビルドに更新します。
ローカルエージェントを最新バージョンに更新します。詳細については、「ローカルエージェントの更新」を参照してください。
更新のタイプに応じて、以下の手順を実行して配置可能パッケージを生成します。
- プラットフォームバイナリ更新プログラム – Lifecycle Services (LCS) から更新プログラムをダウンロードの手順に従って、LCS のアセットライブラリに直接更新プログラムをダウンロードまたは保存します。
- アプリケーションバイナリ更新プログラム – Lifecycle Services (LCS) から更新プログラムをダウンロードの手順に従って、LCS のアセットライブラリに直接更新プログラムをダウンロードまたは保存します。
- アプリケーションの X++ 更新 – 開発環境に必要な修正プログラムをダウンロードし、配置可能なモデルパッケージの作成の手順に従います。
- カスタマイズ – カスタムモデルの開発とオンプレミス環境への配置の手順に従います。

サンドボックス環境の更新

LCS アセットライブラリで、この記事の「前提条件」のセクションで生成された配置可能パッケージを、ソフトウェア配置可能パッケージ タブにアップロードします。
LCS で、オンプレミスの実装プロジェクト開き、更新する環境の環境の詳細ページを開きます。
管理で、更新プログラムを適用 を選択します。スライダーでは、アセットライブラリにアップロードされた更新を表示します。アセットライブラリで有効としてマークされているパッケージのみが表示されることに注意してください。

ローカルエージェントのバージョン 2.1.0 以上を使用している場合は、以下の手順を実行する必要があります。

更新プログラムを選択し、準備をクリックします。準備をクリックすると、サービスのオンプレミス環境を準備します。

メモ

準備中、環境の状態は配置済みになりますが、配置ステータスフィールドは、準備の進行状況を表示します。パッケージを書式設定しパッケージをダウンロードするなどの手順は、準備中に実行されます。環境は準備中に直接触れられないため、準備フェーズ中にダウンタイムは発生しません。ユーザーは、準備時にシステムをそのまま使用できます。
準備が完了すると、中止および環境の更新ボタンが表示されます。更新プログラムの適用を開始するには、更新の環境をクリックします。準備が失敗した場合は、この記事の後半にある「失敗した更新アプリケーションを解決する」を参照してください。
確認メッセージではいを選択します。この環境でサービス操作が開始されました。これは環境のダウンタイムの先頭です。
環境の状態は、配置済みから配置中に変更されます。
更新が完了すると、環境状態は展開に戻されます。更新プログラムの適用に失敗したとき、環境状態は失敗に変更されます。パッケージアプリケーションが失敗する場合に行う操作の詳細については、この記事で後述の「更新が失敗したアプリケーションを解決する」セクションを参照してください。
環境で実行された操作を表示するには、履歴および環境の詳細ページを開きます。展開、サービス、およびロールバックなど、環境で実行された主要なアクションのレコードを表示することもできます。

ローカルエージェントのバージョン 2.1.0 未満を使用している場合は、以下の手順を実行する必要があります。

更新プログラムを選択し、適用をクリックします。
確認メッセージではいを選択します。この環境でサービス操作が開始されました。これは環境のダウンタイムの先頭です。
環境の状態が配置済みから準備に変更します。

メモ

準備中、パッケージを書式設定しパッケージをダウンロードするなどの手順は、準備中に実行されます。環境は準備中に直接触れられないため、準備フェーズ中にダウンタイムは発生しません。ユーザーは、準備時にシステムをそのまま使用できます。ただし、環境が準備状態になったときに、ダウンタイムが開始されることをお勧めします。
準備が完了したら、環境の状態は準備中から配置中に変更されます。
更新が完了すると、環境状態は展開に戻されます。更新プログラムの適用に失敗したとき、環境状態は失敗に変更されます。パッケージアプリケーションが失敗する場合に行う操作の詳細については、この記事で後述の「更新が失敗したアプリケーションを解決する」セクションを参照してください。
環境で実行された操作を表示するには、履歴および環境の詳細ページを開きます。展開、サービス、およびロールバックなど、環境で実行された主要なアクションのレコードを表示することもできます。

運用環境の更新

運用環境を更新する前に、サンドボックス環境でパッケージアプリケーションの更新を正常に完了する必要があります。

パッケージを適用しているサンドボックス環境のプロジェクトで、アセットライブラリを開いてから、ソフトウェア配置可能パッケージ タブでパッケージを選択し、リリース候補としてマークします。
環境の詳細ページで、メンテナンスの下にある、更新プログラムの適用を選択します。ダイアログボックスでは、リリース候補としてマークされたパッケージのみ表示されます。
運用環境に適用されるリリース候補パッケージを選択します。
更新フローの残りの部分は、サンドボックス環境と同じです。更新エクスペリエンスは、使用している環境で実行されているローカルエージェントのバージョンによって異なります。常に最新バージョンで実行することをお勧めします。

更新が失敗したアプリケーションを解決

準備が失敗すると、環境の状態が 配置済み となります。更新プログラムの適用に失敗したとき、環境状態は失敗です。最初の手順でエラーが発生した理由を特定します。ログの場所は、エラーが発生したステージによって異なります。

準備段階:準備段階で操作が失敗すると、ログが LCS にアップロードされます。ログファイルで、ログをダウンロードを選択してログファイルをダウンロードします。パッケージに結合の問題があった場合、エラーがログファイルに含まれます。
配置ステージ:配置ステージで操作が失敗すると、ログはオンプレミス環境にあります。この環境にサインインした後、ログとイベントビューアーにアクセスする必要があります。

トラブルシューティングログの使用方法の詳細については、オンプレミスの配置のトラブルシューティングを参照してください。

ログを確認しエラーの原因を特定すると、次のいずれかの操作を実行して環境を正常な状態に復元します。失敗状態の環境で実行できるアクションはありません。まず、環境を正常な状態に戻す必要があります。

失敗した操作の再試行 – アプリケーションの更新に失敗した場合は、再試行 を選択し、失敗した操作から復旧させます。
失敗した操作の中止 – オンプレミス環境に変更がないため、準備が失敗した場合、操作をキャンセルするオプションがあります。中止を選択して準備をキャンセルします。
更新をロールバック – 失敗した更新をロールバックするには、ロールバックを選択します。ロールバックを開始する前に、最新の問題のない状態にデータベースを復元する必要があります。 ロールバック を選択すると、環境は最後の正常な状態に復元されます。環境の状態は、準備に変更され、次に 配置中 に変更され、次に 配置済み または失敗に変更されます。

メモ

ロールバック ボタンは、データベースをロールバックしません。ユーザーは、更新プログラムの適用の前に行ったと分かっている最後のバックアップに、データベースを復元する責任があります。このステップは、データの損失がないことを保証するために重要です。
状態の更新 – 準備段階で更新アプリケーションが失敗すると、障害は LCS 側にあり、更新アプリケーションはまだ起動していません。したがって、オンプレミス環境は良好な状態です。 LCS 環境の状態を Deployed に戻すには、プロジェクトダッシュボードページで更新を選択します。
環境の削除と再配置 - 再試行とロールバックのオプションが機能しない場合は、環境を削除して再配置する必要があります。環境を削除するには、[プロジェクトダッシュボード] ページで削除を選択します。次に、環境を構成するオプションを表示します。

重要

このオプションは運用環境では使用しないでください。ただし、環境を正常な状態に復元するサンドボックス環境で使用できます。

このオプションは環境を新規に配置することを必要とするため、以前に適用された更新は失われます。カスタマイズおよびバイナリ更新プログラムは、環境に再適用される必要があります。