Teradata Tools and Utilities. Installation Guide for Microsoft Windows

Transcription

1 Teradata Tools and Utilities Installation Guide for Microsoft Windows Release B A September 2007

2 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 teradata-books@lists.teradata.com 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 by Teradata Corporation. All Rights Reserved.

3 Preface Purpose This book provides information about installing the Teradata Tools and Utilities Release 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 Teradata Tools and Utilities To locate detailed supported-release information: 1 Go to 2 Navigate to General Search>Publication Product ID. 3 Enter Open the version of the Teradata Tools and Utilities 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

4 Preface Changes 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. Date and Release September August July Description Removed information on Teradata Dynamic Query Director. Removed ESDM information. Updated installation procedures to reflect Teradata products added to Teradata Tools and Utilities 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. 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 2 Select the General Search check box. 3 In the Publication Product ID box, type Click Search. 5 Select the appropriate Release Definition from the search results. 4 Teradata Tools and Utilities Installation Guide for Microsoft Windows

5 Preface Additional Information Type of Information Description Access to 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 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: Messages B mmyA Teradata Tools and Utilities Command Summary B mmyA Teradata Manager Installation Guide B mmyA Teradata Driver for the JDBC Interface User Guide B mmyA Teradata Tools and Utilities Installation Guide for Microsoft Windows B mmyA Teradata MultiLoad Reference B mmyA Teradata FastExport Reference B mmyA Teradata FastLoad Reference B mmyA Teradata Archive/Recovery Utility Reference B mmyA Basic Teradata Query Reference B mmyA Teradata Director Program Reference B mmyA Teradata Call-Level Interface Version 2 Reference for Channel-Attached Systems B mmyA Teradata Call-Level Interface Version 2 Reference for Network-Attached Systems B mmyA Teradata Transparency Series/ Application Programming Interface User Guide B mmyA Teradata Tools and Utilities Installation Guide for Microsoft Windows 5

6 Preface Additional Information Type of Information Description Access to 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 VM B mmyA Teradata Tools and Utilities Access Module Programmer Guide B mmyA Teradata Tools and Utilities Access Module Reference B mmyA Teradata Manager User Guide B mmyA Teradata SQL Assistant for Microsoft Windows User Guide B mmyA Teradata Parallel Transporter Reference B mmyA Teradata Access Module for Tivoli Installation and User Guide B mmyA Teradata Parallel Transporter User Guide B mmyA Teradata Preprocessor2 for Embedded SQL Programmer Guide B mmyA IBM IMS/DC Interface for Teradata Reference B mmyA IBM CICS Interface for Teradata Reference B mmyA Interactive Teradata Query Reference B mmyA Interactive Teradata Query User Guide B mmyA Teradata Tools and Utilities Installation Guide for IBM z/os B mmyA Teradata Tools and Utilities Installation Guide for UNIX and Linux B mmyA 6 Teradata Tools and Utilities Installation Guide for Microsoft Windows

7 Preface Additional Information Type of Information Description Access to 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 Guide B mmyA OLE DB Provider for Teradata Installation and User Guide B mmyA Teradata Administrator User Guide B mmyA Teradata Statistics Wizard User Guide B mmyA Teradata Visual Explain User Guide B mmyA Teradata SQL Assistant/Web Edition User Guide B mmyA Teradata Index Wizard User Guide B mmyA ODBC Driver for Teradata User Guide B mmyA Teradata Query Director User Guide B mmyA Teradata Query Scheduler Administrator Guide B mmyA Teradata Query Scheduler User Guide B mmyA Teradata Dynamic Workload Manager User Guide B mmyA Teradata Workload Analyzer User Guide B mmyA Teradata Parallel Transporter Application Programming Interface Programmer Guide B mmyA Teradata Parallel Data Pump Reference B mmyA Teradata Meta Data Services Installation and Administration Guide B mmyA Teradata Meta Data Services Programmer Guide B 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 2 Select the General Search check box. 3 In the Title or Keyword box, type CD-ROM. 4 Click Search. Teradata Tools and Utilities Installation Guide for Microsoft Windows 7

8 Preface Additional Information Type of Information Description Access to Information Ordering information for manuals General information about Teradata Use the Teradata Information Products Publishing Library site to order printed versions of manuals. 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 2 Select the How to Order check box under Print & CD Publications. 3 Follow the ordering instructions. 1 Go to Teradata.com. 2 Select a link. 8 Teradata Tools and Utilities Installation Guide for Microsoft Windows

9 Table of Contents Preface Purpose Audience Supported Releases Prerequisites Changes to This Book Additional Information Chapter 1: Introduction System Configuration Information System Requirements Software Requirements Product Dependencies Installation Kit Teradata Software Server IBM VM and IBM z/os Teradata Driver for the JDBC Interface Teradata Parallel Transporter Wizard Teradata Tools and Utilities CDs Chapter 2: Before You Install Installation Recommendations Installing on Windows Vista Installing on EM64T Systems Minimum and Recommended Configurations Shared ICU Libraries for Teradata Recommendations Installation of Dependent Products Teradata Generic Security Services PUT Installations Teradata Tools and Utilities Installation Guide for Microsoft Windows 9

10 Table of Contents Typical, Custom, and Network Installations Command Line Installations Teradata Download Center Installations Teradata Parallel Transporter Installation Uninstalling Previous Software Default Folders Default Product Response Files Restarting After Installation Technical Assistance Installing Required Software for Teradata SQL Assistant/Web Edition Installing Microsoft Internet Information Services Installing ASP.NET for Windows Server Installing Microsoft.NET Framework (version 1.1) Installing Microsoft Visual J#.Net Redistributable Package (version 1.1) Installing the Cumulative Security Patch for IIS Changing Microsoft Internet Explorer Security Settings Changing Cookies Settings on Microsoft Internet Explorer Setting the Number of Client Connections Setting the Number of Clients on Windows Vista Updating the Teradata Parallel Transporter API Chapter 3: Installing the Teradata Tools and Utilities Software Types of Installation Installing Using PUT Installing Using the Client Main Install Initial Procedure for Typical, Custom or Network Installations Typical Installation Custom Installation Network Installation Installing a Package from the Command Prompt Sample Package Folder Installation Installation Commands Configuring the Products Installing the Teradata Driver for the JDBC Interface Installing the OLE DB Provider for Teradata from the Download Center Teradata Tools and Utilities Installation Guide for Microsoft Windows

11 Table of Contents Chapter 4: Configuring 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 Setting Network Parameters Setting Environment Parameters Setting System Parameters Adding CLI User Exit Functions Configuring Teradata Parallel Transporter Changing the twbcfg.ini File Switching Teradata Parallel Transporter Software Versions User Environment Variables System Environment Variable ORACLE_HOME Uninstalling Teradata Parallel Transporter Order to Remove Teradata Parallel Transporter Software Configuring Teradata Access Module for JMS Chapter 5: Verifying the Installation 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 Preprocessor 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 Teradata Tools and Utilities Installation Guide for Microsoft Windows 11

12 Table of Contents 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 Infrastructure 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 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 Chapter 6: Connecting to a Teradata Database Making the Database Connection Overview of Logon Procedures Connecting in GUI Applications Connecting in Command Line Driven Applications Example Logons from the Command Line Connecting to a Teradata Database Programmatically Logon Error Messages Chapter 7: Troubleshooting Technical Assistance Client Computer Problems Cannot Communicate Over the Network with Teradata Database Incorrect Path Name in COPLIB Teradata Tools and Utilities Installation Guide for Microsoft Windows

13 Table of Contents File localisation.dll Could Not Be Opened File icuuctd28.dll Could Not Be Found Incorrect Path Name in COPANOMLOG Incorrect CLIv2 Libraries Referenced CLIv2 DLLs Load Error Incorrect Entries in the hosts File Missing Entries in the services File Incorrect clispb.dat Parameters Cannot Log On from CLI Application Cannot Log On to the Teradata Database MSVCR71.DLL not found Message Network Problems Software Problems Error Running ttu.exe Install Button Does Not Work InstallShield 1603 Error InstallShield 1607 Error InstallShield 432 Error Teradata Database Hardware Problems Silent Installation Result Codes Location of the Setup Log InstallShield Result Codes Index Teradata Tools and Utilities Installation Guide for Microsoft Windows 13

14 Table of Contents 14 Teradata Tools and Utilities Installation Guide for Microsoft Windows

15 List of Figures Figure 1: Typical Connect to Teradata Database Dialog Teradata Tools and Utilities Installation Guide for Microsoft Windows 15

16 List of Figures 16 Teradata Tools and Utilities Installation Guide for Microsoft Windows

