Solución de problemas de paquetes de chocolatey fallidos

Diagnostica las instalaciones fallidas de paquetes de Chocolatey comprendiendo las fases de instalación y encontrando mensajes de error en los registros.

Como se explicó en la sección anterior, la instalación de un paquete de chocolatey consta de varias etapas:

1. Inicialización del entorno y las variables de chocolatey
2. Comprobación de instalaciones existentes del software que se va a instalar
3. Posible desinstalación de instalaciones existentes
4. Descarga de archivos binarios
5. Instalación real usando los binarios de instalación descargados.
6. Acciones posteriores que se ejecutarán después de la instalación

Aunque cada etapa puede fallar y provocar que la instalación se interrumpa, la mayor probabilidad de fallos está en las etapas 3, 4 y 5.

Encontrar el mensaje de error correcto

Es importante saber que toda instalación fallida devolverá mensajes estándar de la pila de errores de chocolatey, que se verán similares a esto:

2021-08-23 09:48:58,465 [DEBUG] - Moviendo 'C:\ProgramData\chocolatey\lib\generic-autodesk-navisworks-freedom-2022'
 a 'C:\ProgramData\chocolatey\lib-bad\generic-autodesk-navisworks-freedom-2022'
2021-08-23 09:48:58,480 [WARN ] - Este es el intento 1/3. Reintentando después de 300 milisegundos.
 Error convertido en advertencia:
 (5) Acceso denegado: [\\?\C:\ProgramData\chocolatey\lib-bad\generic-autodesk-navisworks-freedom-2022]

El Acceso denegado el mensaje pertenece a la pila de errores estándar de chocolatey y debe ignorarse. El error real que está provocando que falle la instalación del paquete se encuentra en alguna parte de las líneas anteriores del archivo de registro. Buscar la etiqueta [ERROR] ayudará a encontrar los mensajes correctos.

Vea cómo en este ejemplo el error real ocurre en la parte superior (404 para la descarga), pero la pila de errores de chocolatey imprime después algunos mensajes engañosos de 'Acceso denegado'.

El error real de descarga en la parte superior, seguido por la pila de errores estándar de chocolatey en la parte inferior, puede ser engañoso.

Ejemplos de instalaciones fallidas

Errores que ocurren durante la inicialización

Durante la fase de inicialización, pueden producirse errores por las siguientes razones:

• Problema con la propia instalación de chocolatey (configuración dañada, archivos faltantes):

2023-10-10 10:28:32,523 [ERROR] - Error al deserializar la respuesta de tipo chocolatey.infrastructure.app.configuration.ConfigFileSettings:
 '.', el valor hexadecimal 0x00, es un carácter no válido. Línea 1, posición 1.
2023-10-10 10:28:32,535 [ERROR] - '.', el valor hexadecimal 0x00, es un carácter no válido. Línea 1, posición 1.
2023-10-10 10:28:32,537 [DEBUG] - Saliendo con 1

Tenga cuidado, ya que este mensaje (ligeramente similar) también puede aparecer en el chocolatey.log también, pero esto se puede ignorar de forma segura y no requiere ninguna acción!

2023-11-21 11:46:10,365 [ERROR] - Error al serializar el tipo chocolatey.infrastructure.app.configuration.ConfigFileSettings:
 Se denegó el acceso a la ruta 'C:\ProgramData\chocolatey\config\chocolatey.config.update'.

• Problema de red, cuando no se puede alcanzar el servidor NuGet de RealmJoin, (véase Consideraciones de infraestructura):

2023-09-08 13:01:47,335 [ERROR] - generic-adobe-reader-dc-continuous no está instalado. El paquete no se encontró con la(s) fuente(s) indicada(s).

• Problema con los argumentos obligatorios del paquete faltantes:

2023-09-14 13:53:33,982 [ERROR] - ERROR: No se proporcionó el argumento obligatorio 'Serial', ¡abortando!

Errores que ocurren durante la descarga

Para errores relacionados con la descarga de los binarios, el mensaje de error normalmente incluirá la URL de descarga que contiene cdn.realmjoin.com, ejemplos:

2023-10-16 13:04:52,952 [ERROR] - ERROR: El archivo remoto no existe, no está autorizado o está prohibido para la URL 'https://cdn.realmjoin.com/blobs/generic/generic-adobe-acrobat-dc-continuous/AcrobatDCUpd2300620320.msp'. Excepción al llamar a "GetResult" con 0 argumento(s): "No se pueden leer datos de la conexión de transporte: Una conexión establecida fue abortada por el software de su máquina host."

2021-08-23 09:36:08,874 [ERROR] - ERROR: El archivo remoto no existe, no está autorizado o está prohibido para la URL 'https://cdn.realmjoin.com/blobs/generic/generic-adobe-acrobat-dc-continuous/AcrobatDCUpd2300620320.msp'. Excepción al llamar a "GetResult" con 0 argumento(s): "No hay suficiente espacio en el disco"

Errores que ocurren durante el proceso de (des)instalación

Los errores que ocurren durante el proceso real de (des)instalación usando el archivo binario descargado pueden depurarse mejor utilizando dos cosas:

1. El código de salida devuelto por el proceso de instalación.
2. El archivo de registro escrito por el proceso de instalación, que se encuentra dentro de C:\WINDOWS\Logs\RealmJoin\Packages\<package-id>\, si el instalador proporciona la posibilidad de escribir un registro.

Cuando se utilizó un instalador MSI, los códigos de salida están estandarizados y pueden consultarse aquí. Además, los instaladores MSI siempre escribirán archivos de registro en la carpeta mencionada arriba. Especialmente cuando se devolvió el código de salida 1603 se devolvió (error genérico de MSI), el archivo de registro MSI será obligatorio para la resolución de problemas.