# Correctifs pour les problèmes courants

{% hint style="danger" %}
**N’utilisez ces correctifs que dans les scénarios décrits !** 

**Ils ne sont pas destinés à être appliqués aveuglément, car ils peuvent faire plus de mal s’ils sont appliqués inutilement.**
{% endhint %}

## Problèmes BranchCache

* Message d’erreur `Il n’y a pas assez d’espace sur le disque` (peut également apparaître localisé, selon la langue du système d’exploitation Windows) lors de la phase de téléchargement, code de sortie Chocolatey `404`:
  1. Ouvrez PowerShell en mode élevé
  2. Exécutez `Clear-BCCache -Force`
* Message d’erreur `L’objet fourni n’a pas été initialisé` (peut également apparaître localisé, selon la langue du système d’exploitation Windows) lors de la phase de téléchargement, code de sortie Chocolatey `404`:
  1. Ouvrez PowerShell en mode élevé
  2. Exécutez `Reset-BC -Force`
* Message d’erreur `Erreur - les empreintes ne correspondent pas. La valeur réelle était « 123abcd »`:
  1. Ouvrez PowerShell en mode élevé
  2. Exécutez `Reset-BC -Force` 

{% hint style="warning" %}
Nous recommandons vivement de déployer le **Réinitialiser ou effacer BranchCache** script de remédiation avec une planification quotidienne. Il peut être trouvé dans la section [Scripts de remédiation](https://docs.realmjoin.com/fr/automatisation/remediation-scripts) du portail RealmJoin. 

En utilisant cette méthode, les problèmes BranchCache mentionnés ci-dessus seront détectés de manière proactive et automatiquement corrigés (si possible).
{% endhint %}

## Arguments de package manquants / incorrects <a href="#user-content-missing-wrong-package-arguments" id="user-content-missing-wrong-package-arguments"></a>

1. Vérifiez le `chocolatey.log` fichier pour la ou les valeur(s) de `packageParameters` dans la section `RJAppDeployToolkit: Resulting Variables`
   * Ce sont la ou les valeur(s) réelles utilisées pour l’installation et transmises par le backend RealmJoin.
2. Si elles ne correspondent pas à la ou aux valeur(s) attendue(s), vérifiez l’affectation du package dans le portail RealmJoin pour les valeurs de remplacement de groupe / utilisateur.

## Fichier .nupkg corrompu

Si vous voyez l’erreur suivante dans le `chocolatey.log`  le fichier .nupkg a été corrompu :&#x20;

`[ERROR] - Unable to read package from path 'generic-package-id\generic-package-id.nupkg'.`&#x20;

On peut souvent aussi constater que le fichier .nupkg a une taille de 0 octet.

Étapes pour corriger ce problème :

1. Accédez à `C:\ProgramData\chocolatey\lib`
2. Supprimez le dossier `generic-package-id`&#x20;

## Configuration Chocolatey défectueuse <a href="#user-content-broken-chocolatey-config" id="user-content-broken-chocolatey-config"></a>

1. Supprimez le contenu du dossier `C:\ProgramData\chocolatey\config`
2. Supprimez la variable système `ChocolateyInstall` :
   * Utilisez l’interface graphique : exécutez `sysdm.cpl` -> Onglet `Avancé` -> `Variables d’environnement...`
   * Utilisez cmd (admin), exécutez : `REG delete "HKLM\SYSTEM\CurrentControlSet\Control\Session Manager\Environment" /V ChocolateyInstall`
3. Redémarrez
4. Le tray RealmJoin réinstallera Chocolatey, laissez le système se stabiliser pendant 5 à 10 minutes.
5. Si des éléments manquent dans le menu du tray RealmJoin, redémarrez à nouveau.

## Problèmes généraux d’installation <a href="#user-content-general-setup-issues" id="user-content-general-setup-issues"></a>

**Comme ceux-ci sont très individuels, il s’agit simplement d’une collection d’étapes générales de dépannage pour aider à cerner le problème.**

* Vérifiez la présence de fichier(s) journal(aux) dans `C:\WINDOWS\Logs\RealmJoin\Packages\<package-id>\`.
  * Essayez d’analyser le ou les fichiers journaux et de trouver le problème.
* Si aucun fichier journal n’est présent, ou s’il n’est pas utile, essayez d’exécuter manuellement l’installation en mode GUI, afin de voir les éventuels messages d’erreur.
  * IMPORTANT : les packages système RealmJoin sont toujours installés à l’aide du compte intégré `NT AUTHORITY\SYSTEM` il est donc préférable d’utiliser un outil comme `psexec` pour lancer l’installation depuis ce compte.
  * La plupart du temps, exécuter l’installation avec un compte administrateur local standard fournira la même erreur, donc exécuter depuis `NT AUTHORITY\SYSTEM` peut ne pas être nécessaire.

### Package non disponible à l’installation / n’apparaît pas dans le menu du tray RealmJoin <a href="#user-content-package-not-available-to-install-not-showing-in-realmjoin-tray-menu" id="user-content-package-not-available-to-install-not-showing-in-realmjoin-tray-menu"></a>

* Vérifiez si le package est correctement affecté à l’utilisateur ou si l’utilisateur est membre du groupe affecté
* Vérifiez si le package n’est pas affecté en mode masqué (utilisez le mode débogage pour voir les packages affectés masqués)
* Vérifiez si l’utilisateur est l’utilisateur principal du client, sinon vérifiez si le package est configuré pour être disponible pour les utilisateurs secondaires

## ConfigUpdater non autorisé <a href="#user-content-broken-chocolatey-config" id="user-content-broken-chocolatey-config"></a>

<figure><img src="https://1100180853-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkrcM7cKOpXKri1kVrh%2Fuploads%2FxKesgpauzdfJFk4dj4Ep%2F25-07-02-10_40_03_Photos.png?alt=media&#x26;token=bbc6af39-5123-4135-a2a2-f2727cc13acb" alt=""><figcaption><p>L’agent RJ ne peut pas accéder à la configuration</p></figcaption></figure>

Le problème principal à l’origine de ce problème est que le jeton d’accès n’a pas été actualisé automatiquement comme prévu. En règle générale, les jetons d’accès sont mis à jour automatiquement afin de garantir un accès ininterrompu aux ressources. Cependant, dans ce cas, le processus attendu a échoué, ce qui a rendu le jeton obsolète et a donc entraîné des problèmes d’accès. Cela souligne l’importance de s’assurer que les mécanismes de rafraîchissement automatique des jetons fonctionnent correctement afin d’éviter des problèmes similaires à l’avenir. La résolution de cette cause racine aidera à maintenir un accès cohérent et à éviter des interruptions dans

1. Supprimez le fichier de jeton RealmJoin :
   * Chemin : `%LOCALAPPDATA%\RealmJoin`
   * RJ 4.19 et versions antérieures `token2.dat`
   * RJ 4.20 et versions ultérieures : `msal_cache.dat`
2. Redémarrez


---

# 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/fixes-for-common-issues.md?ask=<question>
```

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.