> 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" %} **¡Use estas correcciones solo en los escenarios descritos!** **No están pensadas para aplicarse a ciegas, ya que podrían 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, según el idioma del sistema operativo Windows) en la fase de descarga, código de salida de Chocolatey `404`: 1. Abra PowerShell con privilegios elevados 2. Ejecutar `Clear-BCCache -Force` * Mensaje de error `El objeto proporcionado no se ha inicializado` (también puede aparecer localizado, según el idioma del sistema operativo Windows) en la fase de descarga, código de salida de Chocolatey `404`: 1. Abra PowerShell con privilegios elevados 2. Ejecutar `Reset-BC -Force` * Mensaje de error `Error: los hash no coinciden. El valor real era '123abcd'`: 1. Abra PowerShell con privilegios elevados 2. Ejecutar `Reset-BC -Force` {% hint style="warning" %} Recomendamos encarecidamente implementar el **Restablecer o vaciar BranchCache** Script de remediación con programación diaria. Se puede encontrar en la [Scripts de remediación](/es/automatizacion/remediation-scripts.md) sección del Portal de RealmJoin. Al utilizar este método, los problemas de BranchCache mencionados anteriormente se detectarán de forma proactiva y se corregirán automáticamente (si es posible). {% endhint %} ## Crecimiento de la carpeta temporal de Chocolatey Los archivos de instalación de los paquetes de Chocolatey se descargan en `C:\Windows\Temp\chocolatey\\\` 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](/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 desea que esta carpeta se limpie automáticamente, implemente el **Limpieza de la carpeta temporal de Chocolatey** Script de remediación desde la [Scripts de remediación](/es/automatizacion/remediation-scripts.md) sección del Portal de RealmJoin. Elimina las carpetas de versiones de paquetes con más de 7 días. ## Faltan argumentos del paquete / son incorrectos 1. Compruebe el `chocolatey.log` archivo para el/los valor(es) de `packageParameters` en la sección `RJAppDeployToolkit: variables resultantes` * Estos son los valores reales utilizados para la instalación y pasados por el backend de RealmJoin. 2. Si no son los valores que esperaba, compruebe la asignación del paquete en el portal de RealmJoin para ver los valores de anulación de grupo/usuario. ## Archivo .nupkg dañado Si ve el siguiente error en el `chocolatey.log` el archivo .nupkg se ha dañado: `[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. Elimine la carpeta `generic-package-id` ## Configuración de Chocolatey dañada 1. Elimine el contenido de la carpeta `C:\ProgramData\chocolatey\config` 2. Elimine la variable del sistema `ChocolateyInstall` : * Use la interfaz gráfica: Ejecute `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 asiente durante 5-10 minutos. 5. Si faltan elementos en el menú de la bandeja de RealmJoin, reinicie de nuevo. ## Problemas generales de instalación **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.** * Busque archivo(s) de registro en `C:\WINDOWS\Logs\RealmJoin\Packages\\`. * Intente analizar el/los archivo(s) 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 siempre se instalan usando la cuenta integrada de `NT AUTHORITY\SYSTEM` , por lo que es mejor usar una herramienta como `psexec` para ejecutar la instalación con esa cuenta. * La mayoría de las veces, ejecutar la instalación usando una cuenta de administrador local estándar mostrará el mismo error, por lo que ejecutarla desde `NT AUTHORITY\SYSTEM` puede no ser necesario. ### El paquete no está disponible para instalar / no aparece en el menú de la bandeja de RealmJoin * 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 como oculto (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 --- # 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=&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.