> 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 パッケージのインストールを診断します。

前のセクションで説明したように、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 のエラースタックは後ろの方で誤解を招く「アクセスが拒否されました」メッセージを出力していることがわかります。

<figure><img src="https://3438325150-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkrcM7cKOpXKri1kVrh%2Fuploads%2FBPOlb5tEzZXYAtjilVX5%2Fchoco-error-stack.png?alt=media&amp;token=4c5d5eba-d915-45f1-89c0-834ea477db65" 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 サーバーに到達できない場合（参照 [インフラストラクチャの考慮事項](https://docs.realmjoin.com/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] - ERROR: 必須引数 'Serial' が指定されていません。中止します！
```

{% endcode %}

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

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

{% code overflow="wrap" %}

```log
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): "ホストマシン上のソフトウェアによって確立済みの接続が中断されたため、トランスポート接続からデータを読み取れません。"
```

{% endcode %}

{% code overflow="wrap" %}

```log
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): "ディスクの空き容量が不足しています"
```

{% 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
