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
51 changes: 22 additions & 29 deletions quickstarts/_partials/run-vantage.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -4,44 +4,33 @@

- On the next screen, press <kbd>ENTER</kbd> again to select the default SUSE Linux kernel.

![Teradata Data Distribution](../images/run-vantage/grub-menu.png)
![Teradata Data Distribution](../images/run-vantage/linux-menu.png)

- 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.
- Once the VM is up, you will see its desktop environment. When prompted for a username and password, enter `root` for both.

![Wait for GUI](../images/run-vantage/wait-for-gui.png)
![VM Login](../images/run-vantage/vm-login.png)

- After a while the following prompt will appear - assuming that you did not enter anything after the command login prompt above. Press `okay` button in the screen below.
- The database is configured to autostart with the VM. To confirm that the database has started, go to the virtual desktop and start a terminal.

![OK Security Popup](../images/run-vantage/okay-the-security-popup.png)
![Start Terminal](../images/run-vantage/start-terminal.png)

- Once the VM is up, you will see its desktop environment. When prompted for username/password enter `root` for both.

![VM Login](../images/run-vantage/vm.login.png)

- The database is configured to autostart with the VM. To confirm that the database has started go to the virtual desktop and start `Gnome Terminal`.

![Start Gnome Terminal](../images/run-vantage/start-gnome-terminal.png)

- In the terminal execute `pdestate` command that will inform you if Vantage has already started:

:::note
To paste into Gnome Terminal press <kbd>SHIFT+CTRL+V</kbd>.
:::
- In the terminal, execute the `pdestate` command to check if Vantage has already started:

```bash
watch pdestate -a
pdestate -a
```

You want to wait till you see the following message:
Wait until you see the following message:

```bash
PDE state is RUN/STARTED.
DBS state is 5: Logons are enabled - The system is quiescent
```
![PDEstate](../images/run-vantage/pdestate.png)

<details>

<summary>See examples of messages that <code>pdestate</code> returns when the database is still initializing.</summary>
<summary>See examples of messages that <code>pdestate</code> returns when the database is still initializing:</summary>

<pre>
PDE state is DOWN/HARDSTOP.
Expand All @@ -67,14 +56,18 @@ PDE state is RUN/STARTED.

</details>

- Now that the database is up, go back to the virtual desktop and launch `Teradata Studio Express`
- Now that the database is up, you can log in to it:
- At the shell prompt, type `bteq`.
- At the logon prompt, type `.logon 127.0.0.1/dbc`.
- At the password prompt, type `dbc`.
- If successful, the Basic Teradata Query (BTEQ) session confirms that you are logged into BTEQ.

![Start Teradata Studio Express](../images/run-vantage/start-teradata-studio-express.png)
![Database Login](../images/run-vantage/tera-login.png)

- 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 `Teradata`:

![New Connection Profile](../images/run-vantage/new.connection.profile.png)

- On the next screen, connect to the database on your localhost using `dbc` for the username and password:
- Run the SQL test script by typing the following:
```bash
select * from dbc.dbcinfo;
```
- A successful test returns: `*** Query completed.`

