ローカルエージェントの更新

[アーティクル]
01/24/2024

この記事では、ローカルエージェントを更新する方法について説明します。ローカルエージェントの最新バージョンはバージョン 3.3.0 で、2024 年 1 月にリリースされました。

重要

準備フェーズが完了した場合でも、サービス操作中にローカルエージェントを更新しないでください。

ローカルエージェントのバージョン	能力	リリース日	有効期限
3.3.0	このバージョンにより、ローカルエージェントにノードタグ管理機能が追加されます。	2024 年 1 月	適用できません
3.2.3	このバージョンではバグが修正され、証明書ローテーション後に config.json を手動で更新する必要がなくなりました。	2023 年 8 月	適用できません
3.2.2	このバージョンでは、パスが長いファイルを含むディレクトリが原因で、ローカルエージェントがワークスペースディレクトリをクリーンアップできないというバグが修正されます。	2023 年 6 月	適用できません
3.2.1	このバージョンでは、ローカルエージェントが Azure Storage からコンポーネントを正しくダウンロードできないという動作が修正されます。 Azure Storage ライブラリをアップグレードします。	2023 年 6 月	適用できません
3.2.0	このバージョンでは、Service Fabric SDK をアップグレードし、Azure Storage ライブラリをアップグレードし、ファイルハッシュ検証を導入します	2023 年 3 月	該当なし
3.1.0	このバージョンでは、Service Fabric SDK をアップグレードし、新しい展開オプションを追加します。	2022 年 6 月	該当なし
3.0.0	このバージョンには、Edge Scale Unit アプリケーションライフサイクル管理のサポートが含まれています。	2021 年 11 月	2023 年 6 月 30 日
2.7.2	このバージョンには、古いアプリケーションバージョンを配置するための修正が含まれています。	2021 年 10 月	2023 年 6 月 30 日
2.7.1	このバージョンでは、新しい展開オプションが導入され、展開オプションによるバグが修正されます。	2021 年 10 月	2023 年 6 月 30 日
2.7.0	10.0.21 以降のバージョンへの展開または更新を有効にします。さらに、このバージョンでは Microsoft SQL Server 2019 と一部のバグ修正プログラムがある環境への配置が有効になります。	2021 年 8 月	2023 年 6 月 30 日
2.6.0	このバージョンは、Service Fabric SDK をアップグレードし、更新状態のバグを修正して、アプリケーションプロビジョニングのタイムアウトを増やします。	2020 年 10 月	2023 年 6 月 30 日
2.5.0	このバージョンは依存関係を更新し、クリーンアップバグを修正します。	2020 年 5 月	2023 年 6 月 30 日
2.4.0	このバージョンでは、展開の問題が修正され、ローカルエージェントのランタイムがアップグレードされます。	2019 年 12 月	2023 年 4 月 30 日
2.3.1	このバージョンでは、一部の環境でのクリーンアップ中に発生する可能性があるオーケストレーションサービスのクラッシュを修正します。プラットフォーム更新プログラム 29 以前のバージョン 10.0.5 を展開するには、FinancialReportingDeployer.exe.config. の自動更新に事前配置スクリプトを使用する必要があります。詳細については、オンプレミス展開のトラブルシューティングを参照してください。	2019 年 9 月	2023 年 4 月 30 日
2.3.0	このバージョンに、配置前スクリプトと配置後スクリプトのサポートが追加されます。	2019 年 8 月	2023 年 4 月 30 日
2.2.0	このバージョンでは、クリーンアップ中にロックされた DLL を修正し、Microsoft 365 でも使用される Active Directory フェデレーションサービス (AD FS) をサポートするための前提条件を有効にします。	2019 年 7 月	2023 年 1 月 31 日
2.1.2	このバージョンには、更新されたAzure依存関係が含まれており、ダウンロードの安定性を向上し、ファイルがダウンロードされた場合に正しく評価するロジックを使用この更新により、ファイルが完全にダウンロードされるという問題が修正されますが、論理上数バイトが不足していると見なされ、ダウンロードに失敗します。	2019 年 7 月	2023 年 1 月 31 日
2.1.1	このバージョンは、ダウンロードが失敗したときに発生する Microsoft Dynamics Lifecycle Services 管理ボタンが利用できない問題を修正します。他の変更には、Azure Storage との通信を改善し TLS 1.2 を有効にする Azure Storage ライブラリの更新を含みます。	2019 年 2 月	2023 年 1 月 31 日
2.1.0	このバージョンでは、準備および更新が 2 つの個別のステップである 2 段階サービスが可能になります。	2018 年 6 月	2023 年 1 月 31 日
2.0.0	このバージョンでは、サービスフローが可能になり、プラットフォーム更新プログラム 12 が展開されます。	2018 年 1 月	2023 年 1 月 31 日
1.1.0	このバージョンでは、正常に展開するための再構成機能と複数モデルのパッケージ展開が有効になり、プラットフォーム更新プログラム 8 および 11 が展開されます。	2017 年 12 月	2023 年 1 月 31 日
1.0.0	このバージョンでは、展開が失敗した場合のために再構成機能が有効になります。	2017 年 10 月	2023 年 1 月 31 日
Null	この初期バージョンでは、Platform update 8 が導入されています。	2017 年 7 月	2023 年 1 月 31 日

