Nimble Studio File Transfer 疑難排解

如果您在使用時遇到問題Nimble Studio File Transfer，請使用下列資訊協助您疑難排解問題。

我們建議您依照中的指示開啟記錄日誌。

產生支援檔

您可以產生支援檔案來協助您進行疑難排解。支援檔案是您可以提供給支援工程師的 zip 檔案。

GUI

使用圖形化使用者介面 (GUI) 產生支援檔

1. 打開 File Transfer.

   1. 轉到開始菜單並搜索File Transfer。

   2. Nimble Studio File Transfer從清單中選取。

2. 選擇屏幕右上角的下拉菜單，然後選擇 Sup port。

3. 檔案瀏覽器功能表隨即開啟。選擇您要下載檔案的位置。

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 文件。

  2. CLI 將輸出生成的文件的路徑。

疑難排解 GUI

使用命令列介面 (CLI) 疑難排解區段可解決 GUI 的許多錯誤。如果您在 GUI 中收到錯誤，請嘗試以下步驟：

1. 重新啟動 File Transfer。

2. 在視窗上macOS或在視窗cmd.exe上開啟終端機。

3. 執行下列命令以啟動作用中的工作階段：filetransfer daemon

4. 像平常一樣開始上傳。在應用程式中收到錯誤後，請檢查 CLI 視窗。錯誤應該顯示在那裡。

您可以在本疑難排解 CLI節中對此錯誤進行疑難排解。

File Transfer從 v1.x 升級到 v2.0 後無法連接

問題：您從 File Transfer v1.x 升級到 2.0 版，且 File Transfer GUI 不會進入「已連線」狀態。

解決方案：從本機檔案系統下拉式功能表中刪除本機精靈。我們已更新元件的命名，部分客戶可能會受到影響，視其先前的組態而定。

File Transfer無法連線

問題：File TransferGUI 不會進入「已連線」狀態。

解決方案：更新 YAML 檔案。

1. 在偏好的文字編輯器中開啟組態檔案。

   1. 組態檔案位於 C:\Users\username\.filetransfer\configuration.yaml (Windows) 或 ~/.filetransfer/configuration.yaml (Linux&macOS) 中。

2. 確認檔案中是否api_server.enabled存在，並且已將其設定為true。

   1. 如果設定為false，GUI 將無法與 File Transfer CLI 通訊，且所有 GUI 功能都將停用。

   2. 如果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「組態和身份證明檔案設定」頁面中的指示，重新整理設定檔的身份證明。

移轉設定檔無效

錯誤:: 「嚴重」移轉設定檔無效。有效的移轉設定檔：

問題：您使用的是尚未設定的遠端設定名稱。

解決方案：更新遠端設定。

1. 選擇下拉式選單 ( )。然後選擇設置。

2. 如果 [有效遠端設定] 區段下沒有列出任何遠端設定，請依照中的指示新增遠端設定步驟 2：設定 File Transfer。

3. 如果有遠端設定，請確定您沒有拼錯該遠端組態的名稱。

4. 如果您沒有拼錯任何內容，請檢查錯誤的 「有效遠程配置：」 部分，以查看是否列出了特定的遠程配置。

5. 如果您仍然看不到遠端設定，請確定您的 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。

   2. Nimble Studio File Transfer從清單中選取。

2. 選擇畫面右上角的下拉式選單，然後選擇 [設定]。

3. 在 S3 設定區段中，將使用中傳輸上限和執行緒數目變更為1。

4. 選擇 [儲存]，然後重試上傳。

CLI

使用 CLI 降低使用中傳輸的上限和執行緒數目 1

1. 使用電腦上的任何文字編輯軟體開啟組態檔案。

   1. 視窗：瀏覽至電腦上的資User/<your username>料夾。開啟資.filetransfer料夾並使用文字編輯器開啟filetransfer.yaml檔案。

   2. macOS：輸入Cmd+Shift+G。然後輸入~/.filetransfer。使用文字編輯器開啟 filetransfer.yaml 檔案。

   3. Linux：使用任何文字編輯器開啟filetransfer.yaml檔案。檔案位於中~/.filetransfer/configuration.yaml。

2. threads將max_active_transfers和的值更新為1。

3. 儲存組態檔案。

慢慢提高最大活動傳輸和線程數的值，直到達不會壓倒驅動器的配置。

絕對路徑

錯誤：警告 [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：停止使用相同連接埠的其他程式。