View a markdown version of this page

Nimble Studio File Transfer のトラブルシューティング - Nimble Studio File Transfer
サポートファイルの生成GUI のトラブルシューティングCLI のトラブルシューティング

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

Nimble Studio File Transfer のトラブルシューティング

Nimble Studio File Transfer の使用中に問題が発生した場合は、次の情報を使用して、問題のトラブルシューティングを行います。

ログ記録 の指示に従ってログ記録をオンにすることをお勧めします。

サポートファイルの生成

トラブルシューティングに役立つサポートファイルを生成できます。サポートファイルは ZIP ファイルで、サポートエンジニアに提供できます。

GUI
グラフィカルユーザーインターフェイス (GUI) を使用してサポートファイルを生成するには

  1. File Transfer を開きます。

    1. スタートメニューに進み、File Transfer を検索します。

    2. リストから Nimble Studio File Transfer を選択します。

  2. 画面の右上にあるドロップダウンメニューを選択し、[サポート] を選択します。

  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 のトラブルシューティング

GUI の多くのエラーは、コマンドラインインターフェイス (CLI) のトラブルシューティングセクションで解決できます。GUI 内でエラーが表示される場合は、次の手順を試します。

  1. File Transfer を再起動します。

  2. macOS でターミナル、または Windows で cmd.exe を開きます。

  3. 次のコマンドを実行して、アクティブなセッションを開始します: filetransfer daemon

  4. 通常どおりにアップロードを開始します。アプリケーションでエラーを受け取ったら、CLI ウィンドウを確認します。ウィンドウにエラーが表示されるはずです。

「CLI のトラブルシューティング」セクションの手順を使用して、このエラーのトラブルシューティングを行えます。

v1.x から v2.0 にアップグレードした後で File Transfer が接続できなくなる

問題: File Transfer v1.x から v2.0 にアップグレードした後で、File Transfer GUI が [接続済み] ステータスになりません。

解決策: [ローカルファイルシステム] ドロップダウンメニューから [ローカルデーモン] を削除します。コンポーネントの名前を更新しました。以前の設定によっては、一部のお客様が影響を受ける可能性があります。

File Transfer が接続できない

問題: File Transfer GUI が [接続済み] ステータスにならない。

解決策: 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 プロファイルの認証情報を更新します。

無効な転送プロファイル

エラー: : FATAL [202X-XX-XX XX:XX:XX] Invalid transfer profile. Valid transfer profiles:

問題: まだ設定されていないリモート設定名を使用しています。

解決策: リモート設定を更新します。

  1. ドロップダウンメニュー ( The menu icon. ) を選択します。次に [設定] を選択します。

  2. [有効なリモート設定] セクションにリモート設定が表示されていない場合は、「ステップ 2: File Transfer の設定」の手順に従ってリモート設定を追加してください。

  3. リモート設定がある場合は、リモート設定名のスペルを間違えていないことを確認します。

  4. スペルを間違えていない場合は、エラーの「有効なリモート設定: 」部分をチェックして、特定のリモート設定が表示されているかどうかを確認します。

  5. それでもリモート設定が表示されない場合は、YAML が正しくフォーマットされていること、および正しい YAML ファイルを編集していることを確認します。YAML ファイルはサインインしたユーザーに関連付けられています。

    重要

    Windows では、管理者として CMD.exe または PowerShell を実行しないでください。実行すると、コンピュータはローカルユーザーファイルに含まれていない設定ファイルからの読み取りを試みます。

TCP I/O

エラー: FATAL [202X-XX-XX XX:XX:XX] Unrecoverable error: retryable: retryable: 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. In the [S3 設定] セクションで、[最大アクティブ転送数] と [スレッド数] を 1 に変更します。

  4. [保存] を選択し、アップロードをやり直します。

CLI
CLI を使用して最大アクティブ転送数とスレッド数を 1 に減らすには

  1. コンピュータ上の任意のテキスト編集ソフトウェアで設定ファイルを開きます。

    1. Windows: コンピュータ上の User/<your username> フォルダに移動します。.filetransfer フォルダを開き、テキストエディタで filetransfer.yaml ファイルを開きます。

    2. macOS: Cmd+Shift+G と入力します。次に、~/.filetransfer と入力します。テキストエディタで filetransfer.yaml ファイルを開きます。

    3. Linux: 任意のテキストエディタを使用して filetransfer.yaml ファイルを開きます。このファイルは ~/.filetransfer/configuration.yaml にあります。

  2. max_active_transfers と threads の値を 1 に更新します。

  3. 設定ファイルを保存します。

ドライブに過度な負荷がかからない設定になるまで、最大アクティブ転送数とスレッド数の値を徐々に増やします。

絶対パス

エラー: WARN [202X-XX-XX XX:XX:XX] Absolute paths are not supported, ignoring /me dia/drive

問題: この警告が表示されるということは、サポートされていない絶対パスを使用していることを意味します。絶対パスにはドライブ文字が含まれます。Windows の場合、これは C:\ です。Linux と macOS の場合、これは先頭の : / です。

解決策: ルートレベルの場合は、先頭の C:\ (Windows) または / (Linux と macOS) を削除します。そうでない場合は、現在の作業ディレクトリの相対パスに置き換えます。

接続を開けない

エラー: Unable to open connection.

問題 1: 別の File Transfer アプリケーションが実行中です。

解決策 1: 実行中の他の File Transfer アプリケーションをすべて閉じます。または、設定ファイルの api_server.enabled を false に変更することもできます。

問題 2: File Transfer がリッスンできないポートでリッスンしようとしている。この問題は、ユーザーにそのポートをリッスンするアクセス許可がない場合や、1023 以下のポートを使用している場合に発生することがあります。これらは特権付きのポートとみなされます。これらのポートをリッスンするには、管理者として実行する必要があります。

解決策 2: File Transfer を実行中のユーザーがこれらのポートをリッスンするアクセス許可を持っていることを確認します。ポートを 1024 以上に変更することもできます。

問題 3: 別のプログラムが同じポートを使っている。

解決策 3: 同じポートを使用している他のプログラムを停止します。