Transfer Appliance-Befehlszeilenreferenz

ta check

Prüft die Appliance auf Fehler.

Synopsis

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.

Dieser Befehl prüft mehrere Aspekte der Appliance, 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.

Synopsis

Konfigurieren oder rekonfigurieren Sie die Appliance, um sie für die Datenübertragung vorzubereiten. Die bereitgestellte Konfiguration wird beibehalten und bei nachfolgenden Neustarts gespeichert, bis der Befehl „finalize“ ausgegeben wird. Mit dem Befehl „status“ können Sie später die aktuelle Konfiguration aufrufen. Während 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 unter Ihrer Kontrolle bleiben. Die Verschlüsselung und Bereitstellung der Datenpartition erfolgt nur einmal. 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

Zeigt Diagnoseinformationen der Appliance an.

Synopsis

Erfasst Diagnoseinformationen, die bei der Fehlerbehebung hilfreich sind. Dazu gehören Kopien von Systemkonfigurationsdateien und die Ausgabe einiger Diagnosetools. Nutzerdaten sind nicht enthalten. Die Informationen werden in einer komprimierten Archivdatei erfasst, 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.

Synopsis

Mit diesem Befehl wird die Verwendung von NFSv3-Clients für die Übertragung 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 der Appliance.

ta disable_online_operations [flags]

Optionen

  -h, --help   help for disable_online_operations

ta enable_nfsv3

Aktiviert die Verwendung von NFSv3-Clients für die Übertragung von Daten auf die Transfer Appliance.

Synopsis

Mit diesem Befehl wird die Verwendung von NFSv3-Clients für die Übertragung von Daten auf die Transfer Appliance aktiviert.

Durch die Aktivierung von NFSv3 werden Einschränkungen hinsichtlich der Dateinamencodierung eingeführt. 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 das bei NFSv3 nicht der Fall.

Wenn Sie also NFSv3 verwenden: * Dateien mit nicht UTF-8-codierten Dateinamen können möglicherweise nicht in GCS hochgeladen werden. * Wenn Uploads fehlschlagen, kann es aufgrund potenzieller Probleme mit der Dateinamencodierung schwierig sein, die fehlgeschlagenen Dateien zu identifizieren.

Empfehlung: Bevor Sie NFSv3 verwenden, prüfen Sie, ob 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 Befehlszeilenoptionen sollten nicht mit Windows NFSv3-Clients verwendet werden, da der Windows-Client eine andere Codierung verwendet. Für Windows-Clients ist SCP oder SFTP die empfohlene Übertragungsmethode. Diese Optionen dürfen nur verwendet werden, wenn Windows-Clients garantieren, dass alle Dateinamen im ASCII-Format vorliegen. 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.

Synopsis

Prüfen Sie, ob das Gerät sicher und versandbereit ist. Insbesondere werden alle Verschlüsselungsschlüssel und die beibehaltene 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 Ausgabe dieses Befehls sind keine Datenübertragungen mehr möglich. Dadurch wird die Netplan-Konfiguration entfernt und die Änderungen werden erst nach einem Neustart wirksam. Folglich wird die Verbindung der Appliance zum Netzwerk nach einem Neustart getrennt. Die Appliance sollte niemals versendet werden, ohne diesen Befehl zuerst auszuführen. Es wird ein Passcode generiert, der angegeben werden muss, um ein Rücksendelabel zu erhalten. Bei Bedarf wird der Passcode mit dem Befehl „ta status“ ausgegeben.

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.

Synopsis

Der Befehl „fsck“ prüft die Konsistenz des Dateisystems der Appliance. Durch Ausführen dieses Befehls werden keine Änderungen an der Appliance vorgenommen. So wird sichergestellt, dass alle Dateisystemfehler erkannt werden, bevor die Appliance zurückgegeben wird. Das Debuggen 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 Ausführung 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 mount

Führt „mount“ auf der Appliance aus.

Synopsis

„mount“ verarbeitet die Bereitstellung auf der Appliance. 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 der Appliance.

Synopsis

Deaktiviert den Onlineübertragungsmodus der Appliance. Daten aus dem angegebenen Onlineverzeichnis werden auch bei bestehender Netzwerkverbindung NICHT von lokal zu Cloud verschoben.

ta offline [flags]

Beispiele

    ta offline

Optionen

  -h, --help   help for offline

ta os

Eine Schnittstelle für die Interaktion mit dem Betriebssystem.

Synopsis

Bietet eine Schnittstelle für die Interaktion mit dem Betriebssystem. Mit diesem Befehl können Sie das Betriebssystem aktualisieren, ein Rollback 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.

ta performance

Speicher-Benchmarktest, der die Ausgabe in „ta_metadata“ speichert.

Synopsis

Gibt eine CSV-Datei mit FIO-Benchmarkmesswerten zur Speicherleistung in „ta_metadata“ aus: - Zeitstempel - Seriennummer der Appliance - Aktuelle Sitzungs-ID - Appliance-Modell - Zimbru-Betriebssystemversion - Standort der Appliance - 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. 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

Ruft auf der Appliance bereitgestellte Daten ab und archiviert sie.

Synopsis

„pull“ verwendet einen Verzeichnisspeicherort, verarbeitet und archiviert alle dort vorhandenen Dateien und speichert sie am angegebenen Ziel. Mit diesem Befehl wird eine Manifestdatei generiert, in der beschrieben wird, welche Dateien in welchem Archiv gespeichert wurden. Eine Fehlerdatei wird am Ziel gespeichert. Sie wird alle Fehler enthalten, 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.

ta reset

Setzt die Appliance zurück.

Synopsis

Setzt die Appliance auf den ursprünglichen Zustand zurück.
Das bedeutet, dass alle Daten, die bereits auf 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 der Appliance neu.

ta restart_nfs [flags]

Optionen

  -h, --help   help for restart_nfs

ta status

Zeigt Status- und Zustandsinformationen der Appliance an.

Synopsis

Zeigt Status- und Zustandsinformationen der Appliance an: - Status der Appliance: nicht konfiguriert, bereit für die Übertragung, finalisiert. - Aktuelle Konfiguration der Appliance (gemäß dem letzten Befehl „config“) - Puls-Informationen (z.B. verwendeter und verfügbarer Speicher, Anzahl der kopierten Dateien, Übertragungsgeschwindigkeit) - Zustandsprüfungen (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 Telemetrieprotokollen.

ta telemetry_archive [flags]

Optionen

  -h, --help   help for telemetry_archive

ta timesync

Zeitsynchronisierung verwalten

Optionen

  -h, --help   help for timesync

ta unmount

Führt „unmount“ auf der Appliance aus.

Synopsis

„unmount“ hebt die Bereitstellung von Kundenbereitstellungen auf der Appliance auf und entfernt den Eintrag aus {{.CustomerFstab}}.

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.

Synopsis

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 bereitzustellen. Dieser Befehl muss ausgeführt werden, bevor Sie mit der Datenübertragung fortfahren.

ta unseal [flags]

Beispiele

    ta unseal

Optionen

  -h, --help   help for unseal

ta update

Befehl zum Aktualisieren der binären Datei „ta“ auf der Appliance.

Synopsis

Aktualisiert die binäre Datei „ta“ auf der Appliance.

ta update [flags]

Beispiele

    ta update

Optionen

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

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.

Synopsis

„wipe“ löscht alle Datenlaufwerke auf der Appliance gemäß NIST. Es wird ein Zertifikat erstellt, in dem die gelöschten Laufwerke und die zum Löschen der Laufwerke verwendeten Tools aufgeführt sind. „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