ローカルエージェント 3.3.0 の新機能

このバージョンにより、Service Fabric 動的ノードタグを管理するための新しい機能が追加されます。この場合、インフラストラクチャスクリプトのバージョン 2.20.0 に用意されている追加の設定が必要です。

ローカルエージェント 3.2.3 の新機能

このバージョンでは、topology.xml がキャッシュされ、Lifecycle Services から更新されていないバグが修正されます。
証明書のローテーション後に config.json を更新する必要が削除されます。
ローカルエージェントと SQL データベース間の暗号化された通信を実行します。

ローカルエージェント 3.2.2 の新機能

このバージョンでは、パスが長いファイルを含むディレクトリが原因で、ローカルエージェントがワークスペースディレクトリをクリーンアップできないというバグが修正されます。

ローカルエージェント 3.2.1 の新機能

このバージョンでは、ローカルエージェントが Azure Storage からコンポーネントを正しくダウンロードできないという動作が修正されます。
Azure Storage ライブラリをアップグレードします。
7zip 操作のログを追加します。

ローカルエージェント 3.2.0 の新機能

ローカルエージェント 3.2.0 は、新しい Service Fabric Explorer SDK とランタイムを取得します。
このリリースでは、Azure Storage ライブラリも最新バージョンにアップグレードされます。機能を変更する機能は使用できなくなりましたが、カスタマイズ可能な自動再試行機能が追加されました。 Azure Storage ライブラリで再度サポートされた後は、チェックポイントの取り戻すことを検討します。
コンポーネント管理ロジックが改善され、既存のコンポーネントを再ダウンロードしなくなりました。
ファイルハッシュの検証が追加され、コンポーネント店舗のコンポーネントが Lifecycle Services 成果物ストア内のコンポーネントと完全に一致しています。
MSAL ライブラリが、Microsoft Entra ID で認証を行う場合に使用されます。
Service Fabric Explorer の明確なメッセージによって推奨されないローカルエージェントの検出。

重要

このリリースは、8.2+ Service Fabric クラスターとのみ互換性があります。このリリースでは、Lifecycle Services から新しいローカルエージェント構成ファイルをダウンロードする必要があります。

ローカルエージェント 3.1.0 の新機能

ローカルエージェント 3.1.0 は、新しい Service Fabric SDK とランタイムを取得します。
このリリースでは、新しい展開オプションが導入され、環境が Regression Suite Automation Tool (RSAT) で機能するよう構成する必要があると指定することができます。

重要

このリリースは、8.1+ Service Fabric クラスターとのみ互換性があります。

ローカルエージェント 3.0.0 の新機能

ローカルエージェント 3.0.0 には、スケールユニット管理ポータルを通じて Edge Scale Unit のライフサイクルを管理するためのサポートが含まれます。詳細については、分散ハイブリッドトポロジを参照してください。
このリリースでは、Lifecycle Services から最新の変更を取り込むために .NET Framework バージョン 4.8 が必要です。

ローカルエージェント 2.7.2 の新機能

Local agent 2.7.2 では、古いバージョンのアプリケーションの環境が配置に失敗する問題が修正されます。

ローカルエージェント 2.7.1 の新機能

ローカルエージェント 2.7.1では、新しい展開オプションが証明書の証明書失効リストのチェックをスキップするように指定するに導入されます。
このリリースでは、office365AdfsCompatibility deploymentOption が正しく設定されなかった場合のバグに対処します。

ローカルエージェント 2.7.0 の新機能

Local agent 2.7.0 は、10.0.21 以降のリリースを展開または更新する前提条件となるものです。
このリリースを使用すると、環境に固有の配置オプションに対する、限定された一連の配置オプションを指定できます。特に、このリリースでは Microsoft SQL Server 2019 を使用する環境への配置が可能になります。すべての有効なコンフィギュレーションについては、ローカルエージェントの配置コンフィギュレーションを参照してください。
さらに、このリリースは、ローカルエージェントが実行する gMSA アカウントが、一部の証明書のプライベートキーへのアクセス許可を失う問題に対処します。
イベントビューアーが開いている場合でも、LBDTelemetry-Agent アプリケーションを正常に開始できます。

重要

