Teradata Tools and Utilities - dbmanagement.infodbmanagement.info/Books/MIX/2407_TeraData.pdf ·...

of 166 /166
Teradata Tools and Utilities Installation Guide for Microsoft Windows Release 12.00.00 B035-2407-067A September 2007

Embed Size (px)

Transcript of Teradata Tools and Utilities - dbmanagement.infodbmanagement.info/Books/MIX/2407_TeraData.pdf ·...

Page 1: Teradata Tools and Utilities - dbmanagement.infodbmanagement.info/Books/MIX/2407_TeraData.pdf · Teradata Tools and Utilities Installation Guide for Microsoft Windows 7 ... Software

Teradata Tools and UtilitiesInstallation Guide for Microsoft Windows

Release 12.00.00B035-2407-067ASeptember 2007

Page 2: Teradata Tools and Utilities - dbmanagement.infodbmanagement.info/Books/MIX/2407_TeraData.pdf · Teradata Tools and Utilities Installation Guide for Microsoft Windows 7 ... Software

The product or products described in this book are licensed products of Teradata Corporation or its affiliates.

Teradata, BYNET, DBC/1012, DecisionCast, DecisionFlow, DecisionPoint, Eye logo design, InfoWise, Meta Warehouse, MyCommerce, SeeChain, SeeCommerce, SeeRisk, Teradata Decision Experts, Teradata Source Experts, WebAnalyst, and You’ve Never Seen Your Business Like This Before are trademarks or registered trademarks of Teradata Corporation or its affiliates.

Adaptec and SCSISelect are trademarks or registered trademarks of Adaptec, Inc.

AMD Opteron and Opteron are trademarks of Advanced Micro Devices, Inc.

BakBone and NetVault are trademarks or registered trademarks of BakBone Software, Inc.

EMC, PowerPath, SRDF, and Symmetrix are registered trademarks of EMC Corporation.

GoldenGate is a trademark of GoldenGate Software, Inc.

Hewlett-Packard and HP are registered trademarks of Hewlett-Packard Company.

Intel, Pentium, and XEON are registered trademarks of Intel Corporation.

IBM, CICS, DB2, MVS, RACF, Tivoli, and VM are registered trademarks of International Business Machines Corporation.

Linux is a registered trademark of Linus Torvalds.

LSI and Engenio are registered trademarks of LSI Corporation.

Microsoft, Active Directory, Windows, Windows NT, and Windows Server are registered trademarks of Microsoft Corporation in the United States and other countries.

Novell and SUSE are registered trademarks of Novell, Inc., in the United States and other countries.

QLogic and SANbox trademarks or registered trademarks of QLogic Corporation.

SAS and SAS/C are trademarks or registered trademarks of SAS Institute Inc.

SPARC is a registered trademarks of SPARC International, Inc.

Sun Microsystems, Solaris, Sun, and Sun Java are trademarks or registered trademarks of Sun Microsystems, Inc., in the United States and other countries.

Symantec, NetBackup, and VERITAS are trademarks or registered trademarks of Symantec Corporation or its affiliates in the United States and other countries.

Unicode is a collective membership mark and a service mark of Unicode, Inc.

UNIX is a registered trademark of The Open Group in the United States and other countries.

Other product and company names mentioned herein may be the trademarks of their respective owners.

THE INFORMATION CONTAINED IN THIS DOCUMENT IS PROVIDED ON AN “AS-IS” BASIS, WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING THE IMPLIED WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, OR NON-INFRINGEMENT. SOME JURISDICTIONS DO NOT ALLOW THE EXCLUSION OF IMPLIED WARRANTIES, SO THE ABOVE EXCLUSION MAY NOT APPLY TO YOU. IN NO EVENT WILL TERADATA CORPORATION BE LIABLE FOR ANY INDIRECT, DIRECT, SPECIAL, INCIDENTAL, OR CONSEQUENTIAL DAMAGES, INCLUDING LOST PROFITS OR LOST SAVINGS, EVEN IF EXPRESSLY ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.

The information contained in this document may contain references or cross-references to features, functions, products, or services that are not announced or available in your country. Such references do not imply that Teradata Corporation intends to announce such features, functions, products, or services in your country. Please consult your local Teradata Corporation representative for those features, functions, products, or services available in your country.

Information contained in this document may contain technical inaccuracies or typographical errors. Information may be changed or updated without notice. Teradata Corporation may also make improvements or changes in the products or services described in this information at any time without notice.

To maintain the quality of our products and services, we would like your comments on the accuracy, clarity, organization, and value of this document. Please e-mail: [email protected]

Any comments or materials (collectively referred to as “Feedback”) sent to Teradata Corporation will be deemed non-confidential. Teradata Corporation will have no obligation of any kind with respect to Feedback and will be free to use, reproduce, disclose, exhibit, display, transform, create derivative works of, and distribute the Feedback and derivative works thereof without limitation on a royalty-free basis. Further, Teradata Corporation will be free to use any ideas, concepts, know-how, or techniques contained in such Feedback for any purpose whatsoever, including developing, manufacturing, or marketing products or services incorporating Feedback.

Copyright © 1996-2007 by Teradata Corporation. All Rights Reserved.

Page 3: Teradata Tools and Utilities - dbmanagement.infodbmanagement.info/Books/MIX/2407_TeraData.pdf · Teradata Tools and Utilities Installation Guide for Microsoft Windows 7 ... Software

Preface

Purpose

This book provides information about installing the Teradata Tools and Utilities Release 12.00.00 software on a computer that runs on a Windows operating system. 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 12.00.00

• Teradata Tools and Utilities 12.00.00

To locate detailed supported-release information:

1 Go to www.info.teradata.com.

2 Navigate to General Search>Publication Product ID.

3 Enter 3119.

4 Open the version of the Teradata Tools and Utilities 12.00.00 Supported Versions spreadsheet associated with this release.

The spreadsheet includes supported Teradata Database versions, platforms, and product release numbers.

Prerequisites

The following prerequisite knowledge is required for this product:

Teradata Tools and Utilities Installation Guide for Microsoft Windows 3

Page 4: Teradata Tools and Utilities - dbmanagement.infodbmanagement.info/Books/MIX/2407_TeraData.pdf · Teradata Tools and Utilities Installation Guide for Microsoft Windows 7 ... Software

PrefaceChanges to This Book

• 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 Release Definition associated with this release.

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.

Date and Release Description

September 200712.00.00

Removed information on Teradata “Dynamic” Query Director.

August 200712.00.00

Removed ESDM information.

July 2007

12.00.00

Updated installation procedures to reflect Teradata products added to Teradata Tools and Utilities Release 12.00.00.

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 www.info.teradata.com.

2 Select the General Search check box.

3 In the Publication Product ID box, type 2029.

4 Click Search.

5 Select the appropriate Release Definition from the search results.

4 Teradata Tools and Utilities Installation Guide for Microsoft Windows

Page 5: Teradata Tools and Utilities - dbmanagement.infodbmanagement.info/Books/MIX/2407_TeraData.pdf · Teradata Tools and Utilities Installation Guide for Microsoft Windows 7 ... Software

PrefaceAdditional Information

Additional product information

Use the Teradata Information Products Publishing Library site to view or download specific manuals that supply related or additional information to this manual.

1 Go to www.info.teradata.com.

2 Select the Teradata Data Warehousing check box.

3 Do one of the following:

• For a list of Teradata Tools and Utilities documents, click Teradata Tools and Utilities and then select a release or a specific title.

• Select a link to any of the data warehousing publications categories listed.

Specific books related to Teradata Tools and Utilities are as follows:

• MessagesB035-1096-mmyA

• Teradata Tools and Utilities Command SummaryB035-2401-mmyA

• Teradata Manager Installation GuideB035-2402-mmyA

• Teradata Driver for the JDBC Interface User GuideB035-2403-mmyA

• Teradata Tools and Utilities Installation Guide for Microsoft WindowsB035-2407-mmyA

• Teradata MultiLoad ReferenceB035-2409-mmyA

• Teradata FastExport ReferenceB035-2410-mmyA

• Teradata FastLoad ReferenceB035-2411-mmyA

• Teradata Archive/Recovery Utility ReferenceB035-2412-mmyA

• Basic Teradata Query ReferenceB035-2414-mmyA

• Teradata Director Program ReferenceB035-2416-mmyA

• Teradata Call-Level Interface Version 2 Reference for Channel-Attached SystemsB035-2417-mmyA

• Teradata Call-Level Interface Version 2 Reference for Network-Attached SystemsB035-2418-mmyA

• Teradata Transparency Series/ Application Programming Interface User GuideB035-2419-mmyA

Type of Information Description Access to Information

Teradata Tools and Utilities Installation Guide for Microsoft Windows 5

Page 6: Teradata Tools and Utilities - dbmanagement.infodbmanagement.info/Books/MIX/2407_TeraData.pdf · Teradata Tools and Utilities Installation Guide for Microsoft Windows 7 ... Software

PrefaceAdditional Information

• (Continued from the bulleted list above) in the Publication Product ID field, enter one of the following book numbers:

• Teradata Tools and Utilities Installation Guide for IBM VMB035-2422-mmyA

• Teradata Tools and Utilities Access Module Programmer Guide B035-2424-mmyA

• Teradata Tools and Utilities Access Module Reference B035-2425-mmyA

• Teradata Manager User GuideB035-2428-mmyA

• Teradata SQL Assistant for Microsoft Windows User GuideB035-2430-mmyA

• Teradata Parallel Transporter ReferenceB035-2436-mmyA

• Teradata Access Module for Tivoli Installation and User GuideB035-2444-mmyA

• Teradata Parallel Transporter User GuideB035-2445-mmyA

• Teradata Preprocessor2 for Embedded SQL Programmer GuideB035-2446-mmyA

• IBM IMS/DC Interface for Teradata ReferenceB035-2447-mmyA

• IBM CICS Interface for Teradata ReferenceB035-2448-mmyA

• Interactive Teradata Query ReferenceB035-2451-mmyA

• Interactive Teradata Query User GuideB035-2452-mmyA

• Teradata Tools and Utilities Installation Guide for IBM z/OSB035-2458-mmyA

• Teradata Tools and Utilities Installation Guide for UNIX and LinuxB035-2459-mmyA

Type of Information Description Access to Information

6 Teradata Tools and Utilities Installation Guide for Microsoft Windows

Page 7: Teradata Tools and Utilities - dbmanagement.infodbmanagement.info/Books/MIX/2407_TeraData.pdf · Teradata Tools and Utilities Installation Guide for Microsoft Windows 7 ... Software

PrefaceAdditional Information

• (Continued from the bulleted list above) in the Publication Product ID field, enter one of the following book numbers:

• Teradata System Emulation Tool User GuideB035-2492-mmyA

• OLE DB Provider for Teradata Installation and User GuideB035-2498-mmyA

• Teradata Administrator User GuideB035-2502-mmyA

• Teradata Statistics Wizard User GuideB035-2503-mmyA

• Teradata Visual Explain User GuideB035-2504-mmyA

• Teradata SQL Assistant/Web Edition User GuideB035-2505-mmyA

• Teradata Index Wizard User GuideB035-2506-mmyA

• ODBC Driver for Teradata User GuideB035-2509-mmyA

• Teradata Query Director User GuideB035-2510-mmyA

• Teradata Query Scheduler Administrator GuideB035-2511-mmyA

• Teradata Query Scheduler User GuideB035-2512-mmyA

• Teradata Dynamic Workload Manager User GuideB035-2513-mmyA

• Teradata Workload Analyzer User GuideB035-2514-mmyA

• Teradata Parallel Transporter Application Programming Interface Programmer GuideB035-2516-mmyA

• Teradata Parallel Data Pump ReferenceB035-3021-mmyA

• Teradata Meta Data Services Installation and Administration GuideB035-3118-mmyA

• Teradata Meta Data Services Programmer GuideB035-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 www.info.teradata.com.

2 Select the General Search check box.

3 In the Title or Keyword box, type CD-ROM.

4 Click Search.

Type of Information Description Access to Information

Teradata Tools and Utilities Installation Guide for Microsoft Windows 7

Page 8: Teradata Tools and Utilities - dbmanagement.infodbmanagement.info/Books/MIX/2407_TeraData.pdf · Teradata Tools and Utilities Installation Guide for Microsoft Windows 7 ... Software

PrefaceAdditional Information

Ordering information for manuals

Use the Teradata Information Products Publishing Library site to order printed versions of manuals.

1 Go to www.info.teradata.com.

2 Select the How to Order check box under Print & CD Publications.

3 Follow the ordering instructions.

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

8 Teradata Tools and Utilities Installation Guide for Microsoft Windows

Page 9: Teradata Tools and Utilities - dbmanagement.infodbmanagement.info/Books/MIX/2407_TeraData.pdf · Teradata Tools and Utilities Installation Guide for Microsoft Windows 7 ... Software

Table of Contents

Preface. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3

Purpose . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3

Audience . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3

Supported Releases . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3

Prerequisites . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3

Changes to This Book. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4

Additional Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4

Chapter 1: Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21

System Configuration Information. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22

System Requirements. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26

Software Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28

Product Dependencies . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28

Installation Kit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31

Teradata Software Server. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32

IBM VM and IBM z/OS. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32

Teradata Driver for the JDBC Interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32

Teradata Parallel Transporter Wizard . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32

Teradata Tools and Utilities CDs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32

Chapter 2: Before You Install . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41

Installation Recommendations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41

Installing on Windows Vista . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42

Installing on EM64T Systems . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42

Minimum and Recommended Configurations. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43

Shared ICU Libraries for Teradata Recommendations . . . . . . . . . . . . . . . . . . . . . . . . . . . 44

Installation of Dependent Products . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44

Teradata Generic Security Services. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45

PUT Installations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45

Teradata Tools and Utilities Installation Guide for Microsoft Windows 9

Page 10: Teradata Tools and Utilities - dbmanagement.infodbmanagement.info/Books/MIX/2407_TeraData.pdf · Teradata Tools and Utilities Installation Guide for Microsoft Windows 7 ... Software

Table of Contents

Typical, Custom, and Network Installations. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .46

Command Line Installations. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .46

Teradata Download Center Installations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .46

Teradata Parallel Transporter Installation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .46

Uninstalling Previous Software . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .47

Default Folders . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .47

Default Product Response Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .47

Restarting After Installation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .50

Technical Assistance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .51

Installing Required Software for Teradata SQL Assistant/Web Edition . . . . . . . . . . . . . . . . . .52

Installing Microsoft Internet Information Services . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .53

Installing ASP.NET for Windows Server 2003 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .53

Installing Microsoft .NET Framework (version 1.1) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .54

Installing Microsoft Visual J#.Net Redistributable Package (version 1.1) . . . . . . . . . . . . .54

Installing the Cumulative Security Patch for IIS. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .55

Changing Microsoft Internet Explorer Security Settings . . . . . . . . . . . . . . . . . . . . . . . . . .55

Changing Cookies Settings on Microsoft Internet Explorer . . . . . . . . . . . . . . . . . . . . . . . .56

Setting the Number of Client Connections . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .57

Setting the Number of Clients on Windows Vista . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .58

Updating the Teradata Parallel Transporter API . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .59

Chapter 3: Installing the Teradata Tools and Utilities Software. . . . . . . . . . .61

Types of Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .61

Installing Using PUT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .62

Installing Using the Client Main Install . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .63

Initial Procedure for Typical, Custom or Network Installations. . . . . . . . . . . . . . . . . . . . .63

Typical Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .64

Custom Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .74

Network Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .78

Installing a Package from the Command Prompt . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .80

Sample Package Folder Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .80

Installation Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .81

Configuring the Products . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .84

Installing the Teradata Driver for the JDBC Interface. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .84

Installing the OLE DB Provider for Teradata from the Download Center . . . . . . . . . . . . . . . .85

10 Teradata Tools and Utilities Installation Guide for Microsoft Windows

Page 11: Teradata Tools and Utilities - dbmanagement.infodbmanagement.info/Books/MIX/2407_TeraData.pdf · Teradata Tools and Utilities Installation Guide for Microsoft Windows 7 ... Software

Table of Contents

Chapter 4: Configuring the Teradata Tools and Utilities Software . . . . . . . 87

Configuring Teradata Administrator . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87

Configuring the ODBC Driver, Teradata Query Scheduler, and Teradata Manager . . . . . . 88

Configuring Teradata Call-Level Interface version 2 (CLIv2) for Windows . . . . . . . . . . . . . 89

Setting Network Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89

Setting Environment Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91

Setting System Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93

Adding CLI User Exit Functions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93

Configuring Teradata Parallel Transporter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94

Changing the twbcfg.ini File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94

Switching Teradata Parallel Transporter Software Versions . . . . . . . . . . . . . . . . . . . . . . . 95

User Environment Variables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97

System Environment Variable ORACLE_HOME. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98

Uninstalling Teradata Parallel Transporter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98

Order to Remove Teradata Parallel Transporter Software. . . . . . . . . . . . . . . . . . . . . . . . . 98

Configuring Teradata Access Module for JMS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99

Chapter 5: Verifying the Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101

Verifying the Installation of Individual Products . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103

Verifying Basic Teradata Query (BTEQ) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103

Verifying Named Pipes Access Module . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104

Verifying ODBC Driver for Teradata. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104

Verifying Shared ICU Libraries for Teradata . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 105

Verifying Teradata Access Module for JMS. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 106

Verifying Teradata Access Module for Tivoli . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 106

Verifying Teradata Archive/Recovery Utility (ARC) . . . . . . . . . . . . . . . . . . . . . . . . . . . . 107

Verifying Teradata C Preprocessor2. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 107

Verifying Teradata Call-Level Interface version 2 (CLIv2) . . . . . . . . . . . . . . . . . . . . . . . 107

Verifying Teradata Data Connector . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 109

Verifying Teradata Driver for the JDBC Interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 110

Verifying Teradata Dynamic Workload Manager. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 110

Verifying Teradata FastExport . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111

Verifying Teradata FastLoad . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111

Verifying Teradata MultiLoad . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 112

Verifying Teradata MultiTool. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 112

Verifying Teradata OLE DB Access Module . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113

Verifying Teradata Parallel Transporter API. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113

Teradata Tools and Utilities Installation Guide for Microsoft Windows 11

Page 12: Teradata Tools and Utilities - dbmanagement.infodbmanagement.info/Books/MIX/2407_TeraData.pdf · Teradata Tools and Utilities Installation Guide for Microsoft Windows 7 ... Software

Table of Contents

Verifying Teradata Parallel Transporter Data Connector Operator . . . . . . . . . . . . . . . . .121

Verifying Teradata Parallel Transporter DDL Operator . . . . . . . . . . . . . . . . . . . . . . . . . .121

Verifying Teradata Parallel Transporter Export Operator . . . . . . . . . . . . . . . . . . . . . . . . .122

Verifying Teradata Parallel Transporter ICU Library. . . . . . . . . . . . . . . . . . . . . . . . . . . . .122

Verifying Teradata Parallel Transporter Infrastructure . . . . . . . . . . . . . . . . . . . . . . . . . . .123

Verifying Teradata Parallel Transporter Load Operator . . . . . . . . . . . . . . . . . . . . . . . . . .125

Verifying Teradata Parallel Transporter ODBC Operator . . . . . . . . . . . . . . . . . . . . . . . . .126

Verifying Teradata Parallel Transporter Operator Support Library . . . . . . . . . . . . . . . . .126

Verifying Teradata Parallel Transporter OS Command Operator . . . . . . . . . . . . . . . . . .127

Verifying Teradata Parallel Transporter SQL Inserter Operator . . . . . . . . . . . . . . . . . . . .127

Verifying Teradata Parallel Transporter SQL Selector Operator. . . . . . . . . . . . . . . . . . . .127

Verifying Teradata Parallel Transporter Stream Operator. . . . . . . . . . . . . . . . . . . . . . . . .128

Verifying Teradata Parallel Transporter Update Operator . . . . . . . . . . . . . . . . . . . . . . . .128

Verifying Teradata Parallel Transporter Wizard. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .129

Verifying Teradata Query Scheduler Administrator. . . . . . . . . . . . . . . . . . . . . . . . . . . . . .130

Verifying Teradata Query Scheduler Client. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .130

Verifying Teradata Query Scheduler Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .130

Verifying Teradata TPump . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .131

Verifying WebSphere MQ Access Module . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .131

Verifying Teradata Workload Analyzer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .131

Verifying the Installation Using the CLI Sample Program, clisamp . . . . . . . . . . . . . . . . . . . .132

Chapter 6: Connecting to a Teradata Database. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .135

Making the Database Connection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .135

Overview of Logon Procedures . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .135

Connecting in GUI Applications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .136

Connecting in Command Line Driven Applications . . . . . . . . . . . . . . . . . . . . . . . . . . . . .138

Example Logons from the Command Line . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .139

Connecting to a Teradata Database Programmatically . . . . . . . . . . . . . . . . . . . . . . . . . . .145

Logon Error Messages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .146

Chapter 7: Troubleshooting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .147

Technical Assistance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .147

Client Computer Problems . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .147

Cannot Communicate Over the Network with Teradata Database . . . . . . . . . . . . . . . . .147

Incorrect Path Name in COPLIB . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .148

12 Teradata Tools and Utilities Installation Guide for Microsoft Windows

Page 13: Teradata Tools and Utilities - dbmanagement.infodbmanagement.info/Books/MIX/2407_TeraData.pdf · Teradata Tools and Utilities Installation Guide for Microsoft Windows 7 ... Software

Table of Contents

File localisation.dll Could Not Be Opened . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 148

File icuuctd28.dll Could Not Be Found . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 148

Incorrect Path Name in COPANOMLOG. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 149

Incorrect CLIv2 Libraries Referenced . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 149

CLIv2 DLLs Load Error . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 149

Incorrect Entries in the hosts File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 149

Missing Entries in the services File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 149

Incorrect clispb.dat Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 149

Cannot Log On from CLI Application. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 150

Cannot Log On to the Teradata Database . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 150

MSVCR71.DLL not found Message . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 150

Network Problems . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 150

Software Problems . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 151

Error Running ttu.exe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 151

Install Button Does Not Work . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 151

InstallShield 1603 Error. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 151

InstallShield 1607 Error. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 152

InstallShield 432 Error . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 154

Teradata Database Hardware Problems . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 154

Silent Installation Result Codes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 156

Location of the Setup Log . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 156

InstallShield Result Codes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 156

Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 159

Teradata Tools and Utilities Installation Guide for Microsoft Windows 13

Page 14: Teradata Tools and Utilities - dbmanagement.infodbmanagement.info/Books/MIX/2407_TeraData.pdf · Teradata Tools and Utilities Installation Guide for Microsoft Windows 7 ... Software

Table of Contents

14 Teradata Tools and Utilities Installation Guide for Microsoft Windows

Page 15: Teradata Tools and Utilities - dbmanagement.infodbmanagement.info/Books/MIX/2407_TeraData.pdf · Teradata Tools and Utilities Installation Guide for Microsoft Windows 7 ... Software

List of Figures

Figure 1: Typical Connect to Teradata Database Dialog . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 136

Teradata Tools and Utilities Installation Guide for Microsoft Windows 15

Page 16: Teradata Tools and Utilities - dbmanagement.infodbmanagement.info/Books/MIX/2407_TeraData.pdf · Teradata Tools and Utilities Installation Guide for Microsoft Windows 7 ... Software

List of Figures

16 Teradata Tools and Utilities Installation Guide for Microsoft Windows

Page 17: Teradata Tools and Utilities - dbmanagement.infodbmanagement.info/Books/MIX/2407_TeraData.pdf · Teradata Tools and Utilities Installation Guide for Microsoft Windows 7 ... Software

List of Tables

Table 1: Platforms Supported by Each Product . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22

Table 2: Product Dependencies . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28

Table 3: Teradata Utility Pak CD#1 (Windows Products) . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32

Table 4: Teradata Utility Pak CD#2 (HP-UX, Linux and MP-RAS Products) . . . . . . . . . . . . 33

Table 5: Teradata Utility Pak CD#3 (AIX and Solaris Products) . . . . . . . . . . . . . . . . . . . . . . . 33

Table 6: Data Management CD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34

Table 7: Preprocessors CD#1 (Windows Products). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34

Table 8: Preprocessors CD#2 (HP, Linux, and MP-RAS Products). . . . . . . . . . . . . . . . . . . . . 34

Table 9: Preprocessors CD#3 (AIX and Solaris Products) . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35

Table 10: Load/Unload CD#1 (Windows Products) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35

Table 11: Load/Unload CD#2 (HP-UX, Linux and MP-RAS Products) . . . . . . . . . . . . . . . . . 36

Table 12: Load/Unload CD#3 (AIX and Solaris Products) . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36

Table 13: Parallel Transporter CD#1 (Windows Products) . . . . . . . . . . . . . . . . . . . . . . . . . . . 37

Table 14: Parallel Transporter CD#2 (HP-UX, Linux, and MP-RAS Products). . . . . . . . . . . 37

Table 15: Parallel Transporter CD#3 (AIX and Solaris Products) . . . . . . . . . . . . . . . . . . . . . . 38

Table 16: Tape Storage Management Enablers CD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38

Table 17: Query Director CD. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39

Table 18: MetaData Services CD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39

Table 19: Minimum Configurations for Teradata Tools and Utilities. . . . . . . . . . . . . . . . . . . 43

Table 20: Recommended Configurations for Teradata Tools and Utilities. . . . . . . . . . . . . . . 44

Table 21: Default CD Folders. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47

Table 22: Default Folders and Product Response Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48

Table 23: setup.exe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80

Table 24: setup.exe command parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81

Table 25: Command Prompt Installation Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82

Table 26: Configuring ODBC, Teradata Query Scheduler and Teradata Manager . . . . . . . . 88

Table 27: Adding an Entry to the hosts File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89

Table 28: hosts File Syntax . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 90

Table 29: Environment Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91

Table 30: Setting Environment Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91

Table 31: Logon Parameters. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92

Table 32: Setting <machine name>. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92

Teradata Tools and Utilities Installation Guide for Microsoft Windows 17

Page 18: Teradata Tools and Utilities - dbmanagement.infodbmanagement.info/Books/MIX/2407_TeraData.pdf · Teradata Tools and Utilities Installation Guide for Microsoft Windows 7 ... Software

List of Tables

Table 33: Port Number Parameters. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .92

Table 34: Setting TDMSTPORT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .93

Table 35: Basic Teradata Query (BTEQ) Files 32-bit Platforms . . . . . . . . . . . . . . . . . . . . . . . .103

Table 36: Named Pipes Access Module 32-bit Files. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .104

Table 37: ODBC Driver for Teradata 32-bit Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .104

Table 38: ODBC Driver for Teradata 64-bit Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .105

Table 39: Share ICU Libraries for Teradata 32-bit Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .105

Table 40: Shared ICU Libraries for Teradata 64-bit Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . .106

Table 41: Teradata Access Module for JMS Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .106

Table 42: Teradata Access Module for Tivoli Files. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .106

Table 43: Teradata Archive/Recovery Utility (ARC) 32-bit Files . . . . . . . . . . . . . . . . . . . . . . .107

Table 44: Teradata C Preprocessor2 32-bit and 64-bit Files . . . . . . . . . . . . . . . . . . . . . . . . . . .107

Table 45: Teradata Call-Level Interface version 2 (CLIv2), 32-bit Files . . . . . . . . . . . . . . . . .107

Table 46: Teradata Call-Level Interface version 2 (CLIv2), 64-bit Files . . . . . . . . . . . . . . . . .108

Table 47: Teradata Data Connector 32-bit Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .109

Table 48: Teradata Data Connector 64-bit Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .110

Table 49: Teradata Driver for the JDBC Interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .110

Table 50: Teradata Dynamic Workload Manager Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .110

Table 51: Teradata FastExport 32-bit Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .111

Table 52: Teradata FastLoad 32-bit Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .111

Table 53: Teradata MultiLoad 32-bit Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .112

Table 54: Teradata MultiTool 32-bit Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .112

Table 55: Teradata OLE DB Access Module 32-bit Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .113

Table 56: 32-bit Teradata Parallel Transporter API. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .113

Table 57: 64-bit Teradata Parallel Transporter API. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .117

Table 58: Teradata Parallel Transporter Data Connector Operator. . . . . . . . . . . . . . . . . . . . .121

Table 59: Teradata Parallel Transporter DDL Operator . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .121

Table 60: 32-bit Teradata Parallel Transporter Export Operator . . . . . . . . . . . . . . . . . . . . . . .122

Table 61: 64-bit Teradata Parallel Transporter Export Operator . . . . . . . . . . . . . . . . . . . . . . .122

Table 62: 32-bit Teradata Parallel Transporter ICU Library Files . . . . . . . . . . . . . . . . . . . . . .122

Table 63: 64-bit Teradata Parallel Transporter ICU Library Files . . . . . . . . . . . . . . . . . . . . . .122

Table 64: Teradata Parallel Transporter Infrastructure Files . . . . . . . . . . . . . . . . . . . . . . . . . .123

Table 65: 32-bit Teradata Parallel Transporter Load Operator . . . . . . . . . . . . . . . . . . . . . . . .125

Table 66: 64-bit Teradata Parallel Transporter Load Operator . . . . . . . . . . . . . . . . . . . . . . . .126

Table 67: Teradata Parallel Transporter ODBC Operator . . . . . . . . . . . . . . . . . . . . . . . . . . . .126

Table 68: 32-bit Teradata Parallel Transporter Operator Support Library . . . . . . . . . . . . . . .126

18 Teradata Tools and Utilities Installation Guide for Microsoft Windows

Page 19: Teradata Tools and Utilities - dbmanagement.infodbmanagement.info/Books/MIX/2407_TeraData.pdf · Teradata Tools and Utilities Installation Guide for Microsoft Windows 7 ... Software

List of Tables

Table 69: 64-bit Teradata Parallel Transporter Operator Support Library . . . . . . . . . . . . . . 126

Table 70: Teradata Parallel Transporter OS Command Operator . . . . . . . . . . . . . . . . . . . . . 127

Table 71: Teradata Parallel Transporter SQL Inserter Operator . . . . . . . . . . . . . . . . . . . . . . 127

Table 72: Teradata Parallel Transporter SQL Selector Operator . . . . . . . . . . . . . . . . . . . . . . 127

Table 73: 32-bit Teradata Parallel Transporter Stream Operator. . . . . . . . . . . . . . . . . . . . . . 128

Table 74: 64-bit Teradata Parallel Transporter Stream Operator. . . . . . . . . . . . . . . . . . . . . . 128

Table 75: 32-bit Teradata Parallel Transporter Update Operator . . . . . . . . . . . . . . . . . . . . . 128

Table 76: 64-bit Teradata Parallel Transporter Update Operator . . . . . . . . . . . . . . . . . . . . . 128

Table 77: Teradata Parallel Transporter Wizard . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 129

Table 78: Teradata Query Scheduler Administrator 32-bit Files . . . . . . . . . . . . . . . . . . . . . . 130

Table 79: Teradata Query Scheduler Client 32-bit Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 130

Table 80: Teradata Query Scheduler Server 32-bit Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 130

Table 81: Teradata TPump 32-bit Files. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 131

Table 82: WebSphere MQ Access Module . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 131

Table 83: Teradata Workload Analyzer Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 131

Table 84: InstallShield Result Codes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 156

Teradata Tools and Utilities Installation Guide for Microsoft Windows 19

Page 20: Teradata Tools and Utilities - dbmanagement.infodbmanagement.info/Books/MIX/2407_TeraData.pdf · Teradata Tools and Utilities Installation Guide for Microsoft Windows 7 ... Software

List of Tables

20 Teradata Tools and Utilities Installation Guide for Microsoft Windows

Page 21: Teradata Tools and Utilities - dbmanagement.infodbmanagement.info/Books/MIX/2407_TeraData.pdf · Teradata Tools and Utilities Installation Guide for Microsoft Windows 7 ... Software

CHAPTER 1

Introduction

This chapter provides background information you will need before installing the Teradata Tools and Utilities software.

The section topics are:

• System Configuration Information

• Software Requirements

• Installation Kit

Teradata Tools and Utilities Installation Guide for Microsoft Windows 21

Page 22: Teradata Tools and Utilities - dbmanagement.infodbmanagement.info/Books/MIX/2407_TeraData.pdf · Teradata Tools and Utilities Installation Guide for Microsoft Windows 7 ... Software

Chapter 1: IntroductionSystem Configuration Information

System Configuration Information

The Teradata Tools and Utilities software, together with the Teradata Database software, permits communication between a Teradata client and a Teradata Database.

Table 1: Platforms Supported by Each Product

Windows 2000 XP Server 2003 Vista

Product Micr

osof

t Win

dows

2000

Pro

fess

iona

l Ser

ver

and

Adva

nced

Ser

ver,

with

sp4,

runn

ing

on In

tel x

86

(32-

bit T

erad

ata T

ools

and

Utilit

ies)

Micr

osof

t Win

dows

XP

Prof

essio

nal, w

ith sp

2, ru

nnin

g on

Inte

l x86

(3

2-bi

t Ter

adat

a Too

ls an

d Ut

ilities

)

Micr

osof

t Win

dows

XP

Prof

essio

nal, w

ith sp

2, ru

nnin

g on

Inte

l Xeo

n wi

th E

M64T

/Opt

eron

(32-

bit T

erad

ata T

ools

and

Utilit

ies)

Micr

osof

t Win

dows

XP

Prof

essio

nal, x

64, w

ith sp

2, ru

nnin

g on

Inte

l Xeo

n wi

th E

M64T

/Opt

eron

(32-

bit T

erad

ata T

ools

and

Utilit

ies)

Micr

osof

t Win

dows

XP

Prof

essio

nal, x

64, w

ith sp

2, ru

nnin

g on

Inte

l Xeo

n wi

th E

M64T

/Opt

eron

(6

4-bi

t Ter

adat

a Too

ls an

d Ut

ilities

)

Micr

osof

t Win

dows

Ser

ver 2

003 E

nter

prise

an

d St

anda

rd E

ditio

ns, w

ith sp

2, ru

nnin

g on

Inte

l x86

(3

2-bi

t Ter

adat

a Too

ls an

d Ut

ilities

)

Micr

osof

t Win

dows

Ser

ver 2

003 E

nter

prise

and

Stan

dard

Editi

ons,

with

sp2,

runn

ing

on In

tel X

eon

with

EM6

4T/O

pter

on 32

-bit

(32-

bit T

erad

ata T

ools

and

Utilit

ies)

Micr

osof

t Win

dows

Ser

ver 2

003 E

nter

prise

x64 a

nd S

tand

ard

x64

Editi

ons,

with

sp2,

runn

ing

on In

tel X

eon

with

EM6

4T/O

pter

on

(32-

bit T

erad

ata T

ools

and

Utilit

ies)

Micr

osof

t Win

dows

Ser

ver 2

003 E

nter

prise

x64 a

nd S

tand

ard

x64

Editi

ons,

with

sp2,

runn

ing

on In

tel X

eon

with

EM6

4T/O

pter

on

(64-

bit T

erad

ata T

ools

and

Utilit

ies)

]Micr

osof

t Win

dows

Vist

a Ent

erpr

ise E

ditio

nru

nnin

g on

Inte

l x86

(3

2-bi

t Ter

adat

a Too

ls an

d Ut

ilities

Micr

osof

t Win

dows

Vist

a Ent

erpr

ise E

ditio

n ru

nnin

g on

EM6

4T/O

pter

on x3

2-bi

t (3

2-bi

t Ter

adat

a Too

ls an

d Ut

ilities

)

Micr

osof

t Win

dows

Vist

a Ent

erpr

ise E

ditio

nru

nnin

g on

EM6

4T/O

pter

on x6

4-bi

t (3

2-bi

t Ter

adat

a Too

ls an

d Ut

ilities

Micr

osof

t Win

dows

Vist

a Ent

erpr

ise E

ditio

n ru

nnin

g on

EM6

4T/O

pter

on x6

4-bi

t (6

4-bi

t Ter

adat

a Too

ls an

d Ut

ilities

Basic Teradata Query (BTEQ) YES YES YES YES NO YES YES YES NO YES YES YES NO

BTEQWin YES YES NO YES NO NO YES YES NO NO NO NO NO

Named Pipes Access Module a YES YES YES YES NO YES YES YES NO YES YES YES NO

ODBC Driver for Teradata YES YES YES YES YES YES YES YES YES YES YES YES YES

OLEDB Provider for Teradata YES YES YES YES NO YES YES YES NO YES YES YES NO

Shared ICU Libraries for Teradata

YES YES YES YES YES YES YES YES YES YES YES YES YES

Teradata Access Module for JMS YES YES YES YES YES YES YES YES NO YES YES YES YES

Teradata Access Module for Tivoli

YES NO NO NO NO NO NO NO NO NO NO NO NO

Teradata Administrator YES YES YES YES NO YES YES YES NO YES YES YES NO

Teradata Archive/Recovery Utility (ARC) b

*YES *YES

*YES YES NO *YES

*YES

YES NO NO NO NO NO

Teradata C Preprocessor2 YES YES YES YES YES YES YES YES YES YES YES YES YES

Teradata Call-Level Interface version 2 (CLIv2)

YES YES YES YES YES YES YES YES YES YES YES YES YES

Teradata Data Connector YES YES YES YES NO YES YES YES NO YES YES YES NO

22 Teradata Tools and Utilities Installation Guide for Microsoft Windows

Page 23: Teradata Tools and Utilities - dbmanagement.infodbmanagement.info/Books/MIX/2407_TeraData.pdf · Teradata Tools and Utilities Installation Guide for Microsoft Windows 7 ... Software

Chapter 1: IntroductionSystem Configuration Information

Teradata Driver for the JDBC Interface

YES YES NO YES YES YES YES YES YES YES NO YES YES

Teradata Dynamic Workload Manager(Teradata DWM)

YES YES YES YES NO YES YES YES NO YES YES YES NO

Teradata FastExport YES YES YES YES NO YES YES YES NO YES YES YES NO

Teradata FastLoad YES YES YES YES NO YES YES YES NO YES YES YES NO

Teradata Generic Security Services (TeraGSS) Client (Java support)

YES YES YES YES YES YES YES YES YES YES YES YES YES

Teradata Generic Security Services (TeraGSS) Client (C support)

YES YES YES YES YES YES YES YES YES YES YES YES YES

Teradata Index Wizard YES YES YES YES NO YES YES YES NO YES YES YES NO

Teradata Manager YES YES YES YES NO YES YES YES NO YES YES YES NO

Teradata MultiLoad YES YES YES YES NO YES YES YES NO YES YES YES NO

Teradata MultiTool c YES NO NO NO NO YES YES NO NO YES YES YES NO

Teradata OLE DB Access Module YES YES YES YES NO YES YES YES NO YES YES YES NO

Teradata Parallel Transporter API

YES YES YES YES YES YES YES YES YES YES YES YES YES

Teradata Parallel Transporter Data Connector Operator

YES YES YES YES NO YES YES YES NO YES YES YES NO

Teradata Parallel Transporter DDL Operator

YES YES YES YES NO YES YES YES NO YES YES YES NO

Table 1: Platforms Supported by Each Product (continued)

Windows 2000 XP Server 2003 Vista

Product Micr

osof

t Win

dows

2000

Pro

fess

iona

l Ser

ver

and

Adva

nced

Ser

ver,

with

sp4,

runn

ing

on In

tel x

86

(32-

bit T

erad

ata T

ools

and

Utilit

ies)

Micr

osof

t Win

dows

XP

Prof

essio

nal, w

ith sp

2, ru

nnin

g on

Inte

l x86

(3

2-bi

t Ter

adat

a Too

ls an

d Ut

ilities

)

Micr

osof

t Win

dows

XP

Prof

essio

nal, w

ith sp

2, ru

nnin

g on

Inte

l Xeo

n wi

th E

M64T

/Opt

eron

(32-

bit T

erad

ata T

ools

and

Utilit

ies)

Micr

osof

t Win

dows

XP

Prof

essio

nal, x

64, w

ith sp

2, ru

nnin

g on

Inte

l Xeo

n wi

th E

M64T

/Opt

eron

(32-

bit T

erad

ata T

ools

and

Utilit

ies)

Micr

osof

t Win

dows

XP

Prof

essio

nal, x

64, w

ith sp

2, ru

nnin

g on

Inte

l Xeo

n wi

th E

M64T

/Opt

eron

(6

4-bi

t Ter

adat

a Too

ls an

d Ut

ilities

)

Micr

osof

t Win

dows

Ser

ver 2

003 E

nter

prise

an

d St

anda

rd E

ditio

ns, w

ith sp

2, ru

nnin

g on

Inte

l x86

(3

2-bi

t Ter

adat

a Too

ls an

d Ut

ilities

)

Micr

osof

t Win

dows

Ser

ver 2

003 E

nter

prise

and

Stan

dard

Editi

ons,

with

sp2,

runn

ing

on In

tel X

eon

with

EM6

4T/O

pter

on 32

-bit

(32-

bit T

erad

ata T

ools

and

Utilit

ies)

Micr

osof

t Win

dows

Ser

ver 2

003 E

nter

prise

x64 a

nd S

tand

ard

x64

Editi

ons,

with

sp2,

runn

ing

on In

tel X

eon

with

EM6

4T/O

pter

on

(32-

bit T

erad

ata T

ools

and

Utilit

ies)

Micr

osof

t Win

dows

Ser

ver 2

003 E

nter

prise

x64 a

nd S

tand

ard

x64

Editi

ons,

with

sp2,

runn

ing

on In

tel X

eon

with

EM6

4T/O

pter

on

(64-

bit T

erad

ata T

ools

and

Utilit

ies)

]Micr

osof

t Win

dows

Vist

a Ent

erpr

ise E

ditio

nru

nnin

g on

Inte

l x86

(3

2-bi

t Ter

adat

a Too

ls an

d Ut

ilities

Micr

osof

t Win

dows

Vist

a Ent

erpr

ise E

ditio

n ru

nnin

g on

EM6

4T/O

pter

on x3

2-bi

t (3

2-bi

t Ter

adat

a Too

ls an

d Ut

ilities

)

Micr

osof

t Win

dows

Vist

a Ent

erpr

ise E

ditio

nru

nnin

g on

EM6

4T/O

pter

on x6

4-bi

t (3

2-bi

t Ter

adat

a Too

ls an

d Ut

ilities

Micr

osof

t Win

dows

Vist

a Ent

erpr

ise E

ditio

n ru

nnin

g on

EM6

4T/O

pter

on x6

4-bi

t (6

4-bi

t Ter

adat

a Too

ls an

d Ut

ilities

Teradata Tools and Utilities Installation Guide for Microsoft Windows 23

Page 24: Teradata Tools and Utilities - dbmanagement.infodbmanagement.info/Books/MIX/2407_TeraData.pdf · Teradata Tools and Utilities Installation Guide for Microsoft Windows 7 ... Software

Chapter 1: IntroductionSystem Configuration Information

Teradata Parallel Transporter Export Operator

YES YES YES YES YES YES YES YES YES YES YES YES YES

Teradata Parallel Transporter FastExport OUTMOD Adapter Operator d

YES YES YES YES NO YES YES YES NO YES YES YES NO

Teradata Parallel Transporter FastLoad INMOD Adapter Operator e

YES YES YES YES NO YES YES YES NO YES YES YES NO

Teradata Parallel Transporter ICU Library

YES YES YES YES YES YES YES YES YES YES YES YES YES

Teradata Parallel Transporter Infrastructure

YES YES YES YES NO YES YES YES NO YES YES YES NO

Teradata Parallel Transporter Load Operator

YES YES YES YES YES YES YES YES YES YES YES YES YES

Teradata Parallel Transporter MultiLoad INMOD Adapter Operatorf

YES YES YES YES NO YES YES YES NO YES YES YES NO

Teradata Parallel Transporter ODBC Operator

YES YES YES YES NO YES YES YES NO YES YES YES NO

Teradata Parallel Transporter Operator Support Library

YES YES YES YES YES YES YES YES YES YES YES YES YES

Teradata Parallel Transporter OS Command Operator

YES YES YES YES NO YES YES YES NO YES YES YES NO

Teradata Parallel Transporter SQL Inserter Operator

YES YES YES YES NO YES YES YES NO YES YES YES NO

Teradata Parallel Transporter SQL Selector Operator

YES YES YES YES NO YES YES YES NO YES YES YES NO

Table 1: Platforms Supported by Each Product (continued)

Windows 2000 XP Server 2003 Vista

Product Micr

osof

t Win

dows

2000

Pro

fess

iona

l Ser

ver

and

Adva

nced

Ser

ver,

with

sp4,

runn

ing

on In

tel x

86

(32-

bit T

erad

ata T

ools

and

Utilit

ies)

Micr

osof

t Win

dows

XP

Prof

essio

nal, w

ith sp

2, ru

nnin

g on

Inte

l x86

(3

2-bi

t Ter

adat

a Too

ls an

d Ut

ilities

)

Micr

osof

t Win

dows

XP

Prof

essio

nal, w

ith sp

2, ru

nnin

g on

Inte

l Xeo

n wi

th E

M64T

/Opt

eron

(32-

bit T

erad

ata T

ools

and

Utilit

ies)

Micr

osof

t Win

dows

XP

Prof

essio

nal, x

64, w

ith sp

2, ru

nnin

g on

Inte

l Xeo

n wi

th E

M64T

/Opt

eron

(32-

bit T

erad

ata T

ools

and

Utilit

ies)

Micr

osof

t Win

dows

XP

Prof

essio

nal, x

64, w

ith sp

2, ru

nnin

g on

Inte

l Xeo

n wi

th E

M64T

/Opt

eron

(6

4-bi

t Ter

adat

a Too

ls an

d Ut

ilities

)

Micr

osof

t Win

dows

Ser

ver 2

003 E

nter

prise

an

d St

anda

rd E

ditio

ns, w

ith sp

2, ru

nnin

g on

Inte

l x86

(3

2-bi

t Ter

adat

a Too

ls an

d Ut

ilities

)

Micr

osof

t Win

dows

Ser

ver 2

003 E

nter

prise

and

Stan

dard

Editi

ons,

with

sp2,

runn

ing

on In

tel X

eon

with

EM6

4T/O

pter

on 32

-bit

(32-

bit T

erad

ata T

ools

and

Utilit

ies)

Micr

osof

t Win

dows

Ser

ver 2

003 E

nter

prise

x64 a

nd S

tand

ard

x64

Editi

ons,

with

sp2,

runn

ing

on In

tel X

eon

with

EM6

4T/O

pter

on

(32-

bit T

erad

ata T

ools

and

Utilit

ies)

Micr

osof

t Win

dows

Ser

ver 2

003 E

nter

prise

x64 a

nd S

tand

ard

x64

Editi

ons,

with

sp2,

runn

ing

on In

tel X

eon

with

EM6

4T/O

pter

on

(64-

bit T

erad

ata T

ools

and

Utilit

ies)

]Micr

osof

t Win

dows

Vist

a Ent

erpr

ise E

ditio

nru

nnin

g on

Inte

l x86

(3

2-bi

t Ter

adat

a Too

ls an

d Ut

ilities

Micr

osof

t Win

dows

Vist

a Ent

erpr

ise E

ditio

n ru

nnin

g on

EM6

4T/O

pter

on x3

2-bi

t (3

2-bi

t Ter

adat

a Too

ls an

d Ut

ilities

)

Micr

osof

t Win

dows

Vist

a Ent

erpr

ise E

ditio

nru

nnin

g on

EM6

4T/O

pter

on x6

4-bi

t (3

2-bi

t Ter

adat

a Too

ls an

d Ut

ilities

Micr

osof

t Win

dows

Vist

a Ent

erpr

ise E

ditio

n ru

nnin

g on

EM6

4T/O

pter

on x6

4-bi

t (6

4-bi

t Ter

adat

a Too

ls an

d Ut

ilities

24 Teradata Tools and Utilities Installation Guide for Microsoft Windows

Page 25: Teradata Tools and Utilities - dbmanagement.infodbmanagement.info/Books/MIX/2407_TeraData.pdf · Teradata Tools and Utilities Installation Guide for Microsoft Windows 7 ... Software

Chapter 1: IntroductionSystem Configuration Information

Teradata Parallel Transporter Stream Operator

YES YES YES YES YES YES YES YES YES YES YES YES YES

Teradata Parallel Transporter Update Operator

YES YES YES YES YES YES YES YES YES YES YES YES YES

Teradata Parallel Transporter Wizard

YES YES YES YES NO YES YES YES NO YES YES YES NO

Teradata Performance Monitor YES YES YES YES NO YES YES YES NO YES YES YES NO

Teradata Query Director YES YES YES YES NO YES YES YES NO YES YES YES NO

Teradata Query Scheduler Administrator

YES YES YES YES NO YES YES YES NO YES YES YES NO

Teradata Query Scheduler Client YES YES YES YES NO YES YES YES NO YES YES YES NO

Teradata Query Scheduler Server YES YES YES YES NO YES YES YES YES YES YES NO NO

Teradata SQL Assistant YES YES YES YES NO YES YES YES NO YES YES YES NO

Teradata SQL Assistant/Web Edition

YES YES YES YES NO YES YES YES NO YES YES YES NO

Teradata Statistics Wizard YES YES YES YES NO YES YES YES NO YES YES YES NO

Teradata System Emulation Tool YES YES YES YES NO YES YES YES NO YES YES YES NO

Teradata TPump YES YES YES YES NO YES YES YES NO YES YES YES NO

Teradata Visual Explain YES YES YES YES NO YES YES YES NO YES YES YES NO

Teradata Workload Analyzer YES YES YES YES NO YES YES YES NO YES YES YES NO

WebSphere MQ Access Module for Teradata

YES YES YES YES NO YES YES YES NO YES YES YES NO

Table 1: Platforms Supported by Each Product (continued)

Windows 2000 XP Server 2003 Vista

Product Micr

osof

t Win

dows

2000

Pro

fess

iona

l Ser

ver

and

Adva

nced

Ser

ver,

with

sp4,

runn

ing

on In

tel x

86

(32-

bit T

erad

ata T

ools

and

Utilit

ies)

Micr

osof

t Win

dows

XP

Prof

essio

nal, w

ith sp

2, ru

nnin

g on

Inte

l x86

(3

2-bi

t Ter

adat

a Too

ls an

d Ut

ilities

)

Micr

osof

t Win

dows

XP

Prof

essio

nal, w

ith sp

2, ru

nnin

g on

Inte

l Xeo

n wi

th E

M64T

/Opt

eron

(32-

bit T

erad

ata T

ools

and

Utilit

ies)

Micr

osof

t Win

dows

XP

Prof

essio

nal, x

64, w

ith sp

2, ru

nnin

g on

Inte

l Xeo

n wi

th E

M64T

/Opt

eron

(32-

bit T

erad

ata T

ools

and

Utilit

ies)

Micr

osof

t Win

dows

XP

Prof

essio

nal, x

64, w

ith sp

2, ru

nnin

g on

Inte

l Xeo

n wi

th E

M64T

/Opt

eron

(6

4-bi

t Ter

adat

a Too

ls an

d Ut

ilities

)

Micr

osof

t Win

dows

Ser

ver 2

003 E

nter

prise

an

d St

anda

rd E

ditio

ns, w

ith sp

2, ru

nnin

g on

Inte

l x86

(3

2-bi

t Ter

adat

a Too

ls an

d Ut

ilities

)

Micr

osof

t Win

dows

Ser

ver 2

003 E

nter

prise

and

Stan

dard

Editi

ons,

with

sp2,

runn

ing

on In

tel X

eon

with

EM6

4T/O

pter

on 32

-bit

(32-

bit T

erad

ata T

ools

and

Utilit

ies)

Micr

osof

t Win

dows

Ser

ver 2

003 E

nter

prise

x64 a

nd S

tand

ard

x64

Editi

ons,

with

sp2,

runn

ing

on In

tel X

eon

with

EM6

4T/O

pter

on

(32-

bit T

erad

ata T

ools

and

Utilit

ies)

Micr

osof

t Win

dows

Ser

ver 2

003 E

nter

prise

x64 a

nd S

tand

ard

x64

Editi

ons,

with

sp2,

runn

ing

on In

tel X

eon

with

EM6

4T/O

pter

on

(64-

bit T

erad

ata T

ools

and

Utilit

ies)

]Micr

osof

t Win

dows

Vist

a Ent

erpr

ise E

ditio

nru

nnin

g on

Inte

l x86

(3

2-bi

t Ter

adat

a Too

ls an

d Ut

ilities

Micr

osof

t Win

dows

Vist

a Ent

erpr

ise E

ditio

n ru

nnin

g on

EM6

4T/O

pter

on x3

2-bi

t (3

2-bi

t Ter

adat

a Too

ls an

d Ut

ilities

)

Micr

osof

t Win

dows

Vist

a Ent

erpr

ise E

ditio

nru

nnin

g on

EM6

4T/O

pter

on x6

4-bi

t (3

2-bi

t Ter

adat

a Too

ls an

d Ut

ilities

Micr

osof

t Win

dows

Vist

a Ent

erpr

ise E

ditio

n ru

nnin

g on

EM6

4T/O

pter

on x6

4-bi

t (6

4-bi

t Ter

adat

a Too

ls an

d Ut

ilities

Teradata Tools and Utilities Installation Guide for Microsoft Windows 25

Page 26: Teradata Tools and Utilities - dbmanagement.infodbmanagement.info/Books/MIX/2407_TeraData.pdf · Teradata Tools and Utilities Installation Guide for Microsoft Windows 7 ... Software

Chapter 1: IntroductionSystem Configuration Information

a Named Pipes Access Module installs files for both the utility version and the Teradata Parallel Transporter version. It is included as a free product if you ordered any of the following products:

b The Teradata Archive and Recovery Utility (ARC) is included for Open Teradata Backup and is not sold as an individual product.

c Teradata MultiTool cannot be installed if Teradata Database is already installed, because the installation of Teradata Database installs Teradata MultiTool.

d FastExport OUTMOD Adapter Operator is installed as part of the Teradata Parallel Transporter Infrastructure installation.

e FastLoad INMOD Adapter Operator is installed as part of the Teradata Parallel Transporter Infrastructure installation.

f MultiLoad INMOD Adapter Operator is installed as part of the Teradata Parallel Transporter Infrastructure installation.

System Requirements

To use the Teradata Tools and Utilities software, you must have an i386-based or greater computer with:

• An appropriate network card

• Ethernet or Token Ring LAN cards

• 345.9MB of free disk space for a full installation

• FAT or NTFS for Teradata Generic Security Services (TeraGSS) Client

Platform Requirements

Before installing the Teradata Tools and Utilities software, your computer must run on one of the following operating systems:

Windows 2000

• Microsoft Windows 2000 Professional Server and Advanced Server, with sp4, running on Intel x86 (32-bit Teradata Tools and Utilities)

Windows XP Professional

• Microsoft Windows XP Professional, with sp2, running on Intel x86 (32-bit Teradata Tools and Utilities)

• Microsoft Windows XP Professional, with sp2, running on Intel Xeon with EM64T/Opteron (32-bit Teradata Tools and Utilities)

• Microsoft Windows XP Professional, x64, with sp2, running on Intel Xeon with EM64T/Opteron (32-bit Teradata Tools and Utilities)

Archive and Recovery Utility (ARC) Teradata FastLoad

Basic Teradata Query (BTEQ) Teradata MultiLoad

Teradata FastExport Teradata TPump

26 Teradata Tools and Utilities Installation Guide for Microsoft Windows

Page 27: Teradata Tools and Utilities - dbmanagement.infodbmanagement.info/Books/MIX/2407_TeraData.pdf · Teradata Tools and Utilities Installation Guide for Microsoft Windows 7 ... Software

Chapter 1: IntroductionSystem Configuration Information

• Microsoft Windows XP Professional, x64, with sp2, running on Intel Xeon with EM64T/Opteron(64-bit Teradata Tools and Utilities)

Windows Server 2003

• Microsoft Windows Server 2003 Enterprise and Standard Editions, with sp2, running on Intel x86 (32-bit Teradata Tools and Utilities)

• Microsoft Windows Server 2003 Enterprise and Standard Editions, with sp2, running on Intel Xeon with EM64T/Opteron x32-bit (64-bit Teradata Tools and Utilities)

• Microsoft Windows Server 2003 Enterprise x64 and Standard x64 Editions, with sp2, running on Intel Xeon with EM64T/Opteron(32-bit Teradata Tools and Utilities)

• Microsoft Windows Server 2003 Enterprise x64 and Standard x64 Editions, with sp2, running on Intel Xeon with EM64T/Opteron (64-bit Teradata Tools and Utilities)

Windows Vista

• Microsoft Windows Vista Enterprise Edition, running on Intel x86 (32-bit Teradata Tools and Utilities)

• Microsoft Windows Vista Enterprise Edition, running on EM64T/Opteron x32-bit (32-bit Teradata Tools and Utilities)

• Microsoft Windows Vista Enterprise Edition, running on EM64T/Opteron x64-bit (32-bit Teradata Tools and Utilities)

• Microsoft Windows Vista Enterprise Edition, running on EM64T/Opteron x64-bit (64-bit Teradata Tools and Utilities)

Table 1 on page 22 shows which Windows platforms are supported by each product.

Administrator Privileges

You must have administrator privileges for the computer on which you will be installing the Teradata Tools and Utilities software.

Network Requirements

Your computer should be able to communicate with a network-attached Teradata Database that is using the TCP/IP protocol with Winsock version 2.0 support.

For an up-to-date description of which software the Teradata Database should be running, refer to the Teradata Tools and Utilities Release Definition, Release 12.0.

Teradata Database Requirements

The appropriate Ethernet hardware and software, supporting a TCP/IP-based network, must be installed on every Teradata Database with which your computer will communicate.

Teradata Tools and Utilities Installation Guide for Microsoft Windows 27

Page 28: Teradata Tools and Utilities - dbmanagement.infodbmanagement.info/Books/MIX/2407_TeraData.pdf · Teradata Tools and Utilities Installation Guide for Microsoft Windows 7 ... Software

Chapter 1: IntroductionSoftware Requirements

Software Requirements

Product Dependencies

In the following table, the products in the first column are dependent upon, and must be installed with the products in the second column.

Table 2: Product Dependencies

These products... require these installations...

Basic Teradata Query (BTEQ) version 12.00.00 • CLIv2 version 12.00.00 or later

• Teradata Data Connector version 12.00.00 or later

• Shared ICU Libraries for Teradata version 12.00.00 or later

BTEQWin version 12.00.00 • BTEQ version 12.00.00

Named Pipes Access Module version 12.00.00 • No dependencies

NetBackup Teradata Extension version 12.00.00 • No dependencies

ODBC Driver for Teradata version 12.00.00 • Microsoft Data Access Components (MDAC), version 2.8 sp1 (on distribution CD)

• Shared ICU Libraries for Teradata version 12.00.00

• Teradata Generic Security Services version 12.00.00 or laterTeraGSS - Client package

Shared ICU Libraries for Teradata version 12.00.00 • No dependencies

Teradata Access Module for JMS version 12.00.00 • Teradata Data Connector version 12.00.00 or later

• JDK 1.4 or later

• JMS enabled Messaging System

Teradata Access Module for Tivoli version 12.00.00 • No dependencies

Teradata Administrator version 12.00.00 • ODBC Driver for Teradata version 12.00.00 or later

Teradata Archive/Recovery Utility (ARC) version 12.00.00 • CLIv2 version 12.00.00or later

• Teradata Data Connector version 12.00.00 or later

Note: ARC is not distributed as a stand-alone product. It is installed with Open Teradata Backup on MP-RAS and Windows 2000.

Teradata C Preprocessor2 version 12.00.00 • CLIv2 version 12.00.00 or later

• Shared ICU Libraries for Teradata version 12.00.00

28 Teradata Tools and Utilities Installation Guide for Microsoft Windows

Page 29: Teradata Tools and Utilities - dbmanagement.infodbmanagement.info/Books/MIX/2407_TeraData.pdf · Teradata Tools and Utilities Installation Guide for Microsoft Windows 7 ... Software

Chapter 1: IntroductionSoftware Requirements

Teradata Call-Level Interface version 2 (CLIv2) version 12.00.00

• Shared ICU Libraries for Teradata version 12.00.00 or later

• Teradata Generic Security Services version 12.00.00 or laterTDGSS - Server packageTeraGSS - Client package

Teradata Data Connector version 12.00.00 • No dependencies

Teradata Dynamic Workload Manager version 12.00.00 • CLIv2 version 12.00.00 or later

Teradata FastExport version 12.00.00 • CLIv2 version 12.00.00 or later

• Teradata Data Connector version 12.00.00 or later

Teradata FastLoad version 12.00.00 • CLIv2 version 12.00.00 or later

• Teradata Data Connector version 12.00.00 or later

Teradata Generic Security Services Client (TeraGSS) version 12.00.00

• No dependencies

Teradata Generic Security Services Client Java (TeraGSSJava) version12.00.00

• No dependencies

Teradata Index Wizard version 12.00.00 • CLIv2 version 12.00.00 or later

or

• ODBC Driver for Teradata version 12.00.00 or later

Teradata Manager version 12.00.00 • CLIv2 version 12.00.00or later

Teradata MultiLoad version 12.00.00 • CLIv2 version 12.00.00 or later

• Teradata Data Connector version 12.00.00 or later

Teradata MultiTool version 12.00.00 • Java 2 Runtime Environment 1.4 or later

Note: The environment can be downloaded from the Sun website at: http://java.sun.com/products/archive/j2se/1.4.0/index.html

Teradata OLE DB Access Module version 12.00.00 • ODBC Driver for Teradata version 12.00.00 or later

Teradata Performance Monitor version 12.00.00 • CLIv2 version 12.00.00 or later

Teradata Query Director version 12.00.00 • CLIv2 version 12.00.00 or later

• Shared ICU Libraries for Teradata version 12.00.00

• Teradata_GSS_Client version 12.00.00 or later

Teradata Query Scheduler Administrator version 12.00.00 • CLIv2 version 12.00.00 or later

Teradata Query Scheduler Client version 12.00.00 • CLIv2 version 12.00.00 or later

Teradata Query Scheduler Server version 12.00.00 • CLIv2 version 12.00.00 or later

• Teradata Query Scheduler Client version 12.00.00

Table 2: Product Dependencies (continued)

These products... require these installations...

Teradata Tools and Utilities Installation Guide for Microsoft Windows 29

Page 30: Teradata Tools and Utilities - dbmanagement.infodbmanagement.info/Books/MIX/2407_TeraData.pdf · Teradata Tools and Utilities Installation Guide for Microsoft Windows 7 ... Software

Chapter 1: IntroductionSoftware Requirements

a FastExport OUTMOD Adapter Operator is installed as part of the Teradata Parallel Transporter Infrastructure installation.

b FastLoad INMOD Adapter Operator is installed as part of the Teradata Parallel Transporter Infrastructure installation.

c MultiLoad INMOD Adapter Operator is installed as part of the Teradata Parallel Transporter Infrastructure installation.

d Teradata Parallel Transporter12.00.00 is certified with Teradata Call-Level Interface version 2 release 12.00.00.

Teradata SQL Assistant version 12.00.00 • ODBC Driver for Teradata version 12.00.00 or later

Teradata SQL Assistant/Web Edition version 12.00.00 • ODBC Driver for Teradata version 12.00.00 or later

To install, your PC must run one of the following. It will not work with other Windows operating systems:

• Windows 2000 Professional

• Windows 2000 Server

• Windows 2000 Advanced Server

• Windows 2003, or

• 32-bit Windows XP.

Note: See “Installing Required Software for Teradata SQL Assistant/Web Edition” on page 52. This section documents the additional software that must be installed prior to installing Teradata SQL Assistant/Web Edition.

Teradata Statistics Wizard version 12.00.00 • CLIv2 version 12.00.00 or later

Teradata System Emulation Tool version 12.00.00 • CLIv2 version 12.00.00 or later

or

• ODBC Driver for Teradata version 12.00.00 or later

Teradata TPump version 12.00.00 • CLIv2 version 12.00.00 or later

• Teradata Data Connector version 12.00.00 or later

• Shared ICU Libraries for Teradata version 12.00.00

Teradata Visual Explain version 12.00.00 • CLIv2 version 12.00.00 or later

or

• ODBC Driver for Teradata version 12.00.00 or later

• Teradata Parallel Transporter ICU Library version 12.00.00

• Shared ICU Libraries for Teradata 12.00.00 or later

Teradata Workload Analyzer version 12.00.00 • CLIv2 version 12.00.00 or later

WebSphere MQ Access Module version 12.00.00 • Teradata Data Connector 12.00.00 or later

• WebSphere MQ V5.2

Table 2: Product Dependencies (continued)

These products... require these installations...

30 Teradata Tools and Utilities Installation Guide for Microsoft Windows

Page 31: Teradata Tools and Utilities - dbmanagement.infodbmanagement.info/Books/MIX/2407_TeraData.pdf · Teradata Tools and Utilities Installation Guide for Microsoft Windows 7 ... Software

Chapter 1: IntroductionInstallation Kit

Installation Order

When installing Teradata Tools and Utilities products, four product dependencies must be installed first and in the following order:

1 Install ICU Libraries for Teradata (tdicu).

2 Install Teradata Generic Security Services (TeraGSS).

3 Install Teradata Call-Level Interface version 2 (CLIv2).

4 Install Teradata Data Connector (piom).

Note: ICU Libraries for Teradata should not be uninstalled until all software that have it as a dependency are first uninstalled.

Installation Kit

Your installation kit includes:

• Teradata Tools and Utilities Release Definition, Release 12.00.00

• Teradata Tools and Utilities documentation CD

There will also be one or more of the following CDs, depending on your purchase. Each CD contains product versions for one or more network-attached platforms. Refer to the following tables for more information:

• Teradata Utility Pak - Utilities CD#1 (Windows Products)

• Teradata Utility Pak - Utilities CD#2 (HP-UX, Linux, MP-RAS)

• Teradata Utility Pak - Utilities CD#3 (AIX and Solaris Products)

• Database Management

• Preprocessors - CD # 1 (Windows Products)

• Preprocessors - CD #2 (HP-UX, Linux, MP-RAS)

• Preprocessors - CD #3 (AIX and Solaris Products)

• Load/Unload - CD#1 (Windows Products)

• Load/Unload - CD#2 (HP-UX, Linux, MP-RAS)

• Load/Unload - CD#3 (AIX and Solaris Products)

• Parallel Transporter - CD#1 (Windows Products)

• Parallel Transporter - CD#2 (HP-UX, Linux, MP-RAS)

• Parallel Transporter - CD#3 (AIX and Solaris Products)

• Query Director

• Tape Storage Management Enablers

• Meta Data Services

If you did not receive all the CDs you ordered, contact the Teradata Solutions Customer Services Remote Services Center (TSCS-RSC). For more information, refer to the Teradata Tools and Utilities Release Definition, Release 12.0.

Teradata Tools and Utilities Installation Guide for Microsoft Windows 31

Page 32: Teradata Tools and Utilities - dbmanagement.infodbmanagement.info/Books/MIX/2407_TeraData.pdf · Teradata Tools and Utilities Installation Guide for Microsoft Windows 7 ... Software

Chapter 1: IntroductionInstallation Kit

Teradata Software Server

To ensure the highest quality and best performance of Teradata Tools and Utilities products, the most recent critical post-production updates can be downloaded from the Teradata Software Server at:

http://tssprod.ncr.com:8080/TSFS/home.do

IBM VM and IBM z/OS

Teradata Tools and Utilities products are also supported on channel-attached platforms, such as IBM VM and IBM z/OS. On these platforms, the products are loaded from tape. See the installation guides for these systems:

• Teradata Tools and Utilities Installation Guide for IBM VM

• Teradata Tools and Utilities Installation Guide for IBM z/OS

Teradata Driver for the JDBC Interface

The Teradata Driver for the JDBC Interface is downloaded from the World Wide Web. For installation, see “Installing the Teradata Driver for the JDBC Interface” on page 84.

The Java Development Kit is a requirement to use the Teradata Driver for the JDBC Interface. For information how to download the kit, see:

• Teradata Driver for the JDBC Interface User Guide

Teradata Parallel Transporter Wizard

Teradata Parallel Transporter Wizard includes code licensed from RSA Security, Inc. Some portions of the code licensed from IBM are available at:

http://oss.software.ibm.com/icu4j

Teradata Tools and Utilities CDs

The following tables list only the network-attached platform versions contained on the CDs.

Table 3: Teradata Utility Pak CD#1 (Windows Products)

Teradata Utility Pak - Utilities CD#1 Platforms (Windows)

Basic Teradata Query (BTEQ) Windows

Named Pipes Access Module Windows

ODBC Driver for Teradata Windows

Shared ICU Libraries for Teradata Windows

Teradata Administrator Windows

Teradata Call-Level Interface version 2 (CLIv2) Windows

Teradata Data Connector Windows

32 Teradata Tools and Utilities Installation Guide for Microsoft Windows

Page 33: Teradata Tools and Utilities - dbmanagement.infodbmanagement.info/Books/MIX/2407_TeraData.pdf · Teradata Tools and Utilities Installation Guide for Microsoft Windows 7 ... Software

Chapter 1: IntroductionInstallation Kit

Teradata Generic Security Services Windows

Teradata MultiTool Windows

Note: Teradata MultiTool has a dependency on JRE 4.0 or later. This product is not part of the Teradata Tools and Utilities Installation Kit.

Teradata SQL Assistant Windows

Teradata SQL Assistant/Web Edition Windows

Table 4: Teradata Utility Pak CD#2 (HP-UX, Linux and MP-RAS Products)

Teradata Utility Pak - Utilities CD#2 Platforms (HP-UX, Linux and MP-RAS)

Basic Teradata Query (BTEQ) HP-UX, Linux, MP-RAS

Named Pipes Access Module HP-UX, Linux, MP-RAS

ODBC Driver for Teradata HP-UX, Linux, MP-RAS

Shared ICU Libraries for Teradata HP-UX, Linux, MP-RAS

Teradata Call-Level Interface version 2 (CLIv2) HP-UX, Linux, MP-RAS

Teradata Data Connector HP-UX, Linux, MP-RAS

Teradata Generic Security Services HP-UX, Linux, MP-RAS

Table 5: Teradata Utility Pak CD#3 (AIX and Solaris Products)

Teradata Utility Pak - Utilities CD#3 Platforms (AIX and Solaris)

Basic Teradata Query (BTEQ) IBM AIX, Solaris SPARC

Named Pipes Access Module IBM AIX, Solaris SPARC

ODBC Driver for Teradata IBM AIX, Solaris SPARC

Shared ICU Libraries for Teradata IBM AIX, Solaris SPARC, Solaris Opteron

Teradata Call-Level Interface version 2 (CLIv2) IBM AIX, Solaris SPARC, Solaris Opteron

Teradata Data Connector IBM AIX, Solaris SPARC

Teradata Generic Security Services IBM AIX, Solaris SPARC

Table 3: Teradata Utility Pak CD#1 (Windows Products) (continued)

Teradata Utility Pak - Utilities CD#1 Platforms (Windows)

Teradata Tools and Utilities Installation Guide for Microsoft Windows 33

Page 34: Teradata Tools and Utilities - dbmanagement.infodbmanagement.info/Books/MIX/2407_TeraData.pdf · Teradata Tools and Utilities Installation Guide for Microsoft Windows 7 ... Software

Chapter 1: IntroductionInstallation Kit

Table 6: Data Management CD

Database Management CD Platforms (Windows)

Basic Teradata Query (BTEQ) Product dependency

ODBC Driver for Teradata Product dependency

Shared ICU Libraries for Teradata Product dependency

Teradata Call-Level Interface version 2 (CLIv2) Product dependency

Teradata Data Connector Product dependency

Teradata Dynamic Workload Manager Windows

Teradata Generic Security Services Product dependency

Teradata Index Wizard Windows

Teradata Manager Windows

Teradata Performance Monitor Windows

Teradata Query Scheduler Administrator Windows

Teradata Query Scheduler Client Windows

Teradata Query Scheduler Server Windows

Teradata Statistics Wizard Windows

Teradata System Emulation Tool Windows

Teradata Visual Explain Windows

Teradata Workload Analyzer Windows

Table 7: Preprocessors CD#1 (Windows Products)

Preprocessors CD#1 Platforms (Windows)

Shared ICU Libraries for Teradata Product dependency

Teradata C Preprocessor2 Windows

Teradata Call-Level Interface version 2 (CLIv2) Product dependency

Teradata Generic Security Services Product Dependency

Table 8: Preprocessors CD#2 (HP, Linux, and MP-RAS Products)

Preprocessors CD#2 Platforms (HP-UX, Linux, and MP-RAS)

Shared ICU Libraries for Teradata Product dependency

Teradata C Preprocessor2 HP-UX, Linux, MP-RAS

34 Teradata Tools and Utilities Installation Guide for Microsoft Windows

Page 35: Teradata Tools and Utilities - dbmanagement.infodbmanagement.info/Books/MIX/2407_TeraData.pdf · Teradata Tools and Utilities Installation Guide for Microsoft Windows 7 ... Software

Chapter 1: IntroductionInstallation Kit

Teradata Call-Level Interface version 2 (CLIv2) Product dependency

Teradata Cobol Preprocessor2 HP-UX, MP-RAS

Teradata Generic Security Services Product dependency

Table 9: Preprocessors CD#3 (AIX and Solaris Products)

Preprocessors CD#3 Platforms (AIX and Solaris)

Shared ICU Libraries for Teradata Product dependency

Teradata C Preprocessor2 IBM AIX, Solaris SPARC, Solaris Opteron

Teradata Call-Level Interface version 2 (CLIv2) Product dependency

Teradata Cobol Preprocessor2 IBM AIX

Teradata Generic Security Services Product dependency

Table 10: Load/Unload CD#1 (Windows Products)

Load/Unload CD#1 Platforms (Windows)

Basic Teradata Query (BTEQ) Product dependency

Teradata Access Module for JMS Windows

Named Pipes Access Module Windows

Note: Named Pipes Access Module contains both the stand-alone version and the Teradata Parallel Transporter version.

ODBC Driver for Teradata Product dependency

Shared ICU Libraries for Teradata Product dependency

Teradata Call-Level Interface version 2 (CLIv2) Product dependency

Teradata Data Connector Windows

Teradata FastExport Windows

Teradata FastLoad Windows

Teradata Generic Security Services Product dependency

Teradata MultiLoad Windows

Teradata OLE DB Access Module Windows

Teradata TPump Windows

Table 8: Preprocessors CD#2 (HP, Linux, and MP-RAS Products) (continued)

Preprocessors CD#2 Platforms (HP-UX, Linux, and MP-RAS)

Teradata Tools and Utilities Installation Guide for Microsoft Windows 35

Page 36: Teradata Tools and Utilities - dbmanagement.infodbmanagement.info/Books/MIX/2407_TeraData.pdf · Teradata Tools and Utilities Installation Guide for Microsoft Windows 7 ... Software

Chapter 1: IntroductionInstallation Kit

WebSphere MQ Access Module Windows

Note: WebSphere MQ Access Module contains both the stand-alone version and the Teradata Parallel Transporter version.

Table 11: Load/Unload CD#2 (HP-UX, Linux and MP-RAS Products)

Load/Unload CD#2 Platforms (HP-UX, Linux, and MP-RAS)

Basic Teradata Query (BTEQ) Product dependency

Teradata Access Module for JMS HP-UX

Named Pipes Access Module MP-RAS, HP-UX, Linux

Shared ICU Libraries for Teradata Product dependency

Teradata Call-Level Interface version 2 (CLIv2) Product dependency

Teradata Data Connector MP-RAS, HP-UX, Linux

Teradata FastExport MP-RAS, HP-UX, Linux

Teradata FastLoad MP-RAS, HP-UX, Linux

Teradata Generic Security Services Product dependency

Teradata MultiLoad MP-RAS, HP-UX, Linux

Teradata TPump MP-RAS, HP-UX, Linux

WebSphere MQ Access Module MP-RAS, HP-UX, Linux

Note: WebSphere MQ Access Module contains both the stand-alone version and the Teradata Parallel Transporter version.

Table 12: Load/Unload CD#3 (AIX and Solaris Products)

Load/Unload CD#3 Platforms (AIX and Solaris)

Basic Teradata Query (BTEQ) Product dependency

Teradata Access Module for JMS Solaris SPARC

Named Pipes Access Module Solaris SPARC, AIX

Note: Named Pipes Access Module contains both the stand-alone version and the Teradata Parallel Transporter version.

ODBC Driver for Teradata Product dependency

Table 10: Load/Unload CD#1 (Windows Products) (continued)

Load/Unload CD#1 Platforms (Windows)

36 Teradata Tools and Utilities Installation Guide for Microsoft Windows

Page 37: Teradata Tools and Utilities - dbmanagement.infodbmanagement.info/Books/MIX/2407_TeraData.pdf · Teradata Tools and Utilities Installation Guide for Microsoft Windows 7 ... Software

Chapter 1: IntroductionInstallation Kit

Shared ICU Libraries for Teradata Product dependency

Teradata Call-Level Interface version 2 (CLIv2) Product dependency

Teradata Data Connector Solaris SPARC, AIX, Solaris Opteron

Teradata FastExport Solaris SPARC, AIX, Solaris Opteron

Teradata FastLoad Solaris SPARC, AIX, Solaris Opteron

Teradata Generic Security Services Product dependency

Teradata MultiLoad Solaris SPARC, AIX, Solaris Opteron

Teradata TPump Solaris SPARC, AIX, Solaris Opteron

WebSphere MQ Access Module Solaris SPARC, AIX, Solaris Opteron

Note: WebSphere MQ Access Module contains both the stand-alone version and the Teradata Parallel Transporter version.

Table 13: Parallel Transporter CD#1 (Windows Products)

Parallel Transporter CD#1 Platforms (Windows)

Named Pipes Access Module Product dependency

Note: Named Pipes Access Module contains both the stand-alone version and the Teradata Parallel Transporter version.

Shared ICU Libraries for Teradata Product dependency

Teradata Call-Level Interface version 2 (CLIv2) Product dependency

Teradata Generic Security Services Product dependency

WebSphere MQ Access Module Product dependency

Note: WebSphere MQ Access Module contains both the stand-alone version and the Teradata Parallel Transporter version.

Table 14: Parallel Transporter CD#2 (HP-UX, Linux, and MP-RAS Products)

Parallel Transporter CD#2 Platforms (HP-UX, Linux, and MP-RAS)

Named Pipes Access Module Product dependency

Note: Named Pipes Access Module contains both the stand-alone version and the Teradata Parallel Transporter version.

Table 12: Load/Unload CD#3 (AIX and Solaris Products) (continued)

Load/Unload CD#3 Platforms (AIX and Solaris)

Teradata Tools and Utilities Installation Guide for Microsoft Windows 37

Page 38: Teradata Tools and Utilities - dbmanagement.infodbmanagement.info/Books/MIX/2407_TeraData.pdf · Teradata Tools and Utilities Installation Guide for Microsoft Windows 7 ... Software

Chapter 1: IntroductionInstallation Kit

Shared ICU Libraries for Teradata Product dependency

Teradata Call-Level Interface version 2 (CLIv2) Product dependency

Teradata Generic Security Services Product dependency

WebSphere MQ Access Module HP-UX, Linux and MP-RAS

Note: WebSphere MQ Access Module contains both the stand-alone version and the Teradata Parallel Transporter version.

Table 15: Parallel Transporter CD#3 (AIX and Solaris Products)

Parallel Transporter CD#3 Platforms (AIX and Solaris)

Named Pipes Access Module Product dependency

Note: Named Pipes Access Module contains both the stand-alone version and the Teradata Parallel Transporter version.

Shared ICU Libraries for Teradata Product dependency

Teradata Call-Level Interface version 2 (CLIv2) Product dependency

Teradata Generic Security Services Product dependency

WebSphere MQ Access Module Product Dependency

Note: WebSphere MQ Access Module contains both the stand-alone version and the Teradata Parallel Transporter version.

Table 16: Tape Storage Management Enablers CD

Tape Storage Management Enablers CD Platforms (Windows, Linux, MP-RAS)

ODBC Driver for Teradata Product dependency

Shared ICU Libraries for Teradata Product dependency

Teradata Access Module for Tivoli Windows

Teradata Archive/Recovery Utility (ARC) MP-RAS, Linux and Windows

Note: ARC is not distributed as a stand-alone product. It is installed with Open Teradata Backup on MP-RAS and Windows 2000.

Teradata C Preprocessor2 Product dependency

Teradata Call-Level Interface version 2 (CLIv2) Product dependency

Table 14: Parallel Transporter CD#2 (HP-UX, Linux, and MP-RAS Products) (continued)

Parallel Transporter CD#2 Platforms (HP-UX, Linux, and MP-RAS)

38 Teradata Tools and Utilities Installation Guide for Microsoft Windows

Page 39: Teradata Tools and Utilities - dbmanagement.infodbmanagement.info/Books/MIX/2407_TeraData.pdf · Teradata Tools and Utilities Installation Guide for Microsoft Windows 7 ... Software

Chapter 1: IntroductionInstallation Kit

Note: If you did not receive these items, contact the TSCS-RSC. See the Teradata Tools and Utilities Release Definition, Release 12.0 for further instructions.

Note: For information on installing the Teradata Access Module for Tivoli, see the Teradata Access Module for Tivoli Installation and User Guide.

Note: For installation instructions for Teradata Query Director, see the Teradata Query Director User Guide.

Note: For installation instructions for OLE DB Provider for Teradata, see the OLE DB Provider for Teradata Installation and User Guide.

Note: For installation instructions for Meta Data Services, see the Teradata Meta Data Services Installation and Administration Guide.

Note: For UNIX and Linux products, see the Teradata Tools and Utilities Installation Guide for UNIX and Linux.

Teradata Data Connector Product dependency

Teradata Generic Security Services Product dependency

Table 17: Query Director CD

Query Director CD Platforms (Windows and Linux)

Shared ICU Libraries for Teradata Product dependency

Teradata Call-Level Interface version 2 (CLIv2) Product dependency

Teradata Generic Security Services Product dependency

Teradata Query Director Windows, Linux

Table 18: MetaData Services CD

MetaData Services CD Platforms (MP-RAS, Linux, Windows)

Meta Data Services Linux, MP-RAS, Solaris SPARC

Relay Services Gateway Product dependency

Table 16: Tape Storage Management Enablers CD (continued)

Tape Storage Management Enablers CD Platforms (Windows, Linux, MP-RAS)

Teradata Tools and Utilities Installation Guide for Microsoft Windows 39

Page 40: Teradata Tools and Utilities - dbmanagement.infodbmanagement.info/Books/MIX/2407_TeraData.pdf · Teradata Tools and Utilities Installation Guide for Microsoft Windows 7 ... Software

Chapter 1: IntroductionInstallation Kit

40 Teradata Tools and Utilities Installation Guide for Microsoft Windows

Page 41: Teradata Tools and Utilities - dbmanagement.infodbmanagement.info/Books/MIX/2407_TeraData.pdf · Teradata Tools and Utilities Installation Guide for Microsoft Windows 7 ... Software

CHAPTER 2

Before You Install

This chapter describes the procedures to set up the installation of Teradata Tools and Utilities software on Microsoft Windows client systems. This chapter contains the following information:

• Installation Recommendations

• Technical Assistance

• Installing Required Software for Teradata SQL Assistant/Web Edition

Installation Recommendations

Before you begin installing Teradata Tools and Utilities software on Microsoft Windows client systems, make sure your software package is complete (see “Installation Kit” on page 31) and that your PC is set up with the required software and hardware. If you did not receive the correct disks, contact the TSCS-RSC. You should also familiarize yourself with the following issues.

Make sure you have the appropriate Teradata Tools and Utilities CDs. The available CDs are:

• Teradata Utility Pak - Utilities CD#1 (Windows Products)

• Teradata Utility Pak - Utilities CD#2 (HP-UX, Linux, MP-RAS)

• Teradata Utility Pak - Utilities CD#3 (AIX and Solaris Products)

• Database Management

• Preprocessors - CD # 1 (Windows Products)

• Preprocessors - CD #2 (HP-UX, Linux, MP-RAS)

• Preprocessors - CD #3 (AIX and Solaris Products)

• Load/Unload - CD#1 (Windows Products)

• Load/Unload - CD#2 (HP-UX, Linux, MP-RAS)

• Load/Unload - CD#3 (AIX and Solaris Products)

• Parallel Transporter - CD#1 (Windows Products)

• Parallel Transporter - CD#2 (HP-UX, Linux, MP-RAS)

• Parallel Transporter - CD#3 (AIX and Solaris Products)

• Query Director

• Tape Storage Management Enablers

• Meta Data Services

Teradata Tools and Utilities Installation Guide for Microsoft Windows 41

Page 42: Teradata Tools and Utilities - dbmanagement.infodbmanagement.info/Books/MIX/2407_TeraData.pdf · Teradata Tools and Utilities Installation Guide for Microsoft Windows 7 ... Software

Chapter 2: Before You InstallInstallation Recommendations

Note: If you did not receive all the CDs you ordered, contact the Teradata Solutions Customer Services Remote Services Center (TSCS-RSC). For more information, refer to the Teradata Tools and Utilities Release Definition, Release 12.0.

Note: This installation guide does not describe how to install the OLE DB Provider for Teradata. For installation on how to install the OLE DB Provider for Teradata Installation and User Guide.

Note: This installation guide does not describe how to install the Meta Data Services. For installation on how to install the Teradata Meta Data Services Installation and Administration Guide.

Note: This installation guide does not describe how to install the Teradata Query Director. For installation on how to install the Teradata Query Director, see the Teradata Query Director User Guide.

Familiarize yourself with the issues described in the following subsections.

Installing on Windows Vista

Windows Vista does not install the Windows Help program, WinHlp32.exe. This application is required to display 32-bit online help files delivered with Teradata Tools and Utilities products. Use the following procedure to install the Windows Help program.

To install the Windows Help program

The Teradata Tools and Utilities product must be installed before proceeding.

1 Go to http://www.microsoft.com/downloads/

2 In the Search box, type WinHlp32 Vista to locate the WinHlp32.exe file.

Note: Windows Vista users must pass a short validation process before downloading the file. Once validated, specific instructions are given for obtaining the download.

3 Run the executable.

The default location is the c:\Windows directory.

Installing on EM64T Systems

On 64-bit EM64T systems, the following TTU 12.00.00.00 CDs will install only the 32-bit versions of the Teradata Tools and Utilities products that support both 32-bit and 64-bit installations, since the primary Teradata Tools and Utilities products on each CD only support 32-bit installations:

• Database Management

• Query Director

• Load/Unload CD#1

• Meta Data Services

• Tape Storage Management Enablers

42 Teradata Tools and Utilities Installation Guide for Microsoft Windows

Page 43: Teradata Tools and Utilities - dbmanagement.infodbmanagement.info/Books/MIX/2407_TeraData.pdf · Teradata Tools and Utilities Installation Guide for Microsoft Windows 7 ... Software

Chapter 2: Before You InstallInstallation Recommendations

Preprocessors CD and Parallel Transporter CD

On a 64-bit EM64T system, Preprocessors CD#1, and Parallel Transporter CD#1 will install only the 64-bit versions of Teradata Tools and Utilities products that support both 32-bit and 64-bit installations.

To install the 32-bit version of these products on a 64-bit EM64T system, you must first run a “NETWORK” install on a 32-bit system, and select the desired Teradata Tools and Utilities products. On the EM64T system, mount the network drive containing the 32-bit installation packages and run the installations.

Teradata Utility Pak - Utilities CD#1

To install BTEQ from the Teradata Utility Pak - Utilities CD#1 on a 64-bit EM64T system, select BTEQ in either a “TYPICAL” or “CUSTOM” installation. BTEQ, will install the 32-bit versions of CLIv2, TeraGSS, and ICU, since BTEQ only supports 32-bit installations. To install the 64-bit versions of CLIv2, TeraGSS and ICU, deselect BTEQ.

Minimum and Recommended Configurations

The following sections contain information on the minimum and recommended configurations for systems installing Teradata Tools and Utilities products.

Minimum Configurations

The following table shows the minimum configurations for Teradata Tools and Utilities products.

Table 19: Minimum Configurations for Teradata Tools and Utilities

Product Client Server

Teradata ManagerTeradata Performance Monitor Teradata AdministratorTeradata Statistics WizardTeradata Dynamic Workload ManagerTeradata Query Scheduler

500 MHz Pentium III256 MB RAM10 GB Hard Drive (100 MB for TMGR)CD ROM Drive

1.2 GHz Pentium IV512 MB RAM2*18 GB Hard Drive (100 MB for TMGR)CD ROM DriveModem (required to use the Send a Page action of the Alerts facility)

Teradata SQL Assistant/Web Edition

500 MHz Pentium III256 MB RAM10 Mbps Network Interface Card or Modem1024x768 SVGA Display

1.2 GHz Pentium IV512 MB RAM100 Mbps Network Interface Card1024x768 SVGA DisplayCD ROM Drive or DVD Drive2*18 GB Hard Drive

Teradata SQL Assistant 500 MHz Pentium III64 MB RAMCD ROM DriveSVGA or better, Graphics Controller and MonitorMinimum 50 MB free disk space

Teradata Tools and Utilities Installation Guide for Microsoft Windows 43

Page 44: Teradata Tools and Utilities - dbmanagement.infodbmanagement.info/Books/MIX/2407_TeraData.pdf · Teradata Tools and Utilities Installation Guide for Microsoft Windows 7 ... Software

Chapter 2: Before You InstallInstallation Recommendations

Recommended Configurations

The following table shows the recommended configurations for Teradata Tools and Utilities products.

Shared ICU Libraries for Teradata Recommendations

It’s recommended that the Shared ICU Libraries for Teradata be installed to a local drive. If it is installed to a network shared drive, the performance for running the Shared ICU Libraries may be degraded.

Installation of Dependent Products

The Teradata Tools and Utilities installation can automatically install dependent products. If a dependent product already exists on your system for one of the following products:

• Shared Common Components for Internationalization for Teradata

• Teradata Call-Level Interface version 2 (CLIv2)

• Teradata Data Connector

• ODBC Driver for Teradata

• Teradata Generic Security Services

The installation will display one of two messages. The first message is displayed if a dependent product already exists and its version is the same as the dependent product being installed. It asks if you want to reinstall the existing installed product.

For example, the following message is for the ODBC Driver for Teradata:

Table 20: Recommended Configurations for Teradata Tools and Utilities

Product Client Server

Teradata ManagerTeradata Performance Monitor Teradata AdministratorTeradata Statistics WizardTeradata Dynamic Workload ManagerTeradata Query Scheduler

1.2 GHz Pentium IV512 MB RAM40 GB Hard Drive (200 MB for TMGR)CD ROM Drive

2 GHz Pentium IV1 GB RAM2*30 GB Hard Drive (200 MB for TMGR)CD ROM DriveModem (required to use the Send a Page action of the Alerts facility)

Teradata SQL Assistant/Web Edition

1.2 GHz Pentium IV256MB RAM10 Mbps Network Interface Card or Modem1024x768 SVGA Display

2 GHz Pentium IV1 GB RAM100 Mbps Network Interface Card1024x768 SVGA DisplayCD ROM Drive or DVD Drive2*18 GB Hard Drive

Teradata SQL Assistant 1.2 GHz Pentium IV256 MB RAMCD ROM DriveSVGA or better, Graphics Controller and MonitorMinimum 100 MB free disk space

44 Teradata Tools and Utilities Installation Guide for Microsoft Windows

Page 45: Teradata Tools and Utilities - dbmanagement.infodbmanagement.info/Books/MIX/2407_TeraData.pdf · Teradata Tools and Utilities Installation Guide for Microsoft Windows 7 ... Software

Chapter 2: Before You InstallInstallation Recommendations

"ODBC Driver for Teradata 12.00.00.00 is already installed.Do you want to reinstall it?"

The second message is displayed if a dependent product already exists and its version is not equal to the dependent product being installed. It asks if you want to overwrite the existing installed product.

For example, the following message is for the ODBC Driver for Teradata:

"ODBC Driver for Teradata 3.6.0.0 is already installed. Do you want to overwrite it with version 12.00.00.00?"

Teradata Generic Security Services

Multiple Versions of Teradata Generic Security Services

Since it may not be practical to install or upgrade all parts of your system to the latest version of the Teradata Generic Security Services at one time, multiple versions of the software can be installed on the system at the same time. See the section on “TDGSS File Maintenance Tools” in Teradata Database Security Administration.

FAT or NTS File System for Teradata Generic Security Services

Both the NTS and FAT file systems are now supported for Teradata Generic Security Services (TeraGSS) Client. When installing on a FAT file system an LCLIENT directory is created and files are copied to it.

Whenever tdgssconfig is run, it must be run from the LCLIENT\bin directory on a FAT file system. See the section on “TDGSS File Maintenance Tools” in Teradata Database Security Administration.

PUT Installations

Some of products can be installed using the software Teradata Parallel Upgrade Tool (PUT). Currently the following products are the only Teradata Tools and Utilities products that can be installed using the software Parallel Upgrade Tool (PUT) on Microsoft Windows:

• Basic Teradata Query (BTEQ)

• Named Pipes Access Module

• Shared ICU Libraries for Teradata

• Teradata Call-Level Interface version 2 (CLIv2)

• Teradata Data Connector

• Teradata Generic Security Services - Client

• FastExport

• FastLoad

• MultiLoad

• MQ Access Module

• TPump

Teradata Tools and Utilities Installation Guide for Microsoft Windows 45

Page 46: Teradata Tools and Utilities - dbmanagement.infodbmanagement.info/Books/MIX/2407_TeraData.pdf · Teradata Tools and Utilities Installation Guide for Microsoft Windows 7 ... Software

Chapter 2: Before You InstallInstallation Recommendations

To use PUT to install these products, refer to the Parallel Upgrade Tool (PUT) User Guide for Microsoft Windows.

Typical, Custom, and Network Installations

Running the installation you can install:

• All of the Teradata Tools and Utilities products on the current CD (Typical installation)

• Some of the products on the current CD (Custom installation)

• It allows you to copy the product’s setup files to a specified folder (Network installation)

For a list of product dependencies, refer to “Software Requirements” on page 28.

Command Line Installations

You can “silently” install Windows packages from the command prompt:

• Download packages from the Teradata Software Server

• Copy packages using a Network Setup Type, then copy them to the target machine

For a list of product dependencies, refer to “Software Requirements” on page 28.

Teradata Download Center Installations

Some Teradata Tools and Utilities products are available for download on the Teradata Download Center. Some, like the device independent .jar files for the Teradata Driver for the JDBC Interface can only be downloaded from the center.

The following software drivers can be downloaded:

• ODBC Driver for Teradata (ODBC)

• Teradata Driver for the JDBC Interface (JDBC)

• OLE DB Provider for Teradata (OLE DB)

• Call-Level Interface (CLIv2)

The Teradata Download Center is located at:

http://www.teradata.com --> Support Services --> Downloads--> Drivers, UDFs, and Toolbox --> Drivers and Connectivity Software

Teradata Parallel Transporter Installation

Multiple versions of Teradata Parallel Transporter can co-exist on the system. The exception is the emergency fix (e-fix) version of Teradata Parallel Transporter. This version will overwrite the original Teradata Parallel Transporter version.

For example, an installation of Teradata Parallel Transporter 12.00.00.01 version will overwrite the previously released version of Teradata Parallel Transporter 12.0.0.0.

If you have an earlier version of Teradata Parallel Transporter installed, you must install the later version into a different folder.

46 Teradata Tools and Utilities Installation Guide for Microsoft Windows

Page 47: Teradata Tools and Utilities - dbmanagement.infodbmanagement.info/Books/MIX/2407_TeraData.pdf · Teradata Tools and Utilities Installation Guide for Microsoft Windows 7 ... Software

Chapter 2: Before You InstallInstallation Recommendations

If you have the following user environment variables, it is recommended that you delete them before running a Teradata Parallel Transporter job:

• TWB_ROOT

• _MSGCATLOCATION

Uninstalling Previous Software

You do not have to uninstall previous versions of Teradata Tools and Utilities software. However, if you have an earlier version of Teradata Manager installed, you must install the later version into a different folder.

Note: The 64-bit BTEQ package on Windows has been decommissioned. The install/upgrade procedure will not automatically remove this decommissioned 64-bit BTEQ package, however uninstalling the 32-bit BTEQ version will remove the previously installed 64-bit version.

Default Folders

The main folders on the application CDs are:

Table 22 shows the default destination and program folders for the Teradata Tools and Utilities products. <Boot Drive> is the drive destination of the Windows boot up drive.

Table 22 also shows the product response files (*.iss files) that are copied from the Windows\TTU\ClientISS folder on the CD to the %TEMP%\ClientISS folder on the local computer during installation. If a product response file already exists on the local computer, it will be copied over. You can review these files to help resolve installation problems.

Default Product Response Files

All product response files can be used for both new installations and upgrades. For all products, except Teradata Manager, the product response file installs all product components. For Teradata Manager, the product response file installs only the client components.

Procedure - Modifying a Product Response file

To modify a product response file in %TEMP%\ClientISS, use Notepad or another text editor. For example, if you want to change the folder name:

Table 21: Default CD Folders

The folder: Contains:

Windows\Bin files used for autorun.

Windows\TTU\ClientISS response files for products that need them to support silent installation.

Windows\TTU\setupdir Files used in installation.

Teradata Tools and Utilities Installation Guide for Microsoft Windows 47

Page 48: Teradata Tools and Utilities - dbmanagement.infodbmanagement.info/Books/MIX/2407_TeraData.pdf · Teradata Tools and Utilities Installation Guide for Microsoft Windows 7 ... Software

Chapter 2: Before You InstallInstallation Recommendations

1 Use an editor to open the response file.

2 Change the value of the szFolder field.

3 Save and exit the response file.

If you encounter problems during silent installation, refer to “Silent Installation Result Codes” on page 156.

Table 22: Default Folders and Product Response Files

Product Default Destination Folder (<Boot Drive>) Default Program Folder

Basic Teradata Query (BTEQ)

BTEQ.iss

%Program Files%\NCR\Teradata Client Teradata Client

BTEQWin

No product response file

%Program Files%\NCR\Teradata Client Teradata Client

Named Pipes Access Module

NamedPipes.iss

%SystemRoot%\system32 None

ODBC Driver for Teradata

odbc.iss

%Program Files%\NCR\ODBC Driver for Teradata

ODBC Driver for Teradata

Shared ICU Libraries for Teradata

SharedICULibrariesforTeradata.issSharedICULibrariesforTeradata64.iss

%Program Files%\NCR\Common Files\Shared ICU Libraries for Teradata\Lib

None

Teradata Access Module for Tivoli

Teradata_Access_Module_for_Tivoli.iss

%Program Files%\NCR\Teradata Client Teradata Tivoli Access Module

Teradata Access Module for JMS

Teradata_JMS.iss

%Program Files%\Common Files\NCR\JMSAXSMOD

None

Teradata Administrator

No product response file

%Program Files%\NCR\Teradata Administrator <version>

Teradata Administrator <version>

Teradata Archive/Recovery Utility (ARC)

ARC.iss

%Program Files%\NCR\Teradata Client Teradata Client

Teradata C Preprocessor2

Preprocessor.iss

%Program Files%\NCR\Teradata Client Teradata Client

Teradata Call-Level Interface version 2 (CLIv2)

CLI_Module.issCLI_Module64.iss

<Boot Drive>:\Program Files\NCR\Teradata Client\cliv2

None

Teradata Data Connector

DataConnector.issDataConnector64.iss

%SystemRoot%\system32 None

48 Teradata Tools and Utilities Installation Guide for Microsoft Windows

Page 49: Teradata Tools and Utilities - dbmanagement.infodbmanagement.info/Books/MIX/2407_TeraData.pdf · Teradata Tools and Utilities Installation Guide for Microsoft Windows 7 ... Software

Chapter 2: Before You InstallInstallation Recommendations

Teradata Dynamic Workload Manager (Teradata DWM)Teradata_Dynamic_Workload_Manager.iss

%Program Files%\NCR\Teradata Dynamic Workload Manager<version>

None

Teradata Generic Security Services (TeraGSS) Client

There is no product response file.

%Program Files%\NCR\Teradata GSS\nt-i386\<version> (for 32-bit)

%Program Files%\NCR\Teradata GSS\nt-i386\<version> (for 64-bit)

Same as Default Destination Folder

Teradata Generic Security Services (TeraGSS Java) Client Java

There is no product response file.

Teradata FastExport

FastExport.iss

%Program Files%\NCR\Teradata Client Teradata Client

Teradata FastLoad

FastLoad.iss

%Program Files%\NCR\Teradata Client Teradata Client

Teradata Index Wizard

Teradata_Index_Wizard.iss

%Program Files%\NCR\Teradata Index Wizard <version>

Teradata Index Wizard <version>

Teradata Manager

TMgr.iss

%Program Files%\NCR\Teradata Manager <version>

Teradata Manager <version>

Teradata MultiLoad

MultiLoad.iss

%Program Files%\NCR\Teradata Client Teradata Client

Teradata MultiTool

No product response file

%Program Files%\NCR\Teradata MultiTool Teradata Client

Teradata OLE DB Access Module

OLE_DB_AM.iss

%Program Files%\NCR\Teradata Client Teradata Client

• Teradata Parallel Transporter ICU Library

Teradata_Parallel_Transporter_ICU_Library.iss

\Program Files\NCR\Teradata Parallel Transporter\<version>\Bin

None

Teradata Performance Monitor

Teradata_Performance_Monitor.iss

%Program Files%\NCR\Teradata Performance Monitor

Teradata Performance Monitor <version>

Teradata Query Director

Query_Director.iss

%Program Files%\NCR\Teradata Query Director Teradata Query Director <version>

Teradata Query Scheduler Administrator

TDQM_Admin.iss

%Program Files%\NCR\Teradata Query Scheduler Admin <version>

Teradata Query Scheduler Admin <version>

Table 22: Default Folders and Product Response Files (continued)

Product Default Destination Folder (<Boot Drive>) Default Program Folder

Teradata Tools and Utilities Installation Guide for Microsoft Windows 49

Page 50: Teradata Tools and Utilities - dbmanagement.infodbmanagement.info/Books/MIX/2407_TeraData.pdf · Teradata Tools and Utilities Installation Guide for Microsoft Windows 7 ... Software

Chapter 2: Before You InstallRestarting After Installation

Note: The Teradata SQL Assistant/Web Edition software will be installed on the drive where the Microsoft Internet Information Services (IIS) software was previously installed.

Restarting After Installation

After installation, restart your computer to ensure that the environment variables are set correctly and allow the upgrade of files in use to complete.

Teradata Query Scheduler Client

TDQM_Client.iss

%Program Files%\NCR\Teradata Query Scheduler <version>

Teradata Query Scheduler Utilities <version>

Teradata Query Scheduler Server

TDQM_Server.iss

(use port number 3000)

%Program Files%\NCR\Teradata Query Scheduler Server <version>\server

None

Teradata SQL Assistant

No product response file

%Program Files%\NCR\Teradata SQL Assistant <version>

None

Teradata SQL Assistant/Web Edition

No product response file

\inetpub\wwwroot\<SqlAssistantWeb> a None

Teradata Statistics Wizard

Teradata_Statistics_Wizard.iss

%Program Files%\NCR\Teradata Statistics Wizard <version>

None

Teradata System Emulation Tool

Teradata_System_Emulation_Tool.iss

%Program Files%\NCR\Teradata System Emulation Tool <version>

Teradata System Emulation Tool <version>

Teradata TPump

TPump.iss

%Program Files%\NCR\Teradata Client Teradata Client

Teradata Visual Explain

Visual_Explain.iss

%Program Files%\NCR\Teradata Visual Explain <version>

Teradata Visual Explain <version>

Teradata Workload Analyzer

twa.iss

\Program Files\NCR\Teradata Workload Analyzer 12.0

None

WebSphere MQ Access Module

WebSphere_Access_Module_for_Teradata.iss

%Program Files%\Common Files\AXSMOD None

Table 22: Default Folders and Product Response Files (continued)

Product Default Destination Folder (<Boot Drive>) Default Program Folder

50 Teradata Tools and Utilities Installation Guide for Microsoft Windows

Page 51: Teradata Tools and Utilities - dbmanagement.infodbmanagement.info/Books/MIX/2407_TeraData.pdf · Teradata Tools and Utilities Installation Guide for Microsoft Windows 7 ... Software

Chapter 2: Before You InstallTechnical Assistance

Technical Assistance

Technical assistance during installation of the Teradata Tools and Utilities software is available from the Teradata Solutions Customer Services Remote Services Center (TSCS-RSC).

For more information, refer to the

Teradata Tools and Utilities Release Definition, Release 12.0.

Teradata Tools and Utilities Installation Guide for Microsoft Windows 51

Page 52: Teradata Tools and Utilities - dbmanagement.infodbmanagement.info/Books/MIX/2407_TeraData.pdf · Teradata Tools and Utilities Installation Guide for Microsoft Windows 7 ... Software

Chapter 2: Before You InstallInstalling Required Software for Teradata SQL Assistant/Web Edition

Installing Required Software for Teradata SQL Assistant/Web Edition

This section describes the required software that must be loaded to connect Windows clients to the Teradata SQL Assistant/Web Edition.

• Installing Microsoft Internet Information Services

• Installing ASP.NET for Windows Server 2003

• Installing Microsoft .NET Framework (version 1.1)

• Installing Microsoft Visual J#.Net Redistributable Package (version 1.1)

• Installing the Cumulative Security Patch for IIS

Teradata SQL Assistant/Web Edition uses a Web browser to interface to the Teradata Database. The Teradata SQL Assistant/Web Edition software must be installed on a server computer.

Several client computers can then connect to the server. Clients, which can run on any Windows operating system, requires either Microsoft Internet Explorer, version 5.5 or later, or Netscape 7.0 or higher to access the Teradata Database through the server.

Note: The Windows 2000 Professional and 32-bit Windows XP operating systems support 10 or fewer clients. The Windows 2000 Server, Windows 2000 Advanced Server, Windows Server 2003 and Windows Vista operating systems support more than 10 clients.

You must have Microsoft Internet Explorer, version 5.5 or later, installed on your computer. If you use version 5.5, you must install Internet Explorer 5.5 Service Pack 2. If you use version 6.0, you must install Internet Explorer 6.0 Service Pack 1.

ODBC Driver for Teradata and Microsoft Data Access Components will be installed as part of the Teradata Tools and Utilities installation. To use Teradata SQL Assistant/Web Edition, you must install the versions of these products provided on the Teradata Tools and Utilities 12.0 Teradata Utility Pak CD.

Before installing the Teradata SQL Assistant/Web Edition software, install the following products in the order given. You must have administrator privileges to install the software.

• If your computer runs the Windows 2000 Professional or 32-bit Windows XP operating system, install:

• “Installing Microsoft Internet Information Services” on page 53

Note: To install the Microsoft Internet Information Services (IIS), you must have a Windows 2000 or Windows XP operating system CD or access to Windows 2000 or Windows XP from an alternate location such as a network server.

If your computer runs on the Windows Server 2003, install:

• “Installing ASP.NET for Windows Server 2003” on page 53

On any computer, except one running Windows Vista, that will run Teradata SQL Assistant/Web Edition, install the following:

• “Installing Microsoft .NET Framework (version 1.1)” on page 54

52 Teradata Tools and Utilities Installation Guide for Microsoft Windows

Page 53: Teradata Tools and Utilities - dbmanagement.infodbmanagement.info/Books/MIX/2407_TeraData.pdf · Teradata Tools and Utilities Installation Guide for Microsoft Windows 7 ... Software

Chapter 2: Before You InstallInstalling Required Software for Teradata SQL Assistant/Web Edition

Installing Microsoft Internet Information Services

Procedure - Installing Microsoft Internet Information Services

Follow these steps to install Microsoft Internet Information Services on your client.

1 Go to Start > Settings > Control Panel > Add/Remove Programs.

2 In the left panel of the Add/Remove Programs dialog box, click Add/Remove Windows Components.

3 In the Windows Components Wizard dialog box, select Internet Information Services (IIS).4 Click Next and follow the installation instructions. You must have a Windows Installer CD.

5 After the IIS installation is complete, go to the next section to install Microsoft .NET Framework, version 1.1.

Installing ASP.NET for Windows Server 2003

If your computer runs on the Windows Server 2003 operating system, you must install ASP.NET:

Procedure - Installing ASP.NET for Windows Server 2003

Follow these steps to install ASP.NET for Windows Server 2003 on your client.

1 Go to Start > Settings > Control Panel > Add/Remove Programs.

2 In the left panel of the Add/Remove Programs dialog box, click Add/Remove Windows Components.

3 In the Windows Components Wizard dialog box, select Application Server.4 Click Details and check the ASP.NET checkbox.

5 Click OK.

6 Click Next to add the software.

7 Click Finish when ASP.NET has been added.

8 Close the Add/Remove Programs control panel.

Procedure - Installing ASP.NET on Windows Vista

Follow these steps to install ASP.NET for Windows Server 2003 on a Windows Vista client.

1 Go to Start > Settings > Programs and Features > Add/Remove Programs.

2 In the left panel of the Add/Remove Programs dialog box, click Turn Windows features on or off.

3 In the Features Wizard dialog box, select Application Server.

Teradata Tools and Utilities Installation Guide for Microsoft Windows 53

Page 54: Teradata Tools and Utilities - dbmanagement.infodbmanagement.info/Books/MIX/2407_TeraData.pdf · Teradata Tools and Utilities Installation Guide for Microsoft Windows 7 ... Software

Chapter 2: Before You InstallInstalling Required Software for Teradata SQL Assistant/Web Edition

4 Under the Internet Information Services tab, go to Web Management Tools->IIS 6 Management Compatibility and click the IIS Metabase and IIS 6 configuration compatibility checkbox.

5 Under the Internet Information Services tab, go to World Wide Web Services->Application Development Features and click the ASP.NET checkbox.

6 Click OK and follow the installation instructions.

Installing Microsoft .NET Framework (version 1.1)

On any computer running an operating system older than Windows Vista, follow these steps to install the Microsoft .NET Framework, version 1.1. Before installing the Microsoft .NET Framework, you must first install the Microsoft .NET Framework Redistributable, version 1.1. This is not necessary on a computer running Windows Vista.

Note: On Windows Vista, it is not necessary to install dotnetetfx.exe.

Procedure - Installing Microsoft .NET Framework (version 1.1)

Follow these steps to install Microsoft .NET Framework (version 1.1) on your client.

1 Go to http://msdn.microsoft.com/downloads.

2 From this page, find the Microsoft .NET Framework Redistibutable, version 1.1 software download page.

3 Download Microsoft .NET Framework Redistibutable, version 1.1 software.

4 In the dotnetfx.exe dialog box, enter the location where you want to place the extracted files, then click OK. Remember this location.

5 From your Explorer window, find the dotnetfx.exe file you just saved and double-click on it.

6 In the Microsoft .NET Framework Setup dialog box, click Yes to install the Microsoft .NET Framework package.

7 If the installation requests, restart your computer; otherwise, continue.

8 After the Microsoft .NET Framework installation is complete, go to the next section to install Microsoft Visual J#.Net Redistributable Package.

Installing Microsoft Visual J#.Net Redistributable Package (version 1.1)

On any computer that will run Teradata SQL Assistant/Web Edition, follow these steps to install the Microsoft Visual J#.Net Redistributable Package (version 1.1).

54 Teradata Tools and Utilities Installation Guide for Microsoft Windows

Page 55: Teradata Tools and Utilities - dbmanagement.infodbmanagement.info/Books/MIX/2407_TeraData.pdf · Teradata Tools and Utilities Installation Guide for Microsoft Windows 7 ... Software

Chapter 2: Before You InstallInstalling Required Software for Teradata SQL Assistant/Web Edition

Procedure - Installing the Microsoft Visual J#.Net Redistributable Package

Follow these steps to install Microsoft Visual J#.Net Redistributable Package (version 1.1) on your client.

1 Go to http://msdn.microsoft.com/downloads.

2 From this page, find the Microsoft Visual J#.Net Redistributable Package (version 1.1) software download page.

3 Download Microsoft Visual J#.Net Redistributable Package (version 1.1) software.

Installing the Cumulative Security Patch for IIS

If you use Microsoft Internet Information Services (IIS) to operate a Web site, and are operating the Web site when you are using Teradata SQL Assistant/Web Edition, you must ensure that you have the latest Microsoft Internet Information Services (IIS) patches installed.

The patches are needed because of the previous security vulnerabilities that allow an attacker to take over your computer to the extent that the attacker could change Web pages, install and run software, or reformat the hard drive. Even rarely visited Web sites could be attacked via a virus or worm. You eliminate this vulnerability by staying up-to-date with the latest patches to Microsoft Internet Information Services (IIS).

Search at the following Web site for “IIS Patches”:

http://www.microsoft.com/

Changing Microsoft Internet Explorer Security Settings

To enable Teradata SQL Assistant/Web Edition to return information to you from the Web, you may need to change the security settings in Microsoft Internet Explorer.

Procedure - Changing Microsoft Internet Explorer Security Settings

Follow these steps to change the Explorer settings for version 5.5 or version 6.0:

1 Open Microsoft Internet Explorer.

2 Go to Tools > Internet Options.

3 In the Internet Options dialog box, click the Security tab, then click Custom Level.4 From the Security Settings dialog box, enable the following settings:

a Downloads / File download: click EnableThis allows you to save the query, history, or answer set.

b Miscellaneous / Submit non encrypted form data: click EnableThis allows you to submit HTML forms.

c Scripting / Active scripting: click EnableThis allows you to submit SQL queries.

Teradata Tools and Utilities Installation Guide for Microsoft Windows 55

Page 56: Teradata Tools and Utilities - dbmanagement.infodbmanagement.info/Books/MIX/2407_TeraData.pdf · Teradata Tools and Utilities Installation Guide for Microsoft Windows 7 ... Software

Chapter 2: Before You InstallInstalling Required Software for Teradata SQL Assistant/Web Edition

Leave all other settings as is.

5 In the Security Settings dialog box, click OK.

6 In the Internet OptionsOK dialog box, click.

Changing Cookies Settings on Microsoft Internet Explorer

A cookie is a packet of information sent by an HTTP server to a browser, then sent back by the browser each time it accesses that server. Cookies are typically used to identify a user without requiring them to sign in each time they access a Web site.

To differentiate you from other users, Teradata SQL Assistant/Web Edition uses HTTP cookies. Changing the cookies settings in your Microsoft Internet Explorer is necessary for the following reasons:

• So you won't have to log on twice, once for the application and again for the Teradata Database.

• For the history table to be maintained for each specific user.

Changing Cookie Settings on Microsoft Internet Explorer, version 5.5

Procedure - Changing the Cookie Settings on Microsoft Internet Explorer 5.5

Follow these steps to change the settings on Microsoft Internet Explorer, version 5.5:

1 Open Microsoft Internet Explorer.

2 Go to Tools > Internet Options.

3 In the Internet Options dialog box, click the Security tab, then click Custom Level.4 In the Security Settings dialog box, enable the following settings:

a Cookies / Allow cookies that are stored on your computer: click Enable

b Cookies / Allow per-session cookies (not stored): click EnableLeave all other settings as is.

5 In the Security Settings dialog box, click OK.

6 In the Internet Options dialog box, click OK.

Changing Cookie Settings on Microsoft Internet Explorer, version 6.0

Procedure - Changing the Cookie Settings on Microsoft Internet Explorer 6.0

Follow these steps to change the settings on Microsoft Internet Explorer, version 6.0:

1 Open Microsoft Internet Explorer.

2 Go to Tools > Internet Options.

3 In the Internet Options Privacy Advanced dialog box, click the tab, then click.

56 Teradata Tools and Utilities Installation Guide for Microsoft Windows

Page 57: Teradata Tools and Utilities - dbmanagement.infodbmanagement.info/Books/MIX/2407_TeraData.pdf · Teradata Tools and Utilities Installation Guide for Microsoft Windows 7 ... Software

Chapter 2: Before You InstallInstalling Required Software for Teradata SQL Assistant/Web Edition

4 In the Advanced Privacy Settings dialog box, change your settings as follows:

a Override automatic cookie handling: check this check box

b First-party cookies: select Accept

c Third-party cookies: select Accept

d Always allow session cookies: clear this check box

Leave all the other settings as is.

5 In the Advanced Privacy Settings dialog box, click OK.

6 In the Internet Options dialog box, click OK.

Setting the Number of Client Connections

The Windows 2000 Professional and 32-bit Windows XP operating systems support 10 or fewer clients. The Windows 2000 Server, Windows 2000 Advanced Server and the Windows 2003 Server operating systems support more than 10 clients.

Windows 2000 Professional and Windows 2000 Advanced Server

If your computer runs on the Windows 2000 Server or Windows 2000 Advanced Server operating system, the number of client computers that connect to your server can be changed. This is usually done by the system administrator.

Procedure - Setting the Number of Client Connections on Windows 2000

Follow these steps to change the client connections setting on Windows 2000 and Windows 2000 Advanced Server:

1 Go to Start > Settings > Control Panel > Administrative Tools > Internet Services Manager.2 In the Internet Information Services dialog box, in the left panel, click the plus sign (+) next

to the name of the computer to expand the tree.

3 Right-click to get a pop-up menu, then click Properties.

4 In the Default Web Site Properties dialog box, select the Web Site tab.

5 Choose one of the following options:

a UnlimitedThis allows an unlimited number of connections to occur simultaneously.

b Limited to <number> connections

Select the maximum number of simultaneous connections to be allowed.

6 Click Apply, then click OK.

7 Close the Internet Information Services dialog box.

Teradata Tools and Utilities Installation Guide for Microsoft Windows 57

Page 58: Teradata Tools and Utilities - dbmanagement.infodbmanagement.info/Books/MIX/2407_TeraData.pdf · Teradata Tools and Utilities Installation Guide for Microsoft Windows 7 ... Software

Chapter 2: Before You InstallInstalling Required Software for Teradata SQL Assistant/Web Edition

Windows 2003 Server

If your computer runs on the Windows 2003 Server operating system, the number of client computers that connect to your server can be changed. This is usually done by the system administrator.

Procedure - Setting the Number of Client Connections on Windows 2003 Server

Follow these steps to change the connections setting on Windows 2003 Server:

1 Go to Start > Settings > Control Panel > Administrative Tools > Internet Information Services Manager.

2 In the Internet Information Services dialog box, in the left panel, click the plus sign (+) next to the name of the computer to expand the tree.

3 Expand the WebSites folder to display the Default Web Site.

4 Right-click Default Web Site to get a pop-up menu, then click Properties.

5 In the Default Web Site Properties dialog box, select the Performance tab.

6 Choose one of the following options:

a UnlimitedThis allows an unlimited number of connections to occur simultaneously.

b Limited to <number> connections

Select the maximum number of simultaneous connections to be allowed.

7 Click Apply, then click OK.

8 Close the Internet Information Services dialog box.

Setting the Number of Clients on Windows Vista

Procedure - Setting the Number of Clients on Windows Vista

Follow these steps to set the number of clients on Windows Vista.

1 Go to Start->Settings->Control Panel->Administrative Tools->Internet Information Services.

2 Drill-down to the Default web-site and select it.

3 On the right side of the screen, there is a list of Actions, click on the Limits… link under Configure.

4 Check the Limit number of connections: check-box and enter a session limit.

5 Click OK.

6 Close the Internet Information Services dialog.

58 Teradata Tools and Utilities Installation Guide for Microsoft Windows

Page 59: Teradata Tools and Utilities - dbmanagement.infodbmanagement.info/Books/MIX/2407_TeraData.pdf · Teradata Tools and Utilities Installation Guide for Microsoft Windows 7 ... Software

Chapter 2: Before You InstallInstalling Required Software for Teradata SQL Assistant/Web Edition

Updating the Teradata Parallel Transporter API

The following is a list of major new features in Teradata PT API 12.0. For a complete list of changes to the product, see the Teradata Tools and Utilities Release Definition associated with this release.

• Unicode Support (UTF16)

• Buffer Mode Exporting with Export Driver’s New GetBuffer Function

• Performance Enhancement for the Export Driver’s GetRow Function

• Array Support for the Stream Driver

When upgrading applications built with previous versions of the Teradata Parallel Transporter API to the current release of the Teradata Parallel Transporter API, note that the Teradata Parallel Transporter API header files have been changed in the 12.0 release of the product. Applications built with previous versions of Teradata Parallel Transporter API must be re-compiled with these updated header files in order to use Teradata PT API 12.0.

The Teradata Parallel Transporter ICU library is installed with Teradata Parallel Transporter API and is located in the same directory as the other Teradata Parallel Transporter API libraries.

Teradata Tools and Utilities Installation Guide for Microsoft Windows 59

Page 60: Teradata Tools and Utilities - dbmanagement.infodbmanagement.info/Books/MIX/2407_TeraData.pdf · Teradata Tools and Utilities Installation Guide for Microsoft Windows 7 ... Software

Chapter 2: Before You InstallInstalling Required Software for Teradata SQL Assistant/Web Edition

60 Teradata Tools and Utilities Installation Guide for Microsoft Windows

Page 61: Teradata Tools and Utilities - dbmanagement.infodbmanagement.info/Books/MIX/2407_TeraData.pdf · Teradata Tools and Utilities Installation Guide for Microsoft Windows 7 ... Software

CHAPTER 3

Installing the Teradata Tools andUtilities Software

This chapter describes how to install and configure the Teradata Tools and Utilities software.

• Types of Installation

• Installing Using PUT

• Installing Using the Client Main Install

• Typical Installation

• Custom Installation

• Network Installation

• Installing a Package from the Command Prompt

• Installing the Teradata Driver for the JDBC Interface

• Installing the OLE DB Provider for Teradata from the Download Center

Types of Installation

There are four methods you can use to install Teradata Tools and Utilities products:

• PUT — The Teradata Parallel Upgrade Tool can be used as an alternative method of installing some of the Teradata Tools and Utilities products you purchased. See “Installing Using PUT” below.

• Using the Client Main Install — All Teradata Tools and Utilities products, except for the Teradata Driver for the JDBC Interface and the OLE DB Provider for Teradata can be installed using the Client Main Install. See “Installing Using the Client Main Install” on page 63. The Client Main Install is typical of Windows installations, allowing three forms of installation:

• Typical Installation — A typical installation installs all the products on each CD. See “Typical Installation” on page 64.

• Custom Installation — A custom installation installs only those products you select from the available products. See “Custom Installation” on page 74.

• Network Installation— A network installation copies of the installation packages for the selected products to a specified folder. The network installation does not actually install the products. This must be done by the user. See “Network Installation” on page 78.

Teradata Tools and Utilities Installation Guide for Microsoft Windows 61

Page 62: Teradata Tools and Utilities - dbmanagement.infodbmanagement.info/Books/MIX/2407_TeraData.pdf · Teradata Tools and Utilities Installation Guide for Microsoft Windows 7 ... Software

Chapter 3: Installing the Teradata Tools and Utilities SoftwareInstalling Using PUT

• Installing from the Command Prompt — Packages can be downloaded from a patch server, or copied using Network Setup Type, then installed on the target machine by providing the package response file name as an input to the setup.exe command at the command prompt. These packages are installed silently. See “Installing a Package from the Command Prompt” on page 80.

• Downloading Files from the Teradata Download Center — Several Teradata Tools and Utilities products can be downloaded from the Teradata Download Center, including:

• Teradata Call-Level Interface version 2 (CLIv2) — This product and its dependent products: Teradata Generic Security Services (TDGSS) Client, and the Shared ICU Libraries for Teradata, are available for download.

• ODBC Driver for Teradata (ODBC) — This product and its dependent products: Teradata Generic Security Services (TDGSS) Client, and the Shared ICU Libraries for Teradata, are available for download.

Additionally, three other products are available from the Teradata Download Center:

• Teradata Driver for the JDBC Interface. See “Installing the Teradata Driver for the JDBC Interface” on page 84.

• OLE DB Provider for Teradata. See “Installing the OLE DB Provider for Teradata from the Download Center” on page 85.

• .NET Data Provider for Teradata. See the .NET Data Provider for Teradata, Release Definition.

Installing Using PUT

Some of products can be installed using the software Teradata Parallel Upgrade Tool (PUT). Currently the following products are the only Teradata Tools and Utilities products that can be installed using the software Parallel Upgrade Tool (PUT) on Microsoft Windows:

• Basic Teradata Query (BTEQ)

• Named Pipes Access Module

• Shared ICU Libraries for Teradata

• Teradata Call-Level Interface version 2 (CLIv2)

• Teradata Data Connector

• Teradata Generic Security Services - Client

• FastExport

• FastLoad

• MultiLoad

• MQ Access Module

• TPump

To use PUT to install these products, refer to the Parallel Upgrade Tool (PUT) User Guide for Microsoft Windows.

62 Teradata Tools and Utilities Installation Guide for Microsoft Windows

Page 63: Teradata Tools and Utilities - dbmanagement.infodbmanagement.info/Books/MIX/2407_TeraData.pdf · Teradata Tools and Utilities Installation Guide for Microsoft Windows 7 ... Software

Chapter 3: Installing the Teradata Tools and Utilities SoftwareInstalling Using the Client Main Install

Installing Using the Client Main Install

This section describes how to use the Client Main Install to install Teradata Tools and Utilities products.

Initial Procedure for Typical, Custom or Network Installations

Make sure you have the appropriate Teradata Tools and Utilities CDs. Tables in the “Installation Kit” section beginning on “Installation Kit” on page 31 show which applications are on each CD. The applications can be installed in any order:

• Teradata Utility Pak - Utilities CD#1 (Windows Products)

• Teradata Utility Pak - Utilities CD#2 (HP-UX, Linux, MP-RAS)

• Teradata Utility Pak - Utilities CD#3 (AIX and Solaris Products)

• Database Management

• Preprocessors - CD # 1 (Windows Products)

• Preprocessors - CD #2 (HP-UX, Linux, MP-RAS)

• Preprocessors - CD #3 (AIX and Solaris Products)

• Load/Unload - CD#1 (Windows Products)

• Load/Unload - CD#2 (HP-UX, Linux, MP-RAS)

• Load/Unload - CD#3 (AIX and Solaris Products)

• Parallel Transporter - CD#1 (Windows Products)

• Parallel Transporter - CD#2 (HP-UX, Linux, MP-RAS)

• Parallel Transporter - CD#3 (AIX and Solaris Products)

• Query Director

• Tape Storage Management Enablers

• Meta Data Services

Note: This manual does not describe how to install the OLE DB Provider software. Refer to the OLE DB Provider for Teradata Installation and User Guide.

Note: This installation guide does not describe how to install the Meta Data Services. For installation on how to install the Teradata Meta Data Services Installation and Administration Guide.

Note: This installation guide does not describe how to install the Teradata Query Director. For installation on how to install the Teradata Query Director User Guide.

Note: The figures shown in this document are examples only. Depending on the Teradata Tools and Utilities products used in your installation, some dialog boxes and screens might vary from those shown in this guide.

Setup Procedure

The setup procedure for installing the Teradata Tools and Utilities software on your computer is identical for the three types of installation.

Teradata Tools and Utilities Installation Guide for Microsoft Windows 63

Page 64: Teradata Tools and Utilities - dbmanagement.infodbmanagement.info/Books/MIX/2407_TeraData.pdf · Teradata Tools and Utilities Installation Guide for Microsoft Windows 7 ... Software

Chapter 3: Installing the Teradata Tools and Utilities SoftwareInstalling Using the Client Main Install

Procedure - Beginning an Installation

Follow these steps to begin an installation:

1 Close all active Windows programs and disable any virus protection software running on the computer.

2 Since a “Typical” installation installs Teradata SQL Assistant/Web Edition software, if you haven’t already done so, before you go any further, go to “Installing Required Software for Teradata SQL Assistant/Web Edition” on page 52 and install the prerequisites described for Teradata SQL Assistant/Web Edition.

3 Insert the first Teradata Tools and Utilities CD into the CD drive. The applications can be installed in any order.

4 In the Welcome to Teradata Tools and Utilities dialog box, click Install Product.If the Welcome dialog box does not appear shortly after the CD is inserted, use Windows Explorer to navigate to the main folder of the CD. Double-click the setup.bat file to start the installation process.

5 In the Choose Setup Language dialog box, click the drop-down arrow and select the desired language from the list that appears, then click OK. English and Japanese are the only setup languages currently supported.

6 In the Welcome dialog box, click Next.7 In the Software License Agreement dialog box, read the agreement, then click Yes to accept

it.

8 In the Setup Type dialog box, click the name of the desired installation setup:

• A Typical setup installs all products from the CD. Highlight Typical, click Next, then go to “Typical Installation” on page 64 for further instructions.

• A Network setup copies the setup files for the products to a folder that you specify. The Network setup does not install the products; you must do this in a separate process. Highlight Network, click Next, then go to “Network Installation” on page 78 for further instructions.

• A Custom setup installs only those products selected from the CD. Highlight Custom, click Next, then go to “Custom Installation” on page 74 for further instructions.

Typical Installation

A typical installation installs all the products on each CD.

The screens shown in this section are examples of screens that appear during a Typical Installation. Depending on the Teradata Tools and Utilities products used in your installation, some dialog boxes and screens might vary from those shown in this guide.

Procedure - Performing a Typical Installation

Follow these steps to perform a typical installation of Teradata Tools and Utilities. This installation installs all the Teradata Tools and Utilities products.

64 Teradata Tools and Utilities Installation Guide for Microsoft Windows

Page 65: Teradata Tools and Utilities - dbmanagement.infodbmanagement.info/Books/MIX/2407_TeraData.pdf · Teradata Tools and Utilities Installation Guide for Microsoft Windows 7 ... Software

Chapter 3: Installing the Teradata Tools and Utilities SoftwareInstalling Using the Client Main Install

1 After highlighting Typical and clicking Next in the initial Setup Type dialog box, the Choose Destination Location dialog box appears. If the default path shown in the Destination Folder block is acceptable, click Next. (This is recommended.)

Note: If you did not uninstall a previous version of the dependent products, you will be asked if you want to overwrite the software. Click Yes for the software you want to overwrite.

To use a destination location other than the default, click Browse, navigate to the location where you want the files installed, click OK, then click Next. Note: You must have write access to the destination folder, the Windows root folder, and the Windows system folder.

2 In the Select Install Method dialog box, select the products you want to be automatically installed (silent install), or clear the products you want to interactively install:

a Highlight the products to be installed silently.

Note: Shared ICU Libraries for Teradata can only be installed in silent mode from the CD media.

Note: The ODBC Driver for Teradata and Teradata Manager can be installed silently or interactively; the default for ODBC Driver for Teradata is silent; the default for Teradata Manager is silent. Upon completion of the Teradata Tools and Utilities installation in this section, complete these installations as described in the following sections:

“Installing the ODBC Driver for Teradata” on page 72

“Installing the Teradata Manager” on page 70

Teradata Tools and Utilities Installation Guide for Microsoft Windows 65

Page 66: Teradata Tools and Utilities - dbmanagement.infodbmanagement.info/Books/MIX/2407_TeraData.pdf · Teradata Tools and Utilities Installation Guide for Microsoft Windows 7 ... Software

Chapter 3: Installing the Teradata Tools and Utilities SoftwareInstalling Using the Client Main Install

Note: Teradata SQL Assistant/Web Edition can only be installed interactively. Upon completion of the Teradata Tools and Utilities installation in this section, complete these installations as described in the following sections:

“Installing the Teradata SQL Assistant/Web Edition” on page 67

All other products can be installed silently or interactively; the default is silent.

b Those not highlighted will be installed interactively, meaning that the product setup sequence will be activated so you can make adjustments during installation.

c Click Next.

3 An Information window shows the path to the folder containing the product response files for silent installation. If you want to modify a product response file, use a text editor to do so now. When you are finished, click OK in the Information window.

Note: During installation, progress monitors will appear. No action is required.

4 In the Install Wizard Completion screen, click Finish to complete the installation.

Note: The ODBC Driver for Teradata Setup may take several minutes.

Troubleshooting Note: The product setup log is located in the %TEMP%\ ClientISS folder. “Silent Installation Result Codes” on page 156 lists result codes from silent installations that are useful for troubleshooting.

5 After the first phase of the installation is complete, go to the installation procedure for the following products as needed:

• “Installing the ODBC Driver for Teradata” on page 72

• “Installing the Teradata SQL Assistant/Web Edition” on page 67

• “Installing the Teradata MultiTool” on page 69

66 Teradata Tools and Utilities Installation Guide for Microsoft Windows

Page 67: Teradata Tools and Utilities - dbmanagement.infodbmanagement.info/Books/MIX/2407_TeraData.pdf · Teradata Tools and Utilities Installation Guide for Microsoft Windows 7 ... Software

Chapter 3: Installing the Teradata Tools and Utilities SoftwareInstalling Using the Client Main Install

• “Installing the Teradata Manager” on page 70

Installing the Teradata SQL Assistant/Web Edition

Note: The Teradata SQL Assistant/Web Edition software is only installed from the Teradata Utility Pak CD.

This software will be installed in the following folder on the drive where the Microsoft Internet Information Services (IIS) was previously installed:

<Drive where IIS was installed>:\inetpub\wwwroot

Procedure - Installing the SQL Assistant/Web Edition

Follow these steps to install the Teradata SQL Assistant/Web Edition software interactively:

1 In the Welcome to the Teradata SQL Assistant/Web Edition Setup dialog box, click Next.

2 In the License Agreement dialog box, read the agreement, select I accept the terms in the license agreement, then click Next.

3 In the Select Installation Address dialog box, enter the appropriate virtual directory and port number, then click Next.

Virtual Directory Note: Do not enter a root directory in this text box.

The virtual directory is a pointer to the actual root directory. After you install the Teradata SQL Assistant/Web Edition software, the name entered as the virtual directory is the pathname used as a URL in the browser’s address bar when connecting to the Teradata Database.

For more information, refer to the Teradata SQL Assistant/Web Edition User Guide.

Port Note: Typically you would leave the port number at the default of 80.

This port number enables the system administrator to run several Web servers from the same host. For example, you might have a production Web server running on port 80 (the default) and a test Web server running on port 8080.

You can install the Teradata SQL Assistant/Web Edition software on the test Web server before installing it on the production Web server and releasing it to your general user population.

If you use 80 (the default), it is not necessary to include the port number in the URL.

The port number indicates where the Web server listens for connections from Web browsers.

If a user needs to connect to Teradata SQL Assistant/Web Edition on the test Web server, they must include the port number in the URL. For example, they might use http://myhost:8080/SQLAsssistantWeb.

Disk Cost If you click Disk Cost in the Select Installation Address dialog box, an information-only dialog box appears that shows how much disk space you have, how much disk space is available, and how much disk space is required for each available drive.

Teradata Tools and Utilities Installation Guide for Microsoft Windows 67

Page 68: Teradata Tools and Utilities - dbmanagement.infodbmanagement.info/Books/MIX/2407_TeraData.pdf · Teradata Tools and Utilities Installation Guide for Microsoft Windows 7 ... Software

Chapter 3: Installing the Teradata Tools and Utilities SoftwareInstalling Using the Client Main Install

4 In the Confirm Installation dialog box, click Next. 5 You may see the following Information window. Click OK.

6 If the machine.config file could not be modified, you will receive the following warning. Click OK to continue the installation process.

7 In the Installation Complete dialog box, click Close.

8 If the machine.config file was not modified successfully above, refer to “Changing the machine.config File” on page 68 for instructions on how to change it manually.

Changing the machine.config File

The machine.config file is in your operating system folder. It was installed on your computer when you installed the “Installing Microsoft .NET Framework (version 1.1)” on page 54.

When using Teradata SQL Assistant/Web Edition, a query that takes longer to process than the time set in the responseDeadlockInterval attribute of the machine.config file is considered deadlocked and you are disconnected from the Teradata Database with an error message from your browser.

The default for responseDeadlockInterval is 00:03:00 (3 minutes).

The Teradata SQL Assistant/Web Edition installation attempts to access the machine.config file and change responseDeadlockInterval to “Infinite.” If the file modification was not successful above, your system administrator, or someone else who has write privileges to the machine.config file, must complete the following steps to modify this file:

Procedure - Changing the machine.config File

Follow these steps to change the machine.config file.

1 Use Notepad or another text editor to open the machine.config file at:

%SystemRoot%\Microsoft.NET\Framework\V1.0.3705\config

2 Locate the processModel tag shown in the figure below.

68 Teradata Tools and Utilities Installation Guide for Microsoft Windows

Page 69: Teradata Tools and Utilities - dbmanagement.infodbmanagement.info/Books/MIX/2407_TeraData.pdf · Teradata Tools and Utilities Installation Guide for Microsoft Windows 7 ... Software

Chapter 3: Installing the Teradata Tools and Utilities SoftwareInstalling Using the Client Main Install

3 At responseDeadlockInterval, change the number in quotes to “Infinite.” (This is case sensitive so make sure you enter “Infinite” with a capital I.)

4 Save and close the machine.config file.

Installing the Teradata MultiTool

Note: When installing Teradata MultiTool:

• The Teradata MultiTool software is only installed from the Teradata Utility Pak.

• If you are installing Teradata MultiTool and you do not have the Java 2 Runtime Environment, install it when prompted to do so.

• Teradata MultiTool cannot be installed if Teradata Database is already installed. Teradata Database setup installs Teradata MultiTool.

To install the Teradata MultiTool software, your computer must run on the Windows 2000 or 32-bit Windows XP operating system. You cannot install it on a computer running on any other Windows operating system.

Procedure - Installing the Teradata MultiTool

Follow these steps to install the Teradata MultiTool:

1 Before you install Teradata MultiTool, you must download and install Java Runtime Environment (JRE) version 1.4 from the following website: http://java.sun.com/products/archive/j2se/1.4.0/index.html

2 In the Welcome to the InstallShield Wizard for Teradata MultiTool dialog box, click Next.

Teradata Tools and Utilities Installation Guide for Microsoft Windows 69

Page 70: Teradata Tools and Utilities - dbmanagement.infodbmanagement.info/Books/MIX/2407_TeraData.pdf · Teradata Tools and Utilities Installation Guide for Microsoft Windows 7 ... Software

Chapter 3: Installing the Teradata Tools and Utilities SoftwareInstalling Using the Client Main Install

3 In the License Agreement dialog box, read the agreement, select I accept the terms in the license agreement, then click Next.

4 In the Customer Information dialog box, enter the appropriate information, then click Next.5 In the Setup Type dialog box, select Complete, then click Next.6 In the Ready to Install the Program dialog box, click Install.7 In the InstallShield Wizard Completed dialog box, click Finish.

Installing the Teradata Manager

The Teradata Manager software can only be installed from the Database Management CD.

Procedure - Installing Teradata Manager

Follow these steps to install the Teradata Manager:

1 In the Teradata Manager Setup Welcome dialog box, click Next.2 In the Software License Agreement dialog box, read the agreement, then click Yes to accept

it.

3 In the Choose Destination Location dialog box, if the default path shown in the Destination Folder block is acceptable, click Next. (This is recommended.)

To use a destination location other than the default, click Browse, navigate to the location where you want the files installed, click OK, then click Next. Note: You must have write access to the destination folder, the Windows root folder, and the Windows system folder.

4 In the Setup Type dialog box, highlight the desired option, then click Next.5 In the Select Program Folder dialog box, perform one of the following, then click Next:

• Accept the default program folder

• Enter a new folder name into the Program Folders text block

• Select one of the names in the list of existing folders

6 In the Start Copying Files dialog box, check the settings, then click Next to begin copying the files.

7 You may see a Question message box with text similar to the following:

Setup has found application settings from a previous release of Teradata Manager. Would you like to be able to use these settings?

To use the settings from a previous version, click Yes. You may need to update them to use new features.

If you do not want to use them, click No.

8 You will see one of two InstallShield Wizard Complete dialog boxes:

• If the Teradata Manager installation requires a restart, there will be no options in the dialog box, just click Finish.

• If no restart is required, you may view online Help or begin the Teradata Database setup program. Select the desired option, then click Finish.

70 Teradata Tools and Utilities Installation Guide for Microsoft Windows

Page 71: Teradata Tools and Utilities - dbmanagement.infodbmanagement.info/Books/MIX/2407_TeraData.pdf · Teradata Tools and Utilities Installation Guide for Microsoft Windows 7 ... Software

Chapter 3: Installing the Teradata Tools and Utilities SoftwareInstalling Using the Client Main Install

If this is a new installation or this version of Teradata Manager has not been run before, you must perform the Teradata Database setup program to establish the appropriate database privileges to run certain applications.

Note: If it is necessary to run the Teradata Database setup program, you can do so now or after completing installation. Refer to the Teradata Manager User Guide, or the online Teradata Manager Help for more information.

Note: After the dbcmngr database is upgraded, only users of the newly installed version of Teradata Manager will be able to successfully execute all Teradata Manager applications. (The Teradata Database, Teradata Manager server, and Teradata Manager clients must have the same version of the dbcmngr database for certain applications, such as monitoring and alerting applications, to work correctly.)

The installation process continues, completing all silent installations.

Completing the Installation

Which Setup Complete dialog box appears next depends on whether the computer should be restarted.

Procedure - Completing the Installation

Follow these steps to complete the installation:

1 If the computer does not require a restart, choose whether or not to view the Release Definition, then click Finish.

2 If the computer does require a restart, you have two options:

• Yes, I want to restart my computer now. • No, I will restart my computer later. We recommend that you select Yes, I want to restart my computer now, remove the CD from the drive, then click Finish.

Troubleshooting Silent Installations

For help in troubleshooting problems during silent installation, refer to “Silent Installation Result Codes” on page 156.

Configuring the Products

Go to the following sections to configure the installed products:

• “Configuring Teradata Administrator” on page 87

• “Configuring the ODBC Driver, Teradata Query Scheduler, and Teradata Manager” on page 88

• “Configuring Teradata Call-Level Interface version 2 (CLIv2) for Windows” on page 89

• “Configuring Teradata Parallel Transporter” on page 94

Teradata Tools and Utilities Installation Guide for Microsoft Windows 71

Page 72: Teradata Tools and Utilities - dbmanagement.infodbmanagement.info/Books/MIX/2407_TeraData.pdf · Teradata Tools and Utilities Installation Guide for Microsoft Windows 7 ... Software

Chapter 3: Installing the Teradata Tools and Utilities SoftwareInstalling Using the Client Main Install

Installing the ODBC Driver for Teradata

If an earlier version of the ODBC Driver for Teradata is installed on your system, uninstall it using Add/Remove Programs. You must be a member of the Windows Administrators group of the computer on which you are uninstalling the software.

The installation of an ODBC driver will terminate if an older driver is being installed on a system that has a newer ODBC driver installed.

When installing the ODBC Driver for Teradata product on a Windows XP 64-bit system, the install process hangs if all of the following conditions exist:

• The ODBC Driver for Teradata product is already on the system.

• You elect to do a custom install.

• You elect to install the product in silent mode, that is, you select “ODBC_Driver_For_Teradata” in the Select Install Methods dialog.

To prevent the install process from hanging, you must first uninstall all previous versions of the ODBC Driver for Teradata.

The Installation of the ODBC 12.00.00.00 release on a system that already has an ODBC Driver Installed will exhibit a different behavior than when the ODBC Driver for Teradata is installed on a system that has no ODBC Driver for Teradata installed.

In this case, only two dialog boxes are displayed, Resuming the InstallShield Wizard for ODBC Driver for Teradata, and the Installation Wizard Complete dialog boxes.

• When an installation is executed on a system that already has an ODBC Driver installed, Resuming the InstallShield Wizard for ODBC Driver for Teradata appears.

Click Next.• Installation Wizard Complete dialog box appears.

Click Finish.

Note: ODBC 12.00.00.00 is not supported on Microsoft Windows 95, Windows 98, or Windows NT. If you attempt to install ODBC 12.00.00.00 on one of these operating systems, the InstallShield program will detect the operating system and generate an error message indicating the incompatibility, then abort the installation.

Except on 64-bit systems, whenever ODBC is installed, version 2.8 of the Microsoft Data Access Components (MDAC) will also be installed. If MDAC is already installed on your computer and you do not want it upgraded to version 2.8, clear the MDAC check box in the Select Components dialog box. You must install MDAC version 2.8 if you will be using Teradata SQL Assistant/Web Edition.

Note: MDAC is not installed with 64-bit ODBC since it is installed as part of the operating system.

Note: To ensure the highest quality and best performance of the ODBC Driver for Teradata, the most recent critical post-production updates can be downloaded from the Teradata Software Server at:

http://tssprod.ncr.com:8080/TSFS/home.do

72 Teradata Tools and Utilities Installation Guide for Microsoft Windows

Page 73: Teradata Tools and Utilities - dbmanagement.infodbmanagement.info/Books/MIX/2407_TeraData.pdf · Teradata Tools and Utilities Installation Guide for Microsoft Windows 7 ... Software

Chapter 3: Installing the Teradata Tools and Utilities SoftwareInstalling Using the Client Main Install

Procedure - Installing from the Teradata Software Server

Follow these steps to install the ODBC Driver for Teradata from the Teradata Software Server:

1 In the Welcome to the InstallShield Wizard for ODBC Driver for Teradata dialog box, click Next. Note: If you are installing ODBC Driver for Teradata in interactive mode on a computer that runs on the Windows 2000 or Windows XP operating system and you don’t see the Welcome dialog box, press the Alt-Tab keys and bring the dialog box to the foreground. This does not apply to silent installation of this software.

2 In the Choose Destination Location dialog box, if the default path shown in the Destination Folder block is acceptable, click Next. (This is recommended.)

To use a destination location other than the default, click Browse, navigate to the location where you want the files installed, click OK, then click Next. Note: You must have write access to the destination folder, the Windows root folder, and the Windows system folder.

3 In the Setup Type dialog box, click the name of the desired installation setup, then click Next:• Custom is for advanced users who want to choose the options to install.

• Typical is recommended for most users. All ODBC driver programs will be installed.

Note: If you choose Typical, the ODBC installation will also install version 2.8 of the Microsoft Data Access Components (MDAC). If MDAC is already installed on your computer and you do not want it upgraded to version 2.8, select Custom, then clear the MDAC check box in the Select Components dialog box as shown in the following figure.

If you are installing Teradata MultiTool and you do not have the Java 2 Runtime Environment, install it when prompted to do so.

Note: MDAC version 2.8 must be installed Teradata SQL Assistant/Web Edition will be used.

Teradata Tools and Utilities Installation Guide for Microsoft Windows 73

Page 74: Teradata Tools and Utilities - dbmanagement.infodbmanagement.info/Books/MIX/2407_TeraData.pdf · Teradata Tools and Utilities Installation Guide for Microsoft Windows 7 ... Software

Chapter 3: Installing the Teradata Tools and Utilities SoftwareInstalling Using the Client Main Install

4 In the Select Program Folder dialog box, do one of the following, then click Next:• Accept the default program folder

• Enter a new folder name into the Program Folders text block

• Select one of the names in the list of existing folders

5 In the Start Copying Files dialog box, review the information. When you are satisfied that it is correct, click Next. The driver installation begins. During installation, progress monitors will appear. No action is required.

6 Upon completion of the driver installation, the InstallShield Wizard Complete dialog box appears. Choose to view the Read Me file, run the ODBC Administrator immediately, or do neither, then click Finish.

Note: Configuration Note: You must use the ODBC Administrator to configure the driver. Therefore, if you do not run the ODBC Administrator now, you must do so after completing the Teradata Tools and Utilities installation.

Refer to the configuration section of the ODBC Driver for Teradata User Guide.

Custom Installation

A custom installation installs only those products selected from the list of available products.

The screens shown in this section are examples of screens that appear during a Custom Installation. Depending on the Teradata Tools and Utilities products used in your installation, some dialog boxes and screens might vary from those shown in this guide.

74 Teradata Tools and Utilities Installation Guide for Microsoft Windows

Page 75: Teradata Tools and Utilities - dbmanagement.infodbmanagement.info/Books/MIX/2407_TeraData.pdf · Teradata Tools and Utilities Installation Guide for Microsoft Windows 7 ... Software

Chapter 3: Installing the Teradata Tools and Utilities SoftwareInstalling Using the Client Main Install

Procedure - Performing a Custom Installation

Follow these steps to perform a custom installation of Teradata Tools and Utilities. Only those products selected will be installed.

1 After highlighting Custom and clicking Next in the initial Setup Type dialog box, the Select Components dialog box appears. Do the following:

a Select the check boxes for the products you want to install.

b Clear the check boxes for the products you do not want to install.

c Click Next. Note: If the product you select is dependent on other products, those will be selected also.

Table 1 on page 22 shows which Windows platforms are supported by each product. If you have questions about the interdependence of products, refer to “Software Requirements” on page 28.

2 In the Choose Destination Location dialog box, if the default path shown in the Destination Folder block is acceptable, click Next. (This is recommended.)

To use a destination location other than the default, click Browse, navigate to the location where you want the files installed, click OK, then click Next. Note: You must have write access to the destination folder, the Windows root folder, and the Windows system folder.

Teradata Tools and Utilities Installation Guide for Microsoft Windows 75

Page 76: Teradata Tools and Utilities - dbmanagement.infodbmanagement.info/Books/MIX/2407_TeraData.pdf · Teradata Tools and Utilities Installation Guide for Microsoft Windows 7 ... Software

Chapter 3: Installing the Teradata Tools and Utilities SoftwareInstalling Using the Client Main Install

3 In the Select Install Method dialog box, select automatic (silent) or interactive installation for each product.

a Highlight the products to be installed silently.

• Shared ICU Libraries for Teradata can only be installed in the silent mode from the CD media.

• The ODBC Driver for Teradata and Teradata Manager can be installed silently or interactively (the default is silent.) Upon completion of the Teradata Tools and Utilities installation in this section, complete these installations as described in the following sections:

• “Installing the ODBC Driver for Teradata” on page 72

• “Installing the Teradata Manager” on page 70

Teradata SQL Assistant/Web Edition, and Teradata Access Module for Tivoli can only be installed interactively. Upon completion of the Teradata Tools and Utilities installation in this section, complete these installations as described in the following sections:

• “Installing the Teradata SQL Assistant/Web Edition” on page 67

All other products can be installed silently or interactively; the default is silent.

b The products not highlighted will be installed interactively, meaning that the product setup sequence will be activated so you can make adjustments during installation.

c Click Next.

76 Teradata Tools and Utilities Installation Guide for Microsoft Windows

Page 77: Teradata Tools and Utilities - dbmanagement.infodbmanagement.info/Books/MIX/2407_TeraData.pdf · Teradata Tools and Utilities Installation Guide for Microsoft Windows 7 ... Software

Chapter 3: Installing the Teradata Tools and Utilities SoftwareInstalling Using the Client Main Install

4 An Information window shows the path to the folder containing the product response files for silent installation. If you want to modify a product response file, use a text editor to do so now. When you are finished, click OK in the Information window.

Installation Notes:

• During installation, progress monitors will appear. No action is required.

• For silent installations, messages such as “Installing BTEQ. Please wait...” will appear. No action is required.

• The Teradata ODBC Driver Setup may take several minutes.

Troubleshooting Notes:

• The product setup log is located in the %TEMP%\ ClientISS folder.

• “Silent Installation Result Codes” on page 156 lists result codes from silent installations that are useful for troubleshooting.

5 If you selected other products to install interactively, those setup programs will execute. Follow the instructions in each dialog box that appears. If you need more help during installation, refer to “Additional Information” on page 4 for a list of product documents.

6 After the first phase of the installation is complete, go to the installation procedure for the following products as needed:

• “Installing the ODBC Driver for Teradata” on page 72

• “Installing the Teradata SQL Assistant/Web Edition” on page 67

• “Installing the Teradata MultiTool” on page 69

7 Which Setup Complete dialog box appears next depends on whether the computer should be restarted:

a If the computer does not require a restart, choose whether or not to view the Release Definition, then click Finish.

Teradata Tools and Utilities Installation Guide for Microsoft Windows 77

Page 78: Teradata Tools and Utilities - dbmanagement.infodbmanagement.info/Books/MIX/2407_TeraData.pdf · Teradata Tools and Utilities Installation Guide for Microsoft Windows 7 ... Software

Chapter 3: Installing the Teradata Tools and Utilities SoftwareInstalling Using the Client Main Install

b If the computer does require a restart, you have two options:

• Yes, I want to restart my computer now. • No, I will restart my computer later.

We recommend that you select Yes, I want to restart my computer now, remove the CD from the drive, then click Finish.

Troubleshooting Silent Installations

For help in troubleshooting problems during silent installation, refer to “Silent Installation Result Codes” on page 156.

Configuring the Products

Go to the following sections to configure the installed products:

• “Configuring Teradata Administrator” on page 87

• “Configuring the ODBC Driver, Teradata Query Scheduler, and Teradata Manager” on page 88

• “Configuring Teradata Call-Level Interface version 2 (CLIv2) for Windows” on page 89

• “Configuring Teradata Parallel Transporter” on page 94

Network Installation

A network installation copies the setup files for the selected products to a specified folder. The network installation does not actually install the products. This must be done by the user.

The screens shown in this section are examples of screens that appear during a Network Installation. Depending on the Teradata Tools and Utilities products used in your installation, some dialog boxes and screens might vary from those shown in this guide.

Procedure - Performing a Network Installation

Follow these steps to perform a network installation of Teradata Tools and Utilities. This installation only copies the setup files of the selected products to a specified folder.

1 After highlighting Network and clicking Next in the initial Setup Type dialog box, the Select Components dialog box appears. Do the following:

a Select the boxes for the products whose setup files you want to copy.

b Clear the boxes for the products you do not want to copy.

c Click Next. Table 1 on page 22 shows which Windows platforms are supported by each product. If you have questions about interdependence of products, refer to “Software Requirements” on page 28.

78 Teradata Tools and Utilities Installation Guide for Microsoft Windows

Page 79: Teradata Tools and Utilities - dbmanagement.infodbmanagement.info/Books/MIX/2407_TeraData.pdf · Teradata Tools and Utilities Installation Guide for Microsoft Windows 7 ... Software

Chapter 3: Installing the Teradata Tools and Utilities SoftwareInstalling Using the Client Main Install

2 In the Choose Destination Location dialog box, if the default path shown in the Destination Folder block is acceptable, click Next. (This is recommended.)

To use a destination location other than the default, click Browse, navigate to the location where you want the files installed, click, then click Next. Note: You must have write access to the destination folder, the Windows root folder, and the Windows system folder.

3 As files are copied, progress monitors will appear. No action is required.

Teradata Tools and Utilities Installation Guide for Microsoft Windows 79

Page 80: Teradata Tools and Utilities - dbmanagement.infodbmanagement.info/Books/MIX/2407_TeraData.pdf · Teradata Tools and Utilities Installation Guide for Microsoft Windows 7 ... Software

Chapter 3: Installing the Teradata Tools and Utilities SoftwareInstalling a Package from the Command Prompt

4 After the installation process copies the necessary files to the specified folder, the Setup Complete dialog box appears. Choose whether or not to view the Release Definition, then click Finish.

Installing the Products

After you have copied the product setup files to the desired folder, you can install the product from that location without a license file.

Configuring the Products

Go to the following sections to configure the installed products:

• “Configuring Teradata Administrator” on page 87

• “Configuring the ODBC Driver, Teradata Query Scheduler, and Teradata Manager” on page 88

• “Configuring Teradata Call-Level Interface version 2 (CLIv2) for Windows” on page 89

• “Configuring Teradata Parallel Transporter” on page 94

Installing a Package from the Command Prompt

This section documents the commands needed to install Windows packages silently from the command prompt. Packages can be downloaded from a patch server or copied using a Network Setup Type, then copied to the target machine.

A Package Folder sample installation is included.

Sample Package Folder Installation

This procedure installs the Teradata Performance Monitor using a package folder and a response file. The procedure installs the Teradata Performance Monitor silently.

Procedure - Installing Teradata Performance Monitor

Follow these steps to install Teradata Performance Monitor.

1 Exit all applications, including Microsoft Office and disable any virus protection software running on the system.

2 Copy the response file “Teradata_Performance_Monitor.iss” to your directory. For example:

Table 23: setup.exe

Product Setup File Name Location

All products setup.exe <folder name>\<product name>

80 Teradata Tools and Utilities Installation Guide for Microsoft Windows

Page 81: Teradata Tools and Utilities - dbmanagement.infodbmanagement.info/Books/MIX/2407_TeraData.pdf · Teradata Tools and Utilities Installation Guide for Microsoft Windows 7 ... Software

Chapter 3: Installing the Teradata Tools and Utilities SoftwareInstalling a Package from the Command Prompt

C:\PACKAGE

Note: setup.exe must be in C:\PACKAGE, not C:\PACKAGE\DISK1.

3 Make any changes you need in the response file.

4 Copy the Package folder to your directory on your system. For example:

C:\PACKAGE

5 In the command prompt, change directory to:

C:\PACKAGE

6 At the command prompt, type the command:

setup.exe /s /f1"C:\PACKAGE\Teradata_Performance_Monitor.iss"

where C:\PACKAGE\Teradata_Performance_Monitor.iss is an example of how to specify the pathname of the response file.

Installation Commands

To silently install a Teradata Tools and Utilities product from the command prompt, first check Table 25 to determine whether the package has a response file. If it doesn’t have a response file, execute the command shown in the table in the directory where the products package file is located.

If it does, first copy the products package file and it’s response file to a temporary directory, and make the directory the current directory. Then execute the command for the product as shown in Table 25.

The following table includes the setup commands to perform a silent installation of Teradata Tools and Utilities products.

A typical command is:

setup.exe /s /f1<response file> /f2<setup log file>

where:

The values passed to f1 and f2 must be enclosed in double quotes. Other parameters can also be passed.

For example:

setup.exe /s /f1"C:\temp\setup.iss"

Table 24: setup.exe command parameters

Parameters... Description...

<response file> This is the full pathname of the response file input to setup.exe.

<setup log file> This is the full pathname of the log file output by setup.exe.

f1 parameter This is an optional parameter if the response file is in the current directory and the file is named setup.iss.

f2 parameter This is optional parameter. If it is not provided the log file will be created in the current directory as setup.log.

Teradata Tools and Utilities Installation Guide for Microsoft Windows 81

Page 82: Teradata Tools and Utilities - dbmanagement.infodbmanagement.info/Books/MIX/2407_TeraData.pdf · Teradata Tools and Utilities Installation Guide for Microsoft Windows 7 ... Software

Chapter 3: Installing the Teradata Tools and Utilities SoftwareInstalling a Package from the Command Prompt

Note: There is no white space between the f1 switch and the pathname of the response file.

Table 25: Command Prompt Installation Command

Product... Commands...

Basic Teradata Query (BTEQ) At the command prompt, type the command:

setup.exe /s /f1"<response file>" /f2"<setup log file>"

ODBC Driver for Teradata At the command prompt, type the command:

setup.exe /s /f1"<response file>" /f2"<setup log file>"

To change the destination where the ODBC Driver for Teradata is loaded, change “szDir” in the ODBC_Driver_for_Teradata.iss file.

Shared ICU Libraries for Teradata At the command prompt, type the command:

setup.exe /s /f1"<response file>" /f2"<setup log file>" /w

Note: Shared ICU Libraries for Teradata can only be installed in the silent mode.

Teradata Access Module for JMS At the command prompt, type the command:

setup.exe /s /f1"<response file>" /f2"<setup log file>"

Teradata Access Module for Tivoli At the command prompt, type the command:

setup.exe /s /f1"<response file>" /f2"<setup log file>" /w

Teradata Administrator At the command prompt, type the command:

setup.exe /s /v"/qn"

Teradata Archive and Recovery (ARC)

At the command prompt, type the command:

setup.exe /s /f1"<response file>" /f2"<setup log file>"

Teradata C Preprocessor2 At the command prompt, type the command:

setup.exe /s /f1"<response file>" /f2"<setup log file>"

Teradata Call Level Interface version 2 (CLIv2)

At the command prompt, type the command:

setup.exe /s /f1"<response file>" /f2"<setup log file>"

Teradata Data Connector At the command prompt, type the command:

setup.exe /s /f1"<response file>" /f2"<setup log file>" /w

Teradata Dynamic Workload Manager

At the command prompt, type the command:

setup.exe /s /f1"<response file>" /f2"<setup log file>" /w

Teradata FastExport At the command prompt, type the command:

setup.exe /s /f1"<response file>" /f2"<setup log file>" /w

Teradata FastLoad At the command prompt, type the command:

setup.exe /s /f1"<response file>" /f2"<setup log file>" /w

Teradata Generic Security Services

At the command prompt, type the command:

Setup.exe /s /v"/qn"

Teradata Index Wizard At the command prompt, type the command:

setup.exe /s /f1"<response file>" /f2"<setup log file>"

82 Teradata Tools and Utilities Installation Guide for Microsoft Windows

Page 83: Teradata Tools and Utilities - dbmanagement.infodbmanagement.info/Books/MIX/2407_TeraData.pdf · Teradata Tools and Utilities Installation Guide for Microsoft Windows 7 ... Software

Chapter 3: Installing the Teradata Tools and Utilities SoftwareInstalling a Package from the Command Prompt

Teradata Manager At the command prompt, type the command:

setup.exe /s /f1"<response file>" /f2"<setup log file>"

Note: The default setup type is Client. For Server setup enter:

edit TMgr.iss

then find the line:

Result=ClientSetupType

and change it to:

Result=ServerSetupType

Teradata MultiLoad At the command prompt, type the command:

Setup.exe /s /v"/qn"

Teradata Named Pipes Access Module

At the command prompt, type the command:

setup.exe /s /f1"<response file>" /f2"<setup log file>" /w

Teradata OLE DB Access Module At the command prompt, type the command:

setup.exe /s /f1"<response file>" /f2"<setup log file>"

• Teradata Parallel Transporter ICU Library

At the command prompt, type the command:

setup.exe /s /f1"<response file>" /f2"<setup log file>"

Teradata Performance Monitor At the command prompt, type the command:

setup.exe /s /f1"<response file>" /f2"<setup log file>"

Teradata Query Director At the command prompt, type the command:

setup.exe /s /f1"<response file>" /f2"<setup log file>"

Teradata Query Scheduler Administrator

At the command prompt, type the command:

setup.exe /s /f1"<response file>" /f2"<setup log file>"

Teradata Query Scheduler Client At the command prompt, type the command:

setup.exe /s /f1"<response file>" /f2"<setup log file>"

Teradata Query Scheduler Server At the command prompt, type the command:

setup.exe /s /f1"<response file>" /f2"<setup log file>"

Teradata SQL Assistant At the command prompt, type the command:

Setup.exe /s /v"/qn"

without test database:

Setup.exe /s /v"/qn TESTDBSSELECTED=0"

Teradata SQL Assistant/Web Edition

At the command prompt, type the command:

Setup.exe /s /v"/qn"

Teradata Statistics Wizard At the command prompt, type the command:

setup.exe /s /f1"<response file>" /f2"<setup log file>"

Table 25: Command Prompt Installation Command (continued)

Product... Commands...

Teradata Tools and Utilities Installation Guide for Microsoft Windows 83

Page 84: Teradata Tools and Utilities - dbmanagement.infodbmanagement.info/Books/MIX/2407_TeraData.pdf · Teradata Tools and Utilities Installation Guide for Microsoft Windows 7 ... Software

Chapter 3: Installing the Teradata Tools and Utilities SoftwareInstalling the Teradata Driver for the JDBC Interface

Configuring the Products

Go to the following sections to configure the installed products:

• “Configuring Teradata Administrator” on page 87

• “Configuring the ODBC Driver, Teradata Query Scheduler, and Teradata Manager” on page 88

• “Configuring Teradata Call-Level Interface version 2 (CLIv2) for Windows” on page 89

• “Configuring Teradata Parallel Transporter” on page 94

Installing the Teradata Driver for the JDBC Interface

The Teradata Driver for the JDBC Interface must be downloaded from the Teradata Download Center at:

http://www.teradata.com --> Support Services --> Downloads--> Drivers, UDFs, and Toolbox --> Drivers and Connectivity Software

The files can be copied into a directory of your choice and are machine independent.

For configuration instructions go to “Importing the SQL Package and Loading the Teradata Driver for the JDBC Interface” in chapter 2 of the Teradata Driver for the JDBC Interface User Guide.

Teradata System Emulation Tool At the command prompt, type the command:

setup.exe /s /f1"<response file>" /f2"<setup log file>"

Teradata TPump At the command prompt, type the command:

setup.exe /s /f1"<response file>" /f2"<setup log file>" /w

Teradata Visual Explain At the command prompt, type the command:

setup.exe /s /f1"<response file>" /f2"<setup log file>"

Teradata Workload Analyzer At the command prompt, type the command:

setup.exe /s /f1"<response file>" /f2"<setup log file>"

Websphere Access Module for Teradata

At the command prompt, type the command:

setup.exe /s /f1"<response file>" /f2"<setup log file>" /w

Websphere MQ Access Module At the command prompt, type the command:

setup.exe /s /f1"<response file>" /f2"<setup log file>" /w

Web Tools At the command prompt, type the command:

setup.exe /s /v"/qn"

Table 25: Command Prompt Installation Command (continued)

Product... Commands...

84 Teradata Tools and Utilities Installation Guide for Microsoft Windows

Page 85: Teradata Tools and Utilities - dbmanagement.infodbmanagement.info/Books/MIX/2407_TeraData.pdf · Teradata Tools and Utilities Installation Guide for Microsoft Windows 7 ... Software

Chapter 3: Installing the Teradata Tools and Utilities SoftwareInstalling the OLE DB Provider for Teradata from the Download Center

Note: It is recommended, but not required, that any previous release of the Teradata Driver for the JDBC Interface be uninstalled prior to downloading and using this release of the Teradata Driver for the JDBC Interface.

Installing the OLE DB Provider for Teradata from the Download Center

The OLE DB Provider for Teradata must be downloaded from the Teradata Download Center at:

http://www.teradata.com --> Support Services --> Downloads--> Drivers, UDFs, and Toolbox --> Drivers and Connectivity Software

See the OLE DB Provider for Teradata Installation and User Guide for information and procedures for installing the OLE DB Provider and its dependent products from the Download Center.

Teradata Tools and Utilities Installation Guide for Microsoft Windows 85

Page 86: Teradata Tools and Utilities - dbmanagement.infodbmanagement.info/Books/MIX/2407_TeraData.pdf · Teradata Tools and Utilities Installation Guide for Microsoft Windows 7 ... Software

Chapter 3: Installing the Teradata Tools and Utilities SoftwareInstalling the OLE DB Provider for Teradata from the Download Center

86 Teradata Tools and Utilities Installation Guide for Microsoft Windows

Page 87: Teradata Tools and Utilities - dbmanagement.infodbmanagement.info/Books/MIX/2407_TeraData.pdf · Teradata Tools and Utilities Installation Guide for Microsoft Windows 7 ... Software

CHAPTER 4

Configuring the Teradata Tools andUtilities Software

This chapter describes how to configure the Teradata Tools and Utilities software.

• Configuring Teradata Administrator

• Configuring the ODBC Driver, Teradata Query Scheduler, and Teradata Manager

• Configuring Teradata Call-Level Interface version 2 (CLIv2) for Windows

• Configuring Teradata Parallel Transporter

Configuring Teradata Administrator

After installation, the Teradata Administrator should be configured to include the Teradata user name.

Procedure - Configuring the Teradata Administrator

Follow these steps to configure the Teradata Administrator.

1 Go to <Boot Drive>:\Program Files\NCR\Teradata Administrator 12.0\ sql

2 Open setup.sql

3 Use the Edit/Replace menu to change all occurrences of the string <User> to the Teradata user name.

4 Execute the query.

Teradata Tools and Utilities Installation Guide for Microsoft Windows 87

Page 88: Teradata Tools and Utilities - dbmanagement.infodbmanagement.info/Books/MIX/2407_TeraData.pdf · Teradata Tools and Utilities Installation Guide for Microsoft Windows 7 ... Software

Chapter 4: Configuring the Teradata Tools and Utilities SoftwareConfiguring the ODBC Driver, Teradata Query Scheduler, and Teradata Manager

Configuring the ODBC Driver, Teradata Query Scheduler, and Teradata Manager

After installation, configure those of the following products that you have installed:

Table 26: Configuring ODBC, Teradata Query Scheduler and Teradata Manager

To configure... Do the following...

ODBC Driver for Teradata If you have not already done so, use the ODBC Administrator to configure the driver.

For more information, refer to the:

ODBC Driver for Teradata User Guide

Teradata Query Scheduler Administrator

To use the Teradata Query Scheduler Administrator, you must first configure a Teradata Director Program ID (TDPID) name for accessing the desired Teradata Database.

For more information, refer to:

Teradata Query Scheduler Administrator Guide

Teradata Query Scheduler Client

For information on configuring the Teradata Query Scheduler Client refer to the:

Teradata Query Scheduler User Guide

Teradata Query Scheduler Server

To start the Teradata Query Scheduler Server, you must first configure a Teradata Director Program ID (TDPID) name.

For more information, refer to:

Teradata Query Scheduler User Guide

Teradata Manager If you have not already done so, and this is a new or upgraded Teradata Manager installation, use the Teradata Database setup program to create a Teradata Database user with appropriate database privileges to run the Teradata Manager applications. Also, configure the Teradata Manager Service according to “Defining System Parameters.”

For more information, refer to the:

Teradata Manager User Guide

or

to the online Teradata Manager Help

88 Teradata Tools and Utilities Installation Guide for Microsoft Windows

Page 89: Teradata Tools and Utilities - dbmanagement.infodbmanagement.info/Books/MIX/2407_TeraData.pdf · Teradata Tools and Utilities Installation Guide for Microsoft Windows 7 ... Software

Chapter 4: Configuring the Teradata Tools and Utilities SoftwareConfiguring Teradata Call-Level Interface version 2 (CLIv2) for Windows

Configuring Teradata Call-Level Interface version 2 (CLIv2) for Windows

The following sections outline the steps required for setting the Teradata Call-Level Interface version 2 for Windows network, environment, and system parameters:

• Setting the correct network parameters will guarantee that the Teradata Call-Level Interface version 2 for Windows will communicate with your target Teradata Database. These parameters must be set correctly to use the software.

• The environment parameters provide the Teradata Call-Level Interface version 2 for Windows with parameter file location information, as well as the facility for enabling CLIv2 to run in parallel mode. Setting the environment parameters is highly recommended.

• The CLIv2 system parameters are used internally by the Call-Level Interface to customize services and features. Setting system parameters is necessary only if you have special requirements that the default setting cannot meet.

Setting Network Parameters

The Internet address and the symbolic names for the Teradata Database are considered the network parameters. This section assumes that your network software is installed correctly.

hosts File

If you are not running a Name Server, the hosts file contains a list of all systems on the LAN that you can access. The Teradata Database must be identified in this file if a system is going to communicate with it. A hosts file exists on each individual computer system in your network.

If you are running a Name Server, make sure the hosts file is on the Name Server and that your network software is configured to access the Name Server. The Teradata Tools and Utilities software uses generic TCP/IP GetHostByName services.

The hosts file is in the <Boot Drive>:\Program Files\NCR\Teradata Parallel Transporter folder.

Identifying a Teradata Database

To identify the Teradata Database, add an entry to the hosts file for each TCP/IP Communications Processor (COP), Applications Processor (AP), or UNIX node running the Teradata Gateway that your computer will be communicating with.

Table 27: Adding an Entry to the hosts File

To communicate with a... Add entries corresponding to the...

Teradata Database on an AP platform (System 3600) APs

Teradata Database on a V2 Computer (UNIX) nodes

Teradata Tools and Utilities Installation Guide for Microsoft Windows 89

Page 90: Teradata Tools and Utilities - dbmanagement.infodbmanagement.info/Books/MIX/2407_TeraData.pdf · Teradata Tools and Utilities Installation Guide for Microsoft Windows 7 ... Software

Chapter 4: Configuring the Teradata Tools and Utilities SoftwareConfiguring Teradata Call-Level Interface version 2 (CLIv2) for Windows

Note: Throughout this manual, “AP” refers to the following: TCP/IP Communications Processor (COP), Applications Processor (AP), and the node running the Teradata Gateway.

Syntax

Use the following syntax when adding entries to the hosts file:

<a.b.c.d > <dbcnameCOPn> [aliasCOPn]

where:

Table 28: hosts File Syntax

Parameter... is...

a.b.c.d the Internet address. It is a four-byte numeric value that identifies an “AP” and its location on the network. An Internet address is assigned to each “AP” when the Teradata Database is configured.

dbcname the Teradata Database using the “AP.” It is 1 to 8 characters in length. The first character must be alphabetic; the remaining characters can be alphanumeric.

The System Parameter Block file, <Boot Drive>:\Program Files\ NCR\Teradata Client\clispb.dat, lists dbc as the default dbcname. You can assign dbc as the dbcname of a Teradata Database with which your computer communicates. This simplifies network debugging and avoids problems when name servers become available.

If your computer communicates with more than one Teradata Database on the same TCP/IP LAN, you should use dbc as the dbcname for the more heavily used Teradata Database. Any other name(s) can be used for the remaining Teradata Database(s).

COPn the parameter that assigns a number to a particular “AP” that the Teradata Database uses. COP is a fixed string of characters that you must always specify. The value of n can range from 1 to the total number of “APs” in a COP group.

A COP group is a set of “APs” that will operate together for a particular Teradata Database. “APs” in the same COP group share session balancing and session recovery. Each “AP” within a COP group must be assigned a unique number starting with 1.

aliasCOPn the aliasname, specifying an alternate name for a Teradata Database “AP”. Its use is optional. More than one aliasname is permitted. An aliasname need not be unique across a network, but the hosts file for a computer must not contain the same aliasname for more than one “AP”. Suggestion: the n in each aliasCOPn equal n in the corresponding dbcnameCOPn.

90 Teradata Tools and Utilities Installation Guide for Microsoft Windows

Page 91: Teradata Tools and Utilities - dbmanagement.infodbmanagement.info/Books/MIX/2407_TeraData.pdf · Teradata Tools and Utilities Installation Guide for Microsoft Windows 7 ... Software

Chapter 4: Configuring the Teradata Tools and Utilities SoftwareConfiguring Teradata Call-Level Interface version 2 (CLIv2) for Windows

Example

A computer accesses one Teradata Database (named dbc) through two TCP/IP APs with addresses 101.0.0.21 and 101.0.0.22 on the same logical TCP/IP LAN. Each AP is assigned two alias names.

In this case, add these lines to the hosts file:

101.0.0.21 dbcnode1 dbccop1 ncrcop1101.0.0.22 dbcnode2 dbccop2 ncrcop2

Setting Environment Parameters

The environment parameters allow you to specify the runtime environment for each user who will be using the Teradata Tools and Utilities software.

On Windows systems, if system environment parameters are changed, the computer must be rebooted for the changes to take effect. It is not enough to restart your daemon, nor logoff and log on again.

Defining Paths to System Files

You can define the path to the CLIv2 system parameter block file and the anomaly log file by setting the following environment parameters:

Setting the Environment Variables on Windows XP, 2000 and 2003

Use the information in the following table to set the Environment Parameters.

Note: If COPLIB is not specified when the Teradata Tools and Utilities applications are started, the current working folder will be used to find the system parameter block file (.\clispb.dat). If COPANOMLOG is not specified, no anomaly log file will be created.

Table 29: Environment Parameters

Parameter... defines...

COPLIB the path to the CLIv2 system parameter block file, clispb.dat.

COPANOMLOG the path to the anomaly log file, a trace log file displaying CLIv2 activities, including network-related error information. This environment variable should be defined only for debugging purposes.

Table 30: Setting Environment Parameters

To set environment parameters in... go to...

Windows 2000 Start > Control Panel > System, then select the Advanced tab, then click on Environment Variables.

Windows XP or Windows Server 2003 Start > Control Panel > System, then select the Advanced tab, then click on Environment Variables.

Teradata Tools and Utilities Installation Guide for Microsoft Windows 91

Page 92: Teradata Tools and Utilities - dbmanagement.infodbmanagement.info/Books/MIX/2407_TeraData.pdf · Teradata Tools and Utilities Installation Guide for Microsoft Windows 7 ... Software

Chapter 4: Configuring the Teradata Tools and Utilities SoftwareConfiguring Teradata Call-Level Interface version 2 (CLIv2) for Windows

Speeding Up the Logon Process

The speed of the logon process can be increased by limiting the number of GetHostByName requests issued by the Teradata Tools and Utilities applications. This is done by setting an environment variable with the name equal to the machine name with a specified number of COPS available for it, as follows:

set <machine_name>=<cops>

where:

Example:

set SHOGUN=3

This will cause CLIv2 to issue GetHostByName for SHOGUNCOP1, SHOGUNCOP2, and SHOGUNCOP3 only. If one of the GetHostByName requests fails, the successive requests will not be issued.

Setting the Port Number

You can specify the port number used by the Teradata Tools and Utilities software by setting the environment variable TDMSTPORT as follows:

set TDMSTPORT=<nnnn>

where:

Table 31: Logon Parameters

Parameter... is...

machine_name the name of the machine.

cops the number of COPS.

Table 32: Setting <machine name>

To set environment parameters in... go to...

Windows 2000 Start > Control Panel > System, then select the Advanced tab, then click on Environment Variables.

Windows XP or Windows Server 2003 Start > Control Panel > System, then select the Advanced tab, then click on Environment Variables.

Table 33: Port Number Parameters

Parameter... is...

nnnn the port number.

92 Teradata Tools and Utilities Installation Guide for Microsoft Windows

Page 93: Teradata Tools and Utilities - dbmanagement.infodbmanagement.info/Books/MIX/2407_TeraData.pdf · Teradata Tools and Utilities Installation Guide for Microsoft Windows 7 ... Software

Chapter 4: Configuring the Teradata Tools and Utilities SoftwareConfiguring Teradata Call-Level Interface version 2 (CLIv2) for Windows

NETRACE - Enabling Detailed COPANOMLOG Logging

Setting NETRACE=1 enables detailed network information between the client and the Teradata server. This information is logged into the file defined in the environmental setting COPANOMLOG.

THREADLOGGING - Enabling Multiple COPANOMLOG File Creation

Threadlogging supports multi-threaded Windows applications. Multi-threaded logging is enabled by setting THREADLOGGING=1.

For example, if COPANOMLOG is “c:\temp\coplog” and THREADLOGGING is enabled, logs will be created as c:\temp\coplog0.txt, c:\temp\coplog1.txt, and so on through c:\temp\coplogn.txt. Each thread that uses a CLI connection will create its own individual log file.

Setting System Parameters

The clispb.dat file (the CLIv2 System Parameter Block) contains default values for variables used by CLI application programs. In clispb.dat, the Teradata Database sets the initial values to duplicate the CLIv2 internal defaults.

You can edit the clispb.dat file to meet your site’s most common requirements. Refer to the Teradata Call-Level Interface Version 2 Reference for Network-Attached Systems for more information.

Adding CLI User Exit Functions

CLI User Exit functions are general-purpose facilities that may be added to the CLI workstation architecture on Windows systems. These functions allow user-defined processing to take place.

Procedure - Adding User Exit Functions

Use the following steps to install CLI User Exit functions.

1 Use the following command to set your folder to the folder where the tdusr32.mak file was installed. The default folder is <Boot Drive>:\ Program Files\NCR\Teradata\cli\UserExit.

cd "c:\Progam Files\NCR\Teradata\cli\UserExit"

Table 34: Setting TDMSTPORT

To set environment parameters in... go to...

Windows 2000 Start > Control Panel > System, then select the Advanced tab, then click on Environment Variables.

Windows XP or Windows Server 2003 Start > Control Panel > System, then select the Advanced tab, then click on Environment Variables.

Teradata Tools and Utilities Installation Guide for Microsoft Windows 93

Page 94: Teradata Tools and Utilities - dbmanagement.infodbmanagement.info/Books/MIX/2407_TeraData.pdf · Teradata Tools and Utilities Installation Guide for Microsoft Windows 7 ... Software

Chapter 4: Configuring the Teradata Tools and Utilities SoftwareConfiguring Teradata Parallel Transporter

2 Modify the CliLgnEx.c or CliPPS.c file in the UserExit folder.

3 Modify the CliLgnEx.c or CliPPS.c file in the UserExit folder.

4 Compile and link using the make facility:

nmake -f userexit.mak CFG="tdusr32 - Win32 Release"

The following configurations are supported:

• tdusr32 - Win32 Release

• tdusr32 - Win32 Debug

The 64-bit configurations must use the correct environment for 64-bit development.

5 Move the tdusr32.dll file into the appropriate folder. This library is by default installed into the %SystemRoot%\system32 folder.

For more information on CLI User Exit Functions, see the:

Teradata Call-Level Interface Version 2 Reference for Network-Attached Systems, Appendix D.

Configuring Teradata Parallel Transporter

After the Teradata Parallel Transporter has been installed, the following file usually requires modification:

• the local configuration file: twbcfg.ini

The file is located in the <Boot Drive>:\Program Files\NCR\Teradata Parallel Transporter\<version> folder.

Changing the twbcfg.ini File

After the Teradata Parallel Transporter Infrastructure package is installed, you may edit the configuration file, <Boot Drive>:\Program Files\NCR\Teradata Parallel Transporter\<version>\twbcfg.ini. The configuration file contains default directory for checkpoint and logs.

You can use an editor to modify the configuration file.

You would want to modify the Teradata Parallel Transporter configuration file, if you want to change the checkpoint or logs directory.

No reboot is required after making the change in the configuration file.

An example of the Teradata Parallel Transporter configuration file is shown here:

CheckpointDirectory='C:\Program Files\NCR\Teradata Parallel Transporter\12.0\checkpoint' LogDirectory='C:\Program Files\NCR\Teradata Parallel Transporter\12.0\logs'

CheckpointDirectory refers to the folder that contains the checkpoint files for Teradata Parallel Transporter jobs.

94 Teradata Tools and Utilities Installation Guide for Microsoft Windows

Page 95: Teradata Tools and Utilities - dbmanagement.infodbmanagement.info/Books/MIX/2407_TeraData.pdf · Teradata Tools and Utilities Installation Guide for Microsoft Windows 7 ... Software

Chapter 4: Configuring the Teradata Tools and Utilities SoftwareConfiguring Teradata Parallel Transporter

LogDirectory refers to the folder that contains the binary logs for Teradata Parallel Transporter jobs. Each Teradata Parallel Transporter job creates a job log in the jobs directory.

Note: If you change the folder for the LogDirectory and you have the Teradata Parallel Transporter Wizard installed, you must change the LOG_DIRECTORY entry in the %TWB_ROOT%\tptwizard\config\tptwizard.properties file before you run Teradata Parallel Transporter Wizard. %TWB_ROOT% is the system environment variable that holds the value for the Teradata Parallel Transporter installation folder.

For example, if you change the folder for the LogDirectory to C:\Logs\Teradata Parallel Transporter 12.0 and you have the Teradata Parallel Transporter Wizard installed, use the following procedures to update the LOG_DIRECTORY entry in the %TWB_ROOT%\tptwizard\config\tptwizard.properties file

Procedure - Updating the LOG_DIRECTORY

Use the following steps to update the LOG_DIRECTORY.

1 Use an editor (for example, NOTEPAD) to open the tptwizard.properties file in the %TWB_ROOT%\tptwizard\config folder.

2 Update the LOG_DIRECTORY line to this:

LOG_DIRECTORY=C:\\Logs\\Teradata Parallel Transporter 12.00.00\\

3 Save the change.

4 Quit the editor.

The C:\Logs\Teradata Parallel Transporter 12.00.00.00 folder is used as an example. You can use a different folder.

The folder for the LOG_DIRECTORY entry in the tptwizard.properties file must be separated by double backslash “\\” and must end with double backslash “\\”.

Refer to the Teradata Parallel Transporter Reference manual on how to read the job log.

Switching Teradata Parallel Transporter Software Versions

After Teradata Parallel Transporter software is installed, the system is setup to run the installed version of the Teradata Parallel Transporter in the next new window of the MS-DOS Command Prompt.

Determining the Current Teradata Parallel Transporter Version

To find out which version of Teradata Parallel Transporter is currently running on the system, run “tbuild” with no options in a new window of the MS-DOS Command Prompt.

For example:

C:\> tbuildTeradata Parallel Transporter Run Utility Version 12.00.00.

Teradata Tools and Utilities Installation Guide for Microsoft Windows 95

Page 96: Teradata Tools and Utilities - dbmanagement.infodbmanagement.info/Books/MIX/2407_TeraData.pdf · Teradata Tools and Utilities Installation Guide for Microsoft Windows 7 ... Software

Chapter 4: Configuring the Teradata Tools and Utilities SoftwareConfiguring Teradata Parallel Transporter

Switching to Teradata Warehouse Builder Version 4.1 or Earlier

If Teradata Warehouse Builder version 4.1 or earlier is installed, you can switch to this version using the following procedure:

Procedure - Switching to Teradata Warehouse Builder Version 4.1 or Earlier

Follow these steps to switch to Teradata Warehouse Builder version 4.1 or earlier.

1 Go to Start > Settings > Control Panel > System

2 In the System Properties dialog box, click on the Advanced tab.

3 In the Advanced tab, click on the Environment Variables button.

4 Make a copy of the system TWB_ROOT environment variable.

5 Delete the system TWB_ROOT environment variable.

6 Click on the OK button.

7 Click on the OK button again.

8 Bring up a new window of the MS-DOS Command Prompt.

The system should be running version 4.1 or earlier of Teradata Warehouse Builder.

Switching Back to the Installed Teradata Parallel Transporter

If the system is running a previous version of the Teradata Parallel Transporter or Teradata Warehouse Builder, use the following procedure to switch to the current version of Teradata Parallel Transporter.

Procedure - Switching Back to the Installed Teradata Parallel Transporter

Follow these steps to switch back to the installed Teradata Parallel Transporter version.

1 In the System Properties dialog box, click on the Advanced tab.

2 Go to Start > Settings > Control Panel > System

3 In the Advanced tab, click on the Environment Variables button.

4 Create a new system TWB_ROOT environment variable and set the value to the installed Teradata Parallel Transporter installation folder.

If you made a copy of the system TWB_ROOT environment variable, the value of the copied TWB_ROOT environment variable is the installation folder of the installed Teradata Parallel Transporter.

If you do not know the installation folder of the installed Teradata Parallel Transporter, look at the INSTALLBASE name in the HKEY_LOCAL_MACHINE\SOFTWARE\NCR\Teradata Parallel Transporter Infrastructure 12.0 registry key. The value for the INSTALLBASE name is the installation folder of the installed Teradata Parallel Transporter.

5 Click on the OK button.

6 Click on the OK button again.

96 Teradata Tools and Utilities Installation Guide for Microsoft Windows

Page 97: Teradata Tools and Utilities - dbmanagement.infodbmanagement.info/Books/MIX/2407_TeraData.pdf · Teradata Tools and Utilities Installation Guide for Microsoft Windows 7 ... Software

Chapter 4: Configuring the Teradata Tools and Utilities SoftwareConfiguring Teradata Parallel Transporter

7 Bring up a new window of the MS-DOS Command Prompt.

The system will switch back to Teradata Parallel Transporter version 12.0.

Switching to Teradata Warehouse Builder Version 5.0

If Teradata Warehouse Builder 5.0 is installed, use the following procedures to switch to the 5.0 version of Teradata Warehouse Builder:

Procedure - Switching to Teradata Warehouse Builder Version 5.0

Follow these steps to switch to Teradata Warehouse Builder version 5.0.

1 Go to Start > Settings > Control Panel > System

2 In the System Properties dialog box, click on the Advanced tab.

3 In the Advanced tab, click on the Environment Variables button.

4 Create a new system TWB_ROOT environment variable and set the value to the installed Teradata Warehouse Builder 5.0 installation folder. If you do not know the installation folder of the Teradata Warehouse Builder 5.0 version, look at the INSTALLBASE name in the HKEY_LOCAL_MACHINE\SOFTWARE\NCR\Teradata Warehouse Builder 5.0 registry key. The value for the INSTALLBASE name is the installation folder of the Teradata Warehouse Builder 5.0 version.

5 Click on the OK button.

6 Click on the OK button again.

7 Bring up a new window of the MS-DOS Command Prompt.

The system should be running version 5.0 of Teradata Warehouse Builder.

User Environment Variables

If the TWB_ROOT user environment variable is used, it is recommended that you delete it before running a Teradata Parallel Transporter job.

Note: Both 32-bit and 64-bit versions of the Teradata Parallel Transporter Operator Support Library can be installed on a 64-bit Windows machine. If both versions of this package are installed on a 64-bit machine, then the TWB_ROOT, _MSGCATLOCATION, and PATH environment variables include the directories of the most recently installed version of the Teradata Parallel Transporter Operator Support Library.

Procedure - Deleting the TWB_ROOT Variable

Follow these steps to delete the TWB_ROOT user variable.

1 Go to Start > Settings > Control Panel > System

2 In the System Properties dialog box, click on the Advanced tab.

3 In the Advanced tab, click on the Environment Variables button.

Teradata Tools and Utilities Installation Guide for Microsoft Windows 97

Page 98: Teradata Tools and Utilities - dbmanagement.infodbmanagement.info/Books/MIX/2407_TeraData.pdf · Teradata Tools and Utilities Installation Guide for Microsoft Windows 7 ... Software

Chapter 4: Configuring the Teradata Tools and Utilities SoftwareConfiguring Teradata Parallel Transporter

4 Highlight the TWB_ROOT variable in the User variables section and click on the Delete button.

5 Click on the OK button.

6 Click on the OK button again.

System Environment Variable ORACLE_HOME

The Teradata Parallel Transporter Wizard requires that the ORACLE_HOME system environment variable point to folder where the Oracle client version of software used by the Teradata Parallel Transporter Wizard is located.

Uninstalling Teradata Parallel Transporter

Use the following procedure to uninstall Teradata Parallel Transporter.

Procedure - Uninstalling Teradata Parallel Transporter

Follow these steps to uninstall Teradata Parallel Transporter.

1 Go to Start > Settings > Control Panel > Add/Remove Programs.

2 In the Add/Remove Programs dialog box, click Change or Remove Programs.

3 Following the order that the “Order to Remove Teradata Parallel Transporter Software” section describes, highlight a Teradata Parallel Transporter software, then click Add/Remove.

4 Confirm the action and, if necessary, follow the instructions presented in the Uninstall Wizard.

Order to Remove Teradata Parallel Transporter Software

Remove these software first, in any order:

• Teradata Parallel Transporter ODBC Operator <version>

• Teradata Parallel Transporter Data Connector Operator <version>

• Teradata Parallel Transporter DDL Operator <version>

• Teradata Parallel Transporter OS Command Operator <version>

• Teradata Parallel Transporter SQL Inserter Operator <version>

• Teradata Parallel Transporter SQL Selector Operator <version>

• Teradata Parallel Transporter Wizard <version>

• Teradata Parallel Transporter API <version>

Remove these software next, in any order:

• Teradata Parallel Transporter Export Operator <version>

• Teradata Parallel Transporter Load Operator <version>

• Teradata Parallel Transporter Stream Operator <version>

98 Teradata Tools and Utilities Installation Guide for Microsoft Windows

Page 99: Teradata Tools and Utilities - dbmanagement.infodbmanagement.info/Books/MIX/2407_TeraData.pdf · Teradata Tools and Utilities Installation Guide for Microsoft Windows 7 ... Software

Chapter 4: Configuring the Teradata Tools and Utilities SoftwareConfiguring Teradata Parallel Transporter

• Teradata Parallel Transporter Update Operator <version>

• Teradata Parallel Transporter Operator Support Library <version>

• Teradata Parallel Transporter Infrastructure <version>

• Teradata Parallel Transporter ICU Library<version>

Configuring Teradata Access Module for JMS

After the Teradata Access Module for JMS has been installed, see the readme file in the installation folder for Teradata Access Module for JMS. The default installation folder for Teradata Access Module for JMS is <Boot Drive>:\Program Files\Common Files\NCR\JMSAXSMOD. Use an editor, like Notepad, to open the readme file.

Teradata Tools and Utilities Installation Guide for Microsoft Windows 99

Page 100: Teradata Tools and Utilities - dbmanagement.infodbmanagement.info/Books/MIX/2407_TeraData.pdf · Teradata Tools and Utilities Installation Guide for Microsoft Windows 7 ... Software

Chapter 4: Configuring the Teradata Tools and Utilities SoftwareConfiguring Teradata Parallel Transporter

100 Teradata Tools and Utilities Installation Guide for Microsoft Windows

Page 101: Teradata Tools and Utilities - dbmanagement.infodbmanagement.info/Books/MIX/2407_TeraData.pdf · Teradata Tools and Utilities Installation Guide for Microsoft Windows 7 ... Software

CHAPTER 5

Verifying the Installation

This chapter describes how to verify that Teradata Tools and Utilities software has been installed properly. This chapter provides the following topics:

• Verifying the Installation of Individual Products

• Verifying Basic Teradata Query (BTEQ)

• Verifying Named Pipes Access Module

• Verifying ODBC Driver for Teradata

• Verifying Shared ICU Libraries for Teradata

• Verifying Teradata Access Module for JMS

• Verifying Teradata Access Module for Tivoli

• Verifying Teradata Archive/Recovery Utility (ARC)

• Verifying Teradata C Preprocessor2

• Verifying Teradata Call-Level Interface version 2 (CLIv2)

• Verifying Teradata Data Connector

• Verifying Teradata Driver for the JDBC Interface

• Verifying Teradata Dynamic Workload Manager

• Verifying Teradata FastExport

• Verifying Teradata FastLoad

• Verifying Teradata MultiLoad

• Verifying Teradata MultiTool

• Verifying Teradata OLE DB Access Module

• Verifying Teradata Parallel Transporter API

• Verifying Teradata Parallel Transporter Infrastructure

• Verifying Teradata Parallel Transporter Data Connector Operator

• Verifying Teradata Parallel Transporter DDL Operator

• Verifying Teradata Parallel Transporter Export Operator

• Verifying Teradata Parallel Transporter ICU Library

• Verifying Teradata Parallel Transporter Load Operator

• Verifying Teradata Parallel Transporter ODBC Operator

• Verifying Teradata Parallel Transporter Operator Support Library

• Verifying Teradata Parallel Transporter OS Command Operator

• Verifying Teradata Parallel Transporter SQL Inserter Operator

Teradata Tools and Utilities Installation Guide for Microsoft Windows 101

Page 102: Teradata Tools and Utilities - dbmanagement.infodbmanagement.info/Books/MIX/2407_TeraData.pdf · Teradata Tools and Utilities Installation Guide for Microsoft Windows 7 ... Software

Chapter 5: Verifying the Installation

• Verifying Teradata Parallel Transporter SQL Selector Operator

• Verifying Teradata Parallel Transporter Stream Operator

• Verifying Teradata Parallel Transporter Update Operator

• Verifying Teradata Parallel Transporter Wizard

• Verifying Teradata Query Scheduler Administrator

• Verifying Teradata Query Scheduler Client

• Verifying Teradata Query Scheduler Server

• Verifying Teradata TPump

• Verifying WebSphere MQ Access Module

• Verifying Teradata Workload Analyzer

• Verifying the Installation Using the CLI Sample Program, clisamp

102 Teradata Tools and Utilities Installation Guide for Microsoft Windows

Page 103: Teradata Tools and Utilities - dbmanagement.infodbmanagement.info/Books/MIX/2407_TeraData.pdf · Teradata Tools and Utilities Installation Guide for Microsoft Windows 7 ... Software

Chapter 5: Verifying the InstallationVerifying the Installation of Individual Products

Verifying the Installation of Individual Products

After installing Teradata Tools and Utilities, the installation of individual products can be verified.

Procedure - Verifying Installation of Individual Products

Follow these steps to verify the installation of individual products.

1 Check that the directories specified in the tables below have been installed.

2 Check that the files specified in the tables below have been installed.

Verifying Basic Teradata Query (BTEQ)

Table 35: Basic Teradata Query (BTEQ) Files 32-bit Platforms

BTEQ for Windows 32-bit platforms

File Type File Name Default Folder

Executable bteq.exe

bteqwin.exe

<Boot Drive>:\Program Files\NCR\Teradata Client\bin

Help bteqwin_enu.cnt

bteqwin_enu.hlp

bteqwin_jpn.cnt

bteqwin_jpn.hlp

<Boot Drive>:\Program Files\NCR\Teradata Client\bin

Icon teqtalk.ico <Boot Drive>:\Program Files\NCR\Teradata Client\bin

Library bteqwin_jpn.dll

mgrcli.dll

mgrcli_jpn.dll

ncrtmgr.dll

ncrtmgr_jpn.dll

printman.dll

tdis.dll

tm_dialogs.dll

tm_dialogs_jpn.dll

tm_stat.dll

tm_stat_jpn.dll

<Boot Drive>:\Program Files\NCR\Teradata Client\bin

Teradata Tools and Utilities Installation Guide for Microsoft Windows 103

Page 104: Teradata Tools and Utilities - dbmanagement.infodbmanagement.info/Books/MIX/2407_TeraData.pdf · Teradata Tools and Utilities Installation Guide for Microsoft Windows 7 ... Software

Chapter 5: Verifying the InstallationVerifying the Installation of Individual Products

Verifying Named Pipes Access Module

Verifying ODBC Driver for Teradata

Library caputl.dll

mfc71.dll

mfc71u.dll

msvcr71.dll

%SystemRoot%\system32

Sample btnfyext.c

btnfyext.def

btnfyext.h

btnfyext.mak

<Boot Drive>:\Program Files\NCR\Teradata Client\btnfy

Table 35: Basic Teradata Query (BTEQ) Files 32-bit Platforms (continued)

BTEQ for Windows 32-bit platforms

Table 36: Named Pipes Access Module 32-bit Files

Named Pipes Access Module for Windows 32-bit platforms

File Type File Name Default Folder

Library np_AXSMOD.dll

np_AXSMODenu.dll

np_AXSMODTWB.dll

np_AXSMODenuTWB.dll

%SystemRoot%\system32

Table 37: ODBC Driver for Teradata 32-bit Files

ODBC Driver for Teradata for Windows 32-bit platforms

File Type File Name Default Folder

_unodbc.dll

Pbocd0x0.txt

Readme.txt

<Boot Drive>:\Program Files\NCR\ODBC Driver for Teradata

104 Teradata Tools and Utilities Installation Guide for Microsoft Windows

Page 105: Teradata Tools and Utilities - dbmanagement.infodbmanagement.info/Books/MIX/2407_TeraData.pdf · Teradata Tools and Utilities Installation Guide for Microsoft Windows 7 ... Software

Chapter 5: Verifying the InstallationVerifying the Installation of Individual Products

Verifying Shared ICU Libraries for Teradata

Table 38: ODBC Driver for Teradata 64-bit Files

ODBC Driver for Teradata for Windows 64-bit platforms

File Type File Name Default Folder

_unodbc.dll

Pbocd0x0.txt

Readme.txt

<Boot Drive>:\Program Files\NCR\ODBC Driver for Teradata

Table 39: Share ICU Libraries for Teradata 32-bit Files

Shared ICU Libraries for Teradata for Windows 32-bit platforms

File Type File Name Default Folder

Dynamic Link Library icudttd341.dll

icuintd34.dll

icuiotd34.dll

iculetd34.dll

iculxtd34.dll

icuuctd34.dll

MSVCR71.DLL

MSVCP71.DLL

%ProgramFiles\NCR\Common Files\Shared ICU Libraries for Teradata\lib

Teradata Tools and Utilities Installation Guide for Microsoft Windows 105

Page 106: Teradata Tools and Utilities - dbmanagement.infodbmanagement.info/Books/MIX/2407_TeraData.pdf · Teradata Tools and Utilities Installation Guide for Microsoft Windows 7 ... Software

Chapter 5: Verifying the InstallationVerifying the Installation of Individual Products

Verifying Teradata Access Module for JMS

Verifying Teradata Access Module for Tivoli

Table 40: Shared ICU Libraries for Teradata 64-bit Files

Shared ICU Libraries for Teradata for Windows 64-bit platforms

File Type File Name Default Folder

Dynamic Link Library icudttd281.dll

icuintd28.dll

icuiotd28.dll

iculetd28.dll

iculxtd28.dll

icuuctd28.dll

%ProgramFiles\NCR\Common Files\Shared ICU Libraries for Teradata\lib

Table 41: Teradata Access Module for JMS Files

Teradata Access Module for JMS for Windows 32-bit platforms

File Type File Name Default Folder

Dynamic Link Library libjmsam.dll <Boot Drive>:\Program Files\Common Files\NCR\JMSAXSMOD

Readme readme <Boot Drive>:\Program Files\Common Files\NCR\JMSAXSMOD

Class Receiver.class <Boot Drive>:\Program Files\Common Files\NCR\JMSAXSMOD

Table 42: Teradata Access Module for Tivoli Files

Teradata Access Module for Tivoli for Windows 32-bit platforms

File Type File Name Default Folder

Executable TDDSNC.EXE <Boot Drive>:\Program Files\NCR\Teradata Client\bin

Library TIVBAR.DLL <Boot Drive>:\Program Files\NCR\Teradata Client\bin

Help ARCDFLT.TXT

TIVDFLT.TXT

Tivoli.Readme.TXT

<Boot Drive>:\Program Files\NCR\Teradata Client\bin

Configuration TIVARC.BATTIVADM.BAT <Boot Drive>:\Program Files\NCR\Teradata Client\TDBAR

Working Files temporary and diagnostic files

<Boot Drive>:\TDBAR

106 Teradata Tools and Utilities Installation Guide for Microsoft Windows

Page 107: Teradata Tools and Utilities - dbmanagement.infodbmanagement.info/Books/MIX/2407_TeraData.pdf · Teradata Tools and Utilities Installation Guide for Microsoft Windows 7 ... Software

Chapter 5: Verifying the InstallationVerifying the Installation of Individual Products

Verifying Teradata Archive/Recovery Utility (ARC)

Verifying Teradata C Preprocessor2

Verifying Teradata Call-Level Interface version 2 (CLIv2)

Table 43: Teradata Archive/Recovery Utility (ARC) 32-bit Files

Teradata Archive/Recovery Utility (ARC) for Windows 32-bit platforms

File Type File Name Default Folder

Executable arcmain.exe <Boot Drive>:\Program Files\NCR\Teradata Client\bin

Table 44: Teradata C Preprocessor2 32-bit and 64-bit Files

Teradata C Preprocessor2 for Windows 32-bit and 64-bit platforms

File Type File Name Default Folder

Executable ppcmain.exe <Boot Drive>:\Program Files\NCR\Teradata Client\bin

Library ppruntim.dll <Boot Drive>:\Program Files\NCR\Teradata Client\pp2

Library ppruntim.lib <Boot Drive>:\Program Files\NCR\Teradata Client\pp2

Sample LABSBTEQ

PPCLB1

PPCLB2

PPCLB3

PPCLB4

PPCLB5

PPCLB6

PPCLB7

PPCLB8

PPCLB9

<Boot Drive>:\Program Files\NCR\Teradata Client\pp2

Table 45: Teradata Call-Level Interface version 2 (CLIv2), 32-bit Files

CLIv2 for Windows 32-bit platforms

File Type File Name Default Folder

CLI Data clispb.dat <Boot Drive>:\Program Files\NCR\Teradata Client\cliv2

clisamp clisamp.c

makesamp.win

<Boot Drive>:\Program Files\NCR\Teradata Client\cliv2

Teradata Tools and Utilities Installation Guide for Microsoft Windows 107

Page 108: Teradata Tools and Utilities - dbmanagement.infodbmanagement.info/Books/MIX/2407_TeraData.pdf · Teradata Tools and Utilities Installation Guide for Microsoft Windows 7 ... Software

Chapter 5: Verifying the InstallationVerifying the Installation of Individual Products

Include cliv2if.h

coperr.h

coptypes.h

dbcacnx.h

dbcarea.h

dbcerr.h

dbchqep.h

mosiif.h

nojunk.h

parcel.h

resource.h

wincliv2.h

<Boot Drive>:\Program Files\NCR\Teradata Client\cliv2\inc

Library tdusr32.lib

wincli32.lib

<Boot Drive>:\Program Files\NCR\Teradata Client\cliv2\lib

User Exit CliLgnEx.c

CliPPS.c

tdusr.def

tdusr.rc

userexit.mak

<Boot Drive>:\Program Files\NCR\Teradata Client\cliv2\UserExit

Dynamic Link Library wincli32.dll

tdusr32.dll

terasso.dll

localisation.dll

<Boot Drive>:\Program Files\NCR\Teradata Client\cliv2

Table 45: Teradata Call-Level Interface version 2 (CLIv2), 32-bit Files (continued)

CLIv2 for Windows 32-bit platforms

Table 46: Teradata Call-Level Interface version 2 (CLIv2), 64-bit Files

CLIv2 for Windows 64-bit platforms

File Type File Name Default Folder

CLI Data clispb.dat <Boot Drive>:\Program Files\NCR\Teradata Client\cliv2

clisamp clisamp.c

makesamp.win

<Boot Drive>:\Program Files\NCR\Teradata Client\cliv2

108 Teradata Tools and Utilities Installation Guide for Microsoft Windows

Page 109: Teradata Tools and Utilities - dbmanagement.infodbmanagement.info/Books/MIX/2407_TeraData.pdf · Teradata Tools and Utilities Installation Guide for Microsoft Windows 7 ... Software

Chapter 5: Verifying the InstallationVerifying the Installation of Individual Products

Verifying Teradata Data Connector

Include cliv2if.h

coperr.h

coptypes.h

dbcacnx.h

dbcarea.h

dbcerr.h

dbchqep.h

mosiif.h

nojunk.h

parcel.h

resource.h

wincliv2.h

<Boot Drive>:\Program Files\NCR\Teradata Client\cliv2\inc

Library tdusr32.lib

wincli32.lib

<Boot Drive>:\Program Files\NCR\Teradata Client\cliv2\lib

User Exit CliLgnEx.c

CliPPS.c

tdusr.def

tdusr.rc

userexit.mak

<Boot Drive>:\Program Files\NCR\Teradata Client\cliv2\UserExit

Dynamic Link Library wincli32.dll

tdusr32.dll

terasso.dll

localisation.dll

<Boot Drive>:\Program Files\NCR\Teradata Client\cliv2

Table 46: Teradata Call-Level Interface version 2 (CLIv2), 64-bit Files (continued)

CLIv2 for Windows 64-bit platforms

Table 47: Teradata Data Connector 32-bit Files

Teradata Data Connector for Windows 32-bit and 64-bit platforms

File Type File Name Default Folder

Header pmdcomt.h

pmddamt.h

%SystemRoot%\system32

Library libpm.dll %SystemRoot%\system32

Teradata Tools and Utilities Installation Guide for Microsoft Windows 109

Page 110: Teradata Tools and Utilities - dbmanagement.infodbmanagement.info/Books/MIX/2407_TeraData.pdf · Teradata Tools and Utilities Installation Guide for Microsoft Windows 7 ... Software

Chapter 5: Verifying the InstallationVerifying the Installation of Individual Products

Verifying Teradata Driver for the JDBC Interface

Verifying Teradata Dynamic Workload Manager

Table 48: Teradata Data Connector 64-bit Files

Teradata Data Connector for Windows 64-bit platforms

File Type File Name Default Folder

Header pmdcomt.h

pmddamt.h

%SystemRoot%\system32

Library libpm.dll %SystemRoot%\system32

Table 49: Teradata Driver for the JDBC Interface

Teradata Driver for the JDBC Interfaces for Windows 32-bit and 64-bit platforms

File Type File Name Default Folder

Executable terajdbc4.jar user selectable

Sample samples.jar user selectable

Security tdgssjava.jar

tdgssconfig.jar

user selectable

Table 50: Teradata Dynamic Workload Manager Files

Teradata Dynamic Workload Manager for Windows 32-bit platforms

File Type File Name Default Folder

Executable tdwm.exe

mpsfs.exe

Verify.exe

verify.dat

<Boot Drive>:\Program Files\NCR\Teradata Dynamic Workload Manager 12.0

110 Teradata Tools and Utilities Installation Guide for Microsoft Windows

Page 111: Teradata Tools and Utilities - dbmanagement.infodbmanagement.info/Books/MIX/2407_TeraData.pdf · Teradata Tools and Utilities Installation Guide for Microsoft Windows 7 ... Software

Chapter 5: Verifying the InstallationVerifying the Installation of Individual Products

Verifying Teradata FastExport

Verifying Teradata FastLoad

Library FPSpread.dll

mfc71.dll

mfc71u.dll

mgrcli.dll

monpm.dll

msvcr71.dll

msvcr80.dll

ncrtmgr.dll

psload.dll

tdapp.dll

tdis.dll

tdmfcis.dll

tdwmutil.dll

tm_dialogs.dll

<Boot Drive>:\Program Files\NCR\Teradata Dynamic Workload Manager 12.0

Table 50: Teradata Dynamic Workload Manager Files (continued)

Teradata Dynamic Workload Manager for Windows 32-bit platforms

Table 51: Teradata FastExport 32-bit Files

Teradata FastExport for Windows 32-bit platforms

File Type File Name Default Folder

Executable fexp.exe <Boot Drive>:\Program Files\NCR\Teradata Client\bin

Sample feimod.c

fenotf.c

feomod.c

<Boot Drive>:\Program Files\NCR\Teradata Client\fexp

Table 52: Teradata FastLoad 32-bit Files

Teradata FastLoad for Windows 32-bit platforms

File Type File Name Default Folder

Executable fastload.exe <Boot Drive>:\Program Files\NCR\Teradata Client\bin

Teradata Tools and Utilities Installation Guide for Microsoft Windows 111

Page 112: Teradata Tools and Utilities - dbmanagement.infodbmanagement.info/Books/MIX/2407_TeraData.pdf · Teradata Tools and Utilities Installation Guide for Microsoft Windows 7 ... Software

Chapter 5: Verifying the InstallationVerifying the Installation of Individual Products

Verifying Teradata MultiLoad

Verifying Teradata MultiTool

Sample blkexit.c

blkexit.mak

blkexitr.c

flnfyext.c

<Boot Drive>:\Program Files\NCR\Teradata Client\fastload

Table 52: Teradata FastLoad 32-bit Files (continued)

Teradata FastLoad for Windows 32-bit platforms

Table 53: Teradata MultiLoad 32-bit Files

Teradata MultiLoad for Windows 32-bit platforms

File Type File Name Default Folder

Executable mload.exe <Boot Drive>:\Program Files\NCR\Teradata Client\bin

Sample mlimod.c

mlnotf.c

<Boot Drive>:\Program Files\NCR\Teradata Client\mload

Table 54: Teradata MultiTool 32-bit Files

Teradata MultiTool for Windows 32-bit platforms

File Type File Name Default Folder

Classes jhall.jar

pdecui.jar

sfc.jar

symbeans.jar

<Boot Drive>:\Program Files\NCR\Teradata MultiTool

Executable cnstool.exe

winjavaloader.exe

<Boot Drive>:\Program Files\NCR\Teradata MultiTool

Library libnetpde.dll

msvcrtd.dll

<Boot Drive>:\Program Files\NCR\Teradata MultiTool

Miscellaneous td.ico

version.txt

<Boot Drive>:\Program Files\NCR\Teradata MultiTool

Shortcut MultiTool <Boot Drive>:\Program Files\NCR\Teradata MultiTool

112 Teradata Tools and Utilities Installation Guide for Microsoft Windows

Page 113: Teradata Tools and Utilities - dbmanagement.infodbmanagement.info/Books/MIX/2407_TeraData.pdf · Teradata Tools and Utilities Installation Guide for Microsoft Windows 7 ... Software

Chapter 5: Verifying the InstallationVerifying the Installation of Individual Products

Verifying Teradata OLE DB Access Module

Verifying Teradata Parallel Transporter API

Table 55: Teradata OLE DB Access Module 32-bit Files

Teradata OLE DB Access Module for Windows 32-bit platforms

File Type File Name Default Folder

Executable oleload.exe <Boot Drive>:\Program Files\NCR\Teradata Client\bin

Library msvcr71.dll

OLEDB_AXSMOD.dll

OLEDB_AXSMODenu.dll

OLEDB_AXSMODjpn.dll

Uninst.dll

<Boot Drive>:\Program Files\Common Files\NCR\AXSMOD

Help OLEDB_AXSMODenu.cnt

OLEDB_AXSMODENU.hlp

OLEDB_AXSMODjpn.cnt

OLEDB_AXSMODJPN.hlp

<Boot Drive>:\Program Files\Common Files\NCR\AXSMOD

Icon program.ico <Boot Drive>:\Program Files\Common Files\NCR\AXSMOD

Online Help Online Help files <Boot Drive>:\Program Files\Common Files\NCR\AXSMOD\ Teradata OLE DB Access Module Help

Table 56: 32-bit Teradata Parallel Transporter API

API: Windows 32-bit platforms

File Type File Name Default Folder

Library telapi.dll

telapi.lib

<Boot Drive>:\Program Files\NCR\Teradata Parallel Transporter\<version>\bin

Header DMLGroup.h

Schema.h

Connection.h

<Boot Drive>:\Program Files\NCR\Teradata Parallel Transporter\<version>\tptapi\inc

Header generic.h <Boot Drive>:\Program Files\NCR\Teradata Parallel Transporter\<version>\tptapi\sample\generic\inc

Header BlockLoad.h <Boot Drive>:\Program Files\NCR\Teradata Parallel Transporter\<version>\tptapi\sample\blockloading\inc

Header MultipleOperators.h <Boot Drive>:\Program Files\NCR\Teradata Parallel Transporter\<version>\tptapi\sample\multiple\inc

Teradata Tools and Utilities Installation Guide for Microsoft Windows 113

Page 114: Teradata Tools and Utilities - dbmanagement.infodbmanagement.info/Books/MIX/2407_TeraData.pdf · Teradata Tools and Utilities Installation Guide for Microsoft Windows 7 ... Software

Chapter 5: Verifying the InstallationVerifying the Installation of Individual Products

Header fileio.h

multitest.h

synchronize.h

<Boot Drive>:\Program Files\NCR\Teradata Parallel Transporter\<version>\tptapi\sample\multi_node\inc

Header checkpoint.h <Boot Drive>:\Program Files\NCR\Teradata Parallel Transporter\<version>\tptapi\sample\checkpoint\inc

Header common.h

Mutex.h

PerfTestMessage.h

TestBase.h

TestExport.h

TestLoad.h

TestSim.h

TestStream.h

TestUpdate.h

ThreadTest.h

ThreadTestParameters.h

<Boot Drive>:\Program Files\NCR\Teradata Parallel Transporter\<version>\tptapi\sample\threads\inc

Header DMLGroup.h

Schema.h

Connection.h

<Boot Drive>:\Program Files\NCR\Teradata Parallel Transporter\<version>\tptapi\sample\inc

Header OptionsManager.cpp

OptionsManager.h

<Boot Drive>:\Program Files\NCR\Teradata Parallel Transporter\<version>\tptapi\sample\common

Header checkpoint.cpp

main.cpp

input.txt

infile.littleEndian

checkpoint.vcproj

checkpoint.sln

cleanupTables.bteq

setupTables.bteq

<Boot Drive>:\Program Files\NCR\Teradata Parallel Transporter\<version>\tptapi\sample\checkpoint

Table 56: 32-bit Teradata Parallel Transporter API (continued)

API: Windows 32-bit platforms

114 Teradata Tools and Utilities Installation Guide for Microsoft Windows

Page 115: Teradata Tools and Utilities - dbmanagement.infodbmanagement.info/Books/MIX/2407_TeraData.pdf · Teradata Tools and Utilities Installation Guide for Microsoft Windows 7 ... Software

Chapter 5: Verifying the InstallationVerifying the Installation of Individual Products

Header GenericDriver.cpp

main.cpp

input.txt

infile.littleEndian

generic.vcproj

generic.sln

cleanupTables.bteq

setupTables.bteq

<Boot Drive>:\Program Files\NCR\Teradata Parallel Transporter\<version>\tptapi\sample\generic

Header BlockLoad.cpp

main.cpp

input.txt

infile.littleEndian

blockload.vcproj

blockload.sln

cleanupTables.bteq

setupTables.bteq

<Boot Drive>:\Program Files\NCR\Teradata Parallel Transporter\<version>\tptapi\sample\blockloading

Header multitest.cpp

synchronize.cpp

fileio.cpp

master.cpp

slave.cpp

master_input.txt

slave_input.txt

infilemaster.littleEndian

infileslave.littleEndian.1

multinode.sln

masternode.vcproj

slavenode.vcproj

cleanupTables.bteq

setupTables.bteq

<Boot Drive>:\Program Files\NCR\Teradata Parallel Transporter\<version>\tptapi\sample\multi_node

Table 56: 32-bit Teradata Parallel Transporter API (continued)

API: Windows 32-bit platforms

Teradata Tools and Utilities Installation Guide for Microsoft Windows 115

Page 116: Teradata Tools and Utilities - dbmanagement.infodbmanagement.info/Books/MIX/2407_TeraData.pdf · Teradata Tools and Utilities Installation Guide for Microsoft Windows 7 ... Software

Chapter 5: Verifying the InstallationVerifying the Installation of Individual Products

Header PerfTestMessage.cpp

TelapiThreadTest.cpp

PerfTestMessage.cpp

TelapiThreadTest.sln

TelapiThreadTest.vcproj

TestBase.cpp

TestExport.cpp

TestLoad.cpp

TestSim.cpp

TestStream.cpp

TestUpdate.cpp

ThreadTest.cpp

ThreadTestParameters.cpp

Synchronizer.cpp

input.txt

loadData.littleEndian

cleanupTables.bteq

setupTables.bteq

<Boot Drive>:\Program Files\NCR\Teradata Parallel Transporter\<version>\tptapi\sample\threads

Get Buffer GetBuffer.cpp

main.cpp

cleanupTables.bteq

setupTables.bteq

getbuffer.sln

getbuffer.vcproj

input.txt

$INSTALLDIR/tptapi/sample/getbuffer

Include GetBuffer.h $INSTALLDIR/tptapi/sample/getbuffer/inc

Table 56: 32-bit Teradata Parallel Transporter API (continued)

API: Windows 32-bit platforms

116 Teradata Tools and Utilities Installation Guide for Microsoft Windows

Page 117: Teradata Tools and Utilities - dbmanagement.infodbmanagement.info/Books/MIX/2407_TeraData.pdf · Teradata Tools and Utilities Installation Guide for Microsoft Windows 7 ... Software

Chapter 5: Verifying the InstallationVerifying the Installation of Individual Products

XSP GenericDriver.cpp

GenericDriver.h

OptionsReader.cpp

OptionsReader.h

xsp.cpp

xsp.sln

xsp.vcproj

input.exp

input.lod

input.stm

input.upd

infile.littleEndian

$INSTALLDIR/tptapi/sample/xsp

Table 56: 32-bit Teradata Parallel Transporter API (continued)

API: Windows 32-bit platforms

Table 57: 64-bit Teradata Parallel Transporter API

API: Windows 64-bit platforms

File Type File Name Default Folder

Library telapi.dll

telapi.lib

<Boot Drive>:\Program Files\NCR\Teradata Parallel Transporter\<version>\bin64

Header DMLGroup.h

Schema.h

Connection.h

<Boot Drive>:\Program Files\NCR\Teradata Parallel Transporter\<version>\tptapi\inc

Header generic.h <Boot Drive>:\Program Files\NCR\Teradata Parallel Transporter\<version>\tptapi\sample\generic\inc

Header BlockLoad.h <Boot Drive>:\Program Files\NCR\Teradata Parallel Transporter\<version>\tptapi\sample\blockloading\inc

Header MultipleOperators.h <Boot Drive>:\Program Files\NCR\Teradata Parallel Transporter\<version>\tptapi\sample\multiple\inc

Header fileio.h

multitest.h

synchronize.h

<Boot Drive>:\Program Files\NCR\Teradata Parallel Transporter\<version>\tptapi\sample\multi_node\inc

Header checkpoint.h <Boot Drive>:\Program Files\NCR\Teradata Parallel Transporter\<version>\tptapi\sample\checkpoint\inc

Teradata Tools and Utilities Installation Guide for Microsoft Windows 117

Page 118: Teradata Tools and Utilities - dbmanagement.infodbmanagement.info/Books/MIX/2407_TeraData.pdf · Teradata Tools and Utilities Installation Guide for Microsoft Windows 7 ... Software

Chapter 5: Verifying the InstallationVerifying the Installation of Individual Products

Header common.h

Mutex.h

PerfTestMessage.h

TestBase.h

TestExport.h

TestLoad.h

TestSim.h

TestStream.h

TestUpdate.h

ThreadTest.h

ThreadTestParameters.h

<Boot Drive>:\Program Files\NCR\Teradata Parallel Transporter\<version>\tptapi\sample\threads\inc

Header DMLGroup.h

Schema.h

Connection.h

<Boot Drive>:\Program Files\NCR\Teradata Parallel Transporter\<version>\tptapi\sample\inc

Header OptionsManager.cpp

OptionsManager.h

<Boot Drive>:\Program Files\NCR\Teradata Parallel Transporter\<version>\tptapi\sample\common

Header checkpoint.cpp

main.cpp

input.txt

infile.littleEndian

checkpoint64.vcproj

checkpoint64.sln

cleanupTables.bteq

setupTables.bteq

<Boot Drive>:\Program Files\NCR\Teradata Parallel Transporter\<version>\tptapi\sample\checkpoint

Header GenericDriver.cpp

main.cpp

input.txt

infile.littleEndian

generic64.vcproj

generic64.sln

cleanupTables.bteq

setupTables.bteq

<Boot Drive>:\Program Files\NCR\Teradata Parallel Transporter\<version>\tptapi\sample\generic

Table 57: 64-bit Teradata Parallel Transporter API (continued)

API: Windows 64-bit platforms

118 Teradata Tools and Utilities Installation Guide for Microsoft Windows

Page 119: Teradata Tools and Utilities - dbmanagement.infodbmanagement.info/Books/MIX/2407_TeraData.pdf · Teradata Tools and Utilities Installation Guide for Microsoft Windows 7 ... Software

Chapter 5: Verifying the InstallationVerifying the Installation of Individual Products

Header BlockLoad.cpp

main.cpp

input.txt

infile.littleEndian

blockload64.vcproj

blockload64.sln

cleanupTables.bteq

setupTables.bteq

<Boot Drive>:\Program Files\NCR\Teradata Parallel Transporter\<version>\tptapi\sample\blockloading

Header multitest.cpp

synchronize.cpp

fileio.cpp

master.cpp

slave.cpp

master_input.txt

slave_input.txt

infilemaster.littleEndian

infileslave.littleEndian.1

multinode64.sln

masternode64.vcproj

slavenode64.vcproj

cleanupTables.bteq

setupTables.bteq

<Boot Drive>:\Program Files\NCR\Teradata Parallel Transporter\<version>\tptapi\sample\multi_node

Table 57: 64-bit Teradata Parallel Transporter API (continued)

API: Windows 64-bit platforms

Teradata Tools and Utilities Installation Guide for Microsoft Windows 119

Page 120: Teradata Tools and Utilities - dbmanagement.infodbmanagement.info/Books/MIX/2407_TeraData.pdf · Teradata Tools and Utilities Installation Guide for Microsoft Windows 7 ... Software

Chapter 5: Verifying the InstallationVerifying the Installation of Individual Products

Header PerfTestMessage.cpp

TelapiThreadTest.cpp

PerfTestMessage.cpp

TelapiThreadTest64.sln

TelapiThreadTest64.vcproj

TestBase.cpp

TestExport.cpp

TestLoad.cpp

TestSim.cpp

TestStream.cpp

TestUpdate.cpp

ThreadTest.cpp

ThreadTestParameters.cpp

Synchronizer.cpp

input.txt

loadData.littleEndian

cleanupTables.bteq

setupTables.bteq

<Boot Drive>:\Program Files\NCR\Teradata Parallel Transporter\<version>\tptapi\sample\threads

Get Buffer GetBuffer.cpp

main.cpp

cleanupTables.bteq

setupTables.bteq

getbuffer64.sln

getbuffer.64vcproj

input.txt

$INSTALLDIR/tptapi/sample/getbuffer

Include GetBuffer.h $INSTALLDIR/tptapi/sample/getbuffer/inc

Table 57: 64-bit Teradata Parallel Transporter API (continued)

API: Windows 64-bit platforms

120 Teradata Tools and Utilities Installation Guide for Microsoft Windows

Page 121: Teradata Tools and Utilities - dbmanagement.infodbmanagement.info/Books/MIX/2407_TeraData.pdf · Teradata Tools and Utilities Installation Guide for Microsoft Windows 7 ... Software

Chapter 5: Verifying the InstallationVerifying the Installation of Individual Products

Verifying Teradata Parallel Transporter Data Connector Operator

Verifying Teradata Parallel Transporter DDL Operator

XSP GenericDriver.cpp

GenericDriver.h

OptionsReader.cpp

OptionsReader.h

xsp.cpp

xsp64.sln

xsp64.vcproj

input.exp

input.lod

input.stm

input.upd

infile.littleEndian

$INSTALLDIR/tptapi/sample/xsp

Table 57: 64-bit Teradata Parallel Transporter API (continued)

API: Windows 64-bit platforms

Table 58: Teradata Parallel Transporter Data Connector Operator

DataConnector Operator: Windows 32-bit platforms

File Type File Name Default Folder

Library dataconop.dll <Boot Drive>:\Program Files\NCR\Teradata Parallel Transporter\<version>\bin

Uninstall UninstDataConnectorOp12.0.isu

<Boot Drive>:\Program Files\NCR\Teradata Parallel Transporter\<version>

Table 59: Teradata Parallel Transporter DDL Operator

DDL Operator: Windows 32-bit platforms

File Type File Name Default Folder

Library ddlop.dll <Boot Drive>:\Program Files\NCR\Teradata Parallel Transporter\<version>\bin

Uninstall UninstDDLOp12.0.isu <Boot Drive>:\Program Files\NCR\Teradata Parallel Transporter\<version>

Teradata Tools and Utilities Installation Guide for Microsoft Windows 121

Page 122: Teradata Tools and Utilities - dbmanagement.infodbmanagement.info/Books/MIX/2407_TeraData.pdf · Teradata Tools and Utilities Installation Guide for Microsoft Windows 7 ... Software

Chapter 5: Verifying the InstallationVerifying the Installation of Individual Products

Verifying Teradata Parallel Transporter Export Operator

Verifying Teradata Parallel Transporter ICU Library

Table 60: 32-bit Teradata Parallel Transporter Export Operator

Export Operator: Windows 32-bit platforms

File Type File Name Default Folder

Library exportop.dll <Boot Drive>:\Program Files\NCR\Teradata Parallel Transporter\<version>\bin

Sample expnfyxt.c <Boot Drive>:\Program Files\NCR\Teradata Parallel Transporter\<version>\sample

Table 61: 64-bit Teradata Parallel Transporter Export Operator

Export Operator: Windows 64-bit platforms

File Type File Name Default Folder

Library exportop.dll <Boot Drive>:\Program Files\NCR\Teradata Parallel Transporter\<version>\bin64

Sample expnfyxt.c <Boot Drive>:\Program Files\NCR\Teradata Parallel Transporter\<version>\sample

Table 62: 32-bit Teradata Parallel Transporter ICU Library Files

ICU Library: Windows 32-bit platforms

File Type File Name Default Folder

Library pxicu.dll

msvcp71.dll

msvcr71.dll

<Boot Drive>:\Program Files\NCR\Teradata Parallel Transporter\<version>\bin

Table 63: 64-bit Teradata Parallel Transporter ICU Library Files

ICU Library: Windows 64-bit platforms

File Type File Name Default Folder

Library pxicu.dll <Boot Drive>:\Program Files\NCR\Teradata Parallel Transporter\<version>\bin64

122 Teradata Tools and Utilities Installation Guide for Microsoft Windows

Page 123: Teradata Tools and Utilities - dbmanagement.infodbmanagement.info/Books/MIX/2407_TeraData.pdf · Teradata Tools and Utilities Installation Guide for Microsoft Windows 7 ... Software

Chapter 5: Verifying the InstallationVerifying the Installation of Individual Products

Verifying Teradata Parallel Transporter Infrastructure

Table 64: Teradata Parallel Transporter Infrastructure Files

Teradata Parallel Transporter Infrastructure: Windows 32-bit platforms

File Type File Name Default Folder

Configuration twbcfg.ini

twboper.ini

<Boot Drive>:\Program Files\NCR\Teradata Parallel Transporter\<version>

Folder checkpoint

logs

<Boot Drive>:\Program Files\NCR\Teradata Parallel Transporter\<version>

Executable coordinator.exe

executor.exe

planexecutor.exe

tbuild.exe

ptmgts.exe

ptmjlgr.exe

ptmlvs.exe

ptmexec.exe

ptmtims.exe

tlogview.exe

twbstat.exe

twbkill.exe

tbuildexe.exe

tlogviewexe.exe

twbcmdexe.exe

twbkillexe.exe

twbstatexe.exe

twbrmcpexe.exe

twbpathexe.exe

tptlaunch.exe

twbpath.exe

twbrmcp.exe

<Boot Drive>:\Program Files\NCR\Teradata Parallel Transporter\<version>\bin

Teradata Tools and Utilities Installation Guide for Microsoft Windows 123

Page 124: Teradata Tools and Utilities - dbmanagement.infodbmanagement.info/Books/MIX/2407_TeraData.pdf · Teradata Tools and Utilities Installation Guide for Microsoft Windows 7 ... Software

Chapter 5: Verifying the InstallationVerifying the Installation of Individual Products

Header pxdtypes.h

pxtypes.h

pxmacros.h

pxoper.h

pxos.h

pxstc.h

pxdef.h

pxlogdef.h

pxutypes.h

pxversion.h

<Boot Drive>:\Program Files\NCR\Teradata Parallel Transporter\<version>\sdk\inc

Library feomop.dll

flimop.dll

logview.dll

mlimop.dll

msvcirt.dll

msvcirtd.dll

msvcp60.dll

msvcp60d.dll

msvcp71.dll

msvcr71.dll

msvcrt.dll

msvcrtd.dll

oncrpc.dll

pxcommon.dll

ptmin.dll

ptmos.dll

ptmpi.dll

ptmpo.dll

<Boot Drive>:\Program Files\NCR\Teradata Parallel Transporter\<version>\bin

Message Catalog twbmsgs.dll <Boot Drive>:\Program Files\NCR\Teradata Parallel Transporter\<version>\msg

Table 64: Teradata Parallel Transporter Infrastructure Files (continued)

Teradata Parallel Transporter Infrastructure: Windows 32-bit platforms

124 Teradata Tools and Utilities Installation Guide for Microsoft Windows

Page 125: Teradata Tools and Utilities - dbmanagement.infodbmanagement.info/Books/MIX/2407_TeraData.pdf · Teradata Tools and Utilities Installation Guide for Microsoft Windows 7 ... Software

Chapter 5: Verifying the InstallationVerifying the Installation of Individual Products

Verifying Teradata Parallel Transporter Load Operator

Sample GT11.txt

GT44.txt

GT62.txt

GT93.txt

GT94.txt

GT95.txt

GT96.txt

GT97.txt

jobvars.txt

<Boot Drive>:\Program Files\NCR\Teradata Parallel Transporter\<version>\sample\etl

Sample sampleoperator.dsw

sampleoperator.dsp

samplefilter.cpp

<Boot Drive>:\Program Files\NCR\Teradata Parallel Transporter\<version>\sdk\src

Sample data.in

samplescript.txt

<Boot Drive>:\Program Files\NCR\Teradata Parallel Transporter\<version>\sdk\sample

Sample sql1.txt

sql2.txt

twb_status.txt

twb_targets.txt

<Boot Drive>:\Program Files\NCR\Teradata Parallel Transporter\<version>\sample\metadata

Uninstall uninst.dll

UninstTTPTInfrastructure12.0.isu

<Boot Drive>:\Program Files\NCR\Teradata Parallel Transporter\<version>

Version Text version <Boot Drive>:\Program Files\NCR\Teradata Parallel Transporter\<version>

Word Document readme.doc <Boot Drive>:\Program Files\NCR\Teradata Parallel Transporter\<version>\sdk

Table 64: Teradata Parallel Transporter Infrastructure Files (continued)

Teradata Parallel Transporter Infrastructure: Windows 32-bit platforms

Table 65: 32-bit Teradata Parallel Transporter Load Operator

Load Operator: Windows 32-bit platforms

File Type File Name Default Folder

Library loadop.dll <Boot Drive>:\Program Files\NCR\Teradata Parallel Transporter\<version>\bin

Sample ldnfyext.c <Boot Drive>:\Program Files\NCR\Teradata Parallel Transporter\<version>\sample

Teradata Tools and Utilities Installation Guide for Microsoft Windows 125

Page 126: Teradata Tools and Utilities - dbmanagement.infodbmanagement.info/Books/MIX/2407_TeraData.pdf · Teradata Tools and Utilities Installation Guide for Microsoft Windows 7 ... Software

Chapter 5: Verifying the InstallationVerifying the Installation of Individual Products

Verifying Teradata Parallel Transporter ODBC Operator

Verifying Teradata Parallel Transporter Operator Support Library

Table 66: 64-bit Teradata Parallel Transporter Load Operator

Load Operator: Windows 64-bit platforms

File Type File Name Default Folder

Library loadop.dll <Boot Drive>:\Program Files\NCR\Teradata Parallel Transporter\<version>\bin64

Sample ldnfyext.c <Boot Drive>:\Program Files\NCR\Teradata Parallel Transporter\<version>\sample

Table 67: Teradata Parallel Transporter ODBC Operator

Teradata Parallel Transporter ODBC Operator: Windows 32-bit platforms

File Type File Name Default Folder

Library odbcop.dll <Boot Drive>:\Program Files\NCR\Teradata Parallel Transporter\<version>\bin

Uninstall UninstODBCOp12.0.isu <Boot Drive>:\Program Files\NCR\Teradata Parallel Transporter\<version>

Table 68: 32-bit Teradata Parallel Transporter Operator Support Library

Operator Support Library: Windows 32-bit platforms

File Type File Name Default Folder

Library opcommon.dll <Boot Drive>:\Program Files\NCR\Teradata Parallel Transporter\<version>\bin

Message Catalog opermsgs.dll <Boot Drive>:\Program Files\NCR\Teradata Parallel Transporter\<version>\msg

Table 69: 64-bit Teradata Parallel Transporter Operator Support Library

Operator Support Library: Windows 64-bit platforms

File Type File Name Default Folder

Library opcommon.dll <Boot Drive>:\Program Files\NCR\Teradata Parallel Transporter\<version>\bin64

Message Catalog opermsgs.dll <Boot Drive>:\Program Files\NCR\Teradata Parallel Transporter\<version>\msg64

126 Teradata Tools and Utilities Installation Guide for Microsoft Windows

Page 127: Teradata Tools and Utilities - dbmanagement.infodbmanagement.info/Books/MIX/2407_TeraData.pdf · Teradata Tools and Utilities Installation Guide for Microsoft Windows 7 ... Software

Chapter 5: Verifying the InstallationVerifying the Installation of Individual Products

Verifying Teradata Parallel Transporter OS Command Operator

Verifying Teradata Parallel Transporter SQL Inserter Operator

Verifying Teradata Parallel Transporter SQL Selector Operator

Table 70: Teradata Parallel Transporter OS Command Operator

OS Command Operator: Windows 32-bit platforms

File Type File Name Default Folder

Library oscmdop.dll <Boot Drive>:\Program Files\NCR\Teradata Parallel Transporter\<version>\bin

Uninstall UninstOSCmdOp12.0.isu <Boot Drive>:\Program Files\NCR\Teradata Parallel Transporter\<version>

Table 71: Teradata Parallel Transporter SQL Inserter Operator

SQL Inserter Operator: Windows 32-bit platforms

File Type File Name Default Folder

Library insertop.dll <Boot Drive>:\Program Files\NCR\Teradata Parallel Transporter\<version>\bin

Uninstall UninstInsertOp12.0.isu <Boot Drive>:\Program Files\NCR\Teradata Parallel Transporter\<version>

Table 72: Teradata Parallel Transporter SQL Selector Operator

SQL Selector Operator: Windows 32-bit platforms

File Type File Name Default Folder

Library selectop.dll <Boot Drive>:\Program Files\NCR\Teradata Parallel Transporter\<version>\bin

Uninstall UninstSelectOp12.0.isu <Boot Drive>:\Program Files\NCR\Teradata Parallel Transporter\<version>

Teradata Tools and Utilities Installation Guide for Microsoft Windows 127

Page 128: Teradata Tools and Utilities - dbmanagement.infodbmanagement.info/Books/MIX/2407_TeraData.pdf · Teradata Tools and Utilities Installation Guide for Microsoft Windows 7 ... Software

Chapter 5: Verifying the InstallationVerifying the Installation of Individual Products

Verifying Teradata Parallel Transporter Stream Operator

Verifying Teradata Parallel Transporter Update Operator

Table 73: 32-bit Teradata Parallel Transporter Stream Operator

Stream Operator: Windows 32-bit platforms

File Type File Name Default Folder

Library streamop.dll <Boot Drive>:\Program Files\NCR\Teradata Parallel Transporter\<version>\bin

Sample stmnfyxt.c <Boot Drive>:\Program Files\NCR\Teradata Parallel Transporter\<version>\sample

Table 74: 64-bit Teradata Parallel Transporter Stream Operator

Stream Operator: Windows 64-bit platforms

File Type File Name Default Folder

Library streamop.dll <Boot Drive>:\Program Files\NCR\Teradata Parallel Transporter\<version>\bin64

Sample stmnfyxt.c <Boot Drive>:\Program Files\NCR\Teradata Parallel Transporter\<version>\sample

Table 75: 32-bit Teradata Parallel Transporter Update Operator

Update Operator: Windows 32-bit platforms

File Type File Name Default Folder

Library updateop.dll <Boot Drive>:\Program Files\NCR\Teradata Parallel Transporter\<version>\bin

Sample updnfyxt.c <Boot Drive>:\Program Files\NCR\Teradata Parallel Transporter\<version>\sample

Table 76: 64-bit Teradata Parallel Transporter Update Operator

Update Operator: Windows 64-bit platforms

File Type File Name Default Folder

Library updateop.dll <Boot Drive>:\Program Files\NCR\Teradata Parallel Transporter\<version>\bin64

Sample updnfyxt.c <Boot Drive>:\Program Files\NCR\Teradata Parallel Transporter\<version>\sample

128 Teradata Tools and Utilities Installation Guide for Microsoft Windows

Page 129: Teradata Tools and Utilities - dbmanagement.infodbmanagement.info/Books/MIX/2407_TeraData.pdf · Teradata Tools and Utilities Installation Guide for Microsoft Windows 7 ... Software

Chapter 5: Verifying the InstallationVerifying the Installation of Individual Products

Verifying Teradata Parallel Transporter Wizard

Table 77: Teradata Parallel Transporter Wizard

Teradata Parallel Transporter Wizard: Windows 32-bit platforms

File Type File Name Default Folder

Configuration tptwizard.properties <Boot Drive>:\Program Files\NCR\Teradata Parallel Transporter\<version>\tptwizard\config

Directory jre

help

<Boot Drive>:\Program Files\NCR\Teradata Parallel Transporter\<version>\tptwizard

Java Binary tdgssjava.jar

terajdbc4.jar

tptwizard.jar

tdgssconfig.jar

<Boot Drive>:\Program Files\NCR\Teradata Parallel Transporter\<version>\tptwizard\jars

Icon tptwizard.ico <Boot Drive>:\Program Files\NCR\Teradata Parallel Transporter\<version>\tptwizard

Library guisrv.dll

wwhelp.dll

<Boot Drive>:\Program Files\NCR\Teradata Parallel Transporter\<version>\bin

Startup runtbuild.cmd

tptwizard.cmd

<Boot Drive>:\Program Files\NCR\Teradata Parallel Transporter\<version>\tptwizard

Transformation attributes.twb.xsl

base.twb.xsl

columns.twb.xsl

dbms.twb.xsl

file.twb.xsl

job.twb.xsl

jobstep.twb.xsl

logger.twb.xsl

logview.twb.xsl

objects.twb.xsl

operation.twb.xsl

operator.twb.xsl

schema.twb.xsl

table.twb.xsl

tableset.twb.xsl

<Boot Drive>:\Program Files\NCR\Teradata Parallel Transporter\<version>\tptwizard\transformation

Uninstall UninstTPTWizard12.0.isu

<Boot Drive>:\Program Files\NCR\Teradata Parallel Transporter\<version>\tptwizard

Teradata Tools and Utilities Installation Guide for Microsoft Windows 129

Page 130: Teradata Tools and Utilities - dbmanagement.infodbmanagement.info/Books/MIX/2407_TeraData.pdf · Teradata Tools and Utilities Installation Guide for Microsoft Windows 7 ... Software

Chapter 5: Verifying the InstallationVerifying the Installation of Individual Products

Verifying Teradata Query Scheduler Administrator

Verifying Teradata Query Scheduler Client

Verifying Teradata Query Scheduler Server

Table 78: Teradata Query Scheduler Administrator 32-bit Files

Teradata Query Scheduler Administrator for Windows 32-bit platforms

File Type File Name Default Folder

Executable tdqsadm.exe

tdqmdb.exe

<Program Files>\NCR\Teradata Query Scheduler Admin 12.00.00(Program Files can be configured by the system administrator to be on a drive other than the boot drive.)

Readme readme.txt <Program Files>\NCR\Teradata Query Scheduler Admin 12.00.00

Table 79: Teradata Query Scheduler Client 32-bit Files

Teradata Query Scheduler Client for Windows 32-bit platforms

File Type File Name Default Folder

Executable tdqmcomm.exe

tdqmops.exe

tdqmview.exe

<Boot Drive>:\Program Files\NCR\Teradata Query Scheduler\client

Library tdqmcomm.dll

tdqmsr.dll

tdqmsubm.dll

%SystemRoot%\system32

Readme readme.txt <Boot Drive>:\Program Files\NCR\Teradata Query Scheduler\client

Table 80: Teradata Query Scheduler Server 32-bit Files

Teradata Query Scheduler Server for Windows 32-bit platforms

File Type File Name Default Folder

Executable tdqmjob.exe

tdqmlsnr.exe

tdqmreqp.exe

tdqmserv.exe

<Boot Drive>:\Program Files\NCR\Teradata Query Scheduler\server

Library tdqmserv.dll

tdsqlprs.dll

%SystemRoot%\system32

130 Teradata Tools and Utilities Installation Guide for Microsoft Windows

Page 131: Teradata Tools and Utilities - dbmanagement.infodbmanagement.info/Books/MIX/2407_TeraData.pdf · Teradata Tools and Utilities Installation Guide for Microsoft Windows 7 ... Software

Chapter 5: Verifying the InstallationVerifying the Installation of Individual Products

Verifying Teradata TPump

Verifying WebSphere MQ Access Module

Verifying Teradata Workload Analyzer

Parser sqlprs.dfa

sqlprs.llr

<Boot Drive>:\Program Files\NCR\Teradata Query Scheduler\server

Table 80: Teradata Query Scheduler Server 32-bit Files (continued)

Teradata Query Scheduler Server for Windows 32-bit platforms

Table 81: Teradata TPump 32-bit Files

Teradata TPump for Windows 32-bit platforms

File Type File Name Default Folder

Executable tpump.exe <Boot Drive>:\Program Files\NCR\Teradata Client\bin

Sample tdatpump.cfg

tldnfyxt.c

tpumpar.csql

tpumpimd.c

<Boot Drive>:\Program Files\NCR\Teradata Client\tpump

Table 82: WebSphere MQ Access Module

WebSphere MQ Access Module for Windows 32-bit platforms

File Type File Name Default Folder

Library libmqs.dll

libmqsc.dll

libmqsTWB.dll

libmqscTWB.dll

<Boot Drive>:\Program Files\Common Files\NCR\AXSMOD

Table 83: Teradata Workload Analyzer Files

Teradata Workload Analyzer for Windows 32-bit platforms

File Type File Name Default Folder

Executable twa.exe

Verify.exe

verify.dat

<Boot Drive>:\Program Files\NCR\Teradata Workload Analyzer 12.0

Teradata Tools and Utilities Installation Guide for Microsoft Windows 131

Page 132: Teradata Tools and Utilities - dbmanagement.infodbmanagement.info/Books/MIX/2407_TeraData.pdf · Teradata Tools and Utilities Installation Guide for Microsoft Windows 7 ... Software

Chapter 5: Verifying the InstallationVerifying the Installation Using the CLI Sample Program, clisamp

Verifying the Installation Using the CLI Sample Program, clisamp

Another way to verify that you have installed the software properly is to run the sample CLI application, clisamp. The program and its makefile were copied over during installation of the software. Perform the following steps to verify the installation:

1 Modify the makefile makesamp.win with the correct paths to the include files. By default the makesamp.win file is located in:

<Boot Drive>:\ Program Files\NCR\Teradata Client\cli\clisamp.

2 Execute the makefile to create the executable module clisamp:

# nmake -f makesamp.win

The default configuration is CFG=“clisamp - Win32 Debug.” Other supported configurations are “clisamp - Win32 Release” and the 64-bit configurations “clisamp - Win32 IA64Release” and “clisamp - Win32 IA64Debug.” The 64-bit configurations must use the correct environment for 64-bit development.

3 Execute the sample program by entering one of the following commands at the command prompt (change to the appropriate folder first: Release, Debug, IA64Release, or IA64Debug):

To run the sample program using the default logon information (dbc/systemfe,service) enter:

# clisamp

Library fspread.dll

mfc71.dll

mfc71u.dll

mgrcli.dll

monpm.dll

msvcp71.dll

msvcr80.dll

ncrtmgr.dll

psload.dll

tdapp.dll

tdis.dll

tdmfcis.dll

tdwmutil.dll

tm_dialogs.dll

<Boot Drive>:\Program Files\NCR\Teradata Workload Analyzer 12.0

Table 83: Teradata Workload Analyzer Files (continued)

Teradata Workload Analyzer for Windows 32-bit platforms

132 Teradata Tools and Utilities Installation Guide for Microsoft Windows

Page 133: Teradata Tools and Utilities - dbmanagement.infodbmanagement.info/Books/MIX/2407_TeraData.pdf · Teradata Tools and Utilities Installation Guide for Microsoft Windows 7 ... Software

Chapter 5: Verifying the InstallationVerifying the Installation Using the CLI Sample Program, clisamp

To show help for the sample program, use the -h option, enter:

# clisamp -h

To run the sample program, using a user provided input string (TDPID= slugger, user=dbc, password=dbc), enter:

# clisamp slugger/dbc,dbc

4 The program will log on to the default dbccop1 (no user input supplied) specified in the hosts file and execute a simple query - “SELECT * from dbc.sessioninfo;” and write the output to DAT clisamp.dat file. A display similar to the following appears:

# clisampCLIv2 version is 12.00.00.00MTDP version is 12.00.00.00MOSIOS version is 12.00.00.00MOSIDEP version is 12.00.00.00OSERR version is 12.00.00.00Logging on to --->dbc/systemfe,servicewriting out to--> CLISAMP.DATsubmitting -->select* from dbc.sessioninfo;writing out to --> CLISAMP.DATLogging off.

Teradata Tools and Utilities Installation Guide for Microsoft Windows 133

Page 134: Teradata Tools and Utilities - dbmanagement.infodbmanagement.info/Books/MIX/2407_TeraData.pdf · Teradata Tools and Utilities Installation Guide for Microsoft Windows 7 ... Software

Chapter 5: Verifying the InstallationVerifying the Installation Using the CLI Sample Program, clisamp

134 Teradata Tools and Utilities Installation Guide for Microsoft Windows

Page 135: Teradata Tools and Utilities - dbmanagement.infodbmanagement.info/Books/MIX/2407_TeraData.pdf · Teradata Tools and Utilities Installation Guide for Microsoft Windows 7 ... Software

CHAPTER 6

Connecting to a Teradata Database

This chapter describes how to connect to a Teradata Database.

Note: The figures shown in this document are examples only. Depending on the Teradata Tools and Utilities products used in your installation, some dialogs might vary from those shown in this guide.

The section topics are:

• Making the Database Connection

• Connecting in GUI Applications

• Connecting in Command Line Driven Applications

• Connecting to a Teradata Database Programmatically

• Logon Error Messages

Making the Database Connection

This section describes:

• how to connect to a Teradata Database from a GUI application.

• how to connect to a Teradata Database from a command line application.

• where to find the information to programmatically connect to a Teradata Database.

For programmatic interfaces, the User or Reference guide for the specific product provides information about the product interface.

Overview of Logon Procedures

You can provide the logon string while logging on to a Teradata Database if the application allows it. If the application does not provide all the logon information, a Connect to Teradata Database dialog will be displayed that allows you to enter the missing logon information.

Note: If the environment variable GUILOGON is set to NO, the Connect to Teradata Database dialog box will not be displayed, allowing the application to log on to the Teradata Database without prompting for the password.

If the Connect to Teradata Database dialog is displayed, all application-provided parameters are automatically entered into the dialog fields. If the information is incorrect, you can change the value entered in any field. After entering required and optional logon information press Enter or click OK to continue logging on.

Teradata Tools and Utilities Installation Guide for Microsoft Windows 135

Page 136: Teradata Tools and Utilities - dbmanagement.infodbmanagement.info/Books/MIX/2407_TeraData.pdf · Teradata Tools and Utilities Installation Guide for Microsoft Windows 7 ... Software

Chapter 6: Connecting to a Teradata DatabaseMaking the Database Connection

The user logon exit routine can be used to manipulate the fields of the Connect to Teradata Database dialog.

Connecting in GUI Applications

This section describes how to connect to a Teradata Database using the Connect to Teradata Database dialog from a Graphical User Interface (GUI) application. The procedure is for a typical application. See your product User or Reference guide for specific information about an individual product.

Procedure - Connect to a Teradata Database

To connect to a Teradata Database, perform the following procedure:

1 If the application you are trying to connect to the database has a Connectivity tab in the Tools options menu, select WinCLI or ODBC.

2 Click the Connect button. The Connect to Teradata Database dialog appears.

3 Select or enter the appropriate values for the database to which you are connecting.

4 Click OK.

Connect to Teradata Database Dialog

The following figure shows the Connect to Teradata Database dialog:

Figure 1: Typical Connect to Teradata Database Dialog

136 Teradata Tools and Utilities Installation Guide for Microsoft Windows

Page 137: Teradata Tools and Utilities - dbmanagement.infodbmanagement.info/Books/MIX/2407_TeraData.pdf · Teradata Tools and Utilities Installation Guide for Microsoft Windows 7 ... Software

Chapter 6: Connecting to a Teradata DatabaseMaking the Database Connection

The fields in the Connect to Teradata Database dialog are:

Note: Even though the UserId and Password parameters are required to log on to the Teradata Database, you do not have to enter them in the Connect to Teradata Database dialog box since they will be filled in by the user logon exit routine.

Field Name Definition

Database Name (Required) Enter a valid Teradata Database name, or you can also select a Teradata Database Name that you previously entered from the drop down list. This is the name of the database with which you want to connect.

Authentication Mechanism

(Required) Select the authentication mechanism specified by your system administrator from the list of authentication mechanisms provided in the drop down list. The Authentication Mechanism identifies the mechanism used for connections to the data source.

Valid authentication mechanism values are:

• Empty - If no Authentication Mechanism is listed in the drop down list, or if the Authentication Mechanism selected is not supported, the mechanism used is the system default.

• TD1 - Teradata 1 mechanism.

• TD2 - Teradata 2 mechanism.

• ldap - ldap mechanism.

• KRB5 - Kerberos mechanism.

• KRB5C - Kerberos Compatibility mechanism.

• NTLM - NT LAN Manager mechanism.

• NTLMC - NT LAN Manager Compatibility mechanism.

• Other - user-defined mechanism.

Authentication Parameter

(Optional) Enter the parameters required by the selected authentication mechanism. See your System Administrator.

User Name (Required) Select your user name from the drop down list, or enter a valid user name.

Password (Required) Enter your Password for the user name you entered.

Default Database (Optional) Select the default database for the session.

Account String (Optional) Enter a new Account String or select an account string from the drop down list.

The Account String is used to create a user in a Teradata Database, instead of providing account information during configuration of ODBC. It allows Teradata to isolate users, to find out what applications users are running, or to restrict users trying to connect to the database.

Teradata Tools and Utilities Installation Guide for Microsoft Windows 137

Page 138: Teradata Tools and Utilities - dbmanagement.infodbmanagement.info/Books/MIX/2407_TeraData.pdf · Teradata Tools and Utilities Installation Guide for Microsoft Windows 7 ... Software

Chapter 6: Connecting to a Teradata DatabaseMaking the Database Connection

Connecting in Command Line Driven Applications

This section describes how to connect to a Teradata Database from the command line.

Procedure - Connecting in Command Line Driven Applications

Follow these steps to connect to a Teradata Database from the command line.

1 Enter the .logmech command.

2 Enter the .logdata command.

3 Enter the .logon command.

.logmech Command

The .logmech command identifies the desired logon authentication mechanism (logmech_name_string). The logmech_name_string is limited to 8 bytes and is not case-sensitive.

The syntax for the .logmech command is:

.logmech logmech_name_string

The logmech_name_string supports the following values

• None - If no Authentication Mechanism is entered, or if the Authentication Mechanism selected is not supported, the system will default to TD2.

• TD1 - Teradata 1 mechanism.

• TD2 - Teradata 2 mechanism.

• LDAP - ldap mechanism.

• KRB5 - Kerberos mechanism.

• KRB5C - Kerberos Compatibility mechanism.

• NTLM - NT LAN Manager mechanism.

• NTLMC - NT LAN Manager Compatibility mechanism.

.logdata Command

To successfully authenticate the user, the .logdata command provides all the parameters needed by the authentication mechanism, other than a UserId and Password. The information is entered into and passed by the logdata_string. The logdata_string is limited to 64K bytes.

The syntax for the .logdata command is:

.logdata logdata_string;

If the logdata_string has white space characters or the other special characters embedded, the entire logdata string must be delimited with single quotes:

.logdata ‘logdata_string’;

The exact contents of the logdata_string will vary according to the selected authentication mechanism. The string is not displayed, parsed, nor otherwise processed by the application.

138 Teradata Tools and Utilities Installation Guide for Microsoft Windows

Page 139: Teradata Tools and Utilities - dbmanagement.infodbmanagement.info/Books/MIX/2407_TeraData.pdf · Teradata Tools and Utilities Installation Guide for Microsoft Windows 7 ... Software

Chapter 6: Connecting to a Teradata DatabaseMaking the Database Connection

.logon Command

The syntax for the .logon command is:

.logon <DBCName></><UserId><,><Password><,><AccountId>

Example Logons from the Command Line

Supported Mechanisms

In general, mechanisms which perform authentication and validation do not require that a Teradata Database Username and Password be included as part of the logon string. If these items are provided in conjunction with an authentication mechanism, they are ignored.

The following authentication mechanisms are supported:

Kerberos

In all environments that support Kerberos, you can provide a UserId, Password, and a Domain or a Realm. The Domain or Realm must be supplied separately as authentication mechanism data.

Once the user’s identity has been verified by Kerberos, an implicit logon will proceed using the tendered UserId as the Teradata Username:

.logmech KRB5

.logdata [email protected]@@mypassword

.logon mydbs/

For single-Domain environments, the gateway can be configured so that the Domain or Realm do not need to be supplied:

.logmech KRB5

.logdata joe@@mypassword

.logon mydbs/

Parameter Definition

DBCName (Required) The DBCName is also referred to as the TDIPD (Teradata Director Program ID). It identifies a particular Teradata Database.

If no identifier is specified, the value of this field is copied from the clispb.dat field, i_dbcpat.

DBCName is not case sensitive.

UserId (Required) The UserId or user name string can be up to 30 characters long. The first character cannot be a numeric character. The UserId is not case sensitive.

Password (Required) The Password string can be up to 30 characters long. The first character cannot be a numeric character. In the dialog box, each character of the Password is displayed with an asterisk (*). The Password is not case sensitive.

AccountId (Optional) - The AccountId is required only if there is a comma after the Password field. The first character cannot be a numeric character. Do not enter the single quote (') that normally surrounds an AccountId. The AccountId is not case sensitive.

Teradata Tools and Utilities Installation Guide for Microsoft Windows 139

Page 140: Teradata Tools and Utilities - dbmanagement.infodbmanagement.info/Books/MIX/2407_TeraData.pdf · Teradata Tools and Utilities Installation Guide for Microsoft Windows 7 ... Software

Chapter 6: Connecting to a Teradata DatabaseMaking the Database Connection

Alternatively, a Kerberos-mediated SSO-style logon can be used by omitting either the UserId, Password and a Domain or a Realm. In this case, Kerberos uses the security credentials associated with the current client session:

.logmech KRB5

.logon mydbs/

If required, Teradata accounting information may be included as part of .logon command as follows:

.logmech KRB5

.logdata [email protected]@@mypassword

.logon mydbs/,,2345889909

or

.logmech KRB5

.logdata joe@@mypassword

.logon mydbs/,,2345889909

or

.logmech KRB5

.logon mydbs/,,2345889909

In all of the above cases, a Teradata Username must be defined in the target Teradata Database that matches the actual or derived UserId. Further, the Username must have previously been granted the “logon with null password privilege.”

Note: The special “dbc” username cannot be used with Kerberos authentication mechanism since “dbc” cannot be granted the “logon with null password privilege.” If the “dbc” username is passed, the Teradata Database will return error 3790.

KRB5C

The KRB5C mechanism is maintained for compatibility purposes with Teradata Tools and Utilities 8.1 communicating with a pre-V2R6 Teradata Database that supports SSO and logon encryption. It should not generally be specified.

The teraSSO library will automatically determine the appropriate authentication mechanism when interfacing to such a Teradata Database using the same logic as employed in Teradata Tools and Utilities 7.1.

• Windows clients should use NTLMC or KRB5C for SSO.

• For non-SSO, Windows clients use TD1.

• Non-Windows clients should use TD1.

In the event a user manually selects an incompatible mechanism, TERASSO_SECPKGMATCH_FAIL will be returned.

NTLM

The NTLM authentication mechanism should be used in Windows-to-Windows environments only. You can provide a UserId, Password, and Domain. Once the user’s identity has been verified by NTLM, an implicit logon will proceed using the tendered UserId as the Teradata Username.

.logmech NTLM

140 Teradata Tools and Utilities Installation Guide for Microsoft Windows

Page 141: Teradata Tools and Utilities - dbmanagement.infodbmanagement.info/Books/MIX/2407_TeraData.pdf · Teradata Tools and Utilities Installation Guide for Microsoft Windows 7 ... Software

Chapter 6: Connecting to a Teradata DatabaseMaking the Database Connection

.logdata [email protected]@@mypasswordjoe

.logon mydbs/

For single-Domain environments, the gateway can be configured so that the Domain or Realm need not be indicated:

.logmech NTLM

.logdata joe@@mypasswordjoe

.logon mydbs/

Alternatively, an NTLM-mediated SSO-style logon can be used by omitting the UserId, Domain, and Password, or omitting the UserId, Password, and either the Domain or the Realm.

In this second case, NTLM uses the security credentials associated with the current client session:

.logmech NTLM

.logon mydbs/

If required, you can include Teradata accounting information as part of .logon command as follows:

.logmech NTLM

.logdata [email protected]@@mypassword

.logon mydbs/,,2345889909

or

.logmech NTLM

.logdata joe@@mypassword

.logon mydbs/,,2345889909

or

.logmech NTLM

.logon mydbs/,,2345889909

In all of the above cases, a Teradata Username defined in the target Teradata Database must exist. The Username must match the actual or derived UserId and must have previously been granted the “logon with null password privilege. “

Note: The special “dbc” username cannot be used with the NTLM authentication mechanism since “dbc” cannot be granted the “logon with null password privilege.” If “dbc” is passed as the username, the Teradata Database will return error 3790.

For compatibility purposes, this is equivalent to the existing SSO feature. The existing third-party sign-on variant of SSO (NTLM only) is supported for compatibility purposes. However, it is recommended that new applications should use the logmech_name, logmech_data_ptr, and logmech_data_len fields in DBCAREA instead.

NTLMC

The NTLMC authentication mechanism is maintained for compatibility purposes only for Teradata Tools and Utilities 8.1 communication with a pre-V2R6 Teradata Database that supports SSO and logon encryption. You should not generally specify the NTLMC authentication mechanism.

Teradata Tools and Utilities Installation Guide for Microsoft Windows 141

Page 142: Teradata Tools and Utilities - dbmanagement.infodbmanagement.info/Books/MIX/2407_TeraData.pdf · Teradata Tools and Utilities Installation Guide for Microsoft Windows 7 ... Software

Chapter 6: Connecting to a Teradata DatabaseMaking the Database Connection

The teraSSO library automatically determines the appropriate mechanism when interfacing to a Teradata Database, and uses the same logic as employed in Teradata Tools and Utilities 7.1.

• Windows clients should use NTLMC or KRB5C for SSO.

• For non-SSO, Windows clients should use TD1.

• Non-Windows clients should use TD1.

In the event a user manually selects an incompatible mechanism, TERASSO_SECPKGMATCH_FAIL will be returned.

LDAP

The LDAP authentication mechanism allows a user to be authenticated via LDAP and, optionally, to assume a role or user identity other than his or her own, as allowed by the appropriate directory settings.

The user may supply a UserId, Password, and Domain or Realm. The exact contents of the LDAP .logdata information necessarily depends largely upon how the site is using LDAP, and how LDAP has been configured. The samples below are generic examples. Once the user’s identity has been verified by LDAP, an implicit logon will proceed using the UserId as the Teradata username:

.logmech LDAP

.logdata domain7authcid=joe password=password real=myrealm

.logon mydbs/joe,password

If required, Teradata accounting information may be included as part of .logon command as follows:

.logmech LDAP

.logdata authcid=joe password=password real=myrealm

.logon mydbs/,,2345889909

If the directory maps the UserId to a specific Teradata Username, that Username must be defined in the target Teradata Database and must have previously been granted the “logon with null password privilege.”

Once the user’s identity has been verified by LDAP, an implicit logon will proceed using the tendered UserId as the Teradata Username.

Note: The special “dbc” Username cannot be used with the LDAP authentication mechanism since “dbc” cannot be granted the “logon with null password privilege.” If “dbc” is used as the username, the Teradata Database will return error 3790.

If the directory does not map the UserId to a specific Teradata Username, a generic username will be used and a role assigned. The role will be derived from information contained in the directory. Logon will be by extended logon.

.logdata information must always be provided for the LDAP authentication mechanism.

TD1 and TD2

TD1 and TD2 represent the Teradata mechanisms. They do not perform any authentication. Rather, they facilitate encryption/decryption for sessions connected absent the mediation of extended security. Therefore, a valid Teradata Username and Password are always required.

142 Teradata Tools and Utilities Installation Guide for Microsoft Windows

Page 143: Teradata Tools and Utilities - dbmanagement.infodbmanagement.info/Books/MIX/2407_TeraData.pdf · Teradata Tools and Utilities Installation Guide for Microsoft Windows 7 ... Software

Chapter 6: Connecting to a Teradata DatabaseMaking the Database Connection

• Only TD1 is used by Teradata Tools and Utilities 7.1.

• TD2 is used by Teradata Tools and Utilities 8.0 and later for the V2R6.0 Teradata Database and later.

• TD1 is used by Teradata Tools and Utilities 8.0 and above for the V2R5.1 Teradata Database.

The difference between the two mechanisms is that the encryption key for TD2 is longer and, therefore, offers a higher degree of security than that of TD1. For TD2, there should be no .logdata parameter; if one is passed to CLIv2, it will be ignored.

TD2 is the default mechanism for the server-based XML configuration file:

.logmech TD2

.logon mydbs/rhh,password

TD1

TD1 is a deprecated mechanism used by Teradata Tools and Utilities 7.1. It is also used by Teradata Tools and Utilities 8.0 when communicating with a V2R5.x Teradata Database. The difference between the two mechanisms is that the encryption key for TD2 is longer and, therefore, offers a higher degree of security than that of TD1.

The TD1 authentication mechanism is maintained for compatibility purposes only for Teradata Tools and Utilities 8.0 communication with a V2R5.x Teradata Database. Generally, it should not be specified.

The teraSSO library automatically determines the appropriate mechanism when interfacing to a V2R5.x Teradata Database, using the same logic as used in Teradata Tools and Utilities 7.1.

• Windows clients should use NTLMC or KRB5C for SSO.

• For non-SSO, Windows clients should use TD1.

In the event a user manually selects an incompatible mechanism, TERASSO_SECPKGMATCH_FAIL will be returned.

Teradata Tools and Utilities Installation Guide for Microsoft Windows 143

Page 144: Teradata Tools and Utilities - dbmanagement.infodbmanagement.info/Books/MIX/2407_TeraData.pdf · Teradata Tools and Utilities Installation Guide for Microsoft Windows 7 ... Software

Chapter 6: Connecting to a Teradata DatabaseMaking the Database Connection

Single Sign-On Legacy Considerations

In order to provide backward compatibility with pre-Teradata Tools and Utilities 8.0 applications which use SSO, the following items will apply:

Type Description

Direct sign-on If you do not supply a Username and Password as part of the Teradata logon string,

AND

no authentication mechanism name is specified in .logmech, the client interface will not use the default mechanism.

Rather, it will first determine if the Kerberos mechanism is available. If the Kerberos authentication mechanism is available, the client interface will use it.

If the Kerberos interface is not available, the client interface will next determine if the NTLM authentication mechanism is available. If the NTLM authentication mechanism is available, it will use it.

If neither the NTLM nor the Kerberos authentication mechanism is available, the logon attempt will fail.

If .logmech is specified, and the authentication mechanism turns out to be different from the one automatically determined by the client interface, an error will be returned.

Third-party sign-on If an application uses the programmatic third-party sign-on capability using the CLIv2 DBCAREA extension

AND

no authentication mechanism name is specified in logmech_name, the client interface will not use the default authentication mechanism.

Rather, the client interface will first determine if the Kerberos authentication mechanism is available. If the Kerberos authentication mechanism is available, the client interface will use it.

If the Kerberos authentication mechanism is not available, the client interface will next determine if the NTLM authentication mechanism is available. If the NTLM authentication mechanism is available, it will use it.

If neither the NTLM nor the Kerberos authentication method is available, the logon attempt will fail.

If .logmech is specified, and the authentication mechanism turns out to be different from the one automatically determined by the client interface, an error will be returned.

144 Teradata Tools and Utilities Installation Guide for Microsoft Windows

Page 145: Teradata Tools and Utilities - dbmanagement.infodbmanagement.info/Books/MIX/2407_TeraData.pdf · Teradata Tools and Utilities Installation Guide for Microsoft Windows 7 ... Software

Chapter 6: Connecting to a Teradata DatabaseMaking the Database Connection

Connecting to a Teradata Database Programmatically

Several Teradata Tools and Utilities products allow you to programmatically connect to the Teradata Database using SQL and APIs.

Product Document

ODBC Driver for Teradata ODBC Driver for Teradata User Guide.

Describes SQL Connect, SQLDriverConnect, and SQLBrowseConnect and the parameters implemented for security. Includes information on configuring the ODBC Driver for Teradata.

OLE DB Provider for Teradata OLE DB Provider for Teradata Installation and User Guide.

Describes the security implemented for the OLE DB Provider for Teradata.

Teradata Call-Level Interface version 2 (CLIv2)

Teradata Call-Level Interface Version 2 Reference for Network-Attached Systems.

Describes the CLI APIs implemented for security.

Teradata Driver for the JDBC Interface Teradata Driver for the JDBC Interface User Guide.

Describes the security methods implemented for the type 4 driver and illustrates how to connect to the Teradata Database using the Teradata Driver for the JDBC Interface.

Teradata Tools and Utilities Installation Guide for Microsoft Windows 145

Page 146: Teradata Tools and Utilities - dbmanagement.infodbmanagement.info/Books/MIX/2407_TeraData.pdf · Teradata Tools and Utilities Installation Guide for Microsoft Windows 7 ... Software

Chapter 6: Connecting to a Teradata DatabaseMaking the Database Connection

Logon Error Messages

The following error messages apply to the logon and database connection function:

Authentication Mechanism Connection Error

If there is an error in the authentication mechanism selected, “External authentication is not currently allowed” may appear.

If you receive this message, you have selected an incorrect authentication mechanism. Reselect it using the authentication mechanism provided to you by you database administrator and try to connect again.

Error Message

UTY1652 Logon mechanism is not supported in the version of CLI.

Explanation: The user specified an option that needs to use the logon authentication mechanism feature but this feature is not supported in the version of CLI.

Generated by: UTYMSG

Remedy: Remove specified logon mechanism options.

UTY6668 Invalid use of the .LOGMECH statement.

Explanation: It is invalid to specify the .LOGMECH statement after the .LOGON statement.

Generated by: UTYMSG

Remedy: Remove the invalid statement and resubmit the program.

UTY6669 Invalid use of the .LOGDATA statement.

Explanation: It is invalid to specify the .LOGDATA statement after the .LOGON statement.

Generated by: UTYMSG

Remedy: Remove the invalid statement and resubmit the program.

UTY6670 A .LOGMECH statement has been previously specified, terminating.

Explanation: A .LOGMECH statement has already been processed.

Generated by: UTYMSG

Remedy: Remove the extra statement and resubmit the program.

UTY6671 A .LOGDATA statement has been previously specified, terminating.

Explanation: A .LOGDATA statement has already been processed.

Generated by: UTYMSG

Remedy: Remove the extra statement and resubmit the program.

146 Teradata Tools and Utilities Installation Guide for Microsoft Windows

Page 147: Teradata Tools and Utilities - dbmanagement.infodbmanagement.info/Books/MIX/2407_TeraData.pdf · Teradata Tools and Utilities Installation Guide for Microsoft Windows 7 ... Software

CHAPTER 7

Troubleshooting

This chapter gives tips on troubleshooting the Teradata Tools and Utilities installation. If you are unable to resolve a problem after reading this chapter, refer to “Technical Assistance” on page 147.

Problems may fall into one of these categories:

• Client Computer Problems

• Network Problems

• Software Problems

• Teradata Database Hardware Problems

Be aware, however, that a problem can overlap these categories, and that more than one problem can occur simultaneously.

Result codes are also included in this chapter:

• Silent Installation Result Codes

Technical Assistance

If you cannot resolve a problem, contact the Teradata Solutions Customer Services Remote Services Center (TSCS-RSC). For contact information, refer to the Teradata Tools and Utilities Release Definition, Release 12.0.

Client Computer Problems

To determine whether a problem is with your client computer, perform the following checks. You may not have to do all of them.

Cannot Communicate Over the Network with Teradata Database

To confirm that your client computer can communicate over the network to the Teradata Database, ping the Teradata Database by opening a command window and typing:

ping dbcnameCOPn

You should receive a response similar to the following:

Pinging cs5100s.sandiegoca.ncr.com [153.64.116.94] with 32 bytes of data:

Teradata Tools and Utilities Installation Guide for Microsoft Windows 147

Page 148: Teradata Tools and Utilities - dbmanagement.infodbmanagement.info/Books/MIX/2407_TeraData.pdf · Teradata Tools and Utilities Installation Guide for Microsoft Windows 7 ... Software

Chapter 7: TroubleshootingClient Computer Problems

Reply from 153.64.116.94: bytes=32 time=60ms TTL=60Reply from 153.64.116.94: bytes=32 time=40ms TTL=60Reply from 153.64.116.94: bytes=32 time=30ms TTL=60Reply from 153.64.116.94: bytes=32 time=50ms TTL=60Ping statistics for 153.64.116.94:

Packets: Sent = 4, Received = 4, Lost = 0 (0% loss),Approximate round trip times in milli-seconds:

Minimum = 30ms, Maximum = 60ms, Average = 45ms

Use a second test to verify communication to the Teradata Database by entering the following at the command prompt:

telnet dbcnameCOPn

If your telnet service is disabled, you should receive the following response:

telnet: connect: Connection refused

If the connection is successful, you should receive a response similar to the following:

Welcome to the NCR MP-RAS SVR4 UNIX SystemUNIX System V Release 4.0 (cs5100s) (pts/0)login:

If you do not receive one of these responses, consult the next section, “Network Problems” on page 150.

Note: dbcnameCOPn should be upper or lower case.

Incorrect Path Name in COPLIB

Check that the environment variable COPLIB has the correct path name to the CLI system parameter block file, clispb.dat.

COPLIB is not set during installation.

File localisation.dll Could Not Be Opened

If the localisation.dll file is missing, this message appears:

"File "localisation.dll" could not be opened.There may be problems with your installation.Exiting..."

Please check your installation, and make sure that the environmental variable PATH contains the folder in which the localisation.dll file resides.

File icuuctd28.dll Could Not Be Found

If the icuuctd28.dll file is missing, this message appears:

The dynamic link library icuuctd28.dll could not be found in the sprecified path.

Make sure the environment variable PATH contains the folder where icuuctd28.dll is located.

148 Teradata Tools and Utilities Installation Guide for Microsoft Windows

Page 149: Teradata Tools and Utilities - dbmanagement.infodbmanagement.info/Books/MIX/2407_TeraData.pdf · Teradata Tools and Utilities Installation Guide for Microsoft Windows 7 ... Software

Chapter 7: TroubleshootingClient Computer Problems

Incorrect Path Name in COPANOMLOG

If you wish to produce an anomaly log file, check that the environment variable COPANOMLOG has the correct path name to the anomaly log file.

Incorrect CLIv2 Libraries Referenced

CLIv2, WinCLI Runtime, and the WinCLI Developer's Kit install CLIv2 DLLs in different directories under Teradata Client. During the installation, the system PATH environment variable is pre-pended with the directory of where the CLIv2 DLLs are located. Where the DLLs are first found in the system PATH determines how an application accesses the CLIv2 DLLs. The system PATH should be modified to access the correct version of the CLIv2 DLLs.

CLIv2 DLLs Load Error

CLIv2 libraries are no longer installed in the %System32% directory. The libraries are now installed under \Teradata Client. The system PATH environment variable is pre-pended with proper installed directories during installation. In order for the system PATH to take effect, reboot the system or restart the command shell. Also, make sure that the old CLIv2 libraries are removed from %system32% directory.

Incorrect Entries in the hosts File

In the %SystemRoot%\system32\drivers\etc\hosts file on your computer or in the hosts file on the NIS master, perform the following checks:

• Check all entries for incorrect, missing, or duplicate network addresses of COPs, APs, or nodes. Remember that a TCP/IP (Internet) address is a 4-byte value in the form a.b.c.d. COPs, APs, or nodes on the same logical network must have the same network ID portion of the network address.

• Check that COPs, APs, or nodes in the same group for a Teradata have the same dbcname, and that they are numbered sequentially, starting with 1. Remember that the format of a COP name is dbcnameCOPn, where dbcname must begin with an alphabetic character.

Missing Entries in the services File

Check for the following lines in the %SystemRoot%\system32\drivers\etc\ services file or in the services file on the NIS master:

tdmst 1025/udptdses 1025/tcp

Incorrect clispb.dat Parameters

Check the parameter values in the system parameter block file, clispb.dat.

Note whether the default i_dbcpath corresponds to the dbcnames in the %SystemRoot%\system32\drivers\etc\hosts file on your computer or in the hosts file on the NIS master.

Teradata Tools and Utilities Installation Guide for Microsoft Windows 149

Page 150: Teradata Tools and Utilities - dbmanagement.infodbmanagement.info/Books/MIX/2407_TeraData.pdf · Teradata Tools and Utilities Installation Guide for Microsoft Windows 7 ... Software

Chapter 7: TroubleshootingNetwork Problems

Cannot Log On from CLI Application

If you cannot log on to the Teradata Database from your CLI application, try logging on from BTEQ.

If BTEQ works, then check your application for errors.

Cannot Log On to the Teradata Database

If you cannot log on to a Teradata Database, try logging on to a different Teradata Database.

If you are able to log on to the different Teradata Database, there may be something wrong with the first Teradata Database, or something wrong with the address of the first Teradata Database in the local hosts file or in the hosts file on the NIS master.

MSVCR71.DLL not found Message

If you encounter a “MSVCR71.DLL not found” message when trying to start a CLIv2-based application, reboot the system.

Network Problems

Network problems can be due to network hardware or software.

Procedure - Troubleshooting Network Problems

Follow these steps to determine whether a network problem is due to network hardware or software.

1 Verify that the transceiver is connected to the network, the computer, and the Teradata Database. Completing all steps may not be necessary.

2 Check for broken or disconnected network cables.

3 Check for excess lengths of all drop cables (they should follow the IEEE 802.3 standards).

4 Check all repeaters, bridges, routers, and gateways for correct functioning.

5 Check the network controller board to verify that all jumpers are set correctly.

6 Verify that the network software is installed and running correctly on the computer.

7 Verify that the network software is compatible with the network controller board installed on the computer.

8 Use a network utility program to confirm that the network is operational.

9 Use a network utility program from another computer on the same network segment as the first computer to confirm that the network is operational. If this works, there may be a problem with the first computer.

10 Use a network utility program from another computer on a different network segment than the first computer to confirm that the network is operational. If this works, there may be a problem with the first network segment.

150 Teradata Tools and Utilities Installation Guide for Microsoft Windows

Page 151: Teradata Tools and Utilities - dbmanagement.infodbmanagement.info/Books/MIX/2407_TeraData.pdf · Teradata Tools and Utilities Installation Guide for Microsoft Windows 7 ... Software

Chapter 7: TroubleshootingSoftware Problems

11 If a network controller board was replaced in the computer, restart the Teradata Database so it can obtain the network address of the new board.

12 If the network configuration was changed, check that all network-related files were changed accordingly (refer to the previous section, “Client Computer Problems” on page 147).

13 Restart the computer to reset network hardware and reload network software.

Software Problems

This section contains solutions to software problems you may encounter.

Error Running ttu.exe

You may see the following error message while installing a package copied to a network drive:

The parameter is incorrect

This error can occur if the path to the setup.exe file is too long. To resolve the problem, shorten the path to the setup.exe file. One way to do this is to move the file up in the directory structure.

Map a network drive letter to the Disk1 or other folder further down the pathname to produce a new shorter pathname.

If the Install button does not work, see “Install Button Does Not Work.”

Install Button Does Not Work

If the contents of the CD are copied to a network drive and the path to the ttu.exe file is too long, clicking on the Install button after the DemoShield displays will have no effect.

To resolve the problem, shorten the path to the ttu.exe file. One way to do this is to move the file up in the directory structure.

InstallShield 1603 Error

You may see the following error message when installing:

1603: Fatal Error During Installation

Or you may see the following:

Error 1603: General Windows Installer engine error. Increase DiskSpace requirement in Setup.ini and try again.

Some known causes for this error are as follows:

• The computer does not have enough disk space for the installation.

Solution: Increase your disk space.

• The Temp directory is not clean.

Solution: Find your Temp directory and delete its contents.

Teradata Tools and Utilities Installation Guide for Microsoft Windows 151

Page 152: Teradata Tools and Utilities - dbmanagement.infodbmanagement.info/Books/MIX/2407_TeraData.pdf · Teradata Tools and Utilities Installation Guide for Microsoft Windows 7 ... Software

Chapter 7: TroubleshootingSoftware Problems

• A file on the installation Computer is locked.

Solution: Close all running applications and reboot the computer. Then run the installation again.

• The Windows Installer may not be properly installed.

Solution: Update the installation computer with the latest Windows Installer Service.

• You do not have proper Administrative privileges.

Solution: Confirm you have the proper privileges.

• The installation computer may have traces of a previous installation present.

Solution: Use Microsoft’s Windows Installer Clean Up utility to remove the previous install. Also, manually remove files that may have been installed.

InstallShield 1607 Error

You may see the following error message:

1607: Unable to install InstallShield Scripting Runtime

Little information is known at this time about the specific cause of this initialization error, as it rarely occurs and is typically encountered on an intermittent or machine-specific basis.

Some known causes for this error are as follows:

• There is a special character in the directory path containing the installation files.

If the installation files have been copied to a folder on a hard drive, and the full path contains special characters, such as “&”, “-”, “.”, etc., move the installation files to a path which does not contain special characters.

Example of bad path:

C:\tmp\downloads & packages\PMon\setup.exe

Example without the special character:

C:\tmp\downloads\PMon\setup.exe

• On Windows XP, there is a known issue with the Microsoft Windows Installer Service that affects all MSI-based setups. This error results when an MSI-based setup is run from a virtual drive created via the “subst” command.

If running on a Windows XP machine, make sure the setup is not running from a virtual drive created via the “subst” command.

• The file “IDriver.exe” is not registered properly.

Register the file “IDriver.exe” by using the command line below:

<ProgramFiles>\Common Files\InstallShield\Developer\7\Intel 32\IDriver.exe /REGSERVER

This command line can be entered in the Windows Start | Run dialog, after replacing <ProgramFiles> with the location of the Program Files directory.

• Permissions on the <Temp> folder are insufficient.

Make sure SYSTEM has full permission on the UserID %TEMP% folder. For example, on a computer running the Windows 2000 operating system, if UserID is fsk, the UserID %TEMP% folder may be <Boot Drive>:\Documents and Settings\fsk\Local Settings\Temp.

152 Teradata Tools and Utilities Installation Guide for Microsoft Windows

Page 153: Teradata Tools and Utilities - dbmanagement.infodbmanagement.info/Books/MIX/2407_TeraData.pdf · Teradata Tools and Utilities Installation Guide for Microsoft Windows 7 ... Software

Chapter 7: TroubleshootingSoftware Problems

• Permissions on the <WindowsFolder>\Installer folder are insufficient.

Follow the steps below to set the proper permissions to the

<WindowsFolder>\Installer folder:

Procedure - Setting Permissions to the Installer Folder

Follow these steps to set permissions to the Installer Folder.

1 Locate the folder <WindowsFolder>\Installer. (For example, on Windows 2000 this folder would be “C:\WINNT\Installer”)*

2 Right-click the Installer folder, and choose “Properties.”

3 Select the “Security” tab.

4 Make sure the system, as well as the specific user, has full control of this folder.

Note: This folder is hidden by default in the Windows environment. Therefore it may be necessary to enter this path directly in the Windows Start | Run dialog to access this folder.

• The file “msiexec.exe” is not registered properly.

Register the file “msiexec.exe” by using the command line below:

<WindowsFolder>\System32\msiexec.exe /REGSERVER

This command line can be entered in the Windows Start | Run dialog, after replacing <WindowsFolder> with the location of the Windows folder.

• There are insufficient privileges in Windows.

Make sure you have full administrative permissions for this Windows machine.

• Another instance of the file “msiexec.exe” is running.

Kill unproductive copies of msiexec.exe using the Task Manager Processes tab.

• Another MSI-based setup is running simultaneously.

Make sure no other MSI-based installations are running simultaneously.

• DCOM impersonation level is set incorrectly.

The solution for the Windows 2000 Professional is to change the value for the “Default Impersonation Level” from “Anonymous” to “Identify” using the “dcomcnfg” utility.

Procedure - Changing the Default Impersonation Level on Windows 2000

For Windows 2000, follow these steps to change the Default Impersonation Level from “Anonymous” to “Identify.”

1 Click Start->Run and type dcomcnfg in the Open field.

2 Click OK.

3 Select “Default Properties” tab.

4 In the “Default Impersonation Level” list, select “Identify.”

5 Click OK.

Teradata Tools and Utilities Installation Guide for Microsoft Windows 153

Page 154: Teradata Tools and Utilities - dbmanagement.infodbmanagement.info/Books/MIX/2407_TeraData.pdf · Teradata Tools and Utilities Installation Guide for Microsoft Windows 7 ... Software

Chapter 7: TroubleshootingTeradata Database Hardware Problems

Here is the procedure to change the “Default Impersonation Level” to “Identify” using the “dcomcnfg” utility on Windows XP Professional:

Procedure - Changing the Default Impersonation Level on Windows XP

For Windows XP, follow these steps to change the Default Impersonation Level from “Anonymous” to “Identify.”

1 Click Start->Run and type dcomcnfg in the Open field.

2 Click OK.

3 In the console tree of the Component Services administrative tool, right-click the computer whose machine-wide impersonation level you want to modify and then click “Properties.”

4 Select the “Default Properties” tab.

5 Ensure that “Enable Distributed COM on this computer” is checked.

6 In the “Default Impersonation Level” box, select “Identify.”

7 Click OK.

InstallShield 432 Error

If you are installing from the CD to a computer that runs on the Windows 2000, or Windows XP operating system, you can receive an error indicating that UnInstallShield is running (InstallShield Error 432).

Procedure - Deleting ISUnist.exe

Follow these procedures if you receive and InstallShield 432 error.

1 Verify that you have administrative privileges.

2 Delete all instances of IsUninst.exe from the Windows folder and run the setup again.

3 If IsUninst.exe cannot be deleted because it is in use, reboot the machine and run the setup again.

Teradata Database Hardware Problems

Note: Teradata Database hardware problems should be diagnosed with the assistance of your Teradata field service representative.

The following procedure helps determine if there is a database hardware problem, where it is located.

154 Teradata Tools and Utilities Installation Guide for Microsoft Windows

Page 155: Teradata Tools and Utilities - dbmanagement.infodbmanagement.info/Books/MIX/2407_TeraData.pdf · Teradata Tools and Utilities Installation Guide for Microsoft Windows 7 ... Software

Chapter 7: TroubleshootingTeradata Database Hardware Problems

Procedure - Determine whether Database Hardware is Working Properly

Follow these steps to determine whether Database hardware is working properly. Steps 2 through 7 apply to the Teradata Database only.

1 Log on to the Teradata Database from the operator console, another network-attached host, or a mainframe. If you are able to log on, the hardware is operational. If you are unable to log on, contact your Teradata field service representative.

2 Have your field service representative verify that the adapter cable is connected.

3 Have your field service representative check the Multibus Adapter Board (MAB).

4 Check for the following characteristics in all entries of the CopInfoTbl file on the Teradata Database:

• Incorrect, missing, or duplicate cabinet and processor numbers (ccc_p) for applications processors (APs)

• Incorrect, missing, or duplicate network addresses

• Correct network protocol type (CopKind) for each AP

• Correct host number for each AP

• Entries in the CopInfoTbl file match the entries in the <Boot Drive>: \Program Files\NCR\Teradata Parallel Transporter\hosts file (on the computer) or in the hosts file on the NIS master; use the CopUpdate macro to change the CopInfoTbl file.

5 If necessary, run the CopUpdate macro.

If an AP is added or removed from the Teradata Database or if an AP’s network address is changed, the CopUpdate macro must be executed so the Teradata Database can determine changes to network addresses. (The Teradata Database must be restarted before the changes can take effect.)

6 If you are using Internet routing (routers), check the CopRoutesTbl file for the following:

• Incorrect or missing network addresses of destinations

• Incorrect or missing network addresses of routes

• Each router is identified by two (or more) Internet addresses, one for each network on which it resides

• Use the TcpRoute macro to change the CopRoutesTbl file

7 If you are using subnet routing (subnetting), check the CopOptionsTbl file for incorrect or missing subnet masks.

(To change the CopOptionsTbl file, use the AddOption macro.)

8 If the Teradata Database goes down and then comes back up, its sessions table still contains information generated by the hosts that were connected when it went down.

The Teradata Database expects to receive reconnect messages from those hosts. If it does not receive a reconnect message within 20 minutes after it comes back up, it will remove the sessions generated by hosts that have not reconnected.

Therefore, for 20 minutes after the Teradata Database comes back up, some sessions are being kept that may not be used. If use of the Teradata Database is heavy, users unable to

Teradata Tools and Utilities Installation Guide for Microsoft Windows 155

Page 156: Teradata Tools and Utilities - dbmanagement.infodbmanagement.info/Books/MIX/2407_TeraData.pdf · Teradata Tools and Utilities Installation Guide for Microsoft Windows 7 ... Software

Chapter 7: TroubleshootingSilent Installation Result Codes

log on during that 20-minute period (because the maximum number of sessions has been reached) can try again after the unclaimed sessions are cleared.

Silent Installation Result Codes

Silent installation creates a product setup log file, setup.log. The last section in the setup.log file, called Response Result, gives the status of the installation. Any value other than 0 for the Result Code means the installation has failed. If failure occurs, refer to the Remedy entries in Table 84.

Location of the Setup Log

The product setup log file is in the %TEMP%\ClientISS folder. The name of the product setup log file is <product>Setup.log. For example, BTEQ’s setup log file would be BTEQSetup.log and MultiLoad’s setup log file would be MultiLoadSetup.log.

InstallShield Result Codes

Table 84 shows the InstallShield result codes of a silent install.

Table 84: InstallShield Result Codes

Description Result Code

Code:

Explanation:

Remedy:

0

Success

None

Code:

Explanation:

Remedy:

-1

General error

If this result recurs, contact the TSCS-RSC. Try to install the product in interactive mode.

Code:

Explanation:

Remedy:

-2

Invalid mode

If this result recurs, contact the TSCS-RSC. Try to install the product in interactive mode.

Code:

Explanation:

Remedy:

-3

Required data not found in the setup.iss file

Correct the problem in the product’s setup.iss file and reinstall the product in silent mode.

If this result recurs, contact the TSCS-RSC. Try to install the product in interactive mode.

156 Teradata Tools and Utilities Installation Guide for Microsoft Windows

Page 157: Teradata Tools and Utilities - dbmanagement.infodbmanagement.info/Books/MIX/2407_TeraData.pdf · Teradata Tools and Utilities Installation Guide for Microsoft Windows 7 ... Software

Chapter 7: TroubleshootingSilent Installation Result Codes

Code:

Explanation:

Remedy:

-4

Not enough memory available

Exit other currently running Windows programs or increase the memory size, then reinstall the product in silent mode.

Code:

Explanation:

Remedy:

-5

File does not exist

Make sure the response file exists in the %TEMP%\ClientISS or CD ClientISS folder, then reinstall the product in silent mode.

Code:

Explanation:

Remedy:

-6

Cannot write to the response file

Correct the write permission problem, then reinstall the product in silent mode.

If this result recurs, install the product in interactive mode.

Code:

Explanation:

Remedy:

-7

Unable to write to the log file

Correct the write permission problem, then reinstall the product in silent mode.

If this result recurs, install the product in interactive mode.

Code:

Explanation:

Remedy:

-8

Invalid path to the InstallShield response file

Make sure the %TEMP%\ClientISS folder exists or the CD is inserted, then reinstall the product in silent mode.

Code:

Explanation:

Remedy:

-9

Not a valid list type (string or number)

If this result recurs, contact the TSCS-RSC. Try to install the product in interactive mode.

Code:

Explanation:

Remedy:

-10

Data type is invalid

If this result recurs, contact the TSCS-RSC. Try to install the product in interactive mode.

Code:

Explanation:

Remedy:

-11

Unknown error during setup

If this result recurs, contact the TSCS-RSC. Try to install the product in interactive mode.

Table 84: InstallShield Result Codes (continued)

Description Result Code

Teradata Tools and Utilities Installation Guide for Microsoft Windows 157

Page 158: Teradata Tools and Utilities - dbmanagement.infodbmanagement.info/Books/MIX/2407_TeraData.pdf · Teradata Tools and Utilities Installation Guide for Microsoft Windows 7 ... Software

Chapter 7: TroubleshootingSilent Installation Result Codes

Code:

Explanation:

Remedy:

-12

Dialog boxes are out of order

If this result recurs, contact the TSCS-RSC. Try to install the product in interactive mode.

Code:

Explanation:

Remedy:

-51

Cannot create the specified folder

Correct the write permission problem, then reinstall the product in silent mode.

If this result recurs, install the product in interactive mode.

Code:

Explanation:

Remedy:

-52

Cannot access the specified file or folder

Correct the write permission problem, then reinstall the product in silent mode.

If this result recurs, install the product in interactive mode.

Code:

Explanation:

Remedy:

-53

Invalid option selected

If this result recurs, contact the TSCS-RSC. Try to install the product in interactive mode.

Table 84: InstallShield Result Codes (continued)

Description Result Code

158 Teradata Tools and Utilities Installation Guide for Microsoft Windows

Page 159: Teradata Tools and Utilities - dbmanagement.infodbmanagement.info/Books/MIX/2407_TeraData.pdf · Teradata Tools and Utilities Installation Guide for Microsoft Windows 7 ... Software

Index

Symbols.iss files 47_unodbc.dll 104

Aan 48application, cannot log on 150ARC

default destination folder 48default program folder 48dependencies 28product response file name 48

ARCDFLT.TXT 106arcmain.exe 107attributes.twb.xsl 129authentication mechanism 137

Bbase.twb.xsl 129blkexit.c 112blkexit.mak 112blkexitr.c 112BlockLoad.h 113BTEQ 34, 35, 36

default destination folder 48default program folder 48dependencies 28platforms supported 22product response file name 48

bteq.exe 103BTEQWin

default destination folder 48default program folder 48dependencies 28platforms supported 22

bteqwin.exe 103bteqwin_enu.cnt 103bteqwin_enu.hlp 103bteqwin_jpn.cnt 103bteqwin_jpn.dll 103bteqwin_jpn.hlp 103btnfyext.c 104btnfyext.def 104btnfyext.h 104btnfyext.mak 104

Ccannot communicate over network 147cannot log on from CLI application

CLI 150cannot log on to database 150caputl.dll 104checkpoint 123cleanupTables.bteq 116, 120CLI

configuring 89CLI_Module 48client connections

setting number of 57clisamp.c 107, 108clispb.dat 107, 108, 149CLIv2

product response file name 48cliv2if.h 108, 109cnstool.exe 112columns.twb.xsl 129computer problems

troubleshooting 147Connection.h 113connections

setting number of 57contacting Teradata 147coordinator.exe 123COPANOMLOG 91

incorrect path name 149coperr.h 108, 109COPLIB 91

incorrect path name 148coptypes.h 108, 109custom installation 74

Ddata.in 125DataConnector Operator

platforms supported 23dataconop.dll 121dbcacnx.h 108, 109dbcarea.h 108, 109dbcerr.h 108, 109dbms.twb.xsl 129DDL Operator

platforms supported 23

Teradata Tools and Utilities Installation Guide for Microsoft Windows 159

Page 160: Teradata Tools and Utilities - dbmanagement.infodbmanagement.info/Books/MIX/2407_TeraData.pdf · Teradata Tools and Utilities Installation Guide for Microsoft Windows 7 ... Software

Index

ddlop.dll 121dependencies 28Disk Cost

Teradata SQL Assistant/Web Edition 67DMLGroup.h 113

Eenvironment parameters

setting 91executor.exe 123expnfyxt.c 122Export Operator

platforms supported 24exportop.dll 122

FFastExport OUTMOD Adapter Operator

platforms supported 24FastLoad INMOD Adapter Operator

platforms supported 24fastload.exe 111feimod.c 111fenotf.c 111feomod.c 111feomop.dll 124fexp.exe 111file.twb.xsl 129files

installed 101flimop.dll 124flnfyext.c 112FPSpread.dll 111fspread.dll 132

Ggeneric.h 113GenericDriver.cpp 117, 121GenericDriver.h 117, 121GetBuffer.h 116, 120getbuffer.sln 116getbuffer.vcproj 116getbuffer64.sln 120getbuffer64.vcproj 120GetHostByName

limiting requests 92GT11.txt 125GT44.txt 125GT62.txt 125GT93.txt 125GT94.txt 125GT95.txt 125GT96.txt 125

GT97.txt 125guisrv.dll 129

Hhardware problems

troubleshooting 154help 129hosts file 89

adding entries to 90incorrect entries 149

Iicudttd281.dll 105, 106icuintd28.dll 105, 106icuiotd28.dll 105, 106iculetd28.dll 105, 106iculxtd28.dll 105, 106icuuctd28.dll 105, 106incorrect

clispb.dat parameters 149incorrect entries in hosts file 149incorrect path name in COPANOMLOG 149incorrect path name in COPLIB 148parameter is incorrect 151

infile.littleEndian 117, 121input.exp 117, 121input.lod 117, 121input.stm 117, 121input.txt 116, 120input.upd 117, 121insertop.dll 127installation

custom 74kit 31network 78typical 64

InstallShieldresult codes 156

Internet Information Servicesinstallation 53

JJava 2 Runtime Environment 69, 73jhall.jar 112job.twb.xsl 129jobstep.twb.xsl 129jobvars.txt 125jre 129

LLABSBTEQ 107

160 Teradata Tools and Utilities Installation Guide for Microsoft Windows

Page 161: Teradata Tools and Utilities - dbmanagement.infodbmanagement.info/Books/MIX/2407_TeraData.pdf · Teradata Tools and Utilities Installation Guide for Microsoft Windows 7 ... Software

Index

ldnfyext.c 125, 126libjmsam.dll 106libmqs.dll 131libmqsc.dll 131libmqscTWB.dll 131libmqsTWB.dll 131libnetpde.dll 112libpm.dll 109, 110limiting GetHostByName requests 92Load Operator

platforms supportedplatforms supported 24

loadop.dll 125, 126localisation.dll 108, 109

file could not be opened 148logger.twb.xsl 129logon

dialog box 135procedures 135

logs 123logview.dll 124logview.twb.xsl 129

Mmain.cpp 116, 120makesamp.win 107, 108mfc71.dll 104, 111, 132mfc71u.dll 104, 111, 132mgrcli.dll 103, 111, 132mgrcli_jpn.dll 103Microsoft .NET Framework

installation 54Microsoft Internet Explorer Cookie Settings

changing, version 5.5 56changing, version 6.0 56

Microsoft Internet Explorer Security Settingschanging 55

missing entries in services file 149mlimod.c 112mlimop.dll 124mlnotf.c 112mload.exe 112monpm.dll 111, 132mosiif.h 108, 109mpsfs.exe 110msvcirt.dll 124msvcirtd.dll 124msvcp60.dll 124msvcp60d.dll 124MSVCP71.DLL 105msvcp71.dll 122, 124, 132MSVCR71.DLL 105msvcr71.dll 104, 111, 113, 122, 124

msvcr80.dll 111, 132msvcrt.dll 124msvcrtd.dll 112, 124MultiLoad INMOD Adapter Operator

platforms supported 24MultiTool 112

NNamed Pipes Access Module 35, 36, 37, 38

default destination folder 48default program folder 48dependencies 28platforms supported 22product response file 48

ncrtmgr.dll 103, 111, 132ncrtmgr_jpn.dll 103NetBackup Teradata Extension 28network

installation 78parameters, setting 89troubleshooting 150

nojunk.h 108, 109np_AXSMOD.dll 104np_AXSMODenu.dll 104np_AXSMODenuTWB.dll 104np_AXSMODTWB.dll 104

Oobjects.twb.xsl 129ODBC Driver for Teradata 34, 35, 36, 38

configuring 88default destination folder 48default program folder 48dependencies 28installing 72platforms supported 22product response file name 48

ODBC Operatorplatforms supported 24

odbcop.dll 126OLEDB_AXSMOD.dll 113OLEDB_AXSMODenu.cnt 113OLEDB_AXSMODenu.dll 113OLEDB_AXSMODENU.hlp 113OLEDB_AXSMODjpn.cnt 113OLEDB_AXSMODjpn.dll 113OLEDB_AXSMODJPN.hlp 113oleload.exe 113oncrpc.dll 124opcommon.dll 126operating systems 26operation.twb.xsl 129Operator Support Library

Teradata Tools and Utilities Installation Guide for Microsoft Windows 161

Page 162: Teradata Tools and Utilities - dbmanagement.infodbmanagement.info/Books/MIX/2407_TeraData.pdf · Teradata Tools and Utilities Installation Guide for Microsoft Windows 7 ... Software

Index

platforms supported 24operator.twb.xsl 129opermsgs.dll 126OptionsReader.cpp 117, 121OptionsReader.h 117, 121OS Command Operator

platforms supported 24oscmdop.dll 127

Pparameters

setting environment 91setting network 89setting system 93

parcel.h 108, 109Pbocd0x0.txt 104pdecui.jar 112planexecutor.exe 123pmdcomt.h 109, 110pmddamt.h 109, 110port number

setting using TDMSTPORT 92Teradata SQL Assistant/Web Edition 67

PPCLB1 107PPCLB2 107PPCLB3 107PPCLB4 107PPCLB5 107PPCLB6 107PPCLB7 107PPCLB8 107PPCLB9 107ppcmain.exe 107ppruntim.dll 107ppruntim.lib 107Preprocessor

default destination folder 48default program folder 48dependencies 28platforms supported 22product response file name 48

printman.dll 103product dependencies 28product version numbers 3program.ico 113psload.dll 111, 132ptmexec.exe 123ptmgts.exe 123ptmin.dll 124ptmjlgr.exe 123ptmlvs.exe 123ptmos.dll 124ptmpi.dll 124

ptmpo.dll 124ptmtims.exe 123pxcommon.dll 124pxdef.h 124pxdtypes.h 124pxicu.dll 122pxlogdef.h 124pxmacros.h 124pxoper.h 124pxos.h 124pxstc.h 124pxtypes.h 124pxutypes.h 124pxversion.h 124

Rreadme 106readme.doc 125Readme.txt 104readme.txt 130Receiver.class 106requests

GetHostByName 92requirements

software 28resource.h 108, 109result codes 156runtbuild.cmd 129

Ssamplefilter.cpp 125sampleoperator.dsp 125sampleoperator.dsw 125samples.jar 110samplescript.txt 125Schema.h 113schema.twb.xsl 129selectop.dll 127services file

missing entries 149setup.log 156setupTables.bteq 116, 120sfc.jar 112Shared ICU Libraries for Teradata 28, 34, 35, 36, 37, 38, 39, 48

platforms supported 22SharedICULibrariesforTeradata.iss 48SharedICULibrariesforTeradata64.iss 48silent installation

troubleshooting 156software problems

troubleshooting 151software requirements 28SQL Inserter Operator

162 Teradata Tools and Utilities Installation Guide for Microsoft Windows

Page 163: Teradata Tools and Utilities - dbmanagement.infodbmanagement.info/Books/MIX/2407_TeraData.pdf · Teradata Tools and Utilities Installation Guide for Microsoft Windows 7 ... Software

Index

platforms supported 24SQL Selector Operator

platforms supported 24sql1.txt 125sql2.txt 125sqlprs.dfa 131sqlprs.llr 131stmnfyxt.c 128Stream Operator

platforms supported 25streamop.dll 128support 51supported software releases 3symbeans.jar 112syntax

for hosts file entries 90

Ttable.twb.xsl 129tableset.twb.xsl 129tbuild.exe 123tbuildexe.exe 123td.ico 112tdapp.dll 111, 132tdatpump.cfg 131TDDSNC.EXE 106tdgssconfig.jar 110, 129tdgssjava.jar 110, 129tdis.dll 103, 111, 132tdmfcis.dll 111, 132TDMSTPORT

setting the port number 92tdqmcomm.dll 130tdqmcomm.exe 130tdqmdb.exe 130tdqmjob.exe 130tdqmlsnr.exe 130tdqmops.exe 130tdqmreqp.exe 130tdqmserv.dll 130tdqmserv.exe 130tdqmsr.dll 130tdqmsubm.dll 130tdqmview.exe 130tdqsadm.exe 130tdsqlprs.dll 130tdusr32.dll 108, 109tdusr32.lib 108, 109tdwm.exe 110tdwmutil.dll 111, 132technical support 51telapi.dll 113telapi.lib 113

teqtalk.ico 103Teradata 34Teradata Access Module for JMS 22, 28, 35, 36, 48Teradata Access Module for Tivoli 38, 48

dependencies 28platforms supported 22

Teradata Administratorconfiguring 87default destination folder 48default program folder 48dependencies 28platforms supported 22

Teradata Archive/Recovery Utility 38, 48platforms supported 22

Teradata C Preprocessor 22, 34, 35, 38Teradata Call-Level Interface version 2 (CLIv2) 34, 35, 36, 37,

38, 39default destination folder 48default program folder 48dependencies 29installation order 31platforms supported 22

Teradata Cobol Preprocessor 35Teradata Data Connector 34, 35, 36, 37, 39

default destination folder 48default program folder 48dependencies 29installation order 31platforms supported 22product response file name 48

Teradata Databasecannot log on to 150identifying 89

Teradata DQM Administratorconfiguring 88

Teradata DQM Scheduled Requests Clientconfiguring 88default destination folder 50default program folder 50platforms supported 25product response file name 50

Teradata DQM Scheduled Requests Serverconfiguring 88default destination folder 50default program folder 50platforms supported 25product response file name 50

Teradata Driver for the JDBC Interfaceplatforms supported 23, 145

Teradata Dynamic Workload Manager 29, 34, 49platforms supported 23

Teradata FastExport 35, 36, 37default destination folder 49default program folder 49

Teradata Tools and Utilities Installation Guide for Microsoft Windows 163

Page 164: Teradata Tools and Utilities - dbmanagement.infodbmanagement.info/Books/MIX/2407_TeraData.pdf · Teradata Tools and Utilities Installation Guide for Microsoft Windows 7 ... Software

Index

dependencies 29platforms supported 23product response file name 49

Teradata FastLoad 35, 36, 37default destination folder 49default program folder 49dependencies 29platforms supported 23product response file name 49

Teradata Generic Security Services 34, 35, 36, 37, 38, 39, 49Teradata Generic Security Services Client

dependencies 29platforms supported 23, 26

Teradata Index Wizard 34default destination folder 49default program folder 49dependencies 29platforms supported 23product response file name 49, 50

Teradata Manager 34configuring 88default destination folder 49default program folder 49dependencies 29installing 70platforms supported 23product response file name 49

Teradata MultiLoad 35, 36, 37default destination folder 49default program folder 49dependencies 29platforms supported 23product response file name 49

Teradata MultiTooldefault destination folder 49default program folder 49dependencies 29installing 69platforms supported 23

Teradata OLE DB Access Module 35default destination folder 49default program folder 49dependencies 29platforms supported 23product response file name 49

Teradata Parallel Transporterconfiguring 94

Teradata Parallel Transporter APIplatforms supported 23

Teradata Parallel Transporter ICU Librarydefault destination folder 49default program folder 49

Teradata Parallel Transporter Infrastructureplatforms supported 24

product response file name 49Teradata Parallel Transporter Wizard

platforms supported 25Teradata Performance Monitor 34

default destination folder 49default program folder 49dependencies 29platforms supported 25

Teradata Query Director 39dependencies 29platforms supported 25

Teradata Query Scheduler Administrator 29, 34platforms supported 25

Teradata Query Scheduler Client 29, 34default destination folder 50default program folder 50

Teradata Query Scheduler Server 29, 34default destination folder 50default program folder 50

Teradata Scheduled Requests Clientconfiguring 88

Teradata Scheduled Requests Serverconfiguring 88

Teradata Software Server 32Teradata SQL Assistant

default destination folder 50default program folder 50dependencies 30platforms supported 25

Teradata SQL Assistant/Web Editiondefault destination folder 50default program folder 50dependencies 30installing 67platforms supported 25

Teradata Statistics Wizard 34default destination folder 50default program folder 50dependencies 30platforms supported 25

Teradata System Emulation Tool 34default destination folder 50default program folder 50dependencies 30platforms supported 25product response file name 50

Teradata TPump 35, 36, 37default destination folder 50default program folder 50dependencies 30platforms supported 25product response file name 50

Teradata Visual Explain 34default destination folder 50

164 Teradata Tools and Utilities Installation Guide for Microsoft Windows

Page 165: Teradata Tools and Utilities - dbmanagement.infodbmanagement.info/Books/MIX/2407_TeraData.pdf · Teradata Tools and Utilities Installation Guide for Microsoft Windows 7 ... Software

Index

default program folder 50dependencies 30platforms supported 25product response file name 50

Teradata Workload Analyzer 30, 34default destination folder 50default program folder 50platforms supported 25product response file 50

Teradata_Access_Module_for_Tivoli.iss 48Teradata_JMS.iss 48terajdbc4.jar 110, 129terasso.dll 108, 109TIVARC.BATTIVADM.BAT 106TIVBAR.DLL 106TIVDFLT.TXT 106Tivoli.Readme.TXT 106tldnfyxt.c 131tlogview.exe 123tlogviewexe.exe 123tm_dialogs.dll 103, 111, 132tm_dialogs_jpn.dll 103tm_stat.dll 103tm_stat_jpn.dll 103tptlaunch.exe 123tptwizard.cmd 129tptwizard.ico 129tptwizard.jar 129TPump, see Teradata TPumptpump.exe 131tpumpar.csql 131tpumpimd.c 131troubleshooting

client computer problems 147client problems 147hardware problems 154network problems 150silent installation 156Teradata Database problems 154

TSCS-RSC 51twa.exe 131twb_status.txt 125twb_targets.txt 125twbcfg.ini 123twbcmdexe.exe 123twbkill.exe 123twbkillexe.exe 123twbmsgs.dll 124twboper.ini 123twbpath.exe 123twbpathexe.exe 123twbrmcp.exe 123twbrmcpexe.exe 123twbstat.exe 123

twbstatexe.exe 123twbwizard.properties 129typical installation 64

UUninst.dll 113uninst.dll 125uninstalling previous software 47UninstDataConnectorOp8.1.isu 121UninstDDLOp8.1.isu 121UninstInsertOp8.1.isu 127UninstODBCOp8.1.isu 126UninstOSCmdOp8.1.isu 127UninstSelectOp8.1.isu 127UninstTPTWizard8.1.isu 129Update Operator

platforms supported 25updateop.dll 128updnfyxt.c 128User Exit functions 93

CLI 93

Vverify.dat 110, 131Verify.exe 110, 131verifying installation 101version 125version numbers 3version.txt 112Virtual directory

Teradata SQL Assistant/Web Edition 67

WWebSphere MQ Access Module 30, 36, 37, 38

default destination folder 50default program folder 50platforms supported 25product response file 50

wincli32.dll 108, 109wincli32.lib 108, 109wincliv2.h 108, 109winjavaloader.exe 112wwhelp.dll 129

Xxsp.cpp 117xsp.sln 117xsp.vcproj 117xsp64.sln 121xsp64.vcproj 121

Teradata Tools and Utilities Installation Guide for Microsoft Windows 165

Page 166: Teradata Tools and Utilities - dbmanagement.infodbmanagement.info/Books/MIX/2407_TeraData.pdf · Teradata Tools and Utilities Installation Guide for Microsoft Windows 7 ... Software

Index

166 Teradata Tools and Utilities Installation Guide for Microsoft Windows