Dépannage des packages chocolatey échoués

Comme expliqué dans la section précédente, l'installation d'un paquet chocolatey consiste en plusieurs étapes :

1. Initialisation de l'environnement et des variables chocolatey

2. Vérification des installations existantes du logiciel à installer

3. Éventuelle désinstallation des installations existantes

4. Téléchargement des fichiers binaires

5. Installation effective en utilisant les fichiers d'installation binaires téléchargés.

6. Actions post-installation à exécuter après l'installation

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

Trouver le message d'erreur correct

Il est important de savoir que chaque installation échouée retournera les messages d'erreur standards 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 ] - C'est la tentative 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]

et un Accès refusé le message appartient à la pile d'erreurs standard de chocolatey et doit être ignoré. L'erreur réelle qui fait échouer l'installation du paquet se trouve quelque part dans les lignes précédentes du fichier journal. La recherche du tag [ERROR] aidera à trouver les messages corrects.

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

Une erreur de téléchargement réelle en haut suivie de la pile d'erreurs standard de chocolatey en bas peut être trompeuse.

Exemples d'installations échouées

Erreurs survenant lors de 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 de désérialisation de la réponse du 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 1

Faites attention, car ce message (légèrement similaire) peut apparaître dans le chocolatey.log également, mais il est sans danger et ne nécessite aucune action !

2023-11-21 11:46:10,365 [ERROR] - Erreur de sérialisation du type chocolatey.infrastructure.app.configuration.ConfigFileSettings :
 Accès au chemin 'C:\ProgramData\chocolatey\config\chocolatey.config.update' 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 non installé. Le paquet n'a pas été trouvé avec la ou les sources listées.

• Problème d'arguments obligatoires du paquet manquants :

2023-09-14 13:53:33,982 [ERROR] - ERREUR : l'argument obligatoire 'Serial' non fourni, abandon !

Erreurs survenant lors du 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 soit 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 appelant "GetResult" avec "0" argument(s) : "Impossible de lire les données depuis 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 soit 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 appelant "GetResult" avec "0" argument(s) : "Il n'y a pas assez d'espace sur le disque"

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

Les erreurs survenant pendant le processus réel de (dés)installation utilisant le fichier binaire téléchargé peuvent être dépannées au mieux en utilisant deux éléments :

1. Le code de sortie retourné par le processus d'installation.

2. Le fichier journal écrit par le processus d'installation, trouvé à l'intérieur C:\WINDOWS\Logs\RealmJoin\Packages\<package-id>\, si la possibilité d'écrire le journal est fournie par l'installateur.

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. Surtout lorsque le code de sortie 1603 a été retourné (erreur MSI générique), le fichier journal MSI sera obligatoire pour le dépannage.