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

[アーティクル]
11/19/2024

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

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

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

オンプレミス配置の更新

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

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

展開後にオンプレミス環境にアップデートを適用するには、以下の手順に従います。

Lifecycle Services で、環境の 環境の詳細 ページを開きます。
管理で、更新プログラムを適用 を選択します。

注意

環境には、Lifecycle Services で使用可能なローカルエージェントの最新バージョンも必要です。詳細については、「ローカルエージェントの更新」を参照してください。

Lifecycle Services を通じてプラットフォーム更新パッケージの更新を適用する

次の手順を使用して、プラットフォーム更新プログラムパッケージを適用できます。

重要

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

前提条件

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

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

Lifecycle Services で、オンプレミス実装プロジェクトを開き、プロジェクトメニューで資産ライブラリを選択します。資産ライブラリで、プラットフォーム更新パッケージまたはカスタム展開パッケージがソフトウェア展開パッケージ タブに表示されていることを確認します。
オンプレミスの実装プロジェクト開き、更新する環境の環境の詳細ページを開きます。
管理で、更新プログラムを適用 を選択します。ダイアログボックスでは、資産ライブラリにアップロードされた更新を表示します。アセットライブラリで有効としてマークされているパッケージのみが表示されることに注意してください。
更新を選択し、次に準備を選択して、オンプレミス環境をサービス提供可能な状態にします。

注意

環境がサービス提供の準備中である場合、状態は展開済みとなります。しかし、展開の状況のフィールドには準備の進捗状況が表示されます。準備中には、パッケージのフォーマットやパッケージのダウンロードなどの操作が行われます。

準備中に環境に直接触れることがないため、この時点ではダウンタイムはありません。ユーザーは、準備時にシステムをそのまま使用できます。
準備が完了すると、中止と環境の更新ボタンが表示されます。更新を適用するには、環境の更新を選択します。準備が失敗した場合は、この記事の後半にある失敗した更新アプリケーションを解決するを参照してください。
確認メッセージが表示されたら、はいを選択します。環境に対する整備作業が開始されます。この時点から、環境のダウンタイムが始まります。

環境の状態は、配置済みから配置中に変更されます。

更新が完了すると、環境状態は展開に戻されます。更新プログラムの適用に失敗したとき、環境状態は失敗に変更されます。パッケージアプリケーションが失敗する場合に行う操作の詳細については、この記事で後述する更新が失敗したアプリケーションを解決するセクションを参照してください。

注意

更新中は、データベースが同期され、テーブル定義の変更が更新されます。このアクションは、データベースが大規模な場合、時間がかかる場合があります。また、すべてのレポートが SSRS ノードに再度展開されます。
環境で実行された操作を表示するには、履歴および環境の詳細ページを開きます。展開、サービス、ロールバックなど、環境で実行された主要なアクションのレコードを表示することもできます。

運用環境の更新

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

パッケージを適用しているサンドボックス環境のプロジェクトで、アセットライブラリを開いてから、ソフトウェア配置可能パッケージ タブでパッケージを選択し、リリース候補としてマークします。
環境の詳細ページで、メンテナンスの下にある、更新プログラムの適用を選択します。表示されるダイアログボックスには、リリース候補とマークされたパッケージのみが表示されます。
運用環境に適用するリリース候補パッケージを選択します。

更新フローの残りの部分は、サンドボックス環境と同じです。

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

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

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

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

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

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

メモ

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

重要

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

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

次の方法で共有