Create a System Image | Teradata Vantage on AWS (DIY) - 2.2 - Creating a System Image - Teradata Vantage on AWS

Teradata Vantage™ on AWS (DIY) Installation and Administration Guide

Teradata Vantage on AWS
Release Number
Release Date
May 2021
Content Type
Publication ID
English (United States)
Use this procedure to create a new system image, such as in the restoration process of a node failure or for deploying new instances for scaling out. If this image is not created, the software on the recovered instance will not match and the database cannot start if a node failure occurs. In addition, you must create a new system image after upgrading software or adding the system to Teradata QueryGrid.

When a new system image is created, Vantage re-provisions hot standby nodes based on the new system image.

Creating a system image requires a reboot of the target node used to create the image. On a single-node system, the system image creation process automatically targets the one available node. After the system reboots, monitor the status of the instance using the AWS CloudWatch logs in /var/log. If you do not complete this procedure, Vantage uses the image generated when you deployed the instance.

When the software upgrade script runs as a part of the following procedure, it creates a temporary d2.xlarge instance and a 350 GB EBS volume. This instance and volume is automatically deleted, but you will incur a minimal charge. Software upgrades are stored in an AMI in your account for node failure recovery purposes or if you scale out. Charges for this AMI vary per customer.

  1. Stop the database.
    # tpareset –x –y stop for swupgrade
  2. Verify the database is in a DOWN/HARDSTOP state.
    # pdestate -a
    Putting the database in this state may take several minutes.
  3. Display a list of running nodes by instance ID, BYNET® name, and PMA ID.
    # tdc-image --list-nodes
    Following is an example of output:
    Instance ID           Bynet Name       PMA ID
    -------------------- ---------------- ----------------
    i-1a78a202           byn001-01        33
    i-78a40160           byn001-02        34
    i-2bd57033           byn001-03        35
    i-5bd87d43           byn001-04        36
    i-1878a200           byn001-05        37
    i-a57ba1bd           byn001-06        38
  4. Specify the instance ID, BYNET name, or PMA ID to use to create the instance.
    # tdc-image --instance-id instance_ID
    # tdc-image --bynet-name BYNET_NAME
    # tdc-image --pma-id PMA_ID
    For example:
    # tdc-image -–bynet-name byn001-03
    where byn001-03 is the BYNET name.
  5. Start the database.
    # /etc/init.d/tpa start
  6. Ensure the database is running again.
    # pdestate -w
    PDE state: RUN/STARTED
    Putting the database in this state may take several minutes.