Risoluzione dei problemi relativi a Nimble Studio File Transfer

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

Genera un file di supporto

È 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

   2. Seleziona Nimble Studio File Transferdall'elenco.

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

3. 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).

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

Risoluzione dei problemi della GUI

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.

2. Apri il terminale su macOS o cmd.exe su Windows.

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

4. 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

File Transfernon è in grado di connettersi dopo l'aggiornamento dalla v1.x alla v2.0

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.

File Transfernon è in grado di connettersi

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).

2. Verificate che api_server.enabled esista nel file e che sia impostato sutrue.

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

   2. Se api_server.enabled non è definito inconfiguration.yaml, il valore predefinito è. true

Risoluzione dei problemi della CLI

Credenziali scadute o non valide

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 nella Guida per l'utente. AWS Command Line Interface

Profilo di trasferimento non valido

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 () . Quindi scegli Impostazioni.

2. 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

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

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

5. 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

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

   2. Seleziona Nimble Studio File Transferdall'elenco.

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

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

4. 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.

   2. macOS: InvioCmd+Shift+G. Quindi entra~/.filetransfer. Apri il file filetransfer.yaml con un editor di testo.

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

2. Aggiorna i valori di max_active_transfers e threads a1.

3. 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

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

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.