> 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/troubleshooting-failed-chocolatey-packages.md).

# Resolver problemas de pacotes chocolatey falhados

Diagnosticar instalações falhadas de pacotes Chocolatey ao compreender as fases de instalação e encontrar mensagens de erro nos registos.

Como explicado na seção anterior, a instalação de um pacote chocolatey consiste em várias etapas:

1. Inicialização do ambiente e das variáveis do chocolatey
2. Verificação de instalações existentes do software a ser instalado
3. Possível desinstalação de instalações existentes
4. Download de arquivos binários
5. Instalação propriamente dita usando os binários de configuração baixados.
6. Ações pós-instalação a serem executadas após a instalação

Embora cada etapa tenha chance de falhar e fazer com que a instalação seja abortada, a maior probabilidade de falhas está nas etapas 3, 4 e 5.

## Encontrando a mensagem de erro correta

É importante saber que toda instalação com falha retornará mensagens padrão da pilha de erros do chocolatey, que se parecerão com isto:

{% code overflow="wrap" fullWidth="false" %}

```log
2021-08-23 09:48:58,465 [DEBUG] - Movendo 'C:\ProgramData\chocolatey\lib\generic-autodesk-navisworks-freedom-2022'
 para 'C:\ProgramData\chocolatey\lib-bad\generic-autodesk-navisworks-freedom-2022'
2021-08-23 09:48:58,480 [WARN ] - Esta é a tentativa 1/3. Tentando novamente após 300 milissegundos.
 Erro convertido em aviso:
 (5) Acesso negado: [\\?\C:\ProgramData\chocolatey\lib-bad\generic-autodesk-navisworks-freedom-2022]
```

{% endcode %}

O `Acesso negado` a mensagem pertence à pilha de erros padrão do chocolatey e deve ser ignorada. O erro real que está fazendo com que a instalação do pacote falhe está em algum lugar nas linhas anteriores do arquivo de log. Procurar pela tag `[ERROR]` ajudará a encontrar as mensagens corretas.

Veja como, neste exemplo, o erro real acontece no topo (404 para o download), mas a pilha de erros do chocolatey exibe mais tarde algumas mensagens enganosas de 'Access is denied'.

<figure><img src="https://686519968-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkrcM7cKOpXKri1kVrh%2Fuploads%2FBPOlb5tEzZXYAtjilVX5%2Fchoco-error-stack.png?alt=media&amp;token=4c5d5eba-d915-45f1-89c0-834ea477db65" alt=""><figcaption><p>Erro real de download no topo, seguido pela pilha de erros padrão do chocolatey na parte inferior, pode ser enganoso.</p></figcaption></figure>

## Exemplos de instalações com falha

### Erros ocorridos durante a inicialização

Durante a fase de inicialização, erros podem ocorrer pelos seguintes motivos:

* Problema com a própria instalação do chocolatey (configuração corrompida, arquivos ausentes):

{% code overflow="wrap" %}

```log
2023-10-10 10:28:32,523 [ERROR] - Erro ao desserializar a resposta do tipo chocolatey.infrastructure.app.configuration.ConfigFileSettings:
 '.', valor hexadecimal 0x00, é um caractere inválido. Linha 1, posição 1.
2023-10-10 10:28:32,535 [ERROR] - '.', valor hexadecimal 0x00, é um caractere inválido. Linha 1, posição 1.
2023-10-10 10:28:32,537 [DEBUG] - Saindo com 1
```

{% endcode %}

{% hint style="warning" %}
Cuidado, pois esta mensagem (ligeiramente semelhante) também pode ocorrer no `chocolatey.log` também, mas isso pode ser ignorado com segurança e não requer nenhuma ação!

{% code overflow="wrap" %}

```log
2023-11-21 11:46:10,365 [ERROR] - Erro ao serializar o tipo chocolatey.infrastructure.app.configuration.ConfigFileSettings:
 O acesso ao caminho 'C:\ProgramData\chocolatey\config\chocolatey.config.update' foi negado.
```

{% endcode %}
{% endhint %}

* Problema de rede, quando o servidor nuget do RealmJoin não pode ser alcançado, (veja [Considerações de infraestrutura](https://docs.realmjoin.com/pt/implementacao/infrastructure.md#realmjoin-connection-endpoints)):

{% code overflow="wrap" %}

```log
2023-09-08 13:01:47,335 [ERROR] - generic-adobe-reader-dc-continuous não instalado. O pacote não foi encontrado com a(s) fonte(s) listada(s).
```

{% endcode %}

* Problema com argumentos obrigatórios do pacote ausentes:

{% code overflow="wrap" %}

```log
2023-09-14 13:53:33,982 [ERROR] - ERRO: O argumento obrigatório 'Serial' não foi fornecido, abortando!
```

{% endcode %}

### Erros ocorridos durante o download

Para erros envolvendo o download dos binários, a mensagem de erro normalmente incluirá a URL de download contendo `cdn.realmjoin.com`, exemplos:

{% code overflow="wrap" %}

```log
2023-10-16 13:04:52,952 [ERROR] - ERRO: O arquivo remoto não existe, não está autorizado ou é proibido para a URL 'https://cdn.realmjoin.com/blobs/generic/generic-adobe-acrobat-dc-continuous/AcrobatDCUpd2300620320.msp'. Exceção ao chamar "GetResult" com "0" argumento(s): "Não foi possível ler dados da conexão de transporte: Uma conexão estabelecida foi abortada pelo software na sua máquina host."
```

{% endcode %}

{% code overflow="wrap" %}

```log
2021-08-23 09:36:08,874 [ERROR] - ERRO: O arquivo remoto não existe, não está autorizado ou é proibido para a URL 'https://cdn.realmjoin.com/blobs/generic/generic-adobe-acrobat-dc-continuous/AcrobatDCUpd2300620320.msp'. Exceção ao chamar "GetResult" com "0" argumento(s): "Não há espaço suficiente no disco"
```

{% endcode %}

### Erros ocorridos durante o processo de (des)instalação

Os erros que ocorrem durante o processo real de (des)instalação usando o arquivo binário baixado podem ser melhor diagnosticados usando duas coisas:

1. O código de saída retornado pelo processo de instalação.
2. O arquivo de log gravado pelo processo de instalação, encontrado em `C:\WINDOWS\Logs\RealmJoin\Packages\<package-id>\`, se a possibilidade de gravar log for fornecida pelo instalador.

{% hint style="info" %}
Quando foi usado um instalador MSI, os códigos de saída são padronizados e podem ser consultados [aqui](https://learn.microsoft.com/en-us/windows/win32/msi/error-codes). Além disso, instaladores MSI sempre gravarão arquivos de log na pasta mencionada acima. Especialmente quando o código de saída `1603` foi retornado (erro genérico do MSI), o arquivo de log do MSI será obrigatório para solução de problemas.
{% endhint %}


---

# 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/troubleshooting-failed-chocolatey-packages.md?ask=<question>&goal=<user_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.
