

• La AWS Systems Manager CloudWatch dashboard non sarà più disponibile dopo il 30 aprile 2026. I clienti possono continuare a utilizzare la CloudWatch console Amazon per visualizzare, creare e gestire le proprie CloudWatch dashboard Amazon, proprio come fanno oggi. Per ulteriori informazioni, consulta la [documentazione di Amazon CloudWatch Dashboard](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Dashboards.html). 

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Risoluzione dei problemi AWS Systems ManagerDistributor
<a name="distributor-troubleshooting"></a>

Le informazioni seguenti consentono di risolvere i problemi che potrebbero verificarsi durante l'utilizzo di Distributor, uno strumento di AWS Systems Manager.

**Topics**
+ [È installato un pacchetto errato con lo stesso nome](#distributor-tshoot-1)
+ [Errore: non è stato possibile recuperare il manifesto. Non è stato possibile trovare la versione più recente del pacchetto](#distributor-tshoot-2)
+ [Errore: non è stato possibile recuperare il manifesto. Eccezione per convalida](#distributor-tshoot-3)
+ [Il pacchetto non è supportato (manca l'azione di installazione)](#distributor-tshoot-4)
+ [Errore: impossibile scaricare il manifesto, Il documento con nome non esiste](#distributor-tshoot-5)
+ [Caricamento non riuscito.](#distributor-tshoot-6)
+ [Errore: impossibile trovare la piattaforma. Nessun manifesto trovato per la piattaforma: Oracle, versione 8.9, architettura x86\_64](#distributor-tshoot-7)

## È installato un pacchetto errato con lo stesso nome
<a name="distributor-tshoot-1"></a>

**Problema:** hai installato un pacchetto, ma Distributor ha installato un pacchetto diverso.

**Causa:** durante l'installazione, Systems Manager rileva tra i risultati i pacchetti pubblicati da AWS prima dei pacchetti esterni definiti dall'utente. Se il nome del pacchetto definito dall'utente è lo stesso di un nome di pacchetto AWS pubblicato, il AWS pacchetto viene installato al posto del pacchetto.

**Soluzione:** per evitare questo problema, assegnate al pacchetto un nome diverso dal nome di un pacchetto AWS pubblicato.

## Errore: non è stato possibile recuperare il manifesto. Non è stato possibile trovare la versione più recente del pacchetto
<a name="distributor-tshoot-2"></a>

**Problema:** hai ricevuto un errore simile al seguente.

```
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:** stai utilizzando una versione di SSM Agent con Distributor precedente alla versione 2.3.274.0.

**Soluzione:** aggiorna la versione di SSM Agent alla versione 2.3.274.0 o successiva. Per ulteriori informazioni, consulta [Aggiornamento di SSM Agent utilizzando Run Command](run-command-tutorial-update-software.md#rc-console-agentexample) o [Procedura dettagliata: aggiorna SSM Agent automaticamente con AWS CLI](state-manager-update-ssm-agent-cli.md).

## Errore: non è stato possibile recuperare il manifesto. Eccezione per convalida
<a name="distributor-tshoot-3"></a>

**Problema:** hai ricevuto un errore simile al seguente.

```
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:** stai utilizzando una versione di SSM Agent con Distributor precedente alla versione 2.3.274.0.

**Soluzione:** aggiorna la versione di SSM Agent alla versione 2.3.274.0 o successiva. Per ulteriori informazioni, consulta [Aggiornamento di SSM Agent utilizzando Run Command](run-command-tutorial-update-software.md#rc-console-agentexample) o [Procedura dettagliata: aggiorna SSM Agent automaticamente con AWS CLI](state-manager-update-ssm-agent-cli.md).

## Il pacchetto non è supportato (manca l'azione di installazione)
<a name="distributor-tshoot-4"></a>

**Problema:** hai ricevuto un errore simile al seguente.

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

**Causa:** la struttura della directory del pacchetto non è corretta.

**Soluzione:**non comprimere una directory padre contenente il software e gli script richiesti. Invece, crea un file `.zip` di tutti i contenuti richiesti direttamente nel percorso assoluto. Per verificare che il file `.zip` è stato creato correttamente, decomprimere la directory della piattaforma di destinazione ed esaminare la struttura della directory. Ad esempio, il percorso assoluto dello script di installazione dovrebbe essere `/{{ExamplePackage_targetPlatform}}/install.sh`.

## Errore: impossibile scaricare il manifesto, Il documento con nome non esiste
<a name="distributor-tshoot-5"></a>

**Problema:** hai ricevuto un errore simile al seguente. 

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

**Causa 1:** Distributor non riesce a trovare il pacchetto in base al nome del pacchetto quando si condivide un pacchetto Distributor da un altro account.

**Soluzione 1:** quando viene condiviso un pacchetto da un altro account, utilizzare il nome della risorsa Amazon (ARN) completo per il pacchetto e non solo il nome.

**Causa 2:** quando utilizzi un VPC, non hai fornito al tuo profilo di istanza IAM l'accesso al bucket S3 AWS gestito che contiene il documento `AWS-ConfigureAWSPackage` per il Regione AWS quale ti stai rivolgendo.

**Soluzione 2:** assicurati che il profilo dell'istanza IAM SSM Agent fornisca l'accesso al bucket S3 AWS gestito che contiene il documento relativo al target a cui Regione AWS ti `AWS-ConfigureAWSPackage` rivolgi, come spiegato in. [SSM Agentcomunicazioni con AWS bucket S3 gestiti](ssm-agent-technical-details.md#ssm-agent-minimum-s3-permissions)

## Caricamento non riuscito.
<a name="distributor-tshoot-6"></a>

**Problema:** hai ricevuto un errore simile al seguente. 

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

**Causa:** il nome del pacchetto software include uno spazio. Ad esempio, `Hello World.msi` non verrebbe caricato.

## Errore: impossibile trovare la piattaforma. Nessun manifesto trovato per la piattaforma: Oracle, versione 8.9, architettura x86\_64
<a name="distributor-tshoot-7"></a>

**Problema:** hai ricevuto un errore simile al seguente.

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

**Causa:** l'errore indica che il manifesto del pacchetto JSON non ha alcuna definizione per quella piattaforma, in questo caso, Oracle Linux.

**Soluzione:** scarica il pacchetto che si desidera distribuire dal sito [Trend Micro Deep Security Software](https://help.deepsecurity.trendmicro.com/software.html). Crea un pacchetto software `.rpm` utilizzando il [Crea un pacchetto utilizzando il flusso di lavoro Semplice](distributor-working-with-packages-create.md#distributor-working-with-packages-create-simple). Imposta i seguenti valori per il pacchetto e completa il pacchetto software di caricamento utilizzando Distributor:

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