> 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/fixes-for-common-issues.md).

# Correcciones para problemas comunes

Correcciones específicas para problemas comunes de instalación de paquetes de RealmJoin, como errores de BranchCache, para escenarios concretos.

{% hint style="danger" %}
**¡Usa estas correcciones solo en los escenarios descritos!**

**No están pensadas para aplicarse a ciegas, ya que pueden causar más daño si se aplican innecesariamente.**
{% endhint %}

## Problemas de BranchCache

* Mensaje de error `No hay suficiente espacio en el disco` (también puede aparecer localizado, dependiendo del idioma del SO Windows) en la fase de descarga, código de salida de chocolatey `404`:
  1. Abre PowerShell con privilegios elevados
  2. Ejecutar `Clear-BCCache -Force`
* Mensaje de error `El objeto proporcionado no se ha inicializado` (también puede aparecer localizado, dependiendo del idioma del SO Windows) en la fase de descarga, código de salida de chocolatey `404`:
  1. Abre PowerShell con privilegios elevados
  2. Ejecutar `Reset-BC -Force`
* Mensaje de error `Error: los hashes no coinciden. El valor real era '123abcd'`:
  1. Abre PowerShell con privilegios elevados
  2. Ejecutar `Reset-BC -Force`

{% hint style="warning" %}
Recomendamos encarecidamente implementar el **Restablecer o borrar BranchCache** Script de corrección con programación diaria. Se puede encontrar en la [Scripts de remediación](https://docs.realmjoin.com/es/automatizacion/remediation-scripts.md) sección del Portal de RealmJoin.

Al usar este método, los problemas de BranchCache mencionados anteriormente se detectarán proactivamente y se corregirán automáticamente (si es posible).
{% endhint %}

## La carpeta temporal de Chocolatey crece

Los archivos de instalación de los paquetes de Chocolatey se descargan en `C:\Windows\Temp\chocolatey\<package-id>\<version>\` y no se eliminan después de la instalación. Esto se aplica tanto al motor clásico de Chocolatey como al [Native Choco Runtime](https://docs.realmjoin.com/es/agente-de-realmjoin/realmjoin-client/native-choco-runtime.md). Con el tiempo, la carpeta puede ocupar una cantidad considerable de espacio en disco.

Si quieres que esta carpeta se limpie automáticamente, implementa el **Limpieza de la carpeta temporal de Chocolatey** Script de corrección desde la [Scripts de remediación](https://docs.realmjoin.com/es/automatizacion/remediation-scripts.md) sección del Portal de RealmJoin. Elimina las carpetas de versiones de paquetes anteriores a 7 días.

## Faltan argumentos del paquete / son incorrectos <a href="#user-content-missing-wrong-package-arguments" id="user-content-missing-wrong-package-arguments"></a>

1. Consulta el `chocolatey.log` archivo para el/los valor(es) de `packageParameters` en la sección `RJAppDeployToolkit: Variables resultantes`
   * Estos son los valores reales usados para la instalación y enviados por el backend de RealmJoin.
2. Si no son los valores que esperarías, revisa la asignación del paquete en el portal de RealmJoin para ver los valores de anulación de grupo/usuario.

## Archivo .nupkg corrupto

Si ves el siguiente error en el `chocolatey.log` el archivo .nupkg se ha corrompido:

`[ERROR] - No se puede leer el paquete desde la ruta 'generic-package-id\\generic-package-id.nupkg'.`

A menudo también se puede observar que el archivo .nupkg tiene un tamaño de 0 bytes.

Pasos para solucionar este problema:

1. Vaya a `C:\ProgramData\chocolatey\lib`
2. Eliminar carpeta `generic-package-id`

## Configuración de chocolatey dañada <a href="#user-content-broken-chocolatey-config" id="user-content-broken-chocolatey-config"></a>

1. Eliminar el contenido de la carpeta `C:\ProgramData\chocolatey\config`
2. Eliminar variable del sistema `ChocolateyInstall` :
   * Usa la interfaz gráfica: Ejecutar `sysdm.cpl` -> Pestaña `Avanzado` -> `Variables de entorno...`
   * Usa cmd (como administrador) y ejecuta: `REG delete "HKLM\SYSTEM\CurrentControlSet\Control\Session Manager\Environment" /V ChocolateyInstall`
3. Reinicia
4. La bandeja de RealmJoin reinstalará chocolatey; deja que el sistema se estabilice durante 5-10 minutos.
5. Si notas elementos faltantes en el menú de la bandeja de RealmJoin, reinicia de nuevo.

## Problemas generales de instalación <a href="#user-content-general-setup-issues" id="user-content-general-setup-issues"></a>

**Como estos son muy particulares, esto es solo una recopilación de pasos generales de solución de problemas para ayudar a acotar el problema.**

* Busca archivo(s) de registro en `C:\WINDOWS\Logs\RealmJoin\Packages\<package-id>\`.
  * Intenta analizar el/los archivo(s) de registro y encontrar el problema.
* Si no hay ningún archivo de registro, o no es útil, intenta ejecutar manualmente la configuración en modo GUI para ver posibles mensajes de error.
  * IMPORTANTE: Los paquetes del sistema de RealmJoin siempre se instalan usando la cuenta integrada `NT AUTHORITY\SYSTEM` por lo que es mejor usar una herramienta como `psexec` para ejecutar la instalación desde esa cuenta.
  * La mayoría de las veces, ejecutar la instalación usando una cuenta local de administrador estándar dará el mismo error, por lo que ejecutarla desde `NT AUTHORITY\SYSTEM` puede no ser necesario.

### Paquete no disponible para instalar / no aparece en el menú de la bandeja de RealmJoin <a href="#user-content-package-not-available-to-install-not-showing-in-realmjoin-tray-menu" id="user-content-package-not-available-to-install-not-showing-in-realmjoin-tray-menu"></a>

* Comprueba si el paquete está asignado correctamente al usuario o si el usuario es miembro del grupo asignado
* Comprueba que el paquete no esté asignado como oculto (usa el modo de depuración para ver los paquetes asignados ocultos)
* Comprueba si el usuario es el usuario principal del cliente; alternativamente, verifica si el paquete está configurado para estar disponible para usuarios secundarios


---

# 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/fixes-for-common-issues.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.
