本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
# Nimble Studio File Transfer 疑難排解
如果您在使用時遇到問題Nimble Studio File Transfer，請使用下列資訊協助您疑難排解問題。
我們建議您依照中的指示開啟記錄[日誌](monitoring.md#monitoring-logging)。
**Topics**
+ [產生支援檔](#troubleshooting-support-file)
+ [疑難排解 GUI](#troubleshooting-gui)
+ [疑難排解 CLI](#troubleshooting-cli)
## 產生支援檔
您可以產生支援檔案來協助您進行疑難排解。支援檔案是您可以提供給支援工程師的 zip 檔案。
------
#### [ GUI ]
**使用圖形化使用者介面 (GUI) 產生支援檔**
1. 打開 File Transfer.
1. 轉到開**始菜單**並搜索**File Transfer**。
1. **Nimble Studio File Transfer**從清單中選取。
1. 選擇屏幕右上角的下拉菜單，然後選擇 Sup **port**。
1. 檔案瀏覽器功能表隨即開啟。選擇您要下載檔案的位置。
------
#### [ CLI ]
**使用 CLI 產生支援檔**
+ 開啟終端機並執行下列命令：`filetransfer support-file`
1. 這將在 `C:\Users\username\.filetransfer\support-files\support-file-20230310-110834.zip` (Windows) 或 `/Users/username/.tiletransfer/support-files/supportfile-20230227-185212.zip` (Linux&macOS) 中生成一個 zip 文件。
1. CLI 將輸出生成的文件的路徑。
------
## 疑難排解 GUI
使用命令列介面 (CLI) 疑難排解區段可解決 GUI 的許多錯誤。如果您在 GUI 中收到錯誤，請嘗試以下步驟：
1. 重新啟動 File Transfer。
1. 在視窗上macOS或在視窗`cmd.exe`上開啟終端機。
1. 執行下列命令以啟動作用中的工作階段：`filetransfer daemon`
1. 像平常一樣開始上傳。在應用程式中收到錯誤後，請檢查 CLI 視窗。錯誤應該顯示在那裡。
您可以在本[疑難排解 CLI](#troubleshooting-cli)節中對此錯誤進行疑難排解。
### File Transfer從 v1.x 升級到 v2.0 後無法連接
**問題****：您從 File Transfer v1.x 升級到 2.0 版，且 File Transfer GUI 不會進入「已連線」狀態。**
**解決方案**：從**本機**檔案系統下拉式功能表中刪除本機**精靈**。我們已更新元件的命名，部分客戶可能會受到影響，視其先前的組態而定。
![\[alt text not found\]](http://docs.aws.amazon.com/zh_tw/nimble-studio/latest/filetransfer-guide/images/nsft-troubleshooting.png)
### File Transfer無法連線
**問題**：File TransferGUI 不會進入「**已連線**」狀態。
**解決方案**：更新 YAML 檔案。
1. 在偏好的文字編輯器中開啟組態檔案。
1. 組態檔案位於 `C:\Users\username\.filetransfer\configuration.yaml` (Windows) 或 `~/.filetransfer/configuration.yaml` (Linux&macOS) 中。
1. 確認檔案中是否`api_server.enabled`存在，並且已將其設定為`true`。
1. 如果設定為`false`，GUI 將無法與 File Transfer CLI 通訊，且所有 GUI 功能都將停用。
1. 如果`api_server.enabled`未在中定義`configuration.yaml`，則預設為`true`。
## 疑難排解 CLI
### 過期或無效的憑證
**問題**：如果您提供的認證File Transfer有問題，您將收到下列其中一個錯誤。
```
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*=*
```
**解決方案**：按照「AWS Command Line Interface使用者指南」中 AWS「[組態和身份證明檔案設定」頁面中的指示，重新整理設定檔](https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-files.html)的身份證明。
### 移轉設定檔無效
**錯誤:**: 「嚴重」移轉設定檔無效。有效的移轉設定檔：
**問題**：您使用的是尚未設定的遠端設定名稱。
**解決方案**：更新遠端設定。
1. 選擇下拉式選單 (![\[The menu icon.\]](http://docs.aws.amazon.com/zh_tw/nimble-studio/latest/filetransfer-guide/images/icon-three-horizontal.png))。然後選擇**設置**。
1. 如果 [有**效遠端設定] 區段下沒有列出任何遠端設**定，請依照中的指示新增遠端設定[步驟 2：設定 File Transfer](getting-started.md#getting-started-configure)。
1. 如果有遠端設定，請確定您沒有拼錯該遠端組態的名稱。
1. 如果您沒有拼錯任何內容，請檢查錯誤的 「有效遠程配置：」 部分，以查看是否列出了特定的遠程配置。
1. 如果您仍然看不到遠端設定，請確定您的 YAML 格式正確，而且您正在編輯正確的 YAML 檔案。YAML 檔案會繫結至登入的使用者。
**重要**
在視窗上，請勿執行 CMD.exe 或PowerShell以系統管理員身分執行。如果您這樣做，您的電腦會嘗試從不在本機使用者檔案中的設定檔讀取。
### /輸入
**錯誤**：致命 [202X-XX-XX XX：XX：XX] 無法復原的錯誤：可重試：可重試：可重試： RequestError
**問題 1**：您的計算機與互聯網斷開連接，並失去了與 S3 存儲桶的連接。
**解決方案 1**：在此情況下，請檢查是否有網路中斷或任何防火牆限制。
**問題 2**：存儲介質的驅動器正在存儲無法處理放置File Transfer在其上的負載。這會導致與媒體的連接中斷。這在網絡驅動器中很常見。
**解決方案 2**：降低使用中傳輸的上限和執行緒數目，然後再次嘗試上傳。`1`
------
#### [ GUI ]
**使用 GUI 降低最大作用中傳輸量和執行緒數 `1`**
1. 打開 File Transfer.
1. 轉到開**始菜單**並搜索**File Transfer**。
1. **Nimble Studio File Transfer**從清單中選取。
1. 選擇畫面右上角的下拉式選單，然後選擇 **[設定]**。
1. 在 **S3 設定**區段中，將**使用中傳輸上限**和**執行緒數目**變更為**1**。
1. 選擇 [**儲存**]，然後重試上傳。
------
#### [ CLI ]
**使用 CLI 降低使用中傳輸的上限和執行緒數目 `1`**
1. 使用電腦上的任何文字編輯軟體開啟組態檔案。
1. 視窗：瀏覽至電腦上的資`User/`料夾。開啟資`.filetransfer`料夾並使用文字編輯器開啟`filetransfer.yaml`檔案。
1. macOS：輸入**Cmd\$1Shift\$1G**。然後輸入**\$1/.filetransfer**。使用文字編輯器開啟 `filetransfer.yaml` 檔案。
1. Linux：使用任何文字編輯器開啟`filetransfer.yaml`檔案。檔案位於中`~/.filetransfer/configuration.yaml`。
1. `threads`將`max_active_transfers`和的值更新為`1`。
1. 儲存組態檔案。
------
慢慢提高最大活動傳輸和線程數的值，直到達不會壓倒驅動器的配置。
### 絕對路徑
**錯誤**：警告 [202X-XX-XX XX：XX：XX] 絕對路徑不受支持，忽略/我直徑/驅動器
**問題**：收到此警告意味著您使用的絕對路徑不受支持。絕對路徑包含磁碟機代號。因為Windows這是`C:\`。對於Linux和macOS，這是領先的:`/`.
**解決方案**：如果您位於根層級，請移除前導 `C:\` (Windows) 或 `/` (Linux&macOS)。如果沒有，請替換相對於當前工作目錄的路徑。
### 無法開啟連線
**錯誤**：無法開啟連線。
**問題 1**：另一個File Transfer應用程序正在運行。
**解決方案 1**：關閉任何其他正在運行的File Transfer應用 或者，您可以在配置文件中更改`api_server.enabled`為 false。
**問題 2**：File Transfer正在嘗試監聽您無法聽的端口。如果您的用戶沒有監聽端口的權限，或者您使用的是 1023 或更低的端口，則可能會發生這種情況。這些都被視為特權連接埠。這些連接埠需要您以系統管理員身分執行，才能監聽它們。
**解決方案 2**：確定執行中的任何人都File Transfer有監聽這些連接埠的權限。您也可以將連接埠變更為 1024 或更高。
**問題 3**：另一個程序正在使用相同的端口。
**解決方案 3**：停止使用相同連接埠的其他程式。