Microsoft Connected Cache for Enterprise and Education のトラブルシューティング

• 適用対象:

  ✅ Windows 11, ✅ Supported Linux distributions, ✅ Microsoft Connected Cache for Enterprise

この記事では、接続キャッシュの使用中に発生する可能性があるさまざまな問題のトラブルシューティング方法について説明します。 これらの問題は、発生する可能性があるタスクによって分類されます。

既知の問題

このセクションでは、Microsoft Connected Cache for Enterprise and Education の最新リリースに関する既知の問題について説明します。 最新リリースに含まれる修正プログラムの詳細については、「 リリース ノート」ページ を参照してください。

Azure portal ユーザー インターフェイスのキャッシュ ノード監視グラフに正しくない情報が表示される

日本語を使用するように構成されたWindows 11 ホスト コンピューターで実行すると、スクリプト provisionmcconwsl.ps1 が失敗する

Connected Cache インストール スクリプト (provisionmcconwsl.ps1) では、次の処理でインストール タスクの最後の実行コード (最終結果) の値が 0 になるまで、チェック処理が実行されます。 ただし、日本語 OS では、"Last Result" が表示され、例外が発生するため、戻り値は null です。

一時的な回避策として、ローカル管理者ユーザーの言語設定を日本語から英語に変更し、スクリプトを実行しても、上記のエラーは発生しません。

Azure サブスクリプション ID を取得する手順

1. Azure portal にサインインします。
2. [ サブスクリプション] を選択します。 [ サブスクリプション] が表示されない場合は、検索バーに「 サブスクリプション」 と入力します。 入力を開始すると、入力に基づいてリストがフィルター処理されます。
3. 既に Azure サブスクリプションがある場合は、手順 5 に進みます。 Azure サブスクリプションをお持ちでない場合は、左上の [ + 追加] を選択します。
4. 従量課金制サブスクリプションを選択します。 クレジットカード情報の入力を求められますが、Microsoft Connected Cache サービスを使用した場合は課金されません。
5. [ サブスクリプション ] ページには、現在のサブスクリプションに関する詳細が表示されます。 サブスクリプション名を選択します。
6. サブスクリプション名を選択すると、[ 概要 ] タブにサブスクリプション ID が表示されます。[サブスクリプション ID] の横にある [クリップボードにコピー ] アイコンを選択して、値をコピーします。

Azure リソースの作成のトラブルシューティング

接続済みキャッシュ Azure リソースの作成は、Azure portal ユーザー インターフェイスまたは Azure CLI コマンド セットを使用して開始できます。

リソースの作成時にエラーが発生した場合は、サブスクリプションの下に Azure リソースを作成するために必要なアクセス許可があり、リソースの作成プロセス中にすべての必須フィールドを入力していることをチェックします。

キャッシュ ノード構成のトラブルシューティング

接続済みキャッシュ ノードの構成は、Azure portal ユーザー インターフェイスまたは Azure CLI コマンド セットを使用して行うことができます。

検証エラーが発生した場合は、必要なすべての構成フィールドに入力したことをチェックします。

構成が有効になっていないように見える場合は、Azure portal ユーザー インターフェイスの構成ページの上部にある [保存] オプションを選択チェック。

プロキシ構成を変更した場合は、プロキシ構成を有効にするために、ホスト コンピューターに接続済みキャッシュ ソフトウェアを再プロビジョニングする必要があります。

早期プレビュー中に作成されたキャッシュ ノードのトラブルシューティング

Microsoft Connected Cache for Enterprise および Education の早期プレビュー中に作成およびデプロイされたキャッシュ ノードは引き続き機能する必要がありますが、接続キャッシュ Azure サービスを介してリモートで管理または監視することはできません。

そのため、 Azure で既存のリソースを再作成 してから、最新の OS 固有のインストーラーを使用して 接続キャッシュ ソフトウェアをホスト マシンに再デプロイ することを強くお勧めします。

Windows ホスト コンピューターへのキャッシュ ノードの展開のトラブルシューティング

Windows でホストされるインストール ログの収集

接続キャッシュ ノードを Windows ホスト マシンに展開 するには、Windows プロビジョニング パッケージに含まれる一連の PowerShell スクリプトを実行する必要があります。 これらのスクリプトは、プロビジョニング コマンドで指定されたインストール ディレクトリにログ ファイルを書き込もうとします (既定ではC:\mccwsl01\InstallLogs )。

インストール ログ ファイルには、次の 3 種類があります。

