# 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