Referência da CLI do Transfer Appliance

ta check

Verifica se há erros no dispositivo.

Synopsis

Diagnostica e ajuda os clientes a corrigir problemas comuns. O principal objetivo do comando é ajudar a detectar configurações incorretas o mais cedo possível.

Esse comando verifica vários aspectos do dispositivo, incluindo: - Hardware - Software - ABM - Criptografar - Chaves - Uso - Rede - SSH

ta check [flags]

Exemplos

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

Opções

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

ta config

Configura o dispositivo.

Synopsis

Configure ou reconfigure o dispositivo para que ele fique pronto para a transferência de dados. A configuração fornecida será mantida e lembrada em reinicializações subsequentes e até que o comando "finalize" seja emitido. Use o comando "status" mais tarde para conferir a configuração atual. Durante a configuração, o compartilhamento NFS é criado e exportado para captura de dados. Ao mesmo tempo, a criptografia de dados é ativada para que os dados copiados estejam sempre seguros e sob seu controle. A criptografia e a montagem da partição de dados serão feitas apenas uma vez. Você pode executar o comando "config" novamente para atualizar a configuração de rede a qualquer momento.

ta config [flags]

Exemplos

    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

Opções

  -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 as chaves SSH para o dispositivo.

ta copy_ssh_keys [flags]

Opções

  -h, --help   help for copy_ssh_keys

ta diagnostics

Mostra informações de diagnóstico do dispositivo.

Synopsis

Coleta informações de diagnóstico úteis para a solução de problemas em caso de problemas. Isso inclui cópias de arquivos de configuração do sistema e a saída de algumas ferramentas de diagnóstico. Não inclui dados do usuário. As informações são coletadas em um arquivo compactado para que possam ser enviadas ao Google para solução de problemas.

ta diagnostics [flags]

Exemplos

    ta diagnostics
    ta diagnostics --bmc

Opções

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

ta disable_nfsv3

Desativa o NFSv3 no dispositivo.

Synopsis

Esse comando desativa o uso de clientes NFSv3 para transferir dados para o Transfer Appliance.

ta disable_nfsv3 [flags]

Opções

  -h, --help   help for disable_nfsv3

ta disable_online_operations

Desativa as operações on-line no dispositivo.

ta disable_online_operations [flags]

Opções

  -h, --help   help for disable_online_operations

ta enable_nfsv3

Ativa o uso de clientes NFSv3 para transferir dados para o Transfer Appliance.

Synopsis

Esse comando ativa o uso de clientes NFSv3 para transferir dados para o Transfer Appliance.

A ativação do NFSv3 introduz limitações em relação à codificação de nomes de arquivos. O GCS (Google Cloud Storage) exige que os nomes de arquivos sejam codificados em UTF-8. Embora o NFSv4 converta automaticamente os nomes de arquivos para UTF-8 durante a transferência, o NFSv3 não faz isso.

Portanto, se você estiver usando o NFSv3: * Os arquivos com nomes de arquivos não codificados em UTF-8 podem falhar no upload para o GCS. * Se os uploads falharem, a identificação dos arquivos com falha poderá ser difícil devido a possíveis problemas de codificação de nomes de arquivos.

Recomendação: antes de usar o NFSv3, verifique se todos os nomes de arquivos estão codificados em UTF-8. Se os arquivos não estiverem codificados em UTF-8, considere usar SCP ou SFTP para transferência.

Clientes do Windows: essas opções de CLI não devem ser usadas com clientes NFSv3 do Windows, porque o cliente do Windows usa uma codificação diferente. Para clientes do Windows, o SCP ou SFTP é o método de transferência recomendado. Essas opções só podem ser usadas se os clientes do Windows garantirem que todos os nomes de arquivos estejam em ASCII, mas eles precisam saber que os arquivos com nomes de arquivos não ASCII não serão enviados para o GCS.

ta enable_nfsv3 [flags]

Opções

  -h, --help   help for enable_nfsv3

ta finalize

Finaliza o dispositivo.

Synopsis

Verifique se o dispositivo está seguro e pronto para envio. Em particular, isso limpa todas as chaves de criptografia e a configuração persistente. Ele também remove qualquer conteúdo armazenado no armazenamento local do dispositivo. Faça backup de arquivos importantes ou mova para o diretório ta_data. As transferências de dados não serão mais possíveis após a emissão desse comando. Isso remove a configuração do netplan, e as mudanças só entram em vigor após a reinicialização. Consequentemente, o dispositivo será desconectado da rede após uma reinicialização. O dispositivo nunca deve ser enviado sem executar esse comando primeiro. Um código de acesso será gerado e precisará ser fornecido para receber um rótulo para envio de devolução. Se necessário, a execução de "ta status" vai informar o código de acesso.

ta finalize [flags]

Exemplos

    ta finalize

Opções

  -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

Executa o fsck no dispositivo.

Synopsis

O comando fsck verifica a consistência do sistema de arquivos do dispositivo. A execução desse comando não faz mudanças no dispositivo. Ele garante que todos os erros do sistema de arquivos sejam detectados antes de retornar o dispositivo. A depuração de erros do sistema de arquivos durante as transferências de dados para o Google Cloud pode ser desafiadora ou inviável. Isso pode levar a atrasos ou falhas no upload de dados. Esse comando pode levar mais de 5 horas para ser concluído. Talvez seja necessário reiniciar o sistema após executar esse comando.

ta fsck [flags]

Exemplos

    ta fsck
    ta fsck -f
    ta fsck --fix

Opções

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

ta logging

Comando para ativar/desativar a geração de registros.

Synopsis

Fornece uma interface para interagir com o agente de geração de registros.

