מאמרי עזרה על CLI של Transfer Appliance

ta check

בודק אם יש שגיאות במכשיר.

תקציר

מאבחן בעיות נפוצות ועוזר ללקוחות לפתור אותן. המטרה העיקרית של הפקודה היא לעזור לזהות טעויות בהגדרות מוקדם ככל האפשר.

הפקודה הזו בודקת כמה היבטים של ה-appliance, כולל: – חומרה – תוכנה – 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

הגדרת הציוד.

תקציר

מגדירים או מגדירים מחדש את המכשיר כדי להכין אותו להעברת נתונים. ההגדרה שצוינה תישמר ותיזכר בהפעלות מחדש עתידיות, עד להפעלת הפקודה finalize. אפשר להשתמש בפקודה 'סטטוס' מאוחר יותר כדי לראות את ההגדרה הנוכחית. במהלך ההגדרה, נוצר שיתוף 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

מוצג מידע אבחוני על המכשיר.

תקציר

האפליקציה אוספת נתוני אבחון שימושיים לפתרון בעיות במקרה של בעיות. הגיבוי כולל עותקים של קובצי תצורה של המערכת ופלט של כמה כלים לאבחון. הוא לא כולל נתוני משתמשים. המידע נאסף לקובץ ארכיון דחוס כדי שניתן יהיה לשלוח אותו ל-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 במכשיר.

תקציר

הפקודה הזו משביתה את השימוש בלקוחות 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.

תקציר

הפקודה הזו מאפשרת שימוש בלקוחות 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: אין להשתמש באפשרויות ה-CLI האלה עם לקוחות Windows NFSv3, כי לקוח Windows משתמש בקידוד שונה. ללקוחות Windows, מומלץ להשתמש ב-SCP או ב-SFTP להעברה. אפשר להשתמש באפשרויות האלה רק אם לקוחות Windows מבטיחים שכל שמות הקבצים שלהם הם ב-ASCII, אבל צריך להבהיר להם שהעלאה של קבצים עם שמות קבצים שאינם ב-ASCII תיכשל ל-GCS.

ta enable_nfsv3 [flags]

אפשרויות

  -h, --help   help for enable_nfsv3

ta finalize

השלמת ההגדרה של ה-Appliance.

תקציר

מוודאים שהמכשיר בטוח ומוכן למשלוח. המשמעות היא שכל מפתחות ההצפנה וההגדרות הקבועות יימחקו. היא גם מסירה את כל התוכן שמאוחסן באחסון המקומי של המכשיר. חשוב לגבות קבצים חשובים או להעביר אותם לספרייה 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 במכשיר.

תקציר

הפקודה 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

פקודה להפעלה או להשבתה של רישום ביומן.

תקציר

מספק ממשק ליצירת אינטראקציה עם סוכן הרישום.

ta logging [flags]

דוגמאות

    ta logging start
    ta logging stop

אפשרויות

  -h, --help   help for logging

ta metrics

פקודה להפעלה או להשבתה של מדדים.

תקציר

ממשק לאינטראקציה עם תהליך העבודה של המעקב.

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

מריצים את הפקודה mount במכשיר.

תקציר

הטעינה מטפלת בטעינה במכשיר. היא עוטפת את פקודת הטעינה של 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

ההגדרה הזו משביתה פעולות אונליין במכשיר.

תקציר

משבית את מצב ההעברה אונליין של המכשיר. הנתונים מהספרייה המקוונת שצוינה לא יועברו מהמערכת המקומית לענן, גם אם יש קישוריות לרשת.

ta offline [flags]

דוגמאות

    ta offline

אפשרויות

  -h, --help   help for offline

ta online

מפעילים את מצב ההעברה אונליין של המכשיר.

תקציר

ההגדרה הזו מפעילה את מצב ההעברה אונליין של המכשיר. הנתונים מהספרייה המקוונת שצוינה יועברו מהשרת המקומי אל 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

מאפסים את מצב ההעברה אונליין של המכשיר.

