Transfer Appliance-Befehlszeilenreferenz

ta check

Prüft das Gerät auf Fehler.

Zusammenfassung

Diagnostiziert häufige Probleme und hilft Kunden bei der Behebung. Das Hauptziel des Befehls ist es, Fehlkonfigurationen so früh wie möglich zu erkennen.

Mit diesem Befehl werden mehrere Aspekte der Appliance geprüft, darunter: – Hardware – Software – ABM – Verschlüsselung – Schlüssel – Nutzung – Netzwerk – SSH

ta check [flags]

Beispiele

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

Optionen

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

ta config

Konfiguriert die Appliance.

Zusammenfassung

Konfigurieren oder rekonfigurieren Sie die Appliance, um sie für die Datenübertragung vorzubereiten. Die bereitgestellte Konfiguration wird gespeichert und bei nachfolgenden Neustarts beibehalten, bis der Befehl „finalize“ ausgegeben wird. Verwenden Sie später den Befehl „status“, um die aktuelle Konfiguration aufzurufen. Bei der Konfiguration wird die NFS-Freigabe erstellt und für die Datenerfassung exportiert. Gleichzeitig wird die Datenverschlüsselung aktiviert, damit die kopierten Daten immer sicher sind und Sie die Kontrolle darüber behalten. Die Datenpartition wird nur einmal verschlüsselt und bereitgestellt. Sie können den Befehl „config“ jederzeit noch einmal ausführen, um die Netzwerkeinstellung zu aktualisieren.

ta config [flags]

Beispiele

    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

Optionen

  -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

Kopiert SSH-Schlüssel auf die Appliance.

ta copy_ssh_keys [flags]

Optionen

  -h, --help   help for copy_ssh_keys

ta diagnostics

Hier werden Diagnoseinformationen zum Gerät angezeigt.

Zusammenfassung

Erfasst Diagnoseinformationen, die bei der Fehlerbehebung hilfreich sind. Dazu gehören Kopien von Systemkonfigurationsdateien und die Ausgabe einiger Diagnosetools. Sie enthält keine Nutzerdaten. Die Informationen werden in einer komprimierten Archivdatei gesammelt, damit sie zur Fehlerbehebung an Google gesendet werden können.

ta diagnostics [flags]

Beispiele

    ta diagnostics
    ta diagnostics --bmc

Optionen

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

ta disable_nfsv3

Deaktiviert NFSv3 auf der Appliance.

Zusammenfassung

Mit diesem Befehl wird die Verwendung von NFSv3-Clients zum Übertragen von Daten auf die Transfer Appliance deaktiviert.

ta disable_nfsv3 [flags]

Optionen

  -h, --help   help for disable_nfsv3

ta disable_online_operations

Deaktiviert Onlinevorgänge auf dem Gerät.

ta disable_online_operations [flags]

Optionen

  -h, --help   help for disable_online_operations

ta enable_nfsv3

Aktivieren Sie die Verwendung von NFSv3-Clients, um Daten auf die Transfer Appliance zu übertragen.

Zusammenfassung

Mit diesem Befehl können NFSv3-Clients Daten auf die Transfer Appliance übertragen.

Wenn Sie NFSv3 aktivieren, gelten Einschränkungen hinsichtlich der Dateinamen-Codierung. Für GCS (Google Cloud Storage) müssen Dateinamen UTF-8-codiert sein. Während NFSv4 Dateinamen während der Übertragung automatisch in UTF-8 konvertiert, ist dies bei NFSv3 nicht der Fall.

Wenn Sie NFSv3 verwenden, gilt Folgendes: * Dateien mit Dateinamen, die nicht UTF-8-codiert sind, können möglicherweise nicht in GCS hochgeladen werden. * Wenn Uploads fehlschlagen, kann es aufgrund von Problemen mit der Dateinamencodierung schwierig sein, die fehlgeschlagenen Dateien zu identifizieren.

Empfehlung: Bevor Sie NFSv3 verwenden, sollten Sie dafür sorgen, dass alle Dateinamen UTF-8-codiert sind. Wenn Dateien nicht UTF-8-codiert sind, sollten Sie stattdessen SCP oder SFTP für die Übertragung verwenden.

Windows-Clients: Diese CLI-Optionen sollten nicht mit Windows NFSv3-Clients verwendet werden, da der Windows-Client eine andere Codierung verwendet. Für Windows-Clients wird SCP oder SFTP als Übertragungsmethode empfohlen. Diese Optionen dürfen nur verwendet werden, wenn Windows-Clients garantieren, dass alle ihre Dateinamen in ASCII sind. Sie sollten jedoch darauf hingewiesen werden, dass Dateien mit Nicht-ASCII-Dateinamen nicht in GCS hochgeladen werden können.

ta enable_nfsv3 [flags]

Optionen

  -h, --help   help for enable_nfsv3

ta finalize

Finalisiert die Appliance.

Zusammenfassung

Das Gerät muss sicher und versandbereit sein. Insbesondere werden alle Verschlüsselungsschlüssel und die gespeicherte Konfiguration gelöscht. Außerdem werden alle Inhalte entfernt, die im lokalen Speicher der Appliance gespeichert sind. Sichern Sie wichtige Dateien oder verschieben Sie sie in das Verzeichnis „ta_data“. Nach der Ausführung dieses Befehls sind keine Datenübertragungen mehr möglich. Dadurch wird die Netplan-Konfiguration entfernt. Die Änderungen werden erst nach einem Neustart wirksam. Folglich wird die Verbindung des Geräts zum Netzwerk nach einem Neustart getrennt. Das Gerät darf niemals versendet werden, ohne dass dieser Befehl zuvor ausgeführt wurde. Es wird ein Sicherheitscode generiert, der für den Erhalt eines Rücksendelabels angegeben werden muss. Falls erforderlich, wird der Sicherheitscode durch Ausführen von „ta status“ angezeigt.

ta finalize [flags]

Beispiele

    ta finalize

Optionen

  -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

Führt „fsck“ auf der Appliance aus.

Zusammenfassung

Mit dem Befehl „fsck“ wird die Konsistenz des Dateisystems der Appliance geprüft. Durch Ausführen dieses Befehls werden keine Änderungen am Gerät vorgenommen. So werden alle Dateisystemfehler erkannt, bevor Sie die Appliance zurückgeben. Das Beheben von Dateisystemfehlern bei Datenübertragungen zu Google Cloud kann schwierig oder unmöglich sein. Dies kann zu Verzögerungen oder Fehlern beim Hochladen von Daten führen. Die Ausführung dieses Befehls kann mehr als 5 Stunden dauern. Möglicherweise muss das System nach dem Ausführen dieses Befehls neu gestartet werden.

ta fsck [flags]

Beispiele

    ta fsck
    ta fsck -f
    ta fsck --fix

Optionen

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

TA-Logging

Befehl zum Aktivieren/Deaktivieren des Loggings.

Zusammenfassung

Bietet eine Schnittstelle für die Interaktion mit dem Logging-Agent.

ta logging [flags]

Beispiele

    ta logging start
    ta logging stop

Optionen

  -h, --help   help for logging

Messwerte für die Zielgruppenansprache

Befehl zum Aktivieren/Deaktivieren von Messwerten.

Zusammenfassung

Bietet eine Schnittstelle für die Interaktion mit dem Monitoring-Workflow.

ta metrics [flags]

Beispiele

    ta metrics start
    ta metrics stop

Optionen

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

ta mount

Führen Sie den Mount-Befehl auf der Appliance aus.

Zusammenfassung

Bringen Sie die Griffe an der Appliance an. Es umschließt den Linux-Befehl „mount“.

ta mount [flags]

Beispiele

    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

Optionen

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

Deaktiviert Onlinevorgänge auf dem Gerät.

Zusammenfassung

Deaktiviert den Onlinemodus für die Übertragung der Appliance. Daten aus dem angegebenen Onlineverzeichnis werden NICHT von lokal in die Cloud verschoben, auch wenn eine Netzwerkverbindung besteht.

ta offline [flags]

Beispiele

    ta offline

Optionen

  -h, --help   help for offline

ta online

Aktivieren Sie den Onlinemodus der Appliance.

Zusammenfassung

Aktiviert den Onlinemodus für die Übertragung der Appliance. Daten aus dem angegebenen Onlineverzeichnis werden bei bestehender Netzwerkverbindung von lokal zu GCS verschoben. Die erforderlichen Anmeldedaten des Dienstkontos müssen unter /tmp/key.json vorhanden sein.

ta online [flags]

Beispiele

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

Optionen

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

Setzen Sie den Onlinemodus der Appliance zurück.

Zusammenfassung

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

Optionen

  -h, --help   help for online_reset

ta os

Eine Schnittstelle für die Interaktion mit dem Betriebssystem.

Zusammenfassung

Bietet eine Schnittstelle für die Interaktion mit dem Betriebssystem. Mit diesen Befehlen können Sie das Betriebssystem aktualisieren, ein Rollback des Betriebssystems durchführen oder die Betriebssystemversion anzeigen.

ta os [flags]

Beispiele

    ta os update
    ta os rollback
    ta os version

Optionen

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

Leistung von TA

Speicher-Benchmarktest, bei dem die Ausgabe in „ta_metadata“ gespeichert wird.

Zusammenfassung

