Transfer Appliance CLI 참조

ta check

어플라이언스에 오류가 있는지 확인합니다.

Synopsis

일반적인 문제를 진단하고 고객이 문제를 해결하도록 지원합니다. 이 명령어의 주요 목표는 가능한 한 빨리 잘못된 구성을 감지하는 것입니다.

이 명령어는 다음과 같은 어플라이언스의 여러 측면을 확인합니다. - 하드웨어 - 소프트웨어 - ABM - 암호화 - 키 - 사용량 - 네트워크 - SSH

ta check [flags]

예시

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

옵션

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

ta config

어플라이언스를 구성합니다.

Synopsis

어플라이언스를 구성하거나 재구성하여 데이터 전송을 준비합니다. 제공된 구성은 후속 재부팅 시까지 그리고 'finalize' 명령어가 실행될 때까지 유지되고 기억됩니다. 나중에 'status' 명령어를 사용하여 현재 구성을 확인합니다. 구성 중에 데이터 캡처를 위해 NFS 공유가 생성되고 내보내집니다. 동시에 복사된 데이터가 항상 안전하고 사용자가 제어할 수 있도록 데이터 암호화가 사용 설정됩니다. 데이터 파티션 암호화 및 마운트는 한 번만 실행됩니다. 언제든지 'config' 명령어를 다시 실행하여 네트워크 설정을 업데이트할 수 있습니다.

ta config [flags]

예시

    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

옵션

  -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

SSH 키를 어플라이언스에 복사합니다.

ta copy_ssh_keys [flags]

옵션

  -h, --help   help for copy_ssh_keys

ta diagnostics

어플라이언스의 진단 정보를 표시합니다.

Synopsis

문제가 발생할 경우 문제 해결에 유용한 진단 정보를 수집합니다. 여기에는 시스템 구성 파일의 사본과 일부 진단 도구의 출력이 포함됩니다. 사용자 데이터는 포함되지 않습니다. 문제 해결을 위해 Google에 전송할 수 있도록 정보가 압축된 보관 파일로 수집됩니다.

ta diagnostics [flags]

예시

    ta diagnostics
    ta diagnostics --bmc

옵션

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

ta disable_nfsv3

어플라이언스에서 NFSv3을 사용 중지합니다.

Synopsis

이 명령어는 NFSv3 클라이언트를 사용하여 데이터를 Transfer Appliance로 전송하는 것을 사용 중지합니다.

ta disable_nfsv3 [flags]

옵션

  -h, --help   help for disable_nfsv3

ta disable_online_operations

어플라이언스에서 온라인 작업을 사용 중지합니다.

ta disable_online_operations [flags]

옵션

  -h, --help   help for disable_online_operations

ta enable_nfsv3

NFSv3 클라이언트를 사용하여 데이터를 Transfer Appliance로 전송하는 것을 사용 설정합니다.

Synopsis

이 명령어는 NFSv3 클라이언트를 사용하여 데이터를 Transfer Appliance로 전송하는 것을 사용 설정합니다.

NFSv3을 사용 설정하면 파일 이름 인코딩과 관련된 제한사항이 도입됩니다. GCS (Google Cloud Storage)에서는 파일 이름이 UTF-8로 인코딩되어야 합니다. NFSv4는 전송 중에 파일 이름을 UTF-8로 자동 변환하지만 NFSv3은 그렇지 않습니다.

따라서 NFSv3을 사용하는 경우 다음 사항에 유의하세요. * UTF-8로 인코딩되지 않은 파일 이름이 있는 파일은 GCS에 업로드되지 않을 수 있습니다. * 업로드가 실패하면 파일 이름 인코딩 문제로 인해 실패한 파일을 식별하기 어려울 수 있습니다.

권장사항: NFSv3을 사용하기 전에 모든 파일 이름이 UTF-8로 인코딩되어 있는지 확인하세요. 파일이 UTF-8로 인코딩되지 않은 경우 대신 SCP 또는 SFTP를 사용하여 전송하는 것이 좋습니다.

Windows 클라이언트: Windows 클라이언트는 다른 인코딩을 사용하므로 이러한 CLI 옵션을 Windows NFSv3 클라이언트와 함께 사용해서는 안 됩니다. Windows 클라이언트의 경우 SCP 또는 SFTP가 권장되는 전송 방법입니다. 이러한 옵션은 Windows 클라이언트가 모든 파일 이름이 ASCII로 되어 있다고 보장하는 경우에만 사용할 수 있지만, ASCII가 아닌 파일 이름이 있는 파일은 GCS에 업로드되지 않는다는 점을 알고 있어야 합니다.

ta enable_nfsv3 [flags]

옵션

  -h, --help   help for enable_nfsv3

ta finalize

어플라이언스를 완료합니다.

Synopsis

기기가 안전하고 배송 준비가 되었는지 확인합니다. 특히 이 명령어는 모든 암호화 키와 영구 구성을 삭제합니다. 또한 어플라이언스 로컬 스토리지에 저장된 콘텐츠도 삭제합니다. 중요한 파일을 백업하거나 ta_data 디렉터리로 이동하세요. 이 명령어를 실행한 후에는 더 이상 데이터 전송이 불가능합니다. 이 명령어는 netplan 구성을 삭제하며 변경사항은 재부팅 시에만 적용됩니다. 따라서 어플라이언스는 재부팅 후 네트워크에서 연결이 끊어집니다. 이 명령어를 먼저 실행하지 않고 어플라이언스를 배송해서는 안 됩니다. 반품 배송물 라벨을 받기 위해 제공해야 하는 비밀번호가 생성됩니다. 필요한 경우 'ta status'를 실행하면 비밀번호가 보고됩니다.

ta finalize [flags]

예시

    ta finalize

옵션

  -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

어플라이언스에서 fsck를 실행합니다.

Synopsis

fsck 명령어는 어플라이언스의 파일 시스템 일관성을 확인합니다. 이 명령어를 실행해도 어플라이언스가 변경되지는 않습니다. 어플라이언스를 반환하기 전에 파일 시스템 오류가 감지되도록 합니다. Google Cloud로 데이터를 전송하는 동안 파일 시스템 오류를 디버깅하는 것은 어렵거나 불가능할 수 있습니다. 이로 인해 데이터 업로드가 지연되거나 실패할 수 있습니다. 이 명령어를 완료하는 데 5시간 이상 걸릴 수 있습니다. 이 명령어를 실행한 후 시스템을 재부팅해야 할 수도 있습니다.

ta fsck [flags]

예시

    ta fsck
    ta fsck -f
    ta fsck --fix

옵션

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

ta logging

로깅을 사용 설정/중지하는 명령어입니다.

Synopsis

로깅 에이전트와 상호작용할 수 있는 인터페이스를 제공합니다.

ta logging [flags]

예시

    ta logging start
    ta logging stop

옵션

  -h, --help   help for logging

ta metrics

측정항목을 사용 설정/중지하는 명령어입니다.

Synopsis

모니터링 워크플로와 상호작용할 수 있는 인터페이스를 제공합니다.

ta metrics [flags]

예시

    ta metrics start
    ta metrics stop

옵션

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

ta mount

어플라이언스에서 마운트를 실행합니다.

Synopsis

마운트는 어플라이언스에서 마운트를 처리합니다. Linux의 마운트 명령어를 래핑합니다.

ta mount [flags]

예시

    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

옵션

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

어플라이언스에서 온라인 작업을 사용 중지합니다.

Synopsis

어플라이언스의 온라인 전송 모드를 사용 중지합니다. 네트워크 연결이 있더라도 지정된 온라인 디렉터리의 데이터는 온프레미스에서 클라우드로 이동되지 않습니다.

ta offline [flags]

예시

    ta offline

옵션

  -h, --help   help for offline

ta online

어플라이언스의 온라인 전송 모드를 사용 설정합니다.

Synopsis

어플라이언스의 온라인 전송 모드를 사용 설정합니다. 네트워크 연결이 있는 경우 지정된 온라인 디렉터리의 데이터가 온프레미스에서 GCS로 이동됩니다. 필요한 서비스 계정 사용자 인증 정보는 /tmp/key.json에 있어야 합니다.

ta online [flags]

예시

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

옵션

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

어플라이언스의 온라인 전송 모드를 재설정합니다.

Synopsis

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

옵션

  -h, --help   help for online_reset

ta os

OS와 상호작용하기 위한 인터페이스입니다.

Synopsis

OS와 상호작용할 수 있는 인터페이스를 제공합니다. 이 명령어를 사용하면 OS를 업데이트하거나 OS를 롤백하거나 OS 버전을 표시할 수 있습니다.

ta os [flags]

예시

    ta os update
    ta os rollback
    ta os version

옵션

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

ta performance

ta_metadata에 출력을 저장하는 스토리지 벤치마크 테스트입니다.

Synopsis

