> For the complete documentation index, see [llms.txt](https://docs.realmjoin.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.realmjoin.com/ja/toraburushtinguto-faq/troubleshooting/package-installation-issues/troubleshooting-failed-chocolatey-packages.md).

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

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

1. chocolatey 環境と変数の初期化
2. インストール対象ソフトウェアの既存インストールの確認
3. 既存インストールのアンインストールの可能性
4. バイナリファイルのダウンロード
5. ダウンロードしたセットアップバイナリを使用した実際のインストール。
6. インストール後に実行される後処理

すべての段階で失敗してインストールが中断される可能性がありますが、失敗の可能性が最も高いのは 3、4、5 段階です。

## 正しいエラーメッセージを見つける

失敗したインストールはすべて、標準の chocolatey エラースタックメッセージを返すことを知っておくことが重要です。次のような表示になります:

{% code overflow="wrap" fullWidth="false" %}

```log
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]
```

{% endcode %}

その `アクセスが拒否されました` このメッセージは chocolatey の標準エラースタックに属するため、無視してください。パッケージのインストール失敗の原因となっている実際のエラーは、ログファイルの前の方の行のどこかにあります。タグ `[ERROR]` を検索すると、正しいメッセージを見つけやすくなります。

この例では、実際のエラーは上部で発生していますが（ダウンロード時の 404）、その後に chocolatey のエラースタックが誤解を招く「Access is denied」メッセージを出力していることがわかります。

<figure><img src="/files/e5804f2fa4b97c54f095769028916b5282fa47b3" alt=""><figcaption><p>上部に実際のダウンロードエラー、その下に chocolatey の標準エラースタックが続くため、誤解を招く可能性があります。</p></figcaption></figure>

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

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

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

* chocolatey のインストール自体に問題がある場合（設定の破損、ファイル不足）:

{% code overflow="wrap" %}

```log
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 で終了
```

{% endcode %}

{% hint style="warning" %}
この（少し似た）メッセージは `chocolatey.log` でも発生する可能性がありますが、これは無視して問題なく、何もする必要はありません！

{% code overflow="wrap" %}

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

{% endcode %}
{% endhint %}

* ネットワークの問題: RealmJoin の nuget サーバーに接続できない場合（参照 [インフラストラクチャに関する考慮事項](/ja/zhan-kai/infrastructure.md#realmjoin-connection-endpoints)):

{% code overflow="wrap" %}

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

{% endcode %}

* 必須のパッケージ引数が不足している問題:

{% code overflow="wrap" %}

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

{% endcode %}

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

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

{% code overflow="wrap" %}

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

{% endcode %}

{% code overflow="wrap" %}

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

{% endcode %}

### （アン）インストール処理中に発生するエラー

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

1. セットアッププロセスが返す終了コード。
2. セットアッププロセスが書き込むログファイル。場所は次のとおりです: `C:\WINDOWS\Logs\RealmJoin\Packages\<package-id>\`、インストーラーにログを書き込む機能がある場合。

{% hint style="info" %}
MSI インストーラーが使用された場合、終了コードは標準化されており、参照できます [ここ](https://learn.microsoft.com/en-us/windows/win32/msi/error-codes)。また、MSI インストーラーは常に上記のフォルダーにログファイルを書き込みます。特に終了コード `1603` が返された場合（一般的な MSI エラー）、トラブルシューティングには MSI ログファイルが必須になります。
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.realmjoin.com/ja/toraburushtinguto-faq/troubleshooting/package-installation-issues/troubleshooting-failed-chocolatey-packages.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
