diff --git a/quickstarts/connect-to-vantage/configure-odbc/odbc.ubuntu.md b/quickstarts/connect-to-vantage/configure-odbc/odbc.ubuntu.md index d56d66fb951..43103c8d3dc 100644 --- a/quickstarts/connect-to-vantage/configure-odbc/odbc.ubuntu.md +++ b/quickstarts/connect-to-vantage/configure-odbc/odbc.ubuntu.md @@ -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. -* 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/ ubuntu@ +``` + +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/ ~/Downloads/tdodbc2000__linux_x8664.20.00.00.66-1.tar.gz ubuntu@:/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=;UID=;PWD=;') cursor = cnxn.cursor() cursor.execute("SELECT CURRENT_DATE") for row in cursor.fetchall(): print(row) -EOF ``` Run the test application: @@ -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) - - \ No newline at end of file diff --git a/quickstarts/connect-to-vantage/install-teradata-studio-on-mac-m1-m2.md b/quickstarts/connect-to-vantage/install-teradata-studio-on-mac-m1-m2.md index 7c2ec231e39..f088f9eeada 100644 --- a/quickstarts/connect-to-vantage/install-teradata-studio-on-mac-m1-m2.md +++ b/quickstarts/connect-to-vantage/install-teradata-studio-on-mac-m1-m2.md @@ -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. - - \ No newline at end of file +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. \ No newline at end of file