Unfolding a System

Prerequisite
Make sure you have increased Azure service limits. See Azure Service Limits.

For BYOL, make sure you have enough TCores before you unfold the system.

Before unfolding a system, ensure you have enough IP addresses. Each new VM requires 1 IP address from each subnet. A total of 3 IP addresses per VM are required. The available IP addresses per subnet in a VNet are in Virtual network > Subnets.

Use this procedure for any of the following:
  • If you did not initially unfold a system during launch
  • If you previously unfolded a system during launch and want to unfold again after launch

It takes about 20 minutes for a 2 node system and 30 minutes for a 4 node system, depending on the number of premium storage volumes and Azure provisioning time.

  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 unfold] Check to see if your system can be unfolded:
    # tdc-unfold -d
    For information on optional commands you can use with tdc-unfold, see Optional Commands.
  3. Enter one of the following commands to start the unfold process.
    Command Description
    # tdc-unfold 2x Doubles the current node count.

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

    # tdc-unfold 4x

    Quadruples the current node count.

    For example, if the current system has 4 nodes, the unfolded system will have 16 nodes.

    The output displays how the configuration changes after the system has unfolded, as shown in the following example:
    Current system will be unfolded by [2x]:
    ===========================================================================
     Nodes:  Node Count:2 => 4
    ---------------------------------------------------------------------------
     CPU(Core)/Mem(GB):   CPUs/Node:   16 == 16   CPUs Total:   32 => 64Mem/Node:   65 == 65Mem Total:  130 => 260
    ---------------------------------------------------------------------------
     AMPs/PEs:   AMPs/Node:   20 => 10   AMPs Total:   40 == 40PEs/Node:2 == 2 PEs Total:4 => 8
    ===========================================================================
    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.

results matching ""

    No results matching ""