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 relativi a Session Manager

Utilizza le informazioni seguenti per risolvere i problemi relativi a AWS Systems Manager Session Manager.

AccessDeniedException quando si chiama l' TerminateSession operazione

Problema: quando si tenta di terminare una sessione, Systems Manager restituisce il seguente errore:

An error occurred (AccessDeniedException) when calling the TerminateSession operation: 
User: <user_arn> is not authorized to perform: ssm:TerminateSession on resource: 
<ssm_session_arn> because no identity-based policy allows the ssm:TerminateSession action.

Soluzione A: verificare che la versione più recente del Session Manager plugin sia installata sul nodo

Immettete il seguente comando nel terminale e premete Invio.

session-manager-plugin --version

Soluzione B: installa o reinstalla l'ultima versione del plugin

Per ulteriori informazioni, consulta Installazione del plugin Session Manager per la AWS CLI.

Soluzione C: tentativo di ristabilire una connessione al nodo

Verifica che il nodo risponda alle richieste. Prova a ristabilire la sessione. Oppure, se necessario, apri la EC2 console Amazon e verifica che lo stato dell'istanza sia in esecuzione.

Il processo documentale è fallito improvvisamente: l'operatore documentale è scaduto

Problema: quando si avvia una sessione su un host Linux, Systems Manager restituisce il seguente errore:

document process failed unexpectedly: document worker timed out, 
check [ssm-document-worker]/[ssm-session-worker] log for crash reason

Se è stata configurata la registrazione dell'SSM Agent, come descritto in Visualizzazione dei registri di SSM Agent, è possibile visualizzare maggiori dettagli nel log di debug. Per questo problema, Session Manager mostra la seguente voce di log:

failed to create channel: too many open files

Questo errore indica in genere che ci sono troppi processi di lavoro Session Manager in esecuzione e che il sistema operativo sottostante ha raggiunto un limite. Sono disponibili due opzioni per la risoluzione di questo problema.

Soluzione A: aumentare il limite di notifica dei file del sistema operativo

È possibile aumentare il limite eseguendo il comando seguente da un host Linux separato. Questo comando utilizza Systems Manager Run Command. Il valore specificato fa aumentare max_user_instances fino a 8192. Questo valore è notevolmente superiore al valore predefinito di 128, ma non affaticherà le risorse dell'host:

aws ssm send-command --document-name AWS-RunShellScript \
--instance-id i-02573cafcfEXAMPLE  --parameters \
"commands=sudo sysctl fs.inotify.max_user_instances=8192"

Soluzione B: diminuire le notifiche relative ai file utilizzate da Session Manager nell'host di destinazione

Esegui il comando seguente da un host Linux separato per elencare le sessioni in esecuzione sull'host di destinazione:

aws ssm describe-sessions --state Active --filters key=Target,value=i-02573cafcfEXAMPLE

Esamina l'output del comando per identificare le sessioni che non sono più necessarie. È possibile terminare tali sessioni eseguendo il comando seguente da un host Linux separato:

aws ssm terminate-session —session-id session ID

Facoltativamente, quando non ci sono più sessioni in esecuzione sul server remoto, è possibile liberare risorse aggiuntive eseguendo il comando seguente da un host Linux separato. Questo comando termina tutti i processi di Session Manager in esecuzione sull'host remoto e, di conseguenza, tutte le sessioni sull'host remoto. Prima di eseguire questo comando, verifica che non ci siano sessioni in corso che desideri mantenere:

aws ssm send-command --document-name AWS-RunShellScript \
            --instance-id i-02573cafcfEXAMPLE --parameters \
'{"commands":["sudo kill $(ps aux | grep ssm-session-worker | grep -v grep | awk '"'"'{print $2}'"'"')"]}'

Session Managerimpossibile connettersi dalla EC2 console Amazon

Problema: dopo aver creato una nuova istanza, il pulsante Connect > scheda Session Manager nella console Amazon Elastic Compute Cloud (Amazon EC2) non ti offre la possibilità di connetterti.

Soluzione A: crea un profilo di istanza: se non l'hai già fatto (come indicato dalle informazioni nella scheda Session Manager nella EC2 console), crea un profilo di istanza AWS Identity and Access Management (IAM) utilizzando. Quick Setup Quick Setupè uno strumento in AWS Systems Manager.

Session Manager richiede un profilo dell'istanza IAM per connettersi all'istanza. È possibile creare un profilo dell'istanza e assegnarlo all'istanza creando una configurazione di gestione dell'host con Quick Setup. Una configurazione di gestione dell'host crea un profilo dell'istanza con le autorizzazioni richieste e lo assegna all'istanza. Una configurazione di gestione dell'host abilita anche altri strumenti di Systems Manager e crea ruoli IAM per l'esecuzione di tali strumenti. L'utilizzo Quick Setup degli strumenti abilitati dalla configurazione di gestione dell'host è gratuito. Apri Quick Setup e crea una configurazione di gestione dell'host.

Se non riesci ancora a connetterti dopo aver creato una configurazione di gestione dell'host o se ricevi un errore, incluso un errore relativo a SSM Agent, consulta una delle seguenti soluzioni:

Soluzione B: nessun errore, ma non riesci ancora a connetterti

Se hai creato la configurazione di gestione dell'host, hai aspettato diversi minuti prima di provare a connetterti e non riesci ancora a connetterti, potrebbe essere necessario applicare manualmente la configurazione di gestione dell'host all'istanza. Utilizza la procedura seguente per aggiornare una configurazione di gestione dell'host di Quick Setup e applicare le modifiche a un'istanza.

