Transfer Appliance CLI リファレンス

ta check

アプライアンスのエラーを確認します。

概要

一般的な問題を診断し、お客様が問題を解決できるようサポートします。このコマンドの主な目的は、構成ミスをできるだけ早く検出することです。

このコマンドは、アプライアンスの複数の側面(ハードウェア、ソフトウェア、ABM、暗号化、鍵、使用状況、ネットワーク、SSH など)を確認します。

ta check [flags]

    ta check
    ta check usage
    ta check hardware
    ta check {category}

オプション

  -e, --env string   Environment to run the check in. (default "prod")
  -h, --help         help for check

ta config

アプライアンスを構成します。

概要

アプライアンスを構成または再構成して、データ転送の準備をします。指定された構成は、後続の再起動後も保持され、「finalize」コマンドが発行されるまで記憶されます。後で「status」コマンドを使用して、現在の構成を確認します。構成時に、NFS 共有が作成され、データ キャプチャ用にエクスポートされます。同時に、データ暗号化が有効になるため、コピーされたデータは常に安全で、ユーザーの管理下に置かれます。データ パーティションの暗号化とマウントは 1 回のみ行われます。ネットワーク設定を更新するには、いつでも「config」コマンドを再実行できます。

ta config [flags]

    ta config --data_port=RJ45 --ip=192.168.0.100/24 --gw=192.168.0.1
    ta config --data_port=RJ45 --ip=dhcp
    ta config --data_port=RJ45 --ip=dhcp --authorized_hosts=192.168.0.101
    ta config --data_port=RJ45 --ip=dhcp --authorized_hosts=192.168.0.101,192.168.0.0/28
    ta config --data_port=RJ45 --ip=192.168.0.100/24 --gw=192.168.0.1 --network_only --dns_servers=8.8.8.8
    ta config --data_port=QSFP --ip=192.168.0.100/24 --gw=192.168.0.1
    ta config --data_port=QSFP --ip=dhcp
    ta config --data_port=RJ45 --ip=dhcp --data_size=200T
    ta config --data_port=QSFP --ip=dhcp --network_only
    ta config --data_port=RJ45 --ip=dhcp --proxy_addr=http://10.10.10.10:3128
    ta config --data_port=RJ45 --ip=dhcp --proxy_addr=http://10.10.10.10:3128 --network_only
    ta config --data_port=RJ45 --ip=192.168.0.100/24 --gw=192.168.0.1 --proxy_addr=http://10.10.10.10:3128 --network_only

オプション

  -a, --authorized_hosts strings   Comma-separated list of hosts that are allowed to connect to the NFS share. (default [*])
      --data_port string           Type of data port: 'RJ45', 'SFP', or 'QSFP'
      --data_size string           Resizes the data disk partition to the provided size. Does not change the existing data disk if left empty.
      --dns_servers strings        Comma-separated list of DNS name server addresses.
      --env string                 Environment to run the appliance configuration in. (default "prod")
      --fileshare string           File share protocol to configure: 'smb' or 'nfs' (default "nfs")
      --gw string                  IPv4 address of the default gateway. Must be provided for static IP configuration. Example: 192.168.6.1
  -h, --help                       help for config
      --ip string                  IPv4 & netmask address (for static setting), or 'dhcp' (for dynamic). Example: 192.168.6.11/24
      --json                       If true, command output is in JSON format.
      --network_interface string   Network interface to configure.
      --network_only               Configure the appliance network without changing the disk or fileshare configuration.
      --proxy_addr string          Proxy server address to configure. Must be in format http://<IP_ADDR>:<Port>. Example: http://10.10.10.10:3128
      --remove                     Removes the network configuration associated with the network interface provided.
      --restart_bind_mounts        Restart the bind mounts for ta_data and ta_local.

ta copy_ssh_keys

SSH 認証鍵をアプライアンスにコピーします。

ta copy_ssh_keys [flags]

