> 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 de chocolatey fallidos

Como se explicó en la sección anterior, la 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 usando los binarios de instalación descargados.
6. Acciones posteriores que se ejecutarán después de la instalación

Aunque cada etapa puede fallar y provocar que la instalación se interrumpa, 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 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 %}

El `Acceso denegado` el mensaje pertenece a la pila de errores estándar de chocolatey y debe ignorarse. El error real que está provocando 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.

Vea 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>El error real de descarga en la parte superior, seguido por 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 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) también puede aparecer en el `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 alcanzar el servidor NuGet de RealmJoin, (véase [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 está instalado. El paquete no se encontró con la(s) fuente(s) indicada(s).
```

{% endcode %}

* Problema con los 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', ¡abortando!
```

{% 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 0 argumento(s): "No se pueden leer datos de la conexión de transporte: Una conexión establecida fue abortada por el software de su 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 0 argumento(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 pueden depurarse mejor utilizando 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 pueden consultarse [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 arriba. Especialmente cuando se devolvió el código de salida `1603` se devolvió (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 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.
