What would you do if you knew?

Teradata Database on VMware

Developer Tier
Getting Started Guide
Deployer Release 3.01
B035-5938-097K
September 2017
The product or products described in this book are licensed products of Teradata Corporation or its affiliates.

Teradata, Aster, BYNET, Claraview, DecisionCast, IntelliBase, IntelliCloud, IntelliFlex, QueryGrid, SQL-MapReduce, Teradata Decision Experts,
"Teradata Labs" logo, Teradata ServiceConnect, and Teradata Source Experts are trademarks or registered trademarks of Teradata Corporation or its
affiliates in the United States and other countries.
Adaptec and SCSISelect are trademarks or registered trademarks of Adaptec, Inc.
Amazon Web Services, AWS, Amazon Elastic Compute Cloud, Amazon EC2, Amazon Simple Storage Service, Amazon S3, AWS CloudFormation, and
AWS Marketplace are trademarks of Amazon.com, Inc. or its affiliates in the United States and/or other countries.
AMD Opteron and Opteron are trademarks of Advanced Micro Devices, Inc.
Apache, Apache Avro, Apache Hadoop, Apache Hive, Hadoop, and the yellow elephant logo are either registered trademarks or trademarks of the
Apache Software Foundation in the United States and/or other countries.
Apple, Mac, and OS X all are registered trademarks of Apple Inc.
Axeda is a registered trademark of Axeda Corporation. Axeda Agents, Axeda Applications, Axeda Policy Manager, Axeda Enterprise, Axeda Access,
Axeda Software Management, Axeda Service, Axeda ServiceLink, and Firewall-Friendly are trademarks and Maximum Results and Maximum Support
are servicemarks of Axeda Corporation.
CENTOS is a trademark of Red Hat, Inc., registered in the U.S. and other countries.
Cloudera and CDH are trademarks or registered trademarks of Cloudera Inc. in the United States, and in jurisdictions throughout the world.
Data Domain, EMC, PowerPath, SRDF, and Symmetrix are either registered trademarks or trademarks of EMC Corporation in the United States and/or
other countries.
GoldenGate is a trademark of Oracle.
Hewlett-Packard and HP are registered trademarks of Hewlett-Packard Company.
Hortonworks, the Hortonworks logo and other Hortonworks trademarks are trademarks of Hortonworks Inc. in the United States and other countries.
Intel, Pentium, and XEON are registered trademarks of Intel Corporation.
IBM, CICS, RACF, Tivoli, IBM Spectrum Protect, and z/OS are trademarks or registered trademarks of International Business Machines Corporation.
Linux is a registered trademark of Linus Torvalds.
LSI is a registered trademark of LSI Corporation.
Microsoft, Active Directory, Windows, Windows NT, and Windows Server are registered trademarks of Microsoft Corporation in the United States and
other countries.
NetVault is a trademark of Quest Software, Inc.
Novell and SUSE are registered trademarks of Novell, Inc., in the United States and other countries.
Oracle, Java, and Solaris are registered trademarks of Oracle and/or its affiliates.
QLogic and SANbox are trademarks or registered trademarks of QLogic Corporation.
Quantum and the Quantum logo are trademarks of Quantum Corporation, registered in the U.S.A. and other countries.
Red Hat is a trademark of Red Hat, Inc., registered in the U.S. and other countries. Used under license.
SAP is the trademark or registered trademark of SAP AG in Germany and in several other countries.
SAS and SAS/C are trademarks or registered trademarks of SAS Institute Inc.
Sentinel® is a registered trademark of SafeNet, Inc.
Simba, the Simba logo, SimbaEngine, SimbaEngine C/S, SimbaExpress and SimbaLib are registered trademarks of Simba Technologies Inc.
SPARC is a registered trademark of SPARC International, Inc.
Unicode is a registered trademark of Unicode, Inc. in the United States and other countries.
UNIX is a registered trademark of The Open Group in the United States and other countries.
Veritas, the Veritas Logo and NetBackup are trademarks or registered trademarks of Veritas Technologies LLC or its affiliates in the U.S. and other
countries.
Other product and company names mentioned herein may be the trademarks of their respective owners.
The information contained in this document is provided on an "as-is" basis, without warranty of any kind, either express or
implied, including the implied warranties of merchantability, fitness for a particular purpose, or non-infringement. Some
jurisdictions do not allow the exclusion of implied warranties, so the above exclusion may not apply to you. In no event will
Teradata Corporation be liable for any indirect, direct, special, incidental, or consequential damages, including lost profits or
lost savings, even if expressly advised of the possibility of such damages.
The information contained in this document may contain references or cross-references to features, functions, products, or services that are not
announced or available in your country. Such references do not imply that Teradata Corporation intends to announce such features, functions,
products, or services in your country. Please consult your local Teradata Corporation representative for those features, functions, products, or services
available in your country.
Information contained in this document may contain technical inaccuracies or typographical errors. Information may be changed or updated without
notice. Teradata Corporation may also make improvements or changes in the products or services described in this information at any time without
notice.
To maintain the quality of our products and services, we would like your comments on the accuracy, clarity, organization, and value of this document.
Please e-mail: [email protected]
Any comments or materials (collectively referred to as "Feedback") sent to Teradata Corporation will be deemed non-confidential. Teradata Corporation
will have no obligation of any kind with respect to Feedback and will be free to use, reproduce, disclose, exhibit, display, transform, create derivative
works of, and distribute the Feedback and derivative works thereof without limitation on a royalty-free basis. Further, Teradata Corporation will be free
to use any ideas, concepts, know-how, or techniques contained in such Feedback for any purpose whatsoever, including developing, manufacturing, or
marketing products or services incorporating Feedback.
Copyright © 2016 - 2017 by Teradata. All Rights Reserved.
 Preface

Purpose
Use the information in this guide to install and configure Teradata Database on VMware.

Audience
This guide is intended for use by:
• System Administrators who configure hardware in preparation for installing Teradata Database on
VMware.
• Administrators who install and configure Teradata Database on VMware.
• Database and software professionals who use Teradata Database on VMware, are responsible for
ensuring the database is running, and use client applications to access the database for development and
testing.

Prerequisites
Before installing software, you must prepare the host nodes, including configuring virtual disks, datastores,
and network connections.
This guide assumes a solid understanding of virtualization, including experience with:
• Configuring hardware in preparation for installing Teradata Database on VMware.
• Managing vSphere, vCenter, and ESXi technology.
• Terms such as standard switches, datastores, VM templates, ova, ovf, and so forth.
• Network setup for Teradata Database nodes for a bare metal installation and how it relates to a vSphere
installation.
• Software applications that access Teradata Database for development, testing, or production.
• Teradata Database configurations including terminology. See VMware and Teradata Terminology.

Revision History
Date Description
September 2017 • Added support for Teradata Database 16.10, Teradata Ecosystem Manager, and
Server Management.
• Updated the Teradata Database on VMware template versions.
• Added the following new chapter and topics:

Teradata Database on VMware Getting Started Guide, Deployer Release 3.01 3

Preface

Date Description

∘ Supported Software for Teradata Database on VMware

∘ Teradata Database Features
∘ Preparing the ova Templates
∘ Preparing the Templates in the Local System
∘ Installing and Configuring Other Teradata Applications (chapter)
∘ Installing and Configuring Teradata Studio

June 2017 • Renamed this book to Teradata Database on VMware Developer Tier Getting
Started Guide. Changed terminology from edition to tier.
• Changed to using a deployment executable file instead of deployment scripts to
deploy the Teradata Database on VMware software.
• Added VMware administrator privileges you need to install and configure the
Teradata Database on VMware software.
• Updated the information about database sizing.
• Added instructions on running PowerCLI as Administrator.
• Changed Teradata Data Stream Utility to Teradata Data Stream Controller, which
is the name of the component within the DSU product.

January 2017 • Updated to add support for Teradata Database 16.00 and remove support for
Teradata Database 15.00.

November 2016 • Updated to reflect availability of Teradata Database on VMware Development

Edition at http://downloads.teradata.com/.
• References to "Base Edition" now refer to "Enterprise Edition."

September 2016 Initial release.

This book was previously known as Teradata Virtual Machine Developer Edition
Installation, Configuration, and Upgrade Guide.

Supported Releases
This guide applies to the following releases:
• Teradata Database 16.10
• Teradata Database 15.10

Additional Information
Related Documents

Title Publication ID
Data Stream Utility Installation, Configuration, and Upgrade Guide for B035-3153
Customers

4 Teradata Database on VMware Getting Started Guide, Deployer Release 3.01

 Preface

Title Publication ID
Parallel Upgrade Tool (PUT) Reference B035-5716
Security Administration B035-1100
SQL Data Definition Language Syntax and Examples B035-1144
SQL External Routine Programming B035-1147
Temporal Table Support B035-1182
Teradata Database Administration B035-1093
Teradata Database Node Software Migration Guide Linux B035-5942
Teradata Database on VMware Base, Advanced, Enterprise Tiers Getting B035-5958
Started Guide
Teradata Director Program Reference B035-2416
Teradata Ecosystem Manager User Guide B035-3201
Teradata Server Management Web Services User Guide B035-5350
Teradata Tools and Utilities for IBM z/OS Installation Guide B035-3128
Teradata Viewpoint User Guide B035-2206
Utilities B035-1102

Related Links

URL Description
http://www.teradata.com External site for product, service, resource, support, and other
customer information.
http://www.info.teradata.com External site for published Teradata customer documentation.
http://community.teradata.com/ Community-based product forum for Teradata Database on VMware.
tdvm

Product Safety Information

This document may contain information addressing product safety practices related to data or property
damage, identified by the word Notice. A notice indicates a situation which, if not avoided, could result in
damage to property, such as equipment or data, but not related to personal injury.

Example

Notice:
Improper use of the Reconfiguration utility can result in data loss.

Teradata Database on VMware Getting Started Guide, Deployer Release 3.01 5

Preface

6 Teradata Database on VMware Getting Started Guide, Deployer Release 3.01

 CHAPTER 1
Overview

Teradata Database on VMware

Teradata Database on VMware is a SUSE Linux Enterprise Server (SLES) operating system and Teradata
Database packaged into a virtual container that runs in a virtualized environment on third-party hardware.
You must have administrative privileges on the destination VMware environment to install and configure
the virtual machines.
The Teradata Database on VMware software consists of properties file, hardware configuration scripts, and a
deployment executable file.
The product previously known as Teradata Virtual Machine is now known as Teradata Database on
VMware.

Supported Software for Teradata Database on

VMware
The following is a list of Teradata supported software for Teradata Database on VMware.
An additional cost applies to some of the following software. For a list, see Teradata Database License Tiers.

Software Name Description

