> 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 Correções direcionadas para problemas comuns de instalação de pacotes do RealmJoin, como erros BranchCache, para cenários específicos. {% hint style="danger" %} **Use estas correções apenas nos cenários descritos!** **Estas não se destinam a ser aplicadas às cegas, pois podem causar mais danos se 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 OS) na fase de download, código de saída do chocolatey `404`: 1. Abra um PowerShell elevado 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 OS) na fase de download, código de saída do chocolatey `404`: 1. Abra um PowerShell elevado 2. Executar `Reset-BC -Force` * Mensagem de erro `Erro - os hashes não coincidem. O valor real era '123abcd'`: 1. Abra um PowerShell elevado 2. Executar `Reset-BC -Force` {% hint style="warning" %} Recomendamos fortemente implementar o **Redefinir ou limpar o BranchCache** Script de remediação com agendamento diário. Pode ser encontrado na [Scripts de remediação](/pt/automatizacao/remediation-scripts.md) secção do RealmJoin Portal. Ao usar este método, os problemas do BranchCache mencionados acima serão detectados proativamente e corrigidos automaticamente (se possível). {% endhint %} ## Crescimento da pasta temporária do Chocolatey Os ficheiros de instalação dos pacotes Chocolatey são descarregados para `C:\Windows\Temp\chocolatey\\\` e não são removidos após a instalação. Isto aplica-se tanto ao motor clássico do Chocolatey como ao [Tempo de execução nativo do Choco](/pt/agente-realmjoin/realmjoin-client/native-choco-runtime.md). Com o tempo, a pasta pode ocupar uma quantidade considerável de espaço em disco. Se quiser que esta pasta seja limpa automaticamente, implemente o **Limpeza da pasta temporária do Chocolatey** Script de remediação da [Scripts de remediação](/pt/automatizacao/remediation-scripts.md) secção do RealmJoin Portal. Remove pastas de versões de pacotes com mais de 7 dias. ## Argumentos de pacote 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 os valores reais usados para a instalação e transmitidos pelo backend do RealmJoin. 2. Se não forem os valores que esperava, 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] - Não foi possível ler o pacote do caminho 'generic-package-id\generic-package-id.nupkg'.` Muitas vezes também se observa que o ficheiro .nupkg tem 0 bytes de tamanho. Passos para resolver este problema: 1. Navegue até `C:\ProgramData\chocolatey\lib` 2. Eliminar a pasta `generic-package-id` ## Configuração do chocolatey danificada 1. Eliminar o conteúdo da pasta `C:\ProgramData\chocolatey\config` 2. Eliminar a variável de sistema `ChocolateyInstall` : * Use a GUI: 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. Reinicie 4. A bandeja do RealmJoin irá 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 específicos, isto é apenas uma coleção de passos gerais de resolução de problemas para ajudar a restringir a questão.** * 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 houver ficheiro de registo, ou se ele não for útil, tente executar manualmente a instalaçã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` 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 apresentará o mesmo erro, por isso 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 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; em alternativa, verifique se o pacote está configurado para estar disponível para utilizadores secundários --- # 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 by asking a question. Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters: ``` 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 what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case. 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.