Solución de problemas de microsoft connected cache for Enterprise and Education

• Se aplica a:

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

Este artículo contiene instrucciones sobre cómo solucionar diferentes problemas que puede encontrar al usar la caché conectada. Estos problemas se clasifican por la tarea en la que se pueden encontrar.

Problemas conocidos

En esta sección se describen problemas conocidos con la versión más reciente de Microsoft Connected Cache for Enterprise and Education. Consulte la página Notas de la versión para obtener más detalles sobre las correcciones incluidas en la versión más reciente.

Error de provisionmcconwsl.ps1 de script cuando se ejecuta en una máquina host Windows 11 configurada para usar el idioma japonés

En el script de instalación de caché conectada (provisionmcconwsl.ps1), el procesamiento de comprobación se ejecuta hasta que el valor del último código de ejecución (último resultado) de la tarea de instalación se convierte en 0 en el procesamiento siguiente. Sin embargo, en el sistema operativo japonés, el valor devuelto es null porque se muestra "Último resultado" y se produce una excepción.

Como solución temporal, el error anterior no se produce cambiando la configuración de idioma del usuario administrador local de japonés a inglés y, a continuación, ejecutando el script.

Pasos para obtener un identificador de suscripción de Azure

1. Inicie sesión en el Azure Portal.
2. Seleccione Suscripciones. Si no ve Suscripciones, escriba Suscripciones en la barra de búsqueda. Cuando empiece a escribir, la lista se filtra en función de la entrada.
3. Si ya tiene una suscripción de Azure, vaya al paso 5. Si no tiene una suscripción de Azure, seleccione + Agregar en la parte superior izquierda.
4. Seleccione la suscripción de pago por uso. Se le pedirá que escriba la información de la tarjeta de crédito, pero no se le cobrará por usar el servicio Microsoft Connected Cache.
5. En la página Suscripciones , encontrará detalles sobre la suscripción actual. Seleccione el nombre de la suscripción.
6. Después de seleccionar el nombre de la suscripción, encontrará el identificador de suscripción en la pestaña Información general . Seleccione el icono Copiar en el Portapapeles situado junto al identificador de suscripción para copiar el valor.

Solución de problemas de creación de recursos de Azure

La creación de recursos de Azure de caché conectada se puede iniciar mediante la interfaz de usuario Azure Portal o el conjunto de comandos de la CLI de Azure.

Si encuentra un error durante la creación de recursos, compruebe que tiene los permisos necesarios para crear recursos de Azure en su suscripción y que ha rellenado todos los campos necesarios durante el proceso de creación de recursos.

Solución de problemas de configuración del nodo de caché

La configuración del nodo Caché conectada se puede realizar mediante la interfaz de usuario Azure Portal o el conjunto de comandos de la CLI de Azure.

Si encuentra un error de validación, compruebe que ha rellenado todos los campos de configuración necesarios.

Si parece que la configuración no surte efecto, compruebe que ha seleccionado la opción Guardar en la parte superior de la página de configuración de la interfaz de usuario Azure Portal.

Si ha cambiado la configuración del proxy, tendrá que volver a aprovisionar el software de caché conectada en el equipo host para que la configuración del proxy surta efecto.

Solución de problemas de nodos de caché creados durante la versión preliminar temprana

Los nodos de caché creados e implementados durante la versión preliminar temprana de Microsoft Connected Cache for Enterprise and Education deben seguir funcionando, pero ya no se pueden administrar ni supervisar de forma remota a través del servicio De Azure de caché conectada.

Por lo tanto, se recomienda volver a crear los recursos existentes en Azure y, a continuación, volver a implementar el software de caché conectada en las máquinas host mediante el instalador específico del sistema operativo más reciente.

Solución de problemas de implementación de nodos de caché en la máquina host de Windows

Recopilación de registros de instalación hospedados en Windows

La implementación de un nodo de caché conectada en una máquina host de Windows implica ejecutar una serie de scripts de PowerShell contenidos en el paquete de aprovisionamiento de Windows. Estos scripts intentan escribir archivos de registro en el directorio de instalación especificado en el comando de aprovisionamiento (C:\mccwsl01\InstallLogs de forma predeterminada).

Hay tres tipos de archivos de registro de instalación:

