Run Vantage Express on UTM
Author: Adam Tworkiewicz
Last updated: January 9th, 2023
This how-to shows how to gain access to a Teradata database by running it on your local machine. There are many ways to install Teradata. This document optimizes for the lowest time to first query without spending money on cloud resources. Once you finish the steps you will have a working Teradata Vantage Express database on your computer.
|Starting with version 17.20, Vantage Express includes the following analytics packages: Vantage Analytics Library, Bring Your Own Model (BYOM), API Integration with AWS SageMaker.|
A Mac computer. Both Intel and M1/2 chips are supported.
Vantage Express runs on x86 architecture. When you run the VM on M1/2 chips, UTM has to emulate x86. This is significantly slower then virtualization. If you determine that Vantage Express on M1/M2 is too slow for your needs, consider running Vantage Express in the cloud: AWS, Azure, Google Cloud.
30GB of disk space and enough CPU and RAM to be able to dedicate at least one core and 4GB RAM to the virtual machine.
Admin rights to be able to install and run the software.
No admin rights on your local machine? Have a look at how to run Vantage Express in AWS, Azure, Google Cloud.
Download required software
The latest version of Vantage Express. If you have not used the Teradata downloads website before, you will need to register.
The latest version of UTM.
Run Vantage Express
Go to the directory where you downloaded Vantage Express and unzip the downloaded file.
Start UTM, click on the
+sign and select
Virtualize(for Intel Macs) or
Emulate(for M1 Macs).
Operating Systemscreen select
Skip ISO Boot.
Hardwarescreen allocate at least 4GB of memory and at least 1 CPU core. We recommend 10GB RAM and 2 CPUs.
Storagescreen accept the defaults by clicking
Shared Directscreen click
Open VM Settingsand click
Go through the setup wizard. You only need to adjust the following tabs:
QEMU - disable
Network - expose ssh (22) and Vantage (1025) ports on the host computer:
Delete the default
Map the 3 Vantage Express drives by importing the disk files from the downloaded VM zip file. Make sure you map them in the right order,
-disk3. The first disk is bootable and contains the database itself. Disks 2 and 3 are so called
pdisksand contain data. As you import the files UTM will automatically convert them fro
qcow2format. Make sure that each disk is configured using the
Once you are done mapping all 3 drives, your configuration should look like this:
Save the configuration and start the VM.
Press ENTER to select the highlighted
On the next screen, press ENTER again to select the default SUSE Linux kernel.
After completing the bootup sequence a terminal login prompt as shown in the screenshot below will appear. Don’t enter anything in the terminal. Wait till the system starts the GUI.
After a while the following prompt will appear - assuming that you did not enter anything after the command login prompt above. Press
okaybutton in the screen below.
Once the VM is up, you will see its desktop environment. When prompted for username/password enter
The database is configured to autostart with the VM. To confirm that the database has started go to the virtual desktop and start
In the terminal execute
pdestatecommand that will inform you if Vantage has already started:
To paste into Gnome Terminal press SHIFT+CTRL+V.
watch pdestate -a
You want to wait till you see the following message:
PDE state is RUN/STARTED. DBS state is 5: Logons are enabled - The system is quiescent
See examples of messages that
pdestatereturns when the database is still initializing.
PDE state is DOWN/HARDSTOP. PDE state is START/NETCONFIG. PDE state is START/GDOSYNC. PDE state is START/TVSASTART. PDE state is START/READY. PDE state is RUN/STARTED. DBS state is 1/1: DBS Startup - Initializing DBS Vprocs PDE state is RUN/STARTED. DBS state is 1/5: DBS Startup - Voting for Transaction Recovery PDE state is RUN/STARTED. DBS state is 1/4: DBS Startup - Starting PE Partitions PDE state is RUN/STARTED.
Now that the database is up, go back to the virtual desktop and launch
Teradata Studio Express.
When you first start it you will be offered a tour. Once you close the tour, you will see a wizard window to add a new connection. Select
On the next screen, connect to the database on your localhost using
dbcfor the username and password:
Run sample queries
We will now run some queries in the VM. To avoid copy/paste issues between the host and the VM, we will open this quick start in the VM. Go to the virtual desktop, start Firefox and point it to this quick start.
Once in Teradata Studio Express, go to
Query Developmentperspective (go to the top menu and select
Connect using the previously created connection profile by double-clicking on
dbcuser, we will create a new database called
HR. Copy/paste this query and run it by hitting the run query button () or pressing F5 key:
CREATE DATABASE HR AS PERMANENT = 60e6, -- 60MB SPOOL = 120e6; -- 120MB
Let’s create a sample table and insert some data and query it. We will first create a table to hold employee information:
CREATE SET TABLE HR.Employees ( GlobalID INTEGER, FirstName VARCHAR(30), LastName VARCHAR(30), DateOfBirth DATE FORMAT 'YYYY-MM-DD', JoinedDate DATE FORMAT 'YYYY-MM-DD', DepartmentCode BYTEINT ) UNIQUE PRIMARY INDEX ( GlobalID );
Now, let’s insert a record:
INSERT INTO HR.Employees ( GlobalID, FirstName, LastName, DateOfBirth, JoinedDate, DepartmentCode ) VALUES ( 101, 'Adam', 'Tworkowski', '1980-01-05', '2004-08-01', 01 );
Finally, let’s see if we can retrieve the data:
SELECT * FROM HR.Employees;
You should get the following results:
GlobalID FirstName LastName DateOfBirth JoinedDate DepartmentCode -------- --------- ---------- ----------- ---------- -------------- 101 Adam Tworkowski 1980-01-05 2004-08-01 1
In this guide we have covered how to quickly create a working Teradata environment. We used Teradata Vantage Express in a VM running on VMware. In the same VM, we ran Teradata Studio Express to issue queries. We installed all software locally and didn’t have to pay for cloud resources.
|If you have any questions or need further assistance, please visit our community forum where you can get support and interact with other community members.|