Referensi CLI Transfer Appliance

ta check

Memeriksa error pada peralatan.

Synopsis

Mendiagnosis dan membantu pelanggan memperbaiki masalah umum. Tujuan utama perintah ini adalah membantu mendeteksi kesalahan konfigurasi sedini mungkin.

Perintah ini memeriksa beberapa aspek peralatan, termasuk: - Hardware - Software - ABM - Encrypt - Keys - Usage - Network - SSH

ta check [flags]

Contoh

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

Opsi

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

ta config

Mengonfigurasi peralatan.

Synopsis

Mengonfigurasi atau mengonfigurasi ulang peralatan agar siap untuk transfer data. Konfigurasi yang diberikan akan dipertahankan dan diingat selama reboot berikutnya dan hingga perintah "finalize" dikeluarkan. Gunakan perintah "status" nanti untuk melihat konfigurasi saat ini. Selama konfigurasi, share NFS dibuat dan diekspor untuk pengambilan data. Pada saat yang sama, enkripsi data diaktifkan sehingga data yang disalin selalu aman dan berada di bawah kontrol Anda. Enkripsi dan pemasangan partisi data hanya akan dilakukan satu kali; Anda dapat menjalankan kembali perintah "config" untuk memperbarui setelan jaringan kapan saja.

ta config [flags]

Contoh

    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

Opsi

  -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

Menyalin kunci SSH ke peralatan.

ta copy_ssh_keys [flags]

Opsi

  -h, --help   help for copy_ssh_keys

ta diagnostics

Menampilkan informasi diagnostik peralatan.

Synopsis

Mengumpulkan informasi diagnostik yang berguna untuk pemecahan masalah jika terjadi masalah. Informasi ini mencakup salinan file konfigurasi sistem dan output dari beberapa alat diagnostik. Informasi ini tidak menyertakan data pengguna. Informasi dikumpulkan ke dalam file arsip terkompresi sehingga dapat dikirim ke Google untuk pemecahan masalah.

ta diagnostics [flags]

Contoh

    ta diagnostics
    ta diagnostics --bmc

Opsi

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

ta disable_nfsv3

Menonaktifkan NFSv3 di peralatan.

Synopsis

Perintah ini menonaktifkan penggunaan klien NFSv3 untuk mentransfer data ke Transfer Appliance.

ta disable_nfsv3 [flags]

Opsi

  -h, --help   help for disable_nfsv3

ta disable_online_operations

Menonaktifkan operasi online di peralatan.

ta disable_online_operations [flags]

Opsi

  -h, --help   help for disable_online_operations

ta enable_nfsv3

Mengaktifkan penggunaan klien NFSv3 untuk mentransfer data ke Transfer Appliance.

Synopsis

Perintah ini mengaktifkan penggunaan klien NFSv3 untuk mentransfer data ke Transfer Appliance.

Mengaktifkan NFSv3 akan menimbulkan batasan terkait encoding nama file. GCS (Google Cloud Storage) mengharuskan nama file dienkode UTF-8. Meskipun NFSv4 otomatis mengonversi nama file ke UTF-8 selama transfer, NFSv3 tidak.

Oleh karena itu, jika menggunakan NFSv3: * File dengan nama file yang tidak dienkode UTF-8 mungkin gagal diupload ke GCS. * Jika upload gagal, mengidentifikasi file yang gagal dapat menjadi sulit karena potensi masalah encoding nama file.

Rekomendasi: Sebelum menggunakan NFSv3, pastikan semua nama file dienkode UTF-8. Jika file tidak dienkode UTF-8, sebaiknya gunakan SCP atau SFTP untuk transfer.

Klien Windows: Opsi CLI ini tidak boleh digunakan dengan klien Windows NFSv3, karena klien Windows menggunakan encoding yang berbeda. Untuk klien Windows, SCP atau SFTP adalah metode transfer yang direkomendasikan. Opsi ini hanya dapat digunakan jika klien Windows menjamin bahwa semua nama filenya dalam ASCII, tetapi mereka harus mengetahui bahwa file dengan nama file non-ASCII akan gagal diupload ke GCS.

ta enable_nfsv3 [flags]

Opsi

  -h, --help   help for enable_nfsv3

ta finalize

Memfinalisasi peralatan.

Synopsis

Pastikan perangkat aman dan siap dikirim. Secara khusus, tindakan ini akan menghapus semua kunci enkripsi dan konfigurasi yang dipertahankan. Tindakan ini juga akan menghapus konten apa pun yang disimpan di penyimpanan lokal peralatan. Buat cadangan file penting atau pindahkan ke direktori ta_data. Transfer data tidak akan lagi dapat dilakukan setelah mengeluarkan perintah ini. Tindakan ini akan menghapus konfigurasi netplan, dan perubahan akan diterapkan hanya setelah reboot. Akibatnya, peralatan akan terputus dari jaringan setelah reboot. Peralatan tidak boleh dikirim tanpa menjalankan perintah ini terlebih dahulu. Kode sandi akan dibuat yang harus diberikan untuk mendapatkan label pengiriman pengembalian barang; jika perlu, menjalankan 'ta status' akan melaporkan kode sandi.

ta finalize [flags]

Contoh

    ta finalize

Opsi

  -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

Menjalankan fsck di peralatan.

Synopsis

Perintah fsck memeriksa konsistensi sistem file peralatan. Menjalankan perintah ini tidak akan membuat perubahan apa pun pada peralatan. Perintah ini memastikan bahwa error sistem file terdeteksi sebelum mengembalikan peralatan. Melakukan proses debug error sistem file selama transfer data ke Google Cloud dapat menjadi sulit atau tidak mungkin. Hal ini dapat menyebabkan penundaan atau kegagalan dalam upload data. Perintah ini mungkin memerlukan waktu lebih dari 5 jam untuk diselesaikan. Sistem mungkin perlu di-reboot setelah menjalankan perintah ini.

ta fsck [flags]

Contoh

    ta fsck
    ta fsck -f
    ta fsck --fix

Opsi

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

ta mount

Menjalankan mount di peralatan.

Synopsis

Mount menangani pemasangan di peralatan. Mount membungkus perintah mount Linux.

ta mount [flags]

Contoh

    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

Opsi

      --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

Menonaktifkan operasi online di peralatan.

Synopsis

Menonaktifkan mode transfer online peralatan. Data dari direktori online yang ditentukan TIDAK akan dipindahkan dari lokal ke Cloud meskipun ada konektivitas jaringan.

ta offline [flags]

Contoh

    ta offline

Opsi

  -h, --help   help for offline

ta online

Mengaktifkan mode transfer online peralatan.

Synopsis

Mengaktifkan mode transfer online peralatan. Data dari direktori online yang ditentukan akan dipindahkan dari lokal ke GCS jika ada konektivitas jaringan. File individual akan otomatis dihapus setelah berhasil diupload ke GCS, sedangkan hierarki direktori akan dipertahankan. (Kredensial akun layanan yang diperlukan diharapkan ada di bagian /tmp/key.json)

ta online [flags]

Contoh

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

Opsi

      --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 os

Antarmuka untuk berinteraksi dengan OS.

Synopsis

Menyediakan antarmuka untuk berinteraksi dengan OS. Perintah ini memungkinkan Anda mengupdate OS, melakukan rollback OS, atau menampilkan versi OS.

ta os [flags]

Contoh

    ta os update
    ta os rollback
    ta os version

Opsi

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

ta performance

Pengujian benchmark penyimpanan yang menyimpan output di ta_metadata.

Synopsis

Menghasilkan csv metrik benchmark performa penyimpanan fio di ta_metadata: - Timestamp - Nomor seri peralatan - ID sesi saat ini - Model peralatan - Versi Zimbru OS - Lokasi peralatan - Bandwidth baca benchmark - Latensi penyelesaian baca benchmark - Bandwidth tulis benchmark - Latensi penyelesaian tulis benchmark - Parameter benchmark

ta performance [flags]

Contoh

    ta performance
    ta performance --upload

Opsi

      --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. Mutually exclusive with --token-file.
      --token-file string              Path to file containing token to authenticate with google cloud. Mutually exclusive with --token.
      --upload                         Upload performance results to cloud monitoring.

ta pull

Menarik dan mengarsipkan data yang dipasang di peralatan.

Synopsis

Pull akan mengambil lokasi direktori dan memproses serta mengarsipkan semua file yang ada di sana, lalu menyimpannya ke tujuan yang ditentukan. Perintah ini akan membuat file manifes yang menjelaskan file yang disimpan ke dalam arsip. File error akan disimpan ke tujuan, yang akan menyertakan error yang terjadi saat memproses direktori target.

ta pull [flags]

Contoh

    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

Opsi

  -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

Mereset peralatan.

Synopsis

Mereset peralatan ke status aslinya.
Artinya, data apa pun yang telah disalin ke partisi data akan hilang. Setelah direset, peralatan harus dikonfigurasi ulang, yang akan memformat partisi data dan membuat peralatan siap untuk transfer data. NFS/SMB akan dinonaktifkan. Konfigurasi jaringan akan direset, tetapi perubahan akan diterapkan hanya setelah reboot.

ta reset [flags]

Contoh

    ta reset

Opsi

  -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

Memulai ulang server NFS di peralatan.

ta restart_nfs [flags]

Opsi

  -h, --help   help for restart_nfs

ta status

Menampilkan informasi status dan kesehatan peralatan.

Synopsis

Menampilkan informasi status dan kesehatan peralatan: - status peralatan: tidak dikonfigurasi, siap untuk transfer, difinalisasi. - konfigurasi peralatan saat ini (per perintah "config" terakhir) - informasi pulsa (misalnya, penyimpanan yang digunakan & tersedia, jumlah file yang disalin, kecepatan transfer) - pemeriksaan kesehatan (misalnya, disk yang tidak tersedia, status tidak valid, konfigurasi tidak valid)

ta status [flags]

Contoh

    ta status
    ta status --verbose

Opsi

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

ta telemetry_archive

Perintah untuk mengarsipkan log telemetri.

ta telemetry_archive [flags]

Opsi

  -h, --help   help for telemetry_archive

ta timesync

Mengelola sinkronisasi waktu

Opsi

  -h, --help   help for timesync

ta unmount

Menjalankan unmount di peralatan.

Synopsis

Unmount menangani pemasangan pelanggan yang tidak dipasang di peralatan dan menghapus entri dari {{.CustomerFstab}}.

ta unmount [flags]

Contoh

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

Opsi

      --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

Membuka DEK dan memasang partisi data peralatan.

Synopsis

Membuka DEK dan memasang partisi data peralatan. Perintah ini diperlukan setelah reboot untuk membuka kunci enkripsi data dan memasang kembali partisi data. Perintah ini harus dijalankan sebelum melanjutkan transfer data.

ta unseal [flags]

Contoh

    ta unseal

Opsi

  -h, --help   help for unseal

ta update

Perintah untuk mengupdate biner ta di peralatan.

Synopsis

Mengupdate program biner ta di peralatan.

ta update [flags]

Contoh

    ta update

Opsi

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

ta version

Menampilkan versi peralatan.

ta version [flags]

Opsi

  -h, --help   help for version

ta wipe

Menghapus total partisi data peralatan.

Synopsis

Wipe menghapus total semua drive data di peralatan dengan cara yang sesuai dengan NIST. Sertifikat yang menjelaskan drive yang dihapus total dan alat yang digunakan untuk menghapus total drive akan dibuat. Wipe adalah perintah yang tidak dapat dibatalkan, yang berarti tidak ada cara untuk memulihkan data setelah drive dihapus total.

ta wipe [flags]

Contoh

    ta wipe

Opsi

  -h, --help   help for wipe