> 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

Como se explicó en la sección anterior, una instalación de un 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 utilizando 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 aborte, la mayor probabilidad de fallos está 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 verán similares a este:

{% 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 %}

La `Acceso denegado` el mensaje pertenece a la pila de errores estándar de chocolatey y debe ignorarse. El error real que está causando 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 en la parte superior (404 para la descarga), pero la pila de errores de chocolatey imprime después algunos mensajes engañosos de 'Acceso denegado'.

<figure><img src="/files/0f5a5dea961e096764b421a1a00693299a044346" 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, los errores pueden ocurrir 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 de 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 aparecer en `chocolatey.log` también, ¡pero esto se puede ignorar de forma segura 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, (ver [Consideraciones de infraestructura](/es/implementacion/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 argumentos obligatorios del paquete faltantes:

{% code overflow="wrap" %}

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

{% endcode %}

### Errores que ocurren durante la descarga

Para los 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'. Exception calling "GetResult" with "0" argument(s): "No se pueden leer datos de la conexión de transporte: una conexión establecida fue abortada 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'. Exception calling "GetResult" with "0" argument(s): "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 usando el archivo binario descargado se pueden solucionar mejor con 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 proporciona 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 de 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 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/es/solucion-de-problemas-y-preguntas-frecuentes/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.