Riferimento per l'interfaccia a riga di comando di Transfer Appliance

ta check

Controlla la presenza di errori nell'appliance.

Trama

Diagnostica e aiuta i clienti a risolvere i problemi comuni. L'obiettivo principale del comando è rilevare le configurazioni errate il prima possibile.

Questo comando controlla più aspetti dell'appliance, tra cui: - Hardware - Software - ABM - Encrypt - Keys - Usage - Network - SSH

ta check [flags]

Esempi

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

Opzioni

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

ta config

Configura l'appliance.

Trama

Configura o riconfigura l'appliance preparandola per il trasferimento dei dati. La configurazione fornita verrà mantenuta e memorizzata nei riavvii successivi e fino all'emissione del comando "finalize". Utilizza il comando "status" in un secondo momento per visualizzare la configurazione attuale. Durante la configurazione, la condivisione NFS viene creata ed esportata per l'acquisizione dei dati. Allo stesso tempo, la crittografia dei dati è abilitata in modo che i dati copiati siano sempre sicuri e sotto il tuo controllo. La crittografia e il montaggio della partizione dei dati verranno eseguiti una sola volta. Puoi eseguire di nuovo il comando "config" per aggiornare l'impostazione di rete in qualsiasi momento.

ta config [flags]

Esempi

    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

Opzioni

  -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 le chiavi SSH nell'appliance.

ta copy_ssh_keys [flags]

Opzioni

  -h, --help   help for copy_ssh_keys

ta diagnostics

Mostra le informazioni diagnostiche dell'apparecchio.

Trama

Raccoglie informazioni diagnostiche utili per la risoluzione dei problemi in caso di eventuali problemi. Sono incluse copie dei file di configurazione del sistema e l'output di alcuni strumenti di diagnostica. Non include dati utente. Le informazioni vengono raccolte in un file di archivio compresso in modo che possano essere inviate a Google per la risoluzione dei problemi.

ta diagnostics [flags]

Esempi

    ta diagnostics
    ta diagnostics --bmc

Opzioni

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

ta disable_nfsv3

Disabilita NFSv3 sull'appliance.

Trama

Questo comando disattiva l'utilizzo dei client NFSv3 per trasferire i dati a Transfer Appliance.

ta disable_nfsv3 [flags]

Opzioni

  -h, --help   help for disable_nfsv3

ta disable_online_operations

Disattiva le operazioni online sull'appliance.

ta disable_online_operations [flags]

Opzioni

  -h, --help   help for disable_online_operations

ta enable_nfsv3

Consente l'utilizzo di client NFSv3 per trasferire i dati a Transfer Appliance.

Trama

Questo comando consente l'utilizzo di client NFSv3 per trasferire i dati a Transfer Appliance.

L'attivazione di NFSv3 introduce limitazioni relative alla codifica dei nomi file. GCS (Google Cloud Storage) richiede che i nomi dei file siano codificati in UTF-8. Mentre NFSv4 converte automaticamente i nomi dei file in UTF-8 durante il trasferimento, NFSv3 no.

Pertanto, se utilizzi NFSv3: * Il caricamento su GCS dei file con nomi codificati non in UTF-8 potrebbe non riuscire. * Se i caricamenti non vanno a buon fine, identificare i file non riusciti può essere difficile a causa di potenziali problemi di codifica dei nomi dei file.

Consiglio: prima di utilizzare NFSv3, assicurati che tutti i nomi dei file siano codificati in UTF-8. Se i file non sono codificati in UTF-8, valuta la possibilità di utilizzare SCP o SFTP per il trasferimento.

Client Windows: Queste opzioni CLI non devono essere utilizzate con i client NFSv3 di Windows, in quanto il client Windows utilizza una codifica diversa. Per i client Windows, SCP o SFTP è il metodo di trasferimento consigliato. Queste opzioni possono essere utilizzate solo se i client Windows garantiscono che tutti i nomi file siano in ASCII, ma gli utenti devono essere informati che il caricamento dei file con nomi file non ASCII su GCS non andrà a buon fine.

