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

インストール段階を理解し、ログ内のエラーメッセージを見つけることで、失敗した 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 のエラースタックは後で誤解を招く 'Access is denied' メッセージを表示していることに注意してください。

上部の実際のダウンロードエラーに続いて下部に 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] - ERROR: 必須引数 'Serial' が指定されていないため、中止します！

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

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

2023-10-16 13:04:52,952 [ERROR] - ERROR: リモート ファイルは存在しないか、認証されていないか、または URL 'https://cdn.realmjoin.com/blobs/generic/generic-adobe-acrobat-dc-continuous/AcrobatDCUpd2300620320.msp' に対して禁止されています。Exception calling "GetResult" with "0" argument(s): "トランスポート接続からデータを読み取れません: 既に確立された接続がホスト マシン上のソフトウェアによって中断されました。"

2021-08-23 09:36:08,874 [ERROR] - ERROR: リモート ファイルは存在しないか、認証されていないか、または URL 'https://cdn.realmjoin.com/blobs/generic/generic-adobe-acrobat-dc-continuous/AcrobatDCUpd2300620320.msp' に対して禁止されています。Exception calling "GetResult" with "0" argument(s): "ディスクの空き容量が不足しています"

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

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

1. セットアップ処理が返す終了コード。
2. セットアップ処理によって書き込まれるログファイル。場所は次のとおりです C:\WINDOWS\Logs\RealmJoin\Packages\<package-id>\ただし、インストーラーがログ書き込み機能を提供している場合に限ります。

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