> 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).

# Soluciones para problemas comunes

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

**No están pensadas para aplicarse a ciegas, ya que pueden hacer 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. Abra PowerShell con privilegios elevados
  2. Ejecute `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. Abra PowerShell con privilegios elevados
  2. Ejecute `Reset-BC -Force`
* Mensaje de error `Error: los hashes no coinciden. El valor real era '123abcd'`:
  1. Abra PowerShell con privilegios elevados
  2. Ejecute `Reset-BC -Force`

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

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

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

1. Compruebe el `chocolatey.log` archivo para los valores de `packageParameters` en la sección `RJAppDeployToolkit: Variables resultantes`
   * Estos son los valores reales utilizados para la instalación y enviados por el backend de RealmJoin.
2. Si no son los valores que esperaría, compruebe la asignación del paquete en el portal de RealmJoin para ver los valores de anulación de grupo/usuario.

## Archivo .nupkg corrupto

Si ve el siguiente error en el `chocolatey.log` el archivo .nupkg se corrompió:

`[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. Navega 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` :
   * Use la interfaz gráfica: Ejecutar `sysdm.cpl` -> pestaña `Avanzado` -> `Variables de entorno...`
   * Use cmd (como administrador), ejecute: `REG delete "HKLM\SYSTEM\CurrentControlSet\Control\Session Manager\Environment" /V ChocolateyInstall`
3. Reinicie
4. La bandeja de RealmJoin reinstalará chocolatey; deje que el sistema se estabilice durante 5-10 minutos.
5. Si observa elementos faltantes en el menú de la bandeja de RealmJoin, reinicie 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 individuales, esto es solo una recopilación de pasos generales de solución de problemas para ayudar a acotar el problema.**

* Compruebe si hay archivos de registro en `C:\WINDOWS\Logs\RealmJoin\Packages\<package-id>\`.
  * Intente analizar los archivos de registro y encontrar el problema.
* Si no hay ningún archivo de registro, o no es útil, intente ejecutar manualmente la instalación en modo GUI para ver posibles mensajes de error.
  * IMPORTANTE: los paquetes del sistema de RealmJoin se instalan siempre 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 de administrador local estándar proporcionará el mismo error, por lo que ejecutar 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>

* Compruebe si el paquete está asignado correctamente al usuario o si el usuario es miembro del grupo asignado
* Compruebe si el paquete no está asignado de forma oculta (use el modo de depuración para ver los paquetes asignados ocultos)
* Compruebe si el usuario es el usuario principal del cliente; alternativamente, compruebe si el paquete está configurado para estar disponible para usuarios secundarios

## ConfigUpdater no autorizado <a href="#user-content-broken-chocolatey-config" id="user-content-broken-chocolatey-config"></a>

<figure><img src="/files/dce9b850e998ce3cc430cc617872a9f95face69c" alt=""><figcaption><p>El agente RJ no puede acceder a la configuración</p></figcaption></figure>

El problema principal que causa este problema es que el token de acceso no se actualizó automáticamente como se esperaba. Normalmente, los tokens de acceso se actualizan automáticamente para garantizar un acceso ininterrumpido a los recursos. Sin embargo, en este caso, el proceso esperado falló, lo que provocó que el token quedara desactualizado y, por tanto, se produjeran problemas de acceso. Esto pone de relieve la importancia de garantizar que los mecanismos automáticos de actualización del token funcionen correctamente para evitar problemas similares en el futuro. Abordar esta causa raíz ayudará a mantener un acceso constante y a evitar interrupciones en

1. Elimine el archivo de token de RealmJoin:
   * Ruta: `%LOCALAPPDATA%\\RealmJoin`
   * RJ 4.19 y anteriores `token2.dat`
   * RJ 4.20 y posteriores: `msal_cache.dat`
2. Reinicie


---

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