Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Original file line number Diff line number Diff line change
Expand Up @@ -2,10 +2,10 @@
sidebar_position: 3
id: run-vantage-express-on-utm
title: Run Vantage Express on UTM
author: Adam Tworkiewicz
author: Adam Tworkiewicz, Janeth Graziani
email: adam.tworkiewicz@teradata.com
page_last_update: January 9th, 2023
description: Run Vantage Express on your laptop using VMware.
page_last_update: July 16, 2026
description: Run Vantage Express on your Mac using UTM
keywords: [data warehouses, compute storage separation, teradata, vantage, cloud data platform, object storage, business intelligence, enterprise analytics]

---
Expand All @@ -19,10 +19,10 @@ import GettingStartedSummary from '../../_partials/getting-started-summary.mdx';

## Prerequisites

1. A Mac computer. Both Intel and M1/2 chips are supported.
1. A Mac computer. Both Intel and M1/M2/M3 chips are supported.

:::note
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](../on-your-cloud-infrastructure/run-vantage-express-on-aws.md), [Azure](../on-your-cloud-infrastructure/run-vantage-express-on-microsoft-azure.md), [Google Cloud](../on-your-cloud-infrastructure/vantage-express-gcp.md).
Vantage Express runs on x86 architecture. When you run the VM on M1/M2/M3 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](../on-your-cloud-infrastructure/run-vantage-express-on-aws.md), [Azure](../on-your-cloud-infrastructure/run-vantage-express-on-microsoft-azure.md), [Google Cloud](../on-your-cloud-infrastructure/vantage-express-gcp.md).
:::

2. 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.
Expand All @@ -46,38 +46,49 @@ No admin rights on your local machine? Have a look at how to run Vantage Express
### Run Vantage Express

1. Go to the directory where you downloaded Vantage Express and unzip the downloaded file.
2. Start UTM, click on the `+` sign and select `Virtualize` (for Intel Macs) or `Emulate` (for M1 Macs).
3. On `Operating System` screen select `Other`.
4. On `Other` screen select `Skip ISO Boot`.
5. On `Hardware` screen allocate at least 4GB of memory and at least 1 CPU core. We recommend 10GB RAM and 2 CPUs.
2. Start UTM, click on the `+` sign and select `Create a New Virtual Machine`.
3. Select `Virtualize` (Intel Macs) or `Emulate` (M1/M2/M3 Macs).
4. On `Operating System` screen select `Other`.
5. On `Hardware` screen allocate at least 4GB of RAM and at least 1 CPU core. We recommend 10GB RAM and 2 CPUs.

![UTM Hardware](../../images/utm.hardware.png)

6. On `Storage` screen accept the defaults by clicking `Next`.
7. On `Shared Direct` screen click `Next`.
8. On `Summary` screen check `Open VM Settings` and click `Save`.
9. Go through the setup wizard. You only need to adjust the following tabs:
- **QEMU** - disable `UEFI Boot` option
- **Network** - expose ssh (22) and Vantage (1025) ports on the host computer:

![UTM Network](../../images/utm.network.png)

10. Map drives:
6. On the **Other** screen, set **Boot Device** to **None** and uncheck **UEFI Boot**, then click **Continue**.
7. On `Storage` screen accept the defaults by clicking `Next`.
8. On `Shared Directory` screen click `Continue`.
9. On `Summary` screen check `Open VM Settings` and click `Save`.
10. Go through the setup wizard. You only need to adjust the following tabs:
- In the **QEMU** tab, verify that **UEFI Boot** is unchecked. No other changes are needed.
- In the **Network** tab, set **Network Mode** to **Emulated VLAN**.
Then click **Port Forward** in the left sidebar and click **New** to add the following port forwarding rules:

| Protocol | Guest Address | Guest Port | Host Address | Host Port |
|----------|---------------|------------|--------------|-----------|
| TCP | | 22 | | 22 |
| TCP | | 1025 | | 1025 |

11. Map drives:
* Delete the default `IDE Drive`.
* 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, `-disk1`, `-disk2`, `-disk3` . The first disk is bootable and contains the database itself. Disks 2 and 3 are so called `pdisks` and contain data. As you import the files UTM will automatically convert them fro `vmdk` into `qcow2` format. Make sure that each disk is configured using the `IDE` interface:
* 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, `-disk1`, `-disk2`, `-disk3` . The first disk is bootable and contains the database itself. Disks 2 and 3 are so called `pdisks` and contain data. As you import the files UTM will automatically convert them from `vmdk` into `qcow2` format. Make sure that each disk is configured using the `IDE` interface:

![UTM Drives](../../images/utm.drives.png)

* Once you are done mapping all 3 drives, your configuration should look like this:

![UTM Drives Final](../../images/utm.final.png)

11. Save the configuration and start the VM.
12. Save the configuration and start the VM.

:::note
Initial boot on Apple Silicon (M1/M2/M3) via emulation can take 5-15 minutes. Do not force quit the VM.
:::

![UTM Booting](../../images/utm.booting.png)


<RunVantage />


<GettingStartedSummary />
In this guide we have covered how to quickly create a working Teradata Vantage environment on Apple Mac M1/M2/M3. We used Teradata Vantage Express in a VM running on UTM. We installed all software locally and didn't have to pay for cloud resources.

## Next steps
* [Query data stored in object storage](../../manage-data/nos.md)
Expand Down
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added quickstarts/images/utm.booting.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file removed quickstarts/images/utm.network.png
Binary file not shown.
Loading