Folding a System

Teradata Database on Azure Getting Started Guide

Teradata Software for Azure
Make sure you have increased Azure service limits. See Azure Service Limits.
Use this procedure to fold a system after launch.
  1. Provide service principal details and enter responses to the prompts. See Azure Documentation Center for information on how to create the service principal on Azure.
    1. Run tdc-feature-init without arguments.
      # tdc-feature-init
    2. Enter the client ID of your service principal.
    3. Enter the secret key of your service principal.
    4. Enter the tenant of your service principal.
    5. Enter your Azure subscription ID.
    Credentials validation succeeded displays. Service principal details are written to /etc/opt/teradata/tdconfig/service_principal_config.json.
  2. [First time you fold] Check to see if your system can be folded:
    # tdc-fold -d
    For information on optional commands you can use with tdc-fold, see Optional Commands.
  3. Enter one of the following commands to start the fold process: After entering one of the following commands, you can check log files to determine how long the process will take to finish. See Logs.
    Command Description
    # tdc-fold 2x Removes half of the current node count.

    For example, if the current system has 8 nodes, the folded system will have 4 nodes.

    # tdc-fold 4x Removes a quarter of the current node count.

    For example, if the current system has 8 nodes, the folded system will have 2 nodes.

    The output displays how the configuration changes after the system has folded, as shown in the following example:
    Current system will be folded by [2x]:
             Node Count:    4 => 2
              CPUs/Node:   16 == 16       CPUs Total:   64 => 32
               Mem/Node:   65 == 65        Mem Total:  260 => 130
              AMPs/Node:   10 => 20       AMPs Total:   40 == 40
               PEs/Node:    2 == 2         PEs Total:    8 => 4
    Continue? [yes/no] yes
  4. Enter yes. When the process completes, the new configuration appears under Current Configuration.
  5. [Optional] Check the status of the database.
    # pdestate –a
  6. [Optional] Check the logs for troubleshooting. See Logs.