> 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/troubleshooting-failed-chocolatey-packages.md).

# Dépannage des packages Chocolatey ayant échoué

Diagnostiquez les installations de packages Chocolatey ayant échoué en comprenant les étapes d’installation et en trouvant les messages d’erreur dans les journaux.

Comme expliqué dans la section précédente, l'installation d'un package chocolatey se compose de plusieurs étapes :

1. Initialisation de l'environnement chocolatey et des variables
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 effective à l'aide des binaires d'installation téléchargés.
6. Actions à exécuter après l'installation

Bien que chaque étape puisse échouer et provoquer l'arrêt de l'installation, la probabilité la plus élevée d'échec se situe aux étapes 3, 4 et 5.

## Trouver le bon message d'erreur

Il est important de savoir que toute installation échouée renverra des 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 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]
```

{% endcode %}

Le `Accès 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 package se trouve quelque part dans les lignes précédentes du fichier journal. La recherche du tag `[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 ensuite des messages trompeurs « Accès refusé ».

<figure><img src="https://1100180853-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkrcM7cKOpXKri1kVrh%2Fuploads%2FBPOlb5tEzZXYAtjilVX5%2Fchoco-error-stack.png?alt=media&amp;token=4c5d5eba-d915-45f1-89c0-834ea477db65" alt=""><figcaption><p>Erreur réelle de téléchargement en haut, suivie de la pile d'erreurs standard de chocolatey en bas ; cela peut être trompeur.</p></figcaption></figure>

## 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 même de chocolatey (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" %}
Attention, car ce message (légèrement similaire) peut également apparaître dans le `chocolatey.log` et peut être ignoré sans danger 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 de RealmJoin ne peut pas être atteint, (voir [Considérations relatives à l’infrastructure](https://docs.realmjoin.com/fr/deploiement/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 package n'a pas été trouvé avec les sources listées.
```

{% endcode %}

* Problème avec des arguments de package obligatoires manquants :

{% code overflow="wrap" %}

```log
2023-09-14 13:53:33,982 [ERROR] - ERREUR : L'argument obligatoire 'Serial' n'a pas été fourni, arrêt !
```

{% 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 de la connexion de transport : une connexion établie a été interrompue par le logiciel sur 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/désinstallation

Les erreurs survenant pendant le processus réel d'installation/désinstallation à l'aide du fichier binaire téléchargé peuvent être mieux diagnostiquées en utilisant 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\<package-id>\`si la possibilité d'écrire un journal est fournie par l'installateur.

{% hint style="info" %}
Lorsqu'un installateur MSI a été utilisé, les codes de sortie sont normalisé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
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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.realmjoin.com/fr/depannage-et-faq/troubleshooting/package-installation-issues/troubleshooting-failed-chocolatey-packages.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