ta_metadata에 fio 스토리지 성능 벤치마크 측정항목의 csv를 출력합니다. - 타임스탬프 - 어플라이언스 일련번호 - 현재 세션 ID - 어플라이언스 모델 - Zimbru OS 버전 - 어플라이언스 위치 - 벤치마크 읽기 대역폭 - 벤치마크 읽기 완료 지연 시간 - 벤치마크 쓰기 대역폭 - 벤치마크 쓰기 완료 지연 시간 - 벤치마크 매개변수

ta performance [flags]

예시

    ta performance
    ta performance --upload

옵션

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

어플라이언스에 마운트된 데이터를 가져오고 보관합니다.

Synopsis

가져오기는 디렉터리 위치를 가져와서 거기에 있는 모든 파일을 처리하고 보관하여 지정된 대상에 저장합니다. 이 명령어는 어떤 파일이 어떤 보관 파일에 저장되었는지 설명하는 매니페스트 파일을 생성합니다. 오류 파일은 대상에 저장되며 여기에는 대상 디렉터리를 처리하는 동안 발생한 오류가 포함됩니다.

ta pull [flags]

예시

    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

옵션

  -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

어플라이언스를 재설정합니다.

Synopsis

어플라이언스를 원래 상태로 재설정합니다.
즉, 데이터 파티션에 이미 복사된 데이터는 손실됩니다. 재설정 후에는 어플라이언스를 재구성해야 합니다. 그러면 데이터 파티션이 포맷되고 어플라이언스가 데이터 전송을 준비하게 됩니다. NFS/SMB가 사용 중지됩니다. 네트워크 구성이 재설정되지만 변경사항은 재부팅 시에만 적용됩니다.

ta reset [flags]

예시

    ta reset

옵션

  -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

어플라이언스에서 NFS 서버를 다시 시작합니다.

ta restart_nfs [flags]

옵션

  -h, --help   help for restart_nfs

ta status

어플라이언스의 상태 및 상태 정보를 표시합니다.

Synopsis

어플라이언스의 상태 및 상태 정보를 표시합니다. - 어플라이언스 상태: 구성되지 않음, 전송 준비, 완료됨. - 어플라이언스의 현재 구성 (마지막 "config" 명령어 기준) - 펄스 정보 (예: 스토리지 사용량 & 사용 가능한 스토리지, 복사된 파일 수, 전송 속도) - 상태 점검 (예: 사용할 수 없는 디스크, 잘못된 상태, 잘못된 구성)

ta status [flags]

예시

    ta status
    ta status --verbose

옵션

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

ta telemetry_archive

원격 분석 로그를 보관하는 명령어입니다.

ta telemetry_archive [flags]

옵션

  -h, --help   help for telemetry_archive

ta timesync

시간 동기화 관리

옵션

  -h, --help   help for timesync

ta unmount

어플라이언스에서 마운트 해제를 실행합니다.

Synopsis

마운트 해제는 어플라이언스에서 고객 마운트를 마운트 해제하고 항목을 삭제합니다 {{.CustomerFstab}}.

ta unmount [flags]

예시

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

옵션

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

DEK를 봉인 해제하고 어플라이언스의 데이터 파티션을 마운트합니다.

Synopsis

DEK를 봉인 해제하고 어플라이언스의 데이터 파티션을 마운트합니다. 이 명령어는 재부팅 후 데이터 암호화 키를 봉인 해제하고 데이터 파티션을 다시 마운트하는 데 필요합니다. 이 명령어는 데이터 전송을 계속하기 전에 실행해야 합니다.

ta unseal [flags]

예시

    ta unseal

옵션

  -h, --help   help for unseal

ta update

어플라이언스에서 소프트웨어를 업데이트하는 명령어입니다.

Synopsis

어플라이언스에서 소프트웨어를 업데이트합니다.

ta update [flags]

예시

    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

옵션

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

어플라이언스 버전을 표시합니다.

ta version [flags]

옵션

  -h, --help   help for version

ta wipe

어플라이언스의 데이터 파티션을 초기화합니다.

Synopsis

초기화는 NIST를 준수하는 방식으로 어플라이언스의 모든 데이터 드라이브를 초기화합니다. 초기화된 드라이브와 드라이브를 초기화하는 데 사용된 도구를 자세히 설명하는 인증서가 생성됩니다. 초기화는 되돌릴 수 없는 명령어입니다. 즉, 드라이브가 초기화되면 데이터를 복구할 수 없습니다.

ta wipe [flags]

예시

    ta wipe

옵션

  -h, --help   help for wipe