

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

# Fehlerbehebung für Nimble Studio File Transfer
<a name="troubleshooting"></a>

Wenn Sie Probleme bei der Verwendung habenNimble Studio File Transfer, verwenden Sie die folgenden Informationen, um Ihre Probleme zu beheben. 

Wir empfehlen, dass Sie die Protokollierung aktivieren, indem Sie die Anweisungen unter befolgen[Protokollierung](monitoring.md#monitoring-logging).

**Topics**
+ [Generieren Sie eine Support-Datei](#troubleshooting-support-file)
+ [Fehlerbehebung in der GUI](#troubleshooting-gui)
+ [Problembehandlung bei der CLI](#troubleshooting-cli)

## Generieren Sie eine Support-Datei
<a name="troubleshooting-support-file"></a>

Sie können eine Support-Datei generieren, die Ihnen bei der Fehlerbehebung hilft. Eine Support-Datei ist eine ZIP-Datei, die Sie einem Support-Techniker zur Verfügung stellen können.

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

**Um eine Support-Datei mit der grafischen Benutzeroberfläche (GUI) zu generieren**

1. Öffnen Sie File Transfer.

   1. Gehen Sie zum **Startmenü** und suchen Sie nach **File Transfer**.

   1. Wählen Sie **Nimble Studio File Transfer**aus der Liste aus.

1. Wählen Sie das Drop-down-Menü oben rechts auf dem Bildschirm und wählen Sie **Support**.

1. Ein Dateibrowser-Menü wird geöffnet. Wählen Sie aus, wo Sie die Datei herunterladen möchten.

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

**Um eine Support-Datei mit der CLI zu generieren**
+ Öffnen Sie ein Terminal und führen Sie den folgenden Befehl aus: `filetransfer support-file`

  1. Dadurch wird eine Zip-Datei in `C:\Users\username\.filetransfer\support-files\support-file-20230310-110834.zip` (Windows) oder in `/Users/username/.tiletransfer/support-files/supportfile-20230227-185212.zip` (Linux&macOS) generiert.

  1. Die CLI gibt den Pfad zur generierten Datei aus.

------

## Fehlerbehebung in der GUI
<a name="troubleshooting-gui"></a>

Viele Fehler in der GUI können mit dem Abschnitt zur Fehlerbehebung über die Befehlszeilenschnittstelle (CLI) behoben werden. Wenn Sie innerhalb der GUI Fehler erhalten, versuchen Sie die folgenden Schritte:

1. Starten Sie File Transfer neu.

1. Öffnen Sie das Terminal unter macOS oder `cmd.exe` unter Windows. 

1. Führen Sie den folgenden Befehl aus, um eine aktive Sitzung zu starten: `filetransfer daemon` 

1. Beginnen Sie wie gewohnt mit dem Upload. Wenn Sie in der Anwendung einen Fehler erhalten haben, überprüfen Sie das CLI-Fenster. Dort sollte ein Fehler angezeigt werden.

Sie können diesen Fehler im [Problembehandlung bei der CLI](#troubleshooting-cli) Abschnitt beheben.

### File Transferkann nach dem Upgrade von v1.x auf v2.0 keine Verbindung herstellen
<a name="troubleshooting-gui-session-v2-0"></a>

**Problem****: Sie haben ein Upgrade von File Transfer v1.x auf v2.0 durchgeführt und die File Transfer GUI wechselt nicht in den Status Verbunden.**

**Lösung**: Löschen Sie den **lokalen Daemon** aus dem Dropdownmenü **Lokales Dateisystem**. Wir haben die Benennung der Komponenten aktualisiert und einige Kunden könnten je nach ihrer vorherigen Konfiguration davon betroffen sein.

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


### File Transferkann keine Verbindung herstellen
<a name="troubleshooting-gui-session"></a>

**Problem**: Die File Transfer GUI wechselt nicht in den Status **Verbunden**.

**Lösung**: Aktualisieren Sie die YAML-Datei.

1. Öffnen Sie die Konfigurationsdatei in Ihrem bevorzugten Texteditor.

   1. Die Konfigurationsdatei befindet sich in `C:\Users\username\.filetransfer\configuration.yaml` (Windows) oder `~/.filetransfer/configuration.yaml` (Linux&macOS). 

1. Stellen Sie sicher, dass sie in der Datei `api_server.enabled` vorhanden ist und dass sie auf eingestellt ist`true`. 

   1. Wenn es auf gesetzt ist`false`, kann die GUI nicht mit der File Transfer CLI kommunizieren und alle GUI-Funktionen werden deaktiviert. 

   1. Wenn es `api_server.enabled` nicht in der definiert ist`configuration.yaml`, ist es standardmäßig auf`true`.

## Problembehandlung bei der CLI
<a name="troubleshooting-cli"></a>

### Abgelaufene oder ungültige Anmeldeinformationen
<a name="troubleshooting-expired-credentials"></a>



**Problem**: Wenn mit den von Ihnen angegebenen Anmeldeinformationen File Transfer Probleme auftreten, wird Ihnen eine der folgenden Fehlermeldungen angezeigt. 

```
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*=*
```

**Lösung**: Aktualisieren Sie die Anmeldeinformationen für das AWS Profil, indem Sie den Anweisungen auf der Seite mit den [Einstellungen für die Konfiguration und die Anmeldeinformationsdatei](https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-files.html) im AWS Command Line Interface Benutzerhandbuch folgen. 

### Ungültiges Übertragungsprofil
<a name="troubleshooting-invalid-transfer-profile"></a>

**Fehler:** FATAL [202X-XX-XX XX:XX:XX] Ungültiges Übertragungsprofil. Gültige Übertragungsprofile:

**Problem**: Sie verwenden einen Namen für die Remote-Konfiguration, der noch nicht eingerichtet wurde. 

**Lösung**: Aktualisieren Sie die Remote-Konfigurationen.

1. Wählen Sie das Drop-down-Menü (![\[The menu icon.\]](http://docs.aws.amazon.com/de_de/nimble-studio/latest/filetransfer-guide/images/icon-three-horizontal.png)). Wählen Sie dann **Einstellungen.** 

1. Wenn im Abschnitt **Gültige** Remote-Konfigurationen keine Remote-Konfigurationen aufgeführt sind, fügen Sie eine Remote-Konfiguration hinzu, indem Sie den Anweisungen unter folgen[Schritt 2: Konfigurieren von File Transfer](getting-started.md#getting-started-configure). 

1. Wenn es eine Remote-Konfiguration gibt, stellen Sie sicher, dass Sie den Namen dieser Remote-Konfiguration nicht falsch geschrieben haben. 

1. Wenn Sie nichts falsch geschrieben haben, überprüfen Sie im Fehlerteil „Gültige Remote-Konfigurationen:“, ob eine bestimmte Remote-Konfiguration aufgeführt ist. 

1. Wenn Sie Ihre Remote-Konfiguration immer noch nicht sehen, stellen Sie sicher, dass Ihr YAML richtig formatiert ist und dass Sie die richtige YAML-Datei bearbeiten. Die YAML-Datei ist an den angemeldeten Benutzer gebunden. 
**Wichtig**  
Führen Sie unter Windows CMD.exe nicht oder PowerShell als Administrator aus. Wenn Sie dies tun, versucht Ihr Computer, aus einer Konfigurationsdatei zu lesen, die sich nicht in der lokalen Benutzerdatei befindet. 

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

**Fehler**: FATAL [202X-XX-XX XX:XX:XX] Nicht behebbarer Fehler: Wiederholbar: Wiederholbar: RequestError

 **Problem 1**: Ihr Computer hat die Verbindung zum Internet getrennt und die Verbindung zum S3-Bucket verloren.

**Lösung 1**: Suchen Sie in diesem Fall nach einem Netzwerkausfall oder nach Firewall-Einschränkungen.

**Problem 2**: Das Laufwerk, auf dem die Medien gespeichert werden, ist nicht in der Lage, die Belastung zu bewältigen, die File Transfer darauf lastet. Dies führt zu einem Verlust der Verbindung zum Medium. Dies kann bei Netzlaufwerken häufig der Fall sein. 

**Lösung 2**: Senken Sie die maximale Anzahl aktiver Übertragungen und die Anzahl der Threads `1` und versuchen Sie erneut, den Upload durchzuführen.

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

**Um die maximale Anzahl aktiver Übertragungen und die Anzahl der Threads `1` mithilfe der GUI zu senken**

1. Öffnen Sie File Transfer.

   1. Gehe zum **Startmenü** und suche nach **File Transfer**.

   1. Wählen Sie **Nimble Studio File Transfer**aus der Liste aus.

1. Wählen Sie das Drop-down-Menü oben rechts auf dem Bildschirm und wählen Sie dann **Einstellungen**. 

1. Ändern Sie im Bereich **S3-Einstellungen** die Werte **Max. Anzahl aktiver Übertragungen** und **Anzahl der Threads** auf**1**. 

1. Wählen Sie **Speichern** und versuchen Sie den Upload erneut.

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

**Um die maximale Anzahl aktiver Übertragungen und die Anzahl der Threads `1` mithilfe der CLI zu senken**

1. Öffnen Sie die Konfigurationsdatei mit einer beliebigen Textbearbeitungssoftware auf Ihrem Computer. 

   1. Windows: Navigieren Sie zu dem `User/<your username>` Ordner auf Ihrem Computer. Öffnen Sie den `.filetransfer` Ordner und öffnen Sie die `filetransfer.yaml` Datei mit einem Texteditor. 

   1. macOS: Geben Sie ein**Cmd\$1Shift\$1G**. Dann treten Sie ein**\$1/.filetransfer**. Öffnen Sie die Datei `filetransfer.yaml` mit einem Text-Editor.

   1. Linux: Öffnen Sie die `filetransfer.yaml` Datei mit einem beliebigen Texteditor. Die Datei befindet sich in`~/.filetransfer/configuration.yaml`.

1. Aktualisieren Sie die Werte von `max_active_transfers` und `threads` zu`1`.

1. Speichern Sie die Konfigurationsdatei.

------

Erhöhen Sie langsam die Werte für die maximale Anzahl aktiver Übertragungen und die Anzahl der Threads, bis Sie eine Konfiguration erreichen, die Ihr Laufwerk nicht überlastet.

### Absoluter Pfad
<a name="troubleshooting-absolute-path"></a>

**Fehler**: WARN [202X-XX-XX XX:XX:XX] Absolute Pfade werden nicht unterstützt. /me dia/drive wird ignoriert

**Problem: Wenn** Sie diese Warnung erhalten, bedeutet dies, dass Sie einen absoluten Pfad verwenden, der nicht unterstützt wird. Ein absoluter Pfad enthält den Laufwerksbuchstaben. Denn Windows das ist`C:\`. Für Linux undmacOS, das ist der führende:`/`.

**Lösung**: Wenn Sie sich auf der Stammebene befinden, entfernen Sie das führende `C:\` Zeichen (Windows) oder `/` (Linux&macOS). Wenn nicht, ersetzen Sie den Pfad relativ zu Ihrem aktuellen Arbeitsverzeichnis.

### Verbindung konnte nicht geöffnet werden
<a name="troubleshooting-connection"></a>

**Fehler**: Verbindung konnte nicht geöffnet werden.

**Problem 1**: Eine andere File Transfer Anwendung läuft. 

**Lösung 1**: Schließen Sie alle anderen laufenden File Transfer Anwendungen. Alternativ können Sie in der Konfigurationsdatei den Wert `api_server.enabled` auf False ändern.

**Problem 2**: File Transfer versucht, einen Port abzuhören, den Sie nicht hören können. Dies kann passieren, wenn Ihr Benutzer nicht berechtigt ist, den Port abzuhören, oder wenn Sie Port 1023 oder niedriger verwenden. Diese werden als privilegierte Ports betrachtet. Diese Ports müssen Sie als Administrator ausführen, um sie abhören zu können.

**Lösung 2**: Stellen Sie sicher, dass jeder Benutzer, der File Transfer gerade läuft, berechtigt ist, diese Ports abzuhören. Sie können den Port auch auf 1024 oder höher ändern.

**Problem 3**: Ein anderes Programm verwendet denselben Port.

**Lösung 3**: Beenden Sie das andere Programm, das denselben Port verwendet. 