17 List of Tables Table 1: Platforms Supported by Each Product Table 2: Product Dependencies Table 3: Teradata Utility Pak CD#1 (Windows Products) Table 4: Teradata Utility Pak CD#2 (HP-UX, Linux and MP-RAS Products) Table 5: Teradata Utility Pak CD#3 (AIX and Solaris Products) Table 6: Data Management CD Table 7: Preprocessors CD#1 (Windows Products) Table 8: Preprocessors CD#2 (HP, Linux, and MP-RAS Products) Table 9: Preprocessors CD#3 (AIX and Solaris Products) Table 10: Load/Unload CD#1 (Windows Products) Table 11: Load/Unload CD#2 (HP-UX, Linux and MP-RAS Products) Table 12: Load/Unload CD#3 (AIX and Solaris Products) Table 13: Parallel Transporter CD#1 (Windows Products) Table 14: Parallel Transporter CD#2 (HP-UX, Linux, and MP-RAS Products) Table 15: Parallel Transporter CD#3 (AIX and Solaris Products) Table 16: Tape Storage Management Enablers CD Table 17: Query Director CD Table 18: MetaData Services CD Table 19: Minimum Configurations for Teradata Tools and Utilities Table 20: Recommended Configurations for Teradata Tools and Utilities Table 21: Default CD Folders Table 22: Default Folders and Product Response Files Table 23: setup.exe Table 24: setup.exe command parameters Table 25: Command Prompt Installation Command Table 26: Configuring ODBC, Teradata Query Scheduler and Teradata Manager Table 27: Adding an Entry to the hosts File Table 28: hosts File Syntax Table 29: Environment Parameters Table 30: Setting Environment Parameters Table 31: Logon Parameters Table 32: Setting <machine name> Teradata Tools and Utilities Installation Guide for Microsoft Windows 17

18 List of Tables Table 33: Port Number Parameters Table 34: Setting TDMSTPORT Table 35: Basic Teradata Query (BTEQ) Files 32-bit Platforms Table 36: Named Pipes Access Module 32-bit Files Table 37: ODBC Driver for Teradata 32-bit Files Table 38: ODBC Driver for Teradata 64-bit Files Table 39: Share ICU Libraries for Teradata 32-bit Files Table 40: Shared ICU Libraries for Teradata 64-bit Files Table 41: Teradata Access Module for JMS Files Table 42: Teradata Access Module for Tivoli Files Table 43: Teradata Archive/Recovery Utility (ARC) 32-bit Files Table 44: Teradata C Preprocessor2 32-bit and 64-bit Files Table 45: Teradata Call-Level Interface version 2 (CLIv2), 32-bit Files Table 46: Teradata Call-Level Interface version 2 (CLIv2), 64-bit Files Table 47: Teradata Data Connector 32-bit Files Table 48: Teradata Data Connector 64-bit Files Table 49: Teradata Driver for the JDBC Interface Table 50: Teradata Dynamic Workload Manager Files Table 51: Teradata FastExport 32-bit Files Table 52: Teradata FastLoad 32-bit Files Table 53: Teradata MultiLoad 32-bit Files Table 54: Teradata MultiTool 32-bit Files Table 55: Teradata OLE DB Access Module 32-bit Files Table 56: 32-bit Teradata Parallel Transporter API Table 57: 64-bit Teradata Parallel Transporter API Table 58: Teradata Parallel Transporter Data Connector Operator Table 59: Teradata Parallel Transporter DDL Operator Table 60: 32-bit Teradata Parallel Transporter Export Operator Table 61: 64-bit Teradata Parallel Transporter Export Operator Table 62: 32-bit Teradata Parallel Transporter ICU Library Files Table 63: 64-bit Teradata Parallel Transporter ICU Library Files Table 64: Teradata Parallel Transporter Infrastructure Files Table 65: 32-bit Teradata Parallel Transporter Load Operator Table 66: 64-bit Teradata Parallel Transporter Load Operator Table 67: Teradata Parallel Transporter ODBC Operator Table 68: 32-bit Teradata Parallel Transporter Operator Support Library Teradata Tools and Utilities Installation Guide for Microsoft Windows

19 List of Tables Table 69: 64-bit Teradata Parallel Transporter Operator Support Library Table 70: Teradata Parallel Transporter OS Command Operator Table 71: Teradata Parallel Transporter SQL Inserter Operator Table 72: Teradata Parallel Transporter SQL Selector Operator Table 73: 32-bit Teradata Parallel Transporter Stream Operator Table 74: 64-bit Teradata Parallel Transporter Stream Operator Table 75: 32-bit Teradata Parallel Transporter Update Operator Table 76: 64-bit Teradata Parallel Transporter Update Operator Table 77: Teradata Parallel Transporter Wizard Table 78: Teradata Query Scheduler Administrator 32-bit Files Table 79: Teradata Query Scheduler Client 32-bit Files Table 80: Teradata Query Scheduler Server 32-bit Files Table 81: Teradata TPump 32-bit Files Table 82: WebSphere MQ Access Module Table 83: Teradata Workload Analyzer Files Table 84: InstallShield Result Codes Teradata Tools and Utilities Installation Guide for Microsoft Windows 19

20 List of Tables 20 Teradata Tools and Utilities Installation Guide for Microsoft Windows

21 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

22 Chapter 1: Introduction System 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 Microsoft Windows 2000 Professional Server and Advanced Server, with sp4, running on Intel x86 (32-bit Teradata Tools and Utilities) 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) Microsoft Windows XP Professional, x64, with sp2, running on Intel Xeon with EM64T/Opteron (64-bit Teradata Tools and Utilities) 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 32-bit (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 (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) ]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 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 *YES *YE Utility (ARC) b S *YES YES NO *YE S *YE S 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

23 Chapter 1: Introduction System Configuration Information Table 1: Platforms Supported by Each Product (continued) Windows 2000 XP Server 2003 Vista Product Microsoft Windows 2000 Professional Server and Advanced Server, with sp4, running on Intel x86 (32-bit Teradata Tools and Utilities) 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) Microsoft Windows XP Professional, x64, with sp2, running on Intel Xeon with EM64T/Opteron (64-bit Teradata Tools and Utilities) 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 32-bit (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 (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) ]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 Teradata Driver for the JDBC Interface Teradata Dynamic Workload Manager (Teradata DWM) YES YES NO YES YES YES YES YES YES YES NO YES YES 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) Teradata Generic Security Services (TeraGSS) Client (C support) YES YES YES YES YES YES YES YES YES YES YES YES YES 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 Teradata Parallel Transporter Data Connector Operator Teradata Parallel Transporter DDL Operator YES YES YES YES YES YES YES YES YES YES YES YES YES YES YES YES YES NO YES YES YES NO YES YES YES NO YES YES YES YES NO YES YES YES NO YES YES YES NO Teradata Tools and Utilities Installation Guide for Microsoft Windows 23

24 Chapter 1: Introduction System Configuration Information Table 1: Platforms Supported by Each Product (continued) Windows 2000 XP Server 2003 Vista Product Microsoft Windows 2000 Professional Server and Advanced Server, with sp4, running on Intel x86 (32-bit Teradata Tools and Utilities) 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) Microsoft Windows XP Professional, x64, with sp2, running on Intel Xeon with EM64T/Opteron (64-bit Teradata Tools and Utilities) 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 32-bit (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 (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) ]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 Teradata Parallel Transporter Export Operator Teradata Parallel Transporter FastExport OUTMOD Adapter Operator d Teradata Parallel Transporter FastLoad INMOD Adapter Operator e Teradata Parallel Transporter ICU Library Teradata Parallel Transporter Infrastructure Teradata Parallel Transporter Load Operator Teradata Parallel Transporter MultiLoad INMOD Adapter Operator f Teradata Parallel Transporter ODBC Operator Teradata Parallel Transporter Operator Support Library Teradata Parallel Transporter OS Command Operator Teradata Parallel Transporter SQL Inserter Operator Teradata Parallel Transporter SQL Selector Operator YES YES YES YES YES YES YES YES YES YES YES YES YES YES YES YES YES NO YES YES YES NO YES YES YES NO YES YES YES YES NO YES YES YES NO YES YES YES NO YES YES YES YES YES YES YES YES YES YES YES YES YES YES YES YES YES NO YES YES YES NO YES YES YES NO YES YES YES YES YES YES YES YES YES YES YES YES YES YES YES YES YES NO YES YES YES NO YES YES YES NO YES YES YES YES NO YES YES YES NO YES YES YES NO YES YES YES YES YES YES YES YES YES YES YES YES YES YES YES YES YES NO YES YES YES NO YES YES YES NO YES YES YES YES NO YES YES YES NO YES YES YES NO YES YES YES YES NO YES YES YES NO YES YES YES NO 24 Teradata Tools and Utilities Installation Guide for Microsoft Windows

25 Chapter 1: Introduction System Configuration Information Table 1: Platforms Supported by Each Product (continued) Windows 2000 XP Server 2003 Vista Product Microsoft Windows 2000 Professional Server and Advanced Server, with sp4, running on Intel x86 (32-bit Teradata Tools and Utilities) 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) Microsoft Windows XP Professional, x64, with sp2, running on Intel Xeon with EM64T/Opteron (64-bit Teradata Tools and Utilities) 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 32-bit (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 (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) ]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 Teradata Parallel Transporter Stream Operator Teradata Parallel Transporter Update Operator Teradata Parallel Transporter Wizard YES YES YES YES YES YES YES YES YES YES YES YES YES YES YES YES YES YES YES YES YES YES YES YES YES YES 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 Teradata Tools and Utilities Installation Guide for Microsoft Windows 25

