ta check
Vérifie si l'appareil présente des erreurs.
Synopsis
Diagnostique les problèmes courants et aide les clients à les résoudre. L'objectif principal de la 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 ultérieurs, jusqu'à ce que la commande "finalize" soit exécutée. 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é pour 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
Diagnostics des balises
Affiche des informations de diagnostic sur l'appareil.
Synopsis
Collecte des informations de diagnostic utiles pour résoudre les problèmes éventuels. Cela inclut des copies des fichiers de configuration du système et la sortie de certains outils de diagnostic. Il 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 le dépannage.
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 des 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
Activez l'utilisation de clients NFSv3 pour transférer des données vers Transfer Appliance.
Synopsis
Cette commande permet d'utiliser des 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 : * Il est possible que les fichiers dont les noms ne sont pas encodés en UTF-8 ne puissent 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 en 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 de 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, nous recommandons d'utiliser SCP ou SFTP comme méthode de transfert. Ces options ne peuvent être utilisées que si les clients Windows garantissent que tous leurs noms de fichiers sont en ASCII, mais ils doivent être informés que les fichiers dont les noms ne sont pas en ASCII ne pourront pas être 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 supprime 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. Cette action supprime la configuration netplan. Les modifications ne prennent effet qu'au redémarrage. Par conséquent, l'appareil se déconnecte 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" indiquera 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. Cela permet de s'assurer que les erreurs de système de fichiers sont détectées avant le retour de l'appareil. Il peut être difficile, voire impossible, de déboguer les erreurs de système de fichiers lors des transferts de données vers Google Cloud. 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 est possible que le système doive être redémarré 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 logging
Commande permettant d'activer ou de désactiver la journalisation.
Synopsis
Fournit une interface permettant d'interagir avec l'agent de journalisation.
ta logging [flags]
Exemples
ta logging start
ta logging stop
Options
-h, --help help for logging
Métriques TA
Commande permettant d'activer/désactiver les métriques.
Synopsis
Fournit une interface pour interagir avec le workflow de surveillance.
ta metrics [flags]
Exemples
ta metrics start
ta metrics stop
Options
--env string Environment to run the metrics in. (default "prod")
-h, --help help for metrics
ta mount
Exécutez la commande mount sur l'appliance.
Synopsis
Mount gère le montage sur l'appliance. Elle 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 sur 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 online
Activez le mode de transfert en ligne de l'appliance.
Synopsis
Active le mode de transfert en ligne de l'appliance. Les données du répertoire en ligne spécifié seront déplacées du système sur site vers GCS en présence d'une connectivité réseau. (Les identifiants de compte de service requis doivent être présents sous /tmp/key.json.)
ta online [flags]
Exemples
ta online
ta online --bucket=my-bucket --object_prefix=my-object_prefix
ta online --bucket=my-bucket
ta online --object_prefix=my-object_prefix
Options
--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
Réinitialisez le mode de transfert en ligne de l'appliance.
Synopsis
Online reset puts the appliance in offline mode, deletes the folder /mnt/ta_metadata/state.
ta online_reset [flags]
Options
-h, --help help for online_reset
ta os
Interface permettant d'interagir avec l'OS.
Synopsis
Fournit une interface pour 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 de référence du stockage qui enregistre la sortie dans ta_metadata.
Synopsis
Génère un fichier CSV des métriques de performances de stockage fio dans ta_metadata : - Timestamp (Code temporel) - Appliance serial number (Numéro de série de l'appliance) - Current session ID (ID de session actuel) - Appliance model (Modèle de l'appliance) - Zimbru OS version (Version de l'OS Zimbru) - Appliance location (Emplacement de l'appliance) - Benchmark read bandwidth (Bande passante de lecture du benchmark) - Benchmark read completion latency (Latence d'exécution de la lecture du benchmark) - Benchmark write bandwidth (Bande passante d'écriture du benchmark) - Benchmark write completion latency (Latence d'exécution de l'écriture du benchmark) - Benchmark parameters (Paramètres du benchmark)
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.
--upload Upload performance results to cloud monitoring.
ta pull
extrait 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 y existent, 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'erreurs sera enregistré dans la destination. Il inclura 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'appareil.
Synopsis
Rétablit l'état d'origine de l'appareil.
Cela signifie que toutes les données déjà copiées dans la partition de données seront perdues.
Une fois le serveur réinitialisé, vous devrez le reconfigurer. Cela formatera la partition de données et préparera le serveur 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 des informations sur l'état de santé de l'appliance.
Synopsis
Affiche l'état et les informations sur l'état de santé de l'appliance : - état de l'appliance : non configurée, prête pour le transfert, finalisée. - la configuration actuelle de l'appliance (selon la dernière commande "config") ; - les informations sur les pulsations (par exemple, l'espace de stockage utilisé et disponible, le nombre de fichiers copiés, la vitesse de transfert) ; - les vérifications de l'état de fonctionnement (par exemple, les disques indisponibles, l'état non valide, la 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écutez la commande 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éscelle la DEK et installe la partition de données de l'appliance.
Synopsis
Déscelle la DEK et installe la partition de données de l'appliance. Cette commande est requise après un redémarrage pour désactiver la protection de 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 logiciel sur l'appliance.
Synopsis
Mise à jour du logiciel sur l'appareil.
ta update [flags]
Exemples
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
Options
--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
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
L'option "Wipe" efface toutes les données des lecteurs de l'appliance de manière conforme à la norme NIST. Un certificat détaillant les disques qui ont été effacés et les outils utilisés pour les effacer sera généré. L'effacement est une commande irréversible. Il est donc impossible de récupérer les données une fois les disques effacés.
ta wipe [flags]
Exemples
ta wipe
Options
-h, --help help for wipe