> 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/es/solucion-de-problemas-y-preguntas-frecuentes/troubleshooting/package-installation-issues/troubleshooting-failed-chocolatey-packages.md).

# Solución de problemas de paquetes chocolatey fallidos

Diagnostica instalaciones fallidas de paquetes Chocolatey entendiendo las fases de instalación y encontrando mensajes de error en los registros.

Como se explicó en la sección anterior, una instalación de paquete de chocolatey consta de varias etapas:

1. Inicialización del entorno y las variables de chocolatey
2. Comprobación de instalaciones existentes del software que se va a instalar
3. Posible desinstalación de instalaciones existentes
4. Descarga de archivos binarios
5. Instalación real mediante los binarios de instalación descargados.
6. Acciones posteriores que se ejecutarán después de la instalación

Aunque cada etapa tiene la posibilidad de fallar y hacer que la instalación se interrumpa, la mayor probabilidad de fallos se encuentra en las etapas 3, 4 y 5.

## Encontrar el mensaje de error correcto

Es importante saber que toda instalación fallida devolverá mensajes estándar de la pila de errores de chocolatey, que se parecerán a esto:

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

```log
2021-08-23 09:48:58,465 [DEBUG] - Moviendo 'C:\ProgramData\chocolatey\lib\generic-autodesk-navisworks-freedom-2022'
 a 'C:\ProgramData\chocolatey\lib-bad\generic-autodesk-navisworks-freedom-2022'
2021-08-23 09:48:58,480 [WARN ] - Este es el intento 1/3. Reintentando después de 300 milisegundos.
 Error convertido en advertencia:
 (5) Acceso denegado: [\\?\C:\ProgramData\chocolatey\lib-bad\generic-autodesk-navisworks-freedom-2022]
```

{% endcode %}

Los `Acceso denegado` el mensaje pertenece a la pila de errores estándar de chocolatey y debe ignorarse. El error real que está haciendo que falle la instalación del paquete se encuentra en alguna parte de las líneas anteriores del archivo de registro. Buscar la etiqueta `[ERROR]` ayudará a encontrar los mensajes correctos.

Observe cómo en este ejemplo el error real ocurre al principio (404 para la descarga), pero la pila de errores de chocolatey imprime más tarde algunos mensajes engañosos de 'Acceso denegado'.

<figure><img src="https://3832142177-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>Error de descarga real en la parte superior, seguido de la pila de errores estándar de chocolatey en la parte inferior; puede ser engañoso.</p></figcaption></figure>

## Ejemplos de instalaciones fallidas

### Errores que ocurren durante la inicialización

Durante la fase de inicialización, pueden producirse errores por las siguientes razones:

* Problema con la propia instalación de chocolatey (configuración dañada, archivos faltantes):

{% code overflow="wrap" %}

```log
2023-10-10 10:28:32,523 [ERROR] - Error al deserializar la respuesta del tipo chocolatey.infrastructure.app.configuration.ConfigFileSettings:
 '.', el valor hexadecimal 0x00, es un carácter no válido. Línea 1, posición 1.
2023-10-10 10:28:32,535 [ERROR] - '.', el valor hexadecimal 0x00, es un carácter no válido. Línea 1, posición 1.
2023-10-10 10:28:32,537 [DEBUG] - Saliendo con 1
```

{% endcode %}

{% hint style="warning" %}
Tenga cuidado, ya que este mensaje (ligeramente similar) puede ocurrir en el `chocolatey.log` también, pero es seguro ignorarlo y no requiere ninguna acción.

{% code overflow="wrap" %}

```log
2023-11-21 11:46:10,365 [ERROR] - Error al serializar el tipo chocolatey.infrastructure.app.configuration.ConfigFileSettings:
 Se denegó el acceso a la ruta 'C:\ProgramData\chocolatey\config\chocolatey.config.update'.
```

{% endcode %}
{% endhint %}

* Problema de red, cuando no se puede الوصول al servidor nuget de RealmJoin, (véase [Consideraciones de infraestructura](https://docs.realmjoin.com/es/despliegue/infrastructure.md#realmjoin-connection-endpoints)):

{% code overflow="wrap" %}

```log
2023-09-08 13:01:47,335 [ERROR] - generic-adobe-reader-dc-continuous no instalado. No se encontró el paquete con las fuentes indicadas.
```

{% endcode %}

* Problema con los argumentos obligatorios del paquete que faltan:

{% code overflow="wrap" %}

```log
2023-09-14 13:53:33,982 [ERROR] - ERROR: No se proporcionó el argumento obligatorio 'Serial', ¡aborting!
```

{% endcode %}

### Errores que ocurren durante la descarga

Para errores relacionados con la descarga de los binarios, el mensaje de error normalmente incluirá la URL de descarga que contiene `cdn.realmjoin.com`, ejemplos:

{% code overflow="wrap" %}

```log
2023-10-16 13:04:52,952 [ERROR] - ERROR: El archivo remoto no existe, no está autorizado o está prohibido para la URL 'https://cdn.realmjoin.com/blobs/generic/generic-adobe-acrobat-dc-continuous/AcrobatDCUpd2300620320.msp'. Excepción al llamar a "GetResult" con el/los argumento(s) "0": "No se pueden leer datos de la conexión de transporte: Una conexión establecida fue interrumpida por el software en la máquina host."
```

{% endcode %}

{% code overflow="wrap" %}

```log
2021-08-23 09:36:08,874 [ERROR] - ERROR: El archivo remoto no existe, no está autorizado o está prohibido para la URL 'https://cdn.realmjoin.com/blobs/generic/generic-adobe-acrobat-dc-continuous/AcrobatDCUpd2300620320.msp'. Excepción al llamar a "GetResult" con el/los argumento(s) "0": "No hay suficiente espacio en el disco"
```

{% endcode %}

### Errores que ocurren durante el proceso de (des)instalación

Los errores que ocurren durante el proceso real de (des)instalación mediante el archivo binario descargado se pueden diagnosticar mejor usando dos cosas:

1. El código de salida devuelto por el proceso de instalación.
2. El archivo de registro escrito por el proceso de instalación, que se encuentra dentro de `C:\WINDOWS\Logs\RealmJoin\Packages\<package-id>\`, si el instalador ofrece la posibilidad de escribir un registro.

{% hint style="info" %}
Cuando se utilizó un instalador MSI, los códigos de salida están estandarizados y se pueden consultar [aquí](https://learn.microsoft.com/en-us/windows/win32/msi/error-codes). Además, los instaladores MSI siempre escribirán archivos de registro en la carpeta mencionada anteriormente. Especialmente cuando se devolvió el código de salida `1603` (error genérico de MSI), el archivo de registro MSI será obligatorio para la resolución de problemas.
{% 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/es/solucion-de-problemas-y-preguntas-frecuentes/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.
