> For the complete documentation index, see [llms.txt](https://wiki.datadike.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://wiki.datadike.com/es/sonar/administration/software/install-software.md).

# Instalar software

Instale un paquete del catálogo de la consola en un dispositivo Windows y siga la instalación en Pending Actions hasta que termine.

## Qué es y cuándo usarlo

El panel lateral **Install Software**, en la pestaña **Software** de un dispositivo, instala un paquete de un catálogo de paquetes de Chocolatey. El agente ejecuta la instalación en el dispositivo en segundo plano, con el cliente de Chocolatey, y devuelve a la consola la salida del instalador.

Úselo para poner una aplicación común en una máquina Windows sin abrir una sesión remota: un navegador, un lector de PDF, un entorno de ejecución del que depende una aplicación.

El panel lateral funciona con un dispositivo a la vez y solo en Windows. Para instalar en muchos dispositivos a la vez, o en Linux y macOS, ejecute un script de instalación: vea [Ejecutar acciones en varios dispositivos](/es/sonar/administration/automation/bulk-actions.md) y [Ejecutar un comando o un script en un dispositivo](/es/sonar/administration/automation/run-commands-and-scripts.md).

## Antes de empezar

* Un rol con **Manage Software** para instalar, y **List Software** para abrir la pestaña **Software**. Ambos permisos están en **Admin Center › Roles**. Sin **Manage Software**, el botón **Install Software** aparece atenuado y muestra *You don't have permission for this action*.
* **List Pending Actions** para seguir la instalación después.
* El dispositivo es un dispositivo **Windows** y está **online**. La consola entrega la solicitud al agente en el acto; un dispositivo desconectado no puede recibirla.
* Acceso a Internet desde el dispositivo al repositorio de la comunidad de Chocolatey y a los sitios de descarga que usa el paquete. El agente configura por su cuenta el cliente de Chocolatey en el dispositivo cuando se inicia su servicio.

## Pasos

1. Abra **Dashboard › Sysadmin**, elija el cliente y haga clic en el dispositivo en la lista. El panel del dispositivo se abre en la parte inferior de la pantalla.
2. Abra la pestaña **Software**.
3. Haga clic en **Install Software**. El panel lateral lista los paquetes del catálogo.
4. Escriba parte del nombre en **Search software...** para acotar la lista.
5. Opcional: haga clic en el nombre de un paquete para abrir su página en el sitio web de Chocolatey en una nueva pestaña del navegador, y compruebe qué instala.
6. Haga clic en **+** en la línea del paquete.
7. Confirme con **Install** en el cuadro de diálogo *Install \<name>?*.

## Qué debe ver

El panel lateral se cierra y la consola muestra:

`<name> will be installed shortly on <hostname>. Check the Pending Actions menu to see the status/output`

La instalación se ejecuta ahora en el dispositivo. Puede tardar desde unos segundos hasta varios minutos, según el tamaño del paquete y la velocidad de descarga.

En el panel lateral, cada paquete aparece como **Chocolatey Package** con una insignia **Available**. El pie muestra *Showing x-y of N* y los controles de página.

## Cómo verificar que funcionó

1. Abra **Agents › Pending Actions**, o **Pending Agent Actions** desde el menú **Other actions** del dispositivo (el **⋮** del encabezado del panel del dispositivo).
2. Busque la línea **\<name> software install**. Mientras se ejecuta, **Due** muestra `ASAP`.
3. Cuando el agente responde, la acción se completa y sale de la vista predeterminada. Haga clic en **Show N Completed** para verla de nuevo; **Due** muestra `Completed`.
4. Haga clic en **View output** en esa línea. El cuadro de diálogo muestra la salida del propio instalador. Sus últimas líneas indican si el paquete se instaló, o por qué no.
5. De vuelta en la pestaña **Software** del dispositivo, haga clic en el icono de recargar. El programa aparece en la lista en cuanto Windows lo registra como instalado.

## Errores comunes

| Síntoma                                                                            | Causa                                                                                   | Solución                                                                                                                                        |
| ---------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------- |
| `Unable to contact the agent`                                                      | El dispositivo está desconectado, o el agente no respondió a tiempo                     | Revise el estado del dispositivo en **Dashboard › Sysadmin**. Vuelva a intentarlo cuando esté en línea                                          |
| La pestaña muestra **Only supported for Windows Devices**                          | El dispositivo ejecuta Linux o macOS                                                    | Instale con un script: vea [Ejecutar un comando o un script en un dispositivo](/es/sonar/administration/automation/run-commands-and-scripts.md) |
| **Install Software** aparece atenuado, *You don't have permission for this action* | Al rol le falta **Manage Software**                                                     | Añada el permiso en **Admin Center › Roles**                                                                                                    |
| El paquete no está en la lista                                                     | Desde el panel lateral solo se pueden instalar los paquetes del catálogo                | Instálelo con un script                                                                                                                         |
| **View output** muestra un error de descarga o de red                              | El dispositivo no llega al repositorio o al sitio de descarga del paquete               | Abra el acceso a Internet del dispositivo hacia esos sitios y vuelva a instalar                                                                 |
| La acción pendiente sigue pendiente                                                | El instalador sigue en ejecución, o el dispositivo se desconectó durante la instalación | Espere y luego revise el estado del dispositivo. Para empezar de nuevo, haga clic derecho en la línea y elija **Cancel Action**                 |

## Referencia de campos

Panel lateral **Install Software**

| Elemento               | Qué hace                                                                      | Predeterminado |
| ---------------------- | ----------------------------------------------------------------------------- | -------------- |
| **Search software...** | Filtra el catálogo por nombre de paquete a medida que escribe                 | Vacío          |
| Nombre del paquete     | Abre la página del paquete en el sitio web de Chocolatey en una nueva pestaña | (no aplica)    |
| **+**                  | Instala ese paquete en este dispositivo, tras confirmación                    | (no aplica)    |
| Filas por página       | 15, 30 o 50 paquetes por página                                               | 15             |
| Flechas de página      | Página anterior y página siguiente del catálogo                               | (no aplica)    |

Lista **Pending Actions**, para una instalación de software

| Columna                         | Qué muestra                                                                             |
| ------------------------------- | --------------------------------------------------------------------------------------- |
| **Type**                        | Un icono de descarga                                                                    |
| **Due**                         | `ASAP` mientras está pendiente, `Completed` una vez que el agente ha respondido         |
| **Description**                 | `<name> software install`                                                               |
| **Agent**, **Client**, **Site** | El dispositivo, su cliente y su sitio. Solo se muestran en **Agents › Pending Actions** |
| **Details**                     | **View output**, una vez completada la acción                                           |

## Páginas relacionadas

* [Inventario de software](/es/sonar/administration/software/software-inventory.md)
* [Detalles del dispositivo](/es/sonar/administration/devices/device-details.md)
* [Ejecutar un comando o un script en un dispositivo](/es/sonar/administration/automation/run-commands-and-scripts.md)
* [Ejecutar acciones en muchos dispositivos](/es/sonar/administration/automation/bulk-actions.md)
* [Requisitos de red](/es/sonar/deploy-operate/network-requirements.md)