1. WSL_Mcc_Install_Transcript: このログ ファイルは、インストール スクリプトの実行時に PowerShell ウィンドウに出力された行を記録します
2. WSL_Mcc_Install_FromRegisteredTask_Status: このログ ファイルは、登録されたタスクのインストール中に書き込まれた高レベルの状態を記録します
3. WSL_Mcc_Install_FromRegisteredTask_Transcript: このログ ファイルは、登録されたタスクのインストール中に書き込まれた詳細な状態を記録します

通常、インストールの問題を診断するには、登録済みタスクトランスクリプトが最も役立ちます。

他の Windows でホストされているログの収集

キャッシュ ノードが Windows ホスト コンピューターに正常にインストールされると、ログ ファイルは定期的にインストール ディレクトリに書き込まれます (既定ではC:\mccwsl01\ )。

次の種類のログ ファイルが表示されます。

1. WSL_Mcc_Monitor_FromRegisteredTask_Transcript: このログ ファイルには、接続されたキャッシュの実行を確実に行う "MCC_Monitor_Task" スケジュールされたタスクの出力が記録されます。
2. WSL_Mcc_UserUninstall_Transcript: このログ ファイルは、ユーザーがホスト コンピューターから MCC ソフトウェアをアンインストールするために実行できる "uninstallmcconwsl.ps1" スクリプトの出力を記録します。
3. WSL_Mcc_Uninstall_FromRegisteredTask_Transcript: このログ ファイルは、"uninstallmcconwsl.ps1" スクリプトによって呼び出されたときにホスト コンピューターから MCC ソフトウェアをアンインストールする "MCC_Uninstall_Task" スケジュールされたタスクの出力を記録します。

WSL2 が "指定されたログオン セッションが存在しません" というメッセージでインストールに失敗する

Windows ホスト コンピューターで PowerShell コマンド wsl.exe --install --no-distribution を実行しようとすると、このエラー メッセージが表示される場合は、ローカル管理者としてログオンし、管理者特権の PowerShell ウィンドウからコマンドを実行していることを確認します。

WSL2 カーネルの更新

WSL 関連の問題が原因で接続済みキャッシュのインストールが失敗している場合は、 wsl.exe --update を実行して最新バージョンの WSL カーネルを取得してみてください。

接続済みキャッシュ コンテナーが実行されているかどうかを確認する

接続済みキャッシュ ソフトウェアが Windows ホスト コンピューターに正常に展開されたら、Windows ホスト コンピューターで次の手順を実行して、キャッシュ ノードが正常に実行されているかどうかをチェックできます。

1. 接続キャッシュのインストール中にランタイム アカウントとして指定されたアカウントとして PowerShell プロセスを起動する
2. wsl -d Ubuntu-22.04-Mcc-Baseを実行して、接続済みキャッシュ コンテナーをホストする Linux ディストリビューションにアクセスする
3. sudo iotedge listを実行して、IoT Edge ランタイム内で実行されているコンテナーを表示します

edgeAgent コンテナーと edgeHub コンテナーが表示されていても MCC が表示されない場合は、sudo iotedge system logs -- -fを使用してIoT Edge セキュリティ マネージャーの状態を表示できます。

sudo systemctl restart iotedgeを使用して、IoT Edge ランタイムを再起動することもできます。

接続キャッシュのスケジュールされたタスクの確認

接続済みキャッシュ コンテナーが実行されると、接続キャッシュ コンテナーのクリーンアップから WSL を維持するために、接続済みキャッシュ ランタイム アカウントでスケジュールされたタスクが定期的に実行されます。

ホスト コンピューターでタスク スケジューラを使用して、このスケジュールされたタスクの状態をチェックできます。

1. ホスト コンピューターでタスク スケジューラを開く
2. [アクティブタスク] セクションに移動し、MCC_Monitor_Taskをダブルクリックします
3. スケジュールされたタスク MCC_Monitor_Taskを選択する
4. [トリガー] タブを選択し、[状態] が [有効] になっていることを確認します

注

ランタイム アカウントのパスワードが変更された場合は、接続キャッシュ ノードが正常に機能し続けるために、すべての接続キャッシュ スケジュールされたタスクのユーザーを更新する必要があります。

キャッシュ ノードは正常にデプロイされましたが、要求を提供していません

