Correções para problemas comuns

Use essas correções apenas nos cenários descritos!

Elas não devem ser aplicadas cegamente, pois podem causar mais danos se aplicadas desnecessariamente.

Problemas do BranchCache

• Mensagem de erro Não há espaço suficiente no disco (pode também ocorrer localizado, dependendo do idioma do Windows) na fase de download, código de saída do chocolatey 404:

  1. Abra um PowerShell elevado

  2. Execute Clear-BCCache -Force

• Mensagem de erro O objeto fornecido não foi inicializado (pode também ocorrer localizado, dependendo do idioma do Windows) na fase de download, código de saída do chocolatey 404:

  1. Abra um PowerShell elevado

  2. Execute Reset-BC -Force

• Mensagem de erro Erro - hashes não correspondem. O valor real era '123abcd':

  1. Abra um PowerShell elevado

  2. Execute Reset-BC -Force

Recomendamos fortemente implantar o Resetar ou Limpar o BranchCache Script de Remediação com agendamento diário. Pode ser encontrado na Scripts de Remediação seção do Portal RealmJoin.

Ao usar este método, os problemas mencionados acima do BranchCache serão detectados proativamente e remediados automaticamente (se possível).

Argumentos de Pacote ausentes / incorretos

1. Verifique o chocolatey.log arquivo para o(s) valor(es) de packageParameters na seção RJAppDeployToolkit: Resulting Variables

   • Estes são os valores reais usados para a instalação e passados pelo backend do RealmJoin.

2. Se eles não forem os valores que você esperava, verifique a atribuição do pacote no portal RealmJoin para valores substituídos por grupo/usuário.

.nupkg corrompido

Se você vir o seguinte erro no chocolatey.log o arquivo .nupkg foi corrompido:

[ERROR] - Unable to read package from path 'generic-package-id\generic-package-id.nupkg'.

Frequentemente também pode ser observado que o arquivo .nupkg tem 0 bytes de tamanho.

Passos para corrigir este problema:

1. Navegue até C:\ProgramData\chocolatey\lib

2. Excluir pasta generic-package-id

Configuração do chocolatey corrompida

1. Excluir conteúdo da pasta C:\ProgramData\chocolatey\config

2. Excluir Variável do Sistema ChocolateyInstall :

   • Use GUI: Execute sysdm.cpl -> Aba Avançado -> Variáveis de Ambiente...

   • Use cmd (admin), execute: REG delete "HKLM\SYSTEM\CurrentControlSet\Control\Session Manager\Environment" /V ChocolateyInstall

3. Reiniciar

4. A bandeja do RealmJoin reinstalará o chocolatey; deixe o sistema estabilizar por 5-10 minutos.

5. Se você perceber itens ausentes no menu da bandeja do RealmJoin, reinicie novamente.

Problemas gerais de configuração

Como estes são muito individuais, isto é apenas uma coleção de passos gerais de solução de problemas para ajudar a reduzir o escopo do problema.

• Verifique arquivos de log em C:\WINDOWS\Logs\RealmJoin\Packages\<package-id>\.

  • Tente analisar os arquivos de log e encontrar o problema.

• Se nenhum arquivo de log estiver presente, ou não for útil, tente executar manualmente a configuração no modo GUI para ver possíveis mensagens de erro.

  • IMPORTANTE: os pacotes do sistema RealmJoin são sempre instalados usando a conta integrada NT AUTHORITY\SYSTEM portanto é melhor usar uma ferramenta como psexec para executar a instalação a partir dessa conta.

  • Na maioria das vezes, executar a instalação usando uma conta padrão de administrador local apresentará o mesmo erro, então executar a partir de NT AUTHORITY\SYSTEM pode não ser necessário.

Pacote não disponível para instalar / não aparece no menu da bandeja do RealmJoin

• Verifique se o pacote está corretamente atribuído ao usuário ou se o usuário é membro do grupo atribuído

• Verifique se o pacote não está atribuído como oculto (use o Modo de Depuração para ver pacotes atribuídos ocultos)

• Verifique se o usuário é o usuário primário do cliente; alternativamente verifique se o pacote está configurado para estar disponível para usuários secundários

ConfigUpdater não autorizado

O agente RJ não consegue acessar a configuração

A principal causa deste problema é que o token de acesso não foi atualizado automaticamente como esperado. Normalmente, os tokens de acesso são atualizados automaticamente para garantir acesso ininterrupto aos recursos. Contudo, neste caso, o processo esperado falhou, fazendo com que o token ficasse desatualizado e, assim, resultando em problemas de acesso. Isso destaca a importância de garantir que os mecanismos automáticos de atualização de token estejam funcionando corretamente para evitar problemas semelhantes no futuro. Abordar essa causa raiz ajudará a manter o acesso consistente e evitar interrupções em

1. Excluir o arquivo de token do RealmJoin:

   • Caminho: %LOCALAPPDATA%\RealmJoin

   • RJ 4.19 e anteriores token2.dat

   • RJ 4.20 e posteriores: msal_cache.dat

2. Reiniciar