Teradata Database Provides the same full-feature data warehouse software that powers
analytics at many of the world's greatest companies, and is available with
local and attached storage.
Teradata Data Stream Controller Provides administrative functions and metadata storage and is a key
component of the backup and restore of Teradata systems in the public
cloud. The Data Stream Controller (DSC) is an administrative server
required to enable object-level backup and restore of the Teradata
Database. It contains a repository for all backup and restore job
definitions and as well as related configuration details for Teradata
systems and backup targets.
Teradata Ecosystem Manager Provides an end-to-end approach to meeting application service level
agreements through monitoring, administration, and control of both
single and multi-system environments to let you more effectively manage
every part of your data warehouse environment.
Teradata Parallel Upgrade Tool Provides a way to upgrade Teradata Database and other Teradata
software.
This software is bundled with Teradata Database.

Teradata Database on VMware Getting Started Guide, Deployer Release 3.01 7

Chapter 1: Overview

Software Name Description

Teradata REST Services Provides an interface to Teradata Database allowing application
developers a simplified, modern interface to connect to data from a web
page or application.
Teradata Server Management Monitors the VM and generates alerts related to database and operating
system errors and operational state changes. Events that affect the
operation of the system generate alerts.
Teradata Database on VMware supports multiple Server Management
VMs. Multiple VMs (CMICs) provide high availability and management
of larger database systems. High availability requires at least two CMICs.
Each CMIC can manage up to 70 nodes with reserve capacity to manage
an additional 70 failover nodes from another CMIC.
Teradata Studio Provides a desktop tool for performing database administration, query
development, and management tasks on Teradata Databases, Teradata
Aster Databases, and Hadoop systems.
This software is obtained from Teradata Community and is installed and
configured separately from other software components.
Teradata Tools and Utilities Provides utilities and libraries for integrating your Teradata system into
your enterprise and streamlining the daily data warehouse management
tasks, such as moving massive volumes of data and accessing multiple
data sources in parallel, and improving your overall Teradata system
performance.
This software is bundled with but installed and configured separately
from Teradata Database.
Teradata Viewpoint Provides a web-based management portal for Teradata performance and
health management which is easy to use. It provides a consistent interface
using configurable portlets which allows you to customize your own
systems management dashboard. Teradata Data Lab, which is included in
certain versions of Teradata Viewpoint, allows you to provision and
manage analytic workspaces in the Teradata data warehouse.

Introduction to Teradata Database License Tiers

Teradata Database on VMware offers four database license tiers depending on your use case. Each tier differs
in scalability and performance. The Base, Advanced, and Enterprise Tiers can be used as an upgrade path
from Teradata Express.
A free Developer tier is also available and can be used for evaluation purposes. Developer can be used for
proof of concepts, development and testing, data validation, and as a sandbox for Teradata Database users.
For more information, see Teradata Database on VMware Developer Tier Getting Started Guide. This book
is for the Developer tier.

8 Teradata Database on VMware Getting Started Guide, Deployer Release 3.01

 Chapter 1: Overview

Each tier is unique in what it offers in the following areas:

• Amount of system concurrency and number of nodes
• Teradata Database features
• Teradata Database software applications that are available at no additional cost
• Level of customer support
For a list of what is offered in each tier, see Teradata Database License Tiers.

Teradata Database License Tiers

Teradata Database on VMware offers license tiers that include the rights to use the software listed.
Teradata Database on VMware Base, Advanced, and Enterprise come with Teradata Premier Software
Support. You can apply software updates to the Teradata software on these tiers and access TaYS for
assistance.
The Developer tier is free and is for evaluation purposes. When it is deployed, it operates as a fully functional
instance of the configured Teradata Database. You cannot upgrade the Teradata software, apply software
updates, or access TaYS with this tier. To use a later version of Developer, you must install a new version,
resulting in a loss of data. Community-driven customer support is available for Developer at http://
community.teradata.com/tdvm.

Developer Base Advanced Enterprise

Customer Support
Support type Community Premier Premier Premier
Scalability
System concurrency limit 2 15 Unlimited Unlimited
Node limit 2 128 128 128
AMPs/vNode 4 6 to 12 6 to 12 6 to 12
Maximum database size 6 TB Unlimited Unlimited Unlimited
Database Features
Columnar ● ● ● ●
Temporal ● ● ● ●

Teradata Database on VMware Getting Started Guide, Deployer Release 3.01 9

Chapter 1: Overview

Developer Base Advanced Enterprise

Row-level Security ● ● ● ●
Secure Zones ● ● ● ●
Workload Management TIWM TASM
Applications Available at No Additional Cost
Teradata Ecosystem Manager ● ● ● ●
Teradata Data Stream Controller (a ● ● ● ●
component of Teradata Data Stream
Utility)
Teradata REST Services ● ● ● ●
Teradata Server Management ● ● ● ●
Teradata Studio ● ● ● ●
Teradata Tools and Utilities, ● ● ● ●
including Teradata Parallel
Transporter
Teradata Viewpoint (Single ● ● ● ●
Teradata System)

VMware and Teradata Terminology

You should be familiar with the following terms regarding VMware and virtualization.
VMware or Virtualization Term Description
VMware vSphere VMware vSphere as a suite of products that provides network
virtualization services to hosts and VMs. vSphere links VMs to each
other within a single host, connects VMs to the physical network, joins
VMkernel services to the physical network, and provides networking
for the management interface which runs management services for
vSphere hosts.
VMware vCenter vCenter is a server that is installed on either Linux or Windows and
provides central management of VMs and ESXi hosts.
VMware ESXi ESXi is also a component of vSphere. It is a hypervisor that defines
processor, memory, storage, and networking resources into multiple
VMs that run applications.
ESXi is installed directly on the server hardware, inserting a
virtualization layer between the hardware and the operating system.
ESXi partitions a physical server (pNode) into multiple secure VMs
(vNodes) that run on the same physical server. Each VM represents a
complete system, with processors, memory, networking, storage, and
BIOS so that the operating system and applications can be installed

10 Teradata Database on VMware Getting Started Guide, Deployer Release 3.01

 Chapter 1: Overview

VMware or Virtualization Term Description

and run in the VM without modification. VMs are also completely
isolated from each other by the virtualization layer to prevent a crash
or configuration error in one VM from affecting the others.
vCPU A virtual CPU corresponds to one hyperthreaded core. Teradata
Database on VMware requires hyperthreading be enabled.
vSphere Virtual Switch The vSphere virtual switch lets you set up VM access switching from a
centralized interface so you can provision, administer, and monitor
virtual networking across multiple hosts and clusters.

You should understand the following Teradata terminology.

Teradata Terminology Description
Teradata Node A Teradata node requires three pieces of software: a
Trusted Parallel Application (TPA), Parallel
Database Extensions (PDE), and an operating
system. The Teradata Database is classified as a TPA.
Teradata nodes can be either physical or virtual.
Physical Node (pNode) A pNode is a physical machine running in a data
center. Ensure all pNodes are connected identically
to allow vNode TPA instances to be deployed to any
ESXi host. One pNode corresponds to a single ESXi
host or to the actual hardware, such as to one Dell
720, 730, and so on. During deployment, CPUs and
memory are checked to ensure they are the same on
all pNodes containing vNode TPA instances.
Virtual Node (vNode) A vNode is a virtual node running on a pNode in a
data center. pNodes can have multiple vNodes, as
defined through the ESXi hypervisor. A single
vNode corresponds to a single VM that runs
Teradata software.

Requirements
The minimum requirements for hardware, Teradata software, and virtualization software are described in
the table below.
Requirements

Component Minimum Requirements (unless noted)

Developer Tier • Maximum Node Count: 2
• System Concurrency Limit: 2
• AMPs/vNode: 4
• Maximum Database Size: 6 TB

Teradata Database on VMware Getting Started Guide, Deployer Release 3.01 11

Chapter 1: Overview

Component Minimum Requirements (unless noted)

vCPU • Teradata Database (TPA): 2 or 4
By default, there are 2. You can change it to 4 by setting the
PhysicalCoresPerTPA to 2 in the common.IT.properties.json file. See
The common.IT.properties.json File.
• Data Stream Controller: 4
• Teradata Ecosystem Manager: 4
• Teradata Viewpoint: 1
• Server Management: 2

Memory • Teradata Database (TPA): 8 GiB

• Data Stream Controller: 16 GiB
• Teradata Ecosystem Manager: 32 GB
• Teradata Viewpoint: 16 GiB
• Server Management (CMIC): 16 GiB

Datastores for database Minimum: 1 datastore where all the TPA VMs are deployed on the same
storage datastore. Maximum: 2 datastores where the maximum number (2) of TPA
VMs are deployed on different datastores. For each TPA VM, all of its virtual
disks for the database are created on the same datastore where the VM is
deployed.
Datastore formatting VMFS 5 file system
Datastore space for Total size of all drives in each image:
template deployment
• Teradata Database (TPA): 200 GB
• Data Stream Controller: 500 GB
• Teradata Ecosystem Manager: 500 GB
• Teradata Viewpoint: 450 GB
• Server Management (CMIC): 26 GB

RAID RAID-1 LUNs recommended.

Server Dell PowerEdge R720xd/R730xd, or an HP Gen9 or similar system.
Hyper-threading (HT) must be enabled.
Network • BYNET: Two 10 GB networks to support redundancy
• Server Management: Two 10 GB separate (isolated) physical networks for
CMIC connectivity
• DSC: 10 GB separate network

VM deployment sizes • Teradata Database (TPA): 200 GB (187 GiB)

• Data Stream Controller: 500 GB
• Teradata Ecosystem Manager: 500 GB
• Server Management (CMIC): 26 GB
• Teradata Viewpoint: 456 GB

VMware ESXi ESXi 5.5 release 2 and later

12 Teradata Database on VMware Getting Started Guide, Deployer Release 3.01

 Chapter 1: Overview

Component Minimum Requirements (unless noted)

VMware licensing A full VMware vSphere 6.0 license or VMware vSphere Essentials 6.0 license for
at least one physical CPU (unlimited cores per CPU)
VMware vCenter vCenter 5.5 release 2 and later
VMware vSphere Client • VMware vSphere Client version 5.5 release 2 and later, using the Mozilla
Firefox Extended Support Release (ESR) Web browser. Other browsers may
not work properly with the VMware vSphere Client.
• Server:
∘ 64 bit Windows Server 2012 R2
∘ 64 bit Windows Server 2008 R2 SP1
• Workstation:
∘ 64 bit Windows 8.1
∘ 64 bit Windows 7 SP1

VMware vSphere One vSphere standard vSwitch for public network.

vSwitches
Note:
One extra vSphere standard vSwitch for DSC network.

PowerCLI • PowerCLI 5.5 and later

• Windows .Net Framework 4.5
• Windows PowerShell 4 and later
• Requires either a Windows workstation or laptop to run PowerCLI against
the vCenter

VMware Administrator Privileges

