Analyse de chocolatey.log

Cette partie se concentrera sur la manière de dépanner les installations de packages chocolatey échouées.

Exigences

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 capacités de recherche avancées, recommandé : Notepad++, Visual Studio Code.

• ID du paquet ayant échoué, par exemple generic-mozilla-firefox.

• Horodatage de(s) installation(s) échouée(s) (pas 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 paquet à l'intérieur de chocolatey.log utilisez cette chaîne de recherche exacte (adaptez l'ID du paquet 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)

De cette façon, vous trouverez le(s) point(s) de départ du processus choco pour l'installation ou la mise à jour du paquet donné.

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

2023-08-22 15:05:36,664 [DEBUG] - Command line: "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 à l'intérieur de chocolatey.log

Cette ligne contient déjà des informations importantes, comme le numéro de version du paquet à installer, ainsi que les paramètres utilisés (arguments du paquet 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: Input Environment Variables et RJAppDeployToolkit: Resulting Variables. Les deux sections sont situées l'une à côté de l'autre et montrent les variables et valeurs fournies par le RJAppDeployToolkit

Sortie de RJAppDeployToolkit

Processus d'installation

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

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

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

2023-08-22 15:05:47,057 [DEBUG] - Entered function 'Get-RealmjoinRegistryUninstallInfo' with parameters [...]]

2023-08-22 15:05:47,053 [DEBUG] - Entered function 'Uninstall-RealmjoinPackage' with parameters [...]]

Après les vérifications et les éventuelles désinstallations, l'installation principale de l'application commencera, indiquée par le message de journal suivant (le nom de fichier diffèrera bien sûr) :

2023-08-22 15:05:47,858 [INFO ] - Starting RealmJoin-Install of Git-2.42.0-64-bit.exe

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

2023-08-22 15:05:48,273 [INFO ] - Downloading generic-git-git from 'https://cdn.realmjoin.com/blobs/generic/generic-git-git/Git-2.42.0-64-bit.exe'

[...]

2023-08-22 15:05:57,293 [INFO ] - Download of Git-2.42.0-64-bit.exe (58.35 MB) completed.

Après avoir terminé 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 enfin exécuté. Le message de journal pour l'exécution peut être trouvé par le message suivant :

2023-08-22 15:06:00,743 [DEBUG] - Elevating Permissions and running ["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" ]. This may take a while, depending on the statements.

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, si proposé par le fichier d'installation et inclus dans le script du paquet.

Après la fermeture 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 retourné 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] - Command ["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" ] exited with '0'.

Selon le paquet, l'installation du paquet peut maintenant être suivie par les soi-disant 'postActions', qui peuvent être des paramètres de registre, la suppression d'icônes de bureau, ou même l'exécution d'un autre fichier d'installation (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 ] - Running postActions...
2023-09-13 16:49:20,894 7224 [INFO ] - postActions finished.

Le processus d'installation chocolatey sera clôturé par le message de journal suivant (la formulation peut différer selon l'installation / la mise à jour) :

2023-09-13 17:01:39,433 8336 [INFO ] - The install of generic-google-chrome was successful.