![New Connection](../images/run-vantage/new.connection.png)
![Select Statement](../images/run-vantage/select-statement.png)
Original file line number Diff line number Diff line change
Expand Up @@ -11,9 +11,7 @@ keywords: [data warehouses, compute storage separation, teradata, vantage, cloud
---
import GettingStartedIntro from '../../_partials/getting-started-intro.mdx';
import RunVantage from '../../_partials/run-vantage.mdx';
import RunSimpleQueries from '../../_partials/running-sample-queries.mdx';
import GettingStartedSummary from '../../_partials/getting-started-summary.mdx';
import CommunityLink from '../../_partials/community_link.mdx';

# Run Vantage Express on UTM

Expand Down Expand Up @@ -78,7 +76,6 @@ No admin rights on your local machine? Have a look at how to run Vantage Express

<RunVantage />

<RunSimpleQueries />

<GettingStartedSummary />

Expand All @@ -87,5 +84,3 @@ No admin rights on your local machine? Have a look at how to run Vantage Express

## Further reading
* [Teradata® Studio™ and Studio™ Express Installation Guide](https://docs.teradata.com/r/Teradata-StudioTM-and-StudioTM-Express-Installation-Guide-17.20)

<CommunityLink />
Original file line number Diff line number Diff line change
Expand Up @@ -8,9 +8,7 @@ keywords: [data warehouses, compute storage separation, teradata, vantage, cloud
---
import GettingStartedIntro from '../../_partials/getting-started-intro.mdx';
import RunVantage from '../../_partials/run-vantage.mdx';
import RunSimpleQueries from '../../_partials/running-sample-queries.mdx';
import GettingStartedSummary from '../../_partials/getting-started-summary.mdx';
import CommunityLink from '../../_partials/community_link.mdx';

# Run Vantage Express on VirtualBox

Expand Down Expand Up @@ -64,7 +62,6 @@ import CommunityLink from '../../_partials/community_link.mdx';

<RunVantage />

<RunSimpleQueries />

## Updating VirtualBox Guest Extensions

Expand All @@ -89,6 +86,4 @@ mount /dev/cdrom /media/dvd; /media/dvd/VBoxLinuxAdditions.run
* [Query data stored in object storage](../../manage-data/nos.md)

## Further reading
* [Teradata® Studio™ and Studio™ Express Installation Guide](https://docs.teradata.com/r/Teradata-StudioTM-and-StudioTM-Express-Installation-Guide-17.20)

<CommunityLink />
* [Teradata® Studio™ and Studio™ Express Installation Guide](https://docs.teradata.com/r/Teradata-StudioTM-and-StudioTM-Express-Installation-Guide-17.20)
Original file line number Diff line number Diff line change
@@ -1,66 +1,56 @@
---
sidebar_position: 1
author: Adam Tworkiewicz
email: adam.tworkiewicz@teradata.com
page_last_update: January 9th, 2023
author: Adam Tworkiewicz, Daniel Herrera
email: developer.relations@teradata.com
page_last_update: July 13, 2026
description: Run Vantage Express on your laptop using VMware.
keywords: [data warehouses, compute storage separation, teradata, vantage, cloud data platform, object storage, business intelligence, enterprise analytics]
keywords: [data warehouses, compute storage separation, Teradata, Vantage, cloud data platform, object storage, business intelligence, enterprise analytics]
---
import GettingStartedIntro from '../../_partials/getting-started-intro.mdx';
import RunVantage from '../../_partials/run-vantage.mdx';
import RunSampleQueries from '../../_partials/running-sample-queries.mdx';
import GettingStartedSummary from '../../_partials/getting-started-summary.mdx';
import CommunityLink from '../../_partials/community_link.mdx';

# Run Vantage Express on VMware

<GettingStartedIntro />

## Prerequisites

1. A computer using one of the following operating systems: Windows, Linux or Intel-based MacOS.
1. A computer running one of the following operating systems: Windows, Linux, or Intel-based macOS.
:::note
For M1/M2 MacOS systems, see [Run Vantage Express on UTM.](./getting-started-utm.md)
For M1/M2 macOS systems, see [Run Vantage Express on UTM](./getting-started-utm.md).
:::
2. 30GB of disk space and enough CPU and RAM to be able to dedicate at least one core and 6GB RAM to the virtual machine.
3. Admin rights to be able to install and run the software.
2. At least 30GB of available disk space, sufficient CPU resources, and enough RAM to allocate at least one core and 6GB of memory to the virtual machine.
3. Administrator rights to install and run software on your system.

## Installation

### Download required software

* The latest version of [Vantage Express](https://downloads.teradata.com/download/database/teradata-express-for-vmware-player). If you have not used the Teradata downloads website before, you will need to register.
* [VMware Workstation Player](https://www.vmware.com/products/workstation-player.html).
* The latest version of [Vantage Express](https://downloads.teradata.com/download/database/teradata-express-for-vmware-player). If you have not previously used the Teradata downloads website, you will need to create an account.
* [VMware Workstation Pro](https://www.vmware.com/products/desktop-hypervisor/workstation-and-fusion).
* Log in to support.broadcom.com and click the _Free Software Downloads available HERE_ link.
![Broadcom Downloads](../../images/getting-started-vmware/free-downloads.png)

:::info
Commercial organizations require commercial licenses to use VMware Workstation Player. If you don't want to acquire VMware licenses you can run Vantage Express on [VirtualBox](./getting-started-vbox.md).
:::

:::info
VMware doesn't offer VMware Workstation Player for MacOS. If you are on a Mac, you will need to install [VMware Fusion](https://www.vmware.com/products/fusion/fusion-evaluation.html) instead. It's a paid product but VMware offers a free 30-day trial. Alternatively, you can run Vantage Express on [VirtualBox](./getting-started-vbox.md) or [UTM](./getting-started-utm.md).
:::
* On Windows, you will also need [7zip](https://www.7-zip.org/download.html) to unzip Vantage Express.
* VMware Workstation Pro is now available as a free download for both personal and commercial use.

### Run installers

1. Install VMware Player or VMware Fusion by running the installer and accepting the default values.
2. If on Windows, install `7zip`.
1. Run the VMware Workstation Pro installer and accept the default values to complete the installation.

### Run Vantage Express

- Go to the directory where you downloaded Vantage Express and unzip the downloaded file.
- Double-click on the `.vmx` file. This will start the VM image in VMware Player/Fusion.
- Navigate to the directory where you downloaded Vantage Express and double-click the `.ova` file to launch the VM image in VMware Workstation Pro.

<RunVantage />

<RunSampleQueries />
## Summary

<GettingStartedSummary />
This guide demonstrates how to quickly set up a working Teradata environment using Teradata Vantage Express running in a virtual machine on VMware Workstation Pro.

## Next steps

* [Query data stored in object storage](../../manage-data/nos.md)

## Further reading
* [Teradata® Studio™ and Studio™ Express Installation Guide](https://docs.teradata.com/r/Teradata-StudioTM-and-StudioTM-Express-Installation-Guide-17.20)

<CommunityLink />
* [Teradata® Studio™ and Studio™ Express Installation Guide](https://docs.teradata.com/r/Teradata-VantageTM-Express-Installation-and-Configuration-Guide/Installing-Vantage-Express/Add-Vantage-Express-to-the-VMware-Workstation-Player-Inventory)
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified quickstarts/images/run-vantage/boot-manager-menu.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 added quickstarts/images/run-vantage/linux-menu.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 added quickstarts/images/run-vantage/pdestate.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
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/run-vantage/start-terminal.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 added quickstarts/images/run-vantage/tera-login.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 added quickstarts/images/run-vantage/vm-login.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading