Correctifs pour les problèmes courants

Correctifs ciblés pour les problèmes courants d'installation de packages RealmJoin, tels que les erreurs BranchCache, pour des scénarios spécifiques.

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.

Problèmes BranchCache

• Message d’erreur L’espace disponible sur le disque est insuffisant (peut également apparaître localisé, selon la langue du système d’exploitation Windows) pendant la phase de téléchargement, code de sortie Chocolatey 404:

  1. Ouvrez PowerShell en mode administrateur
  2. Exécuter 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) pendant la phase de téléchargement, code de sortie Chocolatey 404:

  1. Ouvrez PowerShell en mode administrateur
  2. Exécuter Reset-BC -Force
• Message d’erreur Erreur - les hachages ne correspondent pas. La valeur réelle était '123abcd':

  1. Ouvrez PowerShell en mode administrateur
  2. Exécuter Reset-BC -Force

Nous recommandons fortement de déployer le Réinitialiser ou vider BranchCache script de remédiation avec une planification quotidienne. Il se trouve dans la Scripts de remédiation section 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 corrigés automatiquement (si possible).

Arguments de package manquants / incorrects

1. Vérifiez le chocolatey.log fichier pour la valeur ou les valeurs de packageParameters dans la section RJAppDeployToolkit : variables résultantes

   • Ce sont les valeur(s) réelles utilisées pour l’installation et transmises par le backend RealmJoin.
2. Si elles ne correspondent pas aux valeur(s) attendues, vérifiez l’attribution 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 est corrompu :

[ERROR] - Impossible de lire le package à partir du chemin 'generic-package-id\generic-package-id.nupkg'.

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

Étapes pour corriger ce problème :

1. Accédez à C:\ProgramData\chocolatey\lib
2. Supprimer le dossier generic-package-id

Configuration Chocolatey endommagée

1. Supprimer le contenu du dossier C:\ProgramData\chocolatey\config
2. Supprimer la variable système ChocolateyInstall :

   • Utilisez l’interface graphique : Exécuter 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. La zone de notification RealmJoin réinstallera Chocolatey, laissez le système se stabiliser pendant 5 à 10 minutes.
5. Si des éléments manquent dans le menu de la zone de notification RealmJoin, redémarrez à nouveau.

Problèmes généraux de configuration

Comme ils sont très spécifiques à chaque cas, il s’agit simplement d’une collection d’étapes générales de dépannage pour aider à cerner le problème.

• Recherchez des fichier(s) journal dans C:\Windows\Logs\RealmJoin\Packages\<package-id>\.

  • Essayez d’analyser le(s) fichier(s) journal 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 la configuration en mode GUI, afin de voir d’é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 avec ce compte.
  • La plupart du temps, lancer l’installation à l’aide d’un compte administrateur local standard renverra la même erreur, donc l’exécution depuis NT AUTHORITY\SYSTEM peut ne pas être nécessaire.

Package non disponible à l’installation / n’apparaît pas dans le menu de la zone de notification RealmJoin

• Vérifiez si le package est correctement attribué à l’utilisateur ou si l’utilisateur est membre du groupe attribué
• Vérifiez si le package n’est pas attribué en mode masqué (utilisez le mode débogage pour voir les packages attribué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é

L’agent RJ ne peut pas accéder à la configuration

Le principal problème à 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 entraîné des problèmes d’accès. Cela souligne l’importance de s’assurer que les mécanismes automatiques d’actualisation 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 constant et à éviter les 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