> For the complete documentation index, see [llms.txt](https://docs.realmjoin.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.realmjoin.com/pt/resolucao-de-problemas-e-faq/troubleshooting/package-installation-issues/fixes-for-common-issues.md). # Correções para problemas comuns {% hint style="danger" %} **Use estas correções apenas nos cenários descritos!** **Estas não se destinam a ser aplicadas cegamente, pois podem causar mais danos se forem aplicadas desnecessariamente.** {% endhint %} ## Problemas do BranchCache * Mensagem de erro `Não há espaço suficiente no disco` (também pode ocorrer localizado, dependendo do idioma do 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 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 real era '123abcd'`: 1. Abra um PowerShell com privilégios elevados 2. Executar `Reset-BC -Force` {% hint style="warning" %} Recomendamos vivamente implementar o **Repor ou limpar o BranchCache** Script de remediação com um agendamento diário. Pode ser encontrado na [Scripts de Remediação](/pt/automacao/remediation-scripts.md) secção do Portal do RealmJoin. Ao utilizar este método, os problemas do BranchCache acima mencionados serão detetados proativamente e remediados automaticamente (se possível). {% endhint %} ## Argumentos do Package em falta / incorretos 1. Verifique o `chocolatey.log` ficheiro para o(s) valor(es) de `packageParameters` na secção `RJAppDeployToolkit: Variáveis resultantes` * Estes são o(s) valor(es) real(is) utilizados 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 ficou 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 de tamanho. Passos para corrigir este problema: 1. Navegue até `C:\ProgramData\chocolatey\lib` 2. Elimine a pasta `generic-package-id` ## Configuração do chocolatey danificada 1. Elimine o conteúdo da pasta `C:\ProgramData\chocolatey\config` 2. Eliminar variável de sistema `ChocolateyInstall` : * Use a GUI: Execute `sysdm.cpl` -> Separador `Avançadas` -> `Variáveis de Ambiente...` * Use o cmd (administrador), execute: `REG delete "HKLM\SYSTEM\CurrentControlSet\Control\Session Manager\Environment" /V ChocolateyInstall` 3. Reinicie 4. A área de notificação do RealmJoin irá reinstalar o chocolatey; deixe o sistema estabilizar durante 5-10 minutos. 5. Se notar itens em falta no menu da área de notificação do RealmJoin, reinicie novamente. ## Problemas gerais de configuração **Como estes são muito individuais, isto é apenas uma coleção de passos gerais de resolução de problemas para ajudar a restringir o problema.** * Verifique se existem ficheiros de registo em `C:\WINDOWS\Logs\RealmJoin\Packages\\`. * Tente analisar o(s) ficheiro(s) de registo e identificar o problema. * Se não existir nenhum ficheiro de registo, ou se este 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 incorporada `NT AUTHORITY\SYSTEM` por isso é 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 irá produzir o mesmo erro, por isso executar a partir de `NT AUTHORITY\SYSTEM` talvez não seja necessário. ### Pacote indisponível para instalação / não aparece no menu da área de notificação 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 os pacotes atribuídos ocultos) * Verifique se o utilizador é o utilizador principal do cliente; em alternativa, verifique se o pacote está configurado para ficar disponível para utilizadores secundários ## ConfigUpdater não autorizado

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

O principal problema que está a causar este problema é que o token de acesso não foi renovado 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, fazendo com que o token ficasse desatualizado e, assim, resultando em problemas de acesso. Isto destaca a importância de garantir que os mecanismos automatizados de renovação de tokens estão a funcionar corretamente para evitar problemas semelhantes no futuro. Resolver esta causa raiz ajudará a manter um acesso consistente e a evitar interrupções em 1. Elimine 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. Reinicie --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## 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, and the optional `goal` query parameter: ``` GET https://docs.realmjoin.com/pt/resolucao-de-problemas-e-faq/troubleshooting/package-installation-issues/fixes-for-common-issues.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. 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.