> 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/analysing-chocolatey.log.md).

# Analizando chocolatey.log

## Requisitos

Los siguientes elementos son necesarios o útiles para la solución de problemas:

* Archivos de registro, especialmente `chocolatey.log`.
* Editor de texto de su elección con capacidades de búsqueda avanzadas, recomendado: Notepad++, Visual Studio Code.
* ID del paquete del paquete fallido, como `generic-mozilla-firefox`.
* Marca temporal de la(s) instalación(es) fallida(s) (no es obligatorio, pero sí útil).

## Estructura del archivo de registro

### Punto de entrada e información de depuración

Para encontrar el punto de entrada de la instalación del paquete dentro de `chocolatey.log` use esta cadena de búsqueda exacta (adapte el ID del paquete en consecuencia): `generic-mozilla-firefox --version=` (si está seguro de la cadena de versión, por supuesto puede añadirla, pero no es obligatorio)

De esta manera encontrará el/los punto(s) de inicio del proceso choco para la instalación o actualización del ID de paquete dado.

La línea completa en el registro puede verse así, en lugar de `actualización` también puede ser `instalación` dependiendo de la operación:

{% code overflow="wrap" fullWidth="false" %}

```log
2023-08-22 15:05:36,664 [DEBUG] - Línea de comandos: "C:\ProgramData\chocolatey\choco.exe" upgrade generic-mozilla-firefox --version=117.0.0.0 --force --yes --ignore-package-exit-codes --timeout=14400 --params="/BlockAddons:1"
```

{% endcode %}

<figure><img src="/files/6081e1deb7f37ef8de31a3c057731faacf805c82" alt=""><figcaption><p>Punto de entrada de una instalación de choco dentro de chocolatey.log</p></figcaption></figure>

Esta línea ya contiene información importante, como el número de versión del paquete que se va a instalar, así como los parámetros utilizados (argumentos del paquete configurados en el Portal RealmJoin).

Las siguientes líneas contendrán mucha información de depuración (no relevante), entre otras cosas, se imprimirá el contenido completo de chocolateyInstall.ps1.\
Dentro de la información de depuración encontrará las dos secciones `RJAppDeployToolkit: Variables de entorno de entrada` y `RJAppDeployToolkit: Variables resultantes`. Ambas secciones están una al lado de la otra y muestran variables y valores proporcionados por el `RJAppDeployToolkit`

<figure><img src="/files/276e8b947170ff1f15fe19a3364c0b19ca75da93" alt=""><figcaption><p>Salida de RJAppDeployToolkit</p></figcaption></figure>

### Proceso de instalación

El script de instalación real del paquete comienza después del siguiente mensaje de registro:

{% code overflow="wrap" %}

```log
2023-08-22 15:05:47,000 [DEBUG] - Ejecutando 'C:\ProgramData\chocolatey\lib\generic-mozilla-firefox\tools\chocolateyInstall.ps1'
```

{% endcode %}

Dependiendo del script de instalación del paquete y del estado del cliente, el primer paso suele ser comprobar si el software ya está instalado. Esto se hace para determinar si será necesaria una desinstalación antes de la instalación real.\
En los registros esto puede seguirse usando uno o más de los siguientes mensajes de registro:

{% code overflow="wrap" %}

```log
2023-08-22 15:05:47,057 [DEBUG] - Se ha प्रवेशado en la función 'Get-RealmjoinRegistryUninstallInfo' con parámetros [...]]
```

{% endcode %}

{% code overflow="wrap" %}

```log
2023-08-22 15:05:47,053 [DEBUG] - Se ha entrado en la función 'Uninstall-RealmjoinPackage' con parámetros [...]]
```

{% endcode %}

Después de que se hayan ejecutado las comprobaciones y las posibles desinstalaciones, comenzará la instalación principal de la aplicación, indicada por el siguiente mensaje de registro (por supuesto, el nombre del archivo será diferente):

{% code overflow="wrap" %}

```log
2023-08-22 15:05:47,858 [INFO ] - Iniciando RealmJoin-Install de Git-2.42.0-64-bit.exe
```

{% endcode %}

La instalación normalmente comenzará con la descarga del archivo binario. El inicio y el final de la descarga se representan mediante los siguientes mensajes de registro:

{% code overflow="wrap" %}

```log
2023-08-22 15:05:48,273 [INFO ] - Descargando generic-git-git desde 'https://cdn.realmjoin.com/blobs/generic/generic-git-git/Git-2.42.0-64-bit.exe'

[...]

2023-08-22 15:05:57,293 [INFO ] - Descarga de Git-2.42.0-64-bit.exe (58.35 MB) completada.
```

{% endcode %}

Después de completar la descarga, chocolatey comprobará el hash del archivo descargado y lo comparará con el valor esperado. Si el hash coincide, finalmente se ejecutará el archivo de instalación.\
El mensaje de registro para la ejecución puede encontrarse con el siguiente mensaje de registro:

{% code overflow="wrap" %}

```log
2023-08-22 15:06:00,743 [DEBUG] - Elevando permisos y ejecutando ["C:\WINDOWS\TEMP\chocolatey\generic-git-git\2.42.0.0\Git-2.42.0-64-bit.exe" /verysilent /norestart /log="C:\WINDOWS\Logs\RealmJoin\Packages\generic-git-git\2023-08-22_15-05-47.916_generic-git-git_2.42.0.0_install_Git-2.42.0-64-bit.exe.log" ]. Esto puede tardar un poco, dependiendo de las instrucciones.
```

{% endcode %}

Este mensaje incluye la ruta del archivo de instalación, así como la línea de comandos completa, incluidos todos los parámetros (silenciosos) utilizados para iniciar el archivo de instalación. También ayudará a encontrar la ruta relevante del archivo de registro de instalación, si el archivo de instalación la ofrece y está incluida en el script del paquete.

Después de que el proceso haya finalizado, se escribirá otro mensaje de registro, que nuevamente incluirá la ruta completa del archivo y todos los parámetros. Además, este mensaje también incluirá el código de salida devuelto por el proceso de instalación, el indicador más importante para una instalación exitosa o fallida:

{% code overflow="wrap" %}

```log
2023-08-22 15:06:52,321 [DEBUG] - El comando ["C:\WINDOWS\TEMP\chocolatey\generic-git-git\2.42.0.0\Git-2.42.0-64-bit.exe" /verysilent /norestart /log="C:\WINDOWS\Logs\RealmJoin\Packages\generic-git-git\2023-08-22_15-05-47.916_generic-git-git_2.42.0.0_install_Git-2.42.0-64-bit.exe.log" ] finalizó con '0'.
```

{% endcode %}

Dependiendo del paquete, la instalación del paquete puede ir ahora seguida por las llamadas 'postActions', que pueden ser algunos ajustes del registro, la eliminación de iconos del escritorio o incluso la ejecución de otro archivo de instalación (comenzando de nuevo con la descarga de ese archivo). La parte de postActions se indicará mediante los siguientes mensajes de inicio y fin en el archivo de registro:

{% code overflow="wrap" %}

```log
2023-09-13 16:49:18,550 7224 [INFO ] - Ejecutando postActions...
2023-09-13 16:49:20,894 7224 [INFO ] - postActions finalizadas.
```

{% endcode %}

El proceso de instalación de chocolatey se cerrará con el siguiente mensaje de registro (la redacción puede diferir según la instalación / actualización):

{% code overflow="wrap" %}

```log
2023-09-13 17:01:39,433 8336 [INFO ] - La instalación de generic-google-chrome fue সফলosa.
```

{% endcode %}


---

# 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/analysing-chocolatey.log.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.
