Check for configuration issues

ta check is a command line tool to detect and help fix configuration issues with Transfer Appliance.

To check all categories:

ta check

To check a single category:

ta check CATEGORY

For a list of valid categories, see Categories and checks below.

Responses and logs

Each test returns one of the following statuses:

  • Passed: All conditions were met.
  • Failed: Any of the required conditions weren't met.
  • Warning: The conditions weren't met but does not block the appliance from being used.
  • Skipped: The check is not supported by the appliance type or the check failed due to internal errors.

More information is captured by the log file, found at /mnt/ta_metadata/logs/tacheck/tacheck.log.

Categories and checks

Category Check Notes Transfer Appliance Online-enabled Transfer Appliance Edge Appliance
hardware Encrypt disks Ensures that the appliance's data disks have been encrypted.
Drives Verifies the correct number of boot disks and data disks.
software Firmware Confirms whether the device firmware is up to date.
OS version Ensures that the device OS is up to date.
Google APIs Ensures that all required Google Cloud APIs are enabled.
encryption Encrypt disks Ensures that the appliance's data disks have been encrypted.
TPM-wrapped DEK Ensures that the encrypted data encryption key (DEK) is present on the device.
keys Key Looks for the existence of the key.json service account key file on the device. The file must be at either /tmp/key.json or /mnt/ta_metadata/key.json.
Boot time key Checks if the OS boot time key exists.
network Network interfaces Makes sure that all ethernet ports on the device are functioning.
Ethernet ports IP Checks if the required ports have an IP assigned.
Access Confirms network access by pinging google.com
usage Data usage Compares data disk usage against the threshold (75%).
Boot usage Compares boot disk usage against the threshold (75%).
RAM usage Compares total memory usage of the RAM against the threshold (75%).
GPU usage Compares total memory usage of the GPU against the threshold (75%).
EA-GPU-T4 only
SSH Unique hosts count Counts the number of unique hosts located in the ~/.ssh/config file and warns if there are too many.
SSH config Reports typos in the ~/.ssh/config file.
ABM Anthos APIs Verifies that all Anthos APIs are pingable from the appliance.
KubeConfig Checks for the existence of the .kube/config file.