Risolvere i problemi di Microsoft Connected Cache for Enterprise and Education

• Si applica a:

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

Questo articolo contiene istruzioni su come risolvere i diversi problemi che possono verificarsi durante l'uso di Cache connessa. Questi problemi sono classificati in base all'attività in cui possono essere rilevati.

Problemi noti

Questa sezione descrive i problemi noti relativi alla versione più recente di Microsoft Connected Cache for Enterprise and Education. Per altre informazioni sulle correzioni incluse nella versione più recente, vedere la pagina Note sulla versione.

Lo script provisionmcconwsl.ps1 non riesce quando viene eseguito in un computer host Windows 11 configurato per l'uso della lingua giapponese

Nello script di installazione della cache connessa (provisionmcconwsl.ps1), l'elaborazione del controllo viene eseguita fino a quando il valore dell'ultimo codice di esecuzione (ultimo risultato) dell'attività di installazione non diventa 0 nell'elaborazione seguente. Tuttavia, nel sistema operativo giapponese il valore restituito è Null perché viene visualizzato "Ultimo risultato" e si verifica un'eccezione.

Come soluzione temporanea, l'errore precedente non si verifica modificando l'impostazione della lingua dell'utente amministratore locale dal giapponese all'inglese e quindi eseguendo lo script.

Procedura per ottenere un ID sottoscrizione di Azure

1. Accedere al portale di Azure.
2. Selezionare Sottoscrizioni. Se sottoscrizioni non vengono visualizzate, digitare Sottoscrizioni nella barra di ricerca. Quando si inizia a digitare, l'elenco viene filtrato in base all'input.
3. Se si ha già una sottoscrizione di Azure, andare al passaggio 5. Se non si ha una sottoscrizione di Azure, selezionare + Aggiungi in alto a sinistra.
4. Selezionare la sottoscrizione con pagamento in base al consumo . Verrà richiesto di immettere le informazioni sulla carta di credito, ma non verrà addebitato alcun costo per l'uso del servizio Microsoft Connected Cache.
5. Nella pagina Sottoscrizioni sono disponibili informazioni dettagliate sulla sottoscrizione corrente. Selezionare il nome della sottoscrizione.
6. Dopo aver selezionato il nome della sottoscrizione, è possibile trovare l'ID sottoscrizione nella scheda Panoramica . Selezionare l'icona Copia negli Appunti accanto all'ID sottoscrizione per copiare il valore.

Risoluzione dei problemi relativi alla creazione di risorse di Azure

La creazione di risorse di Azure nella cache connessa può essere avviata usando l'interfaccia utente portale di Azure o il set di comandi dell'interfaccia della riga di comando di Azure.

Se si verifica un errore durante la creazione delle risorse, verificare di disporre delle autorizzazioni necessarie per creare risorse di Azure nella sottoscrizione e di aver compilato tutti i campi necessari durante il processo di creazione delle risorse.

Risoluzione dei problemi di configurazione dei nodi della cache

La configurazione del nodo Cache connessa può essere eseguita usando l'interfaccia utente portale di Azure o il set di comandi dell'interfaccia della riga di comando di Azure.

Se si verifica un errore di convalida, verificare di aver compilato tutti i campi di configurazione necessari.

Se la configurazione non sembra avere effetto, verificare di aver selezionato l'opzione Salva nella parte superiore della pagina di configurazione nell'interfaccia utente portale di Azure.

Se è stata modificata la configurazione del proxy, è necessario effettuare di nuovo il provisioning del software della cache connessa nel computer host per rendere effettiva la configurazione del proxy.

Risoluzione dei problemi relativi ai nodi della cache creati durante l'anteprima anticipata

I nodi della cache creati e distribuiti durante l'anteprima anticipata di Microsoft Connected Cache for Enterprise and Education devono continuare a funzionare, ma non possono più essere gestiti o monitorati in remoto tramite il servizio Azure Cache connessa.

Di conseguenza, è consigliabile ricreare le risorse esistenti in Azure e quindi ridistribuire il software della cache connessa nei computer host usando il programma di installazione più recente specifico del sistema operativo.

Risoluzione dei problemi di distribuzione dei nodi della cache nel computer host Windows

Raccolta dei log di installazione ospitati da Windows

La distribuzione di un nodo della cache connessa in un computer host Windows comporta l'esecuzione di una serie di script di PowerShell contenuti nel pacchetto di provisioning di Windows. Questi script tentano di scrivere file di log nella directory di installazione specificata nel comando di provisioning (C:\mccwsl01\InstallLogs per impostazione predefinita).