Attendi qualche minuto EC2 per aggiornare la scheda Session Manager. Se ancora non riesci a connetterti o se ricevi un errore, esamina le soluzioni rimanenti per questo problema.

Soluzione C: errore relativo alla mancanza di SSM Agent

Se non sei riuscito a creare una configurazione di gestione dell'host utilizzando Quick Setup o se hai ricevuto un errore relativo alla SSM Agent mancata installazione, potresti dover eseguire l'installazione manualmente SSM Agent sull'istanza. SSM Agentè un software Amazon che consente a Systems Manager di connettersi alla tua istanza utilizzandoSession Manager. SSM Agentè installato per impostazione predefinita sulla maggior parte delle Amazon Machine Images (AMIs). Se l'istanza è stata creata da un'AMI non standard o da un'AMI precedente, potrebbe essere necessario installare manualmente l'agente. Per la procedura di installazione di SSM Agent, consulta il seguente argomento che corrisponde al sistema operativo dell'istanza.

Per problemi con SSM Agent, vedi Risoluzione dei problemi relativi a SSM Agent.

Nessuna autorizzazione ad avviare una sessione

Problema: tenti di avviare una sessione, ma il sistema indica che non disponi delle autorizzazioni necessarie.

SSM Agent non online

Problema: Session Managernella scheda dell' EC2 istanza Amazon viene visualizzato un messaggio che indica: "non SSM Agent è online. Non SSM Agent è riuscito a connettersi a un endpoint Systems Manager per registrarsi al servizio.»

Soluzione: SSM Agent è un software Amazon che viene eseguito su EC2 istanze Amazon in modo che Session Manager possa connettersi ad esse. Se viene visualizzato questo errore, significa che l'SSM Agent non è in grado di stabilire una connessione con l'endpoint di Systems Manager. Le possibili cause del problema potrebbero essere le restrizioni del firewall, i problemi di routing o la mancanza di connettività Internet. Per risolvere il problema, esaminare i problemi di connettività di rete. Per ulteriori informazioni, consultare Risoluzione dei problemi relativi a SSM Agent e Risoluzione dei problemi relativi alla disponibilità dei nodi gestiti. Per informazioni sugli endpoint di Systems Manager, vedere AWS Systems Manager endpoints and quote nel AWS Riferimento generale.

Nessuna autorizzazione a modificare le preferenze delle sessioni

Problema: tenti di aggiornare le preferenze globali delle sessioni della tua organizzazione, ma il sistema indica che non disponi delle autorizzazioni necessarie.

Nodo gestito non disponibile o non configurato per Session Manager

Problema 1: desideri avviare una sessione dalla pagina della console Start a session (Avvia una sessione), ma non sono presenti nodi gestiti nell'elenco.

Problema 2: un nodo gestito che desideri connettere si trova nell'elenco nella pagina della console Avvia una sessione, ma la pagina segnala che "L'istanza selezionata non è configurata per l'uso di Session Manager."

Plug-in Session Manager non trovato

Per utilizzare i comandi AWS CLI per eseguire la sessione, il Session Manager plug-in deve essere installato anche sul computer locale. Per informazioni, consulta Installazione del plugin Session Manager per la AWS CLI.

Il plug-in di Session Manager non viene aggiunto automaticamente al percorso della riga di comando (Windows)

Quando installi il plug-in di Session Manager su Windows, l'eseguibile session-manager-plugin dovrebbe essere aggiunto automaticamente alla variabile di ambiente PATH del sistema operativo. Se il comando ha esito negativo quando lo esegui per verificare se il plug-in Session Manager è stato installato correttamente (aws ssm start-session --target instance-id), potrebbe essere necessario impostarlo manualmente utilizzando la seguente procedura.

Il plug-in Session Manager non risponde

Durante una sessione di inoltro della porta, il traffico potrebbe interrompere l'inoltro se nel computer locale è installato un software antivirus. In alcuni casi, il software antivirus interferisce con il plug-in Session Manager che causa deadlock del processo. Per risolvere il problema, consentire o escludere il plug-in Session Manager dal software antivirus. Per informazioni sul percorso di installazione predefinito del plug-in Session Manager, consulta Installazione del plugin Session Manager per la AWS CLI.

TargetNotConnected

Problema: si tenta di avviare una sessione, ma il sistema restituisce il messaggio di errore «Si è verificato un errore (TargetNotConnected) durante la chiamata all' StartSession operazione: InstanceID non è connesso».

Dopo l'avvio di una sessione viene visualizzata una schermata vuota

Problema: avvii una sessione e Session Manager visualizza una schermata vuota.

Il nodo gestito non risponde durante le sessioni di esecuzione prolungata

Problema: il nodo gestito non risponde o si arresta in modo anomalo durante una sessione di esecuzione prolungata.

Soluzione: riduci la durata di conservazione dei log SSM Agent di Session Manager.

Si è verificato un errore (InvalidDocument) durante la chiamata dell'operazione StartSession

Problema: quando avvii una sessione utilizzando la AWS CLI, visualizzi l'errore seguente.

An error occurred (InvalidDocument) when calling the StartSession operation: Document type: 'Command' is not supported. Only type: 'Session' is supported for Session Manager.

Soluzione: il documento SSM specificato per il parametro --document-name non è un documento di Sessione. Utilizza la procedura seguente per visualizzare un elenco di documenti di sessione nella AWS Management Console.