Teradata Tools and Utilities Installation Guide for UNIX and Linux provides instructions for installing Teradata software on UNIX and Linux systems. It supports Teradata Database 13.10 and Teradata Tools and Utilities 13.10. The guide has been updated to include new product installations and platform support. It provides an overview of the installation process and prerequisites for installing the software.
3. Teradata Tools and Utilities Installation Guide for UNIX and Linux 3
Preface
Purpose
This book provides information about installing the Teradata Tools and Utilities Release 13.10
software on a computer that runs on UNIX®
and Linux operating systems. Teradata Tools and
Utilities is a group of products designed to work with Teradata Database.
Audience
This book is intended for use by:
• System and application programmers
• System administrators
• Database administrators and relational database developers
• System operators and other database specialists
Supported Releases
This book supports the following releases:
• Teradata Database 13.10.00
• Teradata Tools and Utilities 13.10.00
To locate detailed supported-release information:
1 Go to http://www.info.teradata.com.
2 Under Online Publications, click General Search.
3 Type 3119 in the Publication Product ID box.
4 Under Sort By, select Date.
5 Click Search.
6 Open the version of the Teradata Tools and Utilities ##.##.## Supported Platforms and
Product Versions spreadsheet associated with this release.
The spreadsheet includes supported Teradata Database versions, platforms, and product
release numbers.
4. Preface
Prerequisites
4 Teradata Tools and Utilities Installation Guide for UNIX and Linux
Prerequisites
The following prerequisite knowledge is required for this product:
• Computer technology and terminology
• Relational database management systems
• Utilities that load and retrieve data
Changes to This Book
The following changes were made to this book in support of the current release. Changes are
marked with change bars. For a complete list of changes to the product, see the Teradata Tools
and Utilities Release Definition associated with this release.
Date and Release Description
August 2010
13.10
The following changes were made to support Teradata Tools and Utilities
13.10 installation:
• Added ARC 64-bit information Linux native 64-bit.
• Added NLSPATH to the ODBC Configuration.
February 2010
13.10
The following changes were made to support Teradata Tools and Utilities
13.10 installation:
• Total Manual redesign.
• Ported ODBC Driver for Teradata to 64-bit HP.
• Ported Call-Level Interface version 2 to 32-bit on ia64.
• Ported Teradata MQ Access Module to 32-bit on ia64.
• Ported Named Pipes Access Module to 32-bit on ia64.
• Ported Call-Level Interface version 2 to Linux for OS/390.
• Ported Named Pipes Access Module to Linux for OS/390.
• Ported PP2 to Linux for OS/390.
• Ported Teradata Data Connector to Linux for OS/390.
• Ported Teradata FastExport to Linux for OS/390.
• Ported Teradata FastLoad to Linux for OS/390.
• Ported Teradata MultiLoad to Linux for OS/390.
• Ported Teradata TPump to Linux for OS/390.
• Ported Teradata Parallel Transport to Linux for OS/390.
• Ported Teradata MQ Access Module to Linux for OS/390.
• Updated support for TQS Client.
• Consolidated several installation procedures from individual guides to
this document.
• Documented change to Red Hat 3.0 compiler.
5. Preface
Additional Information
Teradata Tools and Utilities Installation Guide for UNIX and Linux 5
Additional Information
Additional information that supports this product and Teradata Tools and Utilities is available
at the web sites listed in the table that follows. In the table, mmyx represents the publication
date of a manual, where mm is the month, y is the last digit of the year, and x is an internal
publication code. Match the mmy of a related publication to the date on the cover of this book.
This ensures that the publication selected supports the same release.
February 2010
13.10 (continued)
The following changes were made to support Teradata Tools and Utilities
13.10 installation:
• Documented tar script for deploying products across a network.
• Discontinued support for z/VM.
• Discontinued support for MP-RAS.
• Discontinued support for AIX 5.1 and 5.2.
• Discontinued Teradata MultiTool.
• Removed ODBC Driver for Teradata from Tape Storage Enablers CD.
• Added ARC installation to documentation.
• Added information about using SPNEGO.
• Removed information on xctl from documentation.
• Changed product release numbering scheme.
• Changed ODBC documentation concerning LIBPATH.
• Included information about downloading compat lib in SUSE 10.
August 2008
13.00
The following changes were made to support Teradata Tools and Utilities
13.00 installation:
• Reduced the number of Teradata Parallel Transport products from 15 to
6.
• The Tivoli Access Module is no longer included on the Tape Storage
Management Enabler CD.
• For those Client products that have both a 32-bit and a 64-bit
installation package, both versions can co-exist on an EM64T system.
• When a Client product that has both a 32-bit and a 64-bit installation
package and is installed silently on an EM64T system, both the 32-bit
and the 64-bit versions will be installed. If the Client product is installed
interactively, only the 64-bit version is installed.
• Earlier versions of installed Client products are now automatically
uninstalled as part of the installation.
• Changes to support the new Teradata Corporation branding that
include a new splash screen, copyright, license text, and logo.
• A new directory structure for the Teradata Tools and Utilities 13.00.00
client products where the default location is now:
%Program Files%TeradataClient13.0<product>
Date and Release Description
6. Preface
Additional Information
6 Teradata Tools and Utilities Installation Guide for UNIX and Linux
Type of Information Description Access to Information
Release overview
Late information
Use the Release Definition for the following
information:
• Overview of all of the products in the
release
• Information received too late to be
included in the manuals
• Operating systems and Teradata
Database versions that are certified to
work with each product
• Version numbers of each product and
the documentation for each product
• Information about available training
and the support center
1 Go to http://www.info.teradata.com/.
2 Under Online Publications, click General Search.
3 Type 2029 in the Publication Product ID box.
4 Click Search.
5 Select the appropriate Release Definition from
the search results.
7. Preface
Additional Information
Teradata Tools and Utilities Installation Guide for UNIX and Linux 7
Additional product
information
Use the Teradata Information Products web
site to view or download specific manuals
that supply related or additional
information to this manual.
1 Go to http://www.info.teradata.com/.
2 Under the Online Publications subcategory,
Browse by Category, click Data Warehousing.
3 Do one of the following:
• For a list of Teradata Tools and Utilities
documents, click Teradata Tools and Utilities,
and then select an item under Releases or
Products.
• Select a link to any of the data warehousing
publications categories listed.
Specific books related to Teradata Call-Level
Interface Version 2 for Channel-Attached Systems
are as follows:
• Messages
B035-1096-mmyA
• Teradata Tools and Utilities Command Summary
B035-2401-mmyA
• Teradata JDBC Driver User Guide
B035-2403-mmyA
• Teradata Tools and Utilities Installation Guide for
Microsoft Windows
B035-2407-mmyA
• Teradata MultiLoad Reference
B035-2409-mmyA
• Teradata FastExport Reference
B035-2410-mmyA
• Teradata FastLoad Reference
B035-2411-mmyA
• Teradata Archive/Recovery Utility Reference
B035-2412-mmyA
• Basic Teradata Query Reference
B035-2414-mmyA
• Teradata Director Program Reference
B035-2416-mmyA
Type of Information Description Access to Information
8. Preface
Additional Information
8 Teradata Tools and Utilities Installation Guide for UNIX and Linux
• (Continued from the bulleted list above) in the
Publication Product ID field, enter one of the
following book numbers:
• Teradata Call-Level Interface Version 2 Reference
for Channel-Attached Systems
B035-2417-mmyA
• Teradata Call-Level Interface Version 2 Reference
for Network-Attached Systems
B035-2418-mmyA
• Teradata Transparency Series/ Application
Programming Interface User Guide
B035-2419-mmyA
• Teradata Tools and Utilities Access Module
Programmer Guide
B035-2424-mmyA
• Teradata Tools and Utilities Access Module
Reference
B035-2425-mmyA
• Teradata SQL Assistant for Microsoft Windows
User Guide
B035-2430-mmyA
• Teradata Parallel Transporter Reference
B035-2436-mmyA
• Teradata Access Module for Tivoli Installation and
User Guide
B035-2444-mmyA
• Teradata Parallel Transporter User Guide
B035-2445-mmyA
• Teradata Preprocessor2 for Embedded SQL
Programmer Guide
B035-2446-mmyA
• Interactive Teradata Query Reference
B035-2451-mmyA
• Interactive Teradata Query User Guide
B035-2452-mmyA
• Teradata Tools and Utilities Installation Guide for
IBM z/OS
B035-2458-mmyA
• Teradata Tools and Utilities Installation Guide for
UNIX and Linux
B035-2459-mmyA
Type of Information Description Access to Information
9. Preface
Additional Information
Teradata Tools and Utilities Installation Guide for UNIX and Linux 9
• (Continued from the bulleted list above) in the
Publication Product ID field, enter one of the
following book numbers:
• Teradata System Emulation Tool User Guide
B035-2492-mmyA
• OLE DB Provider for Teradata Installation and
User Guide
B035-2498-mmyA
• Teradata Administrator User Guide
B035-2502-mmyA
• Teradata Statistics Wizard User Guide
B035-2503-mmyA
• Teradata Visual Explain User Guide
B035-2504-mmyA
• Teradata Index Wizard User Guide
B035-2506-mmyA
• ODBC Driver for Teradata User Guide
B035-2509-mmyA
• Teradata Query Director User Guide
B035-2510-mmyA
• Teradata Query Scheduler Administrator Guide
B035-2511-mmyA
• Teradata Query Scheduler User Guide
B035-2512-mmyA
• Teradata Workload Analyzer User Guide
B035-2514-mmyA
• Teradata Parallel Transporter Application
Programming Interface Programmer Guide
B035-2516-mmyA
• Teradata Parallel Data Pump Reference
B035-3021-mmyA
• Teradata Meta Data Services Installation and
Administration Guide
B035-3118-mmyA
• Teradata Meta Data Services Programmer Guide
B035-3047-mmyA
CD-ROM images Access a link to a downloadable CD-ROM
image of all customer documentation for
this release. Customers are authorized to
create CD-ROMs for their use from this
image.
1 Go to http://www.info.teradata.com/.
2 Under the Online Publications subcategory,
Browse by Category, click Data Warehousing.
3 Click CD-ROM List and Images.
4 Follow the ordering instructions.
Ordering
information for
manuals
Use the Teradata Information Products web
site to order printed versions of manuals.
1 Go to http://www.info.teradata.com/.
2 Under Print & CD Publications, click How to
Order.
3 Follow the ordering instructions.
Type of Information Description Access to Information
10. Preface
Additional Information
10 Teradata Tools and Utilities Installation Guide for UNIX and Linux
General information
about Teradata
The Teradata home page provides links to
numerous sources of information about
Teradata. Links include:
• Executive reports, case studies of
customer experiences with Teradata,
and thought leadership
• Technical information, solutions, and
expert advice
• Press releases, mentions, and media
resources
1 Go to Teradata.com.
2 Select a link.
Type of Information Description Access to Information
24. Table of Contents
24 Teradata Tools and Utilities Installation Guide for UNIX and Linux
25. Teradata Tools and Utilities Installation Guide for UNIX and Linux 25
CHAPTER 1
Linux and UNIX Operating Systems
General Install
This document describes the general installation of Teradata Tools and Utilities products from
CD-ROM, Teradata Download Center, and Teradata Software Server.
General Installation Instructions
Whenever installing Teradata Tools and Utilities software, always compare the versions
available on the CD media, the Teradata Download Center and the Teradata Software Server.
In general, the software server will contain the most recent point release of a software product,
followed in turn by the download center and finally the CD media.
• Installing from a Web URL - Some Teradata Tools and Utilities have third-party
dependencies. Install these dependencies from these respective URLs.
• Installing from CD Media - Describes how to install products on a single user from the
CD media in the Teradata Tools and Utilities Installation Kit. The CDs contain installation
packages for the current release.
• Installing from the Teradata Download Center - Describes how to install Teradata Tools
and Utilities communications packages and other software available on the Teradata
Download Center. The download center may contain more current software packages
which should be installed instead of lower version software contained on the CD media.
• Installing from the Teradata Software Server - This document describes how to install
Teradata Tools and Utilities packages from the Teradata Software Server. The server may
contain updated software packages which should be installed in lieu of lower version
software contained on the CD media, or on the Teradata Download Center.
• Installing from the ESDM Server - This document describes Teradata's Electronic
Software Distribution Management (ESDM) program.
Instructions for Installing Across a Network
• Deploying Using tar - This document describes how to deploy one or more Teradata Tools
and Utilities products across your network using a UNIX system ksh script or a DOS batch
script and tar.
26. Chapter 1: Linux and UNIX Operating Systems General Install
Instructions for Installing Individual Products
26 Teradata Tools and Utilities Installation Guide for UNIX and Linux
Instructions for Installing Individual Products
• Installing Teradata Meta Data Services - Teradata Meta Data Services (MDS) is installed
from CD media or the Teradata Software Server. Installation is generally limited to
administrative users. This section details the installation of Teradata Meta Data Services
from the CD media.
27. Teradata Tools and Utilities Installation Guide for UNIX and Linux 27
CHAPTER 2
Installing to Linux from CD Media
Follow these steps to Install one or more Teradata Tools and Utilities products from the
Teradata Tools and Utilities installation Kit CD Media to Red Hat Linux, SUSE Linux and
Linux for s390x clients.
Step 1: Inspect the Installation Kit
Inspect the Installation Kit CDs
• Installation Kit - Lists the Installation Kit CDs and indicates the CDs where products and
their dependencies are located. Inspect the Teradata Tools and Utilities Installation Kit for
completeness, and determine which CDs contain the products and the dependencies being
installed. Because of space limitations, products on some installation CDs are segregated
by platform
Step 2: Review Platforms, Products,
Dependencies and Requirements
Determine if the products being installed are compatible with and supported by the client.
Then determine if the minimum system requirements have been met, and which products
have dependencies which have to be loaded.
Determine if Platforms and Products are Compatible
Links to a spreadsheet which lists the UNIX, Linux, Windows and mainframe platforms and
the products supported by each release of Teradata Tools and Utilities are located at:
• http://www.info.teradata.com
Links to the current and last two major releases are included below:
• Teradata Tools and Utilities 12.00.xx Supported Versions - [12.00.xx]
• Teradata Tools and Utilities 13.00.xx Supported Versions - [13.00.xx]
• Teradata Tools and Utilities 13.10.xx Supported Versions - [13.10.xx]
Read Product Descriptions and Determine Product Dependencies
• Product Descriptions - Lists a synopsis of each of the products available.
28. Chapter 2: Installing to Linux from CD Media
Step 3: Uninstall Previous Versions of Teradata Tools and Utilities
28 Teradata Tools and Utilities Installation Guide for UNIX and Linux
• Product Dependencies - Lists the Teradata Tools and Utilities dependencies and third-
party dependencies. If installing from the main install, all Teradata Tools and Utilities
product dependencies are verified, and if not available, are installed automatically.
• Third-Party Dependencies - Third-party products must be installed before installing any
Teradata Tools and Utilities Products. This software is not contained on the installation
CDs. Most are available from the manufacturer’s website.
Determine if System Requirements have been Met
• System Requirements - Minimum system requirements to install Teradata Tools and
Utilities
Step 3: Uninstall Previous Versions of Teradata
Tools and Utilities
Prior to installing new Teradata Tools and Utilities software, all existing Teradata Tools and
Utilities software must be uninstalled. A menu item has been added to remove Teradata Tools
and Utilities software. Always uninstall the previous version of the Teradata Tools and Utilities
before starting a new installation.
Uninstall Previous Versions of Teradata Tools and Utilities
• Follow the Uninstall Order - See Uninstalling Previous Versions on Linux for
instructions. Uninstall Teradata Tools and Utilities products in the following order:
1 Products other than the following 4 products
2 Teradata Data Connector (piom)
3 Call-Level Interface version 2 (cliv2)
4 Shared Common Components for Internationalization for Teradata (tdicu)
5 Teradata Generic Security Services (teragss)
Step 4: Install Third-Party Software
Dependencies
Some Teradata Tools and Utilities products require the installation of third-party software.
Most third-party dependency software can be installed from the manufacturer’s website. Links
are provided where known.
Install Third-Party Software
Install the third-party software listed for each product. Where available, the download site or
product information site is shown.
29. Chapter 2: Installing to Linux from CD Media
Step 4: Install Third-Party Software Dependencies
Teradata Tools and Utilities Installation Guide for UNIX and Linux 29
Teradata JDBC Driver
• JDK 1.4, JDK 5.0, or JDK 6.0 from Sun
http://java.sun.com/javase/downloads/index_jdk5.jsp
http://java.sun.com/javase/downloads/index.jsp
• JDK 5.0
• JDK 6.0
Teradata Parallel Transporter Infrastructure
• Java 2 Runtime Environment 1.4.2_06 or later
http://java.sun.com/products/archive
Teradata WebSphere MQ Access Module
• IBM® WebSphere® MQ 5.2
http://www-01.ibm.com/software/data/masterdata/product-info/library/
documentation.html
Compiler and Linker for SUSE Linux Enterprise Server 11
The required library, libstdc++-libc6.2-2.so.3, does not come as part of the standard SLES 11
installation. Download and install this library.
• libstdc++-libc6.2-2.so.3
http://rpmfind.net/linux/RPM/redhat/9/i386/compat-libstdc++-7.3-2.96.118.i386.html
Compiler and Linker for RedHat Linux AS 3.0
The required library, libstdc++.so.5 is included in the operating system as part of the standard
RedHat AS 3.0 installation.
Compiler and Linker for RedHat Linux AS 4.0
The required libraries, libstdc++.so.6 and libstdc++.so.5 are included as part of the standard
RedHat AS 4.0 installation.
Compiler and Linker for RedHat Linux AS 5.0
The library, libstdc++.so.5 does not come as part of the standard RedHat AS 5.0 installation.
Download and install this library by downloading and installing:
• compat-libstdc++-33-3.2.3-61 to download libstdc++-libc6.2-2.so.3
http://rpm.pbone.net/index.php3?stat=26&dist=0&size=237109&name=compat-
libstdc%2B%2B-33-3.2.3-61.i386.rpm
OR
• compat-libstdc++-8-3.3.4.2.i386.rpm to download both libstdc++-libc6.2-2.so.3 and
libstdc++-libc6.2-2.so.5
http://rpm.pbone.net/index.php3?stat=26&dist=0&size=666891&name=compat-
libstdc%2B%2B-8-3.3.4.2.i386.rpm
30. Chapter 2: Installing to Linux from CD Media
Step 5: Install Teradata Tools and Utilities from the CD Media
30 Teradata Tools and Utilities Installation Guide for UNIX and Linux
Step 5: Install Teradata Tools and Utilities from
the CD Media
• Follow the Install Order - When installing “all” packages through the Main Install, the
installer will install packages in the correct order. When installing individual products,
they must be installed in the following order.
1 Teradata Generic Security Services (teragss)
2 Shared Common Components for Internationalization for Teradata (tdicu)
3 Call-Level Interface version 2 (cliv2)
4 Teradata Data Connector (piom)
5 Any other products
Warning: For ODBC on all platforms, since the installation process now installs both 32-bit and 64-bit
versions of the ODBC driver, both the 32-bit and 64-bit versions of TeraGSS must be installed
before installing ODBC.
Note: Using the main install will install all products and their dependencies in the correct
order. Using an alternative method to do the install requires that the products be installed
manually in the correct order.
Install Teradata Tools and Utilities on Linux
This section contains the procedure to install Teradata Tools and Utilities products on Linux
operating systems.
Procedure - Installing Teradata Tools and Utilities Products on Linux
Follow these steps to install Teradata Tools and Utilities products on Linux client operating
systems.
1 Log on to the Linux client as root.
2 If a /mnt directory does not exist, create one
# mkdir /mnt
where: the CD-ROM mount point is /mnt, although an alternate may be used.
3 Insert the installation CD, Teradata Utility Pack for HP-UX - Linux - Vol 2 of 3, into the
CD-ROM drive, then enter the following command at the prompt:
# mount /dev/<cdrom device name> /mnt
For example, if the CD-ROM device name is cdrom, enter:
# mount /dev/cdrom /mnt
In the example, the CD-ROM mount point is /mnt, although an alternate may be entered.
4 To begin the installation process, enter:
# cd /mnt
# ./setup.bat
31. Chapter 2: Installing to Linux from CD Media
Step 5: Install Teradata Tools and Utilities from the CD Media
Teradata Tools and Utilities Installation Guide for UNIX and Linux 31
A screen similar to the following appears:
Copyright 2002-2010. Teradata Corporation. All Rights Reserved.
Platform: Linux 32bit (i386)
Media: Load/Unload
Which software do you want to install?
1. teragss - Teradata GSS client package
2. tdicu - Teradata Shared Component for Internationalization
3. tdodbc - Teradata ODBC Driver
4. cliv2 - Teradata CLIv2
5. piom - Teradata Data Connector API
6. npaxsmod - Teradata Named Pipes Access Module
7. mqaxsmod - Teradata WebSphere(r) MQ Access Module
8. bteq - Teradata BTEQ Application
9. fastexp - Teradata FastExport Utility
10. fastld - Teradata FastLoad Utility
11. mload - Teradata MultiLoad Utility
12. tpump - Teradata TPump Utility
13. qrydir - Teradata Query Director
a. Install all of the above software
u. Remove previously installed Teradata Tools and Utilities software
q. Quit the installation
Enter one or more selections (separated by space):
5 Select the packages to install. Software must be installed in the following order:
1 Teradata Generic Security Services (teragss)
2 Shared Common Components for Internationalization for Teradata (tdicu)
3 Call-Level Interface version 2 (cliv2)
4 Teradata Data Connector (piom)
5 Other Products
6 After reviewing product dependencies, enter the products to install at the prompt:
• One or more numbers for the product(s), separated by spaces, or
Command Action
Install All
Packages
Enter a. The number of products selected appears in the bottom right hand
corner of the screen. The packages selected for installation have an asterisk beside
them.
Uninstall All Enter u. Removes previous versions of Teradata Tools and Utilities products,
except for Teradata Generic Security Services (TeraGSS).
32. Chapter 2: Installing to Linux from CD Media
Step 6: Install Drivers from the Teradata Download Center
32 Teradata Tools and Utilities Installation Guide for UNIX and Linux
7 Change back to the root directory and unmount the CD:
# umount /mnt
8 Remove the installation CD from the CD-ROM drive and repeat the procedure for each
Linux CD in the installation kit.
• Preprocessors for HP-UX - Linux - Vol. 2 of 3
• Load/Unload for HP-UX - Linux - Vol. 2 of 3
• Parallel Transporter for HP-UX - Linux - Vol. 2 of 3
• Tape Storage Enablers for Linux - Windows
• Meta Data Services for Linux - MPRAS (RSG) - Windows
9 When done installing products, remove the installation CD from the CD-ROM drive.
Step 6: Install Drivers from the Teradata
Download Center
• Installing from the Teradata Download Center - [Optional] Install products from the
Teradata Download Center. All products are not available.
Step 7: Install Patches from the Teradata
Software Server
• Installing from the Teradata Software Server - [Optional] Install the most recent critical
post-production product updates from the Teradata Software Server.
Install Selected
Packages
Enter 1, 2, ...n. Products and dependencies associated with the numbers will be
installed.
• Dependencies: If individual products are going to be installed, first determine
the product dependencies, such as CLIv2 or Data Connector API (PIOM),
and enter the numbers for the dependencies at the prompt: one or more
numbers for the product(s) to be installed, separated by spaces.
For information on dependent products, see Product Dependencies
• Products: Enter numbers for the dependencies at the prompt: one or more
numbers for the product(s) to be installed, separated by spaces.
Quit Enter q to quit the installation.
Command Action
33. Chapter 2: Installing to Linux from CD Media
Step 8: Add CLI User Exit Functions
Teradata Tools and Utilities Installation Guide for UNIX and Linux 33
Step 8: Add CLI User Exit Functions
• Adding CLI User Exit Functions - [Optional] CLI User Exit functions are general purpose
facilities that can be added to the CLI workstation architecture on client systems after the
products have been installed. These functions allow user-defined processing to take place.
Step 9: Install Teradata Meta Data Services
To install the latest version of Teradata Meta Data Services and its associated products, go to:
• Installing Teradata Meta Data Services on Linux
• Installing Automatic DIM Update
Step 10: Configure Products
After the installation is complete, before restarting the client system, edit environment
variable names, configure products.
• Configuring Teradata Tools and Utilities
Step 11: Restart the Client Computer
In most cases, the client computer does not require a restart. Reboot if the client installation
requires it.
Note: Teradata Parallel Transporter adds some kernel modifications which require a
computer restart.
Step 12: Verify the Installation
Verify the installation of individual Teradata Tools and Utilities products using one of the
following methods:
• Verifying the Installation Using BTEQ - Verify the installation using BTEQ.
• Verifying Installation Using CLI Sample Program - Verify the installation using the CLI
Sample program on the installed files.
• Checking Files and Folders on Linux - Verify the installation by comparing a list of folder
and file names for each product.
34. Chapter 2: Installing to Linux from CD Media
Step 13: Deploying Across the Network
34 Teradata Tools and Utilities Installation Guide for UNIX and Linux
Step 13: Deploying Across the Network
If you decide to deploy across the network go to the following chapter:
• Deploying Across the Network
Reference Material
The information in this section is provided as additional reference material useful in logging
onto the database, and troubleshooting a Teradata Tools and Utilities installation.
Teradata Tools and Utilities Directory Layout
The Teradata Tools and Utilities directory is the combination of the user-specified base
directory, the Teradata Tools and Utilities fixed directory, and the Teradata Tools and Utilities
release directory. The installation package allows the selection of a starting location, where the
release is installed. The default location is /opt.
Security and Connecting to a Teradata Database
Security and Connecting to a Teradata Database contains information helpful in
understanding the security schemes used in Teradata and making a successful connection to a
Teradata Database.
Base Directory Fixed Directory Release Directory
/opt teradata/client/13.10/ bin
bin64
include
lib
lib64
odbc
odbc_32
odbe_64
sample
tbuild
tdicu
ODBC_32
ODBC_64
35. Chapter 2: Installing to Linux from CD Media
Reference Material
Teradata Tools and Utilities Installation Guide for UNIX and Linux 35
Troubleshooting the Installation
Troubleshooting the Installation - Contains information helpful in troubleshooting problems
that may arise while installing Teradata Tools and Utilities products.
36. Chapter 2: Installing to Linux from CD Media
Reference Material
36 Teradata Tools and Utilities Installation Guide for UNIX and Linux
37. Teradata Tools and Utilities Installation Guide for UNIX and Linux 37
CHAPTER 3
Installing to IBM AIX from CD Media
Follow these steps to Install one or more Teradata Tools and Utilities products from the
Teradata Tools and Utilities installation Kit CD Media to IBM AIX clients.
Step 1: Inspect the Installation Kit
Inspect the Installation Kit CDs
• Installation Kit - Lists the Installation Kit CDs and indicates the CDs where products and
their dependencies are located. Inspect the Teradata Tools and Utilities Installation Kit for
completeness, and determine which CDs contain the products and the dependencies being
installed. Because of space limitations, products on some installation CDs are segregated
by platform.
Step 2: Review Platforms, Products,
Dependencies and Requirements
Determine if the products being installed are compatible with and supported by the client.
Then determine if the minimum system requirements have been met, and which products
have dependencies which have to be loaded.
Determine if Platforms and Products are Compatible
Links to a spreadsheet which lists the UNIX, Linux, Windows and mainframe platforms and
the products supported by each release of Teradata Tools and Utilities are located at:
• http://www.info.teradata.com
Links to the current and last two major releases are included below:
• Teradata Tools and Utilities 12.00.xx Supported Versions - [12.00.xx]
• Teradata Tools and Utilities 13.00.xx Supported Versions - [13.00.xx]
• Teradata Tools and Utilities 13.10.xx Supported Versions - [13.10.xx]
Read Product Descriptions and Determine Product Dependencies
• Product Descriptions - Lists a synopsis of each of the products available.
38. Chapter 3: Installing to IBM AIX from CD Media
Step 3: Uninstall Previous Versions of Teradata Tools and Utilities
38 Teradata Tools and Utilities Installation Guide for UNIX and Linux
• Product Dependencies - Lists the Teradata Tools and Utilities dependencies and third-
party dependencies. If installing from the main install, all Teradata Tools and Utilities
product dependencies are verified, and if not available, are installed automatically.
• Third-Party Dependencies - Third-party products must be installed before installing any
Teradata Tools and Utilities Products. This software is not contained on the installation
CDs. Most are available from the manufacturer’s website.
Determine if System Requirements have been Met
• System Requirements - Minimum system requirements to install Teradata Tools and
Utilities
Step 3: Uninstall Previous Versions of Teradata
Tools and Utilities
Prior to installing new Teradata Tools and Utilities software, all existing Teradata Tools and
Utilities software must be uninstalled. A menu item has been added to remove Teradata Tools
and Utilities software. Always uninstall the previous version of the Teradata Tools and Utilities
before starting a new installation.
Uninstall Previous Versions of Teradata Tools and Utilities
• Follow the Uninstall Order - See Uninstalling Previous Versions on UNIX Systems for
instructions. Uninstall Teradata Tools and Utilities products in the following order:
1 Products other than 2 through 5
2 Teradata Data Connector (piom)
3 Call-Level Interface version 2 (cliv2)
4 Shared Common Components for Internationalization for Teradata (tdicu)
5 Teradata Generic Security Services (teragss)
Step 4: Install Third-Party Software
Dependencies
Some Teradata Tools and Utilities products require the installation of third-party software.
Most third-party dependency software can be installed from the manufacturer’s website. Links
are provided where known.
Install Third-Party Software
Install the third-party software listed for each product. Where available, the download site or
product information site is shown.
39. Chapter 3: Installing to IBM AIX from CD Media
Step 5: Install Teradata Tools and Utilities from the CD Media
Teradata Tools and Utilities Installation Guide for UNIX and Linux 39
IBM XL C/C++ Compiler
• Although versions of AIX support IBM XL C/C++ Compiler v7.0 (runtime libraries fileset
xlC.rte v7.x.x.x) through IBM XL C/C++ Compiler v10.0 (runtime libraries fileset xlC.rte
v10.x.x.x), IBM XL C/C++ Compiler v9.0 (runtime libraries fileset xlC.rte v9.x.x.x) or
later must be used since TDICU has been compiled with v9.0, otherwise runtime errors
such as unresolved symbols from libC.a will occur.
http://www-01.ibm.com/support/docview.wss?rs=2239&uid=swg24015997
Teradata JDBC Driver
• JDK 1.4, JDK 5.0, or JDK 6.0 from Sun
http://java.sun.com/javase/downloads/index_jdk5.jsp
http://java.sun.com/javase/downloads/index.jsp
• JDK 5.0
• JDK 6.0
Teradata Parallel Transporter Infrastructure
• Java 2 Runtime Environment 1.4.2_06 or later
http://java.sun.com/products/archive
Teradata WebSphere MQ Access Module
• IBM® WebSphere® MQ 5.2
http://www-01.ibm.com/software/data/masterdata/product-info/library/
documentation.html
Step 5: Install Teradata Tools and Utilities from
the CD Media
• Follow the Install Order - When installing “all” packages through the Main Install, the
installer will install packages in the correct order. When installing individual products,
they must be installed in the following order.
1 Teradata Generic Security Services (teragss)
2 Shared Common Components for Internationalization for Teradata (tdicu)
3 Call-Level Interface version 2 (cliv2)
4 Teradata Data Connector (piom)
5 Any other products
Warning: For ODBC on all platforms, since the installation process now installs both 32-bit and 64-bit
versions of the ODBC driver, both the 32-bit and 64-bit versions of TeraGSS must be installed
before installing ODBC.
40. Chapter 3: Installing to IBM AIX from CD Media
Step 5: Install Teradata Tools and Utilities from the CD Media
40 Teradata Tools and Utilities Installation Guide for UNIX and Linux
Note: Using the main install will install all products and their dependencies in the correct
order. Using an alternative method to do the install requires that the products be installed
manually in the correct order.
Install Teradata Tools and Utilities on IBM AIX Clients
Teradata Tools and Utilities that can be installed on an IBM AIX client.
Procedure - Installing Teradata Tools and Utilities on an IBM AIX Client
Follow these steps to install Teradata Tools and Utilities on an IBM AIX client.
1 Log on to the IBM AIX client system as root user.
2 If a /mnt directory does not exist, create one:
# mkdir /mnt
3 Insert the installation CD, Teradata Utility Pack for AIX-Solaris - Vol 3 of 3, into the CD-
ROM drive and enter:
# mount -V cdrfs -o ro /dev/<cd-rom device> /mnt
For device name, cd0, the entry is:
# mount -V cdrfs -o ro /dev/cd0 /mnt
where: the CD-ROM mount point is /mnt.
4 To begin the installation, enter:
# cd /mnt
# ./setup.bat
A screen similar to the following appears:
Welcome to the Teradata Tools and Utilities 13.10.00.00 installation
Copyright 2010. Teradata Corporation. All Rights Reserved.
Media: Load/Unload
Platform: AIX
Which software do you want to install?
1. TeraGSS - Teradata GSS client package
2. tdicu - Teradata Shared Component for Internationalization
3. tdodbc - Teradata ODBC Driver
4. cliv2 - Teradata CLIv2
5. piom - Teradata Data Connector API
6. npaxsmod - Teradata Named Pipes Access Module
7. mqaxsmod - Teradata WebSphere(r) MQ Access Module
8. bteq - Teradata BTEQ Application
9. fastexp - Teradata FastExport Utility
10. fastld - Teradata FastLoad Utility
11. mload - Teradata MultiLoad Utility
12. tpump - Teradata TPump Utility
a. Install all of the above software
u. Remove previously installed Teradata Tools and Utilities software
q. Quit the installation
Enter one or more selection (separated by space):
41. Chapter 3: Installing to IBM AIX from CD Media
Step 6: Install Drivers from the Teradata Download Center
Teradata Tools and Utilities Installation Guide for UNIX and Linux 41
5 Select the packages to install. Software must be installed in the following order:
1 Teradata Generic Security Services (teragss)
2 Shared Common Components for Internationalization for Teradata (tdicu)
a Call-Level Interface version 2 (cliv2)
3 Teradata Data Connector (piom)
4 Other Products
5 After reviewing product dependencies, enter the products to install at the prompt:
• One or more numbers for the product(s), separated by spaces, or
• a to install all the software,
• u to remove previously installed Teradata Tools and Utilities software
• q to quit the installation
6 After all installations are complete, change back to the root directory and unmount the CD
by entering the following at the command prompt:
# umount /mnt
7 Remove the installation CD from the CD-ROM drive and repeat the procedure for each of
the IBM AIX CDs in the installation kit.
• Preprocessors for AIX-Solaris - Vol. 3 of 3
• Load/Unload for AIX-Solaris - Vol. 3 of 3
• Parallel Transporter for AIX-Solaris - Vol. 3 of 3
8 When done installing products, remove the installation CD from the CD-ROM drive.
Step 6: Install Drivers from the Teradata
Download Center
• Installing from the Teradata Download Center - [Optional] Install products from the
Teradata Download Center. All products are not available.
Step 7: Patches from the Teradata Software
Server
• Installing from the Teradata Software Server - [Optional] Install the most recent critical
post-production product updates from the Teradata Software Server.
42. Chapter 3: Installing to IBM AIX from CD Media
Step 8: Add CLI User Exit Functions
42 Teradata Tools and Utilities Installation Guide for UNIX and Linux
Step 8: Add CLI User Exit Functions
• Adding CLI User Exit Functions - [Optional] CLI User Exit functions are general purpose
facilities that can be added to the CLI workstation architecture on client systems after the
products have been installed. These functions allow user-defined processing to take place.
Step 9: Configure Products
After the installation is complete, before restarting the client system, edit environment
variable names, configure products.
• Configuring Teradata Tools and Utilities
Step 10: Restart the Client Computer
After editing environment variables and configuring products, always restart the client
computer to ensure that environment variables are setup correctly, and to allow file upgrades
to complete.
Step 11: Verify the Installation
Verify the installation of individual Teradata Tools and Utilities products using one of the
following methods:
• Verifying the Installation Using BTEQ - Verify the installation using BTEQ.
• Verifying Installation Using CLI Sample Program - Verify the installation using the CLI
Sample program on the installed files.
• Checking Files and Folders on UNIX Systems - Verify the installation by comparing a list
of folder and file names for each product.
Step 12: Deploying Across the Network
If you decide to deploy across the network go to the following chapter:
• Deploying Across the Network
43. Chapter 3: Installing to IBM AIX from CD Media
Reference Material
Teradata Tools and Utilities Installation Guide for UNIX and Linux 43
Reference Material
The information in this section is provided as additional reference material useful in logging
onto the database, and troubleshooting a Teradata Tools and Utilities installation
Teradata Tools and Utilities Directory Layout
The Teradata Tools and Utilities directory is the combination of the user-specified base
directory, the Teradata Tools and Utilities fixed directory, and the Teradata Tools and Utilities
release directory. The installation package allows the selection of a starting location, where the
release is installed. The default location is /opt.
Security and Connecting to a Teradata Database
Security and Connecting to a Teradata Database - Contains information helpful in
understanding the security schemes used in Teradata and making a successful connection to a
Teradata Database.
Troubleshooting the Installation
Troubleshooting the Installation - Contains information helpful in troubleshooting problems
that may arise while installing Teradata Tools and Utilities products.
Session Limits
Session Limits - Lists Teradata session limits for Basic Teradata Query (BTEQ) and for the
entire system.
Base Directory Fixed Directory Release Directory
/opt teradata/client/13.10/ bin
include
lib
lib64
odbc
odbc_32
odbe_64
sample
tbuild
tdicu
ODBC_32
ODBC_64
44. Chapter 3: Installing to IBM AIX from CD Media
Reference Material
44 Teradata Tools and Utilities Installation Guide for UNIX and Linux
45. Teradata Tools and Utilities Installation Guide for UNIX and Linux 45
CHAPTER 4
Installing to HP-UX and HP-UX Itanium
from CD Media
Follow these steps to Install one or more Teradata Tools and Utilities products from the
Teradata Tools and Utilities installation Kit CD Media to HP-UX and HP-UX Itanium clients.
Step 1: Inspect the Installation Kit
Inspect the Installation Kit CDs
• Installation Kit - Lists the Installation Kit CDs and indicates the CDs where products and
their dependencies are located. Inspect the Teradata Tools and Utilities Installation Kit for
completeness, and determine which CDs contain the products and the dependencies being
installed. Because of space limitations, products on some installation CDs are segregated
by platform
Step 2: Review Platforms, Products,
Dependencies and Requirements
Determine if the products being installed are compatible with and supported by the client.
Then determine if the minimum system requirements have been met, and which products
have dependencies which have to be loaded.
Determine if Platforms and Products are Compatible
Links to a spreadsheet which lists the UNIX, Linux, Windows and mainframe platforms and
the products supported by each release of Teradata Tools and Utilities are located at:
• http://www.info.teradata.com
Links to the current and last two major releases are included below:
• Teradata Tools and Utilities 12.00.xx Supported Versions - [12.00.xx]
• Teradata Tools and Utilities 13.00.xx Supported Versions - [13.00.xx]
• Teradata Tools and Utilities 13.10.xx Supported Versions - [13.10.xx]
Read Product Descriptions and Determine Product Dependencies
• Product Descriptions - Lists a synopsis of each of the products available.
46. Chapter 4: Installing to HP-UX and HP-UX Itanium from CD Media
Step 3: Uninstall Previous Versions of Teradata Tools and Utilities
46 Teradata Tools and Utilities Installation Guide for UNIX and Linux
• Product Dependencies - Lists the Teradata Tools and Utilities dependencies and third-
party dependencies. If installing from the main install, all Teradata Tools and Utilities
product dependencies are verified, and if not available, are installed automatically.
• Third-Party Dependencies - Third-party products must be installed before installing any
Teradata Tools and Utilities Products. This software is not contained on the installation
CDs. Most are available from the manufacturer’s website.
Determine if System Requirements have been Met
• System Requirements - Minimum system requirements to install Teradata Tools and
Utilities
Step 3: Uninstall Previous Versions of Teradata
Tools and Utilities
Prior to installing new Teradata Tools and Utilities software, all existing Teradata Tools and
Utilities software must be uninstalled. A menu item has been added to remove Teradata Tools
and Utilities software. Always uninstall the previous version of the Teradata Tools and Utilities
before starting a new installation.
Uninstall Previous Versions of Teradata Tools and Utilities
• Follow the Uninstall Order - See Uninstalling Previous Versions on UNIX Systems for
instructions. Uninstall Teradata Tools and Utilities products in the following order:
1 Products other than 2 through 5
2 Teradata Data Connector (piom)
3 Call-Level Interface version 2 (cliv2)
4 Shared Common Components for Internationalization for Teradata (tdicu)
5 Teradata Generic Security Services (teragss)
Step 4: Install Third-Party Software
Dependencies
Some Teradata Tools and Utilities products require the installation of third-party software.
Most third-party dependency software can be installed from the manufacturer’s website. Links
are provided where known.
Install Third-Party Software
Install the third-party software listed for each product. Where available, the download site or
product information site is shown.
47. Chapter 4: Installing to HP-UX and HP-UX Itanium from CD Media
Step 5: Install Teradata Tools and Utilities from the CD Media
Teradata Tools and Utilities Installation Guide for UNIX and Linux 47
Teradata JDBC Driver
• JDK 1.4, JDK 5.0, or JDK 6.0 from Sun
http://java.sun.com/javase/downloads/index_jdk5.jsp
http://java.sun.com/javase/downloads/index.jsp
• JDK 5.0
• JDK 6.0
Teradata Parallel Transporter Infrastructure
• Java 2 Runtime Environment 1.4.2_06 or later
http://java.sun.com/products/archive
Teradata WebSphere MQ Access Module
• IBM® WebSphere® MQ 5.2
http://www-01.ibm.com/software/data/masterdata/product-info/library/
documentation.html
Step 5: Install Teradata Tools and Utilities from
the CD Media
• Follow the Install Order - When installing “all” packages through the Main Install, the
installer will install packages in the correct order. When installing individual products,
they must be installed in the following order.
1 Teradata Generic Security Services (teragss)
2 Shared Common Components for Internationalization for Teradata (tdicu)
3 Call-Level Interface version 2 (cliv2)
4 Teradata Data Connector (piom)
5 Any other products
Warning: For ODBC on all platforms, since the installation process now installs both 32-bit and 64-bit
versions of the ODBC driver, both the 32-bit and 64-bit versions of TeraGSS must be installed
before installing ODBC.
Note: Using the main install will install all products and their dependencies in the correct
order. Using an alternative method to do the install requires that the products be installed
manually in the correct order.
Install Teradata Tools and Utilities on HP-UX and HP-UX Itanium
This section contains the procedure to install Teradata Tools and Utilities products on HP-UX
and HP-UX Itanium operating systems.
48. Chapter 4: Installing to HP-UX and HP-UX Itanium from CD Media
Step 5: Install Teradata Tools and Utilities from the CD Media
48 Teradata Tools and Utilities Installation Guide for UNIX and Linux
Procedure - Installing Teradata Tools and Utilities Products on HP-UX and HP-UX
Itanium
Follow these steps to install the Teradata Tools and Utilities products on HP-UX and HP-UX
Itanium client operating systems:
1 Log on to the HP-UX or HP-UX Itanium client as the root user.
2 If a /mnt directory does not exist, create one:
# mkdir /mnt
where: the CD-ROM mount point is /mnt.
3 Insert the installation CD, Teradata Utility Pack for HP-UX -Linux - Vol 2 of 3, into the CD-
ROM drive, then enter the following:
# mount /dev/dsk/<device name> /mnt
For example, if the CD-ROM device name is c0t1d0:
# mount /dev/dsk/c0t1d0 /mnt
where: the CD-ROM mount point is /mnt.
Note: To find a CD-ROM device, enter the following:
ioscan -fnC disk
4 To begin the installation process, enter:
# cd /mnt
# ./setup.bat
A screen similar to the following appears.
Welcome to the Teradata Tools and Utilities 13.10 installation
Copyright 2002-2010. Teradata Corporation. All Rights Reserved.
Media: Load/Unload
Platform: HP-UX
Which software do you want to install?
1. TeraGSS - Teradata GSS client package
2. tdicu - Teradata Shared Component for Internationalization
3. tdodbc - Teradata ODBC Driver
4. cliv2 - Teradata CLIv2
5. piom - Teradata Data Connector API
6. npaxsmod - Teradata Named Pipes Access Module
7. mqaxsmod - Teradata WebSphere(r) MQ Access Module
8. bteq - Teradata BTEQ Application
9. fastexp - Teradata FastExport Utility
10. fastld - Teradata FastLoad Utility
11. mload - Teradata MultiLoad Utility
12. tpump - Teradata TPump Utility
a. Install all of the above software
u. Remove previously installed Teradata Tools and Utilities software
q. Quit the installation
Enter one or more selection (separated by space):
Note: Teradata Parallel Transporter packages are contained on Load/Unload CD #2.
5 Select the packages to install. Software must be installed in the following order: