失敗した chocolatey パッケージのトラブルシューティング

前のセクションで説明したように、chocolatey パッケージのインストールはいくつかの段階で構成されます：

1. chocolatey 環境と変数の初期化

2. インストール対象ソフトウェアの既存インストールの確認

3. 既存インストールの可能なアンインストール

4. バイナリファイルのダウンロード

5. ダウンロードしたセットアップバイナリを使用した実際のインストール。

6. インストール後に実行されるポストアクション

各段階は失敗してインストールを中止させる可能性がありますが、失敗の発生確率が最も高いのはステージ3、4、5です。

正しいエラーメッセージの特定

重要なのは、すべての失敗したインストールが標準の chocolatey エラースタックメッセージを返すことで、これらは次のように見えるという点です：

2021-08-23 09:48:58,465 [DEBUG] - 'C:\ProgramData\chocolatey\lib\generic-autodesk-navisworks-freedom-2022' を移動中
 'C:\ProgramData\chocolatey\lib-bad\generic-autodesk-navisworks-freedom-2022' へ
2021-08-23 09:48:58,480 [WARN ] - これは試行 1/3 です。300 ミリ秒後に再試行します。
 警告に変換されたエラー：
 (5) アクセスが拒否されました: [\\?\C:\ProgramData\chocolatey\lib-bad\generic-autodesk-navisworks-freedom-2022]

その アクセスが拒否されました というメッセージは chocolatey の標準エラースタックに属するもので無視すべきです。パッケージのインストール失敗を引き起こしている実際のエラーはログファイルの前の行のどこかにあります。タグ [ERROR] を検索すると正しいメッセージの特定に役立ちます。

この例では実際のエラーが上部（ダウンロードの 404）で発生しているが、chocolatey のエラースタックが後で誤解を招く「アクセスが拒否されました」メッセージを出力している様子がわかります。

上部に実際のダウンロードエラー、その下に続く chocolatey 標準エラースタックは誤解を招く可能性があります。

失敗したインストールの例

初期化中に発生するエラー

初期化フェーズでは、次の理由でエラーが発生することがあります：

• chocolatey 自体の問題（設定破損、ファイル欠落など）：

2023-10-10 10:28:32,523 [ERROR] - chocolatey.infrastructure.app.configuration.ConfigFileSettings 型のレスポンスの逆シリアル化エラー：
 '.'、16進値 0x00 は無効な文字です。行 1、位置 1。
2023-10-10 10:28:32,535 [ERROR] - '.'、16進値 0x00 は無効な文字です。行 1、位置 1。
2023-10-10 10:28:32,537 [DEBUG] - 終了コード 1 で終了

注意してください、似たようなこのメッセージは chocolatey.log にも発生することがありますが、これは無視して問題なく、対処は不要です！

2023-11-21 11:46:10,365 [ERROR] - chocolatey.infrastructure.app.configuration.ConfigFileSettings 型のシリアル化エラー：
 パス 'C:\ProgramData\chocolatey\config\chocolatey.config.update' へのアクセスが拒否されました。

• RealmJoin nuget サーバーにアクセスできないなどのネットワーク問題、（参照 インフラストラクチャに関する考慮事項):

2023-09-08 13:01:47,335 [ERROR] - generic-adobe-reader-dc-continuous がインストールされませんでした。指定されたソースでパッケージが見つかりませんでした。

• 必須パッケージ引数の欠如による問題：

2023-09-14 13:53:33,982 [ERROR] - エラー: 必須引数 'Serial' が指定されていません、中止します！

ダウンロード中に発生するエラー

バイナリのダウンロードに関するエラーの場合、エラーメッセージには通常次を含むダウンロード URL が含まれます： cdn.realmjoin.com、例：

2023-10-16 13:04:52,952 [ERROR] - エラー: リモートファイルが存在しない、認可されていない、または URL 'https://cdn.realmjoin.com/blobs/generic/generic-adobe-acrobat-dc-continuous/AcrobatDCUpd2300620320.msp' に対して禁止されています。"GetResult" を "0" 個の引数で呼び出した際の例外: "トランスポート接続からデータを読み取ることができません: ホスト側のソフトウェアによって確立された接続が中止されました。"

2021-08-23 09:36:08,874 [ERROR] - エラー: リモートファイルが存在しない、認可されていない、または URL 'https://cdn.realmjoin.com/blobs/generic/generic-adobe-acrobat-dc-continuous/AcrobatDCUpd2300620320.msp' に対して禁止されています。"GetResult" を "0" 個の引数で呼び出した際の例外: "ディスクに十分な空き領域がありません"

(アン)インストール処理中に発生するエラー

ダウンロードしたバイナリファイルを使用した実際の（アン）インストール処理中に発生するエラーは、次の2つを使用してトラブルシューティングするのが最適です：

1. セットアッププロセスが返す終了コード。

2. セットアッププロセスが書き込むログファイル（次の場所内にあります） C:\WINDOWS\Logs\RealmJoin\Packages\<package-id>\、インストーラーがログ書き込みの機能を提供している場合。

MSI インストーラーが使用された場合、終了コードは標準化されており、参照できます こちら。さらに、MSI インストーラーは常に上記フォルダにログファイルを書き込みます。特に終了コード 1603 が返された場合（一般的な MSI エラー）、MSI ログファイルはトラブルシューティングのために必須になります。