Freigeben über

Problembehandlung bei Microsoft Connected Cache für Unternehmen und Bildungseinrichtungen

Dieser Artikel enthält Anweisungen zur Behandlung verschiedener Probleme, die bei der Verwendung von Connected Cache auftreten können. Diese Probleme werden nach der Aufgabe kategorisiert, in der sie auftreten können.

Bekannte Probleme

In diesem Abschnitt werden bekannte Probleme mit der neuesten Version von Microsoft Connected Cache for Enterprise and Education beschrieben. Weitere Informationen zu den In der neuesten Version enthaltenen Korrekturen finden Sie auf der Seite mit den Versionshinweisen .

Das Überwachungsdiagramm für Cacheknoten in der benutzeroberfläche Azure-Portal zeigt falsche Informationen an.

Skriptprovisionmcconwsl.ps1 schlägt fehl, wenn es auf einem Windows 11 Hostcomputer ausgeführt wird, der für die Verwendung der japanischen Sprache konfiguriert ist

Im Installationsskript für verbundene Caches (provisionmcconwsl.ps1) wird die Überprüfungsverarbeitung ausgeführt, bis der Wert des letzten Ausführungscodes (Last Result) der Installationsaufgabe in der folgenden Verarbeitung 0 ist. Im japanischen Betriebssystem ist der Rückgabewert jedoch NULL, da "Letztes Ergebnis" angezeigt wird und eine Ausnahme auftritt.

Als vorübergehende Problemumgehung tritt der obige Fehler nicht auf, indem die Spracheinstellung des lokalen Administratorbenutzers von Japanisch in Englisch geändert und dann das Skript ausgeführt wird.

Schritte zum Abrufen einer Azure-Abonnement-ID

  1. Melden Sie sich beim Azure-Portal an.
  2. Wählen Sie Abonnements aus. Wenn Abonnements nicht angezeigt wird, geben Sie Abonnements in die Suchleiste ein. Wenn Sie mit der Eingabe beginnen, filtert die Liste basierend auf Ihrer Eingabe.
  3. Wenn Sie bereits über ein Azure-Abonnement verfügen, fahren Sie mit Schritt 5 fort. Wenn Sie nicht über ein Azure-Abonnement verfügen, wählen Sie oben links + Hinzufügen aus.
  4. Wählen Sie das Abonnement Nutzungsbasierte Bezahlung aus. Sie werden aufgefordert, eine Gutschrift Karte Informationen einzugeben, die Nutzung des Microsoft Connected Cache-Diensts wird Ihnen jedoch nicht in Rechnung gestellt.
  5. Auf der Seite Abonnements finden Sie Details zu Ihrem aktuellen Abonnement. Wählen Sie den Abonnementnamen aus.
  6. Nachdem Sie den Abonnementnamen ausgewählt haben, finden Sie die Abonnement-ID auf der Registerkarte Übersicht . Wählen Sie das Symbol In Zwischenablage kopieren neben Ihrer Abonnement-ID aus, um den Wert zu kopieren.

Problembehandlung bei der Azure-Ressourcenerstellung

Die Erstellung von Azure-Ressourcen im verbundenen Cache kann entweder über die Azure-Portal-Benutzeroberfläche oder den Azure CLI-Befehlssatz initiiert werden.

Wenn bei der Ressourcenerstellung ein Fehler auftritt, überprüfen Sie, ob Sie über die erforderlichen Berechtigungen zum Erstellen von Azure-Ressourcen unter Ihrem Abonnement verfügen und während des Ressourcenerstellungsprozesses alle erforderlichen Felder ausgefüllt haben.

Problembehandlung bei der Cacheknotenkonfiguration

Die Konfiguration ihres Connected Cache-Knotens kann entweder über die Azure-Portal-Benutzeroberfläche oder den Azure CLI-Befehlssatz erfolgen.

Wenn ein Überprüfungsfehler auftritt, überprüfen Sie, ob Sie alle erforderlichen Konfigurationsfelder ausgefüllt haben.

Wenn Ihre Konfiguration anscheinend nicht wirksam wird, überprüfen Sie, ob Sie die Option Speichern oben auf der Konfigurationsseite in der Azure-Portal-Benutzeroberfläche ausgewählt haben.

Wenn Sie die Proxykonfiguration geändert haben, müssen Sie die Connected Cache-Software auf dem Hostcomputer erneut bereitstellen, damit die Proxykonfiguration wirksam wird.

Problembehandlung bei Cacheknoten, die während der frühen Vorschau erstellt wurden

Cacheknoten, die während der frühen Vorschauversion von Microsoft Connected Cache for Enterprise and Education erstellt und bereitgestellt wurden, sollten weiterhin funktionieren, können aber nicht mehr remote über den Azure-Dienst Connected Cache verwaltet oder überwacht werden.

Daher wird dringend empfohlen, Ihre vorhandenen Ressourcen in Azure neu zu erstellen und dann die Connected Cache-Software mithilfe des neuesten betriebssystemspezifischen Installers erneut auf Ihren Hostcomputern bereitzustellen .

Problembehandlung bei der Bereitstellung von Cacheknoten auf dem Windows-Hostcomputer

Sammeln von Von Windows gehosteten Installationsprotokollen

Die Bereitstellung eines Verbundenen Cache-Knotens auf einem Windows-Hostcomputer umfasst das Ausführen einer Reihe von PowerShell-Skripts, die im Windows-Bereitstellungspaket enthalten sind. Diese Skripts versuchen, Protokolldateien in das Installationsverzeichnis zu schreiben, das im Bereitstellungsbefehl (C:\mccwsl01\InstallLogs standardmäßig) angegeben ist.

Es gibt drei Arten von Installationsprotokolldateien:

  1. WSL_Mcc_Install_Transcript: Diese Protokolldatei zeichnet die Zeilen auf, die beim Ausführen des Installationsskripts im PowerShell-Fenster ausgegeben werden.
  2. WSL_Mcc_Install_FromRegisteredTask_Status: Diese Protokolldatei zeichnet die allgemeine status auf, die während der Installation registrierter Aufgaben geschrieben wird.
  3. WSL_Mcc_Install_FromRegisteredTask_Transcript: Diese Protokolldatei zeichnet die detaillierten status auf, die während der Installation registrierter Aufgaben geschrieben werden.

Das Transkript für registrierte Aufgaben ist in der Regel am nützlichsten für die Diagnose des Installationsproblems.

Sammeln anderer von Windows gehosteter Protokolle

Sobald der Cacheknoten erfolgreich auf dem Windows-Hostcomputer installiert wurde, schreibt er in regelmäßigen Abständen Protokolldateien in das Installationsverzeichnis (C:\mccwsl01\ standardmäßig).

Sie können davon ausgehen, dass die folgenden Arten von Protokolldateien angezeigt werden:

  1. WSL_Mcc_Monitor_FromRegisteredTask_Transcript: Diese Protokolldatei zeichnet die Ausgabe der geplanten Aufgabe "MCC_Monitor_Task" auf, die dafür verantwortlich ist, dass der verbundene Cache weiterhin ausgeführt wird.
  2. WSL_Mcc_UserUninstall_Transcript: Diese Protokolldatei zeichnet die Ausgabe des Skripts "uninstallmcconwsl.ps1" auf, das der Benutzer ausführen kann, um MCC-Software vom Hostcomputer zu deinstallieren.
  3. WSL_Mcc_Uninstall_FromRegisteredTask_Transcript: Diese Protokolldatei zeichnet die Ausgabe der geplanten Aufgabe "MCC_Uninstall_Task" auf, die für die Deinstallation der MCC-Software vom Hostcomputer zuständig ist, wenn sie vom Skript "uninstallmcconwsl.ps1" aufgerufen wird.

WSL2 kann nicht mit der Meldung "Eine angegebene Anmeldesitzung ist nicht vorhanden" installiert werden.

Wenn diese Fehlermeldung beim Versuch auftritt, den PowerShell-Befehl wsl.exe --install --no-distribution auf Ihrem Windows-Hostcomputer auszuführen, überprüfen Sie, ob Sie als lokaler Administrator angemeldet sind, und führen Sie den Befehl in einem PowerShell-Fenster mit erhöhten Rechten aus.

Aktualisieren des WSL2-Kernels

Wenn die Installation des verbundenen Caches aufgrund von WSL-Problemen fehlschlägt, versuchen Sie, wsl.exe --update die neueste Version des WSL-Kernels zu erhalten.

Überprüfen, ob der Connected Cache-Container ausgeführt wird

Nachdem die Connected Cache-Software erfolgreich auf dem Windows-Hostcomputer bereitgestellt wurde, können Sie überprüfen, ob der Cacheknoten ordnungsgemäß ausgeführt wird, indem Sie auf dem Windows-Hostcomputer wie folgt vorgehen:

  1. Starten Sie einen PowerShell-Prozess als das Konto, das während der Installation des verbundenen Caches als Laufzeitkonto angegeben wurde.
  2. Führen Sie aus wsl -d Ubuntu-22.04-Mcc-Base , um auf die Linux-Distribution zuzugreifen, die den Connected Cache-Container hostet.
  3. Führen Sie aussudo iotedge list, um anzuzeigen, welche Container innerhalb der IoT Edge Runtime ausgeführt werden.

Wenn die Container edgeAgent und edgeHub, aber nicht MCC angezeigt werden, können Sie die status des IoT Edge-Sicherheits-Managers mithilfe sudo iotedge system logs -- -fvon anzeigen.

Sie können die IoT Edge Runtime auch mit sudo systemctl restart iotedgeneu starten.

Überprüfen geplanter Aufgaben im verbundenen Cache

Sobald der Connected Cache-Container ausgeführt wird, wird in regelmäßigen Abständen eine geplante Aufgabe unter dem Laufzeitkonto des verbundenen Caches ausgeführt, damit WSL den Connected Cache-Container nicht bereinigen kann.

Sie können den Taskplaner auf dem Hostcomputer verwenden, um die status dieser geplanten Aufgabe zu überprüfen.

  1. Öffnen des Aufgabenplanungsmoduls auf dem Hostcomputer
  2. Navigieren Sie zum Abschnitt Aktive Aufgaben, und doppelklicken Sie auf MCC_Monitor_Task
  3. Wählen Sie die MCC_Monitor_Task für den geplanten Vorgang aus .
  4. Wählen Sie die Registerkarte Trigger aus, und vergewissern Sie sich, dass der Status Aktiviert ist.

Hinweis

Wenn sich das Kennwort des Laufzeitkontos ändert, müssen Sie den Benutzer in allen geplanten Tasks des verbundenen Caches aktualisieren, damit der Knoten Connected Cache weiterhin ordnungsgemäß funktioniert.

Cacheknoten erfolgreich bereitgestellt, aber keine Anforderungen verarbeiten

Wenn Ihr Cacheknoten nicht auf Anforderungen außerhalb von localhost reagiert, liegt dies möglicherweise daran, dass die Portweiterleitungsregeln des Hostcomputers während der Installation des verbundenen Caches nicht ordnungsgemäß festgelegt wurden.

Verwenden Sie den folgenden PowerShell-Befehl, um die Portweiterleitungsregeln Ihres Hostcomputers zu überprüfen.

netsh interface portproxy show v4tov4

Wenn keine Portweiterleitungsregeln für Port 80 bis 0.0.0.0 angezeigt werden, können Sie den folgenden Befehl über eine PowerShell-instance mit erhöhten Rechten ausführen, um die ordnungsgemäße Weiterleitung auf WSL festzulegen.

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

Sie können die WSL-IP-Adresse aus der wslip.txt Datei abrufen, die in dem Installationsverzeichnis vorhanden sein soll, das Sie im Bereitstellungsbefehl für den verbundenen Cache angegeben haben ("c:\mccwsl01" standardmäßig).

Problembehandlung bei der Bereitstellung von Cacheknoten auf dem Linux-Hostcomputer

Das Bereitstellen eines Verbundenen Cacheknotens auf einem Linux-Hostcomputer umfasst das Ausführen einer Reihe von Bash-Skripts, die im Linux-Bereitstellungspaket enthalten sind.

Nachdem die Connected Cache-Software erfolgreich auf dem Linux-Hostcomputer bereitgestellt wurde, können Sie überprüfen, ob der Cacheknoten ordnungsgemäß ausgeführt wird, indem Sie auf dem Linux-Hostcomputer wie folgt vorgehen:

  1. Führen Sie aussudo iotedge list, um anzuzeigen, welche Container innerhalb der IoT Edge Runtime ausgeführt werden.

Wenn die Container edgeAgent und edgeHub, aber nicht MCC angezeigt werden, können Sie die status des IoT Edge-Sicherheits-Managers mithilfe sudo iotedge system logs -- -fvon anzeigen.

Sie können die IoT Edge Runtime auch mit sudo systemctl restart iotedgeneu starten.

Generieren des Diagnoseunterstützungspakets für Cacheknoten

Sie können ein Supportpaket mit detaillierten Diagnoseinformationen generieren, indem Sie das collectMccDiagnostics.sh im Installationspaket enthaltene Skript ausführen.

Für Windows-Hostcomputer müssen Sie die folgenden Schritte ausführen:

  1. Starten Sie einen PowerShell-Prozess als das Konto, das während der Installation des verbundenen Caches als Laufzeitkonto angegeben wurde.

  2. Wechseln Sie in das Verzeichnis "MccScripts" innerhalb des extrahierten Connected Cache-Bereitstellungspakets, und überprüfen Sie das Vorhandensein von collectmccdiagnostics.sh

  3. Führen Sie aus wsl bash collectmccdiagnostics.sh , um das Diagnoseunterstützungspaket zu generieren.

  4. Beachten Sie nach Abschluss des Skripts die Konsolenausgabe, die den Speicherort des Diagnoseunterstützungspakets beschreibt.

    Beispiel: "Paket erfolgreich gezippt, datei senden, die unter /etc/mccdiagnostics/support_bundle_2024_12_03__11_05_39__AM.tar.gz erstellt wurde"

  5. Führen Sie den wsl cp Befehl aus, um das Supportpaket vom Speicherort in der Ubuntu-Distribution auf das Windows-Hostbetriebssystem zu kopieren.

    Beispiel: wsl cp /etc/mccdiagnostics/support_bundle_2024_12_03__11_05_39__AM.tar.gz /mnt/c/mccwsl01/SupportBundles.

Für Linux-Hostcomputer müssen Sie die folgenden Schritte ausführen:

  1. Wechseln Sie in das Verzeichnis "MccScripts" innerhalb des extrahierten Connected Cache-Bereitstellungspakets, und überprüfen Sie das Vorhandensein von collectmccdiagnostics.sh

  2. Führen Sie aus collectmccdiagnostics.sh , um das Diagnoseunterstützungspaket zu generieren.

  3. Beachten Sie nach Abschluss des Skripts die Konsolenausgabe, die den Speicherort des Diagnoseunterstützungspakets beschreibt.

    Beispiel: "Paket erfolgreich gezippt, datei senden, die unter /etc/mccdiagnostics/support_bundle_2024_12_03__11_05_39__AM.tar.gz erstellt wurde"

Problembehandlung bei der Überwachung von Cacheknoten

Die status und Leistung des Knotens "Connected Cache" können über die Benutzeroberfläche Azure-Portal überwacht werden.

Wenn die grundlegenden Überwachungsvisuals auf der Registerkarte Übersicht unerwartete oder fehlerhafte Werte anzeigen, aktualisieren Sie das Browserfenster.

Wenn das Problem weiterhin besteht, überprüfen Sie, ob Sie die Knotenfilter "Zeitraum" und "Cache" wie gewünscht konfiguriert haben.

Diagnose und Lösung

Sie können auch die Funktion Diagnose und Problembehandlung verwenden, die von der Azure-Portal-Schnittstelle bereitgestellt wird. Diese Registerkarte in der Azure-Ressource Microsoft Connected Cache führt Sie durch einige Eingabeaufforderungen, um die Lösung für Ihr Problem einzugrenzen.