1. WSL_Mcc_Install_Transcript: este archivo de registro registra las líneas impresas en la ventana de PowerShell al ejecutar el script de instalación.
2. WSL_Mcc_Install_FromRegisteredTask_Status: este archivo de registro registra el estado de alto nivel que se escribe durante la instalación de tareas registradas.
3. WSL_Mcc_Install_FromRegisteredTask_Transcript: este archivo de registro registra el estado detallado que se escribe durante la instalación de tareas registradas.

La transcripción de tareas registradas suele ser la más útil para diagnosticar el problema de instalación.

Recopilación de otros registros hospedados en Windows

Una vez que el nodo de caché se haya instalado correctamente en el equipo host de Windows, escribirá periódicamente archivos de registro en el directorio de instalación (C:\mccwsl01\ de forma predeterminada).

Puede esperar ver los siguientes tipos de archivos de registro:

1. WSL_Mcc_Monitor_FromRegisteredTask_Transcript: este archivo de registro registra la salida de la tarea programada "MCC_Monitor_Task" que es responsable de garantizar que la caché conectada continúe ejecutándose.
2. WSL_Mcc_UserUninstall_Transcript: este archivo de registro registra la salida del script "uninstallmcconwsl.ps1" que el usuario puede ejecutar para desinstalar el software MCC de la máquina host.
3. WSL_Mcc_Uninstall_FromRegisteredTask_Transcript: este archivo de registro registra la salida de la tarea programada "MCC_Uninstall_Task" que es responsable de desinstalar el software MCC de la máquina host cuando lo llama el script "uninstallmcconwsl.ps1".

directiva de grupo objeto entra en conflicto con el registro de tareas programadas

Habilitación del objeto directiva de grupo: acceso a la red: no permitir el almacenamiento de contraseñas y credenciales para la autenticación de red impedirá que el software de caché conectada registre las tareas programadas necesarias para el registro y la operación correctos del nodo de caché.

WSL2 no se puede instalar con el mensaje "No existe una sesión de inicio de sesión especificada"

Si encuentra este mensaje de error al intentar ejecutar el comando wsl.exe --install --no-distribution de PowerShell en el equipo host de Windows, compruebe que ha iniciado sesión como administrador local y ejecute el comando desde una ventana de PowerShell con privilegios elevados.

Actualización del kernel de WSL2

Si se produce un error en la instalación de la caché conectada debido a problemas relacionados con WSL, intente ejecutar wsl.exe --update para obtener la versión más reciente del kernel de WSL.

Comprobación de si el contenedor de caché conectada se está ejecutando

Una vez que el software de caché conectada se ha implementado correctamente en la máquina host de Windows, puede comprobar si el nodo de caché se ejecuta correctamente haciendo lo siguiente en el equipo host de Windows:

1. Iniciar un proceso de PowerShell como la cuenta especificada como cuenta en tiempo de ejecución durante la instalación de la caché conectada
2. Ejecución wsl -d Ubuntu-24.04-Mcc-Base para acceder a la distribución de Linux que hospeda el contenedor de caché conectada
3. Ejecutar sudo iotedge list para mostrar qué contenedores se ejecutan en el entorno de ejecución de IoT Edge

Si muestra los contenedores edgeAgent y edgeHub pero no muestra MCC, puede ver el estado del administrador de seguridad de IoT Edge mediante sudo iotedge system logs -- -f.

También puede reiniciar el entorno de ejecución de IoT Edge mediante sudo systemctl restart iotedge.

Comprobación de las tareas programadas de caché conectada

Una vez que se ejecuta el contenedor de caché conectada, se ejecuta periódicamente una tarea programada en la cuenta en tiempo de ejecución de caché conectada para evitar que WSL limpie el contenedor de caché conectada.

Puede usar el Programador de tareas en la máquina host para comprobar el estado de esta tarea programada.

1. Abrir el programador de tareas en el equipo host
2. Vaya a la sección Tareas activas y haga doble clic en MCC_Monitor_Task
3. Seleccione la tarea programada MCC_Monitor_Task
4. Seleccione la pestaña Desencadenadores y confirme que el estado está habilitado.

Nota

Si cambia la contraseña de la cuenta en tiempo de ejecución, deberá actualizar el usuario en todas las tareas programadas de caché conectada para que el nodo Caché conectada siga funcionando correctamente.

Nodo de caché implementado correctamente, pero sin atender solicitudes

Si el nodo de caché no responde a solicitudes fuera de localhost, puede deberse a que las reglas de reenvío de puertos de la máquina host no se establecieron correctamente durante la instalación de la caché conectada. Dado que WSL 2 usa un adaptador Ethernet virtualizado de forma predeterminada, se necesitan reglas de reenvío de puertos para permitir que el tráfico llegue a la instancia de WSL 2 desde la LAN. Para obtener más información, consulte Acceso a aplicaciones de red con WSL.

