chocolatey.log の分析

この部分では、chocolatey パッケージのインストール失敗をトラブルシューティングする方法に焦点を当てます。

要件

トラブルシューティングには、以下の項目が必要または有用です:

• ログファイル、特に chocolatey.log.

• 高度な検索機能を備えたお好みのテキストエディタ。推奨: Notepad++、Visual Studio Code。

• 失敗したパッケージのパッケージ ID。たとえば generic-mozilla-firefox.

• 失敗したインストールのタイムスタンプ（必須ではありませんが、有用です）。

ログファイルの構造

エントリポイントとデバッグ情報

パッケージのインストールのエントリポイントを見つけるには、 chocolatey.log で、次の検索文字列をそのまま使用します（パッケージ ID は適宜調整してください）: generic-mozilla-firefox --version= （バージョン文字列が確実であれば、もちろん追加できますが、必須ではありません）

これにより、指定したパッケージ ID のインストールまたはアップグレードに対する choco プロセスの開始点が見つかります。

ログ内の完全な行は、代わりに次のようになる場合があります。 upgrade は install である場合もあります。操作内容によって異なります:

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"

chocolatey.log 内の choco インストールのエントリポイント

この行には、インストールされるパッケージのバージョン番号や、使用されたパラメータ（RealmJoin Portal で構成されたパッケージ引数）など、すでに重要な情報が含まれています。

以降の行には、多くの（無関係な）デバッグ情報が含まれます。たとえば、chocolateyInstall.ps1 の完全な内容が出力されます。 デバッグ情報の中には、次の 2 つのセクションがあります RJAppDeployToolkit: 入力環境変数 と RJAppDeployToolkit: 結果の変数。これら 2 つのセクションは隣り合って配置され、 RJAppDeployToolkit

RJAppDeployToolkit の出力

インストールプロセス

実際のパッケージインストールスクリプトは、次のログメッセージの後に開始されます:

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

パッケージインストールスクリプトとクライアントの状態によっては、最初の手順は通常、ソフトウェアがすでにインストールされているかどうかの確認になります。これは、実際のインストールの前にアンインストールが必要かどうかを判断するために行われます。 ログでは、これは次の 1 つ以上のログメッセージで追跡できます:

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 [...]]

確認と必要なアンインストールが実行された後、アプリケーションのメインインストールが開始されます。次のログメッセージで示されます（もちろんファイル名は異なります）:

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

インストールは通常、バイナリファイルのダウンロードから始まります。ダウンロードの開始と終了は、次のログメッセージで示されます:

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.

ダウンロード完了後、chocolatey はダウンロードしたファイルのハッシュを確認し、期待値と比較します。ハッシュが一致すれば、セットアップファイルが最終的に実行されます。 実行に関するログメッセージは、次のログメッセージで見つけられます:

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.

このメッセージには、セットアップファイルへのファイルパスと、セットアップファイルの起動に使用されたすべての（サイレント）パラメータを含む完全なコマンドラインが含まれています。また、セットアップファイルがログ出力を提供し、パッケージスクリプトに含まれている場合、関連するセットアップログファイルのパスを見つけるのにも役立ちます。

プロセス終了後、完全なファイルパスとすべてのパラメータを含む別のログメッセージが書き込まれます。さらに、このメッセージにはセットアッププロセスが返した終了コードも含まれます。これは、成功したインストールか失敗したインストールかを示す最も重要な指標です:

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'.

パッケージによっては、パッケージインストールの後に、いわゆる 'postActions' が続く場合があります。これは、レジストリ設定、デスクトップアイコンの削除、あるいは別のセットアップファイルの実行（そのファイルのダウンロードからやり直し）などです。postActions の部分は、ログファイル内の次の開始および終了メッセージで示されます:

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

chocolatey のインストールプロセスは、次のログメッセージで終了します（install / upgrade によって文言は異なる場合があります）:

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