オンライン転送を有効または無効にする

Transfer Appliance には、次の 2 つのモードがあります。

• オフライン転送: データはいっぱいになるまでアプライアンスにコピーされます。アプライアンスは Google に返送され、コピーしたデータは Cloud Storage バケットに移動します。

• オンライン転送: アプライアンスにコピーされたデータが Cloud Storage バケットにストリーミングされます。データが Cloud Storage バケットにアップロードされると、アプライアンスから削除されます。オンライン転送では、転送中のデータが圧縮、暗号化され、gsutil や他のコマンドライン ツールと比較してデータ転送が高速化されます。

オフライン モードとオンライン モードを切り替えることができます。

アプライアンス サービス アカウント キーをダウンロード

プロジェクト設定が完了したら、サービス アカウント キーを準備します。

1. アプライアンス サービス アカウントのサービス アカウント キーを作成します。これは 1 回限りのダウンロード キーです。

2. キーの名前を key.json に変更し、安全な場所に保存します。

3. アプライアンスが受領されたら、アプライアンスの /tmp ディレクトリに key.json をアップロードします。

オンライン モードに設定

オンライン転送モードを初めて有効にする前に、指示に従ってプロジェクトの設定を完了してください。

オンライン モードを有効にして使用するには、送信接続が必要です。オンライン転送モードを有効にする手順は次のとおりです。

1. アプライアンスから下記の HTTPS エンドポイントへの送信接続を確認します。

   • https://gcr.io

   • https://storage.googleapis.com

   • https://oauth2.googleapis.com

   • https://storagetransfer.googleapis.com

   • https://pubsub.googleapis.com

   各 HTTPS エンドポイントを使用して次のコマンドを実行します。

   ping URL
   

   コマンドが失敗した場合、DNS がアプライアンスで正しく構成されていないことを示している可能性があります。静的 IP アドレスを使用するようにアプライアンスが構成されている場合は、DHCP を使用するように更新します。

   ta config --data_port=PORT --ip=dhcp
   

   PORT は、アプライアンスで使用しているデータポート（RJ45 または QSFP）に置き換えます。

2. 次の手順で、アプライアンス サービス アカウント キーのダウンロードでダウンロードしたサービスキーをアプライアンスの tmp フォルダにコピーします。

   Windows

   1. SCP ツールを使用して、次の設定を使用してアプライアンスに接続します。

      • ファイル プロトコル: SFTP
      • Host name: アプライアンスの IP アドレス。
      • ポート番号: 22
      • ユーザー名: Transfer Appliance チームが提供するアプライアンス ユーザー名。
      • パスワード: Transfer Appliance チームが提供するアプライアンス パスワード。

   2. ファイルを /tmp フォルダにコピーします。

   Linux

   1. 次のコマンドを実行します。

      scp PATH_TO_KEY_FILE/key.json USERNAME@IP_ADDRESS:/tmp
      

      次のように置き換えます。

      • PATH_TO_KEY_FILE: コピーする鍵ファイルのパス。
      • USERNAME: Transfer Appliance チームが提供するアプライアンス ユーザー名。
      • IP_ADDRESS: アプライアンスの IP アドレス。

   2. プロンプトが表示されたら、Transfer Appliance チームから提供されたアプライアンス パスワードを入力します。

   Apple macOS

   1. 次のコマンドを実行します。

      scp PATH_TO_KEY_FILE/key.json USERNAME@IP_ADDRESS:/tmp
      

      次のように置き換えます。

      • PATH_TO_KEY_FILE: コピーする鍵ファイルのパス。
      • USERNAME: Transfer Appliance チームが提供するアプライアンス ユーザー名。
      • IP_ADDRESS: アプライアンスの IP アドレス。

   2. プロンプトが表示されたら、Transfer Appliance チームから提供されたアプライアンス パスワードを入力します。

3. アプライアンスをオンライン モードに設定するには、次のコマンドを実行します。

   ta online
   

   次のレスポンスのサンプルは、返される出力に似ています。

   
   Starting containers for online transfer...
   Copied new credentials.          ## Or, Using old credentials
   Running binary to enable online transfer.
   This may take several minutes to finish...
   
   Containers have been successfully started. You can transfer data in
   online mode.
   

4. 省略可: 転送先バケットとジョブ オブジェクトの接頭辞を変更します。

   ta online --bucket=BUCKET --object_prefix=OBJECT_PREFIX
   

   BUCKET は宛先バケットに置き換え、OBJECT_PREFIX は更新するオブジェクト接頭辞に置き換えます。

   コマンドが成功すると、オンライン転送を実行したステップからの出力に似た 2 つの引数が返されます。

   注: 転送先バケットとオブジェクトの接頭辞を個別に更新できます。新しい転送先バケットに更新する場合は、必要なサービス アカウントが新しいバケットに設定されていることを確認してください。また、2 つのフラグのうち少なくとも 1 つを指定してこのコマンドを呼び出すたびに、アプライアンスがオフラインかオンラインかにかかわらず、新しい転送オペレーションがトリガーされます。

オンライン モードのトラブルシューティングについては、オンライン モードのトラブルシューティングをご覧ください。

オフライン モードに設定

オフライン モードを指定するには、次のコマンドを実行します。

ta offline

次のレスポンスのサンプルは、返される出力に似ています。

Putting the appliance in offline mode...
Appliance is successfully put into the offline mode.