> For the complete documentation index, see [llms.txt](https://docs.realmjoin.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.realmjoin.com/fr/depannage-et-faq/troubleshooting/package-installation-issues/analysing-chocolatey.log.md).
# Analyse de chocolatey.log
## 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 :
{% code overflow="wrap" fullWidth="false" %}
```log
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"
```
{% endcode %}
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 :
{% code overflow="wrap" %}
```log
2023-08-22 15:05:47,000 [DEBUG] - Exécution de 'C:\ProgramData\chocolatey\lib\generic-mozilla-firefox\tools\chocolateyInstall.ps1'
```
{% endcode %}
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 :
{% code overflow="wrap" %}
```log
2023-08-22 15:05:47,057 [DEBUG] - Fonction 'Get-RealmjoinRegistryUninstallInfo' entrée avec les paramètres [...]]
```
{% endcode %}
{% code overflow="wrap" %}
```log
2023-08-22 15:05:47,053 [DEBUG] - Fonction 'Uninstall-RealmjoinPackage' entrée avec les paramètres [...]]
```
{% endcode %}
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) :
{% code overflow="wrap" %}
```log
2023-08-22 15:05:47,858 [INFO ] - Démarrage de l'installation RealmJoin de Git-2.42.0-64-bit.exe
```
{% endcode %}
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 :
{% code overflow="wrap" %}
```log
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é.
```
{% endcode %}
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 :
{% code overflow="wrap" %}
```log
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.
```
{% endcode %}
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 :
{% code overflow="wrap" %}
```log
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'.
```
{% endcode %}
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 :
{% code overflow="wrap" %}
```log
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.
```
{% endcode %}
Le processus d'installation chocolatey se terminera par le message de journal suivant (la formulation peut varier selon l'installation / la mise à niveau) :
{% code overflow="wrap" %}
```log
2023-09-13 17:01:39,433 8336 [INFO ] - L'installation de generic-google-chrome a réussi.
```
{% endcode %}
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://docs.realmjoin.com/fr/depannage-et-faq/troubleshooting/package-installation-issues/analysing-chocolatey.log.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.