Para comprobar las reglas de reenvío de puertos de la máquina host, use el siguiente comando de PowerShell.

netsh interface portproxy show v4tov4

Si no ve ninguna regla de reenvío de puertos para el puerto 80 a 0.0.0.0, puede ejecutar el siguiente comando desde una instancia de PowerShell con privilegios elevados para establecer el reenvío adecuado en WSL.

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

Puede recuperar la dirección IP de WSL del wslip.txt archivo que debe estar presente en el directorio de instalación que especificó en el comando de aprovisionamiento de caché conectada ("c:\mccwsl01" de forma predeterminada).

Solución de problemas de implementación de nodos de caché en una máquina host Linux

La implementación de un nodo de caché conectada en una máquina host Linux implica ejecutar una serie de scripts de Bash contenidos en el paquete de aprovisionamiento de Linux.

Una vez que el software de caché conectada se ha implementado correctamente en la máquina host Linux, puede comprobar si el nodo de caché se ejecuta correctamente si hace lo siguiente en el equipo host linux:

1. Ejecutar sudo iotedge list para mostrar qué contenedores se ejecutan en el entorno de ejecución de IoT Edge

Si muestra los contenedores edgeAgent y edgeHub pero no muestra MCC, puede ver el estado del administrador de seguridad de IoT Edge mediante sudo iotedge system logs -- -f.

También puede reiniciar el entorno de ejecución de IoT Edge mediante sudo systemctl restart iotedge.

Generación de una agrupación de compatibilidad de diagnóstico de nodo de caché

Puede generar una agrupación de soporte técnico con información de diagnóstico detallada mediante la ejecución del collectMccDiagnostics.sh script incluido en el paquete de instalación.

En el caso de las máquinas host de Windows, deberá hacer lo siguiente:

1. Iniciar un proceso de PowerShell como la cuenta especificada como cuenta en tiempo de ejecución durante la instalación de la caché conectada

2. Cambie el directorio al directorio "MccScripts" dentro del paquete de aprovisionamiento de caché conectada extraído y compruebe la presencia de collectmccdiagnostics.sh

3. Ejecución wsl bash collectmccdiagnostics.sh para generar la agrupación de compatibilidad de diagnóstico

4. Una vez completado el script, anote la salida de la consola que describe la ubicación de la agrupación de compatibilidad de diagnóstico.

   Por ejemplo, "Paquete comprimido correctamente, envíe el archivo creado en /etc/mccdiagnostics/support_bundle_2024_12_03__11_05_39__AM.tar.gz"

5. Ejecute el wsl cp comando para copiar la agrupación de compatibilidad desde la ubicación dentro de la distribución de Ubuntu al sistema operativo host de Windows.

   Por ejemplo wsl cp /etc/mccdiagnostics/support_bundle_2024_12_03__11_05_39__AM.tar.gz /mnt/c/mccwsl01/SupportBundles

En el caso de las máquinas host linux, deberá hacer lo siguiente:

1. Cambie el directorio al directorio "MccScripts" dentro del paquete de aprovisionamiento de caché conectada extraído y compruebe la presencia de collectmccdiagnostics.sh

2. Ejecución collectmccdiagnostics.sh para generar la agrupación de compatibilidad de diagnóstico

3. Una vez completado el script, anote la salida de la consola que describe la ubicación de la agrupación de compatibilidad de diagnóstico.

   Por ejemplo, "Paquete comprimido correctamente, envíe el archivo creado en /etc/mccdiagnostics/support_bundle_2024_12_03__11_05_39__AM.tar.gz"

Solución de problemas de supervisión de nodos de caché

El estado y el rendimiento del nodo de caché conectada se pueden supervisar mediante la interfaz de usuario Azure Portal.

Si los objetos visuales de supervisión básicos de la pestaña Información general muestran valores inesperados o erróneos, actualice la ventana del explorador.

Si el problema persiste, compruebe que ha configurado los filtros de nodo Intervalo de tiempo y Caché como desee.

Diagnóstico y resolución

También puede usar la funcionalidad Diagnosticar y resolver problemas proporcionada por la interfaz de Azure Portal. Esta pestaña del recurso de Azure de Microsoft Connected Cache le guiará a través de algunas indicaciones para ayudar a restringir la solución al problema.