

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 Nimble Studio File Transfer
<a name="troubleshooting"></a>

Se riscontri problemi di utilizzoNimble Studio File Transfer, utilizza le seguenti informazioni per aiutarti a risolvere i problemi. 

Ti consigliamo di attivare la registrazione seguendo le istruzioni riportate in. [Registrazione](monitoring.md#monitoring-logging)

**Topics**
+ [Genera un file di supporto](#troubleshooting-support-file)
+ [Risoluzione dei problemi della GUI](#troubleshooting-gui)
+ [Risoluzione dei problemi della CLI](#troubleshooting-cli)

## Genera un file di supporto
<a name="troubleshooting-support-file"></a>

È possibile generare un file di supporto per facilitare la risoluzione dei problemi. Un file di supporto è un file zip che è possibile fornire a un tecnico dell'assistenza.

------
#### [ GUI ]

**Per generare un file di supporto utilizzando l'interfaccia utente grafica (GUI)**

1. Aprire File Transfer.

   1. Vai al **menu Start** e cerca. **File Transfer**

   1. Seleziona **Nimble Studio File Transfer**dall'elenco.

1. Seleziona il menu a discesa nella parte superiore destra dello schermo e scegli **Support**.

1. Si apre un menu del browser di file. Scegliete dove scaricare il file.

------
#### [ CLI ]

**Per generare un file di supporto utilizzando la CLI**
+ Apri un terminale ed esegui il seguente comando: `filetransfer support-file`

  1. Questo genererà un file zip in `C:\Users\username\.filetransfer\support-files\support-file-20230310-110834.zip` (Windows) o in `/Users/username/.tiletransfer/support-files/supportfile-20230227-185212.zip` (Linux&macOS).

  1. La CLI restituirà il percorso del file generato.

------

## Risoluzione dei problemi della GUI
<a name="troubleshooting-gui"></a>

Molti errori relativi alla GUI possono essere risolti con la sezione di risoluzione dei problemi dell'interfaccia a riga di comando (CLI). Se ricevi errori all'interno della GUI, prova i seguenti passaggi:

1. Riavviare File Transfer.

1. Apri il terminale su macOS o `cmd.exe` su Windows. 

1. Esegui il seguente comando per avviare una sessione attiva: `filetransfer daemon` 

1. Inizia un caricamento come al solito. Dopo aver ricevuto un errore nell'applicazione, controlla la finestra CLI. Lì dovrebbe apparire un errore.

Puoi risolvere questo errore nella sezione. [Risoluzione dei problemi della CLI](#troubleshooting-cli)

### File Transfernon è in grado di connettersi dopo l'aggiornamento dalla v1.x alla v2.0
<a name="troubleshooting-gui-session-v2-0"></a>

**Problema****: hai eseguito l'aggiornamento dalla File Transfer v1.x alla v2.0 e la GUI non inserirà lo stato Connesso. File Transfer**

**Soluzione****: elimina **Local Daemon** dal menu a discesa Local File System.** Abbiamo aggiornato la denominazione dei componenti e alcuni clienti potrebbero risentirne a seconda della configurazione precedente.

![\[alt text not found\]](http://docs.aws.amazon.com/it_it/nimble-studio/latest/filetransfer-guide/images/nsft-troubleshooting.png)


### File Transfernon è in grado di connettersi
<a name="troubleshooting-gui-session"></a>

**Problema**: la File Transfer GUI non inserirà lo stato **Connesso**.

**Soluzione**: aggiorna il file YAML.

1. Apri il file di configurazione nel tuo editor di testo preferito.

   1. Il file di configurazione si trova in `C:\Users\username\.filetransfer\configuration.yaml` (Windows) o `~/.filetransfer/configuration.yaml` (Linux&macOS). 

1. Verificate che `api_server.enabled` esista nel file e che sia impostato su`true`. 

   1. Se è impostato su`false`, la GUI non sarà in grado di comunicare con la File Transfer CLI e tutte le funzionalità della GUI verranno disabilitate. 

   1. Se `api_server.enabled` non è definito in`configuration.yaml`, il valore predefinito è. `true`

## Risoluzione dei problemi della CLI
<a name="troubleshooting-cli"></a>

### Credenziali scadute o non valide
<a name="troubleshooting-expired-credentials"></a>



**Problema**: se le credenziali che hai fornito File Transfer presentano problemi, riceverai uno dei seguenti errori. 

```
FATAL  *[*202X-XX-XX XX:XX:XX*]* Failed establishing a session to AWS:InvalidAccessKeyId: The AWS Access Key Id you provided does not exist *in* our records. status code: 403, request id: FFYEFCKZX6F1YN8H, host id: aFtPOImvXdJQ+Ukf8SYRobDx4xmZsikoJUyJszJf3Wv74w0Q5cP9TCDz/YLKwSi53hc0hBScd58*=*
or
FATAL  *[*202X-XX-XX XX:XX:XX*]* Failed establishing a session to AWS:ExpiredToken: The provided token has expired. status code: 400, request id: 130NC8C984YZJMJH, host id: j7aA3Zs/O/H3QMYeoDv5Y62o7Mu/9tvi5m7jUVqTnveLZX4qrl/bKJl1j3dLVnhVda/WaUbEgO8*=*
```

**Soluzione**: aggiorna le credenziali per il AWS profilo seguendo le istruzioni nella pagina delle [impostazioni del file di configurazione e delle credenziali](https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-files.html) nella Guida per l'utente. AWS Command Line Interface 

### Profilo di trasferimento non valido
<a name="troubleshooting-invalid-transfer-profile"></a>

**Errore::** FATAL [202X-XX-XX XX:XX] Profilo di trasferimento non valido. Profili di trasferimento validi:

**Problema**: stai utilizzando un nome di configurazione remota che non è stato ancora configurato. 

**Soluzione**: aggiorna le configurazioni remote.

1. Scegli il menu a discesa ()![\[The menu icon.\]](http://docs.aws.amazon.com/it_it/nimble-studio/latest/filetransfer-guide/images/icon-three-horizontal.png). Quindi scegli **Impostazioni.** 

1. Se non ci sono configurazioni remote elencate nella sezione **Configurazioni remote valide**, aggiungi una configurazione remota seguendo le istruzioni riportate in. [Fase 2: configurazione di File Transfer](getting-started.md#getting-started-configure) 

1. Se esiste una configurazione remota, assicurati di non aver digitato male il nome di quella configurazione remota. 

1. Se non hai scritto nulla in modo errato, controlla la parte «Configurazioni remote valide:» dell'errore per vedere se è elencata una configurazione remota specifica. 

1. Se ancora non vedi la tua configurazione remota, assicurati che YAML sia formattato correttamente e che tu stia modificando il file YAML corretto. Il file YAML è collegato all'utente che ha effettuato l'accesso. 
**Importante**  
In Windows, non eseguire CMD.exe o PowerShell come amministratore. In tal caso, il computer proverà a leggere un file di configurazione che non si trova nel file utente locale. 

### TCP I/O
<a name="troubleshooting-tcp-io"></a>

**Errore**: FATAL [202X-XX-XX XX:XX] Errore irreversibile: ritryable: retryable: RequestError

 **Problema 1**: il computer si è disconnesso da Internet e ha perso la connessione al bucket S3.

**Soluzione 1**: in questo caso, verifica la presenza di un'interruzione della rete o di eventuali restrizioni del firewall.

**Problema 2**: l'unità in cui è archiviato il file multimediale non è in grado di gestire il carico che vi File Transfer viene addebitato. Ciò causa una perdita di connessione al supporto. Questo problema può essere comune tra le unità di rete. 

**Soluzione 2**: riduci il numero massimo di trasferimenti attivi e il numero di thread `1` e riprova a eseguire il caricamento.

------
#### [ GUI ]

**Per ridurre il numero massimo di trasferimenti attivi e il numero di thread `1` utilizzando la GUI**

1. Aprire File Transfer.

   1. Vai al **menu Start** e cerca. **File Transfer**

   1. Seleziona **Nimble Studio File Transfer**dall'elenco.

1. Scegli il menu a discesa in alto a destra dello schermo, quindi scegli **Impostazioni**. 

1. Nella sezione delle **impostazioni S3**, modifica il numero **massimo di trasferimenti attivi** e il **numero di thread** su. **1** 

1. Scegli **Salva** e riprova a caricare.

------
#### [ CLI ]

**Per ridurre il numero massimo di trasferimenti attivi e il numero di thread verso `1` utilizzando la CLI**

1. Apri il file di configurazione con qualsiasi software di modifica del testo sul tuo computer. 

   1. Windows: accedi alla `User/<your username>` cartella sul tuo computer. Apri la `.filetransfer` cartella e apri il `filetransfer.yaml` file con un editor di testo. 

   1. macOS: Invio**Cmd\$1Shift\$1G**. Quindi entra**\$1/.filetransfer**. Apri il file `filetransfer.yaml` con un editor di testo.

   1. Linux: apri il `filetransfer.yaml` file utilizzando un editor di testo qualsiasi. Il file si trova in`~/.filetransfer/configuration.yaml`.

1. Aggiorna i valori di `max_active_transfers` e `threads` a`1`.

1. Salvate il file di configurazione.

------

Aumenta lentamente i valori massimi di trasferimenti attivi e il numero di thread fino a raggiungere una configurazione che non sovraccarichi l'unità.

### Percorso assoluto
<a name="troubleshooting-absolute-path"></a>

**Errore**: WARN [202X-XX-XX XX:XX] I percorsi assoluti non sono supportati, ignorando /me dia/drive

**Problema**: la ricezione di questo avviso significa che si sta utilizzando un percorso assoluto non supportato. Un percorso assoluto contiene la lettera dell'unità. Perché Windows questo è`C:\`. Per Linux emacOS, questo è il principale:`/`.

**Soluzione**: Se sei al livello principale, rimuovi l'iniziale `C:\` (Windows) o `/` (Linux&macOS). In caso contrario, sostituite il percorso relativo alla directory di lavoro corrente.

### Impossibile aprire la connessione
<a name="troubleshooting-connection"></a>

**Errore**: impossibile aprire la connessione.

**Problema 1**: è in esecuzione un'altra File Transfer applicazione. 

**Soluzione 1**: chiudete tutte le altre File Transfer applicazioni in esecuzione. In alternativa, potete passare `api_server.enabled` a false nel file di configurazione.

**Problema 2**: File Transfer sta cercando di ascoltare su una porta che non puoi ascoltare. Questo può accadere se l'utente non è autorizzato ad ascoltare la porta o se si utilizza la porta 1023 o una versione inferiore. Queste sono considerate porte privilegiate. Queste porte richiedono l'esecuzione come amministratore per ascoltarle.

**Soluzione 2**: assicuratevi che chiunque sia in esecuzione File Transfer abbia il permesso di ascoltare queste porte. Puoi anche cambiare la porta a 1024 o superiore.

**Problema 3**: un altro programma utilizza la stessa porta.

**Soluzione 3**: arrestate l'altro programma che utilizza la stessa porta. 