# Dépannage des packages chocolatey échoués
Comme expliqué dans la section précédente, l’installation d’un paquet 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 entraîner l’interruption de l’installation, les probabilités d’échec les plus élevées se situent 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 :
{% code overflow="wrap" fullWidth="false" %}
```log
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 ] - Ceci est l'essai 1/3. Nouvelle tentative après 300 millisecondes.
Erreur convertie en avertissement :
(5) L'accès est refusé : [\\?\C:\ProgramData\chocolatey\lib-bad\generic-autodesk-navisworks-freedom-2022]
```
{% endcode %}
Le `L'accès est refusé` le message appartient à la pile d’erreurs standard de chocolatey et doit être ignoré. La véritable erreur qui provoque l’échec de l’installation du paquet se trouve quelque part dans les lignes précédentes du fichier journal. Rechercher la balise `[ERROR]` aidera à 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 plus tard quelques messages trompeurs « L’accès est refusé ».
Erreur de téléchargement réelle en haut suivie de la pile d’erreurs standard chocolatey en bas, peut être trompeur.
## 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 chocolatey elle-même (configuration corrompue, fichiers manquants) :
{% code overflow="wrap" %}
```log
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 non valide. Ligne 1, position 1.
2023-10-10 10:28:32,535 [ERROR] - '.', la valeur hexadécimale 0x00 est un caractère non valide. Ligne 1, position 1.
2023-10-10 10:28:32,537 [DEBUG] - Sortie avec 1
```
{% endcode %}
{% hint style="warning" %}
Faites attention, car ce message (légèrement similaire) peut également apparaître dans `chocolatey.log` mais il est sans danger de l’ignorer et ne nécessite aucune action !
{% code overflow="wrap" %}
```log
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é.
```
{% endcode %}
{% endhint %}
* Problème réseau, lorsque le serveur nuget RealmJoin est inaccessible, (voir [Considérations sur l’infrastructure](/fr/deploiement-realmjoin/infrastructure.md#realmjoin-connection-endpoints)):
{% code overflow="wrap" %}
```log
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 source(s) listée(s).
```
{% endcode %}
* Problème avec des arguments de paquet obligatoires manquants :
{% code overflow="wrap" %}
```log
2023-09-14 13:53:33,982 [ERROR] - ERREUR : l'argument obligatoire 'Serial' n'a pas été fourni, abandon !
```
{% endcode %}
### 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 :
{% code overflow="wrap" %}
```log
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 depuis la connexion de transport : une connexion établie a été interrompue par le logiciel de votre machine hôte."
```
{% endcode %}
{% code overflow="wrap" %}
```log
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) : "Il n’y a pas assez d’espace sur le disque"
```
{% endcode %}
### Erreurs survenant pendant le processus d’installation/de désinstallation
Les erreurs survenant pendant le processus réel d’installation/de désinstallation à 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\\`, si l’installateur offre la possibilité d’écrire un journal.
{% hint style="info" %}
Lorsqu’un installateur MSI a été utilisé, les codes de sortie sont standardisés et peuvent être consultés [ici](https://learn.microsoft.com/en-us/windows/win32/msi/error-codes). De plus, les installateurs MSI écriront toujours des fichiers journal dans le dossier mentionné ci-dessus. Surtout lorsque le code de sortie `1603` a été renvoyé (erreur MSI générique), le fichier journal MSI sera indispensable pour le dépannage.
{% endhint %}
---
# Agent Instructions: 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:
```
GET https://docs.realmjoin.com/fr/autre/troubleshooting/package-installation-issues/troubleshooting-failed-chocolatey-packages.md?ask=
```
The question should be specific, self-contained, and written in natural language.
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.