Solución de problemas de paquetes chocolatey fallidos

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 variables de chocolatey

2. Comprobación de instalaciones existentes del software a instalar

3. Posible desinstalación de instalaciones existentes

4. Descarga de archivos binarios

5. Instalación real usando los binarios de configuración descargados.

6. Acciones posteriores a ejecutar después de la instalación

Aunque cada etapa tiene la posibilidad de fallar y causar que la instalación se aborte, la mayor probabilidad de fallos está en las etapas 3, 4 y 5.

Encontrar el mensaje de error correcto

Es importante saber que cada 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 ] - Esta es la prueba 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]

debe tener un buzón conectado, para que podamos notificarle en caso de que haya problemas relevantes con RealmJoin. Si desea cambiarlo, por favor Acceso denegado el mensaje pertenece a la pila de errores estándar de chocolatey y debe ser ignorado. El error real que está causando que la instalación del paquete falle se encuentra en alguna 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 ocurrir 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 del tipo chocolatey.infrastructure.app.configuration.ConfigFileSettings:
 '.', el valor hexadecimal 0x00, es un carácter inválido. Línea 1, posición 1.
2023-10-10 10:28:32,535 [ERROR] - '.', el valor hexadecimal 0x00, es un carácter invá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) puede ocurrir en el chocolatey.log también, pero esto se puede ignorar de forma segura y no requiere acción alguna.

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

• Problema de red, cuando no se puede alcanzar el servidor nuget de RealmJoin, (ver Consideraciones de infraestructura):

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

• Problema por argumentos obligatorios del paquete ausentes:

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 que implican la descarga de los binarios, el mensaje de error usualmente incluirá la URL de descarga que contiene cdn.realmjoin.com, ejemplos:

2023-10-16 13:04:52,952 [ERROR] - ERROR: El archivo remoto o bien 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 desde la conexión de transporte: Una conexión establecida fue abortada por el software en su máquina host."

2021-08-23 09:36:08,874 [ERROR] - ERROR: El archivo remoto o bien 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 se pueden solucionar mejor usando 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, ubicado dentro de C:\WINDOWS\Logs\RealmJoin\Packages\<package-id>\, si el instalador proporciona la posibilidad de escribir registro.

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