Esistono tre tipi di file di log di installazione:

1. WSL_Mcc_Install_Transcript: questo file di log registra le righe stampate nella finestra di PowerShell durante l'esecuzione dello script di installazione
2. WSL_Mcc_Install_FromRegisteredTask_Status: questo file di log registra lo stato di alto livello scritto durante l'installazione delle attività registrate
3. WSL_Mcc_Install_FromRegisteredTask_Transcript: questo file di log registra lo stato dettagliato scritto durante l'installazione delle attività registrate

La trascrizione attività registrata è in genere la più utile per diagnosticare il problema di installazione.

Raccolta di altri log ospitati da Windows

Dopo che il nodo della cache è stato installato correttamente nel computer host Windows, scriverà periodicamente i file di log nella directory di installazione (C:\mccwsl01\ per impostazione predefinita).

È possibile prevedere che vengano visualizzati i tipi di file di log seguenti:

1. WSL_Mcc_Monitor_FromRegisteredTask_Transcript: questo file di log registra l'output dell'attività pianificata "MCC_Monitor_Task" responsabile dell'esecuzione della cache connessa.
2. WSL_Mcc_UserUninstall_Transcript: questo file di log registra l'output dello script "uninstallmcconwsl.ps1" che l'utente può eseguire per disinstallare il software MCC dal computer host.
3. WSL_Mcc_Uninstall_FromRegisteredTask_Transcript: questo file di log registra l'output dell'attività pianificata "MCC_Uninstall_Task" responsabile della disinstallazione del software MCC dal computer host quando viene chiamato dallo script "uninstallmcconwsl.ps1".

Criteri di gruppo oggetto è in conflitto con la registrazione pianificata dell'attività

Abilitazione dell'oggetto Criteri di gruppo: accesso alla rete: non consentire l'archiviazione di password e credenziali per l'autenticazione di rete impedirà al software della cache connessa di registrare le attività pianificate necessarie per la corretta registrazione e l'operazione del nodo della cache.

L'installazione di WSL2 non riesce con il messaggio "Una sessione di accesso specificata non esiste"

Se si verifica questo messaggio di errore durante il tentativo di eseguire il comando wsl.exe --install --no-distribution PowerShell nel computer host Windows, verificare di essere connessi come amministratore locale ed eseguire il comando da una finestra di PowerShell con privilegi elevati.

Aggiornamento del kernel WSL2

Se l'installazione di Cache connessa ha esito negativo a causa di problemi correlati a WSL, provare a eseguire wsl.exe --update per ottenere la versione più recente del kernel WSL.

Verifica dell'esecuzione del contenitore della cache connessa

Dopo aver distribuito correttamente il software della cache connessa nel computer host Windows, è possibile verificare se il nodo della cache è in esecuzione correttamente eseguendo le operazioni seguenti nel computer host Windows:

1. Avviare un processo di PowerShell come account specificato come account di runtime durante l'installazione della cache connessa
2. Eseguire wsl -d Ubuntu-22.04-Mcc-Base per accedere alla distribuzione Linux che ospita il contenitore Cache connessa
3. Eseguire sudo iotedge list per visualizzare i contenitori in esecuzione all'interno del runtime di IoT Edge

Se vengono visualizzati i contenitori edgeAgent e edgeHub ma non viene visualizzato MCC, è possibile visualizzare lo stato del gestore della sicurezza IoT Edge usando sudo iotedge system logs -- -f.

È anche possibile riavviare il runtime di IoT Edge usando sudo systemctl restart iotedge.

Controllo delle attività pianificate di Cache connessa

Dopo l'esecuzione del contenitore Cache connessa, un'attività pianificata viene eseguita periodicamente nell'account di runtime della cache connessa per impedire a WSL di pulire il contenitore Cache connessa.

È possibile usare Utilità di pianificazione nel computer host per controllare lo stato di questa attività pianificata.

1. Aprire Utilità di pianificazione nel computer host
2. Passare alla sezione Attività attive e fare doppio clic su MCC_Monitor_Task
3. Selezionare l'attività pianificata MCC_Monitor_Task
4. Selezionare la scheda Trigger e verificare che lo stato sia abilitato

Nota

Se la password dell'account di runtime cambia, sarà necessario aggiornare l'utente in tutte le attività pianificate di Cache connessa affinché il nodo Cache connessa continui a funzionare correttamente.

Il nodo della cache è stato distribuito correttamente ma non gestisce le richieste