Gibt eine CSV-Datei mit FIO-Speicherleistungs-Benchmark-Messwerten in „ta_metadata“ aus: - Zeitstempel - Seriennummer des Geräts - Aktuelle Sitzungs-ID - Gerätemodell - Zimbru-Betriebssystemversion - Gerätestandort - Benchmark-Lesebandbreite - Benchmark-Leseabschlusslatenz - Benchmark-Schreibbandbreite - Benchmark-Schreibabschlusslatenz - Benchmark-Parameter

ta performance [flags]

Beispiele

    ta performance
    ta performance --upload

Optionen

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

zieht und archiviert Daten, die auf der Appliance bereitgestellt werden.

Zusammenfassung

Beim Pull-Vorgang wird ein Verzeichnis angegeben, in dem alle vorhandenen Dateien verarbeitet und archiviert werden. Die Dateien werden dann am angegebenen Zielort gespeichert. Mit diesem Befehl wird eine Manifestdatei generiert, in der beschrieben wird, welche Dateien in welchem Archiv gespeichert wurden. Eine Fehlerdatei wird am Zielort gespeichert. Sie enthält alle Fehler, die bei der Verarbeitung des Zielverzeichnisses aufgetreten sind.

ta pull [flags]

Beispiele

    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

Optionen

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

zurücksetzen

Setzt das Gerät zurück.

Zusammenfassung

Setzt das Gerät auf den ursprünglichen Zustand zurück.
Das bedeutet, dass alle Daten, die bereits in die Datenpartition kopiert wurden, verloren gehen. Nach dem Zurücksetzen muss die Appliance neu konfiguriert werden. Dabei wird die Datenpartition formatiert und die Appliance für die Datenübertragung vorbereitet. NFS/SMB wird deaktiviert. Die Netzwerkkonfiguration wird zurückgesetzt. Die Änderungen werden jedoch erst nach einem Neustart wirksam.

ta reset [flags]

Beispiele

    ta reset

Optionen

  -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

Startet den NFS-Server auf dem Gerät neu.

ta restart_nfs [flags]

Optionen

  -h, --help   help for restart_nfs

ta-Status

Zeigt Status- und Zustandsinformationen der Appliance an.

Zusammenfassung

Zeigt Status- und Gesundheitsinformationen der Appliance an: - Status der Appliance: „Nicht konfiguriert“, „Bereit für die Übertragung“, „Finalisiert“. – aktuelle Konfiguration des Geräts (gemäß dem letzten „config“-Befehl) – Puls-Informationen (z.B. verwendeter und verfügbarer Speicherplatz, Anzahl der kopierten Dateien, Übertragungsgeschwindigkeit) – Systemdiagnosen (z.B. nicht verfügbare Laufwerke, ungültiger Status, ungültige Konfiguration)

ta status [flags]

Beispiele

    ta status
    ta status --verbose

Optionen

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

ta telemetry_archive

Befehl zum Archivieren von Telemetrielogs.

ta telemetry_archive [flags]

Optionen

  -h, --help   help for telemetry_archive

ta timesync

Zeitsynchronisierung verwalten

Optionen

  -h, --help   help for timesync

ta unmount

Führen Sie „unmount“ auf der Appliance aus.

Zusammenfassung

Mit „Unmount“ werden Kundenmounts auf der Appliance getrennt und der Eintrag aus {{.CustomerFstab}}entfernt.

ta unmount [flags]

Beispiele

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

Optionen

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

Entsiegelt den DEK und stellt die Datenpartition der Appliance bereit.

Zusammenfassung

Entsiegelt den DEK und stellt die Datenpartition der Appliance bereit. Dieser Befehl ist nach einem Neustart erforderlich, um den Datenverschlüsselungsschlüssel zu entsiegeln und die Datenpartition neu zu mounten. Dieser Befehl muss ausgeführt werden, bevor Sie mit der Datenübertragung fortfahren können.

ta unseal [flags]

Beispiele

    ta unseal

Optionen

  -h, --help   help for unseal

ta update

Befehl zum Aktualisieren der Software auf dem Gerät.

Zusammenfassung

Aktualisiert die Software auf dem Gerät.

ta update [flags]

Beispiele

    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

Optionen

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

Zeigt die Version der Appliance an.

ta version [flags]

Optionen

  -h, --help   help for version

ta wipe

Löscht die Datenpartition der Appliance.

Zusammenfassung

Durch das Löschen werden alle Datenlaufwerke auf dem Gerät gemäß NIST-Standard gelöscht. Es wird ein Zertifikat mit den gelöschten Laufwerken und den zum Löschen der Laufwerke verwendeten Tools generiert. „Wipe“ ist ein irreversibler Befehl. Das bedeutet, dass Daten nach dem Löschen der Laufwerke nicht wiederhergestellt werden können.

ta wipe [flags]

Beispiele

    ta wipe

Optionen

  -h, --help   help for wipe