オプション

  -h, --help   help for copy_ssh_keys

ta 診断

アプライアンスの診断情報が表示されます。

概要

問題が発生した場合のトラブルシューティングに役立つ診断情報を収集します。これには、システム構成ファイルのコピーと一部の診断ツールの出力が含まれます。ユーザーデータは一切送信されません。情報は圧縮アーカイブ ファイルに収集され、トラブルシューティングのために Google に送信されます。

ta diagnostics [flags]

    ta diagnostics
    ta diagnostics --bmc

オプション

  -B, --bmc    Include BMC FFDC logs in diagnostics logs
  -h, --help   help for diagnostics

ta disable_nfsv3

アプライアンスで NFSv3 を無効にします。

概要

このコマンドは、NFSv3 クライアントを使用してデータを Transfer Appliance に転送することを無効にします。

ta disable_nfsv3 [flags]

オプション

  -h, --help   help for disable_nfsv3

ta disable_online_operations

アプライアンスでのオンライン オペレーションを無効にします。

ta disable_online_operations [flags]

オプション

  -h, --help   help for disable_online_operations

ta enable_nfsv3

NFSv3 クライアントを使用してデータを Transfer Appliance に転送できるようにします。

概要

このコマンドにより、NFSv3 クライアントを使用して Transfer Appliance にデータを転送できるようになります。

NFSv3 を有効にすると、ファイル名のエンコードに関する制限が生じます。GCS(Google Cloud Storage)では、ファイル名を UTF-8 でエンコードする必要があります。NFSv4 では転送中にファイル名が UTF-8 に自動的に変換されますが、NFSv3 では変換されません。

そのため、NFSv3 を使用している場合: * UTF-8 以外のエンコードのファイル名を持つファイルは、GCS にアップロードできないことがあります。* アップロードが失敗した場合、ファイル名のエンコードの問題が原因で、失敗したファイルを特定することが難しいことがあります。

推奨事項: NFSv3 を使用する前に、すべてのファイル名が UTF-8 でエンコードされていることを確認してください。ファイルが UTF-8 でエンコードされていない場合は、代わりに SCP または SFTP を使用して転送することを検討してください。

Windows クライアント: Windows クライアントは異なるエンコードを使用するため、これらの CLI オプションは Windows NFSv3 クライアントでは使用しないでください。Windows クライアントの場合、SCP または SFTP を転送方法として使用することをおすすめします。これらのオプションは、Windows クライアントがすべてのファイル名が ASCII であることを保証する場合にのみ使用できます。ただし、ASCII 以外のファイル名を持つファイルは GCS にアップロードできないことを認識しておく必要があります。

ta enable_nfsv3 [flags]

オプション

  -h, --help   help for enable_nfsv3

ta finalize

アプライアンスをファイナライズします。

概要

デバイスが安全で、発送の準備ができていることを確認します。特に、すべての暗号鍵と永続構成が削除されます。アプライアンスのローカル ストレージに保存されているコンテンツも削除されます。重要なファイルのバックアップを作成するか、ta_data ディレクトリに移動してください。このコマンドを発行すると、データ転送はできなくなります。これにより、netplan 構成が削除され、変更は再起動時にのみ有効になります。そのため、アプライアンスは再起動後にネットワークから切断されます。このコマンドを実行せずにアプライアンスを発送しないでください。返送ラベルを取得するために必要なパスコードが生成されます。必要に応じて、'ta status' を実行するとパスコードが報告されます。

ta finalize [flags]

    ta finalize

オプション

  -h, --help                     help for finalize
      --non_repudiation          Verify the authenticity of arriving data. (default true)
      --skip_reencrypt_bmcpass   Skip reencrypting BMC passphrase.
      --skip_shred_mount_fstab   Skip shredding of opt/customer fstab file.
      --tpm_clear                Clear the TPM. (default true)

ta fsck