תקציר

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

ממשק לאינטראקציה עם מערכת ההפעלה.

תקציר

מספק ממשק לאינטראקציה עם מערכת ההפעלה. הפקודות האלה מאפשרות לעדכן את מערכת ההפעלה, לבטל את העדכון של מערכת ההפעלה או להציג את גרסת מערכת ההפעלה.

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.

תקציר

הפלט הוא קובץ CSV של מדדי ביצועים של אחסון fio ב-ta_metadata: - חותמת זמן - מספר סידורי של מכשיר - מזהה סשן נוכחי - דגם מכשיר - גרסת מערכת ההפעלה Zimbru - מיקום המכשיר - רוחב פס של קריאת מדד השוואה - חביון השלמת קריאת מדד השוואה - רוחב פס של כתיבת מדד השוואה - חביון השלמת כתיבת מדד השוואה - פרמטרים של מדד השוואה

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. Mutually exclusive with --token-file.
      --token-file string              Path to file containing token to authenticate with google cloud. Mutually exclusive with --token.
      --upload                         Upload performance results to cloud monitoring.

ta pull

שולף ומעביר לארכיון נתונים שמוצמדים למכשיר.

תקציר

הפעולה pull תבחר מיקום של ספרייה, תעבד את כל הקבצים שקיימים בה ותעביר אותם לארכיון, ותשמור אותם ביעד שצוין. הפקודה הזו תיצור קובץ מניפסט שמתאר אילו קבצים נשמרו בארכיון. קובץ שגיאות יישמר ביעד, והוא יכלול את כל השגיאות שנתקלו בהן במהלך עיבוד ספריית היעד.

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

מאפס את המכשיר.

תקציר

מאפסים את המכשיר למצב המקורי שלו.
המשמעות היא שכל הנתונים שכבר הועתקו למחיצת הנתונים יאבדו. אחרי האיפוס, צריך להגדיר מחדש את המכשיר. הפעולה הזו תגרום לפורמט של מחיצת הנתונים, והמכשיר יהיה מוכן להעברת נתונים. פרוטוקול 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

מוצג מידע על הסטטוס והתקינות של המכשיר.

תקציר

הצגת סטטוס ומידע על תקינות המכשיר: - מצב המכשיר: לא הוגדר, מוכן להעברה, סופי. – ההגדרה הנוכחית של המכשיר (לפי הפקודה האחרונה '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

מריצים את הפקודה unmount במכשיר.

תקציר

הפונקציה unmount מטפלת בביטול של נקודות העיגון של הלקוח במכשיר ומסירה את הרשומה מ- {{.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 ומעלה את מחיצת הנתונים של ה-appliance.

תקציר

פותח את ה-DEK ומעלה את מחיצת הנתונים של ה-appliance. צריך להשתמש בפקודה הזו אחרי הפעלה מחדש כדי לבטל את הנעילה של המפתח להצפנת נתונים ולהרכיב מחדש את מחיצת הנתונים. צריך להריץ את הפקודה הזו לפני שממשיכים בהעברת הנתונים.

ta unseal [flags]

דוגמאות

    ta unseal

אפשרויות

  -h, --help   help for unseal

עדכון ta

פקודה לעדכון התוכנה במכשיר.

תקציר

עדכון התוכנה במכשיר.

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

הגרסה של המכשיר.

ta version [flags]

אפשרויות

  -h, --help   help for version

ta wipe

מחיקת מחיצת הנתונים של המכשיר.

תקציר

האפשרות Wipe מוחקת את כל כונני הנתונים במכשיר בהתאם לתקן NIST. יופק אישור עם פרטים על הכוננים שנמחקו ועל הכלים ששימשו למחיקת הכוננים. הפקודה Wipe היא בלתי הפיכה, כלומר אין דרך לשחזר נתונים אחרי שמבצעים Wipe בכוננים.

ta wipe [flags]

דוגמאות

    ta wipe

אפשרויות

  -h, --help   help for wipe