ta logging [flags]

Exemplos

    ta logging start
    ta logging stop

Opções

  -h, --help   help for logging

ta metrics

Comando para ativar/desativar métricas.

Synopsis

Fornece uma interface para interagir com o fluxo de trabalho de monitoramento.

ta metrics [flags]

Exemplos

    ta metrics start
    ta metrics stop

Opções

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

ta mount

Executa a montagem no dispositivo.

Synopsis

A montagem processa a montagem no dispositivo. Ele envolve o comando de montagem do Linux.

ta mount [flags]

Exemplos

    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

Opções

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

Desativa as operações on-line no dispositivo.

Synopsis

Desativa o modo de transferência on-line do dispositivo. Os dados do diretório on-line especificado NÃO serão movidos do local para a nuvem, mesmo na presença de conectividade de rede.

ta offline [flags]

Exemplos

    ta offline

Opções

  -h, --help   help for offline

ta online

Ativa o modo de transferência on-line do dispositivo.

Synopsis

Ativa o modo de transferência on-line do dispositivo. Os dados do diretório on-line especificado serão movidos do local para o GCS na presença de conectividade de rede. (As credenciais da conta de serviço necessárias precisam estar presentes em /tmp/key.json)

ta online [flags]

Exemplos

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

Opções

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

Redefine o modo de transferência on-line do dispositivo.

Synopsis

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

Opções

  -h, --help   help for online_reset

ta os

Uma interface para interagir com o SO.

Synopsis

Fornece uma interface para interagir com o SO. Esse comando permite atualizar, reverter ou mostrar a versão do SO.

ta os [flags]

Exemplos

    ta os update
    ta os rollback
    ta os version

Opções

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

ta performance

Teste de comparativo de armazenamento que salva a saída em ta_metadata.

Synopsis

Gera um arquivo CSV de métricas de desempenho de armazenamento do fio em ta_metadata: - Carimbo de data/hora - Número de série do dispositivo - ID da sessão atual - Modelo do dispositivo - Versão do SO Zimbru - Local do dispositivo - Largura de banda de leitura de comparativo - Latência de conclusão de leitura de comparativo - Largura de banda de gravação de comparativo - Latência de conclusão de gravação de comparativo - Parâmetros de comparativo

ta performance [flags]

Exemplos

    ta performance
    ta performance --upload

Opções

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

extrai e arquiva dados montados no dispositivo.

Synopsis

O comando "pull" vai receber um local de diretório e processar e arquivar todos os arquivos existentes, salvando-os no destino especificado. Esse comando vai gerar um arquivo de manifesto descrevendo quais arquivos foram salvos em qual arquivo. Um arquivo de erro será salvo no destino, que incluirá todos os erros encontrados durante o processamento do diretório de destino.

ta pull [flags]

Exemplos

    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

Opções

  -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

Redefine o dispositivo.

Synopsis

Redefine o dispositivo para o estado original.
Isso significa que todos os dados já copiados para a partição de dados serão perdidos. Após a redefinição, o dispositivo precisará ser reconfigurado, o que vai formatar a partição de dados e preparar o dispositivo para a transferência de dados. O NFS/SMB será desativado. A configuração de rede será redefinida, mas as mudanças só entrarão em vigor após a reinicialização.

ta reset [flags]

Exemplos

    ta reset

Opções

  -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 o servidor NFS no dispositivo.

ta restart_nfs [flags]

Opções

  -h, --help   help for restart_nfs

ta status

Mostra informações de status e integridade do dispositivo.

Synopsis

Mostra informações de status e integridade do dispositivo: - estado do dispositivo: não configurado, pronto para transferência, finalizado. - configuração atual do dispositivo (por último comando "config") - informações de pulso (por exemplo, armazenamento usado & disponível, contagem de arquivos copiados, velocidade de transferência) - verificações de integridade (por exemplo, discos indisponíveis, estado inválido, configuração inválida)

ta status [flags]

Exemplos

    ta status
    ta status --verbose

Opções

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

ta telemetry_archive

Comando para arquivar registros de telemetria.

ta telemetry_archive [flags]

Opções

  -h, --help   help for telemetry_archive

ta timesync

Gerenciar a sincronização de horário

Opções

  -h, --help   help for timesync

ta unmount

Executa a desmontagem no dispositivo.

Synopsis

A desmontagem processa as montagens do cliente no dispositivo e remove a entrada de {{.CustomerFstab}}.

ta unmount [flags]

Exemplos

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

Opções

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

Desbloqueia a DEK e monta a partição de dados do dispositivo.

Synopsis

Desbloqueia a DEK e monta a partição de dados do dispositivo. Esse comando é necessário após uma reinicialização para desbloquear a chave de criptografia de dados e remontar a partição de dados. Esse comando precisa ser executado antes de continuar com a transferência de dados.

ta unseal [flags]

Exemplos

    ta unseal

Opções

  -h, --help   help for unseal

ta update

Comando para atualizar o software no dispositivo.

Synopsis

Atualiza o software no dispositivo.

ta update [flags]

Exemplos

    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

Opções

      --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 a versão do dispositivo.

ta version [flags]

Opções

  -h, --help   help for version

ta wipe

Limpa a partição de dados do dispositivo.

Synopsis

A limpeza apaga todas as unidades de dados no dispositivo de maneira compatível com o NIST. Um certificado detalhando as unidades que foram limpas e as ferramentas usadas para limpar as unidades será gerado. A limpeza é um comando irreversível, o que significa que não há como recuperar os dados depois que as unidades são limpas.

ta wipe [flags]

Exemplos

    ta wipe

Opções

  -h, --help   help for wipe