Restore from Command Line | Teradata AppCenter - 1.9 - Restoring AppCenter - Teradata AppCenter

Teradata® AppCenter User Guide

Teradata AppCenter
December 2019
User Guide

"" Administrator

Only users with access to appctl can back up AppCenter. For assistance, contact your IT administrator or Teradata Customer Support.

When restore from a backup, AppCenter includes LDAP, system, user, and email configuration. It also includes apps, scripts, and jobs. Backups do not include service accounts. You must recreate the service accounts and assign them to the appropriate apps and scripts after you restore AppCenter.

  1. Log into AppCenter from the command-line interface.
  2. Uninstall AppCenter using the following command:
    appctl platform uninstall --name appcenter
  3. Run the command appctl platform restore --name <backup-file-name> –localPath <path-to-local-backup> --decKey <backupDecKey> --localPath <path_chart_bundle> --registry --set key1=val1, key2=val2 with the following considerations:
    Parameter Consideration
    --chart Required argument that specifies the path to the restore chart bundle (.tgz file).
    --name Backup file name. Either --name or --localPath is required.

    If --name is used, the backup of the same name from the cluster is restored.

    --localPath Absolute path to the local backup file. Either --localPath or --name is required.

    If a local backup file is available to restore from, use --localPath.

    If you use --localPath, the local backup file is restored.

    --decKey Optional flag to overwrite the default encryption key.
    -f, --values valueFiles Optional flag that specifies values in YAML file to override chart defaults. You can specify multiple files with each -f flag.
    --set stringArray Optional flag to set values on the command line. You can specify multiple or separate values with commas. For example:

    key1=val1, key2=val2

  4. [Optional] To show the status of all restore jobs during the lifetime of the current platform deployment in reverse chronological order, run the command appctl platform restore status --filterBy <Success,Failed,Running> with the following consideration:
    Parameter Consideration
    --filterBy Optional flag that filters the restore status command output by the status specified. Status options include:
    • Success
    • Failed
    • Running
    Specify one status option for each run of this command. For example:

    appctl platform restore status --filterBy Running

    Status information for all restores appears. For example:
    Job: <job1> started at <time-1> to restore from backup with name: <backup-1> has status: Success
    Job: <job2> started at <time-2> to restore from backup with name: <backup-2> has status: Failed
    Job: <job3> started at <time-3> to restore from backup with name: <backup-3> has status: Running
  5. Start AppCenter by running one of the following commands:
    appctl platform install --name appcenter --namespace

    appcenter ./appcenter- -f appcenter-override.yaml