Análise de chocolatey.log

Esta parte irá focar-se na forma de resolver instalações falhadas de pacotes chocolatey.

Requisitos

Os seguintes itens são necessários ou úteis para a resolução de problemas:

• Arquivos de log, especialmente chocolatey.log.

• Editor de texto de sua preferência com recursos avançados de pesquisa, recomendado: Notepad++, Visual Studio Code.

• ID do pacote do pacote com falha, como generic-mozilla-firefox.

• Timestamp da(s) instalação(ões) com falha (não obrigatório, mas útil).

Estrutura do arquivo de log

Ponto de entrada e informações de depuração

Para encontrar o ponto de entrada da instalação do pacote dentro do chocolatey.log use esta string de pesquisa exata (adapte o ID do pacote conforme necessário): generic-mozilla-firefox --version= (se você tiver certeza da string de versão, pode adicioná-la, é claro, mas não é obrigatório)

Dessa forma, você encontrará o(s) ponto(s) de início do processo do choco para a instalação ou atualização do ID de pacote fornecido.

A linha completa no log pode ser assim, em vez de upgrade também pode ser install dependendo da operação:

2023-08-22 15:05:36,664 [DEBUG] - Command line: "C:\ProgramData\chocolatey\choco.exe" upgrade generic-mozilla-firefox --version=117.0.0.0 --force --yes --ignore-package-exit-codes --timeout=14400 --params="/BlockAddons:1"

Ponto de entrada de uma instalação do choco dentro de chocolatey.log

Esta linha já contém algumas informações importantes, como o número da versão do pacote a ser instalado, bem como os parâmetros usados (argumentos do pacote configurados no RealmJoin Portal).

As linhas a seguir conterão muitas informações de depuração (não relevantes), entre outras, o conteúdo completo de chocolateyInstall.ps1 será exibido. Dentro das informações de depuração, você verá as duas seções RJAppDeployToolkit: Input Environment Variables e RJAppDeployToolkit: Resulting Variables. Ambas as seções estão localizadas lado a lado e mostram variáveis e valores fornecidos pelo RJAppDeployToolkit

Saída do RJAppDeployToolkit

Processo de instalação

O script real de instalação do pacote começa após a seguinte mensagem de log:

2023-08-22 15:05:47,000 [DEBUG] - Running 'C:\ProgramData\chocolatey\lib\generic-mozilla-firefox\tools\chocolateyInstall.ps1'

Dependendo do script de instalação do pacote e do estado do cliente, a primeira etapa geralmente será verificar se o software já está instalado. Isso é feito para determinar se será necessária uma desinstalação antes da instalação propriamente dita. Nos logs, isso pode ser acompanhado usando uma ou mais das seguintes mensagens de log:

2023-08-22 15:05:47,057 [DEBUG] - Entered function 'Get-RealmjoinRegistryUninstallInfo' with parameters [...]]

2023-08-22 15:05:47,053 [DEBUG] - Entered function 'Uninstall-RealmjoinPackage' with parameters [...]]

Após as verificações e as possíveis desinstalações terem sido executadas, a instalação principal do aplicativo será iniciada, indicada pela seguinte mensagem de log (o nome do arquivo, é claro, será diferente):

2023-08-22 15:05:47,858 [INFO ] - Starting RealmJoin-Install of Git-2.42.0-64-bit.exe

A instalação geralmente começará com o download do arquivo binário. O início e o término do download são representados pelas seguintes mensagens de log:

2023-08-22 15:05:48,273 [INFO ] - Downloading generic-git-git from 'https://cdn.realmjoin.com/blobs/generic/generic-git-git/Git-2.42.0-64-bit.exe'

[...]

2023-08-22 15:05:57,293 [INFO ] - Download of Git-2.42.0-64-bit.exe (58.35 MB) completed.

Após concluir o download, o chocolatey verificará o hash do arquivo baixado e o comparará com o valor esperado. Se o hash corresponder, o arquivo de instalação será finalmente executado. A mensagem de log para a execução pode ser encontrada pela seguinte mensagem de log:

2023-08-22 15:06:00,743 [DEBUG] - Elevating Permissions and running ["C:\WINDOWS\TEMP\chocolatey\generic-git-git\2.42.0.0\Git-2.42.0-64-bit.exe" /verysilent /norestart /log="C:\WINDOWS\Logs\RealmJoin\Packages\generic-git-git\2023-08-22_15-05-47.916_generic-git-git_2.42.0.0_install_Git-2.42.0-64-bit.exe.log" ]. This may take a while, depending on the statements.

Esta mensagem inclui o caminho do arquivo para o arquivo de instalação, bem como a linha de comando completa, incluindo todos os parâmetros (silenciosos) usados para iniciar o arquivo de instalação. Também ajudará a encontrar o caminho relevante do arquivo de log da instalação, se fornecido pelo arquivo de instalação e incluído no script do pacote.

Após o processo terminar, outra mensagem de log será escrita, incluindo novamente o caminho completo do arquivo e todos os parâmetros. Além disso, essa mensagem também incluirá o código de saída retornado pelo processo de instalação, o indicador mais importante para uma instalação bem-sucedida ou malsucedida:

2023-08-22 15:06:52,321 [DEBUG] - Command ["C:\WINDOWS\TEMP\chocolatey\generic-git-git\2.42.0.0\Git-2.42.0-64-bit.exe" /verysilent /norestart /log="C:\WINDOWS\Logs\RealmJoin\Packages\generic-git-git\2023-08-22_15-05-47.916_generic-git-git_2.42.0.0_install_Git-2.42.0-64-bit.exe.log" ] exited with '0'.

Dependendo do pacote, a instalação do pacote pode agora ser seguida pelas chamadas 'postActions', que podem ser algumas configurações de registro, remoção de ícones da área de trabalho ou até mesmo a execução de outro arquivo de instalação (reiniciando com o download desse arquivo). A parte postActions será indicada pelas seguintes mensagens de início e fim no arquivo de log:

2023-09-13 16:49:18,550 7224 [INFO ] - Running postActions...
2023-09-13 16:49:20,894 7224 [INFO ] - postActions finished.

O processo de instalação do chocolatey será encerrado com a seguinte mensagem de log (a redação pode variar dependendo de install / upgrade ):

2023-09-13 17:01:39,433 8336 [INFO ] - The install of generic-google-chrome was successful.