Correções para problemas comuns

Correções direcionadas para problemas comuns de instalação de pacotes do RealmJoin, como erros BranchCache, para cenários específicos.

Apenas use estas correções nos cenários descritos!

Estas não se destinam a ser aplicadas cegamente, pois podem causar mais danos se forem aplicadas desnecessariamente.

Problemas de BranchCache

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

  1. Abra um PowerShell com privilégios elevados
  2. Executar Clear-BCCache -Force
• Mensagem de erro O objeto fornecido não foi inicializado (também pode ocorrer localizado, dependendo do idioma do SO Windows) na fase de download, código de saída do chocolatey 404:

  1. Abra um PowerShell com privilégios elevados
  2. Executar Reset-BC -Force
• Mensagem de erro Erro - os hashes não correspondem. O valor atual era '123abcd':

  1. Abra um PowerShell com privilégios elevados
  2. Executar Reset-BC -Force

Recomendamos fortemente implementar o Repor ou limpar o BranchCache Script de remediação com agendamento diário. Pode ser encontrado na Scripts de Remediação secção do Portal RealmJoin.

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

Argumentos do pacote em falta / incorretos

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

   • Estes são o(s) valor(es) reais usados para a instalação e passados pelo backend do RealmJoin.
2. Se não forem o(s) valor(es) que esperaria, verifique a atribuição do pacote no portal do RealmJoin para valores de substituição de grupo / utilizador.

Ficheiro .nupkg corrompido

Se vir o seguinte erro no chocolatey.log o ficheiro .nupkg foi corrompido:

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

Muitas vezes, também se pode observar que o ficheiro .nupkg tem 0 bytes.

Passos para corrigir este problema:

1. Navegue até C:\ProgramData\chocolatey\lib
2. Eliminar a pasta generic-package-id

Configuração do chocolatey com problemas

1. Eliminar o conteúdo da pasta C:\ProgramData\chocolatey\config
2. Eliminar variável de sistema ChocolateyInstall :

   • Use a interface gráfica: Executar sysdm.cpl -> Separador Avançadas -> Variáveis de ambiente...
   • Use o 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 durante 5-10 minutos.
5. Se notar itens em falta no menu da bandeja do RealmJoin, reinicie novamente.

Problemas gerais de configuração

Como estes são muito individuais, esta é apenas uma coleção de passos gerais de resolução de problemas para ajudar a restringir o problema.

• Verifique se há ficheiro(s) de registo em C:\Windows\Logs\RealmJoin\Packages\<package-id>\.

  • Tente analisar o(s) ficheiro(s) de registo e encontrar o problema.
• Se não existir ficheiro de registo, ou não for útil, tente executar manualmente a configuração no modo GUI, para ver possíveis mensagens de erro.

  • IMPORTANTE: os pacotes de sistema do 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 de administrador local padrão fornecerá o mesmo erro, por isso executar a partir de NT AUTHORITY\SYSTEM pode não ser necessário.

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

• Verifique se o pacote está corretamente atribuído ao utilizador ou se o utilizador é 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 utilizador é o utilizador principal do cliente; alternativamente, verifique se o pacote está configurado para estar disponível para utilizadores secundários

ConfigUpdater não autorizado

O agente RJ não pode aceder à configuração

O principal problema que causa este 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. No entanto, neste caso, o processo esperado falhou, levando o token a ficar desatualizado e, assim, resultando em problemas de acesso. Isto destaca a importância de garantir que os mecanismos automatizados de atualização do token estão a funcionar corretamente para evitar problemas semelhantes no futuro. Abordar esta causa raiz ajudará a manter um acesso consistente e evitar interrupções em

1. Eliminar o ficheiro de token do RealmJoin:

   • Caminho: %LOCALAPPDATA%\RealmJoin
   • RJ 4.19 e inferior token2.dat
   • RJ 4.20 e superior: msal_cache.dat
2. Reiniciar