You must have VMware administrator privileges to install and configure Teradata Database on VMware
software. If you do not have full VMware administrator privileges, your VMware administrator must set the
following minimum permissions in vCenter for you, as an individual user, or for your role:
Datastore.AllocateSpace
Network.Assign
Resource.AssignVMToPool
System.Anonymous
System.Read
System.View
VirtualMachine.Config.AddNewDisk
VirtualMachine.Config.AddRemoveDevice
VirtualMachine.Config.CPUCount
VirtualMachine.Config.EditDevice
VirtualMachine.Config.Memory
VirtualMachine.Config.Resource
VirtualMachine.Config.Settings
VirtualMachine.GuestOperations.Execute

Teradata Database on VMware Getting Started Guide, Deployer Release 3.01 13

Chapter 1: Overview

VirtualMachine.GuestOperations.Modify
VirtualMachine.GuestOperations.Query
VirtualMachine.Inventory.CreateFromExisting
VirtualMachine.Inventory.Delete
VirtualMachine.Interact.PowerOff
VirtualMachine.Interact.PowerOn
VirtualMachine.Interact.Reset
VirtualMachine.Provisioning.DeployTemplate
VirtualMachine.Provisioning.MarkAsTemplate

Database Sizing
The total size of the Teradata Database system is (Size of DBS Virtual Disks in GB) * 2 (because there are two
DBS virtual disks in a TPA node). The maximum database size allowed is 6144 GB.

Note:
You can have up to two TPA nodes.

Network Considerations
The Developer Tier supports both static and DHCP network protocols. If you select DHCP and the vCenter
server has DHCP not configured with the default gateway, you must input the gateway and
public_submask properties in the common.IT.properties.json file.
Teradata Database on VMware supports local virtual switches so each ESXi host must have local virtual
switches for the BYNET, Server Management VM, and DSC.

Note:
The DSC virtual switch must have maximum transmit unit (MTU) value of 9000.

Note:
The Server Management virtual switch must have maximum transmit (MTU) value of 1500.

Memory Considerations
The Developer tier requires 8 GB of memory by default and cannot be altered in the Developer tier
deployment executable file.
If deploying additional software, increase memory as follows:
Deploying Additional Memory (GB)
DSC 16
Teradata Ecosystem Manager 32
Server Management 16
Teradata Viewpoint 16

14 Teradata Database on VMware Getting Started Guide, Deployer Release 3.01

 CHAPTER 2
Preparing for Installation

Installation Components
Teradata Database on VMware installation components consist of templates, property files, text files, and a
deployment executable file.
• Required templates contain the Teradata Database and underlying operating system.
• Optional templates contain Viewpoint and its underlying operating system, DSC, Ecosystem Manager,
and Server Management.
• Templates are ready to use and include defaults for disk space and configuration, I/O, network
connections, AMPs, and memory. By default, there are 4 AMPs per node, managing 2 pdisks.
• The properties files define configuration settings for the overall Teradata Database on VMware
environment and the specific virtual machines.
• An executable file deploys the Teradata VM based on the configuration information in the property files.

Note:
After the database is deployed, the only way to change settings is to run the removevms command
and run the deploy command again.
• Text files are used in time zone settings.
To download the software, go to https://downloads.teradata.com.

Templates
You will use Teradata Database on VMware templates to create a VM instance.
When you download these templates, you can put them in the vCenter or in a local folder on your desktop
PC. It is preferable to deploy your templates from vCenter because it will be faster. If you deploy from your
desktop PC you will be constrained by the connection to your data center.
The download file names listed below are appended with 14 numbers, representing the year (4 digits),
month (2 digits), day (2 digits), hours (2 digits), minutes (2 digits), and seconds (2 digits) when the template
was created by Teradata.

Type Download File Name Default Configuration of

the Template
Teradata Database Teradata_Database_16.10.00.03_SLES11_SP3_on_VMware • 1 virtual core
and Operating Teradata_Database_15.10.06.03_SLES11_SP3_on_VMware • 8 GB RAM
System
• FSG cache setting: 90%
• 187 GB operating
system disk

Teradata Database on VMware Getting Started Guide, Deployer Release 3.01 15

Chapter 2: Preparing for Installation

Type Download File Name Default Configuration of

the Template
Teradata Teradata_Viewpoint_16.10.00.00_SLES11_SP3_on_VMware • 1 virtual core
Viewpoint and • 16 GB RAM
Operating System
• 187 GB operating
system disk
• 256 GB data disk

Data Stream Teradata_DSC_16.10.00.00_SLES11_SP3_on_VMware • 4 virtual cores

Controller • 16 GB RAM
• 3 virtual disks: one 187
GB operating system
disk and two 150 GB for
the DSC repository.

Teradata Teradata_EM_16.10.00.00_SLES11_SP3_on_VMware • 4 virtual cores

Ecosystem • 32 GB RAM
Manager
• 3 virtual disks: one 187
GB operating system
disk and two 150 GB for
the EM repository.

Server Teradata_CMIC_12.05.03.00_SLES11_SP3_on_VMware • 1 virtual core

Management • 16 GB RAM
• 26 GB virtual disk

Properties Files
Properties File Name Description
common.IT.properties.json Defines the VMware vSphere configuration settings common
across Teradata Database on VMware VMs. Configure the values
in this file each time something in the virtual environment
changes.
If you have multiple VMs on one VMware vSphere server, the
common.IT.properties.json properties file is unique for
each VM.
node.IT.properties.json Defines the specifications needed by the deployment executable
file to install and configure the VMs. Define the values in this file
for each deployment.

Deployment Executable File

An executable file deploys the Teradata VM based on the configuration information in the property files.

16 Teradata Database on VMware Getting Started Guide, Deployer Release 3.01

 Chapter 2: Preparing for Installation

Note:
If you receive an iex message when running this executable file, ignore the message as it should not
cause an issue.

Script Description
tdc.deploy.exe Parses the common.IT.properties.json and
node.IT.properties.json files to ensure all required values are
present and correctly formatted, validates settings, and launches each
subsequent command to deploy the components for the Teradata VM.

Installation Process
Since Developer is free, you cannot upgrade the Teradata software, apply software updates, or access TaYS
with this tier. Community-driven customer support is available for Developer at http://
community.teradata.com/tdvm.
Decide if you want to install other Teradata applications. For information, see Installing and Configuring
Other Teradata Applications.
1. Prepare the host node, including configuring virtual disks and network connections, and the script to
create the datastores.
2. Download the Teradata Database on VMware Developer Tier installation components from Teradata
Downloads:
http://downloads.teradata.com/
3. If this is a new, single-server installation, install the vSphere kit.
4. If this is a new installation, set PowerCLI execution privileges.
5. Decide the location of the templates: vCenter or in the local system. You must prepare the templates
before the initial deployment. See Preparing the ova Templates or Preparing the Templates in the Local
System. For the quickest deployment, choose the vCenter.
6. If this is a new installation, or if your VMware environment has changed, edit the values in the
common.IT.properties.json file.
7. Edit the node.IT.properties.json file with the values for the specific Teradata Virtual Machine
installation.
8. Run the deployment executable file to install Teradata Database, Teradata Viewpoint, and DSC.
9. If you plan to use DSC, configure it.
10. If necessary, start the database.
11. Confirm that the Teradata Database installed correctly.
12. Confirm that Viewpoint installed correctly.
13. If you want the virtual machine to communicate with a mainframe computer, establish the connection.

vSphere
Before deploying any Teradata VM in a single-server environment, you must install the vSphere kit, which
includes an operational vCenter Server. Installation and configuration of all VMware software, including
vSphere and vCenter, is the responsibility of your VMware administrator.

Teradata Database on VMware Getting Started Guide, Deployer Release 3.01 17

Chapter 2: Preparing for Installation

Running PowerCLI as Administrator

The PowerCLI shell must be run as a user with administrator privileges.
1. Navigate to VMware vSphere PowerCLI from your Desktop or the Start menu.
2. Right-click VMware vSphere PowerCLI and select Run as administrator.
3. If a User Account Control prompt appears, click Accept.

Setting PowerCLI Execution Privileges

If this is a new installation of PowerCLI, you must set the PowerCLI execution privileges to allow the
unsigned but Teradata-certified deployment executable file to be run.
1. In a PowerCLI command window, run: Set-ExecutionPolicy -ExecutionPolicy bypass
2. If you are prompted to confirm the change, enter Y or A.
3. If you are running this command for the first time, restart the PowerCLI terminal.

Database Option Management

The Teradata private cloud offers the same features that come with an on-premises Teradata Database
system with a couple of exceptions.

Teradata Database Features

Teradata Database on VMware offers many Teradata Database features including, but not limited to, those
listed in this topic. Not all features listed below are included in all Teradata Database tiers. See Teradata
Database License Tiers. Although the package is included in the Teradata Database VM, you still need to
install and configure it.
The following terms are used in the table below:
• Automatic indicates you do not have to install or configure the feature and can begin using the feature
after a Teradata Database VM is launched.
• Manual indicates you must install and configure the feature using the Teradata Database documentation,
similar to on-premises systems. Features that require Teradata Customer Support to enable a feature are
noted.
Teradata Database features that are enabled by default and are automatically installed and configured are not
included in the table below. Fallback is mandatory for all Teradata Database license tiers and cannot be
disabled.
For information on how to install and configure the listed features, see the Documentation column.
Enabled by Installation and
Database Feature Description Default Configuration Documentation
Block-Level Stores data blocks in Yes Automatic Teradata Database
Compression compressed format to Although this Administration
save storage space and feature is disabled
improve performance.

18 Teradata Database on VMware Getting Started Guide, Deployer Release 3.01

 Chapter 2: Preparing for Installation

Enabled by Installation and

Database Feature Description Default Configuration Documentation
See Release Summary for by default for on-
Teradata Database 14.0. premises, it is
enabled by default
for private cloud.
Fallback Protects data in case of Yes Automatic SQL Data Definition
AMP vproc failure. Language Syntax and
See Introduction to Examples
Teradata.
Teradata Provides the ability to No Automatic SQL Data Definition
Columnar partition a table or join Must be Language Syntax and
index by column. configured. Examples
See Release Summary for
Teradata Database 14.0.
Teradata Speeds query No Manual • Utilities
Intelligent performance and Contact Teradata Must be • Teradata Intelligent
Memory maximizes system Customer Support configured. Memory Orange Book
memory by ensuring the to enable. available from https://
most frequently used data tays.teradata.com
is kept in memory.
See Release Summary for
Teradata Database 14.10
Teradata Row- If purchased, allows you No Automatic Security Administration
Level Security to restrict data access by
row in the Teradata
Database.
See Release Summary for
Teradata Database 14.0.
Teradata Secure Provides grouping of user No Automatic Security Administration
Zones and database hierarchies
into separate database
partitions with restriction
of user access to one or
more zones.
See Release Summary for
Teradata Database 15.10.
Teradata Provides built-in No Manual Temporal Table Support
Temporal capabilities that are Enable at the time
required in a temporal you deploy.
database management This feature is
system. available only for
Base, Advanced,
and Enterprise
tiers.