Se il nodo della cache non risponde alle richieste esterne a localhost, è possibile che le regole di inoltro delle porte del computer host non siano state impostate correttamente durante l'installazione di Cache connessa. Poiché WSL 2 usa una scheda Ethernet virtualizzata per impostazione predefinita, sono necessarie regole di inoltro delle porte per consentire al traffico di raggiungere l'istanza di WSL 2 dalla lan. Per altre informazioni, vedere Accesso alle applicazioni di rete con WSL.

Per controllare le regole di inoltro delle porte del computer host, usare il comando di PowerShell seguente.

netsh interface portproxy show v4tov4

Se non vengono visualizzate regole di inoltro delle porte per la porta da 80 a 0.0.0.0, è possibile eseguire il comando seguente da un'istanza di PowerShell con privilegi elevati per impostare l'inoltro corretto su WSL.

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

È possibile recuperare l'indirizzo IP WSL dal wslip.txt file che deve essere presente nella directory di installazione specificata nel comando di provisioning della cache connessa ("c:\mccwsl01" per impostazione predefinita).

Risoluzione dei problemi di distribuzione dei nodi della cache nel computer host Linux

La distribuzione di un nodo della cache connessa in un computer host Linux comporta l'esecuzione di una serie di script Bash contenuti nel pacchetto di provisioning Linux.

Dopo aver distribuito correttamente il software della cache connessa nel computer host Linux, è possibile verificare se il nodo della cache è in esecuzione correttamente eseguendo le operazioni seguenti nel computer host Linux:

1. Eseguire sudo iotedge list per visualizzare i contenitori in esecuzione all'interno del runtime di IoT Edge

Se vengono visualizzati i contenitori edgeAgent e edgeHub ma non viene visualizzato MCC, è possibile visualizzare lo stato del gestore della sicurezza IoT Edge usando sudo iotedge system logs -- -f.

È anche possibile riavviare il runtime di IoT Edge usando sudo systemctl restart iotedge.

Generazione del bundle di supporto per la diagnostica dei nodi della cache

È possibile generare un bundle di supporto con informazioni di diagnostica dettagliate eseguendo lo collectMccDiagnostics.sh script incluso nel pacchetto di installazione.

Per i computer host Windows, è necessario eseguire le operazioni seguenti:

1. Avviare un processo di PowerShell come account specificato come account di runtime durante l'installazione della cache connessa

2. Modificare la directory nella directory "MccScripts" all'interno del pacchetto di provisioning della cache connessa estratta e verificare la presenza di collectmccdiagnostics.sh

3. Eseguire wsl bash collectmccdiagnostics.sh per generare il bundle di supporto diagnostico

4. Al termine dello script, prendere nota dell'output della console che descrive la posizione del bundle di supporto diagnostico

   Ad esempio, "Pacchetto compresso correttamente, inviare il file creato in /etc/mccdiagnostics/support_bundle_2024_12_03__11_05_39__AM.tar.gz"

5. Eseguire il wsl cp comando per copiare il bundle di supporto dal percorso all'interno della distribuzione Ubuntu nel sistema operativo host Windows

   Per esempio wsl cp /etc/mccdiagnostics/support_bundle_2024_12_03__11_05_39__AM.tar.gz /mnt/c/mccwsl01/SupportBundles

Per i computer host Linux, è necessario eseguire le operazioni seguenti:

1. Modificare la directory nella directory "MccScripts" all'interno del pacchetto di provisioning della cache connessa estratta e verificare la presenza di collectmccdiagnostics.sh

2. Eseguire collectmccdiagnostics.sh per generare il bundle di supporto diagnostico

3. Al termine dello script, prendere nota dell'output della console che descrive la posizione del bundle di supporto diagnostico

   Ad esempio, "Pacchetto compresso correttamente, inviare il file creato in /etc/mccdiagnostics/support_bundle_2024_12_03__11_05_39__AM.tar.gz"

Risoluzione dei problemi relativi al monitoraggio dei nodi della cache

Lo stato e le prestazioni del nodo della cache connessa possono essere monitorati usando l'interfaccia utente portale di Azure.

Se gli oggetti visivi di monitoraggio di base nella scheda Panoramica mostrano valori imprevisti o errati, aggiornare la finestra del browser.

Se il problema persiste, verificare di aver configurato i filtri dei nodi Timespan e Cache come desiderato.

Diagnosticare e risolvere

È anche possibile usare la funzionalità Diagnostica e risoluzione dei problemi fornita dall'interfaccia portale di Azure. Questa scheda all'interno della risorsa azure di Cache connessa Microsoft illustra alcune richieste per ridurre la soluzione al problema.