> 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" %} **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.** {% endhint %} ## 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` {% hint style="warning" %} 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](/pt/automacao/remediation-scripts.md) 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). {% endhint %} ## 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\\`. * 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 --- # 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.