Teradata Database on VMware Getting Started Guide, Deployer Release 3.01 19

Chapter 2: Preparing for Installation

Editing Property Files

Edit the common.IT.properties.json file only once unless something in your virtual environment
changes. Edit the node.IT.properties.json file before deploying each Teradata virtual machine.
1. In a text or JSON editor, open and update the properties file you need to edit.
The files are in C:\mylocation\Teradata_Deployer\Properties.
2. Save the file.

The common.IT.properties.json File

The common.IT.properties.json file defines the VMware vSphere configuration settings common
across all Teradata Database on VMware deployments. Configure the settings in this file each time
something in the virtual environment changes.
Unless otherwise indicated, all property settings are required.
Property Category Properties Description
Teradata System TDsystemname The name of the Teradata System.
Name
Domain Setting domain The domain of the system being deployed which will be
placed into the /etc/hosts file.
Example:
domain:corp.company.com
Public Virtual public_vswitch The physical adapter with port group for the virtual
Switches network. The default setting is VM Network.
Example:
public_vswitch:VM Network
BYNET Virtual byn_vswitch1 The labels of the BYNET switches. The first is required
Switches byn_vswitch2 in MPP systems. The second is for redundancy and
performance in MPP systems. This setting is the name
specified when you created the vSwitch in vSphere. The
setting should be empty for single-node systems.
CMIC Virtual cmic_vswitch1 The labels of the server management switches. These
Switches cmic_vswitch2 are only used in MPP systems with server management.
The second is for redundancy and performance in MPP
systems. This setting is the name specified when you
created the vSwitch in vSphere.
DSC Virtual dsu_vswitch The label of the DSC switch. This setting is the name
Switch specified when you created the vSwitch in vSphere.
Public Submask public_submask The public submask name in dot-decimal notation.
Setting Example:
public_submask:192.168.253.0
Gateway Setting gateway The gateway name or IP address.
Example:

20 Teradata Database on VMware Getting Started Guide, Deployer Release 3.01

 Chapter 2: Preparing for Installation

Property Category Properties Description

gateway:10.26.23.254
Domain Name dns1 The DNS name or IP address.
System Settings dns2 Examples:
dns1:192.168.0.256
[Optional] dns2:192.168.1.256
External NTP ntp1 The host name or IP address of the ntp1 server is
Server Settings ntp2 required, however the ntp2 server is optional.
Examples:
ntp1:time00.company.com
ntp2:time01.company.com
You must configure the NTP servers if you plan to use
the Temporal feature.
Time Zone Setting OSTimeZone [Optional] The time zone of the VM. Enter either a
fixed time zone displacement from GMT or the time
zone file name. See the file
LinuxTimeZoneStrings.txt for the valid settings
for OSTimeZone.
If you are not enabling Temporal, the database time
zone syncs with the operating system.
The default time zone is US/Pacific.
Examples:
OSTimeZone=GMT+11
OSTimeZone=US/Eastern
For additional Teradata time zone information, see
Temporal Time Zone Strings.
Physical Disk pdiskSizeGB The size of the Teradata Database system pdisks.
Settings Example:
pdiskSizeGB:800
Temporal Settings Temporal If you plan to use Temporal, change the setting to
TemporalDaylightSavings true. If you do not plan to use it, accept the default of
TemporalTimeDateWZControl false. Refer to Temporal Settings.
TemporalTimeZoneHour You must enable Temporal before deployment. If you
did not enable it before deployment, you must redeploy
TemporalTimeZoneMinute
the VM to enable it.
TemporalTimeZoneString
Since Developer is free, no Teradata Customer Support
is available.
Example:
Temporal:false
TemporalDaylightSavings:false
TemporalTimeDateWZControl:0
TemporalTimeZoneHour:0
TemporalTimeZoneMinute:0
TemporalTimeZoneString:America Pacific

Teradata Database on VMware Getting Started Guide, Deployer Release 3.01 21

Chapter 2: Preparing for Installation

Property Category Properties Description

Other Teradata SecureZones [Optional] Columnar, Row Level Security, and Secure
Database Feature RowLevelSecurity Zones are Teradata Database features that can be
Settings Columnar enabled by setting it to true. If you do not plan to use
a feature, accept the default of false. Columnar must
be purchased to be enabled.

Note:
Secure Zones is supported on Teradata Database
15.10 and later.

Mainframe MainframeLHID The logical Host ID for mainframe connectivity. The

Settings default is -1 to indicate the deployed system will not
connect to a mainframe.
Example:
MainframeLHID:-1
Folder Setting Folder Folder name where the VM is being deployed on the
vSphere server.
IP Address Setting IPAddressSetting Indicates whether to use a static or dynamic IP address.
For a two node MPP deployment, the IP address must
be static.

Sample common.IT.properties.json File

Use the following sample common.IT.properties.json file as a template for creating your own. Replace
the sample data after the colon (:) with your own.
{
"TDsystemname": "",
"domain": "labs.company-domain.com",
"public_vswitch": "VM Network",
"byn_vswitch1": "byn_vswitch1",
"byn_vswitch2": "byn_vswitch2",
"cmic_vswitch1": "cmic_vswitch1",
"cmic_vswitch2": "cmic_vswitch2",
"dsu_vswitch": "dsu_vswitch",
"public_submask": "255.255.254.0",
"gateway": "10.25.29.254",
"dns1": "153.64.251.200",
"dns2": "153.65.8.10",
"ntp1": "time00.company-domain.com",
"ntp2": "time01.company-domain.com",
"OSTimeZone": "US/Eastern",
"pdiskSizeGB": "800",
"Temporal": "FALSE",
"TemporalDaylightSavings": "FALSE",
"TemporalTimeDateWZControl": 0,
"TemporalTimeZoneHour": 0,
"TemporalTimeZoneMinute": 0,
"TemporalTimeZoneString": "America Pacific",
"SecureZones": "FALSE",

22 Teradata Database on VMware Getting Started Guide, Deployer Release 3.01

 Chapter 2: Preparing for Installation

"RowLevelSecurity": "FALSE",
"Columnar": "FALSE",
"MainframeLHID":"-1",
"Folder":"",
"IPAddressSetting":"static"
}

The node.IT.properties.json File

The node.IT.properties.json file contains the specifications needed by the deployment executable file
to install and configure a Teradata Database or Teradata Viewpoint VM.
Set the values in the node.IT.properties.json file for each Teradata Database on VMware
deployment.
Unless otherwise indicated, all property settings are required.

Property Properties Description

Category
VMware Host ESXiHost Name of the VMware host. For example:
Details ESXiHost:esxhost01.corp.company.com
ESXi Datastore OS_Datastore ESXi datastore where this VM instance will reside. For example:
esxhost01.datastore
All TPA VMs are restricted to share the same ESXi host in the Developer
tier.
This datastore is only used for the VM instances and for Teradata
Database storage.
VM Name vmName Name of the Teradata Database, Teradata Viewpoint, DSC, Teradata
Ecosystem Manager, and Server Management.
Examples:
vmName:TD-DBS
vmName:TD-VP
vmName:TD-DSC
vmName:TD-EM
vmName:TD-CMIC
Ethernet eth0 Use only static IP4 addresses.
Network If IPAddressSetting is dhcp, eth0 is not required.
VM Types to vmType Virtual machine type of the Teradata Database, Teradata Viewpoint, DSC,
Deploy Teradata Ecosystem Manager, and Server Management image to deploy.
Examples:
vmType:tpa for a database VM
vmType:vp for a Viewpoint VM
vmType:dsu for a DSC VM
vmType:em for an Ecosystem Manager VM
vmType:cmic for a Server Management VM
Template File Template Refer to one of the following for the Windows file path to the template
Path location:

Teradata Database on VMware Getting Started Guide, Deployer Release 3.01 23

Chapter 2: Preparing for Installation

Property Properties Description

Category

• vCenter: Preparing the ova Templates

• Local system: Preparing the Templates in the Local System

Preparing the ova Templates

Prerequisite
Check that you have installed the VMware Client Integration Plug-in on your workstation. Access the
VMware Knowledge Base and search for Installing VMware Client Integration Plug-in. If you have the
plug-in installed, ensure it has been upgraded to the latest version.
Before initially deploying the VM, this procedure describes how to upload the .ova file to the vCenter and
convert it to a template. Having the template reside on vCenter enables the VM to quickly deploy. Having
the template reside on your local system takes the VM longer to deploy.
For best results, use either Internet Explorer 11 or Google Chrome as your browser.
1. Log in to the vSphere Client using your login credentials.
2. Under Inventories, select Hosts and Clusters to see all the ESXi hosts managed by the vCenter server.
3. Right-click the ESXi host name on which you want to clone the VM, and select All vCenter Actions >
Deploy OVF Template.
If menus differ, look under All vCenter Actions.
4. From the Deploy OVF Template dialog box, do the following to begin the cloning process:
a) Under Select source, select Local file, then click Browse and go to the directory containing the .ova
file that you want to clone.
For example, C:\powercli6\templates
\SP3\Teradata_Database_16.10.xx.xx_SLES11_SP3_on_VMware_20170707125811.ova
b) Click Next.
c) Under Review details, verify the .ova file, and click Next.
d) Under Select name and folder, select a folder or datacenter in your vCenter server in which to clone
your VM, modify the name of the VM to make it unique (for example,
Teradata_Database_16.10.xx.xx_SLES11_SP3_on_VMware_20170707125811, where
16.10.xx.xx represents the template version you are using), and click Next.
e) Under Select storage, select the datastore on which you want to clone the VM, then select Thin
Provision from the Select virtual disk format menu if you want to speed up the clone time and save
space in the datastore, and click Next.
Leave the VM Storage Policy as is.
f) Verify all information, and click Finish to clone the template.
5. From the vSphere Client, do the following to verify the VM was cloned.
a) Click the ESXi host name on which you cloned the VM.
b) Click the Related Objects tab.
c) Click Virtual Machines.
d) Under the Name column, verify the VM is in a powered off state and the status is normal.
6. Under the Name column, right-click the VM you cloned, and select All vCenter Actions > Convert to
Template.
The VM is converted to a template.

24 Teradata Database on VMware Getting Started Guide, Deployer Release 3.01

 Chapter 2: Preparing for Installation

