

• El panel de AWS Systems Manager CloudWatch dejará de estar disponible después del 30 de abril de 2026. Los clientes pueden seguir utilizando la consola de Amazon CloudWatch para ver, crear y administrar sus paneles de Amazon CloudWatch, tal y como lo hacen actualmente. Para obtener más información, consulte la [documentación del panel de Amazon CloudWatch](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Dashboards.html). 

# AWS Systems ManagerSolución de problemasDistributor
<a name="distributor-troubleshooting"></a>

La siguiente información puede ayudarlo a solucionar problemas que pueden ocurrir cuando utiliza Distributor, una herramienta de AWS Systems Manager.

**Topics**
+ [Instalación de paquete incorrecto con el mismo nombre](#distributor-tshoot-1)
+ [Error: no se pudo recuperar el manifiesto: no se pudo encontrar la versión más reciente del paquete](#distributor-tshoot-2)
+ [Error: no se pudo recuperar el manifiesto: excepción de validación](#distributor-tshoot-3)
+ [El paquete no es compatible (falta la acción de instalación del paquete)](#distributor-tshoot-4)
+ [Error: Error al descargar el manifiesto: el documento con el nombre no existe](#distributor-tshoot-5)
+ [Carga fallida.](#distributor-tshoot-6)
+ [Error: No se pudo encontrar la plataforma: no se encontró ningún manifiesto para la plataforma: Oracle, versión 8.9, arquitectura x86\$164](#distributor-tshoot-7)

## Instalación de paquete incorrecto con el mismo nombre
<a name="distributor-tshoot-1"></a>

**Problema:** ha instalado un paquete, pero Distributor ha instalado un paquete diferente en su lugar.

**Causa:** durante la instalación, Systems Manager encuentra paquetes publicados por AWS como resultados antes que los paquetes externos definidos por el usuario. Si el nombre del paquete definido por el usuario es el mismo que un nombre de paquete publicado por AWS, el paquete de AWS se instala en lugar de su paquete.

**Solución:** para evitar este problema, asigne al paquete un nombre algo diferente del nombre de un paquete publicado por AWS.

## Error: no se pudo recuperar el manifiesto: no se pudo encontrar la versión más reciente del paquete
<a name="distributor-tshoot-2"></a>

**Problema:** ha recibido un error como el siguiente.

```
Failed to retrieve manifest: ResourceNotFoundException: Could not find the latest version of package 
arn:aws:ssm:::package/package-name status code: 400, request id: guid
```

**Causa:** está utilizando una versión de SSM Agent con Distributor anterior a la versión 2.3.274.0.

**Solución:** actualice la versión de SSM Agent a la versión 2.3.274.0 o una versión posterior. Para obtener más información, consulte [Actualización de SSM Agent mediante Run Command](run-command-tutorial-update-software.md#rc-console-agentexample) o [Tutorial: actualización automática de SSM Agent con AWS CLI](state-manager-update-ssm-agent-cli.md).

## Error: no se pudo recuperar el manifiesto: excepción de validación
<a name="distributor-tshoot-3"></a>

**Problema:** ha recibido un error como el siguiente.

```
Failed to retrieve manifest: ValidationException: 1 validation error detected: Value 'documentArn'
at 'packageName' failed to satisfy constraint: Member must satisfy regular expression pattern:
arn:aws:ssm:region-id:account-id:package/package-name
```

**Causa:** está utilizando una versión de SSM Agent con Distributor anterior a la versión 2.3.274.0.

**Solución:** actualice la versión de SSM Agent a la versión 2.3.274.0 o una versión posterior. Para obtener más información, consulte [Actualización de SSM Agent mediante Run Command](run-command-tutorial-update-software.md#rc-console-agentexample) o [Tutorial: actualización automática de SSM Agent con AWS CLI](state-manager-update-ssm-agent-cli.md).

## El paquete no es compatible (falta la acción de instalación del paquete)
<a name="distributor-tshoot-4"></a>

**Problema:** ha recibido un error como el siguiente.

```
Package is not supported (package is missing install action)
```

**Causa:** la estructura del directorio del paquete es incorrecta.

**Solución:** no comprima un directorio principal que contenga el software y los scripts necesarios. En su lugar, cree un archivo de `.zip` con todos los contenidos requeridos directamente en la ruta absoluta. Para comprobar que el archivo de `.zip` se creó correctamente, descomprima el directorio de la plataforma destino y revise la estructura del directorio. Por ejemplo, la ruta absoluta del script de instalación debe ser `/ExamplePackage_targetPlatform/install.sh`.

## Error: Error al descargar el manifiesto: el documento con el nombre no existe
<a name="distributor-tshoot-5"></a>

**Problema**: ha recibido un error como el siguiente. 

```
Failed to download manifest - failed to retrieve package document description: InvalidDocument: Document with name filename does not exist.
```

**Causa 1:** Distributor no puede encontrar el paquete por el nombre del paquete al compartir un paquete de Distributor de otra cuenta.

**Solución 1:** cuando comparta un paquete de otra cuenta, utilice el Nombre de recurso de Amazon (ARN) completo del paquete y no solo el nombre.

**Causa 2:** cuando utiliza una VPC, no ha proporcionado el perfil de instancia de IAM con acceso al bucket de S3 administrado de AWS que contiene el documento `AWS-ConfigureAWSPackage` para la Región de AWS de destino.

**Solución 2:** asegúrese de que el perfil de instancia de IAM proporcione a SSM Agent acceso al bucket de S3 administrado de AWS que contiene el documento `AWS-ConfigureAWSPackage` para la Región de AWS de destino, como se explica en [SSM Agent Comunicaciones de AWS con buckets de S3 administrados de](ssm-agent-technical-details.md#ssm-agent-minimum-s3-permissions).

## Carga fallida.
<a name="distributor-tshoot-6"></a>

**Problema**: ha recibido un error como el siguiente. 

```
Upload failed. At least one of your files was not successfully uploaded to your S3 bucket.
```

**Causa:** el nombre del paquete de software incluye un espacio. Por ejemplo, `Hello World.msi` no se podría cargar.

## Error: No se pudo encontrar la plataforma: no se encontró ningún manifiesto para la plataforma: Oracle, versión 8.9, arquitectura x86\$164
<a name="distributor-tshoot-7"></a>

**Problema**: ha recibido un error como el siguiente.

```
Failed to find platform: no manifest found for platform: oracle, version 8.9, architecture x86_64
```

**Causa:** el error significa que el manifiesto del paquete JSON no tiene ninguna definición para esa plataforma, en este caso, Oracle Linux.

**Solución:** descargue el paquete que desee distribuir del sitio web de [Deep Security Software de Trend Micro](https://help.deepsecurity.trendmicro.com/software.html). Cree un paquete de software `.rpm` mediante [Cómo crear un paquete mediante el flujo de trabajo simple](distributor-working-with-packages-create.md#distributor-working-with-packages-create-simple). Establezca los siguientes valores para el paquete y complete la carga del paquete de software con Distributor:

```
Platform version: _any
Target platform: oracle
Architecture: x86_64
```