Resolução de problemas de pacotes chocolatey falhados

Diagnostique instalações falhadas de pacotes Chocolatey compreendendo as etapas de instalação e encontrando mensagens de erro nos registos.

Como explicado na seção anterior, uma instalação de 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 posteriores 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 com falha retornará mensagens padrão de pilha de erros do chocolatey, que parecerão semelhantes a esta:

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) O acesso foi negado: [\\?\C:\ProgramData\chocolatey\lib-bad\generic-autodesk-navisworks-freedom-2022]

A 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á localizado em algum lugar nas linhas anteriores do arquivo de log. A busca 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 imprime depois algumas mensagens enganosas de 'Acesso negado'.

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

Exemplos de instalações com falha

Erros ocorrendo durante a inicialização

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

• 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 a resposta do tipo chocolatey.infrastructure.app.configuration.ConfigFileSettings:
 '.', o valor hexadecimal 0x00 é um caractere inválido. Linha 1, posição 1.
2023-10-10 10:28:32,535 [ERROR] - '.', o valor hexadecimal 0x00 é um caractere inválido. Linha 1, posição 1.
2023-10-10 10:28:32,537 [DEBUG] - Saindo com 1

Tenha 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!

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.

• Problema de rede, quando o servidor nuget do RealmJoin não pode ser alcançado, (ver 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 com as origens listadas.

• Problema com argumentos obrigatórios de pacote ausentes:

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

Erros ocorrendo 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:

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 máquina host."

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"

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

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 dentro de C:\Windows\Logs\RealmJoin\Packages\<package-id>\, se a possibilidade de gravar o log for fornecida pelo instalador.

Quando foi usado um instalador MSI, os códigos de saída são padronizados e podem ser consultados aqui. Além disso, os instaladores MSI sempre gravarã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 a resolução de problemas.