7. From the vSphere Client, do the following to verify the VM was converted to a template.
a) Click the ESXi host name on which you cloned the VM.
b) Click the Related Objects tab.
c) Click VM Templates.
d) Under the Name column, verify the template appears.
8. If you have a physical server with 2 to 7 pNodes, you must clone the template to another ESXi host.
a) From the Related Objects, click VM Templates.
b) Right-click the template name, and select All vCenter Actions > Clone to Template.
c) Under Select a name and folder, enter a name of the new template, then select a folder or datacenter
in your vCenter server to put the new template, and click Next.
d) Under Select a compute resource, select the ESXi host and its datastore to host the template, and click
Next.
e) Under Select storage, select the virtual disk format.
f) If you want to speed up the clone time and save space in the datastore, select Thin Provision from the
Select virtual disk format menu, and click Next.
g) Under Ready to complete, verify all information, and click Finish to clone the template.
Following are examples of deploying VMs from vCenter for either of the latest Teradata Database versions
and associated products.For the latest template version numbers, see Templates.
The template name in the examples below is the VM name you modified in step 4d.
{
"ESXiHost": "cs3097-05.labs.teradata.com",
"Datastore": "cs3097-05.datastore",
"vmName": "cobra26",
"eth0": "10.25.28.110",
"vmType": "tpa",
"Template": "Teradata_Database_16.10.xx.xx_SLES11_SP3_on_VMware_20170707235215"
}
{
"ESXiHost": "cs3097-05.labs.teradata.com",
"Datastore": "cs3097-05.datastore",
"vmName": "cobra26",
"eth0": "10.25.28.110",
"vmType": "tpa",
"Template": "Teradata_Database_15.10.xx.xx_SLES11_SP3_on_VMware_20170707235215"
}
{
"ESXiHost": "cs3097-05.labs.teradata.com",
"Datastore": "cs3097-05.datastore",
"vmName": "cobra26",
"eth0": "10.25.28.110",
"vmType": "vp",
"Template": "Teradata_Viewpoint_16.10.xx.xx_SLES11_SP3_on_VMware_20170707235215"
}
{
"ESXiHost": "cs3097-05.labs.teradata.com",
"Datastore": "cs3097-05.datastore",
"vmName": "cobra26",
"eth0": "10.25.28.110",
"vmType": "cmic",
"Template": "CMIC 12.05.xx.xx_SLES11_SP3_on_VMware_20170707235215"
}
{
"ESXiHost": "cs3097-05.labs.teradata.com",
"Datastore": "cs3097-05.datastore",
"vmName": "cobra26",
"eth0": "10.25.28.110",

Teradata Database on VMware Getting Started Guide, Deployer Release 3.01 25

Chapter 2: Preparing for Installation

"vmType": "dsu",
"Template": "Teradata_DSC_16.10.xx.xx_SLES11_SP3_on_VMware_20170707235215"
}
{
"ESXiHost": "cs3097-05.labs.teradata.com",
"Datastore": "cs3097-05.datastore",
"vmName": "cobra26",
"eth0": "10.25.28.110",
"vmType": "em",
"Template": "Teradata_EM_16.10.xx.xx_SLES11_SP3_on_VMware_20170707235215"
}

Preparing the Templates in the Local System

Before initially deploying the VM, you must prepare the templates in the local system. Having the template
reside on your local system takes the VM longer to deploy. Having the template reside on vCenter enables
the VM to deploy quicker.
Following are examples of deploying a Viewpoint template to the local system using either an absolute path
or relative path. For the latest template version numbers, see Templates.
• Local deployment using absolute path:
C:\Templates
\SP3Ph2\Teradata_Viewpoint_16.10.xx.xx_SLES11_SP3_on_VMware_xxxxxxxxxxxxxx.o
va
• Local deployment using relative path:
Teradata_Viewpoint_16.10.xx.xx_SLES11_SP3_on_VMware_xxxxxxxxxxxxxx.ova
The download file names listed above are appended with 14 numbers representing when the template was
created by Teradata: the year (4 digits), month (2 digits), day (2 digits), hours (2 digits), minutes (2 digits),
and seconds (2 digits).
Following is an example of deploying a Viewpoint virtual machine from your local machine using an
absolute path:
{
"ESXiHost": "cs3097-05.labs.teradata.com",
"Datastore": "cs3097-05.datastore",
"vmName": "cobra26",
"eth0": "10.25.28.110",
"vmType": "vp",
"Template": "C:\Templates
\Teradata_Viewpoint_16.10.xx.xx_SLES11_SP3_on_VMware_xxxxxxxxxxxxxx.ova"
}

Sample node.IT.properties.json Files

Use the following sample node.IT.properties.json file as a template for creating your own. Replace
the sample data after the colon (:) with your own. For the latest template version numbers, see Templates.
{
"ESXiHost": "esxi-14.labs.teradata.com",
"OS_Datastore": "esxi-14.datastore",
"vmName": "cobra1",
"eth0": "10.25.28.85",
"vmType": "tpa",
"Template":
"Teradata_Database_16.10.xx.xx_SLES11_SP3_on_VMware_20160803144556.cp14"

26 Teradata Database on VMware Getting Started Guide, Deployer Release 3.01

 Chapter 2: Preparing for Installation

},
{
"ESXiHost": "esxi-14.labs.teradata.com",
"OS_Datastore": "14_data02",
"vmName": "cobra4",
"eth0": "10.25.28.88",
"vmType": "vp",
"Template":
"Teradata_Viewpoint_16.10.xx.xx_SLES11_SP3_on_VMware_20160810184615"
}

Temporal Settings
To use the Temporal option with Teradata Database on VMware, ensure you configure your system
carefully to avoid issues with your data. For more information, see http://www.teradata.com/Resources/
White-Papers and search for Enabling the Temporal Data Warehouse.

Note:
After you enable the Temporal option, you cannot turn it off, so learn about this option before you
enable it. For more information, see Temporal Table Support.

To enable the Temporal option for a virtual machine, set the Temporal property value in the
node.IT.properties.json file to true, and then configure the other related properties based on your
preferred time options and whether you plan to restore data from another Teradata system.
To use the Temporal option, you must configure the NTP servers in the common.IT.properties.json
file.
Contact your Teradata Database Administrator for the DBSControl Flag values for the time zone variables.
To determine your settings in the properties file, use the following diagram and table. If you do not know
your TimeZoneString, see Teradata Database Administration.

Teradata Database on VMware Getting Started Guide, Deployer Release 3.01 27

Chapter 2: Preparing for Installation

The following information is important when enabling this feature:

• Temporal table support and Time Date with Zone Control by Database (TimeDateWZControl) are two
different features. However, when enabling Temporal table support, Time Date with Zone Control by
Database must also be enabled.
• If DaylightSavings is true, you must include a TimeZoneString.
• In the settings below, TimeZoneHour = 5 and TimeZoneMinute = 30 are examples. Enter the
number of hours and minutes your installation is offset from GMT.
• See Temporal Time Zone Strings for the valid values for TimeZoneString.
• In the table settings below, TimeZoneString = America Pacific is an example. Enter the time
zone for your system.
• In diagram scenario 5, you must copy the time zone settings from the DBSControl General Flags of the
Teradata system from which you are restoring data.

Note:
Scenario 5 reflects six possible variations, described below as 5a, 5b, 5c, 5d, 5e, and 5f.

Diagram Temporal Settings in the Property File DBS Control Setting Applied As
Scenario
1 Temporal:false 16. System TimeZone Hour:0
TimeDateWZControl:0 (Disabled) 17. System TimeZone Minute:0
DaylightSavings:false 18. System TimeZone String:Not Set
TimeZoneHour:0 57. TimeDateWZControl:0 (Disabled)
TimeZoneMinute:0
TimeZoneString:Not Set
2 Temporal:true 16. System TimeZone Hour:0
TimeDateWZControl:3 (Local) 17. System TimeZone Minute:0
DaylightSavings:false 18. System TimeZone String:Not Set

28 Teradata Database on VMware Getting Started Guide, Deployer Release 3.01

 Chapter 2: Preparing for Installation

Diagram Temporal Settings in the Property File DBS Control Setting Applied As
Scenario
TimeZoneHour:0 57. TimeDateWZControl:3 (Local)
TimeZoneMinute:0
TimeZoneString:Not Set
3 Temporal:true 16. System TimeZone Hour:5 (Example)
TimeDateWZControl:3 (Local) 17. System TimeZone Minute:0
DaylightSavings:false 18. System TimeZone String:Not Set
TimeZoneHour:5 (Example) 57. TimeDateWZControl:3 (Local)
TimeZoneMinute:30 (Example)
TimeZoneString:Not Set
4 Temporal:true 16. System TimeZone Hour:0
TimeDateWZControl:3 (Local) 17. System TimeZone Minute:0
DaylightSavings:true 18. System TimeZone String:America Pacific
TimeZoneHour:0 (Example)
TimeZoneMinute:0 57. TimeDateWZControl:3 (Local)
TimeZoneString:America Pacific (Example)
5a Temporal data is stored in the Teradata file 16. System TimeZone Hour:0
system in system local time. Daylight savings 17. System TimeZone Minute:0
is observed. 18. System TimeZone String:America Pacific
Temporal:true (Example)
TimeDateWZControl:3 (Local) 57. TimeDateWZControl:3 (Local)
DaylightSavings:true
TimeZoneHour:0
TimeZoneMinute:0
TimeZoneString:America Pacific (Example)
5b Temporal data is stored in the Teradata file 16. System TimeZone Hour:0
system in UTC time. Daylight savings is 17. System TimeZone Minute:0
observed. 18. System TimeZone String:America Pacific
Temporal:true (Example)
TimeDateWZControl:2 (UTC) 57. TimeDateWZControl:2 (UTC)
DaylightSavings:true
TimeZoneHour:0
TimeZoneMinute:0
TimeZoneString:America Pacific (Example)
5c Temporal data is stored in the Teradata file 16. System TimeZone Hour:0
system in system local time. Temporal data is 17. System TimeZone Minute:0
displayed in UTC time. Daylight savings is not 18. System TimeZone String:Not Set
observed. 57. TimeDateWZControl:3 (Local)
Temporal:true
TimeDateWZControl:3 (Local)
DaylightSavings:false
TimeZoneHour:0
TimeZoneMinute:0
TimeZoneString:Not Set

Teradata Database on VMware Getting Started Guide, Deployer Release 3.01 29

Chapter 2: Preparing for Installation