ta enable_nfsv3 [flags]

Opzioni

  -h, --help   help for enable_nfsv3

ta finalize

Finalizza l'appliance.

Trama

Assicurati che il dispositivo sia sicuro e pronto per la spedizione. In particolare, vengono eliminate tutte le chiavi di crittografia e la configurazione persistente. Vengono rimossi anche i contenuti archiviati nello spazio di archiviazione locale dell'appliance. Esegui il backup dei file importanti o spostali nella directory ta_data. I trasferimenti di dati non saranno più possibili dopo l'emissione di questo comando. In questo modo viene rimossa la configurazione di netplan e le modifiche vengono applicate solo al riavvio. Di conseguenza, l'apparecchio si disconnetterà dalla rete dopo il riavvio. L'appliance non deve mai essere spedita senza prima eseguire questo comando. Verrà generato un passcode che deve essere fornito per ottenere un'etichetta per la spedizione del reso; se necessario, l'esecuzione di "ta status" segnalerà il passcode.

ta finalize [flags]

Esempi

    ta finalize

Opzioni

  -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

Esegue fsck sull'appliance.

Trama

Il comando fsck controlla la coerenza del file system dell'appliance. L'esecuzione di questo comando non apporta modifiche all'appliance. Garantisce che eventuali errori del file system vengano rilevati prima della restituzione dell'apparecchio. Il debug degli errori del file system durante i trasferimenti di dati a Google Cloud può essere difficile o impossibile. Ciò può causare ritardi o errori nel caricamento dei dati. Il completamento di questo comando potrebbe richiedere più di 5 ore. Potrebbe essere necessario riavviare il sistema dopo aver eseguito questo comando.

ta fsck [flags]

Esempi

    ta fsck
    ta fsck -f
    ta fsck --fix

Opzioni

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

ta logging

Comando per attivare/disattivare la registrazione.

Trama

Fornisce un'interfaccia per interagire con l'agente Logging.

ta logging [flags]

Esempi

    ta logging start
    ta logging stop

Opzioni

  -h, --help   help for logging

ta metrics

Comando per attivare/disattivare le metriche.

Trama

Fornisce un'interfaccia per interagire con il flusso di lavoro di monitoraggio.

ta metrics [flags]

Esempi

    ta metrics start
    ta metrics stop

Opzioni

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

ta mount

Esegui il comando mount sull'appliance.

Trama

Monta le maniglie sull'elettrodomestico. Esegue il wrapping del comando mount di Linux.

ta mount [flags]

Esempi

    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

Opzioni

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

Disattiva le operazioni online sull'appliance.

Trama

Disattiva la modalità di trasferimento online dell'appliance. I dati della directory online specificata NON verranno spostati da on-premise al cloud anche in presenza di connettività di rete.

ta offline [flags]

Esempi

    ta offline

Opzioni

  -h, --help   help for offline

ta online

Attiva la modalità di trasferimento online dell'appliance.

Trama

Attiva la modalità di trasferimento online dell'appliance. I dati della directory online specificata verranno spostati da on-premise a GCS in presenza di connettività di rete. Le credenziali del account di servizio necessarie devono essere presenti in /tmp/key.json.

ta online [flags]

Esempi

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

Opzioni

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

Reimposta la modalità di trasferimento online dell'appliance.

Trama

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

Opzioni

  -h, --help   help for online_reset

ta os

Un'interfaccia per interagire con il sistema operativo.

Trama

Fornisce un'interfaccia per interagire con il sistema operativo. Questi comandi ti consentono di aggiornare il sistema operativo, eseguire il rollback del sistema operativo o visualizzare la versione del sistema operativo.

ta os [flags]

Esempi

    ta os update
    ta os rollback
    ta os version

Opzioni

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

ta performance

Test di benchmark di archiviazione che salva l'output in ta_metadata.

Trama

