Verificación de la tarea
Verifica si hay errores en el electrodoméstico.
Sinopsis
Diagnostica y ayuda a los clientes a solucionar problemas habituales. El objetivo principal del comando es ayudar a detectar errores de configuración lo antes posible.
Este comando verifica varios aspectos del dispositivo, incluidos los siguientes: - Hardware - Software - ABM - Encriptación - Claves - Uso - Red - SSH
ta check [flags]
Ejemplos
ta check
ta check usage
ta check hardware
ta check {category}
Opciones
-e, --env string Environment to run the check in. (default "prod")
-h, --help help for check
Configuración de TA
Configura el dispositivo.
Sinopsis
Configurar o volver a configurar el dispositivo para prepararlo para la transferencia de datos La configuración proporcionada se conservará y se recordará en los reinicios posteriores y hasta que se emita el comando "finalize". Usa el comando "status" más adelante para ver la configuración actual. Durante la configuración, se crea y exporta el recurso compartido de NFS para la captura de datos. Al mismo tiempo, se habilita la encriptación de datos para que los datos copiados estén siempre seguros y bajo tu control. La encriptación y el montaje de la partición de datos solo se realizarán una vez. Puedes volver a ejecutar el comando "config" para actualizar la configuración de red en cualquier momento.
ta config [flags]
Ejemplos
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
Opciones
-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
Copia las claves SSH en el dispositivo.
ta copy_ssh_keys [flags]
Opciones
-h, --help help for copy_ssh_keys
Diagnóstico de la antena
Muestra información de diagnóstico del dispositivo.
Sinopsis
Recopila información de diagnóstico útil para solucionar problemas en caso de que surjan. Esto incluye copias de los archivos de configuración del sistema y el resultado de algunas herramientas de diagnóstico. No incluye ningún dato del usuario. La información se recopila en un archivo comprimido para que se pueda enviar a Google y solucionar problemas.
ta diagnostics [flags]
Ejemplos
ta diagnostics
ta diagnostics --bmc
Opciones
-B, --bmc Include BMC FFDC logs in diagnostics logs
-h, --help help for diagnostics
ta disable_nfsv3
Inhabilita NFSv3 en el dispositivo.
Sinopsis
Este comando inhabilita el uso de clientes NFSv3 para transferir datos al Transfer Appliance.
ta disable_nfsv3 [flags]
Opciones
-h, --help help for disable_nfsv3
ta disable_online_operations
Inhabilita las operaciones en línea en el electrodoméstico.
ta disable_online_operations [flags]
Opciones
-h, --help help for disable_online_operations
ta enable_nfsv3
Habilita el uso de clientes de NFSv3 para transferir datos a Transfer Appliance.
Sinopsis
Este comando permite el uso de clientes de NFSv3 para transferir datos a Transfer Appliance.
Habilitar NFSv3 introduce limitaciones con respecto a la codificación de nombres de archivos. GCS (Google Cloud Storage) requiere que los nombres de archivo estén codificados en UTF-8. Si bien NFSv4 convierte automáticamente los nombres de archivos a UTF-8 durante la transferencia, NFSv3 no lo hace.
Por lo tanto, si usas NFSv3, ten en cuenta lo siguiente: * Es posible que no se puedan subir a GCS los archivos con nombres de archivo codificados en un formato que no sea UTF-8. * Si fallan las cargas, puede ser difícil identificar los archivos que fallaron debido a posibles problemas de codificación de nombres de archivos.
Recomendación: Antes de usar NFSv3, asegúrate de que todos los nombres de archivos estén codificados en UTF-8. Si los archivos no están codificados en UTF-8, considera usar SCP o SFTP para la transferencia.
Clientes de Windows: Estas opciones de la CLI no se deben usar con clientes de Windows NFSv3, ya que el cliente de Windows usa una codificación diferente. Para los clientes de Windows, se recomienda el método de transferencia SCP o SFTP. Estas opciones solo se pueden usar si los clientes de Windows garantizan que todos sus nombres de archivo están en ASCII, pero se les debe informar que los archivos con nombres que no sean ASCII no se podrán subir a GCS.
ta enable_nfsv3 [flags]
Opciones
-h, --help help for enable_nfsv3
ta finalize
Finaliza el dispositivo.
Sinopsis
Asegúrate de que el dispositivo sea seguro y esté listo para el envío. En particular, se borran todas las claves de encriptación y la configuración persistente. También quita el contenido almacenado en el almacenamiento local del dispositivo. Crea una copia de seguridad de los archivos importantes o muévelos al directorio ta_data. Las transferencias de datos ya no serán posibles después de emitir este comando. Esto quita la configuración de netplan, y los cambios solo se aplican después de reiniciar. Por lo tanto, el electrodoméstico se desconectará de la red después de reiniciarse. Nunca se debe enviar el electrodoméstico sin ejecutar este comando primero. Se generará un código que se debe proporcionar para obtener una etiqueta de envío de devolución. Si es necesario, ejecutar "ta status" mostrará el código.
ta finalize [flags]
Ejemplos
ta finalize
Opciones
-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
Ejecuta fsck en el dispositivo.
Sinopsis
El comando fsck verifica la coherencia del sistema de archivos del dispositivo. Ejecutar este comando no realiza ningún cambio en el dispositivo. Garantiza que se detecten los errores del sistema de archivos antes de devolver el dispositivo. Depurar errores del sistema de archivos durante las transferencias de datos a Google Cloud puede ser difícil o inviable. Esto puede provocar retrasos o errores en la carga de datos. Este comando puede tardar más de 5 horas en completarse. Es posible que debas reiniciar el sistema después de ejecutar este comando.
ta fsck [flags]
Ejemplos
ta fsck
ta fsck -f
ta fsck --fix
Opciones
-f, --fix Repair filesystem errors if found.
-h, --help help for fsck
Registro de TA
Comando para habilitar o inhabilitar el registro.
Sinopsis
Proporciona una interfaz para interactuar con el agente de registro.
ta logging [flags]
Ejemplos
ta logging start
ta logging stop
Opciones
-h, --help help for logging
Métricas de TA
Comando para habilitar o inhabilitar las métricas.
Sinopsis
Proporciona una interfaz para interactuar con el flujo de trabajo de supervisión.
ta metrics [flags]
Ejemplos
ta metrics start
ta metrics stop
Opciones
--env string Environment to run the metrics in. (default "prod")
-h, --help help for metrics
Soporte de cámara de acción
Ejecuta el soporte en el electrodoméstico.
Sinopsis
Los soportes de montaje permiten instalar la cámara en el electrodoméstico. Encapsula el comando de activación de Linux.
ta mount [flags]
Ejemplos
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
Opciones
--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
Inhabilita las operaciones en línea en el electrodoméstico.
Sinopsis
Inhabilita el modo de transferencia en línea del dispositivo. Los datos del directorio en línea especificado NO se moverán de la ubicación local a la nube, incluso si hay conectividad de red.
ta offline [flags]
Ejemplos
ta offline
Opciones
-h, --help help for offline
ta online
Habilita el modo de transferencia en línea del dispositivo.
Sinopsis
Habilita el modo de transferencia en línea del dispositivo. Los datos del directorio en línea especificado se moverán de las instalaciones locales a GCS si hay conectividad de red. (Se espera que las credenciales de la cuenta de servicio necesarias estén presentes en /tmp/key.json).
ta online [flags]
Ejemplos
ta online
ta online --bucket=my-bucket --object_prefix=my-object_prefix
ta online --bucket=my-bucket
ta online --object_prefix=my-object_prefix
Opciones
--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
Restablece el modo de transferencia en línea del dispositivo.
Sinopsis
Online reset puts the appliance in offline mode, deletes the folder /mnt/ta_metadata/state.
ta online_reset [flags]
Opciones
-h, --help help for online_reset
ta os
Es una interfaz para interactuar con el SO.
Sinopsis
Proporciona una interfaz para interactuar con el SO. Estos comandos te permiten actualizar el SO, revertirlo o mostrar su versión.
ta os [flags]
Ejemplos
ta os update
ta os rollback
ta os version
Opciones
-h, --help help for os
-r, --rollback string Rollback the updated OS.
Rendimiento de la TA
Prueba comparativa de almacenamiento que guarda el resultado en ta_metadata.
Sinopsis
Genera un archivo CSV de las métricas de comparativas de rendimiento de almacenamiento de fio en ta_metadata: - Marca de tiempo - Número de serie del dispositivo - ID de sesión actual - Modelo del dispositivo - Versión del SO de Zimbru - Ubicación del dispositivo - Ancho de banda de lectura de la comparativa - Latencia de finalización de lectura de la comparativa - Ancho de banda de escritura de la comparativa - Latencia de finalización de escritura de la comparativa - Parámetros de la comparativa
ta performance [flags]
Ejemplos
ta performance
ta performance --upload
Opciones
--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
extrae y archiva los datos montados en el dispositivo.
Sinopsis
Pull tomará la ubicación de un directorio, procesará y archivará todos los archivos existentes allí, y los guardará en el destino especificado. Este comando generará un archivo de manifiesto que describa qué archivos se guardaron en qué archivo. Se guardará un archivo de error en el destino, que incluirá cualquier error que se haya producido durante el procesamiento del directorio de destino.
ta pull [flags]
Ejemplos
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
Opciones
-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.
Restablecer la tarjeta
Restablece el electrodoméstico.
Sinopsis
Restablece el dispositivo a su estado original.
Esto significa que se perderán los datos que ya se copiaron en la partición de datos.
Después del restablecimiento, se deberá volver a configurar el dispositivo, lo que formateará la partición de datos y lo preparará para la transferencia de datos.
Se inhabilitará NFS/SMB. Se restablecerá la configuración de red, pero los cambios solo se aplicarán después de reiniciar el dispositivo.
ta reset [flags]
Ejemplos
ta reset
Opciones
-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
Reinicia el servidor NFS en el dispositivo.
ta restart_nfs [flags]
Opciones
-h, --help help for restart_nfs
Estado de la TA
Muestra información sobre el estado y el funcionamiento del electrodoméstico.
Sinopsis
Muestra el estado y la información de salud del dispositivo: - Estado del dispositivo: Sin configurar, listo para la transferencia, finalizado. - Configuración actual del dispositivo (según el último comando "config") - Información de pulsos (p.ej., almacenamiento usado y disponible, recuento de archivos copiados, velocidad de transferencia) - Verificaciones de estado (p.ej., discos no disponibles, estado no válido, configuración no válida)
ta status [flags]
Ejemplos
ta status
ta status --verbose
Opciones
-h, --help help for status
-v, --verbose If true, displays verbose status information.
ta telemetry_archive
Comando para archivar registros de telemetría.
ta telemetry_archive [flags]
Opciones
-h, --help help for telemetry_archive
ta timesync
Administra la sincronización de hora
Opciones
-h, --help help for timesync
ta unmount
Ejecuta el desmontaje en el dispositivo.
Sinopsis
Unmount controla la desactivación de las activaciones del cliente en el dispositivo y quita la entrada de {{.CustomerFstab}}.
ta unmount [flags]
Ejemplos
ta unmount --version
ta unmount --all
ta unmount --target=/mnt/ta_data_base/ta_mounts/test
Opciones
--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
Desbloquea la DEK y activa la partición de datos del dispositivo.
Sinopsis
Desbloquea la DEK y activa la partición de datos del dispositivo. Este comando es necesario después de un reinicio para desprecintar la clave de encriptación de datos y volver a montar la partición de datos. Este comando se debe ejecutar antes de continuar con la transferencia de datos.
ta unseal [flags]
Ejemplos
ta unseal
Opciones
-h, --help help for unseal
ta update
Comando para actualizar el software del electrodoméstico.
Sinopsis
Actualiza el software del electrodoméstico.
ta update [flags]
Ejemplos
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
Opciones
--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.
Versión de TA
Muestra la versión del dispositivo.
ta version [flags]
Opciones
-h, --help help for version
ta wipe
Borra la partición de datos del dispositivo.
Sinopsis
Wipe borra todas las unidades de datos del dispositivo de acuerdo con los estándares del NIST. Se generará un certificado en el que se detallarán las unidades que se borraron y las herramientas que se usaron para borrarlas. Wipe es un comando irreversible, lo que significa que no hay forma de recuperar los datos una vez que se borran las unidades.
ta wipe [flags]
Ejemplos
ta wipe
Opciones
-h, --help help for wipe