Diagram Temporal Settings in the Property File DBS Control Setting Applied As
Scenario
5d Temporal data is stored in the Teradata file 16. System TimeZone Hour:0
system in UTC time. Temporal data is 17. System TimeZone Minute:0
displayed in UTC time. Daylight savings is not 18. System TimeZone String:Not Set
observed. 57. TimeDateWZControl:2 (UTC)
Temporal:true
TimeDateWZControl:2 (UTC)
DaylightSavings:false
TimeZoneHour:0
TimeZoneMinute:0
TimeZoneString:Not Set
5e Temporal data is stored in the Teradata file 16. System TimeZone Hour:5 (Example)
system in system local time. Daylight savings 17. System TimeZone Minute:30 (Example)
is not observed. Time offset from GMT is 18. System TimeZone String:Not Set
entered. 57. TimeDateWZControl:3 (Local)
Temporal:true
TimeDateWZControl:3 (Local)
DaylightSavings:false
TimeZoneHour:5 (Example)
TimeZoneMinute:30 (Example)
TimeZoneString:Not Set
5f Temporal data is stored in the Teradata file 16. System TimeZone Hour:5 (Example)
system in UTC time. Daylight savings is not 17. System TimeZone Minute:30 (Example)
observed. Time offset from GMT is entered. 18. System TimeZone String:Not Set
Temporal:true 57. TimeDateWZControl:2 (UTC)
TimeDateWZControl:2 (UTC)
DaylightSavings:false
TimeZoneHour:5 (Example)
TimeZoneMinute:30 (Example)
TimeZoneString:Not Set

30 Teradata Database on VMware Getting Started Guide, Deployer Release 3.01

 CHAPTER 3
Installing and Configuring Teradata
Database on VMware

Default Passwords
Notice:
For security purposes, we highly recommend default passwords be changed at the time you deploy
Teradata Database on VMware.

VM Type Account User Name Default Description

Password
TPA (Teradata Default OS User tvme iumb123 Default operating system user name
Database) and default password. Commands
must be run with sudo.
Root OS User root iumb123 Default operating system root user
name and default password if the
Security Hardening feature is
disabled in the Teradata Database.
Commands do not need to be run
with sudo.
Teradata Database dbc dbc Default Teradata Database user
User name and password.
EM Default OS User tvme iumb123 Default operating system user name
(Ecosystem and default password if the Security
Manager) Hardening feature is enabled in the
Teradata Database. Commands must
be run with sudo.
Root OS User root iumb123 Default operating system root user
name and default password if the
Security Hardening feature is
disabled in the Teradata Database.
Commands do not need to be run
with sudo.
VP Default OS User tvme iumb123 Default operating system user name
(Viewpoint) and default password. Commands
must be run with sudo.

Teradata Database on VMware Getting Started Guide, Deployer Release 3.01 31

Chapter 3: Installing and Configuring Teradata Database on VMware

VM Type Account User Name Default Description

Password
Root OS User root iumb123 Default operating system root user
name and default password if the
Security Hardening feature is
disabled in the Teradata Database.
Commands do not need to be run
with sudo.
Viewpoint Database viewpoint viewpoint Default Viewpoint user name and
User password created on the database.
Viewpoint logs into the database
with these credentials.
Viewpoint Admin admin teradata Default Viewpoint administrator
User user name and password.
DSC Default OS User tvme iumb123 Default operating system user name
and default password. Commands
must be run with sudo.
Root OS User root iumb123 Default operating system root user
name and default password if the
Security Hardening feature is
disabled in the Teradata Database.
Commands do not need to be run
with sudo.
Admin Teradata dbc dbc#Bar! Default Teradata Administrative
User user.
DSC Repository DSUADMIN dsu#Bar! Default Teradata Database user
User name and password. It is the same
default user name and password for a
superuser.
DSC Repository bar dsu#Bar! Default user name and password for
User the DSC repository user. Used for
Create, Read, Update and Delete
(CRUD) operations on BAR.
DSC Repository barbackup dsu#Bar! Default user name and password for
User the backup DSC repository user.
Used for Create, Read, Update and
Delete (CRUD) operations on
BARBACKUP.
DSC OS User dscuser Default operating system dscuser
user name.
CMIC (Server Root OS User root iumb123 Operating system root user name
Management) and default password.
CMIC OS User cmic smcmic Operating system cmic user name
and default password.

32 Teradata Database on VMware Getting Started Guide, Deployer Release 3.01

 Chapter 3: Installing and Configuring Teradata Database on VMware

VM Type Account User Name Default Description

Password
Server Management root iumb123 Server Management Client root user
Client Root User name and default password.

To update the passwords for the DSC Repository for metadata, see Updating Passwords in the Data Stream
Utility Installation, Configuration, and Upgrade Guide for Customers.

Deploying Teradata Database on VMware

Prerequisite
Before starting this procedure, do the following:
• Ensure all required values in the properties files are present and correctly formatted as described in The
common.IT.properties.json File and The node.IT.properties.json File.

1. Open a VMware vSphere PowerCLI shell version 5.5 or later.

2. Type the following command from the PowerCLI prompt to connect to the vCenter that manages the
ESXi hosts that will be running the Teradata Database VMs:
connect-VIServer -server vCenter.server.name
3. Navigate to the directory containing the Teradata Database on VMware deployment executable file
(C:\mylocation\Teradata_Deployer\).
4. [Optional] For troubleshooting purposes, make copies of the common.IT.properties.json and
node.IT.properties.json properties files, label them according to the system to be deployed, and
then save them.
5. Run tdc.deploy.exe, using the properties files originally used to deploy the VMs.
6. At the prompt, type deploy, and press Enter.
a) Select the Common Properties file, and press Enter.
b) Select the Node Properties file, and press Enter.
The executable file connects to the vCenter server and validates the information in the properties files.
When validation is successful, the executable file deploys the selected templates, and configures the VMs
based on the values in the properties files.
7. If a message warns you that running scripts is disabled, you must set the execution privileges, then
proceed to the next step.
See Setting PowerCLI Execution Privileges.
8. Review the information and do one of the following:
• If it is correct, press y.
• If the information is incorrect, edit the properties files and re-run the deployment executable file.
If there are no errors, the VM deploys. The deployment executable file is re-entrant, meaning if errors occur,
they can be fixed and the executable runs all states again. Action is only taken as needed.
Postrequisite
After the VM deploys, complete the applicable procedures under Deployment Verification.

Teradata Database on VMware Getting Started Guide, Deployer Release 3.01 33

Chapter 3: Installing and Configuring Teradata Database on VMware

DSC Configuration
Before using DSC on Teradata Database on VMware, do the following:
• Verify the DSC vSwitch is using at least a 10 GB network adapter.
• Verify the Teradata Viewpoint vNode is deployed at the same time as DSC.
• Verify a backup location is established. For more information, see the Data Stream Utility Installation,
Configuration, and Upgrade Guide for Customers and refer to Configuring Storage Devices and Ports.
• Ensure users in the Teradata Viewpoint role have been granted permission to use the BAR Setup portlet
as they will be using the portlet to configure the BAR system.
• After DSC has been deployed, Configure the DSC settings. See Configuring DSC Settings.
The TPA and DSC vNodes are preconfigured as media servers. We recommend using the media servers on
the TPA vNodes to back up and restore the Teradata Database, and use the media server on the DSC vNode
to back up and restore the DSC repository for metadata. For the default DSC credentials, see Default
Passwords.

Configuring DSC Settings

Contact your Teradata Viewpoint Administrator to ensure you have the appropriate permissions to
configure DSC settings in Teradata Viewpoint.
1. Add the systems by following the procedure Configuring Portlet Software, in the Data Stream Utility
Installation, Configuration, and Upgrade Guide for Customers.
In the Configuring a DSC section, the Broker IP of the DSC server can be found in the /etc/hosts file
in the DSC LAN section.
• The Broker Port is 61616
• The Broker Connectivity is TCP
• The DSC Server Name is 127.0.0.1.
SSL is not set up by default. Do not select Enable SSL over JMS Communication until it is configured.
In the Adding or Editing a Teradata System or Node section:
• The dsc_name is 127.0.0.1Repository.
2. Add a backup solution.
For more information, see Data Stream Utility Installation, Configuration, and Upgrade Guide for
Customers.
3. Add a target group by following the procedure Adding or Copying a Target Group, in the Data Stream
Utility Installation, Configuration, and Upgrade Guide for Customers.
4. Remove IPv6 IP addresses from media servers.
If buttons in the portlet do not display properly, clear your browser cache and refresh your browser.
a) Open the BAR Setup portlet.
b) From the Categories list, click Media Servers.
c) From the Media Servers list, select each media server and delete the IPv6 IP addresses beginning with
fe.
To ensure all traffic goes through the DSU network, remove all IP addresses except 39.42.xx.xxx.
d) Click Apply.

34 Teradata Database on VMware Getting Started Guide, Deployer Release 3.01

 Chapter 3: Installing and Configuring Teradata Database on VMware

You have completed the configuration settings for DSC. For more information about the settings in the BAR
Setup portlet, see Configuring Using Portlet Software in the Data Stream Utility Installation, Configuration,
and Upgrade Guide for Customers.
You can run backup, analyze, and restore jobs using the BAR Operations portlet in Teradata Viewpoint. For
more information, see the Teradata Data Stream Architecture User Guide.

Deployment Verification
After deploying a Teradata virtual machine, test the Teradata Database and, if applicable, Viewpoint.
Retain the log files to confirm your settings.

Starting the Database

The database starts automatically after deployment.
If the database does not start, start it manually: /etc/init.d/tpa start.

Logging On to the Database

After starting the database, log on.

Notice:
We strongly recommend immediately changing the database password.

Testing the Database

After deploying the database, verify the database is accessible and responsive.
1. Start BTEQ.
No additional installation is required. BTEQ is installed on the Teradata Database (TPA) node for
Teradata Database on VMware.
2. Using the default credentials, log on to the database.
3. Run select * from dbc.dbcinfo to see if the database is responding.
Sample result indicating response.
sel * from dbc.dbcinfo;
*** Query completed. 3 rows found. 2 columns returned.
*** Total elapsed time was 1 second.

InfoKey InfoData
–--------------------------------------
VERSION 16.10.xx.xx
RELEASE 16.10.xx.xx
LANGUAGE SUPPORT MODE Standard
4. If the database does not respond, access the server through SSH.

Teradata Database on VMware Getting Started Guide, Deployer Release 3.01 35

Chapter 3: Installing and Configuring Teradata Database on VMware

Testing Viewpoint
After deploying a Viewpoint VM, test if the deployment was successful by adding portlets, confirming data
displays, and confirming the system is healthy.
1. Log in to the Teradata Viewpoint portal.
2. Click Add Content.
3. Select the System Health, Node Resources, and the Query Monitor portlets, and click Add.
4. Confirm each of the portlets display data.
It may take a few minutes for the data collectors to provide the data that displays in the portlets.
5. Confirm the System Health portlet displays green to indicate the system is healthy and the deployment
was successful.
6. If the Viewpoint does not respond, ensure you have the correct IP address and, if so, access the server
through SSH.

Testing Ecosystem Manager

After deploying an Ecosystem Manager VM, you can verify that it is configured on the Viewpoint node.
1. Add the Ecosystem Manager portlet in Viewpoint.
2. In the Ecosystem Manager portlet click Servers and locate a row with the entry datacenter.
If you do not see a node you configured, you must redeploy.

Testing DSC
After deploying a DSC VM, you can verify the installation.
1. Refer to Verifying Installation in the Data Stream Utility Installation, Configuration, and Upgrade Guide
for Customers.

Testing Server Management

After deploying a Server Management (CMIC) VM, verify the installation in Server Management Client
(SMClient).
1. On the SMWeb Home page, click Server Management Client.
The SMClient displays system components in a hierarchical directory structure.
2. Expand Collective > Cabinet to view the Server Management nodes you configured.
If you do not see a node you configured, you must redeploy.

R for Data Analysis

The Teradata VM image includes packages allowing you to install and use R table operators for data analysis.
The following components must be installed before you can use R functionality with Teradata Database:
• R interpreter
• Fortran compiler

36 Teradata Database on VMware Getting Started Guide, Deployer Release 3.01

 Chapter 3: Installing and Configuring Teradata Database on VMware

• udfGPL library
The ExecR table operator is required and is used to execute R scripts. For more information, see Creating the
ExecR System Table Operator.
To apply innovative statistical techniques to analyze data stored in Teradata Database, install the R add-on
packages from the Comprehensive R Archive Network (CRAN). After they are installed, a new library (pkg)
can be used within an R script. For more information, see Installing Optional R Add-On Packages.
For additional information about installing R components and packages and using R, see SQL External
Routine Programming.

Verifying the Fortran Compiler Packages

Verify the VME ESXi TPA template has the Fortran compiler packages installed before using R
functionality.
1. Display the Fortran packages that are installed.
rpm -qa | grep fortran
2. Check the following packages are installed:
• gcc-fortran
• gcc43-fortran
• libgfortran43

Installing the R Interpreter

Prerequisite
You must have root privileges to access and install the .rpm.
You must install the R interpreter before using R functionality.
1. Type the following command to install the R interpreter:
psh rpm -U /var/opt/teradata/extras/R/R-3.2.1-1.x86_64.rpm

udfGPL Library Installation

The udfGPL library is automatically installed as part of the Teradata Database on VMware operating system
installation. The teradata-udfGPL package that matches your version of the Teradata Database system is
installed.
TDR is the R package interface between R and Teradata Database. Both TDR and the udfGPL library are
included in the teradata-udfGPL package. Each version of the Teradata Database system has a
compatible version of this package.

Creating the ExecR System Table Operator

The ExecR table operator is required and is used to execute R scripts.
1. Run the optional DipRTblOp DIP script to create the ExecR table operator.

Teradata Database on VMware Getting Started Guide, Deployer Release 3.01 37

Chapter 3: Installing and Configuring Teradata Database on VMware

Following is an example of how to run the DipRTblOp script from a Teradata node:
#cnsterm 6
Input Supervisor Command:
> start dip
Started 'dip' in window 1
Input Supervisor Command:
> ^C -- <control C>
#cnsterm 1
Attempting to connect to CNS...Completed
Type the password for user DBC or press the Enter key to quit:
> xxx
***Logon successfully completed.
Select one of the following DIP SQL scripts to execute:
(Press the Enter key to quit)
...
40. DIPRTBLOP - R Table Operator
> 40
Executing DIPRTBLOP
Please wait...
DIPRTBLOP is complete
Please review the results in /var/opt/teradata/tdtemp/dip40.txt on node 1-1
Would you like to execute another DIP script (Y/N)?
> N
Exiting DIP...

Installing Optional R Add-On Packages

To apply innovative statistical techniques to analyze data stored in Teradata Database, you have the option
to install R add-on packages from Comprehensive R Archive Network (CRAN). After they are installed, a
new library called pkg can be used within an R script.
1. Go to http://cran.us.r-project.org/ to download the R add-on package from CRAN.
2. Put the downloaded R add-on package into the /tmp directory on the primary (PDN) node.
3. From the /tmp directory, run the td_installRaddon script.
/opt/teradata/PUTTools/misc/td_RTblop/td_installRaddon pkgname
The script wraps the file downloaded from the CRAN website into a PUT-installable .rpm file and places
the .rpm file in the current working directory which is /tmp.
4. Install the .rpm on all nodes using PUT or manually using rpm commands.
5. Copy the rpm to all nodes.
For MPP installations, put the package in the same common location on all nodes.
6. Run one of the following commands:
• Single-node system: rpm –ivh packagename.rpm
• MPP system: psh rpm –ivh directory/packagename.rpm
7. Using the R console, check if the package was installed correctly.

38 Teradata Database on VMware Getting Started Guide, Deployer Release 3.01

 Chapter 3: Installing and Configuring Teradata Database on VMware

Connecting with a Mainframe Computer

For more information on mainframe configuration, see Teradata Director Program Reference and Teradata
Tools and Utilities for IBM z/OS Installation Guide.
1. In the node.IT.properties.json file, enter the TDP logical host ID in the LHID field.
2. Add the vNodes to the appropriate MVS etc.hosts file in the following format:
HOST : ipaddr : vmnameNTCI n:: ::

Note:
There is no space between the VM name and the NP name. There is a space between the second and
third trailing colon.

ipaddr IP address of the VM

vm Name of the VM
NTCI n:: :: Representation of an Teradata network processor (NP) name

The following is an example of a three vNode system:

HOST : 123.12.123.123 : VMNAMEntci1:: ::
HOST : 123.12.123.124 : VMNAMEntci2:: ::
HOST : 123.12.123.125 : VMNAMEntci3:: ::
3. Edit the TDP Parm file to add the NP information.
The following is the syntax of a three vNode system:
CONFIG NP DATABASE vmname
CONFIG NP LHID logical host id
START NP1
START NP2
START NP3
4. Ping the VM from the mainframe to confirm the deployment using the following syntax:
For a single-node system:
tso ping vmname
For a MPP system, ping the individual nodes:
tso ping vmname1

Connecting with a Mainframe Computer after Installation

If you have already deployed a Teradata VM, you can execute a script to connect with a mainframe
computer.
1. Execute the configureTCHN.sh script on the deployed VM.
sh /var/opt/teradata/tvme/script/configureTCHN.sh tdpid=LHID
where LHID is the TDP logical host ID.

Teradata Database on VMware Getting Started Guide, Deployer Release 3.01 39

Chapter 3: Installing and Configuring Teradata Database on VMware

40 Teradata Database on VMware Getting Started Guide, Deployer Release 3.01

 CHAPTER 4
Installing and Configuring Other
Teradata Applications

Installing and Configuring Teradata Studio

1. Download the Teradata Studio package from https://downloads.teradata.com.
2. Install and configure the Teradata Studio package according to the Teradata Studio and Studio Express
Installation Guide.

Installing and Configuring Teradata Tools and

Utilities
TTU can be installed on VMs running a supported version of Linux or Windows, or on another system
running a supported operating system. For more information, see Teradata Tools and Utilities Supported
Platforms and Product Versions for 15.10 or later at http://www.info.teradata.com.
1. Ensure the Teradata Database on VMware setup process deployed the files for installing TTU.
Linux and Windows versions of the files are placed in /var/opt/teradata/TTU_pkgs.
2. Copy the TTU packages to the appropriate Linux or Windows virtual or physical machine where the
TTU software will be installed and used.
3. Install and configure the TTU package according to the instructions in the appropriate Teradata Tools
and Utilities Installation Guide at http://www.info.teradata.com.

Teradata Database on VMware Getting Started Guide, Deployer Release 3.01 41

Chapter 4: Installing and Configuring Other Teradata Applications

42 Teradata Database on VMware Getting Started Guide, Deployer Release 3.01

 APPENDIX A
Acronyms

Acronyms
Acronym Definition
AMP Access Module Processor
BAR Backup, Archive, and Restore
BTEQ Basic Teradata Query
BYNET Banyan Network (BYNET) Interconnect
COP Communications Processor
CRAN Comprehensive R Archive Network
CRUD Create, Read, Update, and Delete
DBC Database Computer
DBS Database System
DHCP Dynamic Host Configuration Protocol
DIP Database Initialization Program
DNS Domain Name System
DSC Teradata Data Stream Controller
DSU Teradata Data Stream Utility
ESXi Elastic Sky X integrated
GMT Greenwich Mean Time
HT Hyper-Threading
JMS Java Messaging Service
JSON JavaScript Object Notation
LHID Logical Host Identifier
LUN Logical Unit Number
MPP Massively Parallel Processing (Teradata Database multi-node system)
MTU Maximum Transmit Unit
MVS Multi-Value Compression
NP Network Processor

Teradata Database on VMware Getting Started Guide, Deployer Release 3.01 43

Appendix A: Acronyms

Acronym Definition
PDE Parallel Database Extensions
PDN Primary Distribution Node
PUT Teradata Parallel Upgrade Tool
RAID Redundant Array of Independent Disks
SLES SUSE Linux Enterprise Server
SSH Secure SHell
SSL Secure Sockets Layer
TaYS Teradata at Your Service
TCP Transmission Control Protocol
TDP Teradata Director Program
TDR Teradata R
TPA Teradata Parallel Application
TTU Teradata Tools and Utilities
UTC Coordinated Universal Time
VM Virtual Machine
VP Viewpoint

44 Teradata Database on VMware Getting Started Guide, Deployer Release 3.01

 APPENDIX B
Teradata Time Zones and Regions

Temporal Time Zone Strings

If you enabled the Temporal feature of Teradata Database and want to set the TimeZoneString, you can
enter one of the following:
GMT
GMT+1
GMT+10
GMT+11
GMT+11:30
GMT+12
GMT+13
GMT+14
GMT+2
GMT+3
GMT+3:30
GMT+4
GMT+4:30
GMT+5
GMT+5:30
GMT+5:45
GMT+6
GMT+6:30
GMT+7
GMT+8
GMT+8:45
GMT+9
GMT+9:30
GMT-1
GMT-10
GMT-11
GMT-2
GMT-3
GMT-4
GMT-5
GMT-6
GMT-6:30
GMT-7
GMT-8

Teradata Database on VMware Getting Started Guide, Deployer Release 3.01 45

Appendix B: Teradata Time Zones and Regions

Temporal Regions
If you have enabled the Temporal feature of Teradata Database and have set DaylightSavings to true,
you must enter one of the following time zone regions for your system (TimeZoneString):
Africa Egypt
Africa Morocco
Africa Namibia
America Alaska
America Aleutian
America Argentina
America Atlantic
America Brazil
America Central
America Chile
America Cuba
America Eastern
America Mountain
America Newfoundland
America Pacific
America Paraguay
America Uruguay
Asia Gaza
Asia Iran
Asia Iraq
Asia Irkutsk
Asia Israel
Asia Jordan
Asia Kamchatka
Asia Krasnoyarsk
Asia Lebanon
Asia Magadan
Asia Omsk
Asia Syria
Asia Vladivostok
Asia West Bank
Asia Yakutsk
Asia Yekaterinburg
Australia Central
Australia Eastern
Australia Western
Europe Central
Europe Eastern
Europe Kaliningrad
Europe Moscow
Europe Samara
Europe Western
Indian Mauritius
Mexico Central
Mexico Northwest
Mexico Pacific
Pacific New Zealand
Pacific Samoa