キャッシュ ノードが localhost の外部の要求に応答していない場合は、接続キャッシュのインストール中にホスト マシンのポート転送規則が正しく設定されなかった可能性があります。 WSL 2 は既定で仮想化イーサネット アダプターを使用するため、トラフィックが LAN から WSL 2 インスタンスに到達できるようにするには、ポート転送規則が必要です。 詳細については、「 WSL を使用したネットワーク アプリケーションへのアクセス」を参照してください。

ホスト マシンのポート転送規則をチェックするには、次の PowerShell コマンドを使用します。

netsh interface portproxy show v4tov4

ポート 80 から 0.0.0.0 へのポート転送規則が表示されない場合は、管理者特権の PowerShell インスタンスから次のコマンドを実行して、WSL への適切な転送を設定できます。

netsh interface portproxy add v4tov4 listenport=80 listenaddress=0.0.0.0 connectport=80 connectaddress=<WSL IP Address>

接続キャッシュ プロビジョニング コマンド (既定では "c:\mccwsl01") で指定したインストール ディレクトリに存在する必要がある、 wslip.txt ファイルから WSL IP アドレスを取得できます。

Linux ホスト マシンへのキャッシュ ノードのデプロイのトラブルシューティング

接続キャッシュ ノードを Linux ホスト マシンにデプロイ するには、Linux プロビジョニング パッケージに含まれる一連の Bash スクリプトを実行する必要があります。

接続済みキャッシュ ソフトウェアが Linux ホスト コンピューターに正常にデプロイされたら、Linux ホスト コンピューターで次の手順を実行して、キャッシュ ノードが正常に実行されているかどうかをチェックできます。

1. sudo iotedge listを実行して、IoT Edge ランタイム内で実行されているコンテナーを表示します

edgeAgent コンテナーと edgeHub コンテナーが表示されていても MCC が表示されない場合は、sudo iotedge system logs -- -fを使用してIoT Edge セキュリティ マネージャーの状態を表示できます。

sudo systemctl restart iotedgeを使用して、IoT Edge ランタイムを再起動することもできます。

キャッシュ ノード診断サポート バンドルの生成

インストール パッケージに含まれる collectMccDiagnostics.sh スクリプトを実行することで、詳細な診断情報を含むサポート バンドルを生成できます。

Windows ホスト マシンの場合は、次の操作を行う必要があります。

1. 接続キャッシュのインストール中にランタイム アカウントとして指定されたアカウントとして PowerShell プロセスを起動する

2. 抽出された Connected Cache プロビジョニング パッケージ内の "MccScripts" ディレクトリにディレクトリを変更し、 collectmccdiagnostics.sh

3. wsl bash collectmccdiagnostics.shを実行して診断サポート バンドルを生成する

4. スクリプトが完了したら、診断サポート バンドルの場所を説明するコンソール出力を書き留めます

   たとえば、"パッケージが正常に圧縮されました。/etc/mccdiagnostics/support_bundle_2024_12_03__11_05_39__AM.tar.gz で作成されたファイルを送信してください"

5. wsl cp コマンドを実行して、Ubuntu ディストリビューション内の場所から Windows ホスト OS にサポート バンドルをコピーします

   例えば wsl cp /etc/mccdiagnostics/support_bundle_2024_12_03__11_05_39__AM.tar.gz /mnt/c/mccwsl01/SupportBundles

Linux ホスト マシンの場合は、次の操作を行う必要があります。

1. 抽出された Connected Cache プロビジョニング パッケージ内の "MccScripts" ディレクトリにディレクトリを変更し、 collectmccdiagnostics.sh

2. collectmccdiagnostics.shを実行して診断サポート バンドルを生成する

3. スクリプトが完了したら、診断サポート バンドルの場所を説明するコンソール出力を書き留めます

   たとえば、"パッケージが正常に圧縮されました。/etc/mccdiagnostics/support_bundle_2024_12_03__11_05_39__AM.tar.gz で作成されたファイルを送信してください"

キャッシュ ノードの監視のトラブルシューティング

接続されたキャッシュ ノードの状態とパフォーマンスは、Azure portal ユーザー インターフェイスを使用して監視できます。

[概要] タブの 基本的な監視 ビジュアルに予期しない値または誤った値が表示されている場合は、ブラウザー ウィンドウを更新します。

問題が解決しない場合は、必要に応じて Timespan および Cache ノード フィルターを構成したことをチェックします。

診断と解決

Azure portal インターフェイスによって提供される問題の診断と解決機能を使用することもできます。 Microsoft Connected Cache Azure リソース内のこのタブには、問題の解決策を絞り込むのに役立ついくつかのプロンプトが表示されます。