このリリースは、10.0.21 以降のリリースを配置または更新するために使用する必要があります。このリリースでは、Lifecycle Services から新しいローカルエージェント構成ファイルをダウンロードする必要があります。問題が発生した場合は、オンプレミス配置のトラブルシューティングを参照してください。

ローカルエージェント 2.6.0 の新機能

ローカルエージェント 2.6.0 は、新しい Service Fabric SDK とランタイムを取得します。
このリリースでは、環境がダウンロードフェーズでスタックしているときに更新状態がトリガーされた場合、環境を更新せずに、環境が自動的に配置済みに移行するというバグが修正されています。この場合、更新状態は、ダウンロードフェーズを失敗としてマークします。
アプリケーションのプロビジョニングのタイムアウトが増加しました。

重要

このリリースは、7.x Service Fabric クラスターとのみ互換性があります。

ローカルエージェント 2.5.0 の新機能

ローカルエージェント 2.5.0 は、さまざまな依存関係の新しいバージョンを取得します。主な変更点は、Service Fabric と Entity Framework です。
また、このリリースでは、サービスをクリーンアップせずにクリーンアップが失敗した場合、その後の再実行が常にクリーンアップ中に失敗するバグを修正します。

ローカルエージェント 2.4.0 の新機能

ローカルエージェント 2.4.0 では、Lifecycle Services から最新の変更を取り込むために .NET Framework のバージョン 4.7.2 が必要になりました。最新の要件を満たすために、Lifecycle Services で利用可能な最新のインフラストラクチャスクリプトを実行してください。
このリリースでは、ハードコーディングされたタイムアウトのために AXService の展開が遅い環境で失敗する問題も修正されています。

ローカルエージェント 2.3.0 の新機能

ローカルエージェント 2.3.0 は、カスタム実行を有効にします配置前および配置後のスクリプト。
2.2.0 では、以前のプラットフォーム更新プログラムを展開する際に発生する問題が修正されます。
このリリースでは、監視エージェントを削除して LBDTelemetry という新しいサービスを導入し、これを ETWManifests のインストールの際に使用します。

重要

このリリースでは、Lifecycle Services から新しいローカルエージェント構成ファイルをダウンロードする必要があります。問題が発生した場合は、オンプレミス配置のトラブルシューティングの記事を参照してください。

ローカルエージェント 2.1.0 の新機能

ローカルエージェント 2.1.0 では、環境の準備および環境の更新が 2 つの異なる手順および明示的アクションである 2 フェーズのサービスを有効にします。事前準備を行い、ユーザーが準備中に環境を使用できるようにし、実際の更新環境アクションが発生する際にダウンタイムを通知することで、オンプレミス環境に更新プログラムを適用する場合に顧客が取る必要があるダウンタイムの合計が削減されます。

ローカルエージェント 2.0.0 の新機能

ローカルエージェント 2.0.0 はプラットフォーム更新プログラム 12 を展開できます。
プラットフォーム更新 12 の配置の初回成功まで、再構成機能は有効になります。
プラットフォーム更新 12 の配置の初回成功時は、再構成機能は無効になります。配置が成功した後、定期的な更新エクスペリエンスを使用して環境を更新することができます。

メモ

ローカルエージェント 2.0.0 は、プラットフォーム更新プログラム 8 およびプラットフォーム更新プログラム 11 を展開できません。プラットフォーム更新プログラムを展開するには、バージョン 1.1.0 が必要です。

Lifecycle Services から最新のローカルエージェントおよび構成をダウンロード

メモ

現在の配置では、ローカルエージェントの以前のバージョンを要求する場合は、Lifecycle Services の資産ライブラリからそれをダウンロードします。ローカルエージェントバージョン 1.1.0 をダウンロードするには、共用資産ライブラリ > モデル に移動し、Dynamics 365 財務と運用 (オンプレミス) - ローカルエージェント v1.1.0** をクリックします。

プラットフォーム更新プログラム 12 の展開および更新プログラムフローの完成には、バージョン 2.0.0 かそれ以降のバージョンが必要です。

Lifecycle Services で、プロジェクト設定>オンプレミスコネクタ を選択します。
環境へのコネクタを選択し、編集を選択します。
ページの左側にあるメニューの、ホストインフラストラクチャ設定を選択し、エージェントインストーラーのダウンロードを選択します。

この時点で、zip ファイルがダウンロードされ、かつブロックされていないことを確認する必要があります。
zip ファイルに移動し、右クリックして プロパティ を選択します。
プロパティ ダイアログボックスで、ブロック解除を選択してから適用を選択します。
エージェントのコンフィギュレーションタブで、コンフィギュレーションのダウンロードを選択し、localagent-config.json コンフィギュレーションファイルをダウンロードします。