46 Teradata Database on VMware Getting Started Guide, Deployer Release 3.01

 APPENDIX C
Troubleshooting Teradata Database on
VMware

Node Failure Recovery

Node failure recovery depends on the type of failure. If the root disk fails, redeploy the VM. If you have lost a
Pdisk, rebuild the AMP. Community-driven customer support is available for Developer at http://
community.teradata.com/tdvm.

Rebuilding AMPs from Fallback

Prerequisite
Before you begin, assess if you can recover from fallback. If more than a single AMP in the same fallback
cluster is down, you cannot use this procedure.
1. SSH into one of the nodes.
2. Run vprocmanager.
3. Run the command status.
4. Look for AMPs marked as FATAL** and check the column Cluster/Host No.
If two AMPs with the same Cluster/Host No. are Fatal, then recovery using fallback is impossible. In the
following example, both AMPs in cluster 0, 3, 6, 9 are Fatal and are not recoverable.
SYSTEM NAME: MPP160 17/01/12
14:40:21
DBS LOGICAL CONFIGURATION
-------------------------
Rcv
Jrnl/
Vproc Rel. Node Can Crash Vproc Config Config Cluster/ Host TVS
Number Vproc# ID Move Count State Status Type Host No. Type
Vproc
------ ------ ------ ----- ----- ------- -------- ------ -------- -----
-----
0 1 1-01 Yes 0 FATAL** Online AMP 0 On
28671
1 2 1-01 Yes 0 FATAL** Online AMP 1 On
28671
2 3 1-01 Yes 0 FATAL** Online AMP 2 On
28671
3 4 1-01 Yes 0 FATAL** Online AMP 3 On
28671
4* 5 1-01 Yes 0 ONLINE Online AMP 4 On

Teradata Database on VMware Getting Started Guide, Deployer Release 3.01 47

Appendix C: Troubleshooting Teradata Database on VMware

28670
5 6 1-01 Yes 0 ONLINE Online AMP 5 On
28670
6 7 1-01 Yes 0 ONLINE Online AMP 6 On
28670
7 8 1-01 Yes 0 ONLINE Online AMP 7 On
28670
8 9 1-01 Yes 0 ONLINE Online AMP 8 On
28669
9 10 1-01 Yes 0 ONLINE Online AMP 9 On
28669
10 11 1-01 Yes 0 ONLINE Online AMP 10 On
28669
11 12 1-01 Yes 0 ONLINE Online AMP 11 On
28669
12 1 1-02 Yes 0 FATAL** Online AMP 0 On
28668
13 2 1-02 Yes 0 FATAL** Online AMP 3 On
28668
14 3 1-02 Yes 0 FATAL** Online AMP 6 On
28668
15 4 1-02 Yes 0 FATAL** Online AMP 9 On
28668
5. If recovery is possible in your Vsphere client, delete the failed Pdisks that corresponds to the fatal AMPs.
6. Run tdc.deploy.exe with the storage step using the deployed system's Node.IT.Properties and
Common.IT.Properties
This re-creates the removed Pdisks.

Note:
A copy of these two configs are located in /root/tvme on any of the nodes.
7. When the command finishes, run tdc-rebuild as the root user.
8. Enter your DBC account and password, then follow the prompts until the system is rebuilt.

Additional Properties for Customization

Additional properties can be added to the bottom of the common.IT.properties.json file for
troubleshooting purposes.

Note:
This information is intended for advanced users only. Use these properties only when necessary or when
instructed by Teradata as performance may be impacted.
common.IT.properties.json

Property Name Setting Description

cmic_submask Subnet mask When deploying a Server Management vNode, the subnet mask
address for the Server Management network is automatically calculated.
If there are issues with the automatic calculation, you can
override the calculated subnet mask by setting this property.
For example: 255.255.254.0. For assistance, contact your
network administrator.

48 Teradata Database on VMware Getting Started Guide, Deployer Release 3.01

 Appendix C: Troubleshooting Teradata Database on VMware

Property Name Setting Description

EsxiMemReservedMB Integer Changes the percentage of memory in MB reserved on the ESXi
host. The ESXi host requires some memory for the ESXi
Hypervisor. Different systems will have different requirements.
The default is 0.05 of the total memory, rounded down to a
multiple of 4.
EsxiCPUreserved 0.00 - 1.00 Changes the percentage of CPU reserved on the ESXi host. The
ESXi host requires some CPU power for the ESXi Hypervisor.
Different systems have different requirements. The default is
0.12.
NoLockdown • TRUE Teradata recommends keeping this setting as FALSE which is
• FALSE the default setting.
When set to TRUE, the VMs do not allow security changes to
be performed and also disables the root account when using
SSH.

Notice:
Setting this property to TRUE presents a high security risk.
Use with caution.

Deleting Datastore Files to Add Space

Depending on the type of storage used, there is a known VMware issue where free space on datastores does
not return the original amount of space after you delete a VM. You can manually delete files from the
datastore after you delete a VM.

Notice:
Do not delete files in the datastore that are not associated with the deleted VM. If you accidentally do,
those files cannot be recovered which can be destructive to your system. You can use third party tools to
help detect and delete orphaned VM files.

1. Open the vCenter Server or Virtual Infrastructure Client and log in.
2. Select a VM in your host inventory, located in the left panel.
3. Click the Related Objects tab and click Datastores.
4. Click a datastore from the list.
5. Click the Manage tab and click Files.
6. Highlight the files associated with the deleted VM, and click , located in the upper right corner.

Teradata Database on VMware Getting Started Guide, Deployer Release 3.01 49

Appendix C: Troubleshooting Teradata Database on VMware

The free space on the associated datastore is returned to the original amount prior to deleting the VM.

Incorrect Password Error

When deploying a new VM, you may get the following password error after the VM receives power.
"ERROR! The deployed system is not using the default password given.
The given new password is either blank or incorrect!"
If you entered your correct password, check the logs for an entry similar to the following:
Invoke-VMScript : 11/16/2015 6:32:01 PM Invoke-VMScript Unable to connect to
the remote server
The machine running the PowerCLI command and the ESXi host that contains the VMs may not be able to
communicate with each other. Check your network configuration, and then contact your Cloud
administrator for further assistance.

PowerCLI Warnings
PowerCLI may send warnings when accessing the deployment executable file. Depending on the warning, it
may not be relevant or cause issues. In vSphere PowerCLI 6.0 and later, the following warnings may appear
repeatedly, but should not cause an issue.

WARNING: The version of VMware Tools on VM version number is out of date and
may cause Invoke-VMScript to work improperly.

WARNING: Parameter ‘VM’ is obsolete. Passing multiple values to this parameter

is obsolete.

Resolving BAR Setup Connection Warnings

If you get a Connection to system unsuccessful warning message when adding a Teradata
Database system in the BAR Setup portlet, the DSC vNode may not be able to resolve the Teradata Database
COP entries. To resolve this issue, you can verify the servers and domains configured in Teradata Viewpoint
are also configured in the DSC vNode.
1. SSH into Teradata Viewpoint and extract the DNS servers and search domains.

50 Teradata Database on VMware Getting Started Guide, Deployer Release 3.01

 Appendix C: Troubleshooting Teradata Database on VMware

a) Extract the DNS servers:

# grep "NETCONFIG_DNS_STATIC_SERVERS" /etc/sysconfig/network/config
Sample output:
NETCONFIG_DNS_STATIC_SERVERS="153.64.251.200 153.65.8.10"
b) Extract the DNS search domains:
# grep "NETCONFIG_DNS_STATIC_SEARCHLIST" /etc/sysconfig/network/config
Sample output:
NETCONFIG_DNS_STATIC_SEARCHLIST="td.teradata.com teradata.com"
2. SSH into the DSC vNode to check the DNS servers and search domains, and then add the servers and
domains that are in Teradata Viewpoint.
a) Extract the DNS servers.
# grep "NETCONFIG_DNS_STATIC_SERVERS" /etc/sysconfig/network/config
Sample output:
NETCONFIG_DNS_STATIC_SERVERS="153.64.251.200"
Notice if 153.65.8.10 is missing from Teradata Viewpoint.
b) Add any missing servers.
# sed -i "s/^NETCONFIG_DNS_STATIC_SERVERS=.*$/
NETCONFIG_DNS_STATIC_SERVERS=\"153.64.251.200 153.65.8.10\"/" /etc/
sysconfig/network/config
c) If you added a server, verify it is now there.
# grep "NETCONFIG_DNS_STATIC_SERVERS" /etc/sysconfig/network/config
Sample output:
NETCONFIG_DNS_STATIC_SERVERS="153.64.251.200 153.65.8.10"
d) Extract the DNS search domains.
# grep "NETCONFIG_DNS_STATIC_SEARCHLIST" /etc/sysconfig/network/config
Sample output:
NETCONFIG_DNS_STATIC_SEARCHLIST="labs.teradata.com
Notice if td.teradata.com and teradata.com are missing from Teradata Viewpoint.
e) Add any missing search domains.
# sed -i "s/^NETCONFIG_DNS_STATIC_SEARCHLIST=.*$/
NETCONFIG_DNS_STATIC_SEARCHLIST=\"labs.teradata.com td.teradata.com
teradata.com\"/" /etc/sysconfig/network/config
f) If you added a search domain, verify it is now there.
# grep "NETCONFIG_DNS_STATIC_SEARCHLIST" /etc/sysconfig/network/config
Sample output:
NETCONFIG_DNS_STATIC_SEARCHLIST="labs.teradata.com td.teradata.com
teradata.com"
g) Apply the change.
/sbin/netconfig update -f
If the warning message continues, the DNS server may not contain any DNS record for the Teradata
Database COP entries.
3. Extract the Teradata Database COP entries from the hosts file in Teradata Viewpoint and append them
to the hosts file in the DSC vNode using the following syntax:

Teradata Database on VMware Getting Started Guide, Deployer Release 3.01 51

Appendix C: Troubleshooting Teradata Database on VMware

# grep TeradataSystemNamecop* /etc/hosts | ssh root@DSC_public_ip 'cat

>> /etc/hosts'
For example, if the TeradataSystemName is system1 and the public IP for the DSC vNode is
10.25.23.170, use the following syntax:
# grep system1cop* /etc/hosts | ssh [email protected] 'cat >> /etc/hosts'

52 Teradata Database on VMware Getting Started Guide, Deployer Release 3.01