Solução de problemas de pacotes chocolatey com falha

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

1. Inicialização do ambiente e 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 real usando os binários de instalaçã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 causar a interrupção da instalação, a maior probabilidade de falhas está nas etapas 3, 4 e 5.

Encontrando a mensagem de erro correta

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

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 é 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]

O Acesso negado mensagem pertence à pilha de erro padrão do chocolatey e deve ser ignorada. O erro real que está causando a falha na instalação do pacote está localizado 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 erro do chocolatey imprime algumas mensagens enganadoras de 'Acesso negado' mais adiante.

Erro real de download no topo seguido pela pilha de erro padrão do chocolatey na parte inferior pode ser enganoso.

Exemplos de instalações falhadas

Erros ocorrendo durante a inicialização

Durante a fase de inicialização, erros podem ocorrer pelas seguintes razões:

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

2023-10-10 10:28:32,523 [ERROR] - Erro ao desserializar 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

Cuidado, pois esta mensagem (ligeiramente semelhante) pode ocorrer também em chocolatey.log mas isto é seguro para ignorar e não requer ação!

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

• Problema de rede, quando o servidor nuget RealmJoin não pode ser alcançado, (veja Considerações de Infraestrutura):

2023-09-08 13:01:47,335 [ERROR] - generic-adobe-reader-dc-continuous não instalado. O pacote não foi encontrado nas fontes listadas.

• Problema com argumentos obrigatórios do pacote ausentes:

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

Erros ocorrendo durante o download

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

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

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

Erros ocorrendo durante o processo de (des)instalação

Erros ocorrendo durante o processo real de (des)instalação usando o arquivo binário baixado podem ser solucionados da melhor forma usando duas coisas:

1. O código de saída retornado pelo processo de instalação.

2. O arquivo de log escrito pelo processo de instalação, encontrado dentro de C:\WINDOWS\Logs\RealmJoin\Packages\<package-id>\, se a possibilidade de gravar log for fornecida pelo instalador.

Quando um instalador MSI foi usado, os códigos de saída são padronizados e podem ser consultados aqui. Além disso, os instaladores MSI sempre escreverão arquivos de log na pasta mencionada acima. Especialmente quando o código de saída 1603 foi retornado (erro MSI genérico), o arquivo de log do MSI será obrigatório para solução de problemas.