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
102 changes: 72 additions & 30 deletions quickstarts/connect-to-vantage/configure-odbc/odbc.ubuntu.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,70 +2,115 @@
id: ubuntu
title: Ubuntu
sidebar_position: 1
author: Adam Tworkiewicz
author: Adam Tworkiewicz, Janeth Graziani
email: adam.tworkiewicz@teradata.com
page_last_update: January 5th, 2022
description: Use Vantage with ODBC on Ubuntu
keywords: [data warehouses, compute storage separation, teradata, vantage, cloud data platform, object storage, business intelligence, enterprise analytics, odbc, ubuntu]
page_last_update: July 10th, 2026
description: Use Teradata with ODBC on Ubuntu
keywords: [data warehouses, compute storage separation, teradata, cloud data platform, object storage, business intelligence, enterprise analytics, odbc, ubuntu]
---

import TrialDocsNote from '../../_partials/teradata_trial.mdx'
import CommunityLink from '../../_partials/community_link.mdx'

# Use Vantage with ODBC on Ubuntu
# Use Teradata with ODBC on Ubuntu

## Overview

This how-to demonstrates how to use the ODBC driver with Teradata Vantage on Ubuntu.
This how-to demonstrates how to use the ODBC driver with Teradata on Ubuntu.

## Prerequisites

* Access to a Teradata Vantage instance.
* Access to a Teradata instance.
<TrialDocsNote/>
* Root access to a Ubuntu machine.
* Root access to an Ubuntu machine. If you don't have a local Ubuntu machine, you can use an AWS EC2 instance as described in the steps below.
* An AWS account (if using EC2).

## Installation

* Install dependencies:
### Option 1: Launch an Ubuntu instance on AWS EC2

If you don't have a local Ubuntu machine, follow these steps to launch one on AWS EC2:

1. Go to the [AWS EC2 Console](https://console.aws.amazon.com/ec2/) and click **Launch Instance**.
2. Enter a name for your instance.
3. Under **Application and OS Images**, select **Ubuntu** and choose **Ubuntu Server 22.04 LTS** as the AMI.
4. Under **Instance type**, select `t2.micro` or `t3.micro`.
5. Under **Key pair**, click **Create new key pair**. Name it, keep the defaults (RSA, .pem), and click **Create key pair**. The `.pem` file will download automatically — save it to `~/.ssh/`.
6. Under **Network settings**, ensure **Allow SSH traffic** is checked and set the source to **My IP**.
7. Click **Launch Instance**.
8. Once the instance is running, copy the **Public IPv4 address** from the instance details page.
9. Set permissions on your key file and connect via SSH:

```bash
chmod 400 ~/.ssh/
ssh -i ~/.ssh/<your-key.pem> ubuntu@<your-public-ip>
```

10. Once connected, get root access:

```bash
sudo su
```

### Install dependencies

```bash
apt update && DEBIAN_FRONTEND=noninteractive apt install -y wget unixodbc unixodbc-dev iodbc python3-pip
apt update && DEBIAN_FRONTEND=noninteractive apt install -y wget unixodbc unixodbc-dev python3-pip alien
```

* Install Teradata ODBC driver for Ubuntu:
### Install Teradata ODBC driver

Download the Teradata ODBC driver for Linux from the [Teradata Downloads page](https://downloads.teradata.com/download/connectivity/odbc-driver/linux). A Teradata account is required to download the driver. Download the file `tdodbc2000__linux_x8664.20.00.00.66-1.tar.gz` to your local machine.

If you are using an AWS EC2 instance, open a new terminal window on your local machine and use `scp` to transfer the file:

```bash
wget https://downloads.teradata.com/download/cdn/connectivity/odbc/17.10.x.x/tdodbc1710__ubuntu_x8664.17.10.00.14-1.tar.gz \
&& tar -xzf tdodbc1710__ubuntu_x8664.17.10.00.14-1.tar.gz \
&& dpkg -i tdodbc1710/tdodbc1710-17.10.00.14-1.x86_64.deb
scp -i ~/.ssh/<your-key.pem> ~/Downloads/tdodbc2000__linux_x8664.20.00.00.66-1.tar.gz ubuntu@<your-public-ip>:/home/ubuntu/
```

* Configure ODBC, by creating file `/etc/odbcinst.ini` with the following content:
Back in your SSH session, extract and convert the driver package to a Debian-compatible format, then install it:

```bash
tar -xzf tdodbc2000__linux_x8664.20.00.00.66-1.tar.gz \
&& alien -d tdodbc2000/tdodbc2000-20.00.00.66-1.x86_64.rpm \
&& dpkg -i tdodbc2000_20.00.00.66-2_amd64.deb
```

### Configure ODBC

Create the file `/etc/odbcinst.ini` with the following content:

```bash
cat > /etc/odbcinst.ini << 'EOF'
[ODBC Drivers]
Teradata Database ODBC Driver 17.10=Installed
Teradata Database ODBC Driver 20.00=Installed

[Teradata Database ODBC Driver 17.10]
Description=Teradata Database ODBC Driver 17.10
Driver=/opt/teradata/client/17.10/odbc_64/lib/tdataodbc_sb64.so
[Teradata Database ODBC Driver 20.00]
Description=Teradata Database ODBC Driver 20.00
Driver=/opt/teradata/client/20.00/lib64/tdataodbc_sb64.so
EOF
```

## Use ODBC

We will validate the installation with a sample Python application. Create `test.py` file with the following content.
Replace `DBCName=192.168.86.33;UID=dbc;PWD=dbc` with the IP address of your Teradata Vantage instance, username and password:
Install `pyodbc`:

```bash
pip3 install pyodbc --break-system-packages
```

Create a `test.py` file with the following content. Replace `DBCName`, `UID` and `PWD` with your Teradata instance hostname, username and password:

```python
import pyodbc

print(pyodbc.drivers())

cnxn = pyodbc.connect('DRIVER={Teradata Database ODBC Driver 17.10};DBCName=192.168.86.33;UID=dbc;PWD=dbc;')
cnxn = pyodbc.connect('DRIVER={Teradata Database ODBC Driver 20.00};DBCName=<your-teradata-hostname>;UID=<username>;PWD=<password>;')
cursor = cnxn.cursor()

cursor.execute("SELECT CURRENT_DATE")
for row in cursor.fetchall():
print(row)
EOF
```

Run the test application:
Expand All @@ -77,15 +122,12 @@ python3 test.py
You should get output similar to:

```python
['ODBC Drivers', 'Teradata Database ODBC Driver 17.10']
(datetime.date(2022, 1, 5), )
['ODBC Drivers', 'Teradata Database ODBC Driver 20.00']
(datetime.date(2026, 7, 10),)
```

## Summary

This how-to demonstrated how to use ODBC with Teradata Vantage on Ubuntu. The how-to shows how to install the ODBC Teradata driver and the dependencies. It then shows how to configure ODBC and validate connectivity with a simple Python application.
This how-to demonstrated how to use ODBC with Teradata on Ubuntu. The how-to shows how to install the ODBC Teradata driver and the dependencies. It then shows how to configure ODBC and validate connectivity with a simple Python application.

## Further reading
* [ODBC Driver for Teradata® User Guide](https://docs.teradata.com/search/all?query=ODBC+Driver+for+Teradata+User+Guide&filters=ft%3AisBook~%22true%22&sort=last_update)

<CommunityLink />
Original file line number Diff line number Diff line change
Expand Up @@ -2,32 +2,43 @@
id: install-teradata-studio-on-mac-m1-m2
sidebar_position: 1

author: Satish Chinthanippu
email: satish.chinthanippu@teradata.com
page_last_update: August 14th, 2023
description: Run Teradata Studio on Apple Mac M1/M2.
keywords: [Teradata Studio, Teradata Studio Express, teradata, vantage, Mac, Apple Mac, Apple Mac M1,Apple Mac M2, Arm based Processor.]
author: Satish Chinthanippu, Janeth Graziani
email: satish.chinthanippu@teradata.com, developer.relations@teradata.com
page_last_update: July 15th, 2026
description: Run Teradata Studio on Apple Mac M1/M2/M3.
keywords: [Teradata Studio, Teradata Studio Express, teradata, vantage, Mac, Apple Mac, Apple Mac M1,Apple Mac M2, Apple Mac M3, Arm based Processor.]
---

import CommunityLink from '../_partials/community_link.mdx';

# Use Teradata Studio/Express on Apple Mac M1/M2
# Use Teradata Studio/Express on Apple Mac M1/M2/M3

## Overview

This how-to goes through the installation of Teradata Studio and Teradata Studio Express on Apple Mac M1/M2 machines.
This how-to goes through the installation of Teradata Studio and Teradata Studio Express on Apple Mac M1/M2/M3 machines.

## Steps to follow

1. Install and enable Rosetta binary translator. Follow [the Apple Mac Rosetta Installation Guide](https://support.apple.com/en-us/HT211861).
2. Download and Install a x86 64-bit based JDK 11 from your preferred vendor. For example, you can download x86 64-bit JDK 11 from [Azul](https://www.azul.com/downloads/?version=java-11-lts&os=macos&architecture=x86-64-bit&package=jdkGet)
3. Download the latest Teradata Studio or Teradata Studio Express release from the Teradata Downloads page:
* [Teradata Studio](https://downloads.teradata.com/download/tools/teradata-studio)
* [Teradata Studio Express](https://downloads.teradata.com/download/tools/teradata-studio-express)
4. Install the Teradata Studio/Teradata Studio Express. Refer to [Teradata Studio and Teradata Studio Express Installation Guide](./attachments/Studio-Express-InstallGuide.pdf) for details.
1. Install Rosetta binary translator by running the following command in Terminal:
```bash
softwareupdate --install-rosetta --agree-to-license
```

2. Download and install the x86 64-bit JDK 21 from your preferred vendor. For example, download x86 64-bit JDK 21 from [Azul](https://www.azul.com/downloads/?version=java-21&os=macos&architecture=x86-64-bit&package=jdk)
3. Download the latest [Teradata Studio](https://downloads.teradata.com/download/tools/teradata-studio) or [Teradata Studio Express](https://downloads.teradata.com/download/tools/teradata-studio-express) release:
* Go to [Teradata Downloads](https://downloads.teradata.com/) and log in to the portal.
* Select **MacOS** from the drop-down menu on the right-hand side box and download the latest [Teradata Studio](https://downloads.teradata.com/download/tools/teradata-studio) or [Teradata Studio Express](https://downloads.teradata.com/download/tools/teradata-studio-express) release from the Teradata Downloads page, then unzip the downloaded file.
* Download version **20.00.00.10** or later.
* Select the `mac_x86` zip file for macOS for Teradata Studio.
* Accept the License Agreement by clicking **I Agree**.
* In the File Download dialog box, click **Save**, choose a download location, and click **Save** again.
* Unzip the downloaded file.
:::note
Starting from version 20.00.00.05, connections to Hadoop and Aster databases are no longer supported in Teradata Studio.
:::
4. Install Teradata Studio via terminal:
```bash
sudo installer -pkg ~/Downloads/TeradataStudio.pkg -target / -allowUntrusted
```

## Summary

Apple has introduced ARM-based processors in Apple MAC M1/M2 machines. Intel x64-based applications won't work by default on ARM-based processors. Teradata Studio or Teradata Studio Express also doesn't work by default as the current Studio macOS build is an intel x64-based application. This how-to demonstrates how to install Intel x64-based JDK and Teradata Studio or Teradata Studio Express on Apple Mac M1/M2.

<CommunityLink />
Apple has introduced ARM-based processors in Apple MAC M1/M2/M3 machines. Intel x64-based applications won't work by default on ARM-based processors. Teradata Studio or Teradata Studio Express also doesn't work by default as the current Studio macOS build is an intel x64-based application. This how-to demonstrates how to install Intel x64-based JDK and Teradata Studio or Teradata Studio Express on Apple Mac M1/M2/M3.
Loading