Analyse de chocolatey.log

Cette partie se concentrera sur la façon de dépanner les installations de packages chocolatey ayant échoué.

Prérequis

Les éléments suivants sont requis ou utiles pour le dépannage :

• Fichiers journaux, en particulier chocolatey.log.
• Éditeur de texte de votre choix avec des fonctions de recherche avancées, recommandé : Notepad++, Visual Studio Code.
• ID du package en échec, par exemple generic-mozilla-firefox.
• Horodatage de la ou des installations ayant échoué (non obligatoire, mais utile).

Structure du fichier journal

Point d'entrée et informations de débogage

Pour trouver le point d'entrée de l'installation du package dans le chocolatey.log utilisez exactement cette chaîne de recherche (adaptez l'identifiant du package en conséquence) : generic-mozilla-firefox --version= (si vous êtes sûr de la chaîne de version, vous pouvez bien sûr l'ajouter, mais ce n'est pas obligatoire)

Ainsi, vous trouverez le ou les points de démarrage du processus choco pour l'installation ou la mise à niveau de l'identifiant de package donné.

La ligne complète dans le journal peut ressembler à ceci, au lieu de mise à niveau peut aussi être installation selon l'opération :

2023-08-22 15:05:36,664 [DEBUG] - Ligne de commande : "C:\ProgramData\chocolatey\choco.exe" upgrade generic-mozilla-firefox --version=117.0.0.0 --force --yes --ignore-package-exit-codes --timeout=14400 --params="/BlockAddons:1"

Point d'entrée d'une installation choco dans chocolatey.log

Cette ligne contient déjà des informations importantes, comme le numéro de version du package à installer, ainsi que les paramètres utilisés (arguments du package configurés dans le portail RealmJoin).

Les lignes suivantes contiendront beaucoup d'informations de débogage (non pertinentes) ; entre autres, le contenu complet de chocolateyInstall.ps1 sera affiché. Dans les informations de débogage, vous trouverez les deux sections RJAppDeployToolkit : variables d'environnement d'entrée et RJAppDeployToolkit : variables résultantes. Les deux sections sont placées l'une à côté de l'autre et affichent les variables et les valeurs fournies par RJAppDeployToolkit

Sortie de RJAppDeployToolkit

Processus d'installation

Le script d'installation réel du package démarre après le message de journal suivant :

2023-08-22 15:05:47,000 [DEBUG] - Exécution de 'C:\ProgramData\chocolatey\lib\generic-mozilla-firefox\tools\chocolateyInstall.ps1'

Selon le script d'installation du package et l'état du client, la première étape consiste généralement à vérifier si le logiciel est déjà installé. Cela permet de déterminer si une désinstallation sera nécessaire avant l'installation proprement dite. Dans les journaux, cela peut être suivi à l'aide d'un ou de plusieurs des messages de journal suivants :

2023-08-22 15:05:47,057 [DEBUG] - Fonction 'Get-RealmjoinRegistryUninstallInfo' entrée avec les paramètres [...]]

2023-08-22 15:05:47,053 [DEBUG] - Fonction 'Uninstall-RealmjoinPackage' entrée avec les paramètres [...]]

Après l'exécution des vérifications et des désinstallations éventuelles, l'installation principale de l'application démarrera, indiquée par le message de journal suivant (le nom de fichier sera bien sûr différent) :

2023-08-22 15:05:47,858 [INFO ] - Démarrage de l'installation RealmJoin de Git-2.42.0-64-bit.exe

L'installation commence généralement par le téléchargement du fichier binaire. Le début et la fin du téléchargement sont indiqués par les messages de journal suivants :

2023-08-22 15:05:48,273 [INFO ] - Téléchargement de generic-git-git depuis 'https://cdn.realmjoin.com/blobs/generic/generic-git-git/Git-2.42.0-64-bit.exe'

[...]

2023-08-22 15:05:57,293 [INFO ] - Téléchargement de Git-2.42.0-64-bit.exe (58.35 MB) terminé.

Après le téléchargement, chocolatey vérifiera le hachage du fichier téléchargé et le comparera à la valeur attendue. Si les hachages correspondent, le fichier d'installation sera finalement exécuté. Le message de journal correspondant à l'exécution peut être trouvé grâce au message suivant :

2023-08-22 15:06:00,743 [DEBUG] - Élévation des privilèges et exécution de ["C:\WINDOWS\TEMP\chocolatey\generic-git-git\2.42.0.0\Git-2.42.0-64-bit.exe" /verysilent /norestart /log="C:\WINDOWS\Logs\RealmJoin\Packages\generic-git-git\2023-08-22_15-05-47.916_generic-git-git_2.42.0.0_install_Git-2.42.0-64-bit.exe.log" ]. Cela peut prendre un certain temps, selon les paramètres.

Ce message inclut le chemin du fichier d'installation, ainsi que la ligne de commande complète, y compris tous les paramètres (silencieux) utilisés pour lancer le fichier d'installation. Il aidera également à trouver le chemin du fichier journal d'installation pertinent, s'il est fourni par le fichier d'installation et inclus dans le script du package.

Après la fin du processus, un autre message de journal sera écrit, incluant à nouveau le chemin complet du fichier et tous les paramètres. De plus, ce message inclura également le code de sortie renvoyé par le processus d'installation, l'indicateur le plus important d'une installation réussie ou non :

2023-08-22 15:06:52,321 [DEBUG] - La commande ["C:\WINDOWS\TEMP\chocolatey\generic-git-git\2.42.0.0\Git-2.42.0-64-bit.exe" /verysilent /norestart /log="C:\WINDOWS\Logs\RealmJoin\Packages\generic-git-git\2023-08-22_15-05-47.916_generic-git-git_2.42.0.0_install_Git-2.42.0-64-bit.exe.log" ] s'est terminée avec '0'.

Selon le package, l'installation peut désormais être suivie de ce qu'on appelle des « postActions », qui peuvent consister en certains paramètres du registre, la suppression d'icônes du bureau, ou même l'exécution d'un autre fichier d'installation (en recommençant par le téléchargement de ce fichier). La partie postActions sera indiquée par les messages de début et de fin suivants dans le fichier journal :

2023-09-13 16:49:18,550 7224 [INFO ] - Exécution des postActions...
2023-09-13 16:49:20,894 7224 [INFO ] - postActions terminées.

Le processus d'installation chocolatey se terminera par le message de journal suivant (la formulation peut varier selon l'installation / la mise à niveau) :

2023-09-13 17:01:39,433 8336 [INFO ] - L'installation de generic-google-chrome a réussi.