Documentation de référence sur la CLI Transfer Appliance

ta check

Vérifie si des erreurs se produisent sur l'appliance.

Synopsis

Diagnostique les problèmes courants et aide les clients à les résoudre. L'objectif principal de cette commande est de détecter les erreurs de configuration le plus tôt possible.

Cette commande vérifie plusieurs aspects de l'appliance, y compris: - Matériel - Logiciel - ABM - Chiffrer - Clés - Utilisation - Réseau - SSH

ta check [flags]

Exemples

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

Options

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

ta config

Configure l'appliance.

Synopsis

Configurez ou reconfigurez l'appliance pour la préparer au transfert de données. La configuration fournie sera conservée et mémorisée lors des redémarrages suivants et jusqu'à l'exécution de la commande "finalize". Utilisez la commande "status" ultérieurement pour afficher la configuration actuelle. Lors de la configuration, le partage NFS est créé et exporté pour la capture de données. En même temps, le chiffrement des données est activé afin que les données copiées soient toujours sécurisées et sous votre contrôle. Le chiffrement et le montage de la partition de données ne seront effectués qu'une seule fois. Vous pouvez réexécuter la commande "config" pour mettre à jour le paramètre réseau à tout moment.

ta config [flags]

Exemples

    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

Options

  -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

Copie les clés SSH sur l'appliance.

ta copy_ssh_keys [flags]

Options

  -h, --help   help for copy_ssh_keys

ta diagnostics

Affiche les informations de diagnostic de l'appliance.

Synopsis

Collecte des informations de diagnostic utiles pour résoudre les problèmes. Cela inclut des copies des fichiers de configuration du système et la sortie de certains outils de diagnostic. Elle n'inclut aucune donnée utilisateur. Les informations sont collectées dans un fichier d'archive compressé afin de pouvoir être envoyées à Google pour la résolution des problèmes.

ta diagnostics [flags]

Exemples

    ta diagnostics
    ta diagnostics --bmc

Options

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

ta disable_nfsv3

Désactive NFSv3 sur l'appliance.

Synopsis

Cette commande désactive l'utilisation de clients NFSv3 pour transférer des données vers Transfer Appliance.

ta disable_nfsv3 [flags]

Options

  -h, --help   help for disable_nfsv3

ta disable_online_operations

Désactive les opérations en ligne sur l'appliance.

ta disable_online_operations [flags]

Options

  -h, --help   help for disable_online_operations

ta enable_nfsv3

Active l'utilisation de clients NFSv3 pour transférer des données vers Transfer Appliance.

Synopsis

Cette commande active l'utilisation de clients NFSv3 pour transférer des données vers Transfer Appliance.

L'activation de NFSv3 introduit des limites concernant l'encodage des noms de fichiers. GCS (Google Cloud Storage) exige que les noms de fichiers soient encodés au format UTF-8. Alors que NFSv4 convertit automatiquement les noms de fichiers au format UTF-8 lors du transfert, NFSv3 ne le fait pas.

Par conséquent, si vous utilisez NFSv3 : * Les fichiers dont les noms ne sont pas encodés au format UTF-8 peuvent ne pas être importés dans GCS. * En cas d'échec des importations, il peut être difficile d'identifier les fichiers concernés en raison de problèmes potentiels d'encodage des noms de fichiers.

Recommandation : Avant d'utiliser NFSv3, assurez-vous que tous les noms de fichiers sont encodés au format UTF-8. Si les fichiers ne sont pas encodés au format UTF-8, envisagez plutôt d'utiliser SCP ou SFTP pour le transfert.

Clients Windows : ces options CLI ne doivent pas être utilisées avec les clients Windows NFSv3, car le client Windows utilise un encodage différent. Pour les clients Windows, SCP ou SFTP est la méthode de transfert recommandée. Ces options ne peuvent être utilisées que si les clients Windows garantissent que tous leurs noms de fichiers sont au format ASCII, mais ils doivent savoir que les fichiers dont les noms ne sont pas au format ASCII ne seront pas importés dans GCS.

ta enable_nfsv3 [flags]

Options

  -h, --help   help for enable_nfsv3

ta finalize

Finalise l'appliance.

Synopsis

Assurez-vous que l'appareil est sécurisé et prêt à être expédié. En particulier, cela efface toutes les clés de chiffrement et la configuration persistante. Il supprime également tout contenu stocké dans l'espace de stockage local de l'appliance. Veuillez sauvegarder les fichiers importants ou les déplacer vers le répertoire ta_data. Les transferts de données ne seront plus possibles après l'exécution de cette commande. Cela supprime la configuration netplan, et les modifications ne prennent effet qu'au redémarrage. Par conséquent, l'appliance se déconnectera du réseau après un redémarrage. L'appliance ne doit jamais être expédiée sans avoir exécuté cette commande au préalable. Un code secret sera généré et devra être fourni pour obtenir une étiquette de livraison de retour. Si nécessaire, l'exécution de « ta status » affichera le code secret.

ta finalize [flags]

Exemples

    ta finalize

Options

  -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

Exécute fsck sur l'appliance.

Synopsis

La commande fsck vérifie la cohérence du système de fichiers de l'appliance. L'exécution de cette commande n'apporte aucune modification à l'appliance. Elle permet de s'assurer que toutes les erreurs du système de fichiers sont détectées avant le retour de l'appliance. Le débogage des erreurs du système de fichiers lors des transferts de données vers Google Cloud peut être difficile, voire impossible. Cela peut entraîner des retards ou des échecs lors de l'importation des données. L'exécution de cette commande peut prendre plus de cinq heures. Il peut être nécessaire de redémarrer le système après l'exécution de cette commande.

ta fsck [flags]

Exemples

    ta fsck
    ta fsck -f
    ta fsck --fix

Options

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

ta mount

Exécute mount sur l'appliance.

Synopsis

Mount gère le montage sur l'appliance. Il encapsule la commande mount de Linux.

ta mount [flags]

Exemples

    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

Options

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

Désactive les opérations en ligne sur l'appliance.

Synopsis

Désactive le mode de transfert en ligne de l'appliance. Les données du répertoire en ligne spécifié ne seront PAS déplacées du site vers le cloud, même en cas de connectivité réseau.

ta offline [flags]

Exemples

    ta offline

Options

  -h, --help   help for offline

ta os

Interface permettant d'interagir avec l'OS.

Synopsis

Fournit une interface permettant d'interagir avec l'OS. Cette commande vous permet de mettre à jour l'OS, de le rétablir ou d'afficher sa version.

ta os [flags]

Exemples

    ta os update
    ta os rollback
    ta os version

Options

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

ta performance

Test d'évaluation des performances de stockage qui enregistre la sortie dans ta_metadata.

Synopsis

Génère un fichier CSV des métriques d'évaluation des performances de stockage fio dans ta_metadata: - Timestamp - Numéro de série de l'appliance - ID de session actuel - Modèle d'appliance - Version de l'OS Zimbru - Emplacement de l'appliance - Bande passante de lecture de l'évaluation - Latence d'achèvement de la lecture de l'évaluation - Bande passante d'écriture de l'évaluation - Latence d'achèvement de l'écriture de l'évaluation - Paramètres de l'évaluation

ta performance [flags]

Exemples

    ta performance
    ta performance --upload

Options

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

Récupère et archive les données montées sur l'appliance.

Synopsis

La commande "pull" prend un emplacement de répertoire, traite et archive tous les fichiers qui s'y trouvent, puis les enregistre à la destination spécifiée. Cette commande génère un fichier manifeste décrivant les fichiers enregistrés dans chaque archive. Un fichier d'erreur est enregistré à la destination. Il inclut toutes les erreurs rencontrées lors du traitement du répertoire cible.

ta pull [flags]

Exemples

    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

Options

  -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

Réinitialise l'appliance.

Synopsis

Rétablit l'état d'origine de l'appliance.
Cela signifie que toutes les données déjà copiées dans la partition de données seront perdues. Après la réinitialisation, l'appliance devra être reconfigurée, ce qui formatera la partition de données et la préparera au transfert de données. NFS/SMB sera désactivé. La configuration réseau sera réinitialisée, mais les modifications ne prendront effet qu'au redémarrage.

ta reset [flags]

Exemples

    ta reset

Options

  -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

Redémarre le serveur NFS sur l'appliance.

ta restart_nfs [flags]

Options

  -h, --help   help for restart_nfs

ta status

Affiche l'état et les informations de santé de l'appliance.

Synopsis

Affiche l'état et les informations de santé de l'appliance : - état de l'appliance : non configurée, prête pour le transfert, finalisée. - configuration actuelle de l'appliance (par commande "config" la plus récente) - informations sur l'impulsion (par exemple, espace de stockage utilisé & disponible, nombre de fichiers copiés, vitesse de transfert) - vérifications de l'état (par exemple, disques non disponibles, état non valide, configuration non valide)

ta status [flags]

Exemples

    ta status
    ta status --verbose

Options

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

ta telemetry_archive

Commande permettant d'archiver les journaux de télémétrie.

ta telemetry_archive [flags]

Options

  -h, --help   help for telemetry_archive

ta timesync

Gérer la synchronisation horaire

Options

  -h, --help   help for timesync

ta unmount

Exécute unmount sur l'appliance.

Synopsis

Unmount gère le démontage des montages client sur l'appliance et supprime l'entrée de {{.CustomerFstab}}.

ta unmount [flags]

Exemples

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

Options

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

Désencapsule la DEK et monte la partition de données de l'appliance.

Synopsis

Désencapsule la DEK et monte la partition de données de l'appliance. Cette commande est requise après un redémarrage pour désencapsuler la clé de chiffrement des données et remonter la partition de données. Cette commande doit être exécutée avant de poursuivre le transfert de données.

ta unseal [flags]

Exemples

    ta unseal

Options

  -h, --help   help for unseal

ta update

Commande permettant de mettre à jour le binaire ta sur l'appliance.

Synopsis

Met à jour le binaire ta sur l'appliance.

ta update [flags]

Exemples

    ta update

Options

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

ta version

Affiche la version de l'appliance.

ta version [flags]

Options

  -h, --help   help for version

ta wipe

Efface la partition de données de l'appliance.

Synopsis

Wipe efface tous les lecteurs de données de l'appliance conformément à la norme NIST. Un certificat détaillant les lecteurs effacés et les outils utilisés pour les effacer sera généré. Wipe est une commande irréversible, ce qui signifie qu'il n'existe aucun moyen de récupérer les données une fois les lecteurs effacés.

ta wipe [flags]

Exemples

    ta wipe

Options

  -h, --help   help for wipe