アプライアンスで fsck を実行します。

概要

fsck コマンドは、アプライアンスのファイル システムの整合性をチェックします。このコマンドを実行しても、アプライアンスは変更されません。これにより、アプライアンスを返却する前にファイル システム エラーが検出されます。Google Cloud へのデータ転送中にファイルシステム エラーをデバッグすることは、困難または不可能になる可能性があります。これにより、データのアップロードが遅延したり失敗したりする可能性があります。このコマンドが完了するまでに 5 時間以上かかることがあります。このコマンドを実行した後は、システムの再起動が必要になることがあります。

ta fsck [flags]

    ta fsck
    ta fsck -f
    ta fsck --fix

オプション

  -f, --fix    Repair filesystem errors if found.
  -h, --help   help for fsck

ta ロギング

ロギングを有効/無効にするコマンド。

概要

ロギング エージェントを操作するためのインターフェースを提供します。

ta logging [flags]

    ta logging start
    ta logging stop

オプション

  -h, --help   help for logging

ta 指標

指標を有効/無効にするコマンド。

概要

モニタリング ワークフローを操作するためのインターフェースを提供します。

ta metrics [flags]

    ta metrics start
    ta metrics stop

オプション

      --env string   Environment to run the metrics in. (default "prod")
  -h, --help         help for metrics

ta mount

アプライアンスで mount を実行します。

概要

マウントは、アプライアンスでのマウントを処理します。これは Linux の mount コマンドをラップします。

ta mount [flags]

    ta mount --version
    ta mount --list
    ta mount --all
    ta mount --types=nfs --source=nfs_server_ip:/nfs_share_directory --target=/mnt/ta_data_base/ta_mounts/mount_point
    ta mount --types=nfs --source=nfs_server_ip:/nfs_share_directory --target=/mnt/ta_data_base/ta_mounts/mount_point --options=rw,suid,dev,exec,auto,nouser,async
    ta mount --types=cifs --options=username=user1,password=password --source=//cifs_share_ip/share_name --target=/mnt/ta_data_base/ta_mounts/mount_point

オプション

      --all              Mount all customer mounts.
  -h, --help             help for mount
      --list             List of customer mounts.
      --options string   Mount options given in a comma separated string, defaults is set as default. (default "defaults")
      --source string    Device being mounted.
      --target string    Mountpoint of the mount, expected to be under /mnt/ta_data_base/ta_mounts/.
      --types string     Filesystem type of the device to be mounted.
      --version          Version of the mount command.

ta offline

アプライアンスでのオンライン オペレーションを無効にします。

概要

アプライアンスのオンライン転送モードを無効にします。ネットワーク接続が存在する場合でも、指定されたオンライン ディレクトリのデータはオンプレミスから Cloud に移動されません。

ta offline [flags]

    ta offline

オプション

  -h, --help   help for offline

ta online

アプライアンスのオンライン転送モードを有効にします。

概要

アプライアンスのオンライン転送モードを有効にします。指定されたオンライン ディレクトリのデータは、ネットワーク接続が存在する場合にオンプレミスから GCS に移動されます。(必要なサービス アカウントの認証情報は /tmp/key.json に存在する必要があります)。

ta online [flags]

    ta online
    ta online --bucket=my-bucket --object_prefix=my-object_prefix
    ta online --bucket=my-bucket
    ta online --object_prefix=my-object_prefix

オプション

      --agent_pool             Use agent pool in online transfer. (default true)
      --bucket string          Update destination bucket used in online transfer. If in online state, this will stop the running job and start a new transfer job. NOTE: This cannot be an empty string.
      --env string             Environment to run the online transfer in. (default "prod")
  -h, --help                   help for online
      --object_prefix string   Update bucket object prefix used for online transfer. If in online state, this will stop the running job and start a new transfer job.
      --skip_api_check         Bypass the required APIs check on the customer project.
      --skip_net_check         Bypass the network connectivity check that attempts to ping google.
      --skip_role_check        Bypass the HTA IAM Role check on the session service account.

ta online_reset

アプライアンスのオンライン転送モードをリセットします。

概要

Online reset puts the appliance in offline mode, deletes the folder /mnt/ta_metadata/state.
ta online_reset [flags]

オプション

  -h, --help   help for online_reset

ta os

OS とやり取りするためのインターフェース。

概要

OS とやり取りするためのインターフェースを提供します。このコマンドを使用すると、OS の更新、OS のロールバック、OS バージョンの表示を行うことができます。

ta os [flags]

    ta os update
    ta os rollback
    ta os version

オプション

  -h, --help              help for os
  -r, --rollback string   Rollback the updated OS.

ta パフォーマンス

出力を ta_metadata に保存するストレージ ベンチマーク テスト。

概要

ta_metadata に fio ストレージ パフォーマンス ベンチマーク指標の CSV を出力します。 - タイムスタンプ - アプライアンスのシリアル番号 - 現在のセッション ID - アプライアンスのモデル - Zimbru OS のバージョン - アプライアンスの場所 - ベンチマークの読み取り帯域幅 - ベンチマークの読み取り完了レイテンシ - ベンチマークの書き込み帯域幅 - ベンチマークの書き込み完了レイテンシ - ベンチマーク パラメータ

ta performance [flags]

    ta performance
    ta performance --upload

オプション

      --enable_standard_benchmarking   This temporary flag will be used to gradually rollout the new performance benchmark flow.
      --env string                     Environment for token to upload to cloud monitoring. (default "prod")
  -h, --help                           help for performance
      --token string                   Token to authenticate with google cloud.
      --upload                         Upload performance results to cloud monitoring.

ta pull

アプライアンスにマウントされたデータを取得してアーカイブします。

概要

pull はディレクトリの場所を受け取り、そこにあるすべてのファイルを処理してアーカイブし、指定された宛先に保存します。このコマンドは、どのファイルがどのアーカイブに保存されたかを記述するマニフェスト ファイルを生成します。エラーファイルが宛先に保存されます。このファイルには、ターゲット ディレクトリの処理中に発生したエラーが含まれます。

ta pull [flags]

    ta pull --target=/mnt/ta_data_base/ta_mounts/test --size="1GB" --max_archive_file_size="200 MB" --destination=/mnt/ta_data/destination
    ta pull --target=/mnt/ta_data_base/ta_mounts/test --size="1GB" --max_archive_file_size="200 MB" --destination=/mnt/ta_data/destination --count=22
    ta pull --target=/mnt/ta_data_base/ta_mounts/test
    ta pull --target=/mnt/ta_data_base/ta_mounts/test --no_archive
    ta pull --id=55555 --status
    ta pull -i=55555 --pause
    ta pull --id=55555 -r
    ta pull --cleanup

オプション

  -C, --cleanup                        Cleanup the pull job.
  -c, --count int                      The number of tarballs to pull at once. (default 1)
  -d, --destination string             The destination directory where the files will be pulled. (default "/mnt/ta_data/")
  -h, --help                           help for pull
  -i, --id string                      The ID of the pull.
  -m, --max_archive_file_size string   The maximum size of the what is considered archivale file.
  -n, --no_archive                     Skips archiving all pulled files.
  -p, --pause                          Pause the pull job.
  -r, --resume                         Resume the pull job.
  -S, --size string                    The target tarball size. (default "1GB")
  -X, --status                         Get the status of the pull job.
  -t, --target string                  The target directory containing the files to be pulled and archived, expected to be under /mnt/ta_data_base/ta_mounts/.
  -T, --test                           Test the pull job.

ta reset

アプライアンスをリセットします。

概要

アプライアンスを元の状態にリセットします。
つまり、データ パーティションにすでにコピーされているデータは失われます。リセット後、アプライアンスを再構成する必要があります。これにより、データ パーティションがフォーマットされ、アプライアンスがデータ転送の準備を整えます。NFS/SMB が無効になります。ネットワーク構成はリセットされますが、変更は再起動後にのみ有効になります。

ta reset [flags]

    ta reset

オプション

  -h, --help                     help for reset
      --preserve_key             Preserve HTA key.json on reset.
      --preserve_state           Preserve HTA state on reset.
      --skip_reencrypt_bmcpass   Skip reencrypting BMC passphrase.
      --skip_shred_mount_fstab   Skip shredding of opt/customer fstab file.

ta restart_nfs

アプライアンスで NFS サーバーを再起動します。

ta restart_nfs [flags]

オプション

  -h, --help   help for restart_nfs

ta ステータス

アプライアンスのステータスと健全性に関する情報が表示されます。

概要

アプライアンスのステータスと健全性情報を表示します。 - アプライアンスの状態: 未構成、転送準備完了、ファイナライズ済み。- アプライアンスの現在の構成(最後の「config」コマンドごと) - パルス情報(使用済みと使用可能なストレージ、コピーされたファイル数、転送速度など) - ヘルスチェック(使用できないディスク、無効な状態、無効な構成など)

ta status [flags]

    ta status
    ta status --verbose

オプション

  -h, --help      help for status
  -v, --verbose   If true, displays verbose status information.

ta telemetry_archive

テレメトリー ログをアーカイブするコマンド。

ta telemetry_archive [flags]

オプション

  -h, --help   help for telemetry_archive

ta timesync

時刻同期を管理する

オプション

  -h, --help   help for timesync

マウントを解除する

アプライアンスでアンマウントを実行します。

概要

Unmount は、アプライアンスでお客様のマウントをマウント解除し、 {{.CustomerFstab}}からエントリを削除します。

ta unmount [flags]

    ta unmount --version
    ta unmount --all
    ta unmount --target=/mnt/ta_data_base/ta_mounts/test

オプション

      --all             Unmount all filesystems.
  -h, --help            help for unmount
      --target string   The target directory to unmount.
      --version         Print the version of the unmount command.

ta unseal

DEK の封印を解除し、アプライアンスのデータ パーティションをマウントします。

概要

DEK を封印解除し、アプライアンスのデータ パーティションをマウントします。このコマンドは、再起動後にデータ暗号鍵を封印解除してデータ パーティションを再マウントするために必要です。このコマンドは、データ転送を続行する前に実行する必要があります。

ta unseal [flags]

    ta unseal

オプション

  -h, --help   help for unseal

ta update

アプライアンスのソフトウェアを更新するコマンド。

概要

アプライアンスのソフトウェアを更新します。

ta update [flags]

    ta update
    ta update --containers
    ta update --binaries
    ta update --os
    ta update --containers --binaries
    ta update --binaries --os
    ta update --containers --os
    ta update --containers --binaries --os
    ta update --rollback_binaries

オプション

      --agent_pool          Use agent pool during update. (default true)
      --binaries            Update binaries on the appliance.
      --containers          Update containers on the appliance.
      --env string          Environment to conduct the update in. (default "prod")
  -h, --help                help for update
      --os                  Update OS on the appliance.
      --rollback_binaries   Perform binaries update rollback on the appliance.

ta バージョン

アプライアンスのバージョンが表示されます。

ta version [flags]

オプション

  -h, --help   help for version

ta wipe

アプライアンスのデータ パーティションをワイプします。

概要

ワイプは、NIST に準拠した方法でアプライアンス上のすべてのデータ ドライブをワイプします。ワイプされたドライブと、ドライブのワイプに使用されたツールを詳述する証明書が生成されます。ワイプは不可逆的なコマンドです。ドライブをワイプすると、データを復元することはできません。

ta wipe [flags]

    ta wipe

オプション

  -h, --help   help for wipe