Restituisce un file CSV delle metriche di benchmark delle prestazioni di archiviazione fio in ta_metadata: - Timestamp - Numero di serie dell'appliance - ID sessione corrente - Modello dell'appliance - Versione del sistema operativo Zimbru - Posizione dell'appliance - Larghezza di banda di lettura del benchmark - Latenza di completamento della lettura del benchmark - Larghezza di banda di scrittura del benchmark - Latenza di completamento della scrittura del benchmark - Parametri del benchmark

ta performance [flags]

Esempi

    ta performance
    ta performance --upload

Opzioni

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

estrae e archivia i dati montati sull'appliance.

Trama

Il comando Pull accetta una posizione di directory ed elabora e archivia tutti i file esistenti, salvandoli nella destinazione specificata. Questo comando genererà un file manifest che descrive quali file sono stati salvati in quale archivio. Nella destinazione verrà salvato un file di errori che includerà eventuali errori riscontrati durante l'elaborazione della directory di destinazione.

ta pull [flags]

Esempi

    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

Opzioni

  -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

Ripristina l'apparecchio.

Trama

Ripristina lo stato originale dell'appliance.
Ciò significa che tutti i dati già copiati nella partizione dati andranno persi. Dopo il ripristino, l'appliance dovrà essere riconfigurata, il che formatterà la partizione dei dati e la preparerà per il trasferimento dei dati. NFS/SMB verrà disattivato. La configurazione di rete verrà reimpostata, ma le modifiche avranno effetto solo al riavvio.

ta reset [flags]

Esempi

    ta reset

Opzioni

  -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

Riavvia il server NFS sull'appliance.

ta restart_nfs [flags]

Opzioni

  -h, --help   help for restart_nfs

ta status

Mostra lo stato e le informazioni sull'integrità dell'appliance.

Trama

Mostra lo stato e le informazioni sanitarie dell'appliance: - stato dell'appliance: non configurata, pronta per il trasferimento, finalizzata. - configurazione attuale dell'appliance (in base all'ultimo comando "config") - informazioni sul battito (ad es. spazio di archiviazione utilizzato e disponibile, numero di file copiati, velocità di trasferimento) - controlli di integrità (ad es. dischi non disponibili, stato non valido, configurazione non valida)

ta status [flags]

Esempi

    ta status
    ta status --verbose

Opzioni

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

ta telemetry_archive

Comando per archiviare i log di telemetria.

ta telemetry_archive [flags]

Opzioni

  -h, --help   help for telemetry_archive

ta timesync

Gestire la sincronizzazione dell'ora

Opzioni

  -h, --help   help for timesync

ta unmount

Esegui l'operazione di smontaggio sull'appliance.

Trama

Unmount gestisce lo smontaggio dei montaggi del cliente sull'appliance e rimuove la voce da {{.CustomerFstab}}.

ta unmount [flags]

Esempi

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

Opzioni

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

Sblocca la DEK e monta la partizione dei dati dell'appliance.

Trama

Sblocca la DEK e monta la partizione dei dati dell'appliance. Questo comando è necessario dopo un riavvio per sbloccare la chiave di crittografia dei dati e rimontare la partizione dei dati. Questo comando deve essere eseguito prima di continuare con il trasferimento dei dati.

ta unseal [flags]

Esempi

    ta unseal

Opzioni

  -h, --help   help for unseal

ta update

Comando per aggiornare il software sull'appliance.

Trama

Aggiorna il software dell'appliance.

ta update [flags]

Esempi

    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

Opzioni

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

Mostra la versione dell'appliance.

ta version [flags]

Opzioni

  -h, --help   help for version

ta wipe

Cancella la partizione dei dati dell'appliance.

Trama

La cancellazione elimina tutte le unità dati sull'appliance in modo conforme al NIST. Verrà generato un certificato che descrive in dettaglio le unità cancellate e gli strumenti utilizzati per cancellarle. La cancellazione è un comando irreversibile, il che significa che non è possibile recuperare i dati una volta cancellati i dischi.

ta wipe [flags]

Esempi

    ta wipe

Opzioni

  -h, --help   help for wipe