26 Chapter 1: Introduction System 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: Archive and Recovery Utility (ARC) Basic Teradata Query (BTEQ) Teradata FastExport Teradata FastLoad Teradata MultiLoad Teradata TPump b c d e f The Teradata Archive and Recovery Utility (ARC) is included for Open Teradata Backup and is not sold as an individual product. Teradata MultiTool cannot be installed if Teradata Database is already installed, because the installation of Teradata Database installs Teradata MultiTool. FastExport OUTMOD Adapter Operator is installed as part of the Teradata Parallel Transporter Infrastructure installation. FastLoad INMOD Adapter Operator is installed as part of the Teradata Parallel Transporter Infrastructure installation. 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) 26 Teradata Tools and Utilities Installation Guide for Microsoft Windows

27 Chapter 1: Introduction System 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 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

28 Chapter 1: Introduction Software 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 CLIv2 version or later Teradata Data Connector version or later Shared ICU Libraries for Teradata version or later BTEQWin version BTEQ version Named Pipes Access Module version No dependencies NetBackup Teradata Extension version No dependencies ODBC Driver for Teradata version Microsoft Data Access Components (MDAC), version 2.8 sp1 (on distribution CD) Shared ICU Libraries for Teradata version Shared ICU Libraries for Teradata version No dependencies Teradata Generic Security Services version or later TeraGSS - Client package Teradata Access Module for JMS version Teradata Data Connector version or later JDK 1.4 or later JMS enabled Messaging System Teradata Access Module for Tivoli version No dependencies Teradata Administrator version ODBC Driver for Teradata version or later Teradata Archive/Recovery Utility (ARC) version CLIv2 version or later Teradata Data Connector version or later Note: ARC is not distributed as a stand-alone product. It is installed with Open Teradata Backup on MP-RAS and Windows Teradata C Preprocessor2 version CLIv2 version or later Shared ICU Libraries for Teradata version Teradata Tools and Utilities Installation Guide for Microsoft Windows

29 Chapter 1: Introduction Software Requirements Table 2: Product Dependencies (continued) These products... Teradata Call-Level Interface version 2 (CLIv2) version require these installations... Shared ICU Libraries for Teradata version or later Teradata Generic Security Services version or later TDGSS - Server package TeraGSS - Client package Teradata Data Connector version No dependencies Teradata Dynamic Workload Manager version CLIv2 version or later Teradata FastExport version CLIv2 version or later Teradata Data Connector version or later Teradata FastLoad version CLIv2 version or later Teradata Data Connector version or later Teradata Generic Security Services Client (TeraGSS) version Teradata Generic Security Services Client Java (TeraGSSJava) version No dependencies No dependencies Teradata Index Wizard version CLIv2 version or later or ODBC Driver for Teradata version or later Teradata Manager version CLIv2 version or later Teradata MultiLoad version CLIv2 version or later Teradata Data Connector version or later Teradata MultiTool version Java 2 Runtime Environment 1.4 or later Note: The environment can be downloaded from the Sun website at: index.html Teradata OLE DB Access Module version ODBC Driver for Teradata version or later Teradata Performance Monitor version CLIv2 version or later Teradata Query Director version CLIv2 version or later Shared ICU Libraries for Teradata version Teradata_GSS_Client version or later Teradata Query Scheduler Administrator version CLIv2 version or later Teradata Query Scheduler Client version CLIv2 version or later Teradata Query Scheduler Server version CLIv2 version or later Teradata Query Scheduler Client version Teradata Tools and Utilities Installation Guide for Microsoft Windows 29

30 Chapter 1: Introduction Software Requirements Table 2: Product Dependencies (continued) These products... require these installations... Teradata SQL Assistant version ODBC Driver for Teradata version or later Teradata SQL Assistant/Web Edition version ODBC Driver for Teradata version 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 CLIv2 version or later Teradata System Emulation Tool version CLIv2 version or later or ODBC Driver for Teradata version or later Teradata TPump version CLIv2 version or later Teradata Data Connector version or later Shared ICU Libraries for Teradata version Teradata Visual Explain version CLIv2 version or later or ODBC Driver for Teradata version or later Teradata Parallel Transporter ICU Library version Shared ICU Libraries for Teradata or later Teradata Workload Analyzer version CLIv2 version or later WebSphere MQ Access Module version Teradata Data Connector or later WebSphere MQ V5.2 a b c d FastExport OUTMOD Adapter Operator is installed as part of the Teradata Parallel Transporter Infrastructure installation. FastLoad INMOD Adapter Operator is installed as part of the Teradata Parallel Transporter Infrastructure installation. MultiLoad INMOD Adapter Operator is installed as part of the Teradata Parallel Transporter Infrastructure installation. Teradata Parallel Transporter is certified with Teradata Call-Level Interface version 2 release Teradata Tools and Utilities Installation Guide for Microsoft Windows

31 Chapter 1: Introduction Installation 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 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 Teradata Tools and Utilities Installation Guide for Microsoft Windows 31

32 Chapter 1: Introduction Installation 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: 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: 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 Basic Teradata Query (BTEQ) Named Pipes Access Module ODBC Driver for Teradata Shared ICU Libraries for Teradata Teradata Administrator Teradata Call-Level Interface version 2 (CLIv2) Teradata Data Connector Platforms (Windows) Windows Windows Windows Windows Windows Windows Windows 32 Teradata Tools and Utilities Installation Guide for Microsoft Windows

33 Chapter 1: Introduction Installation Kit Table 3: Teradata Utility Pak CD#1 (Windows Products) (continued) Teradata Utility Pak - Utilities CD#1 Teradata Generic Security Services Teradata MultiTool Teradata SQL Assistant Teradata SQL Assistant/Web Edition Platforms (Windows) Windows 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. Windows Windows Table 4: Teradata Utility Pak CD#2 (HP-UX, Linux and MP-RAS Products) Teradata Utility Pak - Utilities CD#2 Basic Teradata Query (BTEQ) Named Pipes Access Module ODBC Driver for Teradata Shared ICU Libraries for Teradata Teradata Call-Level Interface version 2 (CLIv2) Teradata Data Connector Teradata Generic Security Services Platforms (HP-UX, Linux and MP-RAS) HP-UX, Linux, MP-RAS HP-UX, Linux, MP-RAS HP-UX, Linux, MP-RAS HP-UX, Linux, MP-RAS HP-UX, Linux, MP-RAS HP-UX, Linux, MP-RAS HP-UX, Linux, MP-RAS Table 5: Teradata Utility Pak CD#3 (AIX and Solaris Products) Teradata Utility Pak - Utilities CD#3 Basic Teradata Query (BTEQ) Named Pipes Access Module ODBC Driver for Teradata Shared ICU Libraries for Teradata Teradata Call-Level Interface version 2 (CLIv2) Teradata Data Connector Teradata Generic Security Services Platforms (AIX and Solaris) IBM AIX, Solaris SPARC IBM AIX, Solaris SPARC IBM AIX, Solaris SPARC IBM AIX, Solaris SPARC, Solaris Opteron IBM AIX, Solaris SPARC, Solaris Opteron IBM AIX, Solaris SPARC IBM AIX, Solaris SPARC Teradata Tools and Utilities Installation Guide for Microsoft Windows 33

34 Chapter 1: Introduction Installation Kit Table 6: Data Management CD Database Management CD Basic Teradata Query (BTEQ) ODBC Driver for Teradata Shared ICU Libraries for Teradata Teradata Call-Level Interface version 2 (CLIv2) Teradata Data Connector Teradata Dynamic Workload Manager Teradata Generic Security Services Teradata Index Wizard Teradata Manager Teradata Performance Monitor Teradata Query Scheduler Administrator Teradata Query Scheduler Client Teradata Query Scheduler Server Teradata Statistics Wizard Teradata System Emulation Tool Teradata Visual Explain Teradata Workload Analyzer Platforms (Windows) Product dependency Product dependency Product dependency Product dependency Product dependency Windows Product dependency Windows Windows Windows Windows Windows Windows Windows Windows Windows Windows Table 7: Preprocessors CD#1 (Windows Products) Preprocessors CD#1 Shared ICU Libraries for Teradata Teradata C Preprocessor2 Teradata Call-Level Interface version 2 (CLIv2) Teradata Generic Security Services Platforms (Windows) Product dependency Windows Product dependency Product Dependency Table 8: Preprocessors CD#2 (HP, Linux, and MP-RAS Products) Preprocessors CD#2 Shared ICU Libraries for Teradata Teradata C Preprocessor2 Platforms (HP-UX, Linux, and MP-RAS) Product dependency HP-UX, Linux, MP-RAS 34 Teradata Tools and Utilities Installation Guide for Microsoft Windows

35 Chapter 1: Introduction Installation Kit Table 8: Preprocessors CD#2 (HP, Linux, and MP-RAS Products) (continued) Preprocessors CD#2 Teradata Call-Level Interface version 2 (CLIv2) Teradata Cobol Preprocessor2 Teradata Generic Security Services Platforms (HP-UX, Linux, and MP-RAS) Product dependency HP-UX, MP-RAS Product dependency Table 9: Preprocessors CD#3 (AIX and Solaris Products) Preprocessors CD#3 Shared ICU Libraries for Teradata Teradata C Preprocessor2 Teradata Call-Level Interface version 2 (CLIv2) Teradata Cobol Preprocessor2 Teradata Generic Security Services Platforms (AIX and Solaris) Product dependency IBM AIX, Solaris SPARC, Solaris Opteron Product dependency IBM AIX Product dependency Table 10: Load/Unload CD#1 (Windows Products) Load/Unload CD#1 Basic Teradata Query (BTEQ) Teradata Access Module for JMS Named Pipes Access Module ODBC Driver for Teradata Shared ICU Libraries for Teradata Teradata Call-Level Interface version 2 (CLIv2) Teradata Data Connector Teradata FastExport Teradata FastLoad Teradata Generic Security Services Teradata MultiLoad Teradata OLE DB Access Module Teradata TPump Platforms (Windows) Product dependency Windows Windows Note: Named Pipes Access Module contains both the stand-alone version and the Teradata Parallel Transporter version. Product dependency Product dependency Product dependency Windows Windows Windows Product dependency Windows Windows Windows Teradata Tools and Utilities Installation Guide for Microsoft Windows 35

36 Chapter 1: Introduction Installation Kit Table 10: Load/Unload CD#1 (Windows Products) (continued) Load/Unload CD#1 WebSphere MQ Access Module Platforms (Windows) 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 Basic Teradata Query (BTEQ) Teradata Access Module for JMS Named Pipes Access Module Shared ICU Libraries for Teradata Teradata Call-Level Interface version 2 (CLIv2) Teradata Data Connector Teradata FastExport Teradata FastLoad Teradata Generic Security Services Teradata MultiLoad Teradata TPump WebSphere MQ Access Module Platforms (HP-UX, Linux, and MP-RAS) Product dependency HP-UX MP-RAS, HP-UX, Linux Product dependency Product dependency MP-RAS, HP-UX, Linux MP-RAS, HP-UX, Linux MP-RAS, HP-UX, Linux Product dependency MP-RAS, HP-UX, Linux MP-RAS, HP-UX, Linux 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 Basic Teradata Query (BTEQ) Teradata Access Module for JMS Named Pipes Access Module ODBC Driver for Teradata Platforms (AIX and Solaris) Product dependency Solaris SPARC Solaris SPARC, AIX Note: Named Pipes Access Module contains both the stand-alone version and the Teradata Parallel Transporter version. Product dependency 36 Teradata Tools and Utilities Installation Guide for Microsoft Windows

37 Chapter 1: Introduction Installation Kit Table 12: Load/Unload CD#3 (AIX and Solaris Products) (continued) Load/Unload CD#3 Shared ICU Libraries for Teradata Teradata Call-Level Interface version 2 (CLIv2) Teradata Data Connector Teradata FastExport Teradata FastLoad Teradata Generic Security Services Teradata MultiLoad Teradata TPump WebSphere MQ Access Module Platforms (AIX and Solaris) Product dependency Product dependency Solaris SPARC, AIX, Solaris Opteron Solaris SPARC, AIX, Solaris Opteron Solaris SPARC, AIX, Solaris Opteron Product dependency Solaris SPARC, AIX, Solaris Opteron Solaris SPARC, AIX, Solaris Opteron 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 Named Pipes Access Module Shared ICU Libraries for Teradata Teradata Call-Level Interface version 2 (CLIv2) Teradata Generic Security Services WebSphere MQ Access Module Platforms (Windows) Product dependency Note: Named Pipes Access Module contains both the stand-alone version and the Teradata Parallel Transporter version. Product dependency Product dependency Product dependency 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 Named Pipes Access Module Platforms (HP-UX, Linux, and MP-RAS) Product dependency Note: Named Pipes Access Module contains both the stand-alone version and the Teradata Parallel Transporter version. Teradata Tools and Utilities Installation Guide for Microsoft Windows 37

38 Chapter 1: Introduction Installation Kit Table 14: Parallel Transporter CD#2 (HP-UX, Linux, and MP-RAS Products) (continued) Parallel Transporter CD#2 Shared ICU Libraries for Teradata Teradata Call-Level Interface version 2 (CLIv2) Teradata Generic Security Services WebSphere MQ Access Module Platforms (HP-UX, Linux, and MP-RAS) Product dependency Product dependency Product dependency 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 Named Pipes Access Module Shared ICU Libraries for Teradata Teradata Call-Level Interface version 2 (CLIv2) Teradata Generic Security Services WebSphere MQ Access Module Platforms (AIX and Solaris) Product dependency Note: Named Pipes Access Module contains both the stand-alone version and the Teradata Parallel Transporter version. Product dependency Product dependency Product dependency 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 ODBC Driver for Teradata Shared ICU Libraries for Teradata Teradata Access Module for Tivoli Teradata Archive/Recovery Utility (ARC) Teradata C Preprocessor2 Teradata Call-Level Interface version 2 (CLIv2) Platforms (Windows, Linux, MP-RAS) Product dependency Product dependency Windows 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 Product dependency Product dependency 38 Teradata Tools and Utilities Installation Guide for Microsoft Windows

39 Chapter 1: Introduction Installation Kit Table 16: Tape Storage Management Enablers CD (continued) Tape Storage Management Enablers CD Teradata Data Connector Teradata Generic Security Services Platforms (Windows, Linux, MP-RAS) Product dependency Product dependency Table 17: Query Director CD Query Director CD Shared ICU Libraries for Teradata Teradata Call-Level Interface version 2 (CLIv2) Teradata Generic Security Services Teradata Query Director Platforms (Windows and Linux) Product dependency Product dependency Product dependency Windows, Linux Table 18: MetaData Services CD MetaData Services CD Meta Data Services Relay Services Gateway Platforms (MP-RAS, Linux, Windows) Linux, MP-RAS, Solaris SPARC Product dependency 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 Tools and Utilities Installation Guide for Microsoft Windows 39

40 Chapter 1: Introduction Installation Kit 40 Teradata Tools and Utilities Installation Guide for Microsoft Windows

41 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

42 Chapter 2: Before You Install Installation 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 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 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 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

43 Chapter 2: Before You Install Installation 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 Manager Teradata Performance Monitor Teradata Administrator Teradata Statistics Wizard Teradata Dynamic Workload Manager Teradata Query Scheduler Teradata SQL Assistant/Web Edition Teradata SQL Assistant 500 MHz Pentium III 256 MB RAM 10 GB Hard Drive (100 MB for TMGR) CD ROM Drive 500 MHz Pentium III 256 MB RAM 10 Mbps Network Interface Card or Modem 1024x768 SVGA Display 500 MHz Pentium III 64 MB RAM CD ROM Drive SVGA or better, Graphics Controller and Monitor Minimum 50 MB free disk space 1.2 GHz Pentium IV 512 MB RAM 2*18 GB Hard Drive (100 MB for TMGR) CD ROM Drive Modem (required to use the Send a Page action of the Alerts facility) 1.2 GHz Pentium IV 512 MB RAM 100 Mbps Network Interface Card 1024x768 SVGA Display CD ROM Drive or DVD Drive 2*18 GB Hard Drive Teradata Tools and Utilities Installation Guide for Microsoft Windows 43

44 Chapter 2: Before You Install Installation Recommendations Recommended Configurations The following table shows the recommended configurations for Teradata Tools and Utilities products. Table 20: Recommended Configurations for Teradata Tools and Utilities Product Client Server Teradata Manager Teradata Performance Monitor Teradata Administrator Teradata Statistics Wizard Teradata Dynamic Workload Manager Teradata Query Scheduler Teradata SQL Assistant/Web Edition Teradata SQL Assistant 1.2 GHz Pentium IV 512 MB RAM 40 GB Hard Drive (200 MB for TMGR) CD ROM Drive 1.2 GHz Pentium IV 256MB RAM 10 Mbps Network Interface Card or Modem 1024x768 SVGA Display 1.2 GHz Pentium IV 256 MB RAM CD ROM Drive SVGA or better, Graphics Controller and Monitor Minimum 100 MB free disk space 2 GHz Pentium IV 1 GB RAM 2*30 GB Hard Drive (200 MB for TMGR) CD ROM Drive Modem (required to use the Send a Page action of the Alerts facility) 2 GHz Pentium IV 1 GB RAM 100 Mbps Network Interface Card 1024x768 SVGA Display CD ROM Drive or DVD Drive 2*18 GB Hard Drive 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: 44 Teradata Tools and Utilities Installation Guide for Microsoft Windows

45 Chapter 2: Before You Install Installation Recommendations "ODBC Driver for Teradata 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 is already installed. Do you want to overwrite it with version ?" Teradata Generic Security Services PUT Installations 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. 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

46 Chapter 2: Before You Install Installation 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: --> 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 version will overwrite the previously released version of Teradata Parallel Transporter 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

47 Chapter 2: Before You Install Installation 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 Default Folders 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. The main folders on the application CDs are: Table 21: Default CD Folders The folder: Windows\Bin Windows\TTU\ClientISS Windows\TTU\setupdir Contains: files used for autorun. response files for products that need them to support silent installation. Files used in installation. 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: Teradata Tools and Utilities Installation Guide for Microsoft Windows 47

48 Chapter 2: Before You Install Installation 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 Basic Teradata Query (BTEQ) BTEQ.iss BTEQWin No product response file Named Pipes Access Module NamedPipes.iss ODBC Driver for Teradata odbc.iss Shared ICU Libraries for Teradata SharedICULibrariesforTeradata.iss SharedICULibrariesforTeradata64.iss Teradata Access Module for Tivoli Teradata_Access_Module_for_Tivoli.iss Teradata Access Module for JMS Teradata_JMS.iss Teradata Administrator No product response file Teradata Archive/Recovery Utility (ARC) ARC.iss Teradata C Preprocessor2 Preprocessor.iss Teradata Call-Level Interface version 2 (CLIv2) CLI_Module.iss CLI_Module64.iss Teradata Data Connector DataConnector.iss DataConnector64.iss Default Destination Folder (<Boot Drive>) %Program Files%\NCR\Teradata Client %Program Files%\NCR\Teradata Client %SystemRoot%\system32 %Program Files%\NCR\ODBC Driver for Teradata %Program Files%\NCR\Common Files\Shared ICU Libraries for Teradata\Lib %Program Files%\NCR\Teradata Client %Program Files%\Common Files\NCR\JMSAXSMOD %Program Files%\NCR\Teradata Administrator <version> %Program Files%\NCR\Teradata Client %Program Files%\NCR\Teradata Client <Boot Drive>:\Program Files\NCR\Teradata Client\cliv2 %SystemRoot%\system32 Default Program Folder Teradata Client Teradata Client None ODBC Driver for Teradata None Teradata Tivoli Access Module None Teradata Administrator <version> Teradata Client Teradata Client None None 48 Teradata Tools and Utilities Installation Guide for Microsoft Windows

49 Chapter 2: Before You Install Installation Recommendations Table 22: Default Folders and Product Response Files (continued) Product Teradata Dynamic Workload Manager (Teradata DWM) Teradata_Dynamic_Workload_Manager.iss Teradata Generic Security Services (TeraGSS) Client There is no product response file. Teradata Generic Security Services (TeraGSS Java) Client Java There is no product response file. Teradata FastExport FastExport.iss Teradata FastLoad FastLoad.iss Teradata Index Wizard Teradata_Index_Wizard.iss Teradata Manager TMgr.iss Teradata MultiLoad MultiLoad.iss Teradata MultiTool No product response file Teradata OLE DB Access Module OLE_DB_AM.iss Teradata Parallel Transporter ICU Library Teradata_Parallel_Transporter_ICU_Librar y.iss Teradata Performance Monitor Teradata_Performance_Monitor.iss Teradata Query Director Query_Director.iss Teradata Query Scheduler Administrator TDQM_Admin.iss Default Destination Folder (<Boot Drive>) %Program Files%\NCR\Teradata Dynamic Workload Manager<version> %Program Files%\NCR\Teradata GSS\nti386\<version> (for 32-bit) %Program Files%\NCR\Teradata GSS\nti386\<version> (for 64-bit) %Program Files%\NCR\Teradata Client %Program Files%\NCR\Teradata Client %Program Files%\NCR\Teradata Index Wizard <version> %Program Files%\NCR\Teradata Manager <version> %Program Files%\NCR\Teradata Client %Program Files%\NCR\Teradata MultiTool %Program Files%\NCR\Teradata Client \Program Files\NCR\Teradata Parallel Transporter\<version>\Bin %Program Files%\NCR\Teradata Performance Monitor %Program Files%\NCR\Teradata Query Director %Program Files%\NCR\Teradata Query Scheduler Admin <version> Default Program Folder None Same as Default Destination Folder Teradata Client Teradata Client Teradata Index Wizard <version> Teradata Manager <version> Teradata Client Teradata Client Teradata Client None Teradata Performance Monitor <version> Teradata Query Director <version> Teradata Query Scheduler Admin <version> Teradata Tools and Utilities Installation Guide for Microsoft Windows 49

50 Chapter 2: Before You Install Restarting After Installation Table 22: Default Folders and Product Response Files (continued) Product Teradata Query Scheduler Client TDQM_Client.iss Teradata Query Scheduler Server TDQM_Server.iss (use port number 3000) Teradata SQL Assistant No product response file Teradata SQL Assistant/Web Edition No product response file Teradata Statistics Wizard Teradata_Statistics_Wizard.iss Teradata System Emulation Tool Teradata_System_Emulation_Tool.iss Teradata TPump TPump.iss Teradata Visual Explain Visual_Explain.iss Teradata Workload Analyzer twa.iss WebSphere MQ Access Module WebSphere_Access_Module_for_Teradata.iss Default Destination Folder (<Boot Drive>) %Program Files%\NCR\Teradata Query Scheduler <version> %Program Files%\NCR\Teradata Query Scheduler Server <version>\server %Program Files%\NCR\Teradata SQL Assistant <version> \inetpub\wwwroot\<sqlassistantweb> a %Program Files%\NCR\Teradata Statistics Wizard <version> %Program Files%\NCR\Teradata System Emulation Tool <version> %Program Files%\NCR\Teradata Client %Program Files%\NCR\Teradata Visual Explain <version> \Program Files\NCR\Teradata Workload Analyzer 12.0 %Program Files%\Common Files\AXSMOD Default Program Folder Teradata Query Scheduler Utilities <version> None None None None Teradata System Emulation Tool <version> Teradata Client Teradata Visual Explain <version> None None 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. 50 Teradata Tools and Utilities Installation Guide for Microsoft Windows

51 Chapter 2: Before You Install Technical 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 Teradata Tools and Utilities Installation Guide for Microsoft Windows 51

52 Chapter 2: Before You Install Installing 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 Teradata Tools and Utilities Installation Guide for Microsoft Windows

53 Chapter 2: Before You Install Installing 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

54 Chapter 2: Before You Install Installing 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 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

55 Chapter 2: Before You Install Installing 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 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 : 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 Enable This allows you to save the query, history, or answer set. b Miscellaneous / Submit non encrypted form data: click Enable This allows you to submit HTML forms. c Scripting / Active scripting: click Enable This allows you to submit SQL queries. Teradata Tools and Utilities Installation Guide for Microsoft Windows 55

56 Chapter 2: Before You Install Installing 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 Enable Leave 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

57 Chapter 2: Before You Install Installing 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 b Unlimited This allows an unlimited number of connections to occur simultaneously. 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

58 Chapter 2: Before You Install Installing 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 b Unlimited This allows an unlimited number of connections to occur simultaneously. 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

59 Chapter 2: Before You Install Installing 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 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 recompiled with these updated header files in order to use Teradata PT API 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

60 Chapter 2: Before You Install Installing Required Software for Teradata SQL Assistant/Web Edition 60 Teradata Tools and Utilities Installation Guide for Microsoft Windows

61 CHAPTER 3 Installing the Teradata Tools and Utilities 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

62 Chapter 3: Installing the Teradata Tools and Utilities Software Installing 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

63 Chapter 3: Installing the Teradata Tools and Utilities Software Installing 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

64 Chapter 3: Installing the Teradata Tools and Utilities Software Installing Using the Client Main Install Typical Installation 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. 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

65 Chapter 3: Installing the Teradata Tools and Utilities Software Installing 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

66 Chapter 3: Installing the Teradata Tools and Utilities Software Installing Using the Client Main Install b c 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. Those not highlighted will be installed interactively, meaning that the product setup sequence will be activated so you can make adjustments during installation. 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 Teradata Tools and Utilities Installation Guide for Microsoft Windows

67 Chapter 3: Installing the Teradata Tools and Utilities Software Installing 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 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 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

68 Chapter 3: Installing the Teradata Tools and Utilities Software Installing 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\V \config 2 Locate the processmodel tag shown in the figure below. 68 Teradata Tools and Utilities Installation Guide for Microsoft Windows

69 Chapter 3: Installing the Teradata Tools and Utilities Software Installing 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: 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

70 Chapter 3: Installing the Teradata Tools and Utilities Software Installing 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

71 Chapter 3: Installing the Teradata Tools and Utilities Software Installing 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

72 Chapter 3: Installing the Teradata Tools and Utilities Software Installing 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 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 is not supported on Microsoft Windows 95, Windows 98, or Windows NT. If you attempt to install ODBC 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: 72 Teradata Tools and Utilities Installation Guide for Microsoft Windows

73 Chapter 3: Installing the Teradata Tools and Utilities Software Installing 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

74 Chapter 3: Installing the Teradata Tools and Utilities Software Installing Using the Client Main Install Custom Installation 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. 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

75 Chapter 3: Installing the Teradata Tools and Utilities Software Installing 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 b Select the check boxes for the products you want to install. 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 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

76 Chapter 3: Installing the Teradata Tools and Utilities Software Installing Using the Client Main Install 3 In the Select Install Method dialog box, select automatic (silent) or interactive installation for each product. a b c 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. The products not highlighted will be installed interactively, meaning that the product setup sequence will be activated so you can make adjustments during installation. Click Next. 76 Teradata Tools and Utilities Installation Guide for Microsoft Windows

77 Chapter 3: Installing the Teradata Tools and Utilities Software Installing 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

78 Chapter 3: Installing the Teradata Tools and Utilities Software Installing Using the Client Main Install Network Installation 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 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 b Select the boxes for the products whose setup files you want to copy. 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 Teradata Tools and Utilities Installation Guide for Microsoft Windows

79 Chapter 3: Installing the Teradata Tools and Utilities Software Installing 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

80 Chapter 3: Installing the Teradata Tools and Utilities Software Installing 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. Table 23: setup.exe Product Setup File Name Location All products setup.exe <folder name>\<product name> 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: 80 Teradata Tools and Utilities Installation Guide for Microsoft Windows

81 Chapter 3: Installing the Teradata Tools and Utilities Software Installing 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: Table 24: setup.exe command parameters Parameters... <response file> <setup log file> f1 parameter f2 parameter Description... This is the full pathname of the response file input to setup.exe. This is the full pathname of the log file output by setup.exe. This is an optional parameter if the response file is in the current directory and the file is named setup.iss. This is optional parameter. If it is not provided the log file will be created in the current directory as setup.log. 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" Teradata Tools and Utilities Installation Guide for Microsoft Windows 81

82 Chapter 3: Installing the Teradata Tools and Utilities Software Installing a Package from the Command Prompt Table 25: Command Prompt Installation Command Note: There is no white space between the f1 switch and the pathname of the response file. Product... Basic Teradata Query (BTEQ) ODBC Driver for Teradata Shared ICU Libraries for Teradata Teradata Access Module for JMS Teradata Access Module for Tivoli Teradata Administrator Teradata Archive and Recovery (ARC) Teradata C Preprocessor2 Teradata Call Level Interface version 2 (CLIv2) Teradata Data Connector Teradata Dynamic Workload Manager Teradata FastExport Teradata FastLoad Teradata Generic Security Services Teradata Index Wizard Commands... At the command prompt, type the command: setup.exe /s /f1"<response file>" /f2"<setup log file>" 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. 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. At the command prompt, type the command: setup.exe /s /f1"<response file>" /f2"<setup log file>" At the command prompt, type the command: setup.exe /s /f1"<response file>" /f2"<setup log file>" /w At the command prompt, type the command: setup.exe /s /v"/qn" At the command prompt, type the command: setup.exe /s /f1"<response file>" /f2"<setup log file>" At the command prompt, type the command: setup.exe /s /f1"<response file>" /f2"<setup log file>" At the command prompt, type the command: setup.exe /s /f1"<response file>" /f2"<setup log file>" At the command prompt, type the command: setup.exe /s /f1"<response file>" /f2"<setup log file>" /w At the command prompt, type the command: setup.exe /s /f1"<response file>" /f2"<setup log file>" /w At the command prompt, type the command: setup.exe /s /f1"<response file>" /f2"<setup log file>" /w At the command prompt, type the command: setup.exe /s /f1"<response file>" /f2"<setup log file>" /w At the command prompt, type the command: Setup.exe /s /v"/qn" 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

83 Chapter 3: Installing the Teradata Tools and Utilities Software Installing a Package from the Command Prompt Table 25: Command Prompt Installation Command (continued) Product... Teradata Manager Teradata MultiLoad Teradata Named Pipes Access Module Teradata OLE DB Access Module Teradata Parallel Transporter ICU Library Teradata Performance Monitor Teradata Query Director Teradata Query Scheduler Administrator Teradata Query Scheduler Client Teradata Query Scheduler Server Teradata SQL Assistant Teradata SQL Assistant/Web Edition Teradata Statistics Wizard Commands... 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 At the command prompt, type the command: Setup.exe /s /v"/qn" At the command prompt, type the command: setup.exe /s /f1"<response file>" /f2"<setup log file>" /w At the command prompt, type the command: setup.exe /s /f1"<response file>" /f2"<setup log file>" At the command prompt, type the command: setup.exe /s /f1"<response file>" /f2"<setup log file>" At the command prompt, type the command: setup.exe /s /f1"<response file>" /f2"<setup log file>" At the command prompt, type the command: setup.exe /s /f1"<response file>" /f2"<setup log file>" At the command prompt, type the command: setup.exe /s /f1"<response file>" /f2"<setup log file>" At the command prompt, type the command: setup.exe /s /f1"<response file>" /f2"<setup log file>" At the command prompt, type the command: setup.exe /s /f1"<response file>" /f2"<setup log file>" At the command prompt, type the command: Setup.exe /s /v"/qn" without test database: Setup.exe /s /v"/qn TESTDBSSELECTED=0" At the command prompt, type the command: Setup.exe /s /v"/qn" At the command prompt, type the command: setup.exe /s /f1"<response file>" /f2"<setup log file>" Teradata Tools and Utilities Installation Guide for Microsoft Windows 83

84 Chapter 3: Installing the Teradata Tools and Utilities Software Installing the Teradata Driver for the JDBC Interface Table 25: Command Prompt Installation Command (continued) Product... Teradata System Emulation Tool Teradata TPump Teradata Visual Explain Teradata Workload Analyzer Websphere Access Module for Teradata Websphere MQ Access Module Web Tools Commands... At the command prompt, type the command: setup.exe /s /f1"<response file>" /f2"<setup log file>" At the command prompt, type the command: setup.exe /s /f1"<response file>" /f2"<setup log file>" /w At the command prompt, type the command: setup.exe /s /f1"<response file>" /f2"<setup log file>" At the command prompt, type the command: setup.exe /s /f1"<response file>" /f2"<setup log file>" At the command prompt, type the command: setup.exe /s /f1"<response file>" /f2"<setup log file>" /w At the command prompt, type the command: setup.exe /s /f1"<response file>" /f2"<setup log file>" /w At the command prompt, type the command: setup.exe /s /v"/qn" 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: --> 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. 84 Teradata Tools and Utilities Installation Guide for Microsoft Windows

85 Chapter 3: Installing the Teradata Tools and Utilities Software Installing 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: --> 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

86 Chapter 3: Installing the Teradata Tools and Utilities Software Installing the OLE DB Provider for Teradata from the Download Center 86 Teradata Tools and Utilities Installation Guide for Microsoft Windows

87 CHAPTER 4 Configuring the Teradata Tools and Utilities 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

88 Chapter 4: Configuring the Teradata Tools and Utilities Software Configuring 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... ODBC Driver for Teradata Teradata Query Scheduler Administrator Teradata Query Scheduler Client Teradata Query Scheduler Server Teradata Manager Do the following... 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 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 For information on configuring the Teradata Query Scheduler Client refer to the: Teradata Query Scheduler User Guide 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 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

89 Chapter 4: Configuring the Teradata Tools and Utilities Software Configuring 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... Teradata Database on an AP platform (System 3600) Teradata Database on a V2 Computer (UNIX) Add entries corresponding to the... APs nodes Teradata Tools and Utilities Installation Guide for Microsoft Windows 89

90 Chapter 4: Configuring the Teradata Tools and Utilities Software Configuring 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... a.b.c.d dbcname COPn aliascopn is... 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. 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). 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. 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

91 Chapter 4: Configuring the Teradata Tools and Utilities Software Configuring 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 and on the same logical TCP/IP LAN. Each AP is assigned two alias names. In this case, add these lines to the hosts file: dbcnode1 dbccop1 ncrcop 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: Table 29: Environment Parameters Parameter... COPLIB COPANOMLOG defines... the path to the CLIv2 system parameter block file, clispb.dat. 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. 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 30: Setting Environment Parameters To set environment parameters in... Windows 2000 Windows XP or Windows Server 2003 go to... Start > Control Panel > System, then select the Advanced tab, then click on Environment Variables. Start > Control Panel > System, then select the Advanced tab, then click on Environment Variables. Teradata Tools and Utilities Installation Guide for Microsoft Windows 91

92 Chapter 4: Configuring the Teradata Tools and Utilities Software Configuring 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: Table 31: Logon Parameters Parameter... machine_name cops is... the name of the machine. the number of COPS. 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. Table 32: Setting <machine name> To set environment parameters in... Windows 2000 Windows XP or Windows Server 2003 go to... Start > Control Panel > System, then select the Advanced tab, then click on Environment Variables. Start > Control Panel > System, then select the Advanced tab, then click on Environment Variables. 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 33: Port Number Parameters Parameter... nnnn is... the port number. 92 Teradata Tools and Utilities Installation Guide for Microsoft Windows

93 Chapter 4: Configuring the Teradata Tools and Utilities Software Configuring Teradata Call-Level Interface version 2 (CLIv2) for Windows Table 34: Setting TDMSTPORT To set environment parameters in... Windows 2000 Windows XP or Windows Server 2003 go to... Start > Control Panel > System, then select the Advanced tab, then click on Environment Variables. Start > Control Panel > System, then select the Advanced tab, then click on Environment Variables. 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" Teradata Tools and Utilities Installation Guide for Microsoft Windows 93

94 Chapter 4: Configuring the Teradata Tools and Utilities Software Configuring 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

95 Chapter 4: Configuring the Teradata Tools and Utilities Software Configuring 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 \\ 3 Save the change. 4 Quit the editor. The C:\Logs\Teradata Parallel Transporter 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:\> tbuild Teradata Parallel Transporter Run Utility Version Teradata Tools and Utilities Installation Guide for Microsoft Windows 95

96 Chapter 4: Configuring the Teradata Tools and Utilities Software Configuring 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

97 Chapter 4: Configuring the Teradata Tools and Utilities Software Configuring 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 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 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

98 Chapter 4: Configuring the Teradata Tools and Utilities Software Configuring 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

99 Chapter 4: Configuring the Teradata Tools and Utilities Software Configuring 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

100 Chapter 4: Configuring the Teradata Tools and Utilities Software Configuring Teradata Parallel Transporter 100 Teradata Tools and Utilities Installation Guide for Microsoft Windows

101 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

102 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

103 Chapter 5: Verifying the Installation Verifying 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 Help bteq.exe bteqwin.exe bteqwin_enu.cnt bteqwin_enu.hlp bteqwin_jpn.cnt bteqwin_jpn.hlp <Boot Drive>:\Program Files\NCR\Teradata Client\bin <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

104 Chapter 5: Verifying the Installation Verifying the Installation of Individual Products Table 35: Basic Teradata Query (BTEQ) Files 32-bit Platforms (continued) BTEQ for Windows 32-bit platforms Library Sample caputl.dll mfc71.dll mfc71u.dll msvcr71.dll btnfyext.c btnfyext.def btnfyext.h btnfyext.mak %SystemRoot%\system32 <Boot Drive>:\Program Files\NCR\Teradata Client\btnfy Verifying Named Pipes Access Module 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 Verifying ODBC Driver for Teradata 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

105 Chapter 5: Verifying the Installation Verifying the Installation of Individual Products 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 Verifying Shared ICU Libraries 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

106 Chapter 5: Verifying the Installation Verifying the Installation of Individual Products 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 Verifying Teradata Access Module for JMS 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 Verifying Teradata Access Module for Tivoli 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

107 Chapter 5: Verifying the Installation Verifying the Installation of Individual Products Verifying Teradata Archive/Recovery Utility (ARC) 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 Verifying Teradata C Preprocessor2 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 Verifying Teradata Call-Level Interface version 2 (CLIv2) 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

108 Chapter 5: Verifying the Installation Verifying the Installation of Individual Products Table 45: Teradata Call-Level Interface version 2 (CLIv2), 32-bit Files (continued) CLIv2 for Windows 32-bit platforms Include Library User Exit Dynamic Link Library cliv2if.h coperr.h coptypes.h dbcacnx.h dbcarea.h dbcerr.h dbchqep.h mosiif.h nojunk.h parcel.h resource.h wincliv2.h tdusr32.lib wincli32.lib CliLgnEx.c CliPPS.c tdusr.def tdusr.rc userexit.mak wincli32.dll tdusr32.dll terasso.dll localisation.dll <Boot Drive>:\Program Files\NCR\Teradata Client\cliv2\inc <Boot Drive>:\Program Files\NCR\Teradata Client\cliv2\lib <Boot Drive>:\Program Files\NCR\Teradata Client\cliv2\UserExit <Boot Drive>:\Program Files\NCR\Teradata Client\cliv2 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

109 Chapter 5: Verifying the Installation Verifying the Installation of Individual Products Table 46: Teradata Call-Level Interface version 2 (CLIv2), 64-bit Files (continued) CLIv2 for Windows 64-bit platforms Include Library User Exit Dynamic Link Library cliv2if.h coperr.h coptypes.h dbcacnx.h dbcarea.h dbcerr.h dbchqep.h mosiif.h nojunk.h parcel.h resource.h wincliv2.h tdusr32.lib wincli32.lib CliLgnEx.c CliPPS.c tdusr.def tdusr.rc userexit.mak wincli32.dll tdusr32.dll terasso.dll localisation.dll <Boot Drive>:\Program Files\NCR\Teradata Client\cliv2\inc <Boot Drive>:\Program Files\NCR\Teradata Client\cliv2\lib <Boot Drive>:\Program Files\NCR\Teradata Client\cliv2\UserExit <Boot Drive>:\Program Files\NCR\Teradata Client\cliv2 Verifying Teradata Data Connector 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

110 Chapter 5: Verifying the Installation Verifying the Installation of Individual Products 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 Verifying Teradata Driver for the JDBC Interface 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 Verifying Teradata Dynamic Workload Manager 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 Teradata Tools and Utilities Installation Guide for Microsoft Windows

111 Chapter 5: Verifying the Installation Verifying the Installation of Individual Products Table 50: Teradata Dynamic Workload Manager Files (continued) Teradata Dynamic Workload Manager for Windows 32-bit platforms 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 Verifying Teradata FastExport 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 Verifying Teradata FastLoad 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

112 Chapter 5: Verifying the Installation Verifying the Installation of Individual Products Table 52: Teradata FastLoad 32-bit Files (continued) Teradata FastLoad for Windows 32-bit platforms Sample blkexit.c blkexit.mak blkexitr.c flnfyext.c <Boot Drive>:\Program Files\NCR\Teradata Client\fastload Verifying Teradata MultiLoad 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 Verifying Teradata MultiTool Table 54: Teradata MultiTool 32-bit Files Teradata MultiTool for Windows 32-bit platforms File Type File Name Default Folder Classes Executable Library Miscellaneous jhall.jar pdecui.jar sfc.jar symbeans.jar cnstool.exe winjavaloader.exe libnetpde.dll msvcrtd.dll td.ico version.txt <Boot Drive>:\Program Files\NCR\Teradata MultiTool <Boot Drive>:\Program Files\NCR\Teradata MultiTool <Boot Drive>:\Program Files\NCR\Teradata MultiTool <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

113 Chapter 5: Verifying the Installation Verifying the Installation of Individual Products Verifying Teradata OLE DB Access Module 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 Help msvcr71.dll OLEDB_AXSMOD.dll OLEDB_AXSMODenu.dll OLEDB_AXSMODjpn.dll Uninst.dll OLEDB_AXSMODenu.cnt OLEDB_AXSMODENU.hlp OLEDB_AXSMODjpn.cnt OLEDB_AXSMODJPN.hlp <Boot Drive>:\Program Files\Common Files\NCR\AXSMOD <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 Verifying Teradata Parallel Transporter API Table 56: 32-bit Teradata Parallel Transporter API API: Windows 32-bit platforms File Type File Name Default Folder Library Header telapi.dll telapi.lib DMLGroup.h Schema.h Connection.h <Boot Drive>:\Program Files\NCR\Teradata Parallel Transporter\<version>\bin <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

114 Chapter 5: Verifying the Installation Verifying the Installation of Individual Products Table 56: 32-bit Teradata Parallel Transporter API (continued) API: Windows 32-bit platforms 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 Header Header Header common.h Mutex.h PerfTestMessage.h TestBase.h TestExport.h TestLoad.h TestSim.h TestStream.h TestUpdate.h ThreadTest.h ThreadTestParameters.h DMLGroup.h Schema.h Connection.h OptionsManager.cpp OptionsManager.h 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\threads\inc <Boot Drive>:\Program Files\NCR\Teradata Parallel Transporter\<version>\tptapi\sample\inc <Boot Drive>:\Program Files\NCR\Teradata Parallel Transporter\<version>\tptapi\sample\common <Boot Drive>:\Program Files\NCR\Teradata Parallel Transporter\<version>\tptapi\sample\checkpoint 114 Teradata Tools and Utilities Installation Guide for Microsoft Windows

115 Chapter 5: Verifying the Installation Verifying the Installation of Individual Products Table 56: 32-bit Teradata Parallel Transporter API (continued) API: Windows 32-bit platforms Header Header Header GenericDriver.cpp main.cpp input.txt infile.littleendian generic.vcproj generic.sln cleanuptables.bteq setuptables.bteq BlockLoad.cpp main.cpp input.txt infile.littleendian blockload.vcproj blockload.sln cleanuptables.bteq setuptables.bteq 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\generic <Boot Drive>:\Program Files\NCR\Teradata Parallel Transporter\<version>\tptapi\sample\blockloading <Boot Drive>:\Program Files\NCR\Teradata Parallel Transporter\<version>\tptapi\sample\multi_node Teradata Tools and Utilities Installation Guide for Microsoft Windows 115

116 Chapter 5: Verifying the Installation Verifying the Installation of Individual Products Table 56: 32-bit Teradata Parallel Transporter API (continued) API: Windows 32-bit platforms Header Get Buffer 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 GetBuffer.cpp main.cpp cleanuptables.bteq setuptables.bteq getbuffer.sln getbuffer.vcproj input.txt <Boot Drive>:\Program Files\NCR\Teradata Parallel Transporter\<version>\tptapi\sample\threads $INSTALLDIR/tptapi/sample/getbuffer Include GetBuffer.h $INSTALLDIR/tptapi/sample/getbuffer/inc 116 Teradata Tools and Utilities Installation Guide for Microsoft Windows

117 Chapter 5: Verifying the Installation Verifying the Installation of Individual Products Table 56: 32-bit Teradata Parallel Transporter API (continued) API: Windows 32-bit platforms 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 57: 64-bit Teradata Parallel Transporter API API: Windows 64-bit platforms File Type File Name Default Folder Library Header telapi.dll telapi.lib DMLGroup.h Schema.h Connection.h <Boot Drive>:\Program Files\NCR\Teradata Parallel Transporter\<version>\bin64 <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

118 Chapter 5: Verifying the Installation Verifying the Installation of Individual Products Table 57: 64-bit Teradata Parallel Transporter API (continued) API: Windows 64-bit platforms Header Header Header Header Header common.h Mutex.h PerfTestMessage.h TestBase.h TestExport.h TestLoad.h TestSim.h TestStream.h TestUpdate.h ThreadTest.h ThreadTestParameters.h DMLGroup.h Schema.h Connection.h OptionsManager.cpp OptionsManager.h checkpoint.cpp main.cpp input.txt infile.littleendian checkpoint64.vcproj checkpoint64.sln cleanuptables.bteq setuptables.bteq 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\threads\inc <Boot Drive>:\Program Files\NCR\Teradata Parallel Transporter\<version>\tptapi\sample\inc <Boot Drive>:\Program Files\NCR\Teradata Parallel Transporter\<version>\tptapi\sample\common <Boot Drive>:\Program Files\NCR\Teradata Parallel Transporter\<version>\tptapi\sample\checkpoint <Boot Drive>:\Program Files\NCR\Teradata Parallel Transporter\<version>\tptapi\sample\generic 118 Teradata Tools and Utilities Installation Guide for Microsoft Windows

119 Chapter 5: Verifying the Installation Verifying the Installation of Individual Products Table 57: 64-bit Teradata Parallel Transporter API (continued) API: Windows 64-bit platforms Header Header BlockLoad.cpp main.cpp input.txt infile.littleendian blockload64.vcproj blockload64.sln cleanuptables.bteq setuptables.bteq 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\blockloading <Boot Drive>:\Program Files\NCR\Teradata Parallel Transporter\<version>\tptapi\sample\multi_node Teradata Tools and Utilities Installation Guide for Microsoft Windows 119

120 Chapter 5: Verifying the Installation Verifying the Installation of Individual Products Table 57: 64-bit Teradata Parallel Transporter API (continued) API: Windows 64-bit platforms Header Get Buffer 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 GetBuffer.cpp main.cpp cleanuptables.bteq setuptables.bteq getbuffer64.sln getbuffer.64vcproj input.txt <Boot Drive>:\Program Files\NCR\Teradata Parallel Transporter\<version>\tptapi\sample\threads $INSTALLDIR/tptapi/sample/getbuffer Include GetBuffer.h $INSTALLDIR/tptapi/sample/getbuffer/inc 120 Teradata Tools and Utilities Installation Guide for Microsoft Windows

121 Chapter 5: Verifying the Installation Verifying the Installation of Individual Products Table 57: 64-bit Teradata Parallel Transporter API (continued) API: Windows 64-bit platforms 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 Verifying Teradata Parallel Transporter Data Connector Operator 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 UninstDataConnectorOp 12.0.isu <Boot Drive>:\Program Files\NCR\Teradata Parallel Transporter\<version> Verifying Teradata Parallel Transporter DDL Operator 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

122 Chapter 5: Verifying the Installation Verifying the Installation of Individual Products Verifying Teradata Parallel Transporter Export Operator 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 Verifying Teradata Parallel Transporter ICU Library 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>\bin Teradata Tools and Utilities Installation Guide for Microsoft Windows

123 Chapter 5: Verifying the Installation Verifying 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 Folder Executable twbcfg.ini twboper.ini checkpoint logs 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> <Boot Drive>:\Program Files\NCR\Teradata Parallel Transporter\<version> <Boot Drive>:\Program Files\NCR\Teradata Parallel Transporter\<version>\bin Teradata Tools and Utilities Installation Guide for Microsoft Windows 123

124 Chapter 5: Verifying the Installation Verifying the Installation of Individual Products Table 64: Teradata Parallel Transporter Infrastructure Files (continued) Teradata Parallel Transporter Infrastructure: Windows 32-bit platforms Header Library pxdtypes.h pxtypes.h pxmacros.h pxoper.h pxos.h pxstc.h pxdef.h pxlogdef.h pxutypes.h pxversion.h 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>\sdk\inc <Boot Drive>:\Program Files\NCR\Teradata Parallel Transporter\<version>\bin Message Catalog twbmsgs.dll <Boot Drive>:\Program Files\NCR\Teradata Parallel Transporter\<version>\msg 124 Teradata Tools and Utilities Installation Guide for Microsoft Windows

125 Chapter 5: Verifying the Installation Verifying the Installation of Individual Products Table 64: Teradata Parallel Transporter Infrastructure Files (continued) Teradata Parallel Transporter Infrastructure: Windows 32-bit platforms Sample Sample Sample Sample Uninstall GT11.txt GT44.txt GT62.txt GT93.txt GT94.txt GT95.txt GT96.txt GT97.txt jobvars.txt sampleoperator.dsw sampleoperator.dsp samplefilter.cpp data.in samplescript.txt sql1.txt sql2.txt twb_status.txt twb_targets.txt uninst.dll UninstTTPTInfrastructur e12.0.isu <Boot Drive>:\Program Files\NCR\Teradata Parallel Transporter\<version>\sample\etl <Boot Drive>:\Program Files\NCR\Teradata Parallel Transporter\<version>\sdk\src <Boot Drive>:\Program Files\NCR\Teradata Parallel Transporter\<version>\sdk\sample <Boot Drive>:\Program Files\NCR\Teradata Parallel Transporter\<version>\sample\metadata <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 Verifying Teradata Parallel Transporter Load Operator 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

126 Chapter 5: Verifying the Installation Verifying the Installation of Individual Products 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 Verifying Teradata Parallel Transporter ODBC Operator 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> Verifying Teradata Parallel Transporter Operator Support Library 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>\msg Teradata Tools and Utilities Installation Guide for Microsoft Windows

127 Chapter 5: Verifying the Installation Verifying the Installation of Individual Products Verifying Teradata Parallel Transporter OS Command 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> Verifying Teradata Parallel Transporter SQL Inserter Operator 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> Verifying Teradata Parallel Transporter SQL Selector Operator 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

128 Chapter 5: Verifying the Installation Verifying the Installation of Individual Products Verifying Teradata Parallel Transporter Stream 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 Verifying Teradata Parallel Transporter Update Operator 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

129 Chapter 5: Verifying the Installation Verifying 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 Java Binary jre help tdgssjava.jar terajdbc4.jar tptwizard.jar tdgssconfig.jar <Boot Drive>:\Program Files\NCR\Teradata Parallel Transporter\<version>\tptwizard <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 Startup Transformation Uninstall guisrv.dll wwhelp.dll runtbuild.cmd tptwizard.cmd 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 UninstTPTWizard12.0.is u <Boot Drive>:\Program Files\NCR\Teradata Parallel Transporter\<version>\bin <Boot Drive>:\Program Files\NCR\Teradata Parallel Transporter\<version>\tptwizard <Boot Drive>:\Program Files\NCR\Teradata Parallel Transporter\<version>\tptwizard\transformation <Boot Drive>:\Program Files\NCR\Teradata Parallel Transporter\<version>\tptwizard Teradata Tools and Utilities Installation Guide for Microsoft Windows 129

130 Chapter 5: Verifying the Installation Verifying the Installation of Individual Products Verifying Teradata Query Scheduler Administrator 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 (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 Verifying Teradata Query Scheduler Client 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 Library tdqmcomm.exe tdqmops.exe tdqmview.exe tdqmcomm.dll tdqmsr.dll tdqmsubm.dll <Boot Drive>:\Program Files\NCR\Teradata Query Scheduler\client %SystemRoot%\system32 Readme readme.txt <Boot Drive>:\Program Files\NCR\Teradata Query Scheduler\client Verifying Teradata Query Scheduler Server 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 Library tdqmjob.exe tdqmlsnr.exe tdqmreqp.exe tdqmserv.exe tdqmserv.dll tdsqlprs.dll <Boot Drive>:\Program Files\NCR\Teradata Query Scheduler\server %SystemRoot%\system Teradata Tools and Utilities Installation Guide for Microsoft Windows

131 Chapter 5: Verifying the Installation Verifying the Installation of Individual Products Table 80: Teradata Query Scheduler Server 32-bit Files (continued) Teradata Query Scheduler Server for Windows 32-bit platforms Parser sqlprs.dfa sqlprs.llr <Boot Drive>:\Program Files\NCR\Teradata Query Scheduler\server Verifying Teradata TPump 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 Verifying WebSphere MQ Access Module 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 Verifying Teradata Workload Analyzer 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

132 Chapter 5: Verifying the Installation Verifying the Installation Using the CLI Sample Program, clisamp Table 83: Teradata Workload Analyzer Files (continued) Teradata Workload Analyzer for Windows 32-bit platforms 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 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 132 Teradata Tools and Utilities Installation Guide for Microsoft Windows

133 Chapter 5: Verifying the Installation Verifying 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: # clisamp CLIv2 version is MTDP version is MOSIOS version is MOSIDEP version is OSERR version is Logging on to --->dbc/systemfe,service writing out to--> CLISAMP.DAT submitting -->select* from dbc.sessioninfo; writing out to --> CLISAMP.DAT Logging off. Teradata Tools and Utilities Installation Guide for Microsoft Windows 133

134 Chapter 5: Verifying the Installation Verifying the Installation Using the CLI Sample Program, clisamp 134 Teradata Tools and Utilities Installation Guide for Microsoft Windows

135 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

136 Chapter 6: Connecting to a Teradata Database Making 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