KB: .NET 8および.NET 10ランタイムの依存関係の不足によるAES 8.xへのアップグレードの問題

解決方法の詳細

AES 8.xへのアップグレード後の症状

AES v8.xへのアップグレード後、ユーザーから以下の症状が報告されました。

• Altium Designer 25からは、プロジェクトおよびサーバーに正常にアクセスできました。
• Webインターフェースからは、引き続きコンポーネントにアクセスできました。
• AESのWebインターフェースでプロジェクトを表示できませんでした。
• 時間をおいて再試行しても、問題は解決しませんでした。

プロジェクトを表示しようとすると、Webインターフェースに次のメッセージが表示されました。

AESのWebフロントエンドにアクセスしようとした際に、"The service is unavailable. 500: the server isn't responding."が表示される場合もあります。

AES 8.xで導入されたランタイム依存関係の変更

AES 8.x以降では、AESサーバーに.NET 8と.NET 10の両方のランタイムを同時にインストールしておく必要があります。

AES v8.x以降では、以下の点に注意してください。

• .NET 10に移行されたのは、AESサービスの一部のみです。
• 大部分のAESサービスは、引き続き.NET 8に依存しています。
• .NET 8または.NET 10のいずれかを削除したり、インストールしなかったりすると、サービスの起動失敗やWebフロントエンドの問題が発生する可能性があります。

この依存関係はAES v8.x以降の想定された仕様であり、今後のAESリリースで追加のサービスが移行されるにつれて変更される予定です。

推奨される復旧方法

• .NET 10に加えて最新の.NET 8ランタイムをインストールし、サーバーの動作を確認してください。
• 問題が解消しない場合は、AESを再インストールして、必要なすべてのランタイム依存関係を自動的に復元してください。
• 再インストールを実行する前に、既存のAES環境の完全バックアップを作成してください。

AESの機能を復旧する手順

1. AESサーバーマシンに現在インストールされている.NETランタイムを確認します。
2. .NET 8と.NET 10の両方が共存する形でインストールされていることを確認します。
3. .NET 8または.NET 10のいずれかがインストールされていない場合は、不足している.NETランタイムの、サポート対象となる最新バージョンをインストールします。
4. 必要に応じて、影響を受けているAESサービスを再起動します。
5. AESのWebフロントエンドへのアクセスをテストします。
6. Webインターフェースからプロジェクトを開いて表示できることを確認します。
7. 問題が解消しない場合は、AES環境のバックアップを作成します。
8. 標準のインストール手順に従って、AES v8.1.3.17を再インストールします。
9. インストーラーで、必要なすべての依存コンポーネントをインストールします。
10. 必要に応じて、バックアップからデータを復元します。
11. Webフロントエンドとプロジェクト表示機能が正常に動作することを確認します。

補足事項

• AES 8.xでは、.NET 8と.NET 10の両方のランタイムをサーバーにインストールした状態にしておく必要があります。AESの要件を確認せずにランタイムを更新または削除すると、サービスの障害、プロジェクトへのアクセスの問題、Webフロントエンドが利用できなくなるなどの問題が発生する可能性があります。
• Windowsまたは.NETの更新後にAESにアクセスできなくなった場合は、ランタイムに関連するアクセスの問題やバージョンの互換性に関する考慮事項について、こちらのナレッジベース記事を参照してください。この記事は、主にWindowsおよび.NETの更新の影響を受ける、サポート対象外のAESバージョンに適用されます。ただし、ランタイムの変更やWebサービスの可用性に関連する同様の症状を調査する際にも役立つ場合があります。

参考資料

• AESのインストール時にインストールまたは構成される追加ソフトウェア
• Altium On-Prem Enterprise Serverのインストール
• インストール環境のバックアップと復元