Dépannage des packages chocolatey ayant échoué

Diagnostiquez les installations de packages Chocolatey ayant échoué en comprenant les étapes d'installation et en recherchant les messages d'erreur dans les journaux.

Comme expliqué dans la section précédente, l'installation d'un package chocolatey se compose de plusieurs étapes :

1. Initialisation de l'environnement et des variables chocolatey
2. Vérification des installations existantes du logiciel à installer
3. Désinstallation éventuelle des installations existantes
4. Téléchargement des fichiers binaires
5. Installation proprement dite à l'aide des binaires d'installation téléchargés.
6. Actions postérieures à exécuter après l'installation

Même si chaque étape peut échouer et provoquer l'interruption de l'installation, la probabilité d'échec la plus élevée se situe aux étapes 3, 4 et 5.

Trouver le bon message d'erreur

Il est important de savoir que toute installation échouée renverra les messages standard de la pile d'erreurs chocolatey, qui ressembleront à ceci :

2021-08-23 09:48:58,465 [DEBUG] - Déplacement de 'C:\ProgramData\chocolatey\lib\generic-autodesk-navisworks-freedom-2022'
 vers 'C:\ProgramData\chocolatey\lib-bad\generic-autodesk-navisworks-freedom-2022'
2021-08-23 09:48:58,480 [WARN ] - Il s'agit de l'essai 1/3. Nouvelle tentative après 300 millisecondes.
 Erreur convertie en avertissement :
 (5) Accès refusé : [\\?\C:\ProgramData\chocolatey\lib-bad\generic-autodesk-navisworks-freedom-2022]

Le Accès refusé Le message appartient à la pile d'erreurs standard de chocolatey et doit être ignoré. L'erreur réelle à l'origine de l'échec de l'installation du package se trouve quelque part dans les lignes précédentes du fichier journal. La recherche de la balise [ERROR] permettra de trouver les bons messages.

Voyez comment, dans cet exemple, l'erreur réelle se produit en haut (404 pour le téléchargement), mais la pile d'erreurs chocolatey affiche ensuite des messages trompeurs « Accès refusé ».

L'erreur de téléchargement réelle en haut, suivie de la pile d'erreurs standard de chocolatey en bas, peut prêter à confusion.

Exemples d'installations échouées

Erreurs survenant pendant l'initialisation

Pendant la phase d'initialisation, des erreurs peuvent survenir pour les raisons suivantes :

• Problème avec l'installation de chocolatey elle-même (configuration corrompue, fichiers manquants) :

2023-10-10 10:28:32,523 [ERROR] - Erreur lors de la désérialisation de la réponse de type chocolatey.infrastructure.app.configuration.ConfigFileSettings :
 '.', la valeur hexadécimale 0x00 est un caractère invalide. Ligne 1, position 1.
2023-10-10 10:28:32,535 [ERROR] - '.', la valeur hexadécimale 0x00 est un caractère invalide. Ligne 1, position 1.
2023-10-10 10:28:32,537 [DEBUG] - Sortie avec le code 1

Attention, ce message (légèrement similaire) peut également apparaître dans le chocolatey.log également, mais il peut être ignoré sans risque et ne nécessite aucune action !

2023-11-21 11:46:10,365 [ERROR] - Erreur lors de la sérialisation du type chocolatey.infrastructure.app.configuration.ConfigFileSettings :
 L'accès au chemin 'C:\ProgramData\chocolatey\config\chocolatey.config.update' est refusé.

• Problème réseau, lorsque le serveur nuget RealmJoin est inaccessible, (voir Considérations d’infrastructure):

2023-09-08 13:01:47,335 [ERROR] - generic-adobe-reader-dc-continuous n'est pas installé. Le package n'a pas été trouvé avec les sources répertoriées.

• Problème dû à l'absence d'arguments de package obligatoires :

2023-09-14 13:53:33,982 [ERROR] - ERREUR : l'argument obligatoire 'Serial' n'a pas été fourni, abandon !

Erreurs survenant pendant le téléchargement

Pour les erreurs impliquant le téléchargement des binaires, le message d'erreur inclura généralement l'URL de téléchargement contenant cdn.realmjoin.com, exemples :

2023-10-16 13:04:52,952 [ERROR] - ERREUR : le fichier distant n'existe pas, n'est pas autorisé ou est interdit pour l'URL 'https://cdn.realmjoin.com/blobs/generic/generic-adobe-acrobat-dc-continuous/AcrobatDCUpd2300620320.msp'. Exception lors de l'appel de "GetResult" avec 0 argument(s) : "Impossible de lire les données de la connexion de transport : une connexion établie a été interrompue par le logiciel de votre machine hôte."

2021-08-23 09:36:08,874 [ERROR] - ERREUR : le fichier distant n'existe pas, n'est pas autorisé ou est interdit pour l'URL 'https://cdn.realmjoin.com/blobs/generic/generic-adobe-acrobat-dc-continuous/AcrobatDCUpd2300620320.msp'. Exception lors de l'appel de "GetResult" avec 0 argument(s) : "L'espace disque est insuffisant"

Erreurs survenant pendant le processus d'(dés)installation

Les erreurs survenant pendant le processus réel d'(dés)installation à l'aide du fichier binaire téléchargé peuvent être le mieux diagnostiquées à l'aide de deux éléments :

1. Le code de sortie renvoyé par le processus d'installation.
2. Le fichier journal écrit par le processus d'installation, situé dans C:\Windows\Logs\RealmJoin\Packages\<package-id>\si l'installateur permet d'écrire un journal.

Lorsqu'un installateur MSI a été utilisé, les codes de sortie sont standardisés et peuvent être consultés ici. De plus, les installateurs MSI écriront toujours des fichiers journaux dans le dossier mentionné ci-dessus. En particulier lorsque le code de sortie 1603 a été renvoyé (erreur MSI générique), le fichier journal MSI sera indispensable au dépannage.