Teradata Tools and Utilities. Installation Guide for UNIX and Linux

Transcription

1 Teradata Tools and Utilities Installation Guide for UNIX and Linux 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 Teradata Tools and Utilities version products on a client system that runs on NCR UNIX SVR4 MP-RAS, IBM AIX, HP-UX, Sun Solaris or Linux operating systems. Teradata Tools and Utilities is a group of products designed to work with Teradata Database. Audience This book is intended for use by: System and application programmers System administrators Database administrators and 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. Teradata Tools and Utilities Installation Guide for UNIX and Linux 3

4 Preface Prerequisites Prerequisites The following prerequisite knowledge is required for this product: Computer technology Database management systems Utilities that load and retrieve data Changes to This Book The following changes were made to this book in support of the current release. Changes are marked with change bars. For a complete list of changes to the product, see the Teradata Tools and Utilities Release Definition associated with this release. Date and Release 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. 4 Teradata Tools and Utilities Installation Guide for UNIX and Linux

5 Preface Additional Information 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. Teradata Tools and Utilities Installation Guide for UNIX and Linux 5

6 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 6 Teradata Tools and Utilities Installation Guide for UNIX and Linux

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 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 Operator Programmer 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 Teradata Tools and Utilities Installation Guide for UNIX and Linux 7

8 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. 8 Teradata Tools and Utilities Installation Guide for UNIX and Linux

9 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. Teradata Tools and Utilities Installation Guide for UNIX and Linux 9

10 Preface Additional Information 10 Teradata Tools and Utilities Installation Guide for UNIX and Linux

11 Table of Contents Preface Purpose Audience Supported Releases Prerequisites Changes to This Book Additional Information Chapter 1: Introduction Teradata Tools and Utilities What is Teradata Tools and Utilities? Definitions of Client and Server System Requirements Software Requirements Product Dependencies Installation Order Installation Kit Contents Teradata Software Server IBM VM and IBM z/os Teradata Driver for the JDBC Interface Teradata Tools and Utilities CDs Chapter 2: Before You Install Installation Recommendations Installing Upgrade or Maintenance Software Installation of Dependent Products Teradata Generic Security Services Upgrading TPump Upgrading C/COBOL Preprocessor Teradata Tools and Utilities Installation Guide for UNIX and Linux 11

12 Table of Contents PUT Installations pkgplus Installations pkgadd Installations Available Disk Space LD_LIBRARY_PATH, SHLIB_PATH and LIBPATH DUL/DULT Teradata Parallel Transporter Teradata Parallel Transporter Package Names Removing Teradata Warehouse Builder and Teradata Parallel Transporter Packages...52 Teradata Parallel Transporter Install Information File Switching Versions of Teradata Parallel Transporter Software Teradata Generic Security Services TeraGSS Package Names Removing TeraGSS Packages Switching Versions of TeraGSS Software Updating the Teradata Parallel Transporter API Technical Assistance Chapter 3: Installing on MP-RAS Client Systems Installing Individual Products Installation CD-ROMs MP-RAS Packages Uninstalling Previous Versions of Software Teradata Parallel Transporter Default and Alternate Directory Installing the Teradata Tools and Utilities Installing Teradata Parallel Transporter Adding CLI User Exit Functions Chapter 4: Installing on IBM AIX Client Systems Installing Individual Products Installation CD-ROMs IBM AIX Packages Removing Previous Versions of Software Software Name Truncation Teradata Parallel Transporter Default and Alternate Directory Teradata Tools and Utilities Installation Guide for UNIX and Linux

13 Table of Contents Installing Teradata Tools and Utilities Installing the Teradata Driver for the JDBC Interface Installing the Teradata Access Module for JMS Installing Teradata Parallel Transporter Adding CLI User Exit Functions Chapter 5: Installing on HP-UX Client Systems Installing Individual Products Installation CD-ROMs HP-UX Packages Uninstalling Previous Versions of Software Uninstalling at the Terminal Interface Window Teradata Parallel Transporter Default and Alternate Directory Installing the Teradata Tools and Utilities Installing Teradata Tools and Utilities Products Silently Installing Teradata Tools and Utilities Products Interactively Installing the Teradata Driver for the JDBC Interface Installing Teradata Parallel Transporter Adding CLI User Exit Functions Chapter 6: Installing on Sun Solaris SPARC Client Systems Installing Individual Products Installation CD-ROMs Sun Solaris Packages Uninstalling Previous Versions of Software Default and Alternate Directories Screen Navigation Solaris Zones Installing Teradata Tools and Utilities Installing the Teradata Driver for the JDBC Interface Installing Teradata Parallel Transporter Adding CLI User Exit Functions Teradata Tools and Utilities Installation Guide for UNIX and Linux 13

14 Table of Contents Chapter 7: Installing on Sun Solaris Opteron Client Systems Installing Individual Products Installation CD-ROMs Sun Solaris Packages Uninstalling Previous Versions of Software Default and Alternate Directories Solaris Zones Installing Teradata Tools and Utilities Installing the Teradata Driver for the JDBC Interface Installing Teradata Parallel Transporter Adding CLI User Exit Functions Chapter 8: Installing on Red Hat Linux Client Systems Installing Individual Products Installation of Teradata Tools and Utilities Products Using PUT Installation CD-ROMs Linux Packages Removing Previous Versions of Software Installing Teradata Tools and Utilities Installing Teradata Tools and Utilities Products Silently Installing Teradata Tools and Utilities Products Interactively Installing the Teradata Driver for the JDBC Interface Installing the Teradata Access Module for JMS Installing Teradata Parallel Transporter Adding CLI User Exit Functions Chapter 9: Installing on SUSE Linux Client Systems Installing Individual Products Installation of Teradata Tools and Utilities Products Using PUT Teradata Tools and Utilities Installation Guide for UNIX and Linux

15 Table of Contents Installation CD-ROMs Linux Packages Removing Previous Versions of Software Installing Teradata Tools and Utilities Installing Teradata Tools and Utilities Products Silently Installing Teradata Tools and Utilities Products Interactively Installing the Teradata Driver for the JDBC Interface Installing the Teradata Access Module for JMS Adding CLI User Exit Functions Chapter 10: Configuring Teradata Tools and Utilities Configuring Environment Variables for CLIv2 and Data Connector Setting the Environment Variables Configuring the ODBC Driver for Teradata Configuring the ODBC Driver for MP-RAS Configuring the ODBC Driver for IBM AIX Configuring the ODBC Driver for HP-UX Configuring the ODBC Driver for Solaris Configuring the ODBC Driver for Linux Configuring Teradata Access Module for JMS Configuring Teradata Parallel Transporter Configuring Teradata Parallel Transporter for MP-RAS Configuring Teradata Parallel Transporter for IBM AIX Configuring Teradata Parallel Transporter for HP-UX Configuring Teradata Parallel Transporter for Solaris Configuring Teradata Parallel Transporter for Red Hat Linux Chapter 11: After You Install Verifying the Installation of Individual Products Verifying Basic Teradata Query (bteq) Verifying Named Pipes Access Module (npaxsmod) Verifying ODBC Driver for Teradata (tdodbc) Verifying Shared Common Components for Internationalization for Teradata (tdicu) Verifying Teradata Access Module for JMS Teradata Tools and Utilities Installation Guide for UNIX and Linux 15

16 Table of Contents Verifying Teradata Call-Level Interface version 2 (cliv2) Verifying Teradata C Preprocessor2 (sqlpp) Verifying Teradata COBOL Preprocessor2 (cobpp) Verifying Teradata Data Connector (piom) Verifying Teradata Driver for the JDBC Interface Verifying Teradata FastExport (fastexp) Verifying Teradata FastLoad (fastld) Verifying Teradata Generic Security Services (TeraGSS) Verifying Teradata MultiLoad (mload) Verifying Teradata TPump (tpump) Verifying Teradata Parallel Transporter API (papic000) Verifying Teradata Parallel Transporter Data Connector Operator (pdtcc000) Verifying Teradata Parallel Transporter DDL Operator (pddlc000) Verifying Teradata Parallel Transporter Export Operator (pexpc000) Verifying Teradata Parallel Transporter ICU Library(picuc000) Verifying Teradata Parallel Transporter Infrastructure (tbldc000) Verifying Teradata Parallel Transporter Load Operator (plodc000) Verifying Teradata Parallel Transporter ODBC Operator (podbcc000) Verifying Teradata Parallel Transporter Operator Support Library (poslc000) Verifying Teradata Parallel Transporter OS Command Operator (poscc000) Verifying Teradata Parallel Transporter SQL Inserter Operator (pinsc000) Verifying Teradata Parallel Transporter SQL Selector Operator (pselc000) Verifying Teradata Parallel Transporter Stream Operator (pstmc000) Verifying Teradata Parallel Transporter Update Operator (pupdc000) Verifying WebSphere MQ Access Module (mqaxsmod) Verifying the Installation Using BTEQ Log on to the Teradata Database Submit a Sample Teradata SQL Query Exit BTEQ Verifying the Installation Using the CLI Sample Program Run clisamp Teradata Tools and Utilities Installation Guide for UNIX and Linux

17 Table of Contents Chapter 12: 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 13: Troubleshooting Technical Assistance Client Computer Problems Cannot Communicate Over the Network with Teradata Database Incorrect Path Name in COPLIB Incorrect Path Name in COPERR errmsg.cat File Not Found Incorrect Path Name in COPANOMLOG Missing Hosts File Incorrect Entries in the Hosts File Missing Entries in the /etc/services File Improper Linking Incorrect clispb.dat Parameters Cannot Log On from CLI Application Cannot Log On to the Teradata Database Not Enough Shared Virtual Memory to Run Some Processes on NCR MP-RAS Network Problems Teradata Database Problems Teradata Parallel Transporter Unable to Find tbuild Cannot Run the New Installed Version of Teradata Parallel Transporter Failed to Load libpxcommon Library Unable to Find Messages Teradata Tools and Utilities Installation Guide for UNIX and Linux 17

18 Table of Contents Appendix A: Session Limits BTEQ Session Limits System-Wide Session Limits Index Teradata Tools and Utilities Installation Guide for UNIX and Linux

19 List of Figures Figure 1: Typical Connect to Teradata Database Dialog Teradata Tools and Utilities Installation Guide for UNIX and Linux 19

20 List of Figures 20 Teradata Tools and Utilities Installation Guide for UNIX and Linux

21 List of Tables Table 1: Teradata Tools and Utilities supported on UNIX and Linux Table 2: Definition of Client and Server Table 3: Product Dependencies Table 4: Teradata Utility Pak CD#1 (Windows Products) Table 5: Teradata Utility Pak CD#2 (HP-UX, Linux and MP-RAS Products) Table 6: Teradata Utility Pak CD#3 (AIX and Solaris Products) Table 7: Data Management CD Table 8: Preprocessors CD#1 (Windows Products) Table 9: Preprocessors CD#2 (HP, Linux, and MP-RAS Products) Table 10: Preprocessors CD#3 (AIX and Solaris Products) Table 11: Load/Unload CD#1 (Windows Products) Table 12: Load/Unload CD#2 (HP-UX, Linux and MP-RAS Products) Table 13: Load/Unload CD#3 (AIX and Solaris Products) Table 14: Parallel Transporter CD#1 (Windows Products) Table 15: Parallel Transporter CD#2 (HP-UX, Linux, and MP-RAS Products) Table 16: Parallel Transporter CD#3 (AIX and Solaris Products) Table 17: Tape Storage Management Enablers CD Table 18: Query Director CD Table 19: MetaData Services CD Table 20: Short Names for Teradata Parallel Transporter Table 21: MP-RAS Packages and Operating Systems Table 22: Kernel Values Table 23: Environment Variables Updated Table 24: IBM AIX Packages and Operating Systems Table 25: Environment Variables Updated Table 26: HP-UX Packages and Operating Systems Table 27: Kernel Values Table 28: Environment Variables Updated Table 29: Sun Solaris Packages and Operating Systems Table 30: Default and Alternative Directories Table 31: Screen Navigation Commands Table 32: CD-ROM Mount Point Teradata Tools and Utilities Installation Guide for UNIX and Linux 21

22 List of Tables Table 33: Selecting the Packages to Install Table 34: Kernel Values Table 35: Environment Variables Updated Table 36: Sun Solaris Opteron Packages and Operating Systems Table 37: Default and Alternative Directories Table 38: CD-ROM Mount Point Table 39: Selecting the Packages to Install Table 40: Kernel Values Table 41: Environment Variables Updated Table 42: Red Hat Linux Packages and Operating Systems Table 43: Checking for Previous Versions of Software on Linux Table 44: Uninstalling Previous Versions of Software on Linux Table 45: Changing Directories Table 46: Installing Teradata Tools and Utilities on Linux Table 47: Verifying the Installation on Linux Table 48: Kernel Values Table 49: Environment Variables Updated Table 50: Teradata Tools and Utilities supported on UNIX and Linux Table 51: Checking for Previous Versions of Software on Linux Table 52: Uninstalling Previous Versions of Software on Linux Table 53: Changing Directories Table 54: Installing Teradata Tools and Utilities on Linux Table 55: Verifying the Installation on Linux Table 56: Basic Teradata Query Files Table 57: Named Pipes Access Module Files Table 58: ODBC Driver for Teradata Files Table 59: Shared Common Components for Internationalization for Teradata Files Table 60: Teradata Access Module for JMS Files Table 61: Teradata Call-Level Interface version 2 Files Table 62: Teradata C Preprocessor2 Files for IBM AIX, HP-UX, HP Itanium, Solaris SPARC, Solaris Opteron Table 63: Teradata C Preprocessor2 Files for Red Hat Linux 32-bit, Red Hat Linux 64-bit, SUSE Linux 64-bit Table 64: Teradata COBOL Preprocessor2 Files Table 65: Teradata Data Connector Files Table 66: Teradata Driver for the JDBC Interface Files Teradata Tools and Utilities Installation Guide for UNIX and Linux

23 List of Tables Table 67: Teradata FastExport Files Table 68: Teradata FastLoad Files Table 69: Teradata Generic Security Services Version Files Table 70: Teradata MultiLoad Files Table 71: Teradata TPump Files Table 72: Teradata Parallel Transporter API Files Table 73: Teradata Parallel Transporter Data Connector Operator Files Table 74: Teradata Parallel Transporter DDL Operator Files Table 75: Teradata Parallel Transporter Export Operator Files Table 76: Teradata Parallel Transporter ICU Library Files Table 77: Teradata Parallel Transporter Infrastructure Files Table 78: Teradata Parallel Transporter Load Operator Files Table 79: Teradata Parallel Transporter ODBC Operator Files Table 80: Teradata Parallel Transporter Operator Support Library Files Table 81: Teradata Parallel Transporter OS Command Operator Files Table 82: Teradata Parallel Transporter SQL Inserter Operator Files Table 83: Teradata Parallel Transporter SQL Selector Operator Files Table 84: Teradata Parallel Transporter Stream Operator Files Table 85: Teradata Parallel Transporter Update Operator Files Table 86: WebSphere MQ Access Module Files Table 87: Supported Mechanisms Table 88: Single-Sign-On for Legacy Applications Table 89: Connecting Programmatically to a Teradata Database Table 90: Logon Error Messages Table 91: Session Guidelines for Clients Teradata Tools and Utilities Installation Guide for UNIX and Linux 23

24 List of Tables 24 Teradata Tools and Utilities Installation Guide for UNIX and Linux

25 CHAPTER 1 Introduction This chapter describes background information you need before installing the Teradata Tools and Utilities software for NCR UNIX SVR4 MP-RAS, IBM AIX, HP-UX, Sun Solaris, Red Hat Linux and SUSE Linux. This chapter contains the following information: Teradata Tools and Utilities System Requirements Software Requirements Installation Kit Contents Teradata Tools and Utilities What is Teradata Tools and Utilities? The Teradata Tools and Utilities is a set of integrated warehouse management and utility software products designed for the Teradata Database to enable users to get data from any source, extract and load the data quickly, then analyze the data. The Teradata Tools and Utilities software products that can run on the NCR UNIX SVR4 MP- RAS, IBM AIX, HP-UX, Sun Solaris, Red Hat Linux and SUSE Linux operating systems are composed of CLI User Exit Functions, as well as the following programs: Table 1: Teradata Tools and Utilities supported on UNIX and Linux Product MP-RAS IBM AIX HP-UX Sun Solaris SPARC Sun Solaris Opteron Red Hat Linux SUSE Linux Basic Teradata Query (BTEQ) YES YES YES YES YES YES YES Named Pipes Access Module YES YES YES YES YES YES YES ODBC Driver for Teradata YES YES YES YES YES YES YES Shared Common Components for Internationalization for Teradata YES YES YES YES YES YES YES Teradata Access Module for JMS NO YES* YES YES NO YES* YES* Teradata Archive/Recovery Utility (ARC) YES* NO* NO* NO* NO* YES* YES* Teradata Call-Level Interface version 2 (CLIv2) YES YES YES YES YES YES YES Teradata Tools and Utilities Installation Guide for UNIX and Linux 25

26 Chapter 1: Introduction Teradata Tools and Utilities Table 1: Teradata Tools and Utilities supported on UNIX and Linux (continued) Product MP-RAS IBM AIX HP-UX Sun Solaris SPARC Sun Solaris Opteron Red Hat Linux SUSE Linux Teradata C Preprocessor2 YES YES YES YES YES YES YES Teradata COBOL Preprocessor2 YES YES YES NO NO NO NO Teradata Data Connector (also known as PIOM) YES YES YES YES YES YES YES Teradata Driver for the JDBC Interface NO YES YES YES YES YES YES Teradata FastExport YES YES YES YES YES YES YES Teradata FastLoad YES YES YES YES YES YES YES Teradata Generic Security Services YES YES YES YES YES YES YES Teradata Generic Security Services Java NO NO NO NO YES YES YES Teradata MultiLoad YES YES YES YES YES YES YES Teradata Parallel Transporter Teradata Parallel Transporter API YES YES YES YES YES YES YES Teradata Parallel Transporter Data Connector Operator YES YES YES YES NO YES YES Teradata Parallel Transporter DDL Operator YES YES YES YES NO YES YES Teradata Parallel Transporter Export Operator YES YES YES YES YES YES YES Teradata Parallel Transporter FastExport OUTMOD Adapter Operator Teradata Parallel Transporter FastLoad INMOD Adapter Operator YES YES YES YES NO YES YES YES YES YES YES NO YES YES Teradata Parallel Transporter ICU Library YES YES YES YES YES YES YES Teradata Parallel Transporter Infrastructure YES YES YES YES NO YES YES Teradata Parallel Transporter Load Operator YES YES YES YES YES YES YES Teradata Parallel Transporter MultiLoad INMOD Adapter Operator YES YES YES YES NO YES YES Teradata Parallel Transporter ODBC Operator YES YES YES YES NO YES YES Teradata Parallel Transporter Operator Support Library Teradata Parallel Transporter OS Command Operator Teradata Parallel Transporter SQL Inserter Operator YES YES YES YES YES YES YES YES YES YES YES NO YES YES YES YES YES YES NO YES YES 26 Teradata Tools and Utilities Installation Guide for UNIX and Linux

27 Chapter 1: Introduction Teradata Tools and Utilities Table 1: Teradata Tools and Utilities supported on UNIX and Linux (continued) Product MP-RAS IBM AIX HP-UX Sun Solaris SPARC Sun Solaris Opteron Red Hat Linux SUSE Linux Teradata Parallel Transporter SQL Selector Operator Teradata Parallel Transporter Stream Operator Teradata Parallel Transporter Update Operator YES YES YES YES NO YES YES YES YES YES YES YES YES YES YES YES YES YES YES YES YES Teradata Query Director NO NO NO NO NO YES YES Teradata TPump YES YES YES YES YES YES YES WebSphere MQ Access Module YES YES YES YES YES YES YES Note: The Teradata Archive and Recovery Utility (ARC) is included for Open Teradata Backup and is not sold as an individual product. Note: Refer to the Teradata Tools and Utilities Release Definition, Release for specific information about a specific Teradata Tools and Utilities product, including information on which products are supported for specific operating systems and platforms. Note: Teradata Access Module for JMS version is available for IBM AIX, Red Hat Linux, and SUSE Linux from the Teradata Download Center. Definitions of Client and Server For purposes of this installation guide, the following definitions apply: Table 2: Definition of Client and Server Term Teradata client software for NCR UNIX MP-RAS, IBM AIX, HP-UX, Sun Solaris, Red Hat Linux or SUSE Linux Teradata server Definition Teradata client software that installs and executes on a NCR UNIX MP-RAS, IBM AIX, HP-UX, Sun Solaris, Red Hat Linux or SUSE Linux operating system. This software allows access to a Teradata Database. System running the Teradata Database. Examples of servers include System 4800 and System 5250M. Teradata Tools and Utilities Installation Guide for UNIX and Linux 27

28 Chapter 1: Introduction System Requirements System Requirements Platforms Supported Teradata Tools and Utilities software packaged for NCR UNIX SVR4 MP-RAS, IBM AIX, HP- UX, Sun Solaris, Red Hat Linux and SUSE Linux run on systems or nodes supporting one of these operating systems. MP-RAS NCR MP-RAS 3.02 running on Intel x86 and Intel Xeon with EM64T (32-bit Teradata Tools and Utilities) NCR MP-RAS 3.03 running on Intel x86 and Intel Xeon with EM64T (32-bit Teradata Tools and Utilities) IBM AIX IBM AIX 5.1 running on 32-bit and 64-bit IBM Power PC (32-bit Teradata Tools and Utilities) IBM AIX 5.1 running on IBM Power PC (64-bit Teradata Tools and Utilities) IBM AIX 5.2 running on 32-bit and 64-bit IBM Power PC (32-bit Teradata Tools and Utilities) IBM AIX 5.2 running on IBM Power PC (64-bit Teradata Tools and Utilities) IBM AIX 5.3 running on 32-bit and 64-bit IBM Power PC (32-bit Teradata Tools and Utilities) IBM AIX 5.3 running on IBM Power PC (64-bit Teradata Tools and Utilities) HP-UX HP-UX 11.11iv1 (11.11) running on 32-bit and 64-bit Hewlett-Packard PA-Risc (32-bit Teradata Tools and Utilities) HP-UX 11.11iv1 (11.11) running on Hewlett-Packard PA-Risc (64-bit Teradata Tools and Utilities) HP-UX 11.11iv2 (11.23)running on Intel Itanium (Itanium build) (64-bit Teradata Tools and Utilities) HP-UX 11.11iv2 (11.23) running on Intel Itanium (PA-RISC build) (64-bit Teradata Tools and Utilities) HP-UX 11.11iv3 (11.31)running on Intel Itanium (PA-RISC build) (64-bit Teradata Tools and Utilities) HP-UX 11.11iv3 (11.31) running on Intel Itanium (Itanium build) (64-bit Teradata Tools and Utilities) Sun Solaris SPARC Sun Solaris 8 running on 32-bit and 64-bit SPARC (32-bit Teradata Tools and Utilities) Sun Solaris 8 running on SPARC (64-bit Teradata Tools and Utilities) Sun Solaris 9 running on 32-bit and 64-bit SPARC (32-bit Teradata Tools and Utilities) 28 Teradata Tools and Utilities Installation Guide for UNIX and Linux

29 Chapter 1: Introduction System Requirements Sun Solaris 9 running on SPARC (64-bit Teradata Tools and Utilities) Sun Solaris 10 running on 32-bit and 64-bit SPARC (32-bit Teradata Tools and Utilities) Sun Solaris 10 running on SPARC (64-bit Teradata Tools and Utilities) Sun Solaris Opteron Sun 64-bit Solaris 10 running on EM64T and AMD Opteron (32-bit Teradata Tools and Utilities) Sun 64-bit Solaris 10 running on AMD Opteron (64-bit Teradata Tools and Utilities) Linux Red Hat Linux Red Hat Enterprise Linux Advanced Server 2.1 running on Intel x86 (32-bit Teradata Tools and Utilities) Linux Red Hat Enterprise Linux Advanced Server 3.0 running on Intel x86 (32-bit Teradata Tools and Utilities) Linux Red Hat Enterprise Linux Advanced Server 3.0 running on Intel Itanium (64-bit Teradata Tools and Utilities) Linux Red Hat Enterprise Linux Advanced Server 4.0 running on Intel x86 and EM64T and AMD Opteron 32-bit (32-bit Teradata Tools and Utilities) Linux Red Hat Enterprise Linux Advanced Server bit running on Intel EM64T and AMD Opteron 64-bit (32-bit Teradata Tools and Utilities) Linux Red Hat Enterprise Linux Advanced Server bit running on Intel EM64T and AMD Opteron 64-bit (32-bit Teradata Tools and Utilities) Linux Red Hat Enterprise Linux Advanced Serve 5.0 running on Intel x86 and EM64T and AMD Opteron 32-bit(32-bit Teradata Tools and Utilities) Linux Red Hat Enterprise Linux Advanced Server bit running on Intel EM64T and AMD Opteron 64-bit (32-bit Teradata Tools and Utilities) Linux Red Hat Enterprise Linux Advanced Server bit running on Intel EM64T and AMD Opteron 64-bit (32-bit Teradata Tools and Utilities) SUSE Linux SUSE Linux Enterprise 9 with SP1, 2 or 3 running on Intel x86 (32-bit Teradata Tools and Utilities) SUSE Linux Enterprise 9 with SP1, 2 or 3 32-bit running on Intel EM64T (32-bit Teradata Tools and Utilities) SUSE Linux Enterprise 9 with SP1, 2 or 3 running on Intel EM64T (64-bit Teradata Tools and Utilities) SUSE Linux Enterprise 9 with SP1, 2 or 3 running on AMD Opteron (64-bit Teradata Tools and Utilities) SUSE Linux Enterprise 10 with SP1 running on Intel x86 (32-bit Teradata Tools and Utilities) SUSE Linux Enterprise 10 with SP1 32-bit running on Intel EM64T (32-bit Teradata Tools and Utilities) Teradata Tools and Utilities Installation Guide for UNIX and Linux 29

30 Chapter 1: Introduction Software Requirements SUSE Linux Enterprise 10 with SP1 running on Intel EM64T (64-bit Teradata Tools and Utilities) Network Requirements The NCR UNIX SVR4 MP-RAS, IBM AIX, HP-UX, Sun Solaris, and Linux client computers use the Transmission Control Protocol/Internet Protocol (TCP/IP) to communicate with the Teradata Database. The client must be connected to one of the following: The same Ethernet LAN as the Teradata Database with which it will communicate. An Ethernet LAN that permits the client to communicate with the Teradata Database through one or more routers. A node that is attached to the Teradata Database through Ynet or BYNET. No separate network controller board or network software is required; the client provides its own. Teradata Database Requirements The appropriate Ethernet hardware and software, supporting a TCP/IP based network, must be installed on every Teradata Database with which the client communicates. Software Requirements Product Dependencies In the following table, the products in the column 1 are dependent upon the products shown in column 2. The products in the column 1 must be installed for the products in column 2 to operate. Note: When using pkgplus on the NCR UNIX SVR4 MP-RAS platform, the installer does not always automatically select dependent products. Table 3: Product Dependencies These products... Basic Teradata Query (BTEQ) version DUL version DULT version require these installations... For MP-RAS, Sun Solaris, IBM AIX, HP-UX, and Linux: Shared Common Components for Internationalization for Teradata version or later Teradata Data Connector or later Teradata Call-Level Interface version 2 (CLIv2) version or later Teradata Generic Security Services version or later TDGSS - Server package TeraGSS - Client package None None 30 Teradata Tools and Utilities Installation Guide for UNIX and Linux

31 Chapter 1: Introduction Software Requirements Table 3: Product Dependencies (continued) These products... Named Pipes Access Module version require these installations... Installation of the Named Pipes Access Module on MP-RAS, Sun Solaris, IBM AIX and HP-UX is not required, but provides access functionality for these products: Teradata Archive/Recovery Utility (ARC) or later Basic Teradata Query (BTEQ) or later Teradata FastExport or later Teradata FastLoad or later Teradata MultiLoad or later Teradata TPump or later ODBC Driver for Teradata version Shared Common Components for Internationalization for Teradata version Teradata Generic Security Services version or later TeraGSS - Client package For IBM AIX: xlc.rte xlc.aix.50.rte Shared Common Components for Internationalization for Teradata version No dependencies Teradata Access Module for JMS version Teradata Data Connector version or later JDK 1.4 or later JMS enabled Messaging System Teradata Archive/Recovery Utility (ARC) version Teradata Call-Level Interface version 2 (CLIv2) version Teradata C Preprocessor2 version Teradata COBOL Preprocessor2 version For MP-RAS: Teradata Data Connector or later Note: Teradata Archive and Recovery Utility (ARC) is not distributed as a stand-alone product. It is installed with Open Teradata Backup on MP-RAS and Windows Shared Common Components for Internationalization for Teradata version Teradata Generic Security Services version or later TDGSS - Server package TeraGSS - Client package For MP-RAS, Sun Solaris, AIX, HP-UX, and Linux: Shared Common Components for Internationalization for Teradata version Teradata Call-Level Interface version 2 (CLIv2) version or later For MP-RAS, AIX, and HP-UX: Teradata Call-Level Interface version 2 (CLIv2) version or later Teradata Data Connector version No dependencies Teradata Tools and Utilities Installation Guide for UNIX and Linux 31

32 Chapter 1: Introduction Software Requirements Table 3: Product Dependencies (continued) These products... require these installations... Teradata Driver for the JDBC Interface version See Teradata Driver for the JDBC Interface. Teradata FastExport version Teradata FastLoad version For MP-RAS, Sun Solaris, IBM AIX, HP-UX, and Linux: Shared Common Components for Internationalization for Teradata version Teradata Call-Level Interface version 2 (CLIv2) version or later Teradata Generic Security Services version or later TDGSS - Server package TeraGSS - Client package Teradata Data Connector or later For MP-RAS, Sun Solaris, IBM AIX, HP-UX, and Linux: Shared Common Components for Internationalization for Teradata version Teradata Call-Level Interface version 2 (CLIv2) version or later Teradata Generic Security Services version or later TDGSS - Server package TeraGSS - Client package Teradata Data Connector or later Teradata Generic Security Services client version No dependencies Teradata Generic Security Services Java client version Teradata MultiLoad version Teradata TPump version No dependencies For MP-RAS, Sun Solaris, IBM AIX, HP-UX, and Linux: Shared Common Components for Internationalization for Teradata version Teradata Call-Level Interface version 2 (CLIv2) version or later Teradata Generic Security Services version or later TDGSS - Server package TeraGSS - Client package Teradata Data Connector or later For MP-RAS, Sun Solaris, IBM AIX, HP-UX, and Linux: Shared Common Components for Internationalization for Teradata version Teradata Generic Security Services version or later TDGSS - Server package TeraGSS - Client package Teradata Call-Level Interface version 2 (CLIv2) version or later Teradata Data Connector or later Teradata Parallel Transporter version Teradata Tools and Utilities Installation Guide for UNIX and Linux

33 Chapter 1: Introduction Software Requirements Table 3: Product Dependencies (continued) These products... require these installations... Teradata Parallel Transporter API version For MP-RAS, Sun Solaris, IBM AIX, Linux and HP-UX: Teradata Parallel Transporter Load Operator or later Teradata Parallel Transporter Update Operator or later Teradata Parallel Transporter Stream Operator or later Teradata Parallel Transporter Export Operator or later Teradata Parallel Transporter ICU Library or later Teradata Parallel Transporter Data Connector Operator version Teradata Parallel Transporter DDL Operator version Teradata Parallel Transporter Export Operator version Teradata Parallel Transporter FastExport OUTMOD Adapter Operator version Teradata Parallel Transporter FastLoad INMOD Adapter Operator version Teradata Parallel Transporter ICU Library version Teradata Parallel Transporter Infrastructure version For MP-RAS, Sun Solaris, IBM AIX, Linux and HP-UX: Teradata Parallel Transporter Infrastructure or later Teradata Parallel Transporter Operator Support Library or later For MP-RAS, Sun Solaris, IBM AIX, Linux and HP-UX: CLIv2 version or later Teradata Parallel Transporter Infrastructure or later Teradata Parallel Transporter Operator Support Library or later For MP-RAS, Sun Solaris, IBM AIX, Linux and HP-UX: CLIv2 version or later Teradata Parallel Transporter Infrastructure or later Teradata Parallel Transporter Operator Support Library or later For MP-RAS, Sun Solaris, IBM AIX, Linux and HP-UX: Teradata Parallel Transporter Infrastructure or later Teradata Parallel Transporter Operator Support Library or later For MP-RAS, Sun Solaris, IBM AIX, Linux and HP-UX: Teradata Parallel Transporter Infrastructure or later Teradata Parallel Transporter Operator Support Library or later Shared Common Components for Internationalization for Teradata or later Teradata Parallel Transporter ICU Library or later Teradata Tools and Utilities Installation Guide for UNIX and Linux 33

34 Chapter 1: Introduction Software Requirements Table 3: Product Dependencies (continued) These products... Teradata Parallel Transporter Load Operator version Teradata Parallel Transporter MultiLoad INMOD Adapter Operator version Teradata Parallel Transporter ODBC Operator version Teradata Parallel Transporter Operator Support Library 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 Stream Operator version require these installations... For MP-RAS, Sun Solaris, IBM AIX, Linux and HP-UX: CLIv2 version or later Teradata Parallel Transporter Operator Support Library or later Teradata Parallel Transporter Infrastructure or later For MP-RAS, Sun Solaris, HP-UX, Linux and IBM AIX: Teradata Parallel Transporter Infrastructure or later Teradata Parallel Transporter Operator Support Library or later For MP-RAS, Sun Solaris, IBM AIX, Linux and HP-UX: Teradata Parallel Transporter Infrastructure or later Teradata Parallel Transporter Operator Support Library or later For MP-RAS, Sun Solaris, IBM AIX, Linux and HP-UX: CLIv2 version or later Teradata Parallel Transporter Infrastructure or later Teradata Parallel Transporter ICU Library or later For MP-RAS, Sun Solaris, IBM AIX, Linux and HP-UX: Teradata Parallel Transporter Operator Support Library or later Teradata Parallel Transporter Infrastructure or later For MP-RAS, Sun Solaris, IBM AIX, Linux and HP-UX: CLIv2 version or later Teradata Parallel Transporter Operator Support Library or later Teradata Parallel Transporter Infrastructure or later For MP-RAS, Sun Solaris, IBM AIX, Linux and HP-UX: CLIv2 version or later Teradata Parallel Transporter Infrastructure or later Teradata Parallel Transporter Operator Support Library or later For MP-RAS, Sun Solaris, IBM AIX, Linux and HP-UX: CLIv2 version or later Teradata Parallel Transporter Operator Support Library or later Teradata Parallel Transporter Infrastructure or later 34 Teradata Tools and Utilities Installation Guide for UNIX and Linux

35 Chapter 1: Introduction Installation Kit Contents Table 3: Product Dependencies (continued) These products... Teradata Parallel Transporter Update Operator version WebSphere MQ Access Module version require these installations... For MP-RAS, Sun Solaris, IBM AIX, Linux and HP-UX: CLIv2 version or later Teradata Parallel Transporter Infrastructure or later Teradata Parallel Transporter Operator Support Library or later For MP-RAS, Sun Solaris, IBM AIX and HP-UX: Teradata Data Connector or later Basic Teradata Query (BTEQ) or later Teradata FastExport or later Teradata FastLoad or later Teradata MultiLoad or later Teradata TPump or later For IBM AIX: WebSphere MQ (AIX) 5.3 For HP-UX: WebSphere MQ (HP-UX) 5.2 Note: Teradata Parallel Transporter Infrastructure is certified with Teradata CLIv2 version Installation Order When installing Teradata Tools and Utilities products, four product dependencies must be installed first and in the following order: 1 Install Shared Common Components for Internationalization 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: Do not uninstall Shared Common Components for Internationalization for Teradata until all software that have it as a dependency are first uninstalled. Installation Kit Contents The installation kit includes: Teradata Tools and Utilities Release Definition, Release Teradata Tools and Utilities Documentation CD Teradata Tools and Utilities Installation Guide for UNIX and Linux 35

36 Chapter 1: Introduction Installation Kit Contents Teradata Software Server Also included are one or more of the following purchased CDs. 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 all of the CDs ordered were not received, contact the Teradata Solutions Customer Services Remote Services Center (TSCS-RSC). For more information, refer to the Teradata Tools and Utilities Release Definition, Release 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 manufacturer s installation guides for these systems. Teradata Driver for the JDBC Interface The Teradata Driver for the JDBC Interface is downloaded from the Teradata Download Center at: --> Support Services --> Downloads--> Drivers, UDFs, and Toolbox --> Drivers and Connectivity Software 36 Teradata Tools and Utilities Installation Guide for UNIX and Linux

37 Chapter 1: Introduction Installation Kit Contents The files are machine independent and can be copied into a directory of choice. 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. Note: It is recommended, but not required, that any previous release of the Teradata Driver for the JDBC Interface must be uninstalled prior to downloading and using this release of the Teradata Driver for the JDBC Interface. Teradata Tools and Utilities CDs The following tables list only the network-attached platform versions contained on the CDs. Table 4: 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 Teradata Generic Security Services Teradata MultiTool Teradata SQL Assistant Teradata SQL Assistant/Web Edition Platforms (Windows) Windows Windows Windows Windows Windows Windows 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 5: 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) 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 Teradata Tools and Utilities Installation Guide for UNIX and Linux 37

38 Chapter 1: Introduction Installation Kit Contents Table 5: Teradata Utility Pak CD#2 (HP-UX, Linux and MP-RAS Products) (continued) Teradata Utility Pak - Utilities CD#2 Teradata Data Connector Teradata Generic Security Services Platforms (HP-UX, Linux and MP-RAS) HP-UX, Linux, MP-RAS HP-UX, Linux, MP-RAS Table 6: 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 Table 7: 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 Platforms (Windows) Product dependency Product dependency Product dependency Product dependency Product dependency Windows Product dependency Windows Windows Windows Windows Windows Windows Windows 38 Teradata Tools and Utilities Installation Guide for UNIX and Linux

39 Chapter 1: Introduction Installation Kit Contents Table 7: Data Management CD (continued) Database Management CD Teradata System Emulation Tool Teradata Visual Explain Teradata Workload Analyzer Platforms (Windows) Windows Windows Windows Table 8: 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 9: Preprocessors CD#2 (HP, Linux, and MP-RAS Products) Preprocessors CD#2 Shared ICU Libraries for Teradata Teradata C Preprocessor2 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, Linux, MP-RAS Product dependency HP-UX, MP-RAS Product dependency Table 10: 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 Teradata Tools and Utilities Installation Guide for UNIX and Linux 39

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

41 Chapter 1: Introduction Installation Kit Contents Table 12: Load/Unload CD#2 (HP-UX, Linux and MP-RAS Products) (continued) Load/Unload CD#2 Teradata Generic Security Services Teradata MultiLoad Teradata TPump WebSphere MQ Access Module Platforms (HP-UX, Linux, and MP-RAS) 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 13: Load/Unload CD#3 (AIX and Solaris Products) Load/Unload CD#3 Basic Teradata Query (BTEQ) Named Pipes Access Module ODBC Driver for Teradata Shared ICU Libraries for Teradata Teradata Access Module for JMS 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 Solaris SPARC, AIX Note: Named Pipes Access Module contains both the stand-alone version and the Teradata Parallel Transporter version. Product dependency Product dependency Solaris SPARC Product dependency Solaris SPARC, AIX, Solaris Opteron Solaris SPARC, AIX, Solaris Opteron Solaris SPARC, AIXSolaris Opteron Product dependency Solaris SPARC, AIX, Solaris Opteron Solaris SPARC, AIX Solaris SPARC, AIX, Solaris Opteron Note: WebSphere MQ Access Module contains both the stand-alone version and the Teradata Parallel Transporter version. Teradata Tools and Utilities Installation Guide for UNIX and Linux 41

42 Chapter 1: Introduction Installation Kit Contents Table 14: 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 Teradata Parallel Transporter: Teradata Parallel Transporter API Teradata Parallel Transporter Data Connector Operator Teradata Parallel Transporter DDL Operator Teradata Parallel Transporter Export Operator Teradata Parallel Transporter FastExport OUTMOD Adapter Operator Teradata Parallel Transporter FastLoad INMOD Adapter Operator Teradata Parallel Transporter ICU Library Teradata Parallel Transporter Infrastructure Teradata Parallel Transporter Load Operator Teradata Parallel Transporter MultiLoad INMOD Adapter Operator 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 Windows Note: The FastExport OUTMOD Adapter Operator, the FastLoad INMOD Adapter Operator and the MultiLoad INMOD Adapter Operator are installed as part of the Teradata Parallel Transporter Infrastructure on Windows. Note: Teradata Parallel Transporter Wizard is only supported on Windows. 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 Teradata Parallel Transporter Stream Operator Teradata Parallel Transporter Update Operator Teradata Parallel Transporter Wizard WebSphere MQ Access Module Product dependency Note: WebSphere MQ Access Module contains both the stand-alone version and the Teradata Parallel Transporter version. 42 Teradata Tools and Utilities Installation Guide for UNIX and Linux

43 Chapter 1: Introduction Installation Kit Contents Table 15: Parallel Transporter CD#2 (HP-UX, Linux, and MP-RAS Products) Parallel Transporter CD#2 Named Pipes Access Module Shared ICU Libraries for Teradata Teradata Call-Level Interface version 2 (CLIv2) Teradata Generic Security Services Teradata Parallel Transporter: Teradata Parallel Transporter API Teradata Parallel Transporter Data Connector Operator Teradata Parallel Transporter DDL Operator Teradata Parallel Transporter Export Operator Teradata Parallel Transporter FastExport OUTMOD Adapter Operator Teradata Parallel Transporter FastLoad INMOD Adapter Operator Teradata Parallel Transporter ICU Library Teradata Parallel Transporter Infrastructure Teradata Parallel Transporter Load Operator Teradata Parallel Transporter MultiLoad INMOD Adapter Operator 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. Product dependency Product dependency Product dependency HP-UX, Linux and MP-RAS Note: The FastExport OUTMOD Adapter Operator, the FastLoad INMOD Adapter Operator and the MultiLoad INMOD Adapter Operator are installed as part of the Teradata Parallel Transporter Infrastructure on HP-UX, MP-RAS, Linux. 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 Teradata Parallel Transporter Stream Operator Teradata Parallel Transporter Update Operator WebSphere MQ Access Module HP-UX, Linux and MP-RAS Note: WebSphere MQ Access Module contains both the stand-alone version and the Teradata Parallel Transporter version. Teradata Tools and Utilities Installation Guide for UNIX and Linux 43

44 Chapter 1: Introduction Installation Kit Contents Table 16: 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 Teradata Parallel Transporter: Teradata Parallel Transporter API Teradata Parallel Transporter Data Connector Operator Teradata Parallel Transporter DDL Operator Teradata Parallel Transporter Export Operator Teradata Parallel Transporter FastExport OUTMOD Adapter Operator Teradata Parallel Transporter FastLoad INMOD Adapter Operator Teradata Parallel Transporter ICU Library Teradata Parallel Transporter Infrastructure Teradata Parallel Transporter Load Operator Teradata Parallel Transporter MultiLoad INMOD Adapter Operator 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 IBM AIX, Solaris SPARC Note: The FastExport OUTMOD Adapter Operator, the FastLoad INMOD Adapter Operator and the MultiLoad INMOD Adapter Operator are installed as part of the Teradata Parallel Transporter Infrastructure on Solaris SPARC, IBM AIX. Note: Only Teradata Parallel Transporter API, Teradata Parallel Transporter Export Operator, Teradata Parallel Transporter ICU Library, Teradata Parallel Transporter Load Operator, Teradata Parallel Transporter Operator Support Library, Teradata Parallel Transporter Stream Operator, and Teradata Parallel Transporter Update Operator are supported on Solaris Opteron. 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 Teradata Parallel Transporter Stream Operator Teradata Parallel Transporter Update Operator WebSphere MQ Access Module Product Dependency Note: WebSphere MQ Access Module contains both the stand-alone version and the Teradata Parallel Transporter version. 44 Teradata Tools and Utilities Installation Guide for UNIX and Linux

45 Chapter 1: Introduction Installation Kit Contents Table 17: 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) Teradata Data Connector Teradata Generic Security Services 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 Product dependency Product dependency Table 18: 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 19: 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 these items are not in the installation kit, contact the TSCS-RSC. See the Teradata Tools and Utilities Release Definition, Release 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 information on installing Windows products, see the Teradata Tools and Utilities Installation Guide for Microsoft Windows. Teradata Tools and Utilities Installation Guide for UNIX and Linux 45

46 Chapter 1: Introduction Installation Kit Contents 46 Teradata Tools and Utilities Installation Guide for UNIX and Linux

47 CHAPTER 2 Before You Install This chapter describes the procedures to set up the installation of Teradata Tools and Utilities software on MP-RAS, IBM AIX, HP-UX, Sun Solaris and Linux client systems. This chapter contains the following information: Installation Recommendations Teradata Generic Security Services Technical Assistance Installation Recommendations Before you begin installing Teradata Tools and Utilities software on an MP-RAS, IBM AIX, HP-UX, Sun Solaris, or Linux client systems, make sure your software package is complete (see Installation Kit Contents on page 35) and that your client system 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. Installing Upgrade or Maintenance Software As they are made available, Teradata may inform you of software upgrades, higher-level releases, or maintenance releases. The upgrades are normally available on CD-ROM. When installing the Teradata Client Utilities on UNIX, make sure to use the Korn shell (/bin/ ksh) before running setup.bat. This will ensure correct execution of the installation script. Prior to installing new software, existing software must be uninstalled. Note: All the 64-bit BTEQ packages on UNIX have been decommissioned with the exception of HP-UX 11iv2 (64-bit on HP-UX Itanium). The install/upgrade procedure will not automatically remove these decommissioned 64-bit BTEQ packages, however de-installing a 32-bit BTEQ version will remove a previously installed 64-bit version with the exception of HP-UX 11iv2. An exception is the Teradata Generic Security Services software, which does not have to be uninstalled. See Teradata Generic Security Services on page 48. In the ODBC Driver for Teradata version , the package name for the Solaris- SPARC package has been changed from tdodbc to tdodbc64. Note: If a previous version of the 64-bit Solaris-SPARC ODBC driver from the x release was installed, it must be uninstalled before installing the ODBC Driver for Teradata to avoid unpredictable results. Teradata Tools and Utilities Installation Guide for UNIX and Linux 47

48 Chapter 2: Before You Install Installation Recommendations Online updates to individual Teradata Tools and Utilities software packages are sometimes made available on the Teradata Software Server. These upgrades or software patches can be downloaded by authorized customers, or Teradata field support personnel with access to the Teradata Software Server. To re-install a previous version of the software, the original Teradata Tools and Utilities disk must be used. Normally, you should not have to reset network parameters after you make an upgrade. Note: If you create new directories for the files, you will have to change the paths to COPERR, COPLIB, and COPANOMLOG. For more information, see Chapter 13: Troubleshooting. Note: An exception is the Teradata Parallel Transporter software. Teradata Parallel Transporter does not have to be uninstalled. 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, the installation will display one of two messages: 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 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: "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 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 guide. 48 Teradata Tools and Utilities Installation Guide for UNIX and Linux

49 Chapter 2: Before You Install Installation Recommendations Upgrading TPump On Linux, if TPump is being updated from a TPump version prior to , the soft link /usr/bin/tpump is missing after the upgrade. The softlink is a pointer to /opt/teradata/client/ bin/tpump. When upgrading from version or later, the anomaly does not occur. The solution is to first uninstall the existing version of TPump and then upgrade to the new version of TPump. Upgrading C/COBOL Preprocessor2 The default installation location for Teradata C Preprocessor2 (sqlp) and Teradata COBOL Preprocessor2 (cobpp) on all UNIX platforms is changed to /opt/teradata/client. Softlinks from / usr/lib and /usr/bin will be created from /opt/teradata/client/lib and /usr/teradata/client/bin respectively. Similarly, for 64-bit libraries and binaries softlinks will be created. To avoid installation errors while creating these softlinks, it is recommended to uninstall the previous release of Teradata C Preprocessor2 and Teradata COBOL Preprocessor2 packages before installing the Teradata Tools and Utilities 12.0 packages of Teradata C Preprocessor2 and Teradata COBOL Preprocessor2. PUT Installations pkgplus Installations Some of the 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 MP-RAS. BTEQ can also be installed on Linux using PUT. Basic Teradata Query (BTEQ) Shared Common Components for Internationalization for Teradata Teradata Call-Level Interface version 2 (CLIv2) Teradata Data Connector Named Pipes Access Module FastExport FastLoad MultiLoad MQ Access Module TPump See the Parallel Upgrade Tool (PUT) for UNIX MP-RAS and Linux. On the MP-RAS operating system, the pkgplus utility can be used to install almost all of the Teradata Tools and Utilities software. When using pkgplus, note that the installer may not automatically select dependent products for you. Therefore, you should read Software Requirements on page 30 to determine which products you should install. Teradata Tools and Utilities Installation Guide for UNIX and Linux 49

50 Chapter 2: Before You Install Installation Recommendations pkgadd Installations Available Disk Space On the Sun Solaris operating system, the pkgadd utility can be used to install almost all of the Teradata Tools and Utilities software. When using pkgadd, note that the installer may not automatically select dependent products for you. Therefore, you should read System Requirements on page 28 to determine which products you should install. On Sun Solaris SPARC, during installation, you may be asked multiple questions depending on which products you select. Afterwards, a machine check is done to ensure you have enough disk space to install the software. This does not require any interaction unless you do not have enough space. In this case, you will be notified which file systems are lacking space. You will return to the main install screen to either remove some packages or exit the installation process to free up space. Assuming you have enough space on your system, the rest of the installation is automated. A screen, similar to the following, will display indicating how many packages were installed and if any failed. NCR Teradata Tools and Utilities PACKAGE INSTALLATION (Packages will now be installed onto the system.) Number of packages to process: 1 Number successfully processed: 1 Failures: 0 All packages processed successfully. Please see the logfile [/var/ncr/logs/pkgadd.log] for any specific package instructions. If any failures occur, check the.log file and then call the TSCS-RSC. LD_LIBRARY_PATH, SHLIB_PATH and LIBPATH On Sun Solaris and Linux, the LD_LIBARY_PATH environment variable needs to be exported for all Teradata Tools and Utilities products. For the following Teradata Tools and Utilities products: Teradata Call-Level Interface version 2 (CLIv2) Teradata Data Connector Teradata Parallel Transporter Named Pipes Access Module WebSphere MQ Access Module The following environment variables need to be exported: LD_LIBRARY_PATH on MP-RAS, Sun Solaris, and Linux SHLIB_PATH on HP-UX 32-bit SHLIB_PATH or LD_LIBRARY_PATH on HP-UX 64-bit LIBPATH on IBM AIX 50 Teradata Tools and Utilities Installation Guide for UNIX and Linux

51 Chapter 2: Before You Install Teradata Parallel Transporter DUL/DULT On MP-RAS, DUL and DULT cannot be installed using pkgplus. To install DUL and DULT, load the files from the Teradata Database CD-ROM. Teradata Parallel Transporter Teradata Parallel Transporter is an object-oriented software system that executes multiple instances of data extraction, transformation, and load functions in a scalable, high-speed parallel processing environment. Teradata Parallel Transporter replaces the functionality formerly seen in Teradata Warehouse Builder. Teradata Parallel Transporter requires the installation of the Teradata Parallel Transporter Infrastructure and the basic set of Teradata Parallel Transporter operators, such as Load, Export and Data Connector. See Installation Recommendations on page 47. Teradata Parallel Transporter Package Names The package name for Teradata Parallel Transporter will change from release to release to support multiple installed versions of Teradata Parallel Transporter. The format of the package name is <short name><short version>. For example, tbldc000 is the package name for Teradata Parallel Transporter Infrastructure version Here are the short names for Teradata Parallel Transporter: Table 20: Short Names for Teradata Parallel Transporter Utility API Data Connector Operator DDL Operator Export Operator ICU Library Infrastructure Load Operator ODBC Operator Operator Support Library OS Command Operator SQL Inserter Operator SQL Selector Operator Stream Operator Short Names papi pdtc pddl pexp picu tbld plod podbc posl posc pins psel pstm Teradata Tools and Utilities Installation Guide for UNIX and Linux 51

52 Chapter 2: Before You Install Teradata Parallel Transporter Table 20: Short Names for Teradata Parallel Transporter (continued) Utility Update Operator Short Names pupd Removing Teradata Warehouse Builder and Teradata Parallel Transporter Packages It is not necessary to remove previous versions of Teradata Warehouse Builder or its replacement, Teradata Parallel Transporter, prior to installing a new version. Multiple versions of each may coexist on a system. To remove either an older version of Teradata Warehouse Builder or a previously installed version of Teradata Parallel Transporter software from a system, a tool named twbpkgrm is included in the Teradata Parallel Transporter Infrastructure package, version The twbpkgrm Tool The twbpkgrm tool can be found in the /usr/bin directory. Note: The twbpkgrm tool requires version 5.0 or above of Perl to be installed on the system. The path to the Perl executable must be in the PATH environment variable. Versions of Perl can be downloaded from the website: Here is the usage for the twbpkgrm tool: Usage: twbpkgrm [-a] [-h] [-p <package(s)>] [-t <trace file>] -a option removes all versions of Teradata Warehouse Builder and Teradata Parallel Transporter software on the system. -h option displays the usage. -p option removes the specified <package(s)> on the system. Multiple packages can be specified within single or double quotes, and separated by space. For example: twbpkgrm -p "pselc000 pexpc000" Package(s) will be removed in the order specified. -t option enables trace information for this program and saves the trace information in the <trace file>. Note: Options -a, -h, and -p are mutually exclusive. Note: Options are case-sensitive. When executed with no options, the twbpkgrm tool displays information on installed Teradata Warehouse Builder and Teradata Parallel Transporter versions. When you execute the twbpkgrm tool with no options, you can perform the following additional functions: Remove all installed Teradata Parallel Transporter packages (selection a). Use caution when removing all versions of Teradata Parallel Transporter. Sort Teradata Parallel Transporter software name in ascending order (selection b) 52 Teradata Tools and Utilities Installation Guide for UNIX and Linux

53 Chapter 2: Before You Install Teradata Parallel Transporter Sort Teradata Parallel Transporter software name in descending order (selection c) Sort Teradata Parallel Transporter package name in ascending order (selection d) Sort Teradata Parallel Transporter package name in descending order (selection e) Sort Teradata Parallel Transporter version number in ascending order (selection f) Sort Teradata Parallel Transporter version number in descending order (selection g) Quit the twbpkgrm tool (selection q) Note: Sorting is performed within the Teradata Parallel Transporter and Teradata Warehouse Builder software groups. The selection in the twbpkgrm tool is case sensitive. The twbpkgrm tool will remain in the /usr/bin directory even after Teradata Parallel Transporter software is removed. To remove the twbpkgrm tool in the /usr/bin directory, you must be the root user and enter the rm /usr/bin/ twbpkgrm command: # rm /usr/bin/twbpkgrm Removing Teradata Warehouse Builder or Teradata Parallel Transporter Use one of the following procedures to remove a Teradata Warehouse Builder or Teradata Parallel Transporter package. Method 1 - Removing Teradata Warehouse Builder or Teradata Parallel Transporter with twbpkgrm with no options Method 2 - Removing Teradata Warehouse Builder or Teradata Parallel Transporter with twbpkgrm with -p option selected Method 3 - Removing Teradata Warehouse Builder or Teradata Parallel Transporter with twbpkgrm with -a option selected Procedure - Removing Teradata Parallel Transporter with Method 1 Follow these steps to remove Teradata Warehouse Builder or Teradata Parallel Transporter with twbpkgrm with no options selected. 1 Log on as the root user. 2 Run the twbpkgrm tool with no options. # /usr/bin/twbpkgrm twbpkgrm Version File revision: Copyright , NCR Corporation. All Rights Reserved. Platform: NCR MP-RAS UNIX Checking for Teradata Parallel Transporter and Teradata Warehouse Builder software. This may take several seconds. Please wait... Here is the currently installed Teradata Parallel Transporter (TPT) software: Teradata Tools and Utilities Installation Guide for UNIX and Linux 53

54 Chapter 2: Before You Install Teradata Parallel Transporter Num Software Package Version Install Directory === ======== ======= ======= ================= 1 TPT Infrastructure tbld /usr/tbuild/ Operator Support Library posl /usr/tbuild/ Data Connector Operator pdtc /usr/tbuild/ DDL Operator pddl /usr/tbuild/ Export Operator pexp /usr/tbuild/ Load Operator plod /usr/tbuild/ ODBC Operator podbc /usr/tbuild/ OS Command Operator posc /usr/tbuild/ SQL Inserter Operator pins /usr/tbuild/ SQL Selector Operator psel /usr/tbuild/ Stream Operator pstm /usr/tbuild/ Update Operator pupd /usr/tbuild/ TPT API papi /usr/tbuild/ Here is the currently installed Teradata Warehouse Builder (TWB) software: Num Software Package Version Install Directory === ======== ======= ======= ================= 14 PIPC for TWB pipc /etc/pipc 15 TWB Infrastructure tbld /usr/tbuild/ TWB Infrastructure tbuild /usr 17 Operator Support Library posl /usr/tbuild/ Operator Support Library pcommon /usr 19 Data Connector Operator pdtc /usr/tbuild/ Data Connector Operator pdatacon /usr 21 DDL Operator pddl /usr/tbuild/ DDL Operator pddl /usr 23 Export Operator pexp /usr/tbuild/ Export Operator pexport /usr 25 Load Operator plod /usr/tbuild/ Load Operator pload /usr 27 ODBC Operator podbc /usr/tbuild/ Teradata Tools and Utilities Installation Guide for UNIX and Linux

55 Chapter 2: Before You Install Teradata Parallel Transporter 28 ODBC Operator podbc /usr 29 OS Command Operator posc /usr/tbuild/ SQL Inserter Operator pins /usr/tbuild/ SQL Inserter Operator pinsert /usr 32 SQL Selector Operator psel /usr/tbuild/ SQL Selector Operator pselect /usr 34 Stream Operator pstm /usr/tbuild/ Stream Operator pstream /usr 36 Update Operator pupd /usr/tbuild/ Update Operator pupdate /usr a Remove all of the above package(s) b Sort by software in ascending order c Sort by software in descending order d Sort by package in ascending order e Sort by package in descending order f Sort by version in ascending order g Sort by version in descending order q Quit this program Which package(s) do you want to remove? Enter selection and/or selection ranges separated by commas. For examples: 1,2-3 3 Enter a selection. 12 The system will ask for confirmation. Are you sure you want to remove the following software? Num Software Package Version === ======== ======= ======= 12 Update Operator pupd Enter y for yes or n for no [ default: y ]: y 4 Enter Y to confirm that you want to remove the package(s). Removing package <pupd8100> version Please wait... The following package is currently installed: pupd8100 Teradata Parallel Transporter Update Operator (AT486) Do you want to remove this package [y,n,?,q] y 5 Enter Y to confirm that the package is the correct version to remove. ## Removing installed package instance <pupd8100> ## Verifying package dependencies. ## Processing package information. ## Removing pathnames in <none> class ## Executing postremove script. ## Removing Entries from Update Directory ## Updating system information. Removal of <pupd8100> was successful. Teradata Tools and Utilities Installation Guide for UNIX and Linux 55

56 Chapter 2: Before You Install Teradata Parallel Transporter In the example above, Teradata Parallel Transporter Update Operator, version , was selected by entering 12. Entering y confirmed the selection, and initiated its removal. Note: Only a user logged in as root user can remove a package on the system. Note: The selection number may vary from the example, depending on the system configuration, selecting 12 may not always select Teradata Parallel Transporter Update Operator version Another way to remove a Teradata Parallel Transporter package is to be the root user, run the twbpkgrm tool with the -p option and valid Teradata Parallel Transporter package name(s), enter y to confirm that you want to remove the package(s). Multiple packages can be specified within single or double quotes and separated by space. Package(s) will be removed in the order specified. For example, to remove pupd8100 package (Teradata Parallel Transporter Update Operator version ), run twbpkgrm -p pupd8100 as the root user and y to confirm that you want to remove the pupd8100 package. Procedure - Removing Teradata Parallel Transporter with Method 2 Follow these steps to remove Teradata Warehouse Builder or Teradata Parallel Transporter with twbpkgrm with the -p option selected. 1 Log on as the root user. 2 Run the twbpkgrm tool with the -p option. For example: # /usr/bin/twbpkgrm -p pupd8100 A screen similar to the following displays: twbpkgrm Version File revision: Copyright , NCR Corporation. All Rights Reserved. Platform: NCR MP-RAS UNIX User specified package to be removed: 'pupd8100' NOTE: Package(s) will be removed in the order specified. Are you sure you want to remove the <pupd8100> package? Enter y for yes or n for no [ default: y ]: y 3 Enter Y to confirm that the package is the correct package to remove. Removing package <pupd8100>. Please wait... The following package is currently installed: pupd8100 Teradata Parallel Transporter Update Operator (AT486) Do you want to remove this package [y,n,?,q] y 4 Enter Y to confirm that the package is the correct version to remove. ## Removing installed package instance <pupd8100> ## Verifying package dependencies. 56 Teradata Tools and Utilities Installation Guide for UNIX and Linux

57 Chapter 2: Before You Install Teradata Parallel Transporter ## Processing package information. ## Removing pathnames in <none> class ## Executing postremove script. ## Removing Entries from Update Directory ## Updating system information. Removal of <pupd8100> was successful. Note: You must be the root user in order to remove a package on the system The procedure below is another example of using the -p option. The procedure shows the command to use to remove two packages, pupd8100 package (Teradata Parallel Transporter Update Operator version ), and pexp8100 package (Teradata Parallel Transporter Export Operator version ). Procedure - Removing Teradata Parallel Transporter Using Method 2 with Multiple Package Names Follow these steps to remove more than one Teradata Warehouse Builder or Teradata Parallel Transporter package with a single command. 1 Log on as the root user. 2 Run the twbpkgrm tool with the -p option with a list of the programs to remove. For example: # /usr/bin/twbpkgrm -p "pupd8100 pexp8100" twbpkgrm Version File revision: Copyright , NCR Corporation. All Rights Reserved. Platform: NCR MP-RAS UNIX User specified package(s) to be removed: 'pupd8100 pexp8100' NOTE: Package(s) will be removed in the order specified. Are you sure you want to remove the following package(s)? <pupd8100 pexp8100> Enter y for yes or n for no [ default: y ]: y 3 Enter Y to confirm that you want to remove the pupd8100 and pexp8100 packages: Removing package(s) <pupd8100 pexp8100>. Please wait... The following package is currently installed: pupd8100 Teradata Parallel Transporter Update Operator (AT486) Do you want to remove this package [y,n,?,q] y 4 Enter Y to confirm that the package is the correct version to remove. ## Removing installed package instance <pupd8100> ## Verifying package dependencies. ## Processing package information. ## Removing pathnames in <none> class ## Executing postremove script. ## Removing Entries from Update Directory ## Updating system information. Teradata Tools and Utilities Installation Guide for UNIX and Linux 57

58 Chapter 2: Before You Install Teradata Parallel Transporter Removal of <pupd8100> was successful. The following package is currently installed: pexp8100 Teradata Parallel Transporter Export Operator (AT486) Do you want to remove this package [y,n,?,q] y 5 Enter Y to confirm that the package is the correct version to remove. ## Removing installed package instance <pexp8100> ## Verifying package dependencies. ## Processing package information. ## Removing pathnames in <none> class ## Executing postremove script. ## Removing Entries from Update Directory ## Updating system information. Removal of <pexp8100> was successful. Note: You must be the root user in order to remove a package on the system All the packages contained in Teradata Parallel Transporter can be removed at one time using the -a option to the twbprgm command. Procedure - Removing Teradata Parallel Transporter with Method 3 Follow these steps to remove Teradata Warehouse Builder or Teradata Parallel Transporter with twbpkgrm with the -a option selected. 1 Log on as the root user. 2 Run the twbpkgrm tool with the -a option. For example: # /usr/bin/twbpkgrm -a Note: Use caution when removing all versions of Teradata Parallel Transporter. Teradata Parallel Transporter Install Information File Do not modify the /var/twbpkg file. The /var/twbpkg file stores Teradata Parallel Transporter installation information. No backup file exists for the /var/twbpkg file. Modification or removal of the /var/twbpkg file will cause installation and uninstallation problems for Teradata Parallel Transporter. When all packages of Teradata Parallel Transporter software are properly removed from the system, the /var/twbpkg file will be properly removed by the Teradata Parallel Transporter uninstall program. Switching Versions of Teradata Parallel Transporter Software After the Teradata Parallel Transporter Infrastructure is installed, the system is setup to run the installed version of the Teradata Parallel Transporter Infrastructure the next time you login. 58 Teradata Tools and Utilities Installation Guide for UNIX and Linux

59 Chapter 2: Before You Install Teradata Parallel Transporter Determining the Current Version of Software To find out which version of Teradata Parallel Transporter is currently running on the system, run tbuild with no options. Procedure - Determining the Current Version of Teradata Parallel Transporter Follow these steps to determine the current version of Teradata Parallel Transporter. 1 At the command prompt enter: # cd; tbuild The version is returned. Teradata Parallel Transporter Run Utility Version Switching to Teradata Warehouse Builder Version 4.1, or an Earlier Version of the Software There are three ways to switch to Teradata Warehouse Builder version 4.1, or an earlier version of Teradata Warehouse Builder that was previously installed. Method 1 - Running tbuild with the -f option Method 2 - Adding /usr/bin to the path environment variable Method 3 - Adding /usr/bin to the front of the path environment variable in the system login files for shell user Procedure - Switching to Teradata Warehouse Builder 4.1 Software Using Method 1 Follow these steps to switch to Teradata Warehouse Builder version 4.1, or an earlier version of the Teradata Warehouse Builder software by running tbuild with the -f option. 1 Run /usr/bin/tbuild with the -f option and a valid Teradata Warehouse Builder job script. # /usr/bin/tbuild -f <Teradata Warehouse Builder job script> Procedure - Switching to Teradata Warehouse Builder 4.1 Software Using Method 2 Follow these steps to switch to Teradata Warehouse Builder version 4.1, or an earlier version of the Teradata Warehouse Builder software adding /usr/bin to the path environment variable. 1 Add /usr/bin to the front of the PATH environment variable. For Bourne and Korn shell users, here is an example: # PATH=/usr/bin:$PATH # export PATH # tbuild -f <Teradata Warehouse Builder job script> This choice is only valid for the duration of the login. For C-shell users, here is an example: # setenv PATH /usr/bin:$path # tbuild -f <Teradata Warehouse Builder job script> Teradata Tools and Utilities Installation Guide for UNIX and Linux 59

60 Chapter 2: Before You Install Teradata Parallel Transporter This choice is only valid for the duration of the login. Procedure - Switching to Teradata Warehouse Builder 4.1 Software Using Method 3 Follow these steps to switch to Teradata Warehouse Builder version 4.1, or an earlier version of the Teradata Warehouse Builder software by adding /usr/bin to the front of the path environment variable in the system login files for shell user. 1 Add /usr/bin to the front of the PATH environment variable in the system login files for shell user. For Bourne and Korn shell users, here is an example: PATH=/usr/bin:$PATH export PATH For C-shell users, here is an example: setenv PATH /usr/bin:$path You must be the root user to perform this choice. This choice applies to the system for all users in the next login. Note: For Bourne/Korn shell users, the system login file is /etc/profile on HP-UX, AIX, Sun Solaris, and MP-RAS. Note: For C-shell users, the system login file is /etc/csh.login for HP-UX and AIX. The system login file is /etc/.login for Sun Solaris and MP-RAS. Switching to Teradata Warehouse Builder Version 5.0 Software There are two ways to switch to Teradata Warehouse Builder version 5.0 software that was previously installed. Method 1 - Update Environment Variables at the Command Prompt Method 2 - Update Environment Variables in the System Login Files for a Shell User Procedure - Switching to Teradata Warehouse Builder Version 5.0 Using Method 1 Follow these steps to switch to Teradata Warehouse Version 5.0 software by updating environment variables at the command prompt. 1 Find the Teradata Warehouse Builder installation directory by running the /usr/bin/twbpkgrm tool with no options. /usr/bin/twbpkgrm 2 Set the TWB_ROOT environment variable to the installation directory of the installed Teradata Warehouse Builder version 5.0. For Bourne and Korn shell users, enter these commands: # TWB_ROOT=<Teradata Warehouse Builder installation directory> # export TWB_ROOT <Teradata Warehouse Builder installation directory> is the Teradata Warehouse Builder version 5.0 installation directory. For C-shell users, enter this command: 60 Teradata Tools and Utilities Installation Guide for UNIX and Linux

61 Chapter 2: Before You Install Teradata Parallel Transporter # setenv TWB_ROOT <Teradata Warehouse Builder installation directory> <Teradata Warehouse Builder installation directory> is the Teradata Warehouse Builder version 5.0 installation directory. 3 Add the $TWB_ROOT/bin path to the PATH environment variable. For Bourne and Korn shell users, enter these commands: # PATH=$TWB_ROOT/bin:$PATH # export PATH For C-shell users, enter this command: # setenv PATH $TWB_ROOT"/bin:$PATH" 4 For AIX, add the $TWB_ROOT/lib path to the LIBPATH environment variable. For HP-UX, add the $TWB_ROOT/lib path to the SHLIB_PATH environment variable. For MP-RAS, Linux, and Sun Solaris, add the $TWB_ROOT/lib path to the LD_LIBRARY_PATH environment variable. For Bourne and Korn shell users on AIX, enter these commands: # LIBPATH=$TWB_ROOT/lib:$LIBPATH # export LIBPATH For Bourne and Korn shell users on HP-UX, enter these commands: # SHLIB_PATH=$TWB_ROOT/lib:$SHLIB_PATH # export SHLIB_PATH For Bourne and Korn shell users on MP-RAS, Linux, and Sun Solaris, enter these commands: # LD_LIBRARY_PATH=$TWB_ROOT/lib:$LD_LIBRARY_PATH # export LD_LIBRARY_PATH For C-shell users on AIX, enter this command: # setenv LIBPATH $TWB_ROOT"/lib:$LIBPATH" For C-shell users on HP-UX, enter this command: # setenv SHLIB_PATH $TWB_ROOT"/lib:$SHLIB_PATH" For C-shell users on MP-RAS, Linux, and Sun Solaris, enter this command: # setenv LD_LIBRARY_PATH $TWB_ROOT"/lib:$LD_LIBRARY_PATH" 5 Add the $TWB_ROOT/msg/%N path to the NLSPATH environment variable. For Bourne and Korn shell users, enter these commands: # NLSPATH=$TWB_ROOT/msg/%N:$NLSPATH # export NLSPATH For C-shell users, enter this command: # setenv NLSPATH $TWB_ROOT"/msg/%N:$NLSPATH" This method is only valid for the duration of the login. Method 2 - Update Environment Variables in the System Login Files for a Shell User You must be the root user to perform this method. This method applies to the system for all users in the next login. For Bourne/Korn shell users, the system login file is /etc/profile on HP-UX, AIX, Sun Solaris, Linux, and MP-RAS. Teradata Tools and Utilities Installation Guide for UNIX and Linux 61

62 Chapter 2: Before You Install Teradata Parallel Transporter For C-shell users, the system login file is /etc/csh.login for HP-UX, Linux, and AIX. The system login file is /etc/.login for Sun Solaris and MP-RAS. Procedure - Switching to Teradata Warehouse Builder Version 5.0 Using Method 2 Follow these steps to switch to Teradata Warehouse Version 5.0 software by updating environment variables in the system login files for a shell user. 1 Find the Teradata Warehouse Builder version 5.0 installation directory by running the /usr/bin/twbpkgrm tool with no options. # /usr/bin/twbpkgrm 2 Set the TWB_ROOT environment variable to the installation directory of the installed Teradata Warehouse Builder version 5.0 in the system login files for shell user. In the system login file for Bourne and Korn shell users, add these lines to the file: TWB_ROOT=<Teradata Parallel Transporter installation directory> export TWB_ROOT <Teradata Warehouse Builder installation directory> is the Teradata Warehouse Builder version 5.0 installation directory. In the system login file for C-shell users, add this line to the file: setenv TWB_ROOT <Teradata warehouse Builder installation directory> <Teradata Warehouse Builder installation directory> is the Teradata Warehouse Builder version 5.0 installation directory. 3 Add the $TWB_ROOT/bin path to the PATH environment variable in the system login files for shell user. In the system login file for Bourne and Korn shell users, add these lines to the file: if [ "$PATH" = "" ]; then PATH="$TWB_ROOT"/bin else PATH="$TWB_ROOT"/bin:"$PATH" fi export PATH In the system login file for C-shell users, add these lines to the file: if {$?PATH} then setenv PATH $TWB_ROOT"/bin:$PATH" else setenv PATH $TWB_ROOT/bin endif 4 For AIX, add the $TWB_ROOT/lib path to the LIBPATH environment variable in the system login files for shell user. For HP-UX, add the $TWB_ROOT/lib path to the SHLIB_PATH environment variable in the system login files for shell user. For MP-RAS, Linux, and Sun Solaris, add the $TWB_ROOT/lib path to the LD_LIBRARY_PATH environment variable in the system login files for shell user. In the system login file for Bourne and Korn shell users on AIX, add these lines to the file: if [ "$LIBPATH" = "" ]; then 62 Teradata Tools and Utilities Installation Guide for UNIX and Linux

63 Chapter 2: Before You Install Teradata Parallel Transporter LIBPATH="$TWB_ROOT"/lib:/usr/lib else LIBPATH="$TWB_ROOT"/lib:"$LIBPATH":/usr/lib fi export LIBPATH In the system login file for Bourne and Korn shell users on HP-UX, add these lines to the file: if [ "$SHLIB_PATH" = "" ]; then SHLIB_PATH="$TWB_ROOT"/lib:/usr/lib else SHLIB_PATH="$TWB_ROOT"/lib:"$SHLIB_PATH":/usr/lib fi export SHLIB_PATH In the system login file for Bourne and Korn shell users on MP-RAS, Linux, and Sun Solaris, add these lines to the file: if [ "$LD_LIBRARY_PATH" = "" ]; then LD_LIBRARY_PATH="$TWB_ROOT"/lib:/usr/lib else LD_LIBRARY_PATH="$TWB_ROOT"/lib:"$LD_LIBRARY_PATH":/usr/lib fi export LD_LIBRARY_PATH In the system login file for C-shell users on AIX, add these lines to the file: if {$?LIBPATH} then setenv LIBPATH $TWB_ROOT"/lib:$LIBPATH:/usr/lib" else setenv LIBPATH $TWB_ROOT/lib:/usr/lib endif In the system login file for C-shell users on HP-UX, add these lines to the file: if {$?SHLIB_PATH} then setenv SHLIB_PATH $TWB_ROOT"/lib:$SHLIB_PATH:/usr/lib" else setenv SHLIB_PATH $TWB_ROOT/lib:/usr/lib endif In the system login file for C-shell users on MP-RAS and Sun Solaris, add these lines to the file: if {$?LD_LIBRARY_PATH} then setenv LD_LIBRARY_PATH $TWB_ROOT"/lib:$LD_LIBRARY_PATH:/usr/lib" else setenv LD_LIBRARY_PATH $TWB_ROOT/lib:/usr/lib endif 5 Add the $TWB_ROOT/msg/%N path to the NLSPATH environment variable in the system login files for shell user. In the system login file for Bourne and Korn shell users, add these lines to the file: if [ "$NLSPATH" = "" ]; then NLSPATH="$TWB_ROOT"/msg/%N else NLSPATH="$TWB_ROOT"/msg/%N:"$NLSPATH" fi export NLSPATH In the system login file for C-shell users, add these lines to the file: if {$?NLSPATH} then Teradata Tools and Utilities Installation Guide for UNIX and Linux 63

64 Chapter 2: Before You Install Teradata Parallel Transporter setenv NLSPATH $TWB_ROOT"/msg/%N:$NLSPATH" else setenv NLSPATH $TWB_ROOT/msg/%N endif This method applies to the system for all users in the next login. Switching Back to the Installed Teradata Parallel Transporter Version To switch back to the installed Teradata Parallel Transporter version, use one of the following two methods. Method 1 - Update Environment Variables at the Command Prompt Method 2 - Update Environment Variables in the System Login Files for a Shell User Procedure - Switching the Teradata Parallel Transporter Version using Method 1 Follow these steps to switch the Teradata Parallel Transporter Version by updating environment variables at from the command prompt. 1 Find the Teradata Parallel Transporter installation directory by running the /usr/bin/twbpkgrm tool with no options. /usr/bin/twbpkgrm 2 Set the TWB_ROOT environment variable to the installation directory of the installed Teradata Parallel Transporter version. For Bourne and Korn shell users, enter these commands: # TWB_ROOT=<Teradata Parallel Transporter installation directory> # export TWB_ROOT <Teradata Parallel Transporter installation directory> is the Teradata Parallel Transporter installation directory. For C-shell users, enter this command: # setenv TWB_ROOT <Teradata Parallel Transporter installation directory> <Teradata Parallel Transporter installation directory> is the Teradata Parallel Transporter installation directory. 3 Add the $TWB_ROOT/bin path to the PATH environment variable. For Bourne and Korn shell users, enter these commands: # PATH=$TWB_ROOT/bin:$PATH # export PATH For C-shell users, enter this command: # setenv PATH $TWB_ROOT"/bin:$PATH" This method is only valid for the duration of the login. 64 Teradata Tools and Utilities Installation Guide for UNIX and Linux

65 Chapter 2: Before You Install Teradata Parallel Transporter Procedure - Switching the Teradata Parallel Transporter Version using Method 2 Follow these steps to switch the Teradata Parallel Transporter Version by updating environment variables in the system login files for a shell user. 1 You must be the root user to perform this method. This method applies to the system for all users in the next login. Note: For Bourne/Korn shell users, the system login file is /etc/profile on HP-UX, AIX, Sun Solaris, Linux, and MP-RAS. Note: For C-shell users, the system login file is /etc/csh.login for HP-UX, Linux, and AIX. The system login file is /etc/.login for Sun Solaris and MP-RAS. 2 Find the Teradata Parallel Transporter installation directory by running the /usr/bin/twbpkgrm tool with no options. # /usr/bin/twbpkgrm 3 Set the TWB_ROOT environment variable to the installation directory of the installed Teradata Parallel Transporter version in the system login files for shell user. In the system login file for Bourne and Korn shell users, add these lines to the file: TWB_ROOT=<Teradata Parallel Transporter installation directory> export TWB_ROOT Note: <Teradata Parallel Transporter installation directory> is the Teradata Parallel Transporter installation directory. In the system login file for C-shell users, add this line to the file: setenv TWB_ROOT <Teradata Parallel Transporter installation directory> Note: <Teradata Parallel Transporter installation directory> is the Teradata Parallel Transporter installation directory. 4 Add the $TWB_ROOT/bin path to the PATH environment variable in the system login files for shell user. In the system login file for Bourne and Korn shell users, add these lines to the file: if [ "$PATH" = "" ]; then PATH="$TWB_ROOT"/bin else PATH="$TWB_ROOT"/bin:"$PATH" fi export PATH In the system login file for C-shell users, add these lines to the file: if {$?PATH} then setenv PATH $TWB_ROOT"/bin:$PATH" else setenv PATH $TWB_ROOT/bin endif This method applies to the system for all users in the next login. Teradata Tools and Utilities Installation Guide for UNIX and Linux 65

66 Chapter 2: Before You Install Teradata Generic Security Services Teradata Generic Security Services TeraGSS Package Names This section discusses general information you need to know about the Teradata Generic Security Services feature before installing it. It describes how to remove TeraGSS packages and switch versions. See Chapter 12: Connecting to a Teradata Database, for additional information on security and logging onto Teradata. With the exception of the Teradata Generic Security Service package for MP-RAS, TeraGSS, all of the Teradata Generic Security Service packages include the target architecture as part of the package name. For example, the Teradata Generic Security Service package for Sun Solaris TeraGSS_solaris-sparc. For MP-RAS, the architecture is not included as part of the package name (the package name is TeraGSS) because of a restriction on the length of the package name. Removing TeraGSS Packages Although, it is not necessary to remove previous versions of TeraGSS prior to installing a new version, multiple versions of TeraGSS may coexist on a node, TeraGSS software can be removed from a node using the tdgsspkgrm utility included in the installation package. This allow cleanup up of obsolete (non-current versions) of TeraGSS. The tdgsspkgrm utility can be found at /usr/teragss/<architecture>/client/bin/tdgsspkgrm, where <architecture> is the architecture for the TeraGSS package. For example: mpras-i386 and solaris-sparc. # tdgsspkgrm -h Usage: tdgsspkgrm [version to remove] e.g. tdgsspkgrm Procedure - Removing the TeraGSS Package Follow these steps to remove obsolete, non-current versions of the TeraGSS package from the client. 1 Log on as the root user. 2 Run the tdgsspkgrm tool without any options to list the versions of TeraGSS installed. For example: # tdgsspkgrm When executed with no arguments, the tdgsspkgrm utility will display information on installed versions. TeraGSS current version: 06G TeraGSS versions available for removal: 06H Teradata Tools and Utilities Installation Guide for UNIX and Linux

67 Chapter 2: Before You Install Updating the Teradata Parallel Transporter API 3 To remove an obsolete version, execute tdgsspkgrm and specify the version to remove. For example: # tdgsspkgrm 06H Note: The current version cannot be removed using tdgsspkgrm. To remove the current version, use the appropriate utility for the operating system. For example: pkgrm on MP- RAS. Switching Versions of TeraGSS Software Switching between installed versions of TeraGSS software is allowed. After a new version of TeraGSS is installed, the new version can be set as the current version, that switch must be done manually. To facilitate version switching, a utility named tdgssversion is included in the package. The tdgssversion utility can be found at: usr/teragss/<architecture>/client/bin/tdgssversion Usage: tdgssversion [-switch nn.nn.nn.nn] where: <architecture> is the architecture for the TeraGSS package. For example: mpras-i386 and solaris-sparc. And: nn.nn.nn.nn is the version of TeraGSS. Procedure - Switching between versions of TeraGSS Follow these steps to switch between versions of TeraGSS. 1 Log on as the root user. 2 Run the tdgssversion tool without any options to list the versions of TeraGSS installed. For example, enter: # tdgssversion The output indicates the Teradata GSS Client available versions are: 06H and 06G *. The asterisk (*) denotes the current version. TeraGSS current version: 06G * TeraGSS versions available for removal: 06H To switch to the 06H version enter: # tdgssversion -h 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. Teradata Tools and Utilities Installation Guide for UNIX and Linux 67

68 Chapter 2: Before You Install Technical Assistance Unicode Support (UTF16) Buffer Mode Exporting with Export Driver s New GetBuffer Function Performance Enhancement for the Export Driver s GetRow Function Array Support for the Stream Driver When upgrading applications built with previous versions of the Teradata Parallel Transporter API to the current release of the Teradata Parallel Transporter API, note that the Teradata Parallel Transporter API header files have been changed in the 12.0 release of the product. Applications built with previous versions of Teradata Parallel Transporter API must be re-compiled with these updated header files in order to use Teradata PT API Teradata Parallel Transporter API applications on MP-RAS must now explicitly link with the new Teradata Parallel Transporter ICU library using the -lpxicu option. If the Teradata Parallel Transporter ICU library is installed in the same directory as the Teradata Parallel Transporter API library then no changes need to be made to system environment variables to accommodate this new link option. The default installation directory for the Teradata Parallel Transporter ICU library is the same as the default installation directory for the Teradata Parallel Transporter API library. Technical Assistance Technical assistance during installation of the Teradata Tools and Utilities software is available from the TSCS-RSC. For contact information, see the Teradata Tools and Utilities Release Definition, Release Teradata Tools and Utilities Installation Guide for UNIX and Linux

69 CHAPTER 3 Installing on MP-RAS Client Systems This chapter describes process for installing the Teradata Tools and Utilities software on your UNIX MP-RAS system. The installation topics are: Installing Individual Products Uninstalling Previous Versions of Software Installing the Teradata Tools and Utilities Installing Teradata Parallel Transporter Adding CLI User Exit Functions Installing Individual Products Installation CD-ROMs This section describes how to install Teradata Tools and Utilities on an MP-RAS operating system. The specific operating systems include: NCR MP-RAS 3.02 running on Intel x86 and Intel Xeon with EM64T (32-bit Teradata Tools and Utilities) NCR MP-RAS 3.03 running on Intel x86 and Intel Xeon with EM64T (32-bit Teradata Tools and Utilities) Install Teradata Tools and Utilities products using setup.bat from one of the following CDs: 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) Teradata Tools and Utilities Installation Guide for UNIX and Linux 69

70 Chapter 3: Installing on MP-RAS Client Systems Installing Individual Products MP-RAS Packages Parallel Transporter - CD#3 (AIX and Solaris Products) Query Director Tape Storage Management Enablers Meta Data Services The following table shows the MP-RAS package names and the packages included with this release. Version numbers are contained in the Teradata Tools and Utilities Release Definition, Release Table 21: MP-RAS Packages and Operating Systems Product Package Names NCR MP-RAS 3.02 running on Intel x86 and Intel Xeon with EM64T (32-bit Teradata Tools and Utilities)) NCR MP-RAS 3.03 running on Intel x86 and Intel Xeon with EM64T (32-bit Teradata Tools and Utilities) Basic Teradata Query (BTEQ) bteq YES YES Named Pipes Access Module npaxsmod YES YES ODBC Driver for Teradata tdodbc YES YES Shared Common Components for Internationalization for Teradata tdicu YES YES Teradata Access Module for JMS jmsaxsmod NO NO Teradata Archive/Recovery Utility (ARC) arc YES YES Teradata Call-Level Interface version 2 (CLIv2) cliv2 YES YES Teradata C Preprocessor2 sqlpp YES YES Teradata COBOL Preprocessor2 cobpp YES YES Teradata Data Connector (also known as PIOM) piom YES YES Teradata FastExport fastexp YES YES Teradata FastLoad fastld YES YES Teradata Generic Security Services TeraGSS YES YES Teradata MultiLoad mload YES YES 70 Teradata Tools and Utilities Installation Guide for UNIX and Linux

71 Chapter 3: Installing on MP-RAS Client Systems Installing Individual Products Table 21: MP-RAS Packages and Operating Systems (continued) Product Package Names NCR MP-RAS 3.02 running on Intel x86 and Intel Xeon with EM64T (32-bit Teradata Tools and Utilities)) NCR MP-RAS 3.03 running on Intel x86 and Intel Xeon with EM64T (32-bit Teradata Tools and Utilities) Teradata Parallel Transporter API papic000 YES YES Teradata Parallel Transporter Data Connector Operator pdtcc000 YES YES Teradata Parallel Transporter DDL Operator pddlc000 YES YES Teradata Parallel Transporter Export Operator pexpc000 YES YES Teradata Parallel Transporter FastExport OUTMOD Adapter Operator Loaded as part of Teradata Parallel Transporter Infrastructure YES YES Teradata Parallel Transporter FastLoad INMOD Adapter Operator Loaded as part of Teradata Parallel Transporter Infrastructure YES YES Teradata Parallel Transporter ICU Library picuc000 YES YES Teradata Parallel Transporter Infrastructure tbldc000 YES YES Teradata Parallel Transporter Load Operator plodc000 YES YES Teradata Parallel Transporter MultiLoad INMOD Adapter Operator Loaded as part of Teradata Parallel Transporter Infrastructure YES YES Teradata Parallel Transporter ODBC Operator podbcc000 YES YES Teradata Parallel Transporter Operator Support Library poslc000 YES YES Teradata Parallel Transporter OS Command Operator poscc000 YES YES Teradata Parallel Transporter SQL Inserter Operator pinsc000 YES YES Teradata Parallel Transporter SQL Selector Operator pselc000 YES YES Teradata Tools and Utilities Installation Guide for UNIX and Linux 71

72 Chapter 3: Installing on MP-RAS Client Systems Uninstalling Previous Versions of Software Table 21: MP-RAS Packages and Operating Systems (continued) Product Package Names NCR MP-RAS 3.02 running on Intel x86 and Intel Xeon with EM64T (32-bit Teradata Tools and Utilities)) NCR MP-RAS 3.03 running on Intel x86 and Intel Xeon with EM64T (32-bit Teradata Tools and Utilities) Teradata Parallel Transporter Stream Operator pstmc000 YES YES Teradata Parallel Transporter Update Operator pupdc000 YES YES Teradata TPump tpump YES YES WebSphere MQ Access Module mqaxsmod YES YES Uninstalling Previous Versions of Software Prior to the installing new versions of the Teradata Tools and Utilities, previous versions should be removed. Note: If a previous version of cliv2 is installed, it must be uninstalled before installing the newer version. Note: An exception is the Teradata Generic Security Services software, it does not have to be uninstalled. Note: Teradata Parallel Transporter is an exception, and does not have to be uninstalled. Although, it can be uninstalled using the following procedure. Procedure - Uninstalling Previous Versions of Teradata Tools and Utilities Software Follow these steps to check for any existing software and remove it. 1 Prior to the installing new versions of the Teradata Tools and Utilities, previous versions should be removed. # pkginfo -x <PkgName> 2 If the software package is on the node, you must remove it. To remove the software package, enter the following as root: # pkgrm <PkgName> 72 Teradata Tools and Utilities Installation Guide for UNIX and Linux

73 Chapter 3: Installing on MP-RAS Client Systems Installing the Teradata Tools and Utilities Enter Y in response to the following prompt: "Do you want to remove this package?" Teradata Parallel Transporter Default and Alternate Directory Teradata Parallel Transporter allows a user-specified installation directory. The default installation directory for Teradata Parallel Transporter is /usr/tbuild/<version>. where: <version> is the version number for Teradata Parallel Transporter. For example, the default install directory for Teradata Parallel Transporter version is: /usr/tbuild/ The following are the restrictions for the installation directory for Teradata Parallel Transporter: The installation directory cannot be a relative directory path. The pipe character cannot be in the name of the installation directory. The double quote character cannot be in the name of the installation directory. The equal character = cannot be in the name of the installation directory. The whitespace character cannot be in the name of the installation directory. The first Teradata Parallel Transporter package asks for the installation directory. Subsequent Teradata Parallel Transporter packages of the same version will not ask for the installation directory, instead, they will use the same installation directory as the first package. Starting with Teradata Parallel Transporter , an installation of a Teradata Parallel Transporter emergency fix (efix) package will overwrite the installed Teradata Parallel Transporter package. For example, the installation of Teradata Parallel Transporter Infrastructure will overwrite the Teradata Parallel Transporter Infrastructure package. Installing the Teradata Tools and Utilities See Table 21 on page 70 for a list of the Teradata Tools and Utilities software that can be installed on an MP-RAS client. Procedure - Installing Teradata Tools and Utilities Software on an MP-RAS Client Follow these steps to install Teradata Tools and Utilities products on an MP-RAS client. 1 Insert the CD into the CD-ROM drive. 2 Find out the <cd_device_name> by entering the following command as root: # devstat -FI Teradata Tools and Utilities Installation Guide for UNIX and Linux 73

74 Chapter 3: Installing on MP-RAS Client Systems Installing the Teradata Tools and Utilities This command should return a readout similar to the following. The <cd_device_name> would be /dev/dsk/c0t6d0s0. Searching for devices... IO Bus 0 Controller 0 Initiator...c0t7d0s0 ADAPTEC PCI I Cdrom...c0t6d0s0 TOSHIBA CD-ROM XM-6201TA 1037 Controller 1 Initiator...c10t7d0s0 ADAPTEC PCI I Disk...c10t0d0s0 SEAGATE ST39102LC Mb Disk...c10t1d0s0 SEAGATE ST118273WC Mb Disk...c10t2d0s0 SEAGATE ST118273WC Mb Disk...c10t3d0s0 SEAGATE ST39102LC 7C Mb 3 If it does not already exist, create a /cdrom directory. As root, enter the following command on the node: # mkdir /cdrom 4 You should mount the CD-ROM to a local file. As root, enter the following command. If needed, insert the path name before <cd_device _name>: # mount -F cdfs -o ro <cd_device_name> /cdrom 5 Start the installation. As root, enter the following command: # /cdrom/setup.bat 6 For systems with an Administration Work Station (AWS), enter Y in response to the following warning and prompt: WARNING: The AWS update should be completed before updating an AP. Please ignore this warning if the AWS has been updated. Do you want to continue with the AP installation? 7 For systems without an AWS, enter N or wait for the time-out to accept the Y default in response to the following prompt: Do you want to use VM&F? (default: y) 8 The installation screen appears (the following sample is from the Load/Unload CD). An asterisk beside a package indicates that either the same version or an older version is already installed on your system: pkgplus - Package Selection >*TeraGSS *bteq *cliv2 *piom *fastexp *fastld *mload *mqaxsmod *npaxsmod *tdicu *tdodbc *tpump (Package 1 of 12) Description=Teradata GSS client package Version= (*This version is already installed) (a) Add (o) Original (s) Spool (U) Unselect all 74 Teradata Tools and Utilities Installation Guide for UNIX and Linux

75 Chapter 3: Installing on MP-RAS Client Systems Installing the Teradata Tools and Utilities (A) Add all (r) Response (S) Spool all (q) Quit/Abort (h) Help (R) Rollback on (u) Unselect (x) Save+Exit Note: Teradata Parallel Transporter packages are contained on Load/Unload CD #2. 9 From the installation screen, select the packages you want to install. Arrow down and enter a next to the name of each package. 10 Enter an a next to piom (Data Connector) whenever ARC (arc), BTEQ (bteq), Teradata Fast Export (fastexp), Teradata FastLoad (fastld), Teradata MultiLoad (mload), or Teradata TPump (tpump) are selected. 11 After all desired packages have been selected, press x to save and exit. The installer will check disk space and begin installing. 12 Upon completion, a message will indicate that the installation operation is complete. 13 From the root directory, enter the following command and remove the CD from the CD- ROM drive: # umount /cdrom 14 If a reboot is required immediately, the system will prompt you. Otherwise, a reboot is not required. Installing Teradata Parallel Transporter The installation of a new version of Teradata Parallel Transporter will prompt for the Teradata Parallel Transporter installation directory. The following is an example of the prompt: Please specify the install directory [default:/usr/tbuild/ ]: Note: It is not recommended to use / or /usr as the installation directory. If you respond by pressing the Enter key, the default installation directory is used. The following are the restrictions on the installation directory for Teradata Parallel Transporter: The installation directory cannot be a relative directory path. The pipe character cannot be in the name of the installation directory. The double quote character cannot be in the name of the installation directory. The equal character = cannot be in the name of the installation directory. The whitespace character cannot be in the name of the installation directory. In addition to the Teradata Parallel Transporter installation directory, the Teradata Parallel Transporter Infrastructure package will prompt for the Teradata Parallel Transporter logs directory. The following is an example of the prompt: The logs directory contains Teradata Parallel Transporter job log files. The logs directory should be in a partition with a large free space. Please specify the logs directory [ default: /usr/tbuild/ / logs ]: If you respond by pressing the Enter key, the default logs directory will be used. Teradata Tools and Utilities Installation Guide for UNIX and Linux 75

76 Chapter 3: Installing on MP-RAS Client Systems Installing the Teradata Tools and Utilities The following are the restrictions on the logs directory for Teradata Parallel Transporter: The logs directory cannot be a relative directory path. The whitespace character cannot be in the name of the logs directory. The Teradata Parallel Transporter package will prompt for the interprocess communication (IPC) memory choice. The following is an example of the prompt: Teradata Parallel Transporter Infrastructure uses shared memory or memory mapped file for interprocess communication (IPC). Shared memory utilizes system shared memory for IPC. Memory mapped file utilizes temporary disk storage for IPC. Please select the IPC memory mechanism [ default: shared memory ]: Enter 1 for shared memory Enter 2 for memory mapped file If you respond by pressing the Enter key or 1, the IPC memory choice will be shared memory. If you respond by pressing 2, the IPC memory choice will be memory mapped file and the Teradata Parallel Transporter package will prompt for the memory mapped file directory. The following is an example of the prompt: The memory mapped file directory contains temporary Teradata Parallel Transporter job files. The memory mapped file directory should be in a partition with a large free space. Please specify the memory mapped file directory [ default: /usr/tbuild/ /mmap ]: If you respond by pressing the Enter key, the default memory mapped file directory will be used. The following are the restrictions on the memory mapped file directory for Teradata Parallel Transporter: The memory mapped file directory cannot be a relative directory path. The whitespace character cannot be in the name of the memory mapped file directory Note: During the reinstall of the same Teradata Parallel Infrastructure version, the Teradata Parallel Infrastructure reinstall will not ask for the IPC memory choice. The reinstall will reuse the existing IPC memory choice. Note: The first Teradata Parallel Transporter package will ask for the installation directory. Subsequent Teradata Parallel Transporter packages of the same version will not ask for the installation directory, instead, they will use the same version of the installation directory as the first package. The Teradata Parallel Transporter Infrastructure package checks for the following system kernel values: 76 Teradata Tools and Utilities Installation Guide for UNIX and Linux

77 Chapter 3: Installing on MP-RAS Client Systems Installing the Teradata Tools and Utilities Table 22: Kernel Values Kernel Parameter Required Minimum Value Description NUMTRW 1328 Number of TLI read/write structures to allocate in kernel data space SEMMAP 1000 Maximum number of entries in a semaphore map. SEMMNI 1000 Maximum number of semaphore sets in entire system. SEMMNS 1000 Maximum number of semaphores in entire system. SEMMNU 2500 Maximum number of processes that can have undo operations pending on semaphores. SHMMAX Maximum size of a shared memory segment. SHMMNI 200 Maximum number of shared memory segments in entire system. SHMSEG 10 Maximum number of shared memory segments per process. Note: The Teradata Parallel Transporter Infrastructure installation does not support formula value. If the kernel value is a formula, then the Teradata Parallel Transporter Infrastructure installation will display a warning message. If the system does not meet the required minimum value, the Teradata Parallel Transporter Infrastructure installation will prompt for an increase in the minimum required value. Here is a sample of the prompt: Warning: The current value of for the kernel parameter (SHMMAX) is less than the minimum required value of SHMMAX refers to the maximum size of a shared memory segment. Note: This install recommends increasing the value to the minimum required value. Note: A reboot is required to make the kernel parameter change(s) effective. The reboot can be done after this installation but before running Teradata Parallel Transporter jobs. Do you want to increase the value to the minimum required value for the above kernel parameter(s)? Please enter y for yes or n for no [y,n,? (default : y)] If you enter n, the Teradata Parallel Transporter Infrastructure package will not change the kernel value. If you enter y, or if you respond by pressing the Enter key, the Teradata Parallel Transporter Infrastructure package will prompt you to rebuild the kernel after the end of the Teradata Parallel Transporter Infrastructure installation. Here is a sample of the prompt: Teradata Tools and Utilities Installation Guide for UNIX and Linux 77

78 Chapter 3: Installing on MP-RAS Client Systems Installing the Teradata Tools and Utilities A kernel rebuild is required to make the kernel parameter change(s) effective. Do you want to rebuild the kernel at the end of this installation? Please enter y for yes or n for no [y,n,? (default : y)] If you enter n, the Teradata Parallel Transporter Infrastructure package will not rebuild the kernel. If you enter y or if you respond by pressing the Enter key, the Teradata Parallel Transporter Infrastructure package will rebuild the kernel at the end of the Teradata Parallel Transporter Infrastructure installation. A reboot is required to make the kernel parameter change(s) effective. The reboot can be done after all the installations, but before running a Teradata Parallel Transporter job. You must be the root user to reboot the system. The following sample reboot command will reboot the system in 60 seconds: # cd; /usr/sbin/shutdown -y -g60 -i6 At the end of the Teradata Parallel Transporter Infrastructure installation, the Teradata Parallel Transporter Infrastructure installation will update the following environment variables in the system /etc/profile and /etc/.login files: Table 23: Environment Variables Updated Environment Variable TWB_ROOT PATH LD_LIBRARY_PATH NLSPATH Update to Environment Variable Set to the Teradata Parallel Transporter installation directory. Add $TWB_ROOT/bin to the front of the PATH environment variable. Add $TWB_ROOT/lib to the front of the LD_LIBRARY_PATH environment variable. Add $TWB_ROOT/msg/%N to the front of the NLSPATH environment variable. The updates to the environment variables are effective in the next login only if the Teradata Parallel Transporter Infrastructure package is installed. The updates to the environment variables allow users to run the installed version of Teradata Parallel Transporter. If the Teradata Parallel Transporter API package is installed, then the LD_LIBRARY_PATH and NLSPATH environment variables must be updated manually. The environment variables can be updated on the command line, in the user's profile, or in the system profile. If the environment variables are updated on the command line, then the updates are effective only for the current session. If the environment variables are updated in the user's profile, then the updates are effective every time that particular user logs in. If the environment variables are updated in the system profile, then the updates are effective every time any user logs in. 78 Teradata Tools and Utilities Installation Guide for UNIX and Linux

79 Chapter 3: Installing on MP-RAS Client Systems Adding CLI User Exit Functions Note: Users must use the updates to the environment variables in order to run the installed version of Teradata Parallel Transporter properly. Note: If users do not use the updates to the environment variables, then they will not be able to run the installed version of Teradata Parallel Transporter properly. Adding CLI User Exit Functions CLI User Exit functions are general purpose facilities that may be added to the CLI workstation architecture on UNIX MP-RAS systems. These functions allow user-defined processing to take place. Procedure - Adding CLI User Exit Functions to an MP-RAS Client Follow these steps to add CLI User Exit functions to an MP-RAS client. 1 Change directories to /usr/sample, using the following command: # cd /usr/sample 2 Modify the CliLgnEx.c or CliPPS.c file in the sample directory. 3 Compile and link using the make facility to create a new shared object, libtdusr.so: # make -f makeusr.unx 4 Move the libtdusr.so file into the appropriate directory 5 The CLIv2 libcliv2 should also exist in the same directory (generally /usr/lib). For more information on CLI User Exit Functions, see Teradata Call-Level Interface Version 2 Reference for Network-Attached Systems, Appendix D. Teradata Tools and Utilities Installation Guide for UNIX and Linux 79

80 Chapter 3: Installing on MP-RAS Client Systems Adding CLI User Exit Functions 80 Teradata Tools and Utilities Installation Guide for UNIX and Linux

81 CHAPTER 4 Installing on IBM AIX Client Systems This chapter describes the procedures to install and uninstall the Teradata Tools and Utilities software on IBM AIX client systems: Installing Individual Products Removing Previous Versions of Software Installing Teradata Tools and Utilities Installing the Teradata Driver for the JDBC Interface Installing Teradata Parallel Transporter Adding CLI User Exit Functions Installing Individual Products Installation CD-ROMs This section describes how to install Teradata Tools and Utilities on an IBM AIX operating system. The specific operating systems include: IBM AIX 5.1 running on 32-bit and 64-bit IBM Power PC (32-bit Teradata Tools and Utilities) IBM AIX 5.1 running on IBM Power PC (64-bit Teradata Tools and Utilities) IBM AIX 5.2 running on 32-bit and 64-bit IBM Power PC (32-bit Teradata Tools and Utilities) IBM AIX 5.2 running on IBM Power PC (64-bit Teradata Tools and Utilities) IBM AIX 5.3 running on 32-bit and 64-bit IBM Power PC (32-bit Teradata Tools and Utilities) IBM AIX 5.3 running on IBM Power PC (64-bit Teradata Tools and Utilities) Install Teradata Tools and Utilities products using setup.bat from one of the following CDs: 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) Teradata Tools and Utilities Installation Guide for UNIX and Linux 81

82 Chapter 4: Installing on IBM AIX Client Systems Installing Individual Products IBM AIX Packages 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 The following table shows the IBM AIX package names and the packages included with this release. Version numbers are contained in the Teradata Tools and Utilities Release Definition, Release Table 24: IBM AIX Packages and Operating Systems Product Package Names IBM AIX 5.1 running on 32-bit and 64-bit IBM Power PC (32-bit Teradata Tools and Utilities) IBM AIX 5.1 running on IBM Power PC (64-bit Teradata Tools and Utilities) IBM AIX 5.2 running on 32-bit and 64-bit IBM Power PC (32-bit Teradata Tools and Utilities) IBM AIX 5.2 running on IBM Power PC (64-bit Teradata Tools and Utilities) IBM AIX 5.3 running on 32-bit and 64-bit IBM Power PC (32-bit Teradata Tools and Utilities) IBM AIX 5.3 running on IBM Power PC (64-bit Teradata Tools and Utilities) Basic Teradata Query (BTEQ) bteq YES NO YES NO YES NO Named Pipes Access Module npaxsmod YES NO YES NO YES NO ODBC Driver for Teradata tdodbc YES YES YES YES YES YES Shared Common Components for Internationalization for Teradata tdicu YES YES YES YES YES YES Teradata Access Module for JMS jmsaxsmod YES NO YES NO YES NO Teradata C Preprocessor2 sqlpp YES YES YES YES YES YES Teradata Call-Level Interface version 2 (CLIv2) cliv2 YES YES YES YES YES YES Teradata COBOL Preprocessor2 cobpp YES NO YES YES YES YES Teradata Data Connector (also known as PIOM) piom YES NO YES NO YES NO Teradata Driver for the JDBC Interface terajdbc4.jar YES YES YES YES YES YES 82 Teradata Tools and Utilities Installation Guide for UNIX and Linux

83 Chapter 4: Installing on IBM AIX Client Systems Installing Individual Products Table 24: IBM AIX Packages and Operating Systems (continued) Product Package Names IBM AIX 5.1 running on 32-bit and 64-bit IBM Power PC (32-bit Teradata Tools and Utilities) IBM AIX 5.1 running on IBM Power PC (64-bit Teradata Tools and Utilities) IBM AIX 5.2 running on 32-bit and 64-bit IBM Power PC (32-bit Teradata Tools and Utilities) IBM AIX 5.2 running on IBM Power PC (64-bit Teradata Tools and Utilities) IBM AIX 5.3 running on 32-bit and 64-bit IBM Power PC (32-bit Teradata Tools and Utilities) IBM AIX 5.3 running on IBM Power PC (64-bit Teradata Tools and Utilities) Teradata FastExport fastexp YES NO YES NO YES NO Teradata FastLoad fastld YES NO YES NO YES NO Teradata Generic Security Services TeraGSS_aixpower and TeraGSS_aixpower32 YES YES YES YES YES YES Teradata Generic Security Services Java YES YES YES YES YES YES Teradata MultiLoad mload YES NO YES NO YES NO Teradata Parallel Transporter API papic000 YES YES YES YES YES YES Teradata Parallel Transporter Data Connector Operator pdtcc000 YES NO YES NO YES NO Teradata Parallel Transporter DDL Operator pddlc000 YES NO YES NO YES NO Teradata Parallel Transporter Export Operator pexpc000 YES YES YES YES YES YES Teradata Parallel Transporter FastExport OUTMOD Adapter Operator Teradata Parallel Transporter FastLoad INMOD Adapter Operator Loaded as part of Teradata Parallel Transporter Infrastructure Loaded as part of Teradata Parallel Transporter Teradata Parallel Transporter Infrastructure YES NO YES NO YES NO YES NO YES NO YES NO Teradata Parallel Transporter ICU Library picuc000 YES YES YES YES YES YES Teradata Parallel Transporter Infrastructure tbldc000 YES NO YES NO YES NO Teradata Parallel Transporter Load Operator plodc000 YES YES YES YES YES YES Teradata Tools and Utilities Installation Guide for UNIX and Linux 83

84 Chapter 4: Installing on IBM AIX Client Systems Removing Previous Versions of Software Table 24: IBM AIX Packages and Operating Systems (continued) Product Package Names IBM AIX 5.1 running on 32-bit and 64-bit IBM Power PC (32-bit Teradata Tools and Utilities) IBM AIX 5.1 running on IBM Power PC (64-bit Teradata Tools and Utilities) IBM AIX 5.2 running on 32-bit and 64-bit IBM Power PC (32-bit Teradata Tools and Utilities) IBM AIX 5.2 running on IBM Power PC (64-bit Teradata Tools and Utilities) IBM AIX 5.3 running on 32-bit and 64-bit IBM Power PC (32-bit Teradata Tools and Utilities) IBM AIX 5.3 running on IBM Power PC (64-bit Teradata Tools and Utilities) Teradata Parallel Transporter MultiLoad INMOD Adapter Operator Loaded as part of Teradata Parallel Transporter Infrastructure YES NO YES NO YES NO Teradata Parallel Transporter ODBC Operator podbcc000 YES NO YES NO YES NO Teradata Parallel Transporter Operator Support Library Teradata Parallel Transporter OS Command Operator Teradata Parallel Transporter SQL Inserter Operator Teradata Parallel Transporter SQL Selector Operator poslc000 YES YES YES YES YES YES poscc000 YES NO YES NO YES NO pinsc000 YES NO YES NO YES NO pselc000 YES NO YES NO YES NO Teradata Parallel Transporter Stream Operator pstmc000 YES YES YES YES YES YES Teradata Parallel Transporter Update Operator pupdc000 YES YES YES YES YES YES Teradata TPump tpump YES NO YES NO YES NO WebSphere MQ Access Module mqaxsmod YES NO YES NO YES NO Note: The Teradata Access Module for JMS, version is available for IBM AIX from the Teradata Download Center. Removing Previous Versions of Software Prior to the installation process, check for any existing software and remove it by performing the following: Note: An exception is the Teradata Parallel Transporter software. Teradata Parallel Transporter does not have to be uninstalled. 84 Teradata Tools and Utilities Installation Guide for UNIX and Linux

85 Chapter 4: Installing on IBM AIX Client Systems Removing Previous Versions of Software Note: An exception is the Teradata Generic Security Services software, it does not have to be uninstalled. Procedure - Removing Previous Versions of Teradata Tools and Utilities Software Follow these steps to remove previous versions of Teradata Tools and Utilities software. 1 Log on as root and enter your password. 2 List the installed packages by entering the following at the command prompt: /usr/bin/lslpp -l Note: To check an individual package, use one of the following commands: lslpp -l <clientpkgname>.<clientpkgname> or lslpp -l <clientpkgname> where clientpkgname is the name of the client package to be uninstalled. Fore example: A screen display similar to the following example (for listing of the BTEQ package) appears. root@stationb: [/] > /usr/bin/lslpp -l bteq.bteq Fileset Level State Description Path: /usr/lib/objrepos bteq.bteq COMMITTED Teradata BTEQ Application ( ) for IBM-AIX 5.1/5.2 Path: /etc/objrepos bteq.bteq Application IBM-AIX Note: For TeraGSS packages, the command is: COMMITTED Teradata BTEQ ( ) for 5.1/5.2 lslpp -l <clientpkgname>.<clientpkgname>_<version> For example: to list the installed versions of TeraGSS_aix-power, you would use the following command: lslpp -l TeraGSS_aix-power.* 3 To remove a package, type: /usr/sbin/installp -u <clientpkgname> where clientpkgname is the name of the client package to be uninstalled. A screen display similar to the following example (for removal of the CLIv2 package) appears. root@stationb: [/] > installp -u cliv Pre-deinstall Verification Teradata Tools and Utilities Installation Guide for UNIX and Linux 85

86 Chapter 4: Installing on IBM AIX Client Systems Software Name Truncation Verifying selections...done Verifying requisites...done Results... SUCCESSES Filesets listed in this section passed pre-deinstall verification and will be removed. Selected Filesets cliv2.cliv # TTU8.2 Teradata CLIV2 packag... << End of Success Section >> FILESET STATISTICS Selected to be deinstalled, of which: 1 Passed pre-deinstall verification Total to be deinstalled Deinstalling Software installp: DEINSTALLING software for: cliv2.cliv Removing CLI environment variables from /etc/profile Finished processing all filesets. (Total time: 5 secs) Summaries: Installation Summary Name Level Part Event Result cliv2.cliv ROOT DEINSTALL SUCCESS cliv2.cliv USR DEINSTALL SUCCESS Software Name Truncation During the installation, software names may become truncated. For example, the Teradata Parallel Transporter Update Operator: Selected Filesets pupdc #Teradata Parallel Transporter U... To find the complete software name, enter the following at the command prompt: lslpp -l <clientpkgname>.<clientpkgname> or lslpp -l <clientpkgname> Here is an example of the Teradata Parallel Transporter Update Operator: # lslpp -l pupdc000 Fileset Level State Description Path: /usr/lib/objrepos 86 Teradata Tools and Utilities Installation Guide for UNIX and Linux

87 Chapter 4: Installing on IBM AIX Client Systems Teradata Parallel Transporter Default and Alternate Directory pupdc COMMITTED Teradata Parallel Transporter Update Operator Version Teradata Parallel Transporter Default and Alternate Directory Teradata Parallel Transporter allows user-specified installation directory. The default installation directory for Teradata Parallel Transporter is /usr/tbuild/<version>. <version> is the version number for Teradata Parallel Transporter. For example, the default installation directory for Teradata Parallel Transporter version is: /usr/tbuild/ The following are the restrictions on the installation directory for Teradata Parallel Transporter: The installation directory cannot be a relative directory path. The pipe character cannot be in the name of the installation directory. The double quote character cannot be in the name of the installation directory. The equal character = cannot be in the name of the installation directory. The whitespace character cannot be in the name of the installation directory. The first Teradata Parallel Transporter package will ask for the installation directory. Subsequent Teradata Parallel Transporter packages of the same version will not ask for the installation directory, but will use the same installation directory as the first one. The installation of a Teradata Parallel Transporter emergency fix (efix) package will overwrite the installed Teradata Parallel Transporter package. For example, the installation of Teradata Parallel Transporter Infrastructure will overwrite the Teradata Parallel Transporter Infrastructure package. Installing Teradata Tools and Utilities See Table 24 on page 82 for a list of the Teradata Tools and Utilities that can be installed on an IBM AIX client. Procedure - Installing Teradata Tools and Utilities on an IBM AIX Client Follow these steps to install Teradata Tools and Utilities on an IBM AIX client. 1 Log on to your UNIX client system as root user. 2 If a /mnt directory does not exist, create one by typing: # mkdir /mnt 3 Insert the CD into the CD-ROM drive and type: Teradata Tools and Utilities Installation Guide for UNIX and Linux 87

88 Chapter 4: Installing on IBM AIX Client Systems Installing Teradata Tools and Utilities # mount -V cdrfs -o ro /dev/<cd-rom device> /mnt For example, if cd0 is the device name, the entry would be: # mount -V cdrfs -o ro /dev/cd0 /mnt In this example, the CD-ROM mount point is /mnt, but an alternate may be entered. 4 To begin the installation process, type: # cd /mnt #./setup.bat A screen display similar to the following appears. The example is for the Load/Unload CD: Welcome to the Teradata Tools and Utilities installation Copyright NCR Corporation. All Rights Reserved. Media: Load/Unload Platform: AIX Which software do you want to install? 1. TeraGSS - Teradata GSS client package 2. tdicu - Teradata Shared Component for Internationalization 3. tdodbc - Teradata ODBC Driver 4. cliv2 - Teradata CLIv2 5. piom - Teradata Data Connector API 6. npaxsmod - Teradata Named Pipes Access Module 7. mqaxsmod - WebSphere(r) Access Module for Teradata 8. bteq - Teradata BTEQ Application 9. fastexp - Teradata FastExport Utility 10. fastld - Teradata FastLoad Utility 11. mload - Teradata MultiLoad Utility 12. tpump - Teradata TPump Utility a. Install all of the above software q. Quit the installation Enter one or more selection (separated by space): Note: Teradata Parallel Transporter packages are contained on Load/Unload CD #2. 5 Software must be installed in the order shown in Software Requirements on page 30. After reviewing product dependencies, enter your selection at the prompt: one or more numbers for the product(s) you want to install, separated by spaces, or a to install all the software, or q to quit the installation 6 After all installations are complete, change back to the root directory and unmount the CD by typing the following at the command prompt: # umount /mnt 7 Remove the installation CD from the CD-ROM drive. 88 Teradata Tools and Utilities Installation Guide for UNIX and Linux

89 Chapter 4: Installing on IBM AIX Client Systems Installing the Teradata Driver for the JDBC Interface Installing the Teradata Driver for the JDBC Interface The Teradata Driver for the JDBC Interface can 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. 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 Teradata Access Module for JMS The Teradata Access Module for JMS version is available on the following CDs: Load/Unload CD #2 for HP-UX Load/Unload CD #3 for Sun Solaris SPARC The Teradata Access Module for JMS version for IBM AIX and Linux is being released asynchronously to Teradata Tools and Utilities IBM AIX and Linux versions of the Teradata Access Module for Teradata can be downloaded from the Teradata Download Center at: --> Support Services --> Downloads --> Drivers, UDFs, and Toolbox --> Teradata Toolbox --> JMS Access Module Installing Teradata Parallel Transporter The installation of a new version of Teradata Parallel Transporter will prompt for the Teradata Parallel Transporter installation directory. Here is a sample of the prompt: Please specify the install directory [default:/usr/tbuild/ ]: If you respond by pressing the Enter key, the default installation directory will be used. Note: It is not recommended to use / or /usr as the installation directory. Here are the restrictions on the installation directory for Teradata Parallel Transporter: Teradata Tools and Utilities Installation Guide for UNIX and Linux 89

90 Chapter 4: Installing on IBM AIX Client Systems Installing Teradata Parallel Transporter The installation directory cannot be a relative directory path. The pipe character cannot be in the name of the installation directory. The double quote character cannot be in the name of the installation directory. The equal character = cannot be in the name of the installation directory. The whitespace character cannot be in the name of the installation directory. In addition to the Teradata Parallel Transporter installation directory, the Teradata Parallel Transporter Infrastructure package will prompt for the Teradata Parallel Transporter logs directory. The following is an example of the prompt: The logs directory contains Teradata Parallel Transporter job log files. The logs directory should be in a partition with a large free space. Please specify the logs directory [ default: /usr/tbuild/ / logs ]: If you respond by just pressing the Enter key, the default logs directory will be used. The following are the restrictions on the logs directory for Teradata Parallel Transporter: The logs directory cannot be a relative directory path. The whitespace character cannot be in the name of the logs directory. The Teradata Parallel Transporter package will prompt for the interprocess communication (IPC) memory choice. The following is an example of the prompt: Teradata Parallel Transporter Infrastructure uses shared memory or memory mapped file for interprocess communication (IPC). Shared memory utilizes system shared memory for IPC. Memory mapped file utilizes temporary disk storage for IPC. Please select the IPC memory mechanism [ default: shared memory ]: Enter 1 for shared memory Enter 2 for memory mapped file If you respond by pressing the Enter key or 1, the IPC memory choice will be shared memory. If you respond by pressing 2, the IPC memory choice will be memory mapped file and the Teradata Parallel Transporter package will prompt for the memory mapped file directory. The following is an example of the prompt: The memory mapped file directory contains temporary Teradata Parallel Transporter job files. The memory mapped file directory should be in a partition with a large free space. Please specify the memory mapped file directory [ default: /usr/tbuild/ /mmap ]: If you respond by pressing the Enter key, the default memory mapped file directory will be used. 90 Teradata Tools and Utilities Installation Guide for UNIX and Linux

91 Chapter 4: Installing on IBM AIX Client Systems Installing Teradata Parallel Transporter The following are the restrictions on the memory mapped file directory for Teradata Parallel Transporter: The memory mapped file directory cannot be a relative directory path The whitespace character cannot be in the name of the memory mapped file directory. Note: During the reinstall of the same Teradata Parallel Infrastructure version, the Teradata Parallel Infrastructure reinstall will not ask for the IPC memory choice. The reinstall will reuse the existing IPC memory choice. Note: The first Teradata Parallel Transporter package will ask for the installation directory. Subsequent Teradata Parallel Transporter packages of the same version will not ask for the installation directory, but will use the same installation directory as the first one. At the end of the Teradata Parallel Transporter Infrastructure installation, the Teradata Parallel Transporter Infrastructure installation will update the following environment variables in the system /etc/profile and /etc/csh.login files: Table 25: Environment Variables Updated Environment Variable TWB_ROOT PATH LIBPATH NLSPATH Update to Environment Variable Set to the Teradata Parallel Transporter installation directory. Add $TWB_ROOT/bin to the front of the PATH environment variable. Add $TWB_ROOT/lib to the front of the LIBPATH environment variable. Add $TWB_ROOT/msg/%N to the front of the NLSPATH environment variable. The updates to the environment variables are effective in the next login only if the Teradata Parallel Transporter Infrastructure package is installed. The updates to the environment variables allow users to run the installed version of Teradata Parallel Transporter. If the Teradata Parallel Transporter API package is installed, then the LIBPATH and NLSPATH environment variables must be updated manually. The 32-bit files are in $TWB_ROOT/lib and $TWB_ROOT/msg. The 64-bit files are in $TWB_ROOT/lib64 and $TWB_ROOT/msg64. The environment variables can be updated on the command line, in the user's profile, or in the system profile. If the environment variables are updated on the command line, then the updates are effective only for the current session. If the environment variables are updated in the user's profile, then the updates are only effective every time that particular user logs in. If the environment variables are updated in the system profile, then the updates are effective every time any user logs in. Teradata Tools and Utilities Installation Guide for UNIX and Linux 91

92 Chapter 4: Installing on IBM AIX Client Systems Adding CLI User Exit Functions Note: Users must use the updates to the environment variables in order to run the installed version of Teradata Parallel Transporter properly. Note: If users do not use the updates to the environment variables, then they will not be able to run the installed version of Teradata Parallel Transporter properly. Adding CLI User Exit Functions CLI User Exit functions are general purpose facilities that may be added to the CLI workstation architecture on IBM AIX systems. These functions allow user-defined processing to take place. Procedure - Adding CLI User Exit Functions to an IBM AIX Client Follow these steps to add CLI User Exit functions to an IBM AIX client. 1 Change directories to /opt/teradata/client/sample, using the following command: # cd /opt/teradata/client/sample 2 Modify the CliLgnEx.c or CliPPS.c file in the sample directory. 3 Compile and link using either the 32-bit or 64-bit version of the makefile to create a new shared object, libtdusr.so. This command compiles the 32-bit version: # make -f maketdusr.aix 4 Move the libtdusr.so file into the /usr/lib directory for 32-bit applications, or into the /usr/ lib/lib_64 directory for 64-bit applications. The CLIv2 libcliv2 should also exist in the same directory. For more information on CLI User Exit Functions, see Teradata Call-Level Interface Version 2 Reference for Network-Attached Systems, Appendix D. 92 Teradata Tools and Utilities Installation Guide for UNIX and Linux

93 CHAPTER 5 Installing on HP-UX Client Systems This chapter provides the procedures for installing and uninstalling the Teradata Tools and Utilities software on HP-UX client systems. This chapter has the following sections: Installing Individual Products Uninstalling Previous Versions of Software Installing the Teradata Tools and Utilities Installing the Teradata Driver for the JDBC Interface Installing Teradata Parallel Transporter Adding CLI User Exit Functions Installing Individual Products Installation CD-ROMs This section describes how to install Teradata Tools and Utilities on an HP-UX operating system. The specific operating systems include: HP-UX 11.11iv1 (11.11) running on 32-bit and 64-bit Hewlett-Packard PA-Risc (32-bit Teradata Tools and Utilities) HP-UX 11.11iv1 (11.11) running on Hewlett-Packard PA-Risc (64-bit Teradata Tools and Utilities) HP-UX 11.11iv2 (11.23)running on Intel Itanium (Itanium build) (64-bit Teradata Tools and Utilities) HP-UX 11.11iv2 (11.23) running on Intel Itanium (PA-RISC build) (64-bit Teradata Tools and Utilities) HP-UX 11.11iv3 (11.31)running on Intel Itanium (PA-RISC build) (64-bit Teradata Tools and Utilities) HP-UX 11.11iv3 (11.31) running on Intel Itanium (Itanium build) (64-bit Teradata Tools and Utilities) Install Teradata Tools and Utilities products using setup.bat from one of the following CDs: 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 Teradata Tools and Utilities Installation Guide for UNIX and Linux 93

94 Chapter 5: Installing on HP-UX Client Systems Installing Individual Products HP-UX Packages 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 The following table shows the HP-UX package names and the packages included with this release. Version numbers are contained in the Teradata Tools and Utilities Release Definition, Release Table 26: HP-UX Packages and Operating Systems Product Package Names HP-UX 11.11iv1 (11.11) running on Hewlett-Packard PA-Risc (32-bit Teradata Tools and Utilities) HP-UX 11.11iv1 (11.11) running on Hewlett-Packard PA-Risc (64-bit Teradata Tools and Utilities)) HP-UX 11.11iv2 (11.23) running on Intel Itanium (Itanium build) (64-bit Teradata Tools and Utilities)) HP-UX 11.11iv2 (11.23) running on Intel Itanium (PA-RISC build) (64-bit Teradata Tools and Utilities) HP-UX 11.11iv3 (11.31) running on Intel Itanium (ltanium build) (64-bit Teradata Tools and Utilities) Basic Teradata Query (BTEQ) bteq YES NO YES NO YES Named Pipes Access Module npaxsmod YES NO YES NO YES ODBC Driver for Teradata tdodbc YES NO YES NO YES Shared Common Components for Internationalization for Teradata tdicu YES YES YES YES YES Teradata Access Module for JMS jmsaxsmod YES NO NO NO NO Teradata C Preprocessor2 sqlpp YES YES YES YES YES Teradata Call-Level Interface version 2 (CLIv2) cliv2 YES YES YES YES YES Teradata COBOL Preprocessor2 cobpp YES NO NO NO NO 94 Teradata Tools and Utilities Installation Guide for UNIX and Linux

95 Chapter 5: Installing on HP-UX Client Systems Installing Individual Products Table 26: HP-UX Packages and Operating Systems (continued) Product Package Names HP-UX 11.11iv1 (11.11) running on Hewlett-Packard PA-Risc (32-bit Teradata Tools and Utilities) HP-UX 11.11iv1 (11.11) running on Hewlett-Packard PA-Risc (64-bit Teradata Tools and Utilities)) HP-UX 11.11iv2 (11.23) running on Intel Itanium (Itanium build) (64-bit Teradata Tools and Utilities)) HP-UX 11.11iv2 (11.23) running on Intel Itanium (PA-RISC build) (64-bit Teradata Tools and Utilities) HP-UX 11.11iv3 (11.31) running on Intel Itanium (ltanium build) (64-bit Teradata Tools and Utilities) Teradata Data Connector (also known as PIOM) piom YES NO YES NO YES Teradata Driver for the JDBC Interface terajdbc4.jar YES YES YES YES YES Teradata FastExport fastexp YES NO YES NO YES Teradata FastLoad fastld YES NO YES NO YES Teradata Generic Security Services TeraGSS_hpuxpa32 TeraGSS_hpux-pa TeraGSS_hpuxia64 YES YES YES YES YES Teradata Generic Security Services JAVA YES YES YES YES YES Teradata MultiLoad mload YES NO YES NO YES Teradata Parallel Transporter API papic000 YES YES YES YES YES Teradata Parallel Transporter Data Connector Operator Teradata Parallel Transporter DDL Operator Teradata Parallel Transporter Export Operator pdtcc000 YES NO NO NO NO pddlc000 YES NO NO NO NO pexpc000 YES YES YES YES YES Teradata Parallel Transporter FastExport OUTMOD Adapter Operator Teradata Parallel Transporter FastLoad INMOD Adapter Operator Loaded as part of Teradata Parallel Transporter Infrastructure Loaded as part of Teradata Parallel Transporter Infrastructure YES NO NO NO NO YES NO NO NO NO Teradata Parallel Transporter ICU Library picuc000 YES YES YES YES YES Teradata Tools and Utilities Installation Guide for UNIX and Linux 95

96 Chapter 5: Installing on HP-UX Client Systems Uninstalling Previous Versions of Software Table 26: HP-UX Packages and Operating Systems (continued) Product Package Names HP-UX 11.11iv1 (11.11) running on Hewlett-Packard PA-Risc (32-bit Teradata Tools and Utilities) HP-UX 11.11iv1 (11.11) running on Hewlett-Packard PA-Risc (64-bit Teradata Tools and Utilities)) HP-UX 11.11iv2 (11.23) running on Intel Itanium (Itanium build) (64-bit Teradata Tools and Utilities)) HP-UX 11.11iv2 (11.23) running on Intel Itanium (PA-RISC build) (64-bit Teradata Tools and Utilities) HP-UX 11.11iv3 (11.31) running on Intel Itanium (ltanium build) (64-bit Teradata Tools and Utilities) Teradata Parallel Transporter Infrastructure Teradata Parallel Transporter Load Operator tbldc000 YES NO NO NO NO plodc000 YES YES YES YES YES Teradata Parallel Transporter MultiLoad INMOD Adapter Operator Loaded as part of Teradata Parallel Transporter Infrastructure YES NO NO NO NO 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 Teradata Parallel Transporter Stream Operator Teradata Parallel Transporter Update Operator podbcc000 YES NO NO NO NO poslc000 YES YES YES YES YES poscc000 YES NO NO NO NO pinsc000 YES NO NO NO NO pselc000 YES NO NO NO NO pstmc000 YES YES YES YES YES pupdc000 YES YES YES YES YES Teradata TPump tpump YES NO YES NO YES WebSphere MQ Access Module mqaxsmod YES NO NO NO NO Uninstalling Previous Versions of Software Prior to the installing new versions of the Teradata Tools and Utilities, previous versions should be uninstalled. 96 Teradata Tools and Utilities Installation Guide for UNIX and Linux

97 Chapter 5: Installing on HP-UX Client Systems Uninstalling Previous Versions of Software Note: If a previous version of cliv2 is installed, it must be uninstalled before installing the newer version. Note: An exception is the Teradata Generic Security Services software, it does not have to be uninstalled. Note: Teradata Parallel Transporter is an exception, and does not have to be uninstalled. Although, it can be uninstalled using the following procedure. Procedure - Uninstalling Previous Versions of Teradata Tools and Utilities Software Follow these steps to for any existing Teradata Tools and Utilities software and remove it. 1 Log on as root and enter the password. 2 List the installed packages by entering the following command at the prompt: /usr/sbin/swlist You can check to see if an individual package is installed using the command: /usr/sbin/swlist <PkgName> 3 Remove the package by entering: /usr/sbin/swremove <PkgName> Note: The utilities packages are removed by repeating the above command for the packages being removed. The packages can be removed in any order, except for the for the following dependency packages: Data Connector API (piom) or CLIv2. These packages should be removed last, in the following order: Data Connector API (piom), then CLIv2. If the CLIv2 package is uninstalled, without uninstalling dependent packages use swremove with the following options: swremove -x enforce_dependencies=false <CLI package name> Uninstalling at the Terminal Interface Window Optionally, the Terminal Interface Window can be used to remove the software from the system. Procedure - Uninstalling Teradata Tools and Utilities Software Using the Terminal Interface Window Follow these steps to uninstall Teradata Tools and Utilities software using the Terminal Interface Window. 1 Log on as root and enter the password. 2 List the installed packages by entering the following at the command prompt: /usr/sbin/swlist <PkgName> 3 Activate the SD Remove interface window by entering the following at the command prompt: /usr/sbin/swremove Teradata Tools and Utilities Installation Guide for UNIX and Linux 97

98 Chapter 5: Installing on HP-UX Client Systems Uninstalling Previous Versions of Software 4 Select the product packages for removal by performing the following: a b c In the SD Remove window, use the Tab and Arrow keys to move the highlight bar to the name of the package that is to be removed. Press the Space Bar to select the package. In the upper menu bar, Tab across to Actions. d Using the Arrow key, move down to Mark For Remove and press the Space Bar. A Yes appears under the Marked? column in front of the product name indicating it has been designated for removal. 5 Repeat Step 4 for each product being removed. 6 Remove the selected product packages by performing the following: a b In the upper menu bar, Tab to Actions and press the Space Bar. In the Actions menu, begin the removal process by pressing R. Or, alternatively, using the Arrow key, move down to Remove (analysis)... and press the Space Bar. 98 Teradata Tools and Utilities Installation Guide for UNIX and Linux

99 Chapter 5: Installing on HP-UX Client Systems Uninstalling Previous Versions of Software After an analysis of your system is successfully completed, Ready will appear in the Status line of the Remove Analysis window. 7 If the removal setup is correct, highlight OK and press Enter. Otherwise, return to the previous menu by pressing Tab to highlight the word Cancel, and press the Space Bar. 8 In the confirmation display that appears, confirm the removal by highlighting Yes and pressing the Space Bar. Otherwise, Tab to the word No and press the Space Bar. 9 Complete the removal process by highlighting Done and pressing the Space Bar. When the Remove window reappears, the updated list of the installed packages is shown. 10 Exit the process by performing the following: a b In the upper menu bar, highlight File and press the Space Bar. In the File menu, press E. Or, highlight Exit and press the Space Bar. Teradata Tools and Utilities Installation Guide for UNIX and Linux 99

100 Chapter 5: Installing on HP-UX Client Systems Installing the Teradata Tools and Utilities Teradata Parallel Transporter Default and Alternate Directory Teradata Parallel Transporter allows user-specified installation directory. The default installation directory for Teradata Parallel Transporter is: /usr/tbuild/<version> <version> is the version number for Teradata Parallel Transporter. For example, the default installation directory for Teradata Parallel Transporter version is: /usr/tbuild/ The following are the restrictions on the installation directory for Teradata Parallel Transporter: The installation directory cannot be a relative directory path. The pipe character cannot be in the name of the installation directory. The double quote character cannot be in the name of the installation directory. The equal character = cannot be in the name of the installation directory. The whitespace character cannot be in the name of the installation directory. The first Teradata Parallel Transporter package will ask for the installation directory. Subsequent Teradata Parallel Transporter packages of the same version will not ask for the installation directory, but will use the same installation directory as the first package. The installation of a Teradata Parallel Transporter emergency fix (efix) package will overwrite the installed Teradata Parallel Transporter package. For example, the installation of Teradata Parallel Transporter Infrastructure will overwrite the Teradata Parallel Transporter Infrastructure package. Installing the Teradata Tools and Utilities The Teradata Tools and Utilities can be installed silently or interactively through the external interface window. These two methods are described below. Note: Teradata Parallel Transporter packages cannot be installed interactively through the external interface window. Teradata Parallel Transporter packages can only be installed using the silent mode. Installing Teradata Tools and Utilities Products Silently Teradata Tools and Utilities products can be installed silently. Note: Teradata Parallel Transporter packages must be installed using this method. Procedure - Installing Teradata Tools and Utilities Products Silently Follow these steps to install the Teradata Tools and Utilities products silently: 100 Teradata Tools and Utilities Installation Guide for UNIX and Linux

101 Chapter 5: Installing on HP-UX Client Systems Installing the Teradata Tools and Utilities 1 Log on to the UNIX client as root user. 2 If a /mnt directory does not exist, create one by entering the following command at the prompt: # mkdir /mnt In the command shown, the CD-ROM mount point is /mnt, but an alternate may be used. 3 Insert the installation CD into the CD-ROM drive, then enter the following at the command prompt: # mount /dev/dsk/<device name> /mnt Example If the CD-ROM device name is c0t1d0, you would type: # mount /dev/dsk/c0t1d0 /mnt In the example, the CD-ROM mount point is /mnt, but an alternate may be entered. Note: To find your CD-ROM device, enter the following at the command prompt: ioscan -fnc disk 4 To begin the installation process, type: # cd /mnt #./setup.bat A screen display similar to the following appears. The example is for the Load/Unload CD: Welcome to the Teradata Tools and Utilities 12.0 installation Copyright NCR Corporation. All Rights Reserved. Media: Load/Unload Platform: HP-UX Which software do you want to install? 1. TeraGSS - Teradata GSS client package 2. tdicu - Teradata Shared Component for Internationalization 3. tdodbc - Teradata ODBC Driver 4. cliv2 - Teradata CLIv2 5. piom - Teradata Data Connector API 6. npaxsmod - Teradata Named Pipes Access Module 7. mqaxsmod - WebSphere(r) Access Module for Teradata 8. bteq - Teradata BTEQ Application 9. fastexp - Teradata FastExport Utility 10. fastld - Teradata FastLoad Utility 11. mload - Teradata MultiLoad Utility 12. tpump - Teradata TPump Utility a. Install all of the above software q. Quit the installation Enter one or more selection (separated by space): Note: Teradata Parallel Transporter packages are contained on Load/Unload CD #2. 5 Software must be installed in the order shown in Product Dependencies on page 30. After reviewing product dependencies, enter your selection at the prompt: one or more numbers for the product(s) you want to install, separated by spaces, or a to install all the software, or q to quit the installation 6 Change back to the root directory and unmount the CD by typing: Teradata Tools and Utilities Installation Guide for UNIX and Linux 101

102 Chapter 5: Installing on HP-UX Client Systems Installing the Teradata Tools and Utilities # umount /mnt 7 Remove the installation CD from the CD-ROM drive. Installing Teradata Tools and Utilities Products Interactively Teradata Tools and Utilities products can be installed interactively. Note: Teradata Parallel Transporter packages cannot be installed interactively through the external interface window. Teradata Parallel Transporter packages can only be installed using the silent mode. Procedure - Installing Teradata Tools and Utilities Products Interactively Use the following procedure to install the Teradata Tools and Utilities interactively: 1 Log on to the UNIX client as root. 2 If a /mnt directory does not exist, create one by entering the following command at the prompt: # mkdir /mnt In the command shown, the CD-ROM mount point is /mnt, but an alternate may be used. 3 Insert the installation CD into the CD-ROM drive, and then enter the following at the command prompt: Example: # mount /dev/dsk/<device name> /mnt Note: If the CD-ROM device name is c0t1d0, you would type: # mount /dev/dsk/c0t1d0 /mnt In the example, the CD-ROM mount point is /mnt, but an alternate may be entered. Note: To find your CD-ROM device, enter the following at the command prompt: ioscan -fnc disk 4 Register the CD-ROM containing the installation software as the depot by entering the following at the command prompt: # /usr/sbin/swreg -l depot /mnt/hp-ux/<package dirname> Note: For the command above, the term -l uses the lower case letter L. 5 Install the utilities using the terminal interface window by entering the following at the command prompt: swinstall In the swinstall help screen, you may see a prompt to Press Return. Press Enter. 6 Go to the Source Depot and select the product in the Source Depot Path. 102 Teradata Tools and Utilities Installation Guide for UNIX and Linux

103 Chapter 5: Installing on HP-UX Client Systems Installing the Teradata Tools and Utilities 7 In the Install screen of the terminal interface window, perform the following: a b In the Bundles and Products list, highlight the product to be installed. In the upper menu bar, use the Tab key to move the cursor to Actions, then press the Space Bar. c In the Actions menu, mark the product for installation by pressing M. 8 Highlight OK, then press Enter. 9 Select the product using the Space Bar. 10 Go to the Actions menu and select Install (Analysis). The Install Analysis window appears. After an analysis of your system is successfully completed, Ready will appear in the Status line. 11 If the installation setup is correct, highlight OK and press Enter. Otherwise, halt the process and return to the previous menu by pressing Tab to highlight the word Cancel, and press the Space Bar. 12 In the confirmation display that appears, confirm the installation by highlighting Yes and pressing the Space Bar. Otherwise, Tab to the word No and press the Space Bar. After confirmation, installation begins. The Install window reappears, similar to the one shown below. The Percent Complete line can be used as a progress monitor and, when the installation has finished, the Status line will show Completed. Teradata Tools and Utilities Installation Guide for UNIX and Linux 103

104 Chapter 5: Installing on HP-UX Client Systems Installing the Teradata Driver for the JDBC Interface You can monitor the progress by selecting the Logfile. 13 After the installation completes, highlight Done and press Enter. When the SD Install window reappears, the updated list of the installed products is shown. 14 Exit the process by performing the following: a In the upper menu bar, highlight File and press the Space Bar. b In the File menu, press E. Or, highlight Exit and press the Space Bar. 15 Verify the package is installed by using the swlist command: # /usr/sbin/swlist <PkgName> 16 Change back to the root directory and unmount the CD by entering the following at the command prompt: # umount /mnt 17 Remove the installation CD from the CD-ROM drive. Installing the Teradata Driver for the JDBC Interface The Teradata Driver for the JDBC Interface can 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. 104 Teradata Tools and Utilities Installation Guide for UNIX and Linux

105 Chapter 5: Installing on HP-UX Client Systems Installing Teradata Parallel Transporter 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 Teradata Parallel Transporter The installation of a new version of Teradata Parallel Transporter will prompt for the Teradata Parallel Transporter installation directory. Here is a sample of the prompt: Please specify the install directory [default:/usr/tbuild/ ]: If you respond by just pressing the Enter key, the default install directory will be used. Note: It is not recommended to use / or /usr as the install directory. Here are the restrictions on the installation directory for Teradata Parallel Transporter: The installation directory cannot be a relative directory path. The pipe character cannot be in the name of the installation directory. The double quote character cannot be in the name of the installation directory. The equal character = cannot be in the name of the installation directory. The whitespace character cannot be in the name of the installation directory. In addition to the Teradata Parallel Transporter installation directory, the Teradata Parallel Transporter Infrastructure package will prompt you for the Teradata Parallel Transporter logs directory. Here is an example of the prompt: The logs directory contains Teradata Parallel Transporter job log files. The logs directory should be in a partition with a large free space. Please specify the logs directory [ default: /usr/tbuild/ / logs ]: If you respond by just pressing the Enter key, the default logs directory will be used. The following are the restrictions on the logs directory for Teradata Parallel Transporter: The logs directory cannot be a relative directory path. The whitespace character cannot be in the name of the logs directory. The Teradata Parallel Transporter package will prompt for the interprocess communication (IPC) memory choice. The following is an example of the prompt: Teradata Parallel Transporter Infrastructure uses shared memory or memory mapped file for interprocess communication (IPC). Shared memory utilizes system shared memory for IPC. Memory mapped file utilizes temporary disk storage for IPC. Please select the IPC memory mechanism [ default: shared memory ]: Enter 1 for shared memory Teradata Tools and Utilities Installation Guide for UNIX and Linux 105

106 Chapter 5: Installing on HP-UX Client Systems Installing Teradata Parallel Transporter Enter 2 for memory mapped file If you respond by pressing the Enter key or 1, the IPC memory choice will be shared memory. If you respond by pressing 2, the IPC memory choice will be memory mapped file and the Teradata Parallel Transporter package will prompt for the memory mapped file directory. The following is an example of the prompt: The memory mapped file directory contains temporary Teradata Parallel Transporter job files. The memory mapped file directory should be in a partition with a largefree space. Please specify the memory mapped file directory [ default: /usr/tbuild/ /mmap ]: If you respond by pressing the Enter key, the default memory mapped file directory will be used. The following are the restrictions on the memory mapped file directory for Teradata Parallel Transporter: The memory mapped file directory cannot be a relative directory path. The whitespace character cannot be in the name of the memory mapped file directory. Note: During the reinstall of the same Teradata Parallel Infrastructure version, the Teradata Parallel Infrastructure reinstall will not ask for the IPC memory choice. The reinstall will reuse the existing IPC memory choice. Note: The first Teradata Parallel Transporter package will ask for the installation directory. Subsequent Teradata Parallel Transporter packages of the same version will not ask for the installation directory, but will use the same installation directory as the first package. The Teradata Parallel Transporter Infrastructure package checks for the following system kernel values: Table 27: Kernel Values Kernel Parameter Required Minimum Value Description semmap 1000 Maximum number of entries in a semaphore map. Note: Only checked on HP-UX 32-bit. semmni 1000 Maximum number of semaphore sets in entire system. semmns 1000 Maximum number of semaphores in entire system. semmnu 2500 Maximum number of processes that can have undo operations pending on semaphores. shmmax Maximum size of a shared memory segment. shmmni 200 Maximum number of shared memory segments in entire system. 106 Teradata Tools and Utilities Installation Guide for UNIX and Linux

107 Chapter 5: Installing on HP-UX Client Systems Installing Teradata Parallel Transporter Table 27: Kernel Values (continued) Kernel Parameter Required Minimum Value Description shmseg 10 Maximum number of shared memory segments per process. Note: The Teradata Parallel Transporter Infrastructure installation does not support formula value. If the kernel value is a formula, then the Teradata Parallel Transporter Infrastructure installation will display a warning message. If the system does not meet the required minimum value, the Teradata Parallel Transporter Infrastructure installation will prompt you to increase the value to the minimum required value. The following is an example of the prompt: Warning: The current value of for the kernel parameter (shmmax) is less than the minimum required value of shmmax refers to the maximum size of a shared memory segment. A kernel rebuild is not required to change the value for the kernel parameter (shmmax). Note: This install recommends increasing the value to the minimum required value. Note: A reboot is not required to make the kernel parameter change(s) effective. Do you want to increase the value to the minimum required value for the above kernel parameter(s)? Please enter y for yes or n for no [y,n,? (default : y)] If you enter n, the Teradata Parallel Transporter Infrastructure package will not change the kernel value. If you enter y, or if you respond by just entering the Enter key, the Teradata Parallel Transporter Infrastructure package will change the kernel value. Note: If there is a change to the kernel value, the following kernel parameter requires a kernel rebuild and a reboot: semmap, semmni, semmns, semmnu, and shmmni. Note: If there is a change to the kernel value, the following kernel parameter does not require a kernel rebuild or a reboot: shmmax and shmseg. At the end of the Teradata Parallel Transporter Infrastructure installation, the Teradata Parallel Transporter Infrastructure installation will update the following environment variables in the system /etc/profile and /etc/csh.login files: Table 28: Environment Variables Updated Environment Variable TWB_ROOT PATH SHLIB_PATH Update to Environment Variable Set to the Teradata Parallel Transporter installation directory. Add $TWB_ROOT/bin to the front of the PATH environment variable. Add $TWB_ROOT/lib to the front of the SHLIB_PATH environment variable. Teradata Tools and Utilities Installation Guide for UNIX and Linux 107

108 Chapter 5: Installing on HP-UX Client Systems Adding CLI User Exit Functions Table 28: Environment Variables Updated (continued) Environment Variable NLSPATH Update to Environment Variable Add $TWB_ROOT/msg/%N to the front of the NLSPATH environment variable. The updates to the environment variables are effective in the next login only if the Teradata Parallel Transporter Infrastructure package is installed. The updates to the environment variables allow users to run the installed version of Teradata Parallel Transporter. If the Teradata Parallel Transporter API package was installed, then the SHLIB_PATH and NLSPATH environment variables must be updated manually. The 32-bit files are in $TWB_ROOT/lib and $TWB_ROOT/msg. The 64-bit files are in $TWB_ROOT/lib64 and $TWB_ROOT/msg64. The environment variables are updated on the command line, in the user's profile, or in the system profile. If the environment variables are updated on the command line, then the updates are effective only for the current session. If the environment variables are updated in the user's profile, then the updates are only effective every time that particular user logs in. If the environment variables are updated in the system profile then the updates will be effective every time any user logs in. Note: Users must use the updates to the environment variables in order to run the installed version of Teradata Parallel Transporter properly. Note: If users do not use the updates to the environment variables, then they will not be able to run the installed version of Teradata Parallel Transporter properly. Adding CLI User Exit Functions CLI User Exit functions are general purpose facilities that may be added to the CLI workstation architecture on HP-UX systems. These functions allow user-defined processing to take place. Procedure - Adding CLI User Exit Functions to an HP-UX Client Follow these steps to add CLI User Exit functions to an HP-UX client. 1 Change directories to /opt/teradata/client/sample, using the following command: # cd /opt/teradata/client/sample 2 Modify the CliLgnEx.c or CliPPS.c file in the sample directory. 3 Compile and link using either the 32-bit or 64-bit version of the makefile to create a new shared object, libtdusr.sl. This command uses the 32-bit version of the make facility: # make -f maketdusr.hpux 108 Teradata Tools and Utilities Installation Guide for UNIX and Linux

109 Chapter 5: Installing on HP-UX Client Systems Adding CLI User Exit Functions Note: The Native compiler on IA64 is not supported. 4 Move the libtdusr.sl file into the /usr/lib directory for 32-bit applications, or into the /usr/ lib/pa20_64 directory for 64-bit applications. For more information on CLI User Exit Functions, see Teradata Call-Level Interface Version 2 Reference for Network-Attached Systems, Appendix D. Teradata Tools and Utilities Installation Guide for UNIX and Linux 109

110 Chapter 5: Installing on HP-UX Client Systems Adding CLI User Exit Functions 110 Teradata Tools and Utilities Installation Guide for UNIX and Linux

111 CHAPTER 6 Installing on Sun Solaris SPARC Client Systems This chapter describes the installation of the Teradata Tools and Utilities software on your Sun Solaris system. The installation topics are: Installing Individual Products Uninstalling Previous Versions of Software Installing Teradata Tools and Utilities Installing the Teradata Driver for the JDBC Interface Installing Teradata Parallel Transporter Adding CLI User Exit Functions Installing Individual Products Installation CD-ROMs This section describes how to install Teradata Tools and Utilities on a Sun Solaris SPARC operating system. The specific operating systems include: Sun Solaris 8 running on 32-bit and 64-bit SPARC (32-bit Teradata Tools and Utilities) Sun Solaris 8 running on SPARC (64-bit Teradata Tools and Utilities) Sun Solaris 9 running on 32-bit and 64-bit SPARC (32-bit Teradata Tools and Utilities) Sun Solaris 9 running on SPARC (64-bit Teradata Tools and Utilities) Sun Solaris 10 running on 32-bit and 64-bit SPARC (32-bit Teradata Tools and Utilities) Sun Solaris 10 running on SPARC (64-bit Teradata Tools and Utilities) Install Teradata Tools and Utilities products using setup.bat from one of the following CDs: 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) Teradata Tools and Utilities Installation Guide for UNIX and Linux 111

112 Chapter 6: Installing on Sun Solaris SPARC Client Systems Installing Individual Products Sun Solaris Packages 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 The following table shows the Sun Solaris Package names and the packages included with this release. Version numbers are contained in the Teradata Tools and Utilities Release Definition, Release The following table shows the products supported by each operating system: Table 29: Sun Solaris Packages and Operating Systems Product Package Names Sun Solaris 8 running on SPARC (32-bit Teradata Tools and Utilities) Sun Solaris 8 running on SPARC (64-bit Teradata Tools and Utilities) Sun Solaris 9 running on 32-bit and 64-bit SPARC (32-bit Teradata Tools and Utilities) Sun Solaris 9 running on SPARC (64-bit Teradata Tools and Utilities) Sun Solaris 10 running on 32-bit and 64-bit SPARC (32-bit Teradata Tools and Utilities) Sun Solaris 10 running on SPARC (64-bit Teradata Tools and Utilities) Basic Teradata Query (BTEQ) bteq YES NO YES NO YES NO Named Pipes Access Module npaxsmod YES NO YES NO YES NO ODBC Driver for Teradata tdodbc and tdodbc64 YES YES YES YES YES YES Shared Common Components for Internationalization for Teradata tdicu YES YES YES YES YES YES Teradata Access Module for JMS jmsaxsmod YES NO YES NO YES NO Teradata C Preprocessor2 sqlpp YES YES YES YES YES YES 112 Teradata Tools and Utilities Installation Guide for UNIX and Linux

113 Chapter 6: Installing on Sun Solaris SPARC Client Systems Installing Individual Products Table 29: Sun Solaris Packages and Operating Systems (continued) Product Package Names Sun Solaris 8 running on SPARC (32-bit Teradata Tools and Utilities) Sun Solaris 8 running on SPARC (64-bit Teradata Tools and Utilities) Sun Solaris 9 running on 32-bit and 64-bit SPARC (32-bit Teradata Tools and Utilities) Sun Solaris 9 running on SPARC (64-bit Teradata Tools and Utilities) Sun Solaris 10 running on 32-bit and 64-bit SPARC (32-bit Teradata Tools and Utilities) Sun Solaris 10 running on SPARC (64-bit Teradata Tools and Utilities) Teradata Call-Level Interface version 2 (CLIv2) cliv2 YES YES YES YES YES YES Teradata Data Connector (also known as PIOM) piom YES NO YES NO YES NO Teradata Driver for the JDBC Interface terajdbc4.jar YES YES YES YES YES YES Teradata FastExport fastexp YES NO YES NO YES NO Teradata FastLoad fastld YES NO YES NO YES NO Teradata Generic Security Services TeraGSS_solaris -sparc32 TeraGSS_solaris -sparc YES YES YES YES YES YES Teradata Generic Security Services Java YES YES YES YES YES YES Teradata MultiLoad mload YES NO YES NO YES NO Teradata Parallel Transporter API papic000 YES YES YES YES YES YES Teradata Parallel Transporter Data Connector Operator pdtcc000 YES NO YES NO YES NO Teradata Parallel Transporter DDL Operator pddlc000 YES NO YES NO YES NO Teradata Parallel Transporter Export Operator pexpc000 YES YES YES YES YES YES Teradata Parallel Transporter FastExport OUTMOD Adapter Operator Loaded as part of Teradata Parallel Transporter Infrastructure YES NO YES NO YES NO Teradata Tools and Utilities Installation Guide for UNIX and Linux 113

114 Chapter 6: Installing on Sun Solaris SPARC Client Systems Installing Individual Products Table 29: Sun Solaris Packages and Operating Systems (continued) Product Package Names Sun Solaris 8 running on SPARC (32-bit Teradata Tools and Utilities) Sun Solaris 8 running on SPARC (64-bit Teradata Tools and Utilities) Sun Solaris 9 running on 32-bit and 64-bit SPARC (32-bit Teradata Tools and Utilities) Sun Solaris 9 running on SPARC (64-bit Teradata Tools and Utilities) Sun Solaris 10 running on 32-bit and 64-bit SPARC (32-bit Teradata Tools and Utilities) Sun Solaris 10 running on SPARC (64-bit Teradata Tools and Utilities) Teradata Parallel Transporter FastLoad INMOD Adapter Operator Loaded as part of Teradata Parallel Transporter Infrastructure YES NO YES NO YES NO Teradata Parallel Transporter ICU Library picuc000 YES YES YES YES YES YES Teradata Parallel Transporter Infrastructure tbldc000 YES NO YES NO YES NO Teradata Parallel Transporter Load Operator plodc000 YES YES YES YES YES YES Teradata Parallel Transporter MultiLoad INMOD Adapter Operator Loaded as part of Teradata Parallel Transporter Infrastructure YES NO YES NO YES NO Teradata Parallel Transporter ODBC Operator podbcc000 YES NO YES NO YES NO Teradata Parallel Transporter Operator Support Library Teradata Parallel Transporter OS Command Operator Teradata Parallel Transporter SQL Inserter Operator Teradata Parallel Transporter SQL Selector Operator poslc000 YES YES YES YES YES YES poscc000 YES NO YES NO YES NO pinsc000 YES NO YES NO YES NO pselc000 YES NO YES NO YES NO Teradata Parallel Transporter Stream Operator pstmc000 YES YES YES YES YES YES Teradata Parallel Transporter Update Operator pupdc000 YES YES YES YES YES YES Teradata TPump tpump YES NO YES NO YES NO 114 Teradata Tools and Utilities Installation Guide for UNIX and Linux

115 Chapter 6: Installing on Sun Solaris SPARC Client Systems Uninstalling Previous Versions of Software Table 29: Sun Solaris Packages and Operating Systems (continued) Product Package Names Sun Solaris 8 running on SPARC (32-bit Teradata Tools and Utilities) Sun Solaris 8 running on SPARC (64-bit Teradata Tools and Utilities) Sun Solaris 9 running on 32-bit and 64-bit SPARC (32-bit Teradata Tools and Utilities) Sun Solaris 9 running on SPARC (64-bit Teradata Tools and Utilities) Sun Solaris 10 running on 32-bit and 64-bit SPARC (32-bit Teradata Tools and Utilities) Sun Solaris 10 running on SPARC (64-bit Teradata Tools and Utilities) WebSphere MQ Access Module mqaxsmod YES NO YES NO YES NO Uninstalling Previous Versions of Software Before beginning the installation process, use the following procedure to check for previous versions of Teradata Tools and Utilities programs: Note: If a previous version of cliv2 is installed, it must be uninstalled before installing the newer version. Note: An exception is the Teradata Generic Security Services software, it does not have to be uninstalled. Note: Teradata Parallel Transporter is an exception, and does not have to be uninstalled. Although, it can be uninstalled using the following procedure. Procedure - Uninstalling Previous Versions of Teradata Tools and Utilities Software Follow these steps to check for any existing software and remove it. 1 To determine if there are any existing software packages installed on the client, enter the following command at the command prompt: # pkginfo -l <name of software> Note: In the above command, -l uses a lowercase L. To check for more than one software package at a time, enter the same command, separated by a space. For example, to search for Basic Teradata Query (BTEQ), Teradata FastExport and Teradata FastLoad enter: # pkginfo bteq fastexp fastload... Teradata Tools and Utilities Installation Guide for UNIX and Linux 115

116 Chapter 6: Installing on Sun Solaris SPARC Client Systems Uninstalling Previous Versions of Software 2 If existing software is found, remove it using the following command at the command prompt: # pkgrm <name of software> To remove more than one software package at a time, enter the same command, separated by a space. For example, to remove Basic Teradata Query (BTEQ), Teradata FastExport and Teradata FastLoad, enter: # pkgrm bteq fastexp fastload... 3 A screen displays messages asking you to confirm the removal of the selected software package. Answer the questions as instructed. Default and Alternate Directories The following are the default directories where the software will be installed: Table 30: Default and Alternative Directories Item ODBC driver files Executable files Library files Includes files Sample files 64-bit Library files 64-bit Executable files Teradata Parallel Transporter Default Directory /opt/teradata/client/odbc /opt/teradata/client/bin /opt/teradata/client/lib /opt/teradata/client/include /opt/teradata/client/sample /opt/teradata/client/lib64 /opt/teradata/client/bin64 /usr/tbuild/<version> where: <version> is the version number for Teradata Parallel Transporter. For example, the default install directory for Teradata Parallel Transporter version is /usr/tbuild/ You may choose an alternate directory; however, you must log on as root. After selecting the packages you want to install, the installation program prompts you to either select the default directory or you may browse your system and select an alternate directory. The first Teradata Parallel Transporter package will ask for the installation directory. Subsequent Teradata Parallel Transporter packages of the same version will not ask you for the installation directory, but will use the same installation directory as the first package. Starting with Teradata Parallel Transporter , an installation of a Teradata Parallel Transporter emergency fix (efix) package will overwrite the installed Teradata Parallel Transporter package. 116 Teradata Tools and Utilities Installation Guide for UNIX and Linux

117 Chapter 6: Installing on Sun Solaris SPARC Client Systems Solaris Zones Screen Navigation For example, the installation of Teradata Parallel Transporter Infrastructure will overwrite the Teradata Parallel Transporter Infrastructure package. To navigate between and within screen elements during the installation and uninstallation process use the following commands: Table 31: Screen Navigation Commands To do the following... Navigate to the product you want to install Install each product Press... the arrow keys either Enter or the space bar Display licenses 1 View product packages Select all Unselect all Continue Exit the screen without installing any products or to abort v a u c q Solaris Zones To support Solaris 10 Zones, the <product> installation packages were changed to allow users to specify where the <product> components will be installed, to remove the limitation of specifying only the <product> install directory. When a <product> is installed, the installation package prompts for the following directory input: 1) Enter installation directory [default: /opt/teradata/client/<product> ]: 2) Enter 32-bit library directory [default: /opt/teradata/client/lib ]: 3)Enter man page directory [default: /usr/share/man ]: Optionally the default values provided can be selected, or another directory location can be selected for each of the three prompts above. Having the ability to specify the <product> install directory, the 32-bit libraries, and the placement of man pages allows complete control over where the <product> components are placed and supports the Solaris zones that have been created on a Solaris system. In the case where an unacceptable directory is erroneously selected, the installation for the <product> issues a warning and prompts for a new directory. For example: Teradata Tools and Utilities Installation Guide for UNIX and Linux 117

118 Chapter 6: Installing on Sun Solaris SPARC Client Systems Installing Teradata Tools and Utilities Enter installation directory [ default: /opt/teradata/client/odbc ]: / usr/odbc ERROR: /usr/odbc does not have write permissions. Please enter a writable directory. Operating under a Solaris zone limits the selection of only those directories that have write permissions in the active zone. Users must have the ability to determine which directories these are. Running within the Global zone is equivalent to a Solaris system that does not have Solaris zones setup. After the <product> has been installed, the directories for the <product> install directory, the 32-bit libraries, and the icu libraries must be included in the LD_LIBRARY_PATH, since the typical symbolic links will no longer be available in the /usr/lib directory when using Solaris zones. For example, the LD_LIBRARY_PATH that includes the ODBC Driver for Teradata would be: LD_LIBRARY_PATH=/opt/teradata/client/odbc/drivers:/opt/teradata/client/ odbc/lib:/opt/teradata/client/lib:/opt/tdicu/lib Installing Teradata Tools and Utilities If you are not installing all the products on the CD, review System Requirements on page 28. Note: Before beginning the installation, remove all previous versions of the software (see Technical Assistance on page 68) Note: An exception is the Teradata Parallel Transporter software. Previous versions of Teradata Parallel Transporter do not have to be removed. Procedure - Installing Teradata Tools and Utilities Products Follow these steps to install Teradata Tools and Utilities on Sun Solaris. 1 Insert the CD in the CD-ROM drive on the server running Sun Solaris. 2 From the console, log on as root or change to root and enter your password. 3 Change your directory to CD-ROM mount point with the following command: # cd /cdrom/cdrom0 Note: If cdrom0 does not exist under the CD-ROM mount point, then, in the cdrom directory, change the directory to: <cd directory> Table 32: CD-ROM Mount Point If you have this CD Teradata Utility Pak Database Management Preprocessors change the directory to cd1a_tera_util_pak cd2_database_mgnt cd3_preprocessors 118 Teradata Tools and Utilities Installation Guide for UNIX and Linux

119 Chapter 6: Installing on Sun Solaris SPARC Client Systems Installing Teradata Tools and Utilities Table 32: CD-ROM Mount Point (continued) If you have this CD Load/Unload Tape Storage Management Enablers change the directory to cd4_load_unload cd5_tape_stor_mgnt_ena 4 Type: #./setup.bat An NCR Teradata Tools and Utilities CD Installation screen similar to the following appears. The following sample screen appears for the Load/Unload CD: NCR Teradata Tools and Utilities CD installation. Use arrow keys to move to the product you want. Press <space> or <enter> to select/de-select a product (l) display licenses (v) view product packages (q) abort (a) to select all (u) to unselect all (c) to continue Available products: ( 1) TeraGSS - Teradata GSS client package ( 2) TeraGSS32 - Teradata GSS client package ( 3) tdicu - Shared common components for Internationalization for Teradata ( 4) npaxsmod - Named Pipes Access Module ( 5) piom - Teradata Data Connector Access Module API ( 6) cliv2 - Teradata CLIV2 Package ( 7) bteq - Teradata BTEQ Application ( 8) tbld Teradata Parallel Transporter Infrastructure ( 9) mqaxsmod - WebSphere (r) Access Module for Teradata (10) tpump - Teradata Parallel Data Pump For UNIX (11) mload - Teradata MultiLoad Utility (12) fastld - Teradata FastLoad Utility (13) fastexp - Teradata FastExport Utility (14) tdodbc - Teradata ODBC Driver * - means product is currently selected for addition/spooling. & - means only some packages in product are selected for addition spooling. Note: Teradata Parallel Transporter packages are contained on Load/Unload CD #2. 5 In this screen, select the packages you would like to install: Table 33: Selecting the Packages to Install To install... all the packages Do the following... Enter a. The number of products you selected will be shown in the bottom right corner of the screen. The packages selected for installation will have an asterisk beside them. Teradata Tools and Utilities Installation Guide for UNIX and Linux 119

120 Chapter 6: Installing on Sun Solaris SPARC Client Systems Installing the Teradata Driver for the JDBC Interface Table 33: Selecting the Packages to Install (continued) To install... selected packages Do the following... Use the arrow keys to go the package(s) you want installed. Then, press the space bar once to select the package. An asterisk indicates the selection. Repeat the previous step if you want to select other packages. Select any dependent modules that are needed, such as CLIv2 or Data Connector API (PIOM), and repeat step 1 if necessary. For information on dependent modules, see Software Requirements on page Enter c to accept the selected packages and continue with the installation. The screen displays installation information for the selected products. Read the information and answer the questions appropriately for your installation. After responding to the prompts, the installation begins. 7 After the installation completes, a screen similar to the following will display indicating how many packages were installed and if any failed. If any failures occur, check the.log file and then call the Teradata Solutions Customer Services Remote Service Center (TSCS-RSC). NCR Teradata Tools and Utilities PACKAGE INSTALLATION (Packages will now be installed onto the system.) Number of packages to process: 12 Number successfully processed: 12 Failures: 0 All packages processed successfully. Please see the logfile [/var/ncr/logs/pkgadd.log] for any specific package instructions. 8 From the root directory, enter the following command and remove the CD from the CD- ROM drive: # umount /cdrom 9 To remove the CD-ROM mount point, enter the following command (this step is optional): # rmdir /cdrom/<mount point> We recommend that you review the log file (/var/ncr/logs/pkgadd.log) for any specific information of any of the packages installed. If a reboot is required, we recommend that you reboot the machine to fully enable the software packages to take effect. Installing the Teradata Driver for the JDBC Interface The Teradata Driver for the JDBC Interface can be downloaded from the Teradata Download Center at: 120 Teradata Tools and Utilities Installation Guide for UNIX and Linux

121 Chapter 6: Installing on Sun Solaris SPARC Client Systems Installing Teradata Parallel Transporter --> 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. 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 Teradata Parallel Transporter The installation of a new version of Teradata Parallel Transporter will prompt for the Teradata Parallel Transporter installation directory. Here is a sample of the prompt: Please specify the install directory [default:/usr/tbuild/ ]: If you respond by pressing the Enter key, the default installation directory will be used. Note: It is not recommended to use / or /usr as the installation directory. Here are the restrictions on the installation directory for Teradata Parallel Transporter: The installation directory cannot be a relative directory path. The pipe character cannot be in the name of the installation directory. The double quote character cannot be in the name of the installation directory. The equal character = cannot be in the name of the installation directory. The whitespace character cannot be in the name of the installation directory. In addition to the Teradata Parallel Transporter installation directory, the Teradata Parallel Transporter Infrastructure package will prompt for the Teradata Parallel Transporter logs directory. The following is an example of the prompt: The logs directory contains Teradata Parallel Transporter job log files. The logs directory should be in a partition with a large free space. Please specify the logs directory [ default: /usr/tbuild/ / logs ]: If you respond by pressing the Enter key, the default logs directory will be used. The following are the restrictions on the logs directory for Teradata Parallel Transporter: The logs directory cannot be a relative directory path. The whitespace character cannot be in the name of the logs directory. The Teradata Parallel Transporter package will prompt for the interprocess communication (IPC) memory choice. Teradata Tools and Utilities Installation Guide for UNIX and Linux 121

122 Chapter 6: Installing on Sun Solaris SPARC Client Systems Installing Teradata Parallel Transporter The following is an example of the prompt: Teradata Parallel Transporter Infrastructure uses shared memory or memory mapped file for interprocess communication (IPC). Shared memory utilizes system shared memory for IPC. Memory mapped file utilizes temporary disk storage for IPC. Please select the IPC memory mechanism [ default: shared memory ]: Enter 1 for shared memory Enter 2 for memory mapped file If you respond by pressing the Enter key or 1, the IPC memory choice will be shared memory. If you respond by pressing 2, the IPC memory choice will be memory mapped file and the Teradata Parallel Transporter package will prompt for the memory mapped file directory. The following is an example of the prompt: The memory mapped file directory contains temporary Teradata Parallel Transporter job files. The memory mapped file directory should be in a partition with a large free space. Please specify the memory mapped file directory [ default: /usr/tbuild/ /mmap ]: If you respond by pressing the Enter key, the default memory mapped file directory will be used. The following are the restrictions on the memory mapped file directory for Teradata Parallel Transporter: The memory mapped file directory cannot be a relative directory path. The whitespace character cannot be in the name of the memory mapped file directory. Note: During the reinstall of the same Teradata Parallel Infrastructure version, the Teradata Parallel Infrastructure reinstall will not ask for the IPC memory choice. The reinstall will reuse the existing IPC memory choice. Note: The first Teradata Parallel Transporter package will ask for the installation directory. Subsequent Teradata Parallel Transporter packages of the same version will not ask for the installation directory, but will use the same installation directory as the first package. The Teradata Parallel Transporter Infrastructure package checks for the following system kernel values: Table 34: Kernel Values Kernel Parameter Required Minimum Value Description SEMMNI 1000 Maximum number of semaphore sets in entire system. SEMMNS 1000 Maximum number of semaphores in entire system. SEMMNU 2500 Maximum number of processes that can have undo operations pending on semaphores. 122 Teradata Tools and Utilities Installation Guide for UNIX and Linux

123 Chapter 6: Installing on Sun Solaris SPARC Client Systems Installing Teradata Parallel Transporter Table 34: Kernel Values (continued) Kernel Parameter Required Minimum Value Description SHMMAX Maximum size of a shared memory segment. SHMMNI 200 Maximum number of shared memory segments in entire system. SHMSEG 10 Maximum number of shared memory segments per process. Note: Checked only on Sun Solaris 8. Note: The Teradata Parallel Transporter Infrastructure installation does not support formula value. If the kernel value is a formula, then the Teradata Parallel Transporter Infrastructure installation will display a warning message. If the system does not meet the required minimum value, the Teradata Parallel Transporter Infrastructure installation will prompt to increase the value to the minimum required value. The following is an example of the prompt: Warning: The current value of for the kernel parameter (SHMMAX) is less than the minimum required value of SHMMAX refers to the maximum size of a shared memory segment. Note: This install recommends increasing the value to the minimum required value. Note: A kernel rebuild is not required to make the kernel parameter change(s) effective. Note: A reboot is required to make the kernel parameter change(s) effective. The reboot can be done after this installation but before running Teradata Parallel Transporter jobs. Do you want to increase the value to the minimum required value for the above kernel parameter(s)? Please enter y for yes or n for no [y,n,? (default : y)] If you enter n, the Teradata Parallel Transporter Infrastructure package will not change the kernel value. If you enter y, or if you respond by pressing the Enter key, the Teradata Parallel Transporter Infrastructure package will change the kernel value. A reboot is required to make the kernel parameter change(s) effective. You must be the root user to reboot the system. The reboot can be done after all the installations but before running a Teradata Parallel Transporter job. The following example reboot command will reboot the system in 60 seconds: # cd; /usr/sbin/shutdown -y -g60 -i6 At the end of the Teradata Parallel Transporter Infrastructure installation, the Teradata Parallel Transporter Infrastructure installation will update the following environment variables in the system /etc/profile and /etc/.login files: Teradata Tools and Utilities Installation Guide for UNIX and Linux 123

124 Chapter 6: Installing on Sun Solaris SPARC Client Systems Adding CLI User Exit Functions Table 35: Environment Variables Updated Environment Variable TWB_ROOT PATH LD_LIBRARY_PATH NLSPATH Update to Environment Variable Set to the Teradata Parallel Transporter installation directory. Add $TWB_ROOT/bin to the front of the PATH environment variable. Add $TWB_ROOT/lib to the front of the LD_LIBRARY_PATH environment variable. Add $TWB_ROOT/msg/%N to the front of the NLSPATH environment variable. The updates to the environment variables are effective in the next login only if the Teradata Parallel Transporter Infrastructure package is installed. The updates to the environment variables allow users to run the installed version of Teradata Parallel Transporter. If the Teradata Parallel Transporter API package is installed, then the LD_LIBRARY_PATH and NLSPATH environment variables must be updated manually. The 32-bit files are in $TWB_ROOT/lib and $TWB_ROOT/msg. The 64-bit files will be in $TWB_ROOT/lib64 and $TWB_ROOT/msg64. The environment variables are updated on the command line, in the user's profile, or in the system profile. If the environment variables are updated on the command line, then the updates are effective only for the current session. If the environment variables are updated in the user's profile, then the updates are only effective every time that particular user logs in. If the environment variables are updated in the system profile, then the updates are effective every time any user logs in. Note: Users must use the updates to the environment variables in order to run the installed version of Teradata Parallel Transporter properly. Note: If users do not use the updates to the environment variables, then they will not be able to run the installed version of Teradata Parallel Transporter properly. Adding CLI User Exit Functions CLI User Exit functions are general purpose facilities that may be added to the CLI workstation architecture on Sun Solaris systems. These functions allow user-defined processing to take place. Procedure - Adding CLI User Exit Functions to a Sun Solaris Client Follow these steps to add CLI User Exit functions to a Sun Solaris client. 124 Teradata Tools and Utilities Installation Guide for UNIX and Linux

125 Chapter 6: Installing on Sun Solaris SPARC Client Systems Adding CLI User Exit Functions 1 Change directories to /opt/teradata/client/sample by typing: # cd /opt/teradata/client/sample 2 Modify the CliLgnEx.c or CliPPS.c file in the sample directory. 3 Compile and link using either the 64-bit version or the 32-bit version of the makefile to create a new shared object, libtdusr.so. The following command compiles the 32-bit version: # make -f makedusr.sols 4 Move the libtdusr.so file into the /usr/lib directory for 32-bit applications, and to /usr/lib/ sparcv9 for 64-bit applications. If the default library directories were utilized during installation. Otherwise, specify the directory where the libcliv2.so library was installed. Refer to Teradata Call-Level Interface Version 2 Reference for Network-Attached Systems, Appendix D. Teradata Tools and Utilities Installation Guide for UNIX and Linux 125

126 Chapter 6: Installing on Sun Solaris SPARC Client Systems Adding CLI User Exit Functions 126 Teradata Tools and Utilities Installation Guide for UNIX and Linux

127 CHAPTER 7 Installing on Sun Solaris Opteron Client Systems This chapter describes the installation of the Teradata Tools and Utilities software on your Sun Solaris Opteron system. The installation topics are: Installing Individual Products Uninstalling Previous Versions of Software Installing Teradata Tools and Utilities Installing the Teradata Driver for the JDBC Interface Installing Teradata Parallel Transporter Adding CLI User Exit Functions Installing Individual Products Installation CD-ROMs This section describes how to install Teradata Tools and Utilities on a Sun Solaris operating system. The specific operating systems include: Sun 64-bit Solaris 10 running on EM64T and AMD Opteron (32-bit Teradata Tools and Utilities) Sun 64-bit Solaris 10 running on EM64T and AMD Opteron (64-bit Teradata Tools and Utilities) Install Teradata Tools and Utilities products using setup.bat from one of the following CDs: 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) Teradata Tools and Utilities Installation Guide for UNIX and Linux 127

128 Chapter 7: Installing on Sun Solaris Opteron Client Systems Installing Individual Products Sun Solaris Packages 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 The following table shows the Sun Solaris Package names and the packages included with this release. Version numbers are contained in the Teradata Tools and Utilities Release Definition, Release The following table shows the products supported by each operating system: Table 36: Sun Solaris Opteron Packages and Operating Systems Product Package Names Sun 64-bit Solaris 10 running on AMD Opteron (32-bit Teradata Tools and Utilities) Sun 64-bit Solaris 10 running on AMD Opteron (64-bit Teradata Tools and Utilities) Basic Teradata Query (BTEQ) bteq YES NO Named Pipes Access Module npaxsmod YES NO ODBC Driver for Teradata tdodbc and tdodbc64 YES YES Shared Common Components for Internationalization for Teradata tdicu YES YES Teradata Access Module for JMS jmsaxsmod NO NO Teradata C Preprocessor2 sqlpp YES YES Teradata Call-Level Interface version 2 (CLIv2) cliv2 YES YES Teradata Data Connector (also known as PIOM) piom YES NO Teradata Driver for the JDBC Interface terajdbc4.jar YES YES 128 Teradata Tools and Utilities Installation Guide for UNIX and Linux

129 Chapter 7: Installing on Sun Solaris Opteron Client Systems Installing Individual Products Table 36: Sun Solaris Opteron Packages and Operating Systems (continued) Product Package Names Sun 64-bit Solaris 10 running on AMD Opteron (32-bit Teradata Tools and Utilities) Sun 64-bit Solaris 10 running on AMD Opteron (64-bit Teradata Tools and Utilities) Teradata FastExport fastexp YES NO Teradata FastLoad fastld YES NO Teradata Generic Security Services TeraGSS_solaris -i386 YES YES TeraGSS_solaris -x8664 Teradata Generic Security Services Java YES YES Teradata MultiLoad mload YES NO Teradata Parallel Transporter API papic000 YES YES Teradata Parallel Transporter Data Connector Operator pdtcc000 NO NO Teradata Parallel Transporter DDL Operator pddlc000 NO NO Teradata Parallel Transporter Export Operator pexpc000 YES YES Teradata Parallel Transporter FastExport OUTMOD Adapter Operator Loaded as part of Teradata Parallel Transporter Infrastructure NO NO Teradata Parallel Transporter FastLoad INMOD Adapter Operator Loaded as part of Teradata Parallel Transporter Infrastructure NO NO Teradata Parallel Transporter ICU Library picuc000 YES YES Teradata Parallel Transporter Infrastructure tbldc000 NO NO Teradata Parallel Transporter Load Operator plodc000 YES YES Teradata Tools and Utilities Installation Guide for UNIX and Linux 129

130 Chapter 7: Installing on Sun Solaris Opteron Client Systems Uninstalling Previous Versions of Software Table 36: Sun Solaris Opteron Packages and Operating Systems (continued) Product Package Names Sun 64-bit Solaris 10 running on AMD Opteron (32-bit Teradata Tools and Utilities) Sun 64-bit Solaris 10 running on AMD Opteron (64-bit Teradata Tools and Utilities) Teradata Parallel Transporter MultiLoad INMOD Adapter Operator Loaded as part of Teradata Parallel Transporter Infrastructure NO NO Teradata Parallel Transporter ODBC Operator podbcc000 NO NO Teradata Parallel Transporter Operator Support Library poslc000 YES YES Teradata Parallel Transporter OS Command Operator poscc000 NO NO Teradata Parallel Transporter SQL Inserter Operator pinsc000 NO NO Teradata Parallel Transporter SQL Selector Operator pselc000 NO NO Teradata Parallel Transporter Stream Operator pstmc000 YES YES Teradata Parallel Transporter Update Operator pupdc000 YES YES Teradata TPump tpump YES NO WebSphere MQ Access Module mqaxsmod YES NO Uninstalling Previous Versions of Software Before beginning the installation process, use the following procedure to check for previous versions of Teradata Tools and Utilities programs: Note: If a previous version of cliv2 is installed, it must be uninstalled before installing the newer version. Note: An exception is the Teradata Generic Security Services software, it does not have to be uninstalled. 130 Teradata Tools and Utilities Installation Guide for UNIX and Linux

131 Chapter 7: Installing on Sun Solaris Opteron Client Systems Uninstalling Previous Versions of Software Note: Teradata Parallel Transporter is an exception, and does not have to be uninstalled. Although, it can be uninstalled using the following procedure. Procedure - Uninstalling Previous Versions of Teradata Tools and Utilities Software Follow these steps to check for any existing software and remove it. 1 To determine if there are any existing software packages installed on the client, enter the following command at the command prompt: # pkginfo -l <name of software> Note: In the above command, -l uses a lowercase L. To check for more than one software package at a time, enter the same command, separated by a space. For example, to search for Basic Teradata Query (BTEQ), Teradata FastExport and Teradata FastLoad enter: # pkginfo bteq fastexp fastload... 2 If existing software is found, remove it using the following command at the command prompt: # pkgrm <name of software> To remove more than one software package at a time, enter the same command, separated by a space. For example, to remove Basic Teradata Query (BTEQ), Teradata FastExport and Teradata FastLoad, enter: # pkgrm bteq fastexp fastload... 3 A screen displays messages asking you to confirm the removal of the selected software package. Answer the questions as instructed. Default and Alternate Directories The following are the default directories where the software will be installed: Table 37: Default and Alternative Directories Item ODBC driver files Executable files Library files Includes files Sample files 64-bit Library files 64-bit Executable files Default Directory /opt/teradata/client/odbc /opt/teradata/client/bin /opt/teradata/client/lib /opt/teradata/client/include /opt/teradata/client/sample /opt/teradata/client/lib64 /opt/teradata/client/bin64 Teradata Tools and Utilities Installation Guide for UNIX and Linux 131

132 Chapter 7: Installing on Sun Solaris Opteron Client Systems Solaris Zones Table 37: Default and Alternative Directories (continued) Item Teradata Parallel Transporter Default Directory /usr/tbuild/<version> where: <version> is the version number for Teradata Parallel Transporter. For example, the default install directory for Teradata Parallel Transporter version is /usr/tbuild/ You may choose an alternate directory; however, you must log on as root. After selecting the packages you want to install, the installation program prompts you to either select the default directory or you may browse your system and select an alternate directory. The first Teradata Parallel Transporter package will ask for the installation directory. Subsequent Teradata Parallel Transporter packages of the same version will not ask you for the installation directory, but will use the same installation directory as the first package. Starting with Teradata Parallel Transporter , an installation of a Teradata Parallel Transporter emergency fix (efix) package will overwrite the installed Teradata Parallel Transporter package. For example, the installation of Teradata Parallel Transporter Infrastructure will overwrite the Teradata Parallel Transporter Infrastructure package. Solaris Zones To support Solaris 10 Zones, the <product> installation packages were changed to allow users to specify where the <product> components will be installed, to remove the limitation of specifying only the <product> install directory. When a <product> is installed, the installation package prompts for the following directory input: 1) Enter installation directory [default: /opt/teradata/client/<product> ]: 2) Enter 32-bit library directory [default: /opt/teradata/client/lib ]: 3)Enter man page directory [default: /usr/share/man ]: Optionally the default values provided can be selected, or another directory location can be selected for each of the three prompts above. Having the ability to specify the <product> install directory, the 32-bit libraries, and the placement of man pages allows complete control over where the <product> components are placed and supports the Solaris zones that have been created on a Solaris system. In the case where an unacceptable directory is erroneously selected, the installation for the <product> issues a warning and prompts for a new directory. For example: 132 Teradata Tools and Utilities Installation Guide for UNIX and Linux

133 Chapter 7: Installing on Sun Solaris Opteron Client Systems Installing Teradata Tools and Utilities Enter installation directory [ default: /opt/teradata/client/odbc ]: / usr/odbc ERROR: /usr/odbc does not have write permissions. Please enter a writable directory. Operating under a Solaris zone limits the selection of only those directories that have write permissions in the active zone. Users must have the ability to determine which directories these are. Running within the Global zone is equivalent to a Solaris system that does not have Solaris zones setup. After the <product> has been installed, the directories for the <product> install directory, the 32-bit libraries, and the icu libraries must be included in the LD_LIBRARY_PATH, since the typical symbolic links will no longer be available in the /usr/lib directory when using Solaris zones. For example, the LD_LIBRARY_PATH that includes the ODBC Driver for Teradata would be: LD_LIBRARY_PATH=/opt/teradata/client/odbc/drivers:/opt/teradata/client/ odbc/lib:/opt/teradata/client/lib:/opt/tdicu/lib Installing Teradata Tools and Utilities If you are not installing all the products on the CD, review System Requirements on page 28. Note: Before beginning the installation, remove all previous versions of the software (see Technical Assistance on page 68) Note: An exception is the Teradata Parallel Transporter software. Previous versions of Teradata Parallel Transporter do not have to be removed. Procedure - Installing Teradata Tools and Utilities Products Follow these steps to install Teradata Tools and Utilities on Sun Solaris. 1 Insert the CD in the CD-ROM drive on the server running Sun Solaris. 2 From the console, log on as root or change to root and enter your password. 3 Change your directory to CD-ROM mount point with the following command: # cd /cdrom/cdrom0 Note: If cdrom0 does not exist under the CD-ROM mount point, then, in the cdrom directory, change the directory to: <cd directory> Table 38: CD-ROM Mount Point If you have this CD Teradata Utility Pak Database Management change the directory to cd1a_tera_util_pak cd2_database_mgnt Teradata Tools and Utilities Installation Guide for UNIX and Linux 133

134 Chapter 7: Installing on Sun Solaris Opteron Client Systems Installing Teradata Tools and Utilities Table 38: CD-ROM Mount Point (continued) If you have this CD Preprocessors Load/Unload Tape Storage Management Enablers change the directory to cd3_preprocessors cd4_load_unload cd5_tape_stor_mgnt_ena 4 Type: #./setup.bat An NCR Teradata Tools and Utilities CD Installation screen similar to the following appears. The following sample screen appears for the Load/Unload CD: Welcome to the Teradata Tools and Utilities 12 installation Copyright NCR Corporation. All Rights Reserved. Platform: Solaris Opteron 64bit Media: Load/Unload - Volume 3 Which software do you want to install? 1. TeraGSS - Teradata GSS client package 2. tdicu - Teradata Shared Component for Internationalization 3. cliv2 - Teradata CLIv2 4. piom - Teradata Data Connector API 5. npaxsmod - Teradata Named Pipes Access Module 6. mqaxsmod - Teradata WebSphere(r) Access Module for Teradata 7. bteq - Teradata BTEQ Application 8. fastexp - Teradata FastExport Utility 9. fastld - Teradata FastLoad Utility 10. mload - Teradata MultiLoad Utility 11. tpump - Teradata TPump Utility a. Install all of the above software q. Quit the installation Enter one or more selections (separated by space): Note: Teradata Parallel Transporter packages are contained on Load/Unload CD #2. 5 In this screen, select the packages you would like to install: Table 39: Selecting the Packages to Install To install... all the packages Do the following... Enter a. The number of products you selected will be shown in the bottom right corner of the screen. The packages selected for installation will have an asterisk beside them. 134 Teradata Tools and Utilities Installation Guide for UNIX and Linux

135 Chapter 7: Installing on Sun Solaris Opteron Client Systems Installing the Teradata Driver for the JDBC Interface Table 39: Selecting the Packages to Install (continued) To install... selected packages Do the following... After reviewing product dependencies, enter your selection at the prompt: one or more numbers for the product(s) you want to install, separated by spaces, or a to install all the software, or q to quit the installation. Repeat the previous step if you want to select other packages. Select any dependent modules that are needed, such as CLIv2 or Data Connector API (PIOM), and repeat step 1 if necessary. For information on dependent modules, see Software Requirements on page From the root directory, enter the following command and remove the CD from the CD- ROM drive: # umount /cdrom 7 To remove the CD-ROM mount point, enter the following command (this step is optional): # rmdir /cdrom/<mount point> We recommend that you review the log file (/var/ncr/logs/pkgadd.log) for any specific information of any of the packages installed. If a reboot is required, we recommend that you reboot the machine to fully enable the software packages to take effect. Installing the Teradata Driver for the JDBC Interface The Teradata Driver for the JDBC Interface can 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. 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. Teradata Tools and Utilities Installation Guide for UNIX and Linux 135

136 Chapter 7: Installing on Sun Solaris Opteron Client Systems Installing Teradata Parallel Transporter Installing Teradata Parallel Transporter The installation of a new version of Teradata Parallel Transporter will prompt for the Teradata Parallel Transporter installation directory. Here is a sample of the prompt: Please specify the install directory [default:/usr/tbuild/ ]: If you respond by pressing the Enter key, the default installation directory will be used. Note: It is not recommended to use / or /usr as the installation directory. Here are the restrictions on the installation directory for Teradata Parallel Transporter: The installation directory cannot be a relative directory path. The pipe character cannot be in the name of the installation directory. The double quote character cannot be in the name of the installation directory. The equal character = cannot be in the name of the installation directory. The whitespace character cannot be in the name of the installation directory. In addition to the Teradata Parallel Transporter installation directory, the Teradata Parallel Transporter Infrastructure package will prompt for the Teradata Parallel Transporter logs directory. The following is an example of the prompt: The logs directory contains Teradata Parallel Transporter job log files. The logs directory should be in a partition with a large free space. Please specify the logs directory [ default: /usr/tbuild/ / logs ]: If you respond by pressing the Enter key, the default logs directory will be used. The following are the restrictions on the logs directory for Teradata Parallel Transporter: The logs directory cannot be a relative directory path. The whitespace character cannot be in the name of the logs directory. The Teradata Parallel Transporter package will prompt for the interprocess communication (IPC) memory choice. The following is an example of the prompt: Teradata Parallel Transporter Infrastructure uses shared memory or memory mapped file for interprocess communication (IPC). Shared memory utilizes system shared memory for IPC. Memory mapped file utilizes temporary disk storage for IPC. Please select the IPC memory mechanism [ default: shared memory ]: Enter 1 for shared memory Enter 2 for memory mapped file If you respond by pressing the Enter key or 1, the IPC memory choice will be shared memory. If you respond by pressing 2, the IPC memory choice will be memory mapped file and the Teradata Parallel Transporter package will prompt for the memory mapped file directory. 136 Teradata Tools and Utilities Installation Guide for UNIX and Linux

137 Chapter 7: Installing on Sun Solaris Opteron Client Systems Installing Teradata Parallel Transporter The following is an example of the prompt: The memory mapped file directory contains temporary Teradata Parallel Transporter job files. The memory mapped file directory should be in a partition with a large free space. Please specify the memory mapped file directory [ default: /usr/tbuild/ /mmap ]: If you respond by pressing the Enter key, the default memory mapped file directory will be used. The following are the restrictions on the memory mapped file directory for Teradata Parallel Transporter: The memory mapped file directory cannot be a relative directory path. The whitespace character cannot be in the name of the memory mapped file directory. Note: During the reinstall of the same Teradata Parallel Infrastructure version, the Teradata Parallel Infrastructure reinstall will not ask for the IPC memory choice. The reinstall will reuse the existing IPC memory choice. Note: The first Teradata Parallel Transporter package will ask for the installation directory. Subsequent Teradata Parallel Transporter packages of the same version will not ask for the installation directory, but will use the same installation directory as the first package. The Teradata Parallel Transporter Infrastructure package checks for the following system kernel values: Table 40: Kernel Values Kernel Parameter Required Minimum Value Description SEMMNI 1000 Maximum number of semaphore sets in entire system. SEMMNS 1000 Maximum number of semaphores in entire system. SEMMNU 2500 Maximum number of processes that can have undo operations pending on semaphores. SHMMAX Maximum size of a shared memory segment. SHMMNI 200 Maximum number of shared memory segments in entire system. SHMSEG 10 Maximum number of shared memory segments per process. Note: Checked only on Sun Solaris 8. Note: The Teradata Parallel Transporter Infrastructure installation does not support formula value. If the kernel value is a formula, then the Teradata Parallel Transporter Infrastructure installation will display a warning message. Teradata Tools and Utilities Installation Guide for UNIX and Linux 137

138 Chapter 7: Installing on Sun Solaris Opteron Client Systems Installing Teradata Parallel Transporter If the system does not meet the required minimum value, the Teradata Parallel Transporter Infrastructure installation will prompt to increase the value to the minimum required value. The following is an example of the prompt: Warning: The current value of for the kernel parameter (SHMMAX) is less than the minimum required value of SHMMAX refers to the maximum size of a shared memory segment. Note: This install recommends increasing the value to the minimum required value. Note: A kernel rebuild is not required to make the kernel parameter change(s) effective. Note: A reboot is required to make the kernel parameter change(s) effective. The reboot can be done after this installation but before running Teradata Parallel Transporter jobs. Do you want to increase the value to the minimum required value for the above kernel parameter(s)? Please enter y for yes or n for no [y,n,? (default : y)] If you enter n, the Teradata Parallel Transporter Infrastructure package will not change the kernel value. If you enter y, or if you respond by pressing the Enter key, the Teradata Parallel Transporter Infrastructure package will change the kernel value. A reboot is required to make the kernel parameter change(s) effective. You must be the root user to reboot the system. The reboot can be done after all the installations but before running a Teradata Parallel Transporter job. The following example reboot command will reboot the system in 60 seconds: # cd; /usr/sbin/shutdown -y -g60 -i6 At the end of the Teradata Parallel Transporter Infrastructure installation, the Teradata Parallel Transporter Infrastructure installation will update the following environment variables in the system /etc/profile and /etc/.login files: Table 41: Environment Variables Updated Environment Variable TWB_ROOT PATH LD_LIBRARY_PATH NLSPATH Update to Environment Variable Set to the Teradata Parallel Transporter installation directory. Add $TWB_ROOT/bin to the front of the PATH environment variable. Add $TWB_ROOT/lib to the front of the LD_LIBRARY_PATH environment variable. Add $TWB_ROOT/msg/%N to the front of the NLSPATH environment variable. 138 Teradata Tools and Utilities Installation Guide for UNIX and Linux

139 Chapter 7: Installing on Sun Solaris Opteron Client Systems Adding CLI User Exit Functions The updates to the environment variables are effective in the next login only if the Teradata Parallel Transporter Infrastructure package is installed. The updates to the environment variables allow users to run the installed version of Teradata Parallel Transporter. If the Teradata Parallel Transporter API package is installed, then the LD_LIBRARY_PATH and NLSPATH environment variables must be updated manually. The 32-bit files are in $TWB_ROOT/lib and $TWB_ROOT/msg. The 64-bit files will be in $TWB_ROOT/lib64 and $TWB_ROOT/msg64. The environment variables are updated on the command line, in the user's profile, or in the system profile. If the environment variables are updated on the command line, then the updates are effective only for the current session. If the environment variables are updated in the user's profile, then the updates are only effective every time that particular user logs in. If the environment variables are updated in the system profile, then the updates are effective every time any user logs in. Note: Users must use the updates to the environment variables in order to run the installed version of Teradata Parallel Transporter properly. Note: If users do not use the updates to the environment variables, then they will not be able to run the installed version of Teradata Parallel Transporter properly. Adding CLI User Exit Functions CLI User Exit functions are general purpose facilities that may be added to the CLI workstation architecture on Sun Solaris systems. These functions allow user-defined processing to take place. Procedure - Adding CLI User Exit Functions to a Sun Solaris Client Follow these steps to add CLI User Exit functions to a Sun Solaris client. 1 Change directories to /opt/teradata/client/sample by typing: # cd /opt/teradata/client/sample 2 Modify the CliLgnEx.c or CliPPS.c file in the sample directory. 3 Compile and link using either the 64-bit version or the 32-bit version of the makefile to create a new shared object, libtdusr.so. The following command compiles the 32-bit version: # make -f makedusr.sols 4 Move the libtdusr.so file into the /usr/lib directory for 32-bit applications, and to /usr/lib/ sparcv9 for 64-bit applications. If the default library directories were utilized during installation. Otherwise, specify the directory where the libcliv2.so library was installed. Refer to Teradata Call-Level Interface Version 2 Reference for Network-Attached Systems, Appendix D. Teradata Tools and Utilities Installation Guide for UNIX and Linux 139

140 Chapter 7: Installing on Sun Solaris Opteron Client Systems Adding CLI User Exit Functions 140 Teradata Tools and Utilities Installation Guide for UNIX and Linux

141 CHAPTER 8 Installing on Red Hat Linux Client Systems This chapter provides the procedures for installing and uninstalling the Teradata Tools and Utilities software on Red Hat Linux client systems. This chapter has the following sections: Installing Individual Products Removing Previous Versions of Software Installing Teradata Tools and Utilities Products Silently Installing Teradata Tools and Utilities Products Interactively Installing the Teradata Driver for the JDBC Interface Installing Teradata Parallel Transporter Adding CLI User Exit Functions Installing Individual Products This section describes how to install Teradata Tools and Utilities products on a RedHat Linux operating system. The specific operating systems include: Linux Red Hat Enterprise Linux Advanced Server 2.1 running on Intel x86 (32-bit Teradata Tools and Utilities) Linux Red Hat Enterprise Linux Advanced Server 3.0 running on Intel x86 (32-bit Teradata Tools and Utilities) Linux Red Hat Enterprise Linux Advanced Server 3.0 running on Intel Itanium (64-bit Teradata Tools and Utilities) Linux Red Hat Enterprise Linux Advanced Server 4.0 running on Intel x86 and EM64T and AMD Opteron 32-bit (32-bit Teradata Tools and Utilities) Linux Red Hat Enterprise Linux Advanced Server bit running on Intel EM64T and AMD Opteron 64-bit (32-bit Teradata Tools and Utilities) Linux Red Hat Enterprise Linux Advanced Server bit running on Intel EM64T and AMD Opteron 64-bit (32-bit Teradata Tools and Utilities) Linux Red Hat Enterprise Linux Advanced Server 5.0 running on Intel x86 and EM64T and AMD Opteron 32-bit(32-bit Teradata Tools and Utilities) Linux Red Hat Enterprise Linux Advanced Server bit running on Intel EM64T and AMD Opteron 64-bit (32-bit Teradata Tools and Utilities) Teradata Tools and Utilities Installation Guide for UNIX and Linux 141

142 Chapter 8: Installing on Red Hat Linux Client Systems Installing Individual Products Linux Red Hat Enterprise Linux Advanced Server bit running on Intel EM64T and AMD Opteron 64-bit (32-bit Teradata Tools and Utilities) The installation of CLI User exits are described later in the chapter. Installation of Teradata Tools and Utilities Products Using PUT Installation CD-ROMs Linux Packages The Teradata Parallel Upgrade Tool (PUT) is not supported for Linux Red Hat operating systems. Install Teradata Tools and Utilities products using setup.bat from one of the following CDs: 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 The following table shows the Red Hat Linux package names and the packages included with this release. Version numbers are contained in the Teradata Tools and Utilities Release Definition, Release Teradata Tools and Utilities Installation Guide for UNIX and Linux

143 Chapter 8: Installing on Red Hat Linux Client Systems Installing Individual Products Table 42: Red Hat Linux Packages and Operating Systems Linux Red Hat Enterprise Linux Advanced Server 2.1 running on Intel x86 (32-bit Teradata Tools and Utilities) Product Package Basic Teradata Query (BTEQ) bteq YES YES NO YES YES YES YES YES YES Named Pipes Access Module npaxsmod YES YES NO YES YES NO YES YES NO ODBC Driver for Teradata tdodbc YES YES NO YES YES YES YES YES YES Shared Common Components for tdicu YES YES YES YES YES YES YES YES YES Internationalization for Teradata Teradata Archive/Recovery Utility arc NO NO NO NO YES NO NO NO NO (ARC) Teradata C Preprocessor2 sqlpp YES YES YES YES YES YES YES YES YES Teradata Call-Level Interface version cliv2 YES YES NO YES YES YES YES YES YES 2 (CLIv2) Teradata Data Connector (also piom YES YES NO YES YES NO YES YES NO known as PIOM) Teradata Driver for the JDBC terajdbc4.jar YES YES YES YES NO YES YES NO YES Interface Teradata FastExport fexp YES YES NO YES YES NO YES YES NO Teradata FastLoad fastld YES YES NO YES YES NO YES YES NO Teradata Generic Security Services (32-bit) Teradata Generic Security Services (64-bit) Teradata Generic Security Services JAVA TeraGSS_ redhatlinux-i386 TeraGSS_ redhatlinux-ia64 Linux Red Hat Enterprise Linux Advanced Server 3.0 running on Intel x86 (32-bit Teradata Tools and Utilities) Linux Red Hat Enterprise Linux Advanced Server 3.0 running on Intel Itanium (64-bit Teradata Tools and Utilities) Linux Red Hat Enterprise Linux Advanced Server 4.0 running on Intel x86and EM64T/Opteron 32-bit (32-bit Teradata Tools and Utilities) Linux Red Hat Enterprise Linux Advanced Server bit running on Intel EM64T/Opteron 64-bit (32-bit Teradata Tools and Utilities) Linux Red Hat Enterprise Linux Advanced Server bit running on Intel EM64T/Opteron 64-bit (32-bit Teradata Tools and Utilities) Linux Red Hat Enterprise Linux Advanced Server 5.x running on Intel x86 and EM64T/Opteron 32-bit (32-bit Teradata Tools and Utilities) Linux Red Hat Enterprise Linux Advanced Server 5.x 32-bit running on Intel EM64T /Opteron 64-bit (32-bit Teradata Tools and Utilities) Linux Red Hat Enterprise Linux Advanced Server 5.x 64-bit running on Intel EM64T/Opteron 64-bit (32-bit Teradata Tools and Utilities) 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 Teradata MultiLoad mload YES YES NO YES YES NO YES YES NO Teradata Parallel Transporter API papic000 YES YES NO YES YES YES YES YES YES Teradata Parallel Transporter Data pdtcc000 YES YES NO YES YES NO YES YES NO Connector Operator Teradata Parallel Transporter DDL Operator pddlc000 YES YES NO YES YES NO YES YES NO Teradata Tools and Utilities Installation Guide for UNIX and Linux 143

144 Chapter 8: Installing on Red Hat Linux Client Systems Installing Individual Products Table 42: Red Hat Linux Packages and Operating Systems (continued) Product Teradata Parallel Transporter Export Operator Teradata Parallel Transporter FastExport OUTMOD Adapter Operator Teradata Parallel Transporter FastLoad INMOD Adapter Operator Teradata Parallel Transporter ICU Library Teradata Parallel Transporter Infrastructure Teradata Parallel Transporter Load Operator Teradata Parallel Transporter MultiLoad INMOD Adapter Operator 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 Package pexpc000 YES YES NO Loaded as part of Teradata Parallel Transporter Infrastructure. Loaded as part of Teradata Parallel Transporter Infrastructure. YES YES YES YES YES YES YES YES NO YES YES NO YES YES NO NO YES NO YES YES NO YES YES NO picuc000 YES YES NO YES YES YES YES YES YES tbldc000 NO YES NO YES YES NO YES YES NO plodc000 YES YES NO YES YES YES YES YES YES Loaded as part of Teradata Parallel Transporter Infrastructure. Linux Red Hat Enterprise Linux Advanced Server 2.1 running on Intel x86 (32-bit Teradata Tools and Utilities) Linux Red Hat Enterprise Linux Advanced Server 3.0 running on Intel x86 (32-bit Teradata Tools and Utilities) Linux Red Hat Enterprise Linux Advanced Server 3.0 running on Intel Itanium (64-bit Teradata Tools and Utilities) Linux Red Hat Enterprise Linux Advanced Server 4.0 running on Intel x86and EM64T/Opteron 32-bit (32-bit Teradata Tools and Utilities) Linux Red Hat Enterprise Linux Advanced Server bit running on Intel EM64T/Opteron 64-bit (32-bit Teradata Tools and Utilities) Linux Red Hat Enterprise Linux Advanced Server bit running on Intel EM64T/Opteron 64-bit (32-bit Teradata Tools and Utilities) Linux Red Hat Enterprise Linux Advanced Server 5.x running on Intel x86 and EM64T/Opteron 32-bit (32-bit Teradata Tools and Utilities) Linux Red Hat Enterprise Linux Advanced Server 5.x 32-bit running on Intel EM64T /Opteron 64-bit (32-bit Teradata Tools and Utilities) NO YES NO YES YES NO YES YES NO podbcc000 NO YES NO YES NO NO YES NO NO poslc000 YES YES NO YES YES YES YES YES YES poscc000 NO YES NO YES YES NO YES YES NO pinsc000 YES YES NO YES YES NO YES YES NO pselc000 YES YES NO YES YES NO YES YES NO Linux Red Hat Enterprise Linux Advanced Server 5.x 64-bit running on Intel EM64T/Opteron 64-bit (32-bit Teradata Tools and Utilities) 144 Teradata Tools and Utilities Installation Guide for UNIX and Linux

145 Chapter 8: Installing on Red Hat Linux Client Systems Removing Previous Versions of Software Table 42: Red Hat Linux Packages and Operating Systems (continued) Linux Red Hat Enterprise Linux Advanced Server 2.1 running on Intel x86 (32-bit Teradata Tools and Utilities) Product Package Teradata Parallel Transporter Stream pstmc000 YES YES NO YES YES YES YES YES YES Operator Teradata Parallel Transporter Update pupdc000 YES YES NO YES YES YES YES YES YES Operator Teradata Query Director qrydir NO NO NO YES YES NO YES YES NO Teradata TPump tpump YES YES NO YES YES NO YES YES NO WebSphere MQ Access Module mqaxsmod YES YES NO YES YES NO YES YES NO Linux Red Hat Enterprise Linux Advanced Server 3.0 running on Intel x86 (32-bit Teradata Tools and Utilities) Linux Red Hat Enterprise Linux Advanced Server 3.0 running on Intel Itanium (64-bit Teradata Tools and Utilities) Linux Red Hat Enterprise Linux Advanced Server 4.0 running on Intel x86and EM64T/Opteron 32-bit (32-bit Teradata Tools and Utilities) Linux Red Hat Enterprise Linux Advanced Server bit running on Intel EM64T/Opteron 64-bit (32-bit Teradata Tools and Utilities) Linux Red Hat Enterprise Linux Advanced Server bit running on Intel EM64T/Opteron 64-bit (32-bit Teradata Tools and Utilities) Linux Red Hat Enterprise Linux Advanced Server 5.x running on Intel x86 and EM64T/Opteron 32-bit (32-bit Teradata Tools and Utilities) Linux Red Hat Enterprise Linux Advanced Server 5.x 32-bit running on Intel EM64T /Opteron 64-bit (32-bit Teradata Tools and Utilities) Linux Red Hat Enterprise Linux Advanced Server 5.x 64-bit running on Intel EM64T/Opteron 64-bit (32-bit Teradata Tools and Utilities) Removing Previous Versions of Software Prior to the installation process, check for any existing software and remove it. Note: If a previous version of cliv2 is installed, it must be uninstalled before installing the newer version. Note: An exception is the Teradata Generic Security Services software, it does not have to be uninstalled. Note: An exception is the Teradata Parallel Transporter software, it does not have to be uninstalled. Procedure - Removing Previous Versions of Teradata Tools and Utilities Software Follow these steps to remove previous versions of Teradata Tools and Utilities software. Teradata Tools and Utilities Installation Guide for UNIX and Linux 145

146 Chapter 8: Installing on Red Hat Linux Client Systems Removing Previous Versions of Software 1 Log on as root and enter the password. 2 List all the installed packages by entering the following command at the prompt: # rpm -qa Or, you can check to see if a particular package is installed using the command: # rpm -q <rpmname> Table 43: Checking for Previous Versions of Software on Linux To check for a single package... Basic Teradata Query (BTEQ) (32-bit) Named Pipes Access Module (32-bit) ODBC Driver for Teradata Shared Common Components for Internationalization for Teradata (32-bit) Shared Common Components for Internationalization for Teradata (64-bit) Teradata Call-level Interface version 2 (CLIv2) (32-bit) Teradata Call-level Interface version 2 (CLIv2) (64-bit) Teradata Data Connector (32-bit) Teradata FastExport (32-bit) Teradata FastLoad (32-bit) enter... # rpm -q bteq # rpm -q npaxsmod # rpm -q tdodbc # rpm -q tdicu # rpm -q tdicu_64 # rpm -q cliv2 # rpm -q cliv2_64 # rpm -q piom # rpm -q fexp # rpm -q fastld Teradata Generic Security Services (32-bit) # rpm -q TeraGSS_redhatlinux-i386 Teradata Generic Security Services (64-bit) # rpm -q TeraGSS_redhatlinux-ia64 Teradata MultiLoad (32-bit) Teradata C Preprocessor2 (32-bit) Teradata C Preprocessor2 (64-bit) Teradata Parallel Transporter API (32-bit) Teradata Parallel Transporter Data Connector Operator (32-bit) Teradata Parallel Transporter DDL Operator (32-bit) Teradata Parallel Transporter Export Operator (32-bit) Teradata Parallel Transporter ICU Library (32-bit) Teradata Parallel Transporter Infrastructure (32-bit) Teradata Parallel Transporter Load Operator (32-bit) # rpm -q mload # rpm -q sqlpp # rpm -q sqlpp # rpm -q papic000 # rpm -q pdtcc000 # rpm -q pddlc000 # rpm -q pexpc000 # rpm -q picuc000 # rpm -q tbldc000 # rpm -q plodc Teradata Tools and Utilities Installation Guide for UNIX and Linux

147 Chapter 8: Installing on Red Hat Linux Client Systems Removing Previous Versions of Software Table 43: Checking for Previous Versions of Software on Linux (continued) To check for a single package... Teradata Parallel Transporter ODBC Operator (32-bit) Teradata Parallel Transporter Operator Support Library (32-bit) Teradata Parallel Transporter OS Command Operator (32-bit) Teradata Parallel Transporter SQL Inserter Operator (32- bit) Teradata Parallel Transporter SQL Selector Operator (32- bit) Teradata Parallel Transporter Stream Operator (32-bit) Teradata Parallel Transporter Update Operator (32-bit) Teradata Query Director Teradata TPump (32-bit) WebSphere MQ Access Module (32-bit) enter... # rpm -q podbcc000 # rpm -q poslc000 # rpm -q poscc000 # rpm -q pinsc000 # rpm -q pselc000 # rpm -q pstmvc000 # rpm -q pupdc000 # rpm -q qrydir # rpm -q tpump # rpm -q mqaxsmod 3 Remove individual packages by entering: # rpm -e <rpmname> Table 44: Uninstalling Previous Versions of Software on Linux To uninstall... Basic Teradata Query BTEQ (32-bit) Named Pipes Access Module (32-bit) ODBC Driver for Teradata Shared Common Components for Internationalization for Teradata (32-bit) Shared Common Components for Internationalization for Teradata (64-bit) Teradata Call-level Interface version 2 (CLIv2) (32-bit) Teradata Call-level Interface version 2 (CLIv2) (64-bit) Teradata Data Connector (32-bit) Teradata FastExport (32-bit) Teradata FastLoad (32-bit) enter... # rpm -e bteq # rpm -e npaxsmod # rpm -e tdodbc # rpm -e tdicu # rpm -e tdicu_64 # rpm -e cliv2 # rpm -e cliv2_64 # rpm -e piom # rpm -e fastexp # rpm -e fastld Teradata Generic Security Services (32-bit) # rpm -e TeraGSS_redhatlinux-i386 Teradata Tools and Utilities Installation Guide for UNIX and Linux 147

148 Chapter 8: Installing on Red Hat Linux Client Systems Installing Teradata Tools and Utilities Table 44: Uninstalling Previous Versions of Software on Linux (continued) To uninstall... enter... Teradata Generic Security Services (64-bit) # rpm -e TeraGSS_redhatlinux-ia64 Teradata MultiLoad (32-bit) Teradata C Preprocessor2 (32-bit) Teradata C Preprocessor2 (64-bit) Teradata Parallel Transporter API (32-bit) Teradata Parallel Transporter Data Connector Operator (32-bit) Teradata Parallel Transporter DDL Operator (32-bit) Teradata Parallel Transporter Export Operator (32-bit) Teradata Parallel Transporter ICU Library(32-bit) Teradata Parallel Transporter Infrastructure (32-bit) Teradata Parallel Transporter Load Operator (32-bit) Teradata Parallel Transporter ODBC Operator (32-bit) Teradata Parallel Transporter Operator Support Library (32-bit) Teradata Parallel Transporter OS Command Operator (32-bit) Teradata Parallel Transporter SQL Inserter Operator (32- bit) Teradata Parallel Transporter SQL Selector Operator (32- bit) Teradata Parallel Transporter Stream Operator (32-bit) Teradata Parallel Transporter Update Operator (32-bit) Teradata Query Director Teradata TPump (32-bit) WebSphere MQ Access Module (32-bit) # rpm -e mload # rpm -e sqlpp # rpm -e sqlpp # rpm -e papic000 # rpm -e pdtcc000 # rpm -e pddlc000 # rpm -e pexpc000 # rpm -e picuc000 # rpm -e tbldc000 # rpm -e plodc000 # rpm -e podbcc000 # rpm -e poslc000 # rpm -e poscc000 # rpm -e pinsc000 # rpm -e pselc000 # rpm -e pstmc000 # rpm -e pupdc000 # rpm -e qrydir # rpm -e tpump # rpm -e mqaxsmod Installing Teradata Tools and Utilities To install products, run the installation for Teradata Tools and Utilities and select the products to install. 148 Teradata Tools and Utilities Installation Guide for UNIX and Linux

149 Chapter 8: Installing on Red Hat Linux Client Systems Installing Teradata Tools and Utilities Installing Teradata Tools and Utilities Products Silently Teradata Tools and Utilities products can be installed silently. Procedure - Installing Teradata Tools and Utilities Products Silently Follow these steps to install Teradata Tools and Utilities products silently. 1 Log on to the Linux client as root. 2 If a /mnt directory does not exist, create one by entering the following command at the prompt: # mkdir /mnt In the command shown, the CD-ROM mount point is /mnt, but an alternate may be used. 3 Insert the installation CD into the CD-ROM drive, then enter the following at the command prompt: # mount /dev/<cdrom device name> /mnt For example, if the CD-ROM device name is cdrom, you would type: # mount /dev/cdrom /mnt In the example, the CD-ROM mount point is /mnt, but an alternate may be entered. 4 To begin the installation process, type: # cd /mnt #./setup.bat A screen display similar to the following appears: Copyright NCR Corporation. All Rights Reserved. Platform: Linux 32bit (i386) Media: Load/Unload Which software do you want to install? 1. TeraGSS - Teradata GSS client package 2. tdicu - Teradata Shared Component for Internationalization 3. tdodbc - Teradata ODBC Driver 4. cliv2 - Teradata CLIv2 5. piom - Teradata Data Connector API 6. npaxsmod - Teradata Named Pipes Access Module 7. mqaxsmod - WebSphere(r) Access Module for Teradata 8. bteq - Teradata BTEQ Application 9. fastexp - Teradata FastExport Utility 10. fastld - Teradata FastLoad Utility 11. mload - Teradata MultiLoad Utility 12. tpump - Teradata TPump Utility 13. qrydir - Teradata Query Director a. Install all of the above software q. Quit the installation Enter one or more selections (separated by space): 5 Software must be installed in the order shown in Software Requirements on page 30. After reviewing product dependencies, enter your selection at the prompt: Teradata Tools and Utilities Installation Guide for UNIX and Linux 149

150 Chapter 8: Installing on Red Hat Linux Client Systems Installing Teradata Tools and Utilities one or more numbers for the product(s) you want to install, separated by spaces, or a to install all the software, or q to quit the installation 6 Change back to the root directory and unmount the CD by typing: # umount /mnt 7 Remove the installation CD from the CD-ROM drive. Following installation, you may wish to verify that the installation executed successfully. See Verifying the Installation of Individual Products on page 212 and Verifying the Installation Using the CLI Sample Program on page 241. Installing Teradata Tools and Utilities Products Interactively Teradata Tools and Utilities products can be installed interactively. Procedure - Installing Teradata Tools and Utilities Products Interactively Follow these steps to install Teradata Tools and Utilities products interactively. 1 Log on to the Linux client as root. 2 If a /mnt directory does not exist, create one by entering the following command at the prompt: # mkdir /mnt In the command shown, the CD-ROM mount point is /mnt, but an alternate may be used. 3 Insert the installation CD into the CD-ROM drive, then enter the following at the command prompt: # mount /dev/<cdrom device name> /mnt For example: If the CD-ROM device name is cdrom, you would type: # mount /dev/cdrom /mnt In the example, the CD-ROM mount point is /mnt, but an alternate may be entered. 4 Go to the directory where the rpm for the Teradata Tools and Utilities product is present. # cd <CD mount point>/linux # cd <package directory name> Table 45: Changing Directories To change to the directory where... Basic Teradata Query (BTEQ) (32-bit) Named Pipes Access Module (32-bit) ODBC Driver for Teradata is installed, enter... # cd bteq # cd npipes # cd tdodbc 150 Teradata Tools and Utilities Installation Guide for UNIX and Linux

151 Chapter 8: Installing on Red Hat Linux Client Systems Installing Teradata Tools and Utilities Table 45: Changing Directories (continued) To change to the directory where... Shared Common Components for Internationalization for Teradata (32-bit) Shared Common Components for Internationalization for Teradata (64-bit) Teradata Call-level Interface version 2(CLIv2) (32-bit) Teradata Call-level Interface version 2 (CLIv2) (64-bit) Teradata Data Connector (32-bit) Teradata FastExport (32-bit) Teradata FastLoad (32-bit) Teradata MultiLoad (32-bit) Teradata C Preprocessor2 (32-bit) Teradata C Preprocessor2 (64-bit) Teradata Generic Security Services (32-bit) Teradata Generic Security Services (64-bit) Teradata Parallel Transporter API (32-bit) Teradata Parallel Transporter Data Connector Operator (32-bit) Teradata Parallel Transporter DDL Operator (32-bit) Teradata Parallel Transporter Export Operator (32-bit) Teradata Parallel Transporter ICU Library (32-bit) Teradata Parallel Transporter Infrastructure (32-bit) Teradata Parallel Transporter Load Operator (32-bit) Teradata Parallel Transporter ODBC Operator (32-bit) Teradata Parallel Transporter Operator Support Library (32-bit) Teradata Parallel Transporter OS Command Operator (32-bit) Teradata Parallel Transporter SQL Inserter Operator (32- bit) Teradata Parallel Transporter SQL Selector Operator (32- bit) Teradata Parallel Transporter Stream Operator (32-bit) Teradata Parallel Transporter Update Operator (32-bit) is installed, enter... # cd tdicu # cd tdicu # cd cliv2 # cd cliv2 # cd piom # cd fexp # cd fastld # cd mload # cd sqlpp # cd sqlpp # cd TeraGSS # cd TeraGSS # cd papic000 # cd pdtcc000 # cd pddlc000 # cd pexpc000 # cd picuc000 # cd tbldc000 # cd plodc000 # cd podbcc000 # cd poslc000 # cd poscc000 # cd pinsc000 # cd pselc000 # cd pstmc000 # cd pupdc000 Teradata Tools and Utilities Installation Guide for UNIX and Linux 151

152 Chapter 8: Installing on Red Hat Linux Client Systems Installing Teradata Tools and Utilities Table 45: Changing Directories (continued) To change to the directory where... Teradata Query Director Teradata TPump (32-bit) WebSphere MQ Access Module (32-bit) is installed, enter... # cd qrydir # cd tpump # cd mqaxsmod 5 To install a Teradata Tools and Utilities product use the command: # rpm -ivh <rpmname> To install a Teradata Parallel Transporter product use the command: #./tptinstall -r <rpmname> Table 46: Installing Teradata Tools and Utilities on Linux To install... Basic Teradata Query (BTEQ) (32- bit) Named Pipes Access Module (32- bit) ODBC Driver for Teradata Shared Common Components for Internationalization for Teradata (32-bit) Shared Common Components for Internationalization for Teradata (64-bit) Teradata Call-level Interface version 2 (CLIv2) (32-bit) Teradata Call-level Interface version 2 (CLIv2) (64-bit) Teradata Data Connector (32-bit) Teradata FastExport (32-bit) Teradata FastLoad (32-bit) Teradata Generic Security Services (32-bit) Teradata Generic Security Services (64-bit) Teradata MultiLoad (32-bit) Teradata C Preprocessor2 (32-bit) enter... # rpm -ivh bteq i386.rpm # rpm -ivh npaxsmod i386.rpm # rpm --nodeps -i tdodbc i386.rpm # rpm -ivh tdicu i386.rpm # rpm -ivh tdicu_ ia64.rpm # rpm -ivh cliv i386.rpm # rpm -ivh cliv2_ ia64.rpm # rpm -ivh piom i386.rpm # rpm -ivh fexp i386.rpm # rpm -ivh fastld i386.rpm # rpm -ivh TeraGSS_redhatlinux-1.i i386.rpm # rpm -ivh TeraGSS_redhatlinux-1.ia ia64.rpm # rpm -ivh mload i386.rpm # rpm -ivh sqlpp i386.rpm 152 Teradata Tools and Utilities Installation Guide for UNIX and Linux

153 Chapter 8: Installing on Red Hat Linux Client Systems Installing Teradata Tools and Utilities Table 46: Installing Teradata Tools and Utilities on Linux (continued) To install... Teradata C Preprocessor2 (64-bit) Teradata Parallel Transporter API (32-bit) Teradata Parallel Transporter Data Connector Operator (32-bit) Teradata Parallel Transporter DDL Operator (32-bit) Teradata Parallel Transporter Export Operator (32-bit) Teradata Parallel Transporter ICU Library (32-bit) Teradata Parallel Transporter Infrastructure (32-bit) Teradata Parallel Transporter Load Operator (32-bit) Teradata Parallel Transporter ODBC Operator (32-bit) Teradata Parallel Transporter Operator Support Library (32-bit) Teradata Parallel Transporter OS Command Operator (32-bit) Teradata Parallel Transporter SQL Inserter Operator (32-bit) Teradata Parallel Transporter SQL Selector Operator (32-bit) Teradata Parallel Transporter Stream Operator (32-bit) Teradata Parallel Transporter Update Operator (32-bit) Teradata Query Director Teradata Query Director Teradata TPump (32-bit) WebSphere MQ Access Module (32- bit) enter... # rpm -ivh sqlpp ia64.rpm #./tptinstall -r papic i386.rpm #./tptinstall -r pdtcc i386.rpm #./tptinstall -r pddlc i386.rpm #./tptinstall -r pexpc i386.rpm #./tptinstall -r picuc i386.rpm #./tptinstall -r tbldc i386.rpm #./tptinstall -r plodc i386.rpm #./tptinstall -r podbcc i386.rpm #./tptinstall -r poslc i386.rpm #./tptinstall -r poscc i386.rpm #./tptinstall -r pinsc i386.rpm #./tptinstall -r psec i386.rpm #./tptinstall -r pstmc i386.rpm #./tptinstall -r pupdc i386.rpm # rpm -ivh qrydir # rpm -ivh qrydir i386.rpm # rpm -ivh tpump i386.rpm # rpm -ivh mqaxsmod i386.rpm Teradata Tools and Utilities Installation Guide for UNIX and Linux 153

154 Chapter 8: Installing on Red Hat Linux Client Systems Installing Teradata Tools and Utilities 6 Chapter 10: Configuring Teradata Tools and Utilities, contains a list of the files in each package. Verify all the files in the package are installed by using the Red Hat Package Manager command: # rpm -ql <rpmname> Table 47: Verifying the Installation on Linux To verify the installation of... Basic Teradata Query (BTEQ) (32-bit) Named Pipes Access Module (32-bit) ODBC Driver for Teradata Shared Common Components for Internationalization for Teradata (32-bit) Shared Common Components for Internationalization for Teradata (64-bit) Teradata Call-level Interface version 2 (CLIv2) (32- bit) Teradata Call-level Interface version 2 (CLIv2) (64- bit) Teradata Data Connector (32-bit) Teradata FastExport (32-bit) Teradata FastLoad (32-bit) Teradata Generic Security Services (32-bit) Teradata Generic Security Services (64-bit) Teradata MultiLoad (32-bit) Teradata C Preprocessor (32-bit) Teradata C Preprocessor (64-bit) Teradata Parallel Transporter API (32-bit) Teradata Parallel Transporter Data Connector Operator (32-bit) Teradata Parallel Transporter DDL Operator (32-bit) Teradata Parallel Transporter Export Operator (32- bit) Teradata Parallel Transporter ICU Library (32-bit) Teradata Parallel Transporter Infrastructure (32-bit) Teradata Parallel Transporter Load Operator (32-bit) enter... # rpm -ql bteq # rpm -ql npaxsmod # rpm -ql tdodbc # rpm -ql tdicu # rpm -ql tdicu_64 # rpm -ql cliv2 # rpm -ql cliv2_64 # rpm -ql piom # rpm -ql fastexp # rpm -ql fastld # rpm -ql TeraGSS_redhatlinuxi386 # rpm -ql TeraGSS_redhatlinuxia64 # rpm -ql mload # rpm -ql sqlpp # rpm -ql sqlpp # rpm -ql papic000 # rpm -ql pdtcc000 # rpm -ql pddlc000 # rpm -ql pexpc000 # rpm -ql picuc000 # rpm -ql tbldc000 # rpm -ql plodc Teradata Tools and Utilities Installation Guide for UNIX and Linux

155 Chapter 8: Installing on Red Hat Linux Client Systems Installing the Teradata Driver for the JDBC Interface Table 47: Verifying the Installation on Linux (continued) To verify the installation of... Teradata Parallel Transporter ODBC Operator (32- bit) Teradata Parallel Transporter Operator Support Library (32-bit) Teradata Parallel Transporter OS Command Operator (32-bit) Teradata Parallel Transporter SQL Inserter Operator (32-bit) Teradata Parallel Transporter SQL Selector Operator (32-bit) Teradata Parallel Transporter Stream Operator (32- bit) Teradata Parallel Transporter Update Operator (32- bit) Teradata Query Director Teradata TPump (32-bit) WebSphere MQ Access Module (32-bit) enter... # rpm -ql podbcc000 # rpm -ql poslc000 # rpm -ql poscc000 # rpm -ql pinsc000 # rpm -ql pselc000 # rpm -ql pstmc000 # rpm -ql pupdc000 # rpm -ql qrydir # rpm -ql tpump # rpm -ql mqaxsmod 7 Change back to the root directory and unmount the CD by entering the following command at the prompt: # umount /mnt 8 Remove the installation CD from the CD-ROM drive. Installing the Teradata Driver for the JDBC Interface The Teradata Driver for the JDBC Interface can 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. Teradata Tools and Utilities Installation Guide for UNIX and Linux 155

156 Chapter 8: Installing on Red Hat Linux Client Systems Installing the Teradata Access Module for JMS 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 Teradata Access Module for JMS The Teradata Access Module for JMS version is available on the following CDs: Load/Unload CD #2 for HP-UX Load/Unload CD #3 for Sun Solaris SPARC The Teradata Access Module for JMS version for IBM AIX and Linux is being released asynchronously to Teradata Tools and Utilities IBM AIX and Linux versions of the Teradata Access Module for Teradata can be downloaded from the Teradata Download Center at: --> Support Services --> Downloads --> Drivers, UDFs, and Toolbox --> Teradata Toolbox --> JMS Access Module Installing Teradata Parallel Transporter The installation of a new version of Teradata Parallel Transporter will prompt you for the Teradata Parallel Transporter installation directory. Here is a sample of the prompt: Please specify the install directory [default: /opt/teradata/client/tbuild/ ]: If you respond by just pressing the Enter key, the default install directory will be used. Note: It is not recommended to use / or /usr as the install directory. Here are the restrictions on the installation directory for Teradata Parallel Transporter: The installation directory cannot be a relative directory path. The pipe character cannot be in the name of the installation directory. The double quote character cannot be in the name of the installation directory. The equal character = cannot be in the name of the installation directory. The whitespace character cannot be in the name of the installation directory. In addition to the Teradata Parallel Transporter installation directory, the Teradata Parallel Transporter Infrastructure package will prompt you for the Teradata Parallel Transporter logs directory. The following is an example of the prompt: The logs directory contains Teradata Parallel Transporter job log files. The logs directory should be in a partition with a large free space. Please specify the logs directory [ default: /opt/teradata/client/ tbuild/ /logs ]: 156 Teradata Tools and Utilities Installation Guide for UNIX and Linux

157 Chapter 8: Installing on Red Hat Linux Client Systems Installing Teradata Parallel Transporter If you respond by just pressing the Enter key, the default logs directory will be used. The following are the restrictions on the logs directory for Teradata Parallel Transporter: The logs directory cannot be a relative directory path. The whitespace character cannot be in the name of the logs directory. The Teradata Parallel Transporter package will prompt for the interprocess communication (IPC) memory choice. The following is an example of the prompt: Teradata Parallel Transporter Infrastructure uses shared memory or memory mapped file for interprocess communication (IPC). Shared memory utilizes system shared memory for IPC. Memory mapped file utilizes temporary disk storage for IPC. Please select the IPC memory mechanism [ default: shared memory ]: Enter 1 for shared memory Enter 2 for memory mapped file If you respond by pressing the Enter key or 1, the IPC memory choice will be shared memory. If you respond by pressing 2, the IPC memory choice will be memory mapped file and the Teradata Parallel Transporter package will prompt for the memory mapped file directory. The following is an example of the prompt: The memory mapped file directory contains temporary Teradata Parallel Transporter job files. The memory mapped file directory should be in a partition with a large free space. Please specify the memory mapped file directory [ default: /usr/tbuild/ /mmap ]: If you respond by pressing the Enter key, the default memory mapped file directory will be used. The following are the restrictions on the memory mapped file directory for Teradata Parallel Transporter: The memory mapped file directory cannot be a relative directory path. The whitespace character cannot be in the name of the memory mapped file directory. Note: During the reinstall of the same Teradata Parallel Infrastructure version, the Teradata Parallel Infrastructure reinstall will not ask for the IPC memory choice. The reinstall will reuse the existing IPC memory choice. Note: The first Teradata Parallel Transporter package will ask for the installation directory. Subsequent Teradata Parallel Transporter packages of the same version will not ask for the installation directory, but will use the same installation directory as the first one. The Teradata Parallel Transporter Infrastructure package checks for the following system kernel values: Teradata Tools and Utilities Installation Guide for UNIX and Linux 157

158 Chapter 8: Installing on Red Hat Linux Client Systems Installing Teradata Parallel Transporter Table 48: Kernel Values Kernel Parameter Required Minimum Value Description semmni 1000 Maximum number of semaphore sets in entire system. semmns 1000 Maximum number of semaphores in entire system. shmmax Maximum size of a shared memory segment in bytes. shmmni 200 Maximum number of shared memory segments in entire system. Note: The Teradata Parallel Transporter Infrastructure installation does not support formula value. If the kernel value is a formula, then the Teradata Parallel Transporter Infrastructure installation will display a warning message. If the system does not meet the required minimum value, the Teradata Parallel Transporter Infrastructure installation will prompt you to increase the value to the minimum required value. The following is an example of the prompt: Warning: The current value of for the kernel parameter (shmmax) is less than the minimum required value of shmmax refers to the maximum size of a shared memory segment. Note: This install recommends increasing the value to the minimum required value. Note: A reboot is not required to make the above kernel parameter change(s) effective. Do you want to increase the value to the minimum required value for the above kernel parameter(s)? Please enter y for yes or n for no [y,n,? (default : y)] If you enter n, the Teradata Parallel Transporter Infrastructure package will not change the kernel value. If you enter y, or if you respond by just pressing the Enter key, the Teradata Parallel Transporter Infrastructure package will change the kernel value. A reboot is not required to make the kernel parameter change(s) effective. At the end of the Teradata Parallel Transporter Infrastructure installation, the Teradata Parallel Transporter Infrastructure installation will update the following environment variables in the system /etc/profile and /etc/csh.login files: Table 49: Environment Variables Updated Environment Variable TWB_ROOT PATH LD_LIBRARY_PATH Update to Environment Variable Set to the Teradata Parallel Transporter installation directory. Add $TWB_ROOT/bin to the front of the PATH environment variable. Add $TWB_ROOT/lib to the front of the LD_LIBRARY_PATH environment variable. 158 Teradata Tools and Utilities Installation Guide for UNIX and Linux

159 Chapter 8: Installing on Red Hat Linux Client Systems Adding CLI User Exit Functions Table 49: Environment Variables Updated (continued) Environment Variable NLSPATH Update to Environment Variable Add $TWB_ROOT/msg/%N to the front of the NLSPATH environment variable. The updates to the environment variables are effective in the next login only if the Teradata Parallel Transporter Infrastructure package is installed. The updates to the environment variables allow users to run the installed version of Teradata Parallel Transporter. If the Teradata Parallel Transporter API package is installed, then the LD_LIBRARY_PATH and NLSPATH environment variables must be updated manually. The 32-bit files is in $TWB_ROOT/lib and $TWB_ROOT/msg. The 64-bit files is in $TWB_ROOT/lib64 and $TWB_ROOT/msg64. The environment variables must be updated on the command line, in the user's profile, or in the system profile. If the environment variables are updated on the command line, then the updates are effective only for the current session. If the environment variables are updated in the user's profile, then the updates are only effective every time that particular user logs in. If the environment variables are updated in the system profile, then the updates are effective every time any user logs in. Note: Users must use the updates to the environment variables in order to run the installed version of Teradata Parallel Transporter properly. Note: If users do not use the updates to the environment variables, then they will not be able to run the installed version of Teradata Parallel Transporter properly. Adding CLI User Exit Functions CLI User Exit functions are general purpose facilities that may be added to the CLI workstation architecture on Linux systems. These functions allow user-defined processing to take place. Procedure - Adding CLI User Exit Functions to a Red Hat Linux Client Follow these steps to add CLI User Exit functions to a Red Hat Linux client. 1 Change directories to /opt/teradata/client/sample, using the following command: # cd /opt/teradata/client/sample 2 Modify the CliLgnEx.c or CliPPS.c file in the sample directory. 3 Compile and link using either the 64-bit version or the 32-bit version of the makefile to create a new shared object, libtdusr.so. This command compiles the 32-bit version: # make -f maketdusr.lx Teradata Tools and Utilities Installation Guide for UNIX and Linux 159

160 Chapter 8: Installing on Red Hat Linux Client Systems Adding CLI User Exit Functions Note: On 64-bit Linux, the compiler will always generate 64-bit binaries. The 32-bit makefile is not supported on 64-bit Linux platforms. 4 Move the libtdusr.so file into the /usr/lib directory. The CLIv2 libcliv2.so should exist in the same directory. For more information on CLI User Exit Functions, see Teradata Call-Level Interface Version 2 Reference for Network-Attached Systems, Appendix D. 160 Teradata Tools and Utilities Installation Guide for UNIX and Linux

161 CHAPTER 9 Installing on SUSE Linux Client Systems This chapter provides the procedures for installing and uninstalling the Teradata Tools and Utilities software on SUSE Linux client systems. This chapter has the following sections: Installing Individual Products Removing Previous Versions of Software Installing Teradata Tools and Utilities Products Silently Installing Teradata Tools and Utilities Products Interactively Installing the Teradata Driver for the JDBC Interface Adding CLI User Exit Functions Installing Individual Products This section describes how to install Teradata Tools and Utilities products on a SUSE Linux operating system. The specific operating systems include: SUSE Linux Enterprise 9 with SP1, 2 or 3 running on Intel x86 (32-bit Teradata Tools and Utilities) SUSE Linux Enterprise 9 with SP1, 2 or 3 32-bit running on Intel EM64T (32-bit Teradata Tools and Utilities) SUSE Linux Enterprise 9 with SP1, 2 or 3 running on Intel EM64T (64-bit Teradata Tools and Utilities) SUSE Linux Enterprise 9 with SP1, 2 or 3 running on AMD Opteron (64-bit Teradata Tools and Utilities) SUSE Linux Enterprise 10 with SP1 running on Intel x86 (32-bit Teradata Tools and Utilities) SUSE Linux Enterprise 10 with SP1 32-bit running on Intel EM64T (32-bit Teradata Tools and Utilities) SUSE Linux Enterprise 10 with SP1 running on Intel EM64T (64-bit Teradata Tools and Utilities) The installation of CLI User exits are described later in the chapter. Teradata Tools and Utilities Installation Guide for UNIX and Linux 161

162 Chapter 9: Installing on SUSE Linux Client Systems Installing Individual Products Installation of Teradata Tools and Utilities Products Using PUT Installation CD-ROMs Linux Packages The following products can be installed from either the Teradata Tools and Utilities CD using the installation procedures described below, or using the Teradata Parallel Upgrade Tool (PUT). Basic Teradata Query (BTEQ) Shared Common Components for Internationalization for Teradata Teradata Call-Level Interface version 2 (CLIv2) Teradata Data Connector Named Pipes Access Module Install Teradata Tools and Utilities products using setup.bat from one of the following CDs: 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 The following table shows the SUSE Linux package names and the packages included with this release. Version numbers are contained in the Teradata Tools and Utilities Release Definition, Release Teradata Tools and Utilities Installation Guide for UNIX and Linux

163 Chapter 9: Installing on SUSE Linux Client Systems Installing Individual Products Table 50: Teradata Tools and Utilities supported on UNIX and Linux Product Package Names Basic Teradata Query (BTEQ) bteq YES YES NO YES YES NO Named Pipes Access Module npaxsmod YES YES NO YES YES NO ODBC Driver for Teradata tdodbc YES YES YES YES YES YES Shared Common Components for tdicu YES YES YES YES YES YES Internationalization for Teradata Teradata Archive/Recovery Utility (ARC) arc NO YES NO NO YES NO Teradata Call-Level Interface version 2 cliv2 YES YES YES YES YES YES (CLIv2) Teradata C Preprocessor2 sqlp YES YES YES YES YES YES Teradata Data Connector (also known as piom YES YES NO YES YES NO PIOM) Teradata Driver for the JDBC Interface terajdbc4.jar YES YES YES YES NO NO Teradata FastExport fexp YES YES NO YES YES NO Teradata FastLoad fastld YES YES NO YES YES NO Teradata Generic Security Services TeraGSS_suselinuxx86_64 YES YES YES YES YES YES Teradata Generic Security Services JAVA YES YES YES YES YES YES Teradata MultiLoad mload YES YES NO YES YES NO Teradata Parallel Transporter API papic000 YES YES YES YES YES YES Teradata Parallel Transporter Data pdtcc000 YES YES NO YES YES NO Connector Operator Teradata Parallel Transporter DDL pddlc000 YES YES NO YES YES NO Operator Teradata Parallel Transporter Export Operator pexpc000 YES YES YES YES YES YES Teradata Parallel Transporter FastExport OUTMOD Adapter Operator Teradata Parallel Transporter FastLoad INMOD Adapter Operator Loaded as part of Teradata Parallel Transporter Infrastructure. Loaded as part of Teradata Parallel Transporter Infrastructure. SUSE Linux Enterprise 9 with SP1, 2 or 3 running on Intel x86 and EM64T/AMD Opteron 32-bit (32-bit Teradata Tools and Utilities) SUSE Linux Enterprise 9 with SP1, 2 or 3 32-bit running on Intel EM64T and Opteron 64-bit (32-bit Teradata Tools and Utilities) SUSE Linux Enterprise 9 with SP1, 2 or 3 running on Intel EM64T and Opteron (64-bit Teradata Tools and Utilities) SUSE Linux Enterprise 10 with SP1 running on Intel x86and EM64T Opteron 32-bit (32-bit Teradata Tools and Utilities) SUSE Linux Enterprise 10 with SP1 32-bit running on Intel EM64T/Opteron 32-bit (32-bit Teradata Tools and Utilities) SUSE Linux Enterprise 10 with SP1 running on Intel EM64T/Opteron (64-bit) Teradata Tools and Utilities) YES YES NO YES YES NO YES YES NO YES YES NO Teradata Parallel Transporter ICU Library picuc000 YES YES YES YES YES YES Teradata Parallel Transporter tbldc000 YES YES NO YES YES NO Infrastructure Teradata Tools and Utilities Installation Guide for UNIX and Linux 163

164 Chapter 9: Installing on SUSE Linux Client Systems Removing Previous Versions of Software Table 50: Teradata Tools and Utilities supported on UNIX and Linux (continued) Product Teradata Parallel Transporter Load Operator Teradata Parallel Transporter MultiLoad INMOD Adapter Operator 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 Teradata Parallel Transporter Stream Operator Teradata Parallel Transporter Update Operator Package Names plodc000 YES YES YES YES YES YES Loaded as part of Teradata Parallel Transporter Infrastructure. YES YES NO YES YES NO podbcc000 YES NO NO YES YES NO poslc000 YES YES YES YES YES YES poscc000 YES YES NO YES YES NO pinsc000 YES YES NO YES YES NO pselc000 YES YES NO YES YES NO pstmc000 YES YES YES YES YES YES pupdc000 YES YES YES YES YES YES Teradata Query Director qrydir YES YES NO YES YES NO Teradata TPump tpump YES YES NO YES YES NO WebSphere MQ Access Module mqaxsmod YES YES NO YES YES NO SUSE Linux Enterprise 9 with SP1, 2 or 3 running on Intel x86 and EM64T/AMD Opteron 32-bit (32-bit Teradata Tools and Utilities) SUSE Linux Enterprise 9 with SP1, 2 or 3 32-bit running on Intel EM64T and Opteron 64-bit (32-bit Teradata Tools and Utilities) SUSE Linux Enterprise 9 with SP1, 2 or 3 running on Intel EM64T and Opteron (64-bit Teradata Tools and Utilities) SUSE Linux Enterprise 10 with SP1 running on Intel x86and EM64T Opteron 32-bit (32-bit Teradata Tools and Utilities) SUSE Linux Enterprise 10 with SP1 32-bit running on Intel EM64T/Opteron 32-bit (32-bit Teradata Tools and Utilities) SUSE Linux Enterprise 10 with SP1 running on Intel EM64T/Opteron (64-bit) Teradata Tools and Utilities) Removing Previous Versions of Software Prior to the installing the latest Teradata Tools and Utilities, check for any existing software and remove it. Note: If a previous version of cliv2 is installed, it must be uninstalled before installing the newer version. 164 Teradata Tools and Utilities Installation Guide for UNIX and Linux

165 Chapter 9: Installing on SUSE Linux Client Systems Removing Previous Versions of Software Note: An exception is the Teradata Generic Security Services software, it does not have to be uninstalled. Procedure - Removing Previous Versions of Teradata Tools and Utilities Follow these steps to remove previous versions of Teradata Tools and Utilities software. 1 Log on as root and enter the password. 2 List all the installed packages by entering the following command at the prompt: # rpm -qa Or, check to see if a particular package is installed using the command: # rpm -q <rpmname> Table 51: Checking for Previous Versions of Software on Linux To check for a single package... Basic Teradata Query (BTEQ) (32-bit) Named Pipes Access Module (32-bit) ODBC Driver for Teradata Shared Common Components for Internationalization for Teradata (32-bit) Shared Common Components for Internationalization for Teradata (64-bit) Teradata Call-level Interface version 2 (CLIv2) (32-bit) Teradata Call-level Interface version 2 (CLIv2) (64-bit) Teradata Data Connector (32-bit) Teradata FastExport (32-bit) Teradata FastLoad (32-bit) Teradata Generic Security Services (64-bit) Teradata MultiLoad (32-bit) Teradata C Preprocessor2 (32-bit) Teradata C Preprocessor2 (64-bit) Teradata Parallel Transporter API (32-bit) Teradata Parallel Transporter Data Connector Operator (32-bit) Teradata Parallel Transporter DDL Operator (32-bit) Teradata Parallel Transporter Export Operator (32-bit) Teradata Parallel Transporter ICU Library enter... # rpm -q bteq # rpm -q npaxsmod # rpm -q tdodbc # rpm -q tdicu # rpm -q tdicu_64 # rpm -q cliv2 # rpm -q cliv2_64 # rpm -q piom # rpm -q fexp # rpm -q fastld # rpm -q TeraGSS_suselinuxx8664 # rpm -q mload # rpm -q sqlpp # rpm -q sqlpp # rpm -q papic000 # rpm -q pdtcc000 # rpm -q pddlc000 # rpm -q pexpc000 # rpm -q picuc000 Teradata Tools and Utilities Installation Guide for UNIX and Linux 165

166 Chapter 9: Installing on SUSE Linux Client Systems Removing Previous Versions of Software Table 51: Checking for Previous Versions of Software on Linux (continued) To check for a single package... Teradata Parallel Transporter Infrastructure (32-bit) Teradata Parallel Transporter Load Operator (32-bit) Teradata Parallel Transporter ODBC Operator (32-bit) Teradata Parallel Transporter Operator Support Library (32-bit) Teradata Parallel Transporter OS Command Operator (32-bit) Teradata Parallel Transporter SQL Inserter Operator (32- bit) Teradata Parallel Transporter SQL Selector Operator (32- bit) Teradata Parallel Transporter Stream Operator (32-bit) Teradata Parallel Transporter Update Operator (32-bit) Teradata Query Director Teradata TPump (32-bit) WebSphere MQ Access Module (32-bit) enter... # rpm -q tbldc000 # rpm -q plodc000 # rpm -q podbcc000 # rpm -q poslc000 # rpm -q poscc000 # rpm -q pinsc000 # rpm -q pselc000 # rpm -q pstmc000 # rpm -q pupdc000 # rpm -q qrydir # rpm -q tpump # rpm -q mqaxsmod 3 Remove individual packages by entering: # rpm -e <rpmname> Table 52: Uninstalling Previous Versions of Software on Linux To uninstall... Basic Teradata Query BTEQ (32-bit) Named Pipes Access Module (32-bit) ODBC Driver for Teradata Shared Common Components for Internationalization for Teradata (32-bit) Shared Common Components for Internationalization for Teradata (64-bit) Teradata Call-level Interface version 2 (CLIv2) (32-bit) Teradata Call-level Interface version 2 (CLIv2) (64-bit) Teradata Data Connector (32-bit) Teradata FastExport (32-bit) Teradata FastLoad (32-bit) enter... # rpm -e bteq # rpm -e npaxsmod # rpm -e tdodbc # rpm -e tdicu # rpm -e tdicu_64 # rpm -e cliv2 # rpm -e cliv2_64 # rpm -e piom # rpm -e fastexp # rpm -e fastld 166 Teradata Tools and Utilities Installation Guide for UNIX and Linux

167 Chapter 9: Installing on SUSE Linux Client Systems Removing Previous Versions of Software Table 52: Uninstalling Previous Versions of Software on Linux (continued) To uninstall... Teradata Generic Security Services (64-bit) Teradata MultiLoad (32-bit) Teradata C Preprocessor2 (32-bit) Teradata C Preprocessor2 (64-bit) Teradata Parallel Transporter API (32-bit) Teradata Parallel Transporter Data Connector Operator (32-bit) Teradata Parallel Transporter DDL Operator (32-bit) Teradata Parallel Transporter Export Operator (32-bit) Teradata Parallel Transporter ICU Library Teradata Parallel Transporter Infrastructure (32-bit) Teradata Parallel Transporter Load Operator (32-bit) Teradata Parallel Transporter ODBC Operator (32-bit) Teradata Parallel Transporter Operator Support Library (32-bit) Teradata Parallel Transporter OS Command Operator (32-bit) Teradata Parallel Transporter SQL Inserter Operator (32- bit) Teradata Parallel Transporter SQL Selector Operator (32- bit) Teradata Parallel Transporter Stream Operator (32-bit) Teradata Parallel Transporter Update Operator (32-bit) Teradata Query Director Teradata TPump (32-bit) WebSphere MQ Access Module (32-bit) enter... # rpm -e TeraGSS_suselinuxx8664 # rpm -e mload # rpm -e sqlpp # rpm -e sqlpp # rpm -e papic000 # rpm -e pdtcc000 # rpm -e pddlc000 # rpm -e pexpc000 # rpm -e picuc000 # rpm -e tbldc000 # rpm -e plodc000 # rpm -e podbcc000 # rpm -e poslc000 # rpm -e poscc000 # rpm -e pinsc000 # rpm -e pselc000 # rpm -e pstmc000 # rpm -e pupdc000 # rpm -e qrydir # rpm -e tpump # rpm -e mqaxsmod Teradata Tools and Utilities Installation Guide for UNIX and Linux 167

168 Chapter 9: Installing on SUSE Linux Client Systems Installing Teradata Tools and Utilities Installing Teradata Tools and Utilities To install products, run the installation for Teradata Tools and Utilities and select the products you want to install. Installing Teradata Tools and Utilities Products Silently Teradata Tools and Utilities products can be installed silently. Procedure - Installing Teradata Tools and Utilities Products Silently Follow these steps to install Teradata Tools and Utilities products silently. 1 Log on to the Linux client as root. 2 If a /mnt directory does not exist, create one by entering the following command at the prompt: # mkdir /mnt In the command shown, the CD-ROM mount point is /mnt, but an alternate may be used. 3 Insert the installation CD into the CD-ROM drive, then enter the following at the command prompt: # mount /dev/<cdrom device name> /mnt For example, if the CD-ROM device name is cdrom, you would type: # mount /dev/cdrom /mnt In the example, the CD-ROM mount point is /mnt, but an alternate may be entered. 4 To begin the installation process, type: # cd /mnt #./setup.bat A screen display similar to the following appears: Copyright NCR Corporation. All Rights Reserved. Platform: Linux 32bit (i386) Media: Load/Unload Which software do you want to install? 1. TeraGSS - Teradata GSS client package 2. tdicu - Teradata Shared Component for Internationalization 3. tdodbc - Teradata ODBC Driver 4. cliv2 - Teradata CLIv2 5. piom - Teradata Data Connector API 6. npaxsmod - Teradata Named Pipes Access Module 7. mqaxsmod - WebSphere(r) Access Module for Teradata 8. bteq - Teradata BTEQ Application 9. fastexp - Teradata FastExport Utility 10. fastld - Teradata FastLoad Utility 11. mload - Teradata MultiLoad Utility 12. qrydir -Teradata Query Director a. Install all of the above software 168 Teradata Tools and Utilities Installation Guide for UNIX and Linux

169 Chapter 9: Installing on SUSE Linux Client Systems Installing Teradata Tools and Utilities q. Quit the installation Enter one or more selections (separated by space): 5 Software must be installed in the order shown in Software Requirements on page 30. After reviewing product dependencies, enter your selection at the prompt: one or more numbers for the product(s) you want to install, separated by spaces, or a to install all the software, or q to quit the installation 6 Change back to the root directory and unmount the CD by typing: # umount /mnt 7 Remove the installation CD from the CD-ROM drive. Following installation, you may wish to verify that the installation executed successfully. See Verifying the Installation of Individual Products on page 212 and Verifying the Installation Using the CLI Sample Program on page 241. Installing Teradata Tools and Utilities Products Interactively Teradata Tools and Utilities products can be installed interactively. Procedure - Installing Teradata Tools and Utilities Products Interactively Follow these steps to install Teradata Tools and Utilities products interactively. 1 Log on to the Linux client as root. 2 If a /mnt directory does not exist, create one by entering the following command at the prompt: # mkdir /mnt In the command shown, the CD-ROM mount point is /mnt, but an alternate may be used. 3 Insert the installation CD into the CD-ROM drive, then enter the following at the command prompt: # mount /dev/<cdrom device name> /mnt For example: If the CD-ROM device name is cdrom, you would type: # mount /dev/cdrom /mnt In the example, the CD-ROM mount point is /mnt, but an alternate may be entered. 4 Go to the directory where the rpm for the Teradata Tools and Utilities product is present. # cd <rpmname> Table 53: Changing Directories To change to the directory where... Basic Teradata Query (BTEQ) (32-bit) is installed, enter... # cd bteq Teradata Tools and Utilities Installation Guide for UNIX and Linux 169

170 Chapter 9: Installing on SUSE Linux Client Systems Installing Teradata Tools and Utilities Table 53: Changing Directories (continued) To change to the directory where... Named Pipes Access Module (32-bit) ODBC Driver for Teradata Shared Common Components for Internationalization for Teradata Teradata Call-level Interface version 2(CLIv2) (32-bit) Teradata Call-level Interface version 2 (CLIv2) (64-bit) Teradata Data Connector (32-bit) Teradata FastExport (32-bit) Teradata FastLoad (32-bit) Teradata MultiLoad (32-bit) Teradata C Preprocessor2 (32-bit) Teradata C Preprocessor2 (64-bit) Teradata Generic Security Services (64-bit) Teradata Parallel Transporter API (32-bit) Teradata Parallel Transporter Data Connector Operator (32-bit) Teradata Parallel Transporter DDL Operator (32-bit) Teradata Parallel Transporter Export Operator (32-bit) Teradata Parallel Transporter ICU Library (32-bit) Teradata Parallel Transporter Infrastructure (32-bit) Teradata Parallel Transporter Load Operator (32-bit) Teradata Parallel Transporter ODBC Operator (32-bit) Teradata Parallel Transporter Operator Support Library (32-bit) Teradata Parallel Transporter OS Command Operator (32-bit) Teradata Parallel Transporter SQL Inserter Operator (32- bit) Teradata Parallel Transporter SQL Selector Operator (32- bit) Teradata Parallel Transporter Stream Operator (32-bit) Teradata Parallel Transporter Update Operator (32-bit) is installed, enter... # cd npipes # cd tdodbc # cd tdicu # cd cliv2 # cd cliv2 # cd piom # cd fexp # cd fastld # cd mload # cd sqlpp # cd sqlpp # cd TeraGSS # cd papic000 # cd pdtcc000 # cd pddlc000 # cd pexpc000 # cd picuc000 # cd tbldc000 # cd plodc000 # cd podbcc000 # cd poslc000 # cd poscc000 # cd pinsc000 # cd pselc000 # cd pstmc000 # cd pupdc Teradata Tools and Utilities Installation Guide for UNIX and Linux

171 Chapter 9: Installing on SUSE Linux Client Systems Installing Teradata Tools and Utilities Table 53: Changing Directories (continued) To change to the directory where... Teradata Query Director Teradata TPump (32-bit) WebSphere MQ Access Module (32-bit) is installed, enter... # cd qrydir # cd tpump # cd mqaxsmod 5 To install a Teradata Tools and Utilities product use the command: # rpm -ivh <rpmname> Table 54: Installing Teradata Tools and Utilities on Linux To install... Basic Teradata Query (BTEQ) (32- bit) Named Pipes Access Module (32- bit) ODBC Driver for Teradata (32-bit) ODBC Driver for Teradata (64-bit) Shared Common Components for Internationalization for Teradata (32-bit) Shared Common Components for Internationalization for Teradata (64-bit) Teradata Call-level Interface version 2 (CLIv2) (32-bit) Teradata Call-level Interface version 2 (CLIv2) (64-bit) Teradata Data Connector (32-bit) Teradata FastExport (32-bit) Teradata FastLoad (32-bit) Teradata Generic Security Services (64-bit) Teradata MultiLoad (32-bit) Teradata C Preprocessor2 (32-bit) Teradata C Preprocessor2 (64-bit) enter... # rpm -ivh bteq i386.rpm # rpm -ivh npaxsmod i386.rpm # rpm --nodeps -i tdodbc i386.rpm # rpm --nodeps -i tdodbc x8664.rpm # rpm -ivh tdicu i386.rpm # rpm -ivh tdicu_ x8664.rpm # rpm -ivh cliv i386.rpm # rpm -ivh cliv2_ x8664.rpm # rpm -ivh piom i386.rpm # rpm -ivh fexp i386.rpm # rpm -ivh fastld i386.rpm # rpm -ivh TeraGSS_suselinux-x x86_64.rpm # rpm -ivh mload i386.rpm # rpm -ivh sqlpp i386.rpm # rpm -ivh sqlpp x8664.rpm Teradata Tools and Utilities Installation Guide for UNIX and Linux 171

172 Chapter 9: Installing on SUSE Linux Client Systems Installing Teradata Tools and Utilities Table 54: Installing Teradata Tools and Utilities on Linux (continued) To install... Teradata Parallel Transporter API (32-bit) Teradata Parallel Transporter Data Connector Operator (32-bit) Teradata Parallel Transporter DDL Operator (32-bit) Teradata Parallel Transporter Export Operator (32-bit) Teradata Parallel Transporter ICU Library (32-bit) Teradata Parallel Transporter Infrastructure (32-bit) Teradata Parallel Transporter Load Operator (32-bit) Teradata Parallel Transporter ODBC Operator (32-bit) Teradata Parallel Transporter Operator Support Library (32-bit) Teradata Parallel Transporter OS Command Operator (32-bit) Teradata Parallel Transporter SQL Inserter Operator (32-bit) Teradata Parallel Transporter SQL Selector Operator (32-bit) Teradata Parallel Transporter Stream Operator (32-bit) Teradata Parallel Transporter Update Operator (32-bit) Teradata Query Director Teradata TPump (32-bit) WebSphere MQ Access Module (32- bit) enter... #./tptinstall -r papic i386.rpm #./tptinstall -r pdtcc i386.rpm #./tptinstall -r pddlc i386.rpm #./tptinstall -r pexpc i386.rpm #./tptinstall -r picuc i386.rpm #./tptinstall -r tbldc i386.rpm #./tptinstall -r plodc i386.rpm #./tptinstall -r podbcc i386.rpm #./tptinstall -r poslc i386.rpm #./tptinstall -r poscc i386.rpm #./tptinstall -r pinsc i386.rpm #./tptinstall -r pselc i386.rpm #./tptinstall -r pstmc i386.rpm #./tptinstall -r pupdc i386.rpm # rpm -ivh qrydir i386.rpm # rpm -ivh tpump i386.rpm # rpm -ivh mqaxsmod i386.rpm 6 Chapter 9 contains a list of the files in each package. Verify all the files in the package are installed by using the SUSE Package Manager command: # rpm -ql <rpmname> 172 Teradata Tools and Utilities Installation Guide for UNIX and Linux

173 Chapter 9: Installing on SUSE Linux Client Systems Installing Teradata Tools and Utilities Table 55: Verifying the Installation on Linux To verify the installation of... Basic Teradata Query (BTEQ) (32-bit) Named Pipes Access Module (32-bit) ODBC Driver for Teradata Shared Common Components for Internationalization for Teradata (32-bit) Shared Common Components for Internationalization for Teradata (64-bit) Teradata Call-level Interface version 2 (CLIv2) (32- bit) Teradata Call-level Interface version 2 (CLIv2) (64- bit) Teradata Data Connector (32-bit) Teradata FastExport (32-bit) Teradata FastLoad (32-bit) Teradata Generic Security Services (64-bit) Teradata MultiLoad (32-bit) Teradata C Preprocessor (32-bit) Teradata C Preprocessor (64-bit) Teradata Parallel Transporter API (32-bit) Teradata Parallel Transporter Data Connector Operator (32-bit) Teradata Parallel Transporter DDL Operator (32-bit) Teradata Parallel Transporter Export Operator (32- bit) Teradata Parallel Transporter ICU Library (32-bit) Teradata Parallel Transporter Infrastructure (32-bit) Teradata Parallel Transporter Load Operator (32-bit) Teradata Parallel Transporter ODBC Operator (32- bit) Teradata Parallel Transporter Operator Support Library (32-bit) Teradata Parallel Transporter OS Command Operator (32-bit) enter... # rpm -ql bteq # rpm -ql npaxsmod # rpm -ql tdodbc # rpm -ql tdicu # rpm -ql tdicu_64 # rpm -ql cliv2 # rpm -ql cliv2_64 # rpm -ql piom # rpm -ql fastexp # rpm -ql fastld # rpm -ql TeraGSS_suselinuxx8664 # rpm -ql mload # rpm -ql sqlpp # rpm -ql sqlpp # rpm -ql papic000 # rpm -ql pdtc000 # rpm -ql pddlc000 # rpm -ql pexc000 # rpm -ql picuc000 # rpm -ql tbldc000 # rpm -ql plodc000 # rpm -ql podbcc000 # rpm -ql poslc000 # rpm -ql poscc000 Teradata Tools and Utilities Installation Guide for UNIX and Linux 173

174 Chapter 9: Installing on SUSE Linux Client Systems Installing the Teradata Driver for the JDBC Interface Table 55: Verifying the Installation on Linux (continued) To verify the installation of... Teradata Parallel Transporter SQL Inserter Operator (32-bit) Teradata Parallel Transporter SQL Selector Operator (32-bit) Teradata Parallel Transporter Stream Operator (32- bit) Teradata Parallel Transporter Update Operator (32- bit) Teradata Query Director Teradata TPump (32-bit) WebSphere MQ Access Module (32-bit) enter... # rpm -ql pinsc000 # rpm -ql pselc000 # rpm -ql pstmc000 # rpm -ql pupdc000 # rpm -ql qrydir # rpm -ql tpump # rpm -ql mqaxsmod 7 Change back to the root directory and unmount the CD by entering the following command at the prompt: # umount /mnt 8 Remove the installation CD from the CD-ROM drive. Installing the Teradata Driver for the JDBC Interface The Teradata Driver for the JDBC Interface can 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. 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 Teradata Access Module for JMS The Teradata Access Module for JMS version is available on the following CDs: 174 Teradata Tools and Utilities Installation Guide for UNIX and Linux

175 Chapter 9: Installing on SUSE Linux Client Systems Adding CLI User Exit Functions Load/Unload CD #2 for HP-UX Load/Unload CD #3 for Sun Solaris SPARC The Teradata Access Module for JMS version for IBM AIX and Linux is being released asynchronously to Teradata Tools and Utilities IBM AIX and Linux versions of the Teradata Access Module for Teradata can be downloaded from the Teradata Download Center at: --> Support Services --> Downloads --> Drivers, UDFs, and Toolbox --> Teradata Toolbox --> JMS Access Module Adding CLI User Exit Functions CLI User Exit functions are general purpose facilities that may be added to the CLI workstation architecture on Linux systems. These functions allow user-defined processing to take place. Procedure - Adding CLI User Exit Functions to a SUSE Linux Client Follow these steps to add CLI User Exit functions to a SUSE Linux client. 1 Change directories to /opt/teradata/client/sample, using the following command: # cd /opt/teradata/client/sample 2 Modify the CliLgnEx.c or CliPPS.c file in the sample directory. 3 Compile and link using either the 64-bit version or the 32-bit version of the makefile to create a new shared object, libtdusr.so. This command compiles the 32-bit version: # make -f maketdusr.lx Note: On 64-bit Linux, the compiler will always generate 64-bit binaries. The 32-bit makefile is not supported on 64-bit Linux platforms. 4 Move the libtdusr.so file into the /usr/lib directory. The CLIv2 libcliv2.so should exist in the same directory. For more information on CLI User Exit Functions, see Teradata Call-Level Interface Version 2 Reference for Network-Attached Systems, Appendix D. Teradata Tools and Utilities Installation Guide for UNIX and Linux 175

176 Chapter 9: Installing on SUSE Linux Client Systems Adding CLI User Exit Functions 176 Teradata Tools and Utilities Installation Guide for UNIX and Linux

177 CHAPTER 10 Configuring Teradata Tools and Utilities Several of the Teradata Tools and Utilities products require that you manually configure the products prior to operating the product. Configuration information or procedures for these products are contained in this chapter: Configuring Environment Variables for CLIv2 and Data Connector Configuring the ODBC Driver for Teradata Configuring Teradata Access Module for JMS Configuring Teradata Parallel Transporter Configuring Environment Variables for CLIv2 and Data Connector Setting the Environment Variables Environment variables must be set to reflect the location of the CLIv2 and Data Connector libraries. These products are loaded as dependencies for all Teradata Tools and Utilities products. To set CLIv2 and Data Connector environment variables perform the following procedures. Setting MP-RAS Environment Variables for CLIv2 and Data Connector If CLIv2 and Data Connector were loaded on MP-RAS, set the environment variables for those products. Make sure the LD_LIBRARY_PATH includes the./usr/lib path, where CLIv2 and Data Connector software files: For Bourne shell systems, use this command to add /usr/lib to the LD_LIBRARY_PATH: LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/usr/lib; export LD_LIBRARY_PATH For C shell systems, use this command to add /usr/lib to the LD_LIBRARY_PATH: setenv LD_LIBRARY_PATH $LD_LIBRARY_PATH":/usr/lib" Setting IBM AIX Environment Variables for CLIv2, Data Connector, and TeraGSS If CLIv2 and Data Connector were loaded on IBM AIX, set the environment variables for those products. Make sure the LIBPATH includes the /usr/lib path. For Bourne shell systems, use this command to add /usr/lib to the LIBPATH: LIBPATH=$LIBPATH:/usr/lib;export LIBPATH Teradata Tools and Utilities Installation Guide for UNIX and Linux 177

178 Chapter 10: Configuring Teradata Tools and Utilities Configuring Environment Variables for CLIv2 and Data Connector For C shell systems, use this command to add /usr/lib to the LIBPATH: setenv LIBPATH $LIBPATH:/usr/lib To ensure that IBM AIX can find the correct version of libtdgss.so, make sure the LIBPATH includes the following path as the first path in line. For 64-bit applications: usr/teragss/aix-power/client/lib Setting HP-UX Environment Variables for CLIv2 and Data Connector If CLIv2 and Data Connector were loaded on HP-UX, set the environment variables for those products. Make sure the SHLIB_PATH includes the /usr/lib path, where the CLIv2 and Data Connector files are installed. For Bourne shell users, use this command to add /usr/lib to the SHLIB_PATH. SHLIB_PATH=$LD_LIBRARY_PATH:/usr/lib; export SHLIB_PATH For C shell systems, use this command to add /usr/lib to the SHLIB_PATH setenv SHLIB_PATH $SHLIB_PATH:/usr/lib Setting Solaris Environment Variables for CLIv2 and Data Connector If CLIv2 and Data Connector were loaded on Solaris, set the environment variables for those products. Make sure the LD_LIBRARY_PATH includes the basedir path, where basedir is the directory path of the CLIv2 and Data Connector software files: For Bourne shell systems, use this command to add basedir path to the LD_LIBRARY_PATH: LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/basedir: export LD_LIBRARY_PATH For C shell systems, use this command to add basedir path to the LD_LIBRARY_PATH: setenv LD_LIBRARY_PATH $LD_LIBRARY_PATH":/basedir" Setting Linux Environment Variables for CLIv2 If CLIv2 was loaded on Linux, set the environment variables for those products. Make sure the LD_LIBRARY_PATH includes the /usr/lib path, where the CLIv2 software files are installed. For Bash and Bourne shell users, use this command to add /usr/lib path to the LD_LIBRARY_PATH: LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/usr/lib; export LD_LIBRARY_PATH For C shell users, use this command to add /usr/lib path to the PATH: setenv LD_LIBRARY_PATH $LD_LIBRARY_PATH":/usr/lib" 178 Teradata Tools and Utilities Installation Guide for UNIX and Linux

179 Chapter 10: Configuring Teradata Tools and Utilities Configuring the ODBC Driver for Teradata Configuring the ODBC Driver for Teradata This section describes how to configure the ODBC Driver for Teradata for each of the UNIX and Linux operating systems. Find the Configuration section for your platform and perform the procedures to configure the ODBC Driver for Teradata. After installing the ODBC Driver for Teradata, you must configure: Environment Variables The odbc.ini Template ODBC Data Sources For complete configuration information on the ODBC Driver for Teradata, see the ODBC Driver for Teradata User Guide. Configuring the ODBC Driver for MP-RAS Follow the procedures in this section to configure the ODBC Driver for Teradata on MP-RAS. Copying the Template odbc.ini File A template odbc.ini is in the root directory where the ODBC Driver for Teradata software is installed. Before using an ODBC driver, copy this file to your home directory and rename it.odbc.ini. The default location of the.odbc.ini file is your home directory, but you can specify a different path for the file using the ODBCINI environment variable. The.odbc.ini file is a hidden file. To copy the.ini file to the home directory, enter the following command: cp /usr/odbc/odbc.ini $HOME/.odbc.ini Setting the Environment Variables You must set the environment variable to reflect the location of the ODBC libraries. To set the environment variable: 1 Set LD_LIBRARY_PATH for MP-RAS. 2 If the ODBC driver was installed in /usr/odbc set LD_LIBRARY_PATH to: /usr/odbc/lib:/usr/odbc/drivers Note: An optional environment variable ODBCINI is available that allows an application to use an alternate odbc.ini file. When specifying an alternate file, the full path name must be used. Teradata Tools and Utilities Installation Guide for UNIX and Linux 179

180 Chapter 10: Configuring Teradata Tools and Utilities Configuring the ODBC Driver for Teradata Configuring the ODBC Driver for IBM AIX Follow the procedures in this section to configure the ODBC Driver for Teradata on IBM AIX. Copying the Template odbc.ini File A template odbc.ini is in the root directory where the ODBC Driver for Teradata software is installed. Before using an ODBC driver, copy this file to your home directory and rename it.odbc.ini. The default location of the.odbc.ini file is your home directory, but you can specify a different path for the file using the ODBCINI environment variable. The.odbc.ini file is a hidden file. To copy the.ini file to the home directory, enter the following command: cp /usr/odbc/odbc.ini $HOME/.odbc.ini Setting the Environment Variables You must set the environment variable to reflect the location of the ODBC libraries. To set the environment variable: 1 Set LIBPATH for IBM AIX. 2 If the ODBC driver was installed in /usr/odbc set LIBPATH to: /usr/odbc/lib:/usr/odbc/drivers Note: An optional environment variable ODBCINI is available that allows an application to use an alternate odbc.ini file. When specifying an alternate file, the full path name must be used. Configuring the ODBC Driver for HP-UX Follow the procedures in this section to configure the ODBC Driver for Teradata on HP-UX. Copying the Template odbc.ini File A template odbc.ini is in the root directory where the ODBC Driver for Teradata software is installed. Before using an ODBC driver, copy this file to your home directory and rename it.odbc.ini. The default location of the.odbc.ini file is your home directory, but you can specify a different path for the file using the ODBCINI environment variable. The.odbc.ini file is a hidden file. To copy the.ini file to the home directory, enter the following command: cp /usr/odbc/odbc.ini $HOME/.odbc.ini 180 Teradata Tools and Utilities Installation Guide for UNIX and Linux

181 Chapter 10: Configuring Teradata Tools and Utilities Configuring the ODBC Driver for Teradata Setting the Environment Variables You must set the environment variable to reflect the location of the ODBC libraries. To set the environment variable: 1 Set SHLIB_PATH for HP-UX. 2 If the ODBC driver was installed in /usr/odbc set SHLIB_PATH to: /usr/odbc/lib:/usr/odbc/drivers Note: An optional environment variable ODBCINI is available that allows an application to use an alternate odbc.ini file. When specifying an alternate file, the full path name must be used. Configuring the ODBC Driver for Solaris Follow the procedures in this section to configure the ODBC Driver for Teradata on Solaris. Copying the Template odbc.ini File A template odbc.ini is in the root directory where the ODBC Driver for Teradata software is installed. Before using an ODBC driver, copy this file to your home directory and rename it.odbc.ini. The default location of the.odbc.ini file is your home directory, but you can specify a different path for the file using the ODBCINI environment variable. The.odbc.ini file is a hidden file. To copy the.ini file to the home directory, enter the following command: cp /opt/teradata/odbc/odbc.ini $HOME/.odbc.ini Setting the Environment Variables You must set the environment variable to reflect the location of the ODBC libraries. To set the environment variable perform the following procedure: 1 Set LD_LIBRARY_PATH for Solaris. 2 If the ODBC driver was installed in /usr/odbc set LD_LIBRARY_PATH to: /usr/odbc/lib:/usr/odbc/drivers Note: An optional environment variable ODBCINI is available that allows an application to use an alternate odbc.ini file. When specifying an alternate file, the full path name must be used. Configuring the ODBC Driver for Linux Follow the procedures in this section to configure the ODBC Driver for Teradata on Linux. Copying the Template odbc.ini File A template odbc.ini is in the root directory where the ODBC Driver for Teradata software is installed. Before using an ODBC driver, copy this file to your home directory and rename it.odbc.ini. Teradata Tools and Utilities Installation Guide for UNIX and Linux 181

182 Chapter 10: Configuring Teradata Tools and Utilities Configuring Teradata Access Module for JMS The default location of the.odbc.ini file is your home directory, but you can specify a different path for the file using the ODBCINI environment variable. The.odbc.ini file is a hidden file. To copy the.ini file to the home directory, enter the following command: cp /usr/odbc/odbc.ini $HOME/.odbc.ini Setting the Environment Variables for the ODBC Libraries You must set the environment variable to reflect the location of the ODBC libraries. Procedure - Setting the Environment Variables for the ODBC Libraries Follow these steps to set the environment variable perform the following procedure: 1 Set LD_LIBRARY_PATH for Linux. 2 If the ODBC driver was installed in /usr/odbc set LD_LIBRARY_PATH to: /usr/odbc/lib:/usr/odbc/drivers Note: An optional environment variable ODBCINI is available that allows an application to use an alternate odbc.ini file. When specifying an alternate file, the full path name must be used. 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 directory for Teradata Access Module for JMS is /opt/teradata/client/jmsaxsmod. Use an editor, like vi, to open the readme file. Configuring Teradata Parallel Transporter This section describes how to configure the Teradata Parallel Transporter for each of the UNIX operating systems. Find the Configuration section for your platform and perform the procedures to configure the Teradata Parallel Transporter. For complete configuration information on the Teradata Parallel Transporter, see: Teradata Parallel Transporter Reference. Configuring Teradata Parallel Transporter for MP-RAS Follow the procedures in this section to configure the Teradata Parallel Transporter on MP- RAS. Teradata Parallel Transporter configuration normally requires modifications to one file in the Teradata Parallel Transporter directory: The configuration file: twbcfg.ini 182 Teradata Tools and Utilities Installation Guide for UNIX and Linux

183 Chapter 10: Configuring Teradata Tools and Utilities Configuring Teradata Parallel Transporter Additionally, your system configuration may require modification of the following parameters: Shared memory parameters: SHMMAX, SHMSEG and SHMMNI Semaphore parameters: SEMMNI, SEMMNS, SEMMNU and SEMMAP You may need to modify the following environment variables: TWB_ROOT PATH LD_LIBRARY_PATH NLSPATH Changing the twbcfg.ini File After the Teradata Parallel Transporter Infrastructure package is installed, you may edit the configuration file, $TWB_ROOT/twbcfg.ini. The configuration file contains default directory for checkpoint and logs. $TWB_ROOT is the environment variable that contains the value for the Teradata Parallel Transporter installation directory. You must be the root user in order to modify the configuration file. 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. For example, if the logs directory is full, then you should change the logs directory to another directory with free disk space. No kernel rebuild or reboot is required after making the change in the configuration file. Configuration File Defaults The configuration file contains parameters that determine the default behavior for Teradata Parallel Transporter Infrastructure, such as: Default checkpoint directory Default log directory An example of the Teradata Parallel Transporter configuration file defaults is shown in the following: CheckpointDirectory='/usr/tbuild/ /checkpoint' LogDirectory='/usr/tbuild/ /logs' CheckpointDirectory refers to the directory that contains the checkpoint files for Teradata Parallel Transporter jobs. LogDirectory refers to the directory that contains the binary logs for Teradata Parallel Transporter jobs. Each Teradata Parallel Transporter job creates a job log in the jobs directory. Refer to the Teradata Parallel Transporter Reference manual on how to read the job log. Teradata Tools and Utilities Installation Guide for UNIX and Linux 183

184 Chapter 10: Configuring Teradata Tools and Utilities Configuring Teradata Parallel Transporter Setting the Shared Memory Teradata Parallel Transporter Parameters The Teradata Parallel Transporter Infrastructure installation process checks the values of the following shared memory parameters for the required minimum value: SHMMAX (set to ) SHMSEG (set to 10) SHMMNI (set to 200) Note: The Teradata Parallel Transporter Infrastructure installation does not support a formula value for a kernel parameter. If the value for a kernel parameter is less than the required minimum value, the installation will recommend increasing the value to the minimum value. The SHMMAX value determines the maximum size of a shared memory segment. The SHMSEG value determines the maximum number of segments that a process can allocate. The SHMMNI value determines the system wide limit on the number of shared memory segments that can be created. If any of the above shared memory parameter is less than the minimum value, the Teradata Parallel Transporter Infrastructure installation recommends increasing the shared memory parameter to the minimum value using the idtune command as the root user. Here is an example on how to check the value of the SHMSEG parameter: # /etc/conf/bin/idtune -g SHMSEG Here is an example on how to increase the SHMSEG parameter to 10: # /etc/conf/bin/idtune -f SHMSEG 10 After the shared memory parameters are changed, a kernel rebuild is required using the idbuild command as the root user. Here is an example on how to rebuild the kernel: # /etc/conf/bin/idbuild After the kernel rebuild, a reboot on the system is required using the shutdown command as the root user. Here is an example on how to shutdown the system in 60 seconds: # cd; /usr/sbin/shutdown -y -g60 -i6 Setting the Semaphore Parameters The Teradata Parallel Transporter Infrastructure installation process checks the values of the following semaphore parameters and increases them if they are not set properly: SEMMNI (set to 1000) SEMMNS (set to 1000) SEMMAP (set to 1000) SEMMNU (set to 2500) Note: The Teradata Parallel Transporter Infrastructure installation does not support a formula value for a kernel parameter. If the value for a kernel parameter is less than the 184 Teradata Tools and Utilities Installation Guide for UNIX and Linux

185 Chapter 10: Configuring Teradata Tools and Utilities Configuring Teradata Parallel Transporter required minimum value, the installation will recommend increasing the value to the minimum value. Most significant is the SEMMNS parameter, which determines the number of semaphores in the entire system. The default configuration allows 1000 semaphores in concurrent use. Setting the Environment Variables The Teradata Parallel Transporter Infrastructure installation updates the following environment variables in the system /etc/profile and /etc/.login files: Environment Variable TWB_ROOT PATH LD_LIBRARY_PATH NLSPATH Update to Environment Variable Set to the Teradata Warehouse Builder installation directory. Add $TWB_ROOT/bin to the front of the PATH environment variable. Add $TWB_ROOT/lib to the front of the LD_LIBRARY_PATH environment variable. Add $TWB_ROOT/msg/%N to the front of the NLSPATH environment variable. The updates to the environment variables are effective in the next login only if the Teradata Parallel Transporter Infrastructure package is installed. The updates to the environment variables allow users to run the installed version of Teradata Parallel Transporter. If the Teradata Parallel Transporter API package is installed, then the LD_LIBRARY_PATH and NLSPATH environment variables must be updated manually. The environment variables can be updated on the command line, in the user's profile, or in the system profile. If the environment variables are updated on the command line, then the updates are effective only for the current session. If the environment variables are updated in the user's profile, then the updates are effective every time that particular user logs in. If the environment variables are updated in the system profile, then the updates are effective every time any user logs in. Note: Users must use the updates to the environment variables in order to run the installed version of Teradata Parallel Transporter properly. Note: If users do not use the updates to the environment variables, then they will not be able to run the installed version of Teradata Parallel Transporter properly. If users do not use the updates to the environment variables, then here are the commands to setup the environment variables: For Bourne and Korn shell users: How to set the TWB_ROOT environment variable: # TWB_ROOT=<Teradata Parallel Transporter installation directory> # export TWB_ROOT Teradata Tools and Utilities Installation Guide for UNIX and Linux 185

186 Chapter 10: Configuring Teradata Tools and Utilities Configuring Teradata Parallel Transporter <Teradata Parallel Transporter installation directory> is the Teradata Parallel Transporter installation directory. You can find out the Teradata Parallel Transporter installation directory by running the /usr/bin/twbpkgrm tool. How to update the PATH environment variable: # PATH=$TWB_ROOT/bin:$PATH # export PATH How to update the LD_LIBRARY_PATH environment variable: # LD_LIBRARY_PATH=$TWB_ROOT/lib:$LD_LIBRARY_PATH # export LD_LIBRARY_PATH How to update the NLSPATH environment variable: # NLSPATH=$TWB_ROOT/msg/%N:$NLSPATH # export NLSPATH For C-shell users: How to set the TWB_ROOT environment variable: # setenv TWB_ROOT <Teradata Parallel Transporter installation directory> <Teradata Parallel Transporter installation directory> is the Teradata Parallel Transporter installation directory. You can find out the Teradata Parallel Transporter installation directory by running the /usr/bin/twbpkgrm tool. How to update the PATH environment variable: # setenv PATH $TWB_ROOT"/bin:$PATH" How to update the LD_LIBRARY_PATH environment variable: # setenv LD_LIBRARY_PATH $TWB_ROOT"/lib:$LD_LIBRARY_PATH" How to update the NLSPATH environment variable: # setenv NLSPATH $TWB_ROOT"/msg/%N:$NLSPATH" Switching the IPC Memory Choice to Shared Memory Here are the steps to switch the IPC memory choice to shared memory: Procedure - Switching the IPC Memory Choice to Shared Memory Follow these steps to switch the IPC Memory Choice to Shared Memory: 1 Log in as root user. 2 Change directory to the Teradata Parallel Transporter install directory. 3 Remove the mmap directory using this command: # rm -rf mmap After following the above steps, Teradata Parallel Transporter will use shared memory as the IPC memory choice. The change does not require a kernel rebuild or a reboot. 186 Teradata Tools and Utilities Installation Guide for UNIX and Linux

187 Chapter 10: Configuring Teradata Tools and Utilities Configuring Teradata Parallel Transporter Switching the IPC Memory Choice to Memory Mapped File Here are the steps to switch the IPC memory choice to memory mapped file: Procedure - Switching the IPC Memory Choice to Shared Memory Follow these steps to switch the IPC Memory Choice to Shared Memory: 1 Log in as root user. 2 Change directory to the Teradata Parallel Transporter install directory. 3 Create the mmap directory with 777 permission using these commands: # mkdir mmap # chmod 777 mmap After following the above steps, Teradata Parallel Transporter will use memory mapped file as the IPC memory choice. The change does not require a kernel rebuild or a reboot. Uninstalling Uninstalling any or all of the components in Teradata Parallel Transporter requires no input from the installer. Procedure - Uninstalling a Teradata Parallel Transporter Package Follow these steps to uninstall a Teradata Parallel Transporter package. 1 Log on as root user and enter the password. 2 Use the command: pkgrm <package name> or, from the main sysadm menu, select Software, then Remove, and follow the instructions on the screen. or, run /usr/bin/twbpkgrm and follow the instructions. See section Removing Teradata Warehouse Builder and Teradata Parallel Transporter Packages on page 52 for information on how to use /usr/bin/twbpkgrm to uninstall a Teradata Parallel Transporter package. Configuring Teradata Parallel Transporter for IBM AIX Follow the procedures in this section to configure the Teradata Parallel Transporter on IBM AIX. Teradata Parallel Transporter configuration normally requires modifications to one file in the Teradata Parallel Transporter installation directory: The configuration file: twbcfg.ini Teradata Tools and Utilities Installation Guide for UNIX and Linux 187

188 Chapter 10: Configuring Teradata Tools and Utilities Configuring Teradata Parallel Transporter You may need to modify the following environment variables: TWB_ROOT PATH LIBPATH NLSPATH Changing the twbcfg.ini File After the Teradata Parallel Transporter Infrastructure package is installed, the configuration file, $TWB_ROOT/twbcfg.ini, can be edited to change the default directory for checkpoint and logs. The $TWB_ROOT environment variable contains the installation directory for Teradata Parallel Transporter. To make a change in this configuration file, log on as the root user, and use an editor to modify the file. A typical reasons for modifying the file is to change the logs directory to another directory with free disk space, if the log is full. No kernel rebuild or reboot is required after making the change in the configuration file. Configuration File Defaults The configuration file contains parameters that determine the default behavior for Teradata Parallel Transporter Infrastructure, such as: Default checkpoint directory Default log directory Here is an example that shows the Teradata Parallel Transporter configuration file defaults: CheckpointDirectory='/usr/tbuild/ /checkpoint' LogDirectory='/usr/tbuild/ /logs' CheckpointDirectory refers to the directory that contains the checkpoint files for Teradata Parallel Transporter jobs LogDirectory refers to the directory that contains the binary logs for Teradata Parallel Transporter jobs. Each Teradata Parallel Transporter job creates a job log in the jobs directory. Refer to the Teradata Parallel Transporter Reference on how to read the job log. Setting the Environment Variables The Teradata Parallel Transporter Infrastructure installation updates the following environment variables in the system /etc/profile and /etc/csh.login files: Environment Variable TWB_ROOT PATH Update to Environment Variable Set to the Teradata Parallel Transporter installation directory. Add $TWB_ROOT/bin to the front of the PATH environment variable. 188 Teradata Tools and Utilities Installation Guide for UNIX and Linux

189 Chapter 10: Configuring Teradata Tools and Utilities Configuring Teradata Parallel Transporter Environment Variable LIBPATH NLSPATH Update to Environment Variable Add $TWB_ROOT/lib to the front of the LIBPATH environment variable. Add $TWB_ROOT/msg/%N to the front of the NLSPATH environment variable. The updates to the environment variables are effective in the next login only if the Teradata Parallel Transporter Infrastructure package is installed. The updates to the environment variables allow users to run the installed version of Teradata Parallel Transporter. If the Teradata Parallel Transporter API package is installed, then the LIBPATH and NLSPATH environment variables must be updated manually. The 32-bit files are in $TWB_ROOT/lib and $TWB_ROOT/msg. The 64-bit files are in $TWB_ROOT/lib64 and $TWB_ROOT/msg64. The environment variables can be updated on the command line, in the user's profile, or in the system profile. If the environment variables are updated on the command line, then the updates are effective only for the current session. If the environment variables are updated in the user's profile, then the updates are only effective every time that particular user logs in. If the environment variables are updated in the system profile, then the updates are effective every time any user logs in. Note: Users must use the updates to the environment variables in order to run the installed version of Teradata Parallel Transporter properly. Note: If users do not use the updates to the environment variables, then they will not be able to run the installed version of Teradata Parallel Transporter properly. If users do not use the updates to the environment variables, then here are the commands to setup the environment variables: For Bourne and Korn shell users: How to set the TWB_ROOT environment variable: # TWB_ROOT=<Teradata Parallel Transporter installation directory> # export TWB_ROOT <Teradata Parallel Transporter installation directory> is the Teradata Parallel Transporter installation directory. You can find out the Teradata Parallel Transporter installation directory by running the /usr/bin/twbpkgrm tool. How to update the PATH environment variable: # PATH=$TWB_ROOT/bin:$PATH # export PATH How to update the LIBPATH environment variable: # LIBPATH=$TWB_ROOT/lib:$LIBPATH # export LIBPATH How to update the NLSPATH environment variable: Teradata Tools and Utilities Installation Guide for UNIX and Linux 189

190 Chapter 10: Configuring Teradata Tools and Utilities Configuring Teradata Parallel Transporter # NLSPATH=$TWB_ROOT/msg/%N:$NLSPATH # export NLSPATH For C-shell users: How to set the TWB_ROOT environment variable: # setenv TWB_ROOT <Teradata Parallel Transporter installation directory> <Teradata Parallel Transporter installation directory> is the Teradata Parallel Transporter installation directory. You can find out the Teradata Parallel Transporter installation directory by running the /usr/bin/twbpkgrm tool. How to update the PATH environment variable: # setenv PATH $TWB_ROOT"/bin:$PATH" How to update the LIBPATH environment variable: # setenv LIBPATH $TWB_ROOT"/lib:$LIBPATH" How to update the NLSPATH environment variable: # setenv NLSPATH $TWB_ROOT"/msg/%N:$NLSPATH" Switching the IPC Memory Choice to Shared Memory Procedure - Switching the IPC Choice to Shared Memory Follow these steps to switch the IPC Memory Choice to Shared Memory: 1 Log in as root user. 2 Change directory to the Teradata Parallel Transporter install directory. 3 Remove the mmap directory using this command: # rm -rf mmap After following the above steps, Teradata Parallel Transporter will use shared memory as the IPC memory choice. The change does not require a kernel rebuild or a reboot. Switching the IPC Memory Choice to Memory Mapped File Procedure - Switching the IPC Choice to Memory Mapped File Follow these steps to switch the IPC Memory Choice to Memory Mapped File: 1 Log in as root user. 2 Change directory to the Teradata Parallel Transporter install directory. 3 Create the mmap directory with 777 permission using these commands: # mkdir mmap # chmod 777 mmap After following the above steps, Teradata Parallel Transporter will use memory mapped file as the IPC memory choice. 190 Teradata Tools and Utilities Installation Guide for UNIX and Linux

191 Chapter 10: Configuring Teradata Tools and Utilities Configuring Teradata Parallel Transporter The change does not require a kernel rebuild or a reboot. Uninstalling There are two ways to uninstall Teradata Parallel Transporter software. The first way is to uninstall the software using the twbpkgrm command. Procedure - Uninstalling Teradata Parallel Transporter Software Using twbpkgrm Follow these steps to uninstall Teradata Parallel Transporter software using the twbpkgrm program. 1 Log on as root and enter the password. 2 Run: /usr/bin/twbpkgrm and follow the instructions. See Removing Teradata Warehouse Builder and Teradata Parallel Transporter Packages on page 52 for information on using /usr/bin/twbpkgrm. The second way to uninstall Teradata Parallel Transporter software is to use the installp command. Procedure - Uninstalling Teradata Parallel Transporter Software Using installp Follow these steps to uninstall Teradata Parallel Transporter software using the installp program. 1 Log on as root and enter the password. 2 List all installed packages by entering the following command at the prompt: /usr/bin/lslpp -l Alternately, you can check to see if a specific package is installed by typing: /usr/bin/lslpp -l <PkgName> 3 Following the order that the next section describes, remove the package by typing: /usr/sbin/installp -u <PkgName> Order to Uninstall Packages Remove these packages first, in any order: pinsc000 pselc000 pddlc000 podbcc000 poscc000 pdtcc000 pexpc000 plodc000 Teradata Tools and Utilities Installation Guide for UNIX and Linux 191

192 Chapter 10: Configuring Teradata Tools and Utilities Configuring Teradata Parallel Transporter pstmc000 pupdc000 Remove these packages next, in the following order: poslc000 tbldc000 picuc000 Configuring Teradata Parallel Transporter for HP-UX Follow the procedures in this section to configure the Teradata Parallel Transporter on HP- UX. The Teradata Parallel Transporter configuration normally requires modifications to only one file in the Teradata Parallel Transporter installation directory: The configuration file: twbcfg.ini Additionally, the system configuration may require modification of the following parameters: Shared memory parameters: shmmax, and shmseg Semaphore parameters: semmni, semmns, semmnu and semmap The following environment variables may also need to be modified: TWB_ROOT PATH SHLIB_PATH NLSPATH Changing the twbcfg.ini File After the Teradata Parallel Transporter Infrastructure package is installed, the configuration file, $TWB_ROOT/twbcfg.ini, can be edited to change the default directory for checkpoint and logs. The $TWB_ROOT environment variable contains the installation directory for Teradata Parallel Transporter. To make a change in this configuration file, log on as the root user, and use an editor to modify the file. A typical reasons for modifying the file is to change the logs directory to another directory with free disk space, if the log is full. No kernel rebuild or reboot is required after making the change in the configuration file. Configuration File Defaults The configuration file contains parameters that determine the default behavior for Teradata Parallel Transporter Infrastructure, such as: Default checkpoint directory Default log directory 192 Teradata Tools and Utilities Installation Guide for UNIX and Linux

193 Chapter 10: Configuring Teradata Tools and Utilities Configuring Teradata Parallel Transporter An example of the Teradata Parallel Transporter configuration file defaults is shown in the following: CheckpointDirectory='/usr/tbuild/ /checkpoint' LogDirectory='/usr/tbuild/ /logs' CheckpointDirectory refers to the directory that contains the checkpoint files for Teradata Parallel Transporter jobs LogDirectory refers to the directory that contains the binary logs for Teradata Parallel Transporter jobs. Each Teradata Parallel Transporter job creates a job log in the jobs directory. Refer to the Teradata Parallel Transporter Reference manual on how to read the job log. Setting the Shared Memory Parameters The Teradata Parallel Transporter Infrastructure installation process checks the values of the following shared memory parameters for the required minimum values: shmmax (set to ) shmseg (set to 10) shmmni (set to 200) semmnu (set to 2500) Note: The Teradata Parallel Transporter Infrastructure installation does not support a formula value for a kernel parameter. If the value for a kernel parameter is less than the required minimum value, the installation will recommend increasing the value to the minimum value. The shmmax value determines the maximum size of a shared memory segment. The shmseg value determines the maximum number of segments that a process can allocate. The shmmni value determines the system wide limit on the number of shared memory segments that can be created. If any of the above shared memory parameter is less than the minimum value, the Teradata Parallel Transporter Infrastructure installation recommends increasing the shared memory parameter to the minimum value using the kmtune command as the root user. Here is an example on how to check the shmseg parameter: # /usr/sbin/kmtune -q shmseg Here is an example on how to increase the shmseg parameter to 10: # /usr/sbin/kmtune -s shmseg=10 After the shared memory parameters are changed, a kernel rebuild may be required using the mk_kernel command as the root user. Here is an example on how to rebuild the kernel: # /usr/sbin/mk_kernel After rebuilding the kernel, save the current vmunix file: # cp /stand/vmunix /stand/vmunix.prev Then, move the new vmunix file into the /stand directory: Teradata Tools and Utilities Installation Guide for UNIX and Linux 193

194 Chapter 10: Configuring Teradata Tools and Utilities Configuring Teradata Parallel Transporter # mv /stand/build/vmunix_test /stand/vmunix Lastly, reboot the machine. Here is a sample command to reboot: # /usr/sbin/reboot Note: If there is a change to the kernel value, the following kernel parameter requires a kernel rebuild and a reboot: shmmni Note: If there is a change to the kernel value, the following kernel parameter does not require a kernel rebuild or a reboot: shmmax shmseg Setting the Semaphore Parameters The Teradata Parallel Transporter Infrastructure installation process checks the values of the following semaphore parameters and increases them if they are not set properly: semmni (set to 1000) semmns (set to 1000) semmap (set to 1000) semmnu (set to 2500) Note: The Teradata Parallel Transporter Infrastructure installation does not support a formula value for a kernel parameter. If the value for a kernel parameter is less than the required minimum value, the installation will recommend increasing the value to the minimum value. Most significant is the semmns parameter, which determines the number of semaphores in the entire system. The default configuration allows 1000 semaphores in concurrent use. If any of the above semaphore parameter is less than the minimum value, the Teradata Parallel Transporter Infrastructure installation recommends increasing the semaphore parameter to the minimum value using the kmtune command as the root user. Here is an example on how to increase the semmap parameter to 1000: # /usr/sbin/kmtune -s semmap=1000 After the semaphore parameters are changed, a kernel rebuild is required using the mk_kernel command as the root user. Here is an example on how to rebuild the kernel: # /usr/sbin/mk_kernel After rebuilding the kernel, save the current vmunix file: # cp /stand/vmunix /stand/vmunix.prev Then, move the new vmunix file into the /stand directory: # mv /stand/build/vmunix_test /stand/vmunix Lastly, reboot the machine. Here is a sample command to reboot: # /usr/sbin/reboot 194 Teradata Tools and Utilities Installation Guide for UNIX and Linux

195 Chapter 10: Configuring Teradata Tools and Utilities Configuring Teradata Parallel Transporter Note: If there is a change to the kernel value, the following kernel parameter requires a kernel rebuild and a reboot: semmap, semmni, semmns and semmnu. Setting the Environment Variables The Teradata Parallel Transporter Infrastructure installation updates the following environment variables in the system /etc/profile and /etc/csh.login files: Environment Variable TWB_ROOT PATH SHLIB_PATH NLSPATH Update to Environment Variable Set to the Teradata Parallel Transporter installation directory. Add $TWB_ROOT/bin to the front of the PATH environment variable. Add $TWB_ROOT/lib to the front of the SHLIB_PATH environment variable. Add $TWB_ROOT/msg/%N to the front of the NLSPATH environment variable. The updates to the environment variables are effective in the next login only if the Teradata Parallel Transporter Infrastructure package is installed. The updates to the environment variables allow users to run the installed version of Teradata Parallel Transporter. If the Teradata Parallel Transporter API package was installed, then the SHLIB_PATH and NLSPATH environment variables must be updated manually. The 32-bit files are in $TWB_ROOT/lib and $TWB_ROOT/msg. The 64-bit files are in $TWB_ROOT/lib64 and $TWB_ROOT/msg64. The environment variables are updated on the command line, in the user's profile, or in the system profile. If the environment variables are updated on the command line, then the updates are effective only for the current session. If the environment variables are updated in the user's profile, then the updates are only effective every time that particular user logs in. If the environment variables are updated in the system profile then the updates will be effective every time any user logs in. Note: Users must use the updates to the environment variables in order to run the installed version of Teradata Parallel Transporter properly. Note: If users do not use the updates to the environment variables, then they will not be able to run the installed version of Teradata Parallel Transporter properly. If users do not use the updates to the environment variables, then here are the commands to setup the environment variables: For Bourne and Korn shell users: How to set the TWB_ROOT environment variable: # TWB_ROOT=<Teradata Parallel Transporter installation directory> Teradata Tools and Utilities Installation Guide for UNIX and Linux 195

196 Chapter 10: Configuring Teradata Tools and Utilities Configuring Teradata Parallel Transporter # export TWB_ROOT <Teradata Parallel Transporter installation directory> is the Teradata Parallel Transporter installation directory. You can find out the Teradata Parallel Transporter installation directory by running the /usr/bin/twbpkgrm tool. How to update the PATH environment variable: # PATH=$TWB_ROOT/bin:$PATH # export PATH How to update the SHLIB_PATH environment variable: # SHLIB_PATH=$TWB_ROOT/lib:$SHLIB_PATH # export SHLIB_PATH How to update the NLSPATH environment variable: # NLSPATH=$TWB_ROOT/msg/%N:$NLSPATH # export NLSPATH For C-shell users: How to set the TWB_ROOT environment variable: # setenv TWB_ROOT <Teradata Parallel Transporter installation directory> <Teradata Parallel Transporter installation directory> is the Teradata Parallel Transporter installation directory. You can find out the Teradata Parallel Transporter installation directory by running the /usr/bin/twbpkgrm tool. How to update the PATH environment variable: # setenv PATH $TWB_ROOT"/bin:$PATH" How to update the SHLIB_PATH environment variable: # setenv SHLIB_PATH $TWB_ROOT"/lib:$SHLIB_PATH" How to update the NLSPATH environment variable: # setenv NLSPATH $TWB_ROOT"/msg/%N:$NLSPATH" Switching the IPC Memory Choice to Shared Memory Procedure - Switching the IPC Choice to Shared Memory Follow these steps to switch the IPC Memory Choice to Shared Memory: 1 Log in as root user. 2 Change directory to the Teradata Parallel Transporter install directory. 3 Remove the mmap directory using this command: # rm -rf mmap After following the above steps, Teradata Parallel Transporter will use shared memory as the IPC memory choice. The change does not require a kernel rebuild or a reboot. 196 Teradata Tools and Utilities Installation Guide for UNIX and Linux

197 Chapter 10: Configuring Teradata Tools and Utilities Configuring Teradata Parallel Transporter Switching the IPC Memory Choice to Memory Mapped File Procedure - Switching the IPC Choice to Memory Mapped File Follow these steps to switch the IPC Memory Choice to Memory Mapped File: 1 Log in as root user. 2 Change directory to the Teradata Parallel Transporter install directory. 3 Create the mmap directory with 777 permission using these commands: # mkdir mmap # chmod 777 mmap After following the above steps, Teradata Parallel Transporter will use memory mapped file as the IPC memory choice. The change does not require a kernel rebuild or a reboot. Uninstalling Teradata Parallel Transporter Packages There are two ways to uninstall Teradata Parallel Transporter software packages. The first way is to uninstall a software package is to use the twbpkgrm command. Procedure - Uninstalling Teradata Parallel Transporter Packages Using twbpkgrm Follow these steps to uninstall Teradata Parallel Transporter packages. 1 Log on as the root user and enter the password. 2 Run: /usr/bin/twbpkgrm and follow the instructions. See Removing Teradata Warehouse Builder and Teradata Parallel Transporter Packages on page 52 for information on using /usr/bin/twbpkgrm. The second way to uninstall Teradata Parallel Transporter software is to use the swremove command: Procedure - Uninstalling Teradata Parallel Transporter Packages Using swremove Follow these steps to uninstall Teradata Parallel Transporter packages. 1 Log on as root and enter the password. 2 List all installed packages by entering the following command at the prompt: /usr/sbin/swlist Alternately, you can check to see if a specific package is installed by typing: /usr/bin/swlist <PkgName> 3 Following the order that the next section describes, remove the package by typing: /usr/sbin/swremove <PkgName> Teradata Tools and Utilities Installation Guide for UNIX and Linux 197

198 Chapter 10: Configuring Teradata Tools and Utilities Configuring Teradata Parallel Transporter Order to Uninstall Packages Remove these packages first, in any order: pinsc000 pselc000 pddlc000 podbcc000 poscc000 pdtcc000 pexpc000 plodc000 pstmc000 pupdc000 Remove these packages next, in the following order: poslc000 tbldc000 picuc000 Configuring Teradata Parallel Transporter for Solaris Follow the procedures in this section to configure the Teradata Parallel Transporter on Solaris. Teradata Parallel Transporter configuration normally requires modifications to one file in the Teradata Parallel Transporter installation directory: The configuration file: twbcfg.ini. Additionally, your system configuration may require modification of the following parameters: Shared memory parameters: SHMMAX and SHMMNI Semaphore parameters: SEMMNI, SEMMNU and SEMMNS You may need to modify the following environment variables: TWB_ROOT PATH LD_LIBRARY_PATH NLSPATH Changing the twbcfg.ini File After the Teradata Parallel Transporter Infrastructure package is installed, the configuration file, $TWB_ROOT/twbcfg.ini, can be edited to change the default directory for checkpoint and logs. The $TWB_ROOT environment variable contains the installation directory for Teradata Parallel Transporter. 198 Teradata Tools and Utilities Installation Guide for UNIX and Linux

199 Chapter 10: Configuring Teradata Tools and Utilities Configuring Teradata Parallel Transporter To make a change in this configuration file, log on as the root user, and use an editor to modify the file. A typical reasons for modifying the file is to change the logs directory to another directory with free disk space, if the log is full. No kernel rebuild or reboot is required after making the change in the configuration file. Configuration File Defaults The configuration file contains parameters that determine the default behavior for Teradata Parallel Transporter Infrastructure, such as: Default checkpoint directory Default log directory An example of the Teradata Parallel Transporter configuration file defaults is shown in the following: CheckpointDirectory='/usr/tbuild/ /checkpoint' LogDirectory='/usr/tbuild/ /logs' CheckpointDirectory refers to the directory that contains the checkpoint files for Teradata Parallel Transporter jobs LogDirectory refers to the directory that contains the binary logs for Teradata Parallel Transporter jobs. Each Teradata Parallel Transporter job creates a job log in the jobs directory. Refer to the Teradata Parallel Transporter Reference manual on how to read the job log. Setting the Shared Memory Parameters The Teradata Parallel Transporter Infrastructure installation process checks the values of the following shared memory parameters for the required minimum values: Parameter SHMMAX (minimum value of ) SHMMNI (minimum value of 200) SHMSEG (minimum value of 10) Description The SHMMAX value determines the maximum size of a shared memory segment. The SHMMNI value determines the system wide limit on the number of shared memory segments that can be created. The SHMSEG value determines the maximum number of shared memory segments per process. Note: This is checked only on Solaris 8. Note: The Teradata Parallel Transporter Infrastructure installation does not support a formula value for a kernel parameter. If the value for a kernel parameter is less than the required minimum value, the installation will recommend increasing the value to the minimum value. Teradata Tools and Utilities Installation Guide for UNIX and Linux 199

200 Chapter 10: Configuring Teradata Tools and Utilities Configuring Teradata Parallel Transporter If any of the above shared memory parameter is less than the minimum value, the Teradata Parallel Transporter Infrastructure installation recommends increasing the shared memory parameter to the minimum value by updating the /etc/system file as the root user. Here is an example on how to check the value of the shmseg parameter: # /usr/sbin/sysdef -i grep shmseg Here is an example on how to increase the shmseg parameter to 10: # set shmsys:shminfo_shmseg=10 After the shared memory parameters are changed, a kernel rebuild is not required. After the shared memory parameters are changed, a reboot on the system is required using the shutdown command as the root user. Here is an example on how to shutdown the system in 60 seconds: # cd; /usr/sbin/shutdown -y -g60 -i6 Setting the Semaphore Parameters The Teradata Parallel Transporter Infrastructure installation process checks the values of the following semaphore parameters for the required minimum value: SEMMNI (set to 1000) SEMMNS (set to 1000) SHMMNU (set to 2500) Note: The Teradata Parallel Transporter Infrastructure installation does not support a formula value for a kernel parameter. If the value for a kernel parameter is less than the required minimum value, the installation will recommend increasing the value to the minimum value. Most significant is the SEMMNS parameter, which determines the number of semaphores in the entire system. The default configuration allows 1000 semaphores in concurrent use. Setting the Environment Variables The Teradata Parallel Transporter Infrastructure installation updates the following environment variables in the system /etc/profile and /etc/.login files: Environment Variable TWB_ROOT PATH LD_LIBRARY_PATH NLSPATH Update to Environment Variable Set to the Teradata Parallel Transporter installation directory. Add $TWB_ROOT/bin to the front of the PATH environment variable. Add $TWB_ROOT/lib to the front of the LD_LIBRARY_PATH environment variable. Add $TWB_ROOT/msg/%N to the front of the NLSPATH environment variable. 200 Teradata Tools and Utilities Installation Guide for UNIX and Linux

201 Chapter 10: Configuring Teradata Tools and Utilities Configuring Teradata Parallel Transporter The updates to the environment variables are effective in the next login only if the Teradata Parallel Transporter Infrastructure package is installed. The updates to the environment variables allow users to run the installed version of Teradata Parallel Transporter. If the Teradata Parallel Transporter API package is installed, then the LD_LIBRARY_PATH and NLSPATH environment variables must be updated manually. The 32-bit files are in $TWB_ROOT/lib and $TWB_ROOT/msg. The 64-bit files will be in $TWB_ROOT/lib64 and $TWB_ROOT/msg64. The environment variables are updated on the command line, in the user's profile, or in the system profile. If the environment variables are updated on the command line, then the updates are effective only for the current session. If the environment variables are updated in the user's profile, then the updates are only effective every time that particular user logs in. If the environment variables are updated in the system profile, then the updates are effective every time any user logs in. Note: Users must use the updates to the environment variables in order to run the installed version of Teradata Parallel Transporter properly. Note: If users do not use the updates to the environment variables, then they will not be able to run the installed version of Teradata Parallel Transporter properly. If users do not use the updates to the environment variables, then here are the commands to setup the environment variables: For Bourne and Korn shell users: How to set the TWB_ROOT environment variable: # TWB_ROOT=<Teradata Parallel Transporter installation directory> # export TWB_ROOT <Teradata Parallel Transporter installation directory> is the Teradata Parallel Transporter installation directory. You can find out the Teradata Parallel Transporter installation directory by running the /usr/bin/twbpkgrm tool. How to update the PATH environment variable: # PATH=$TWB_ROOT/bin:$PATH # export PATH How to update the LD_LIBRARY_PATH environment variable: # LD_LIBRARY_PATH=$TWB_ROOT/lib:$LD_LIBRARY_PATH # export LD_LIBRARY_PATH How to update the NLSPATH environment variable: # NLSPATH=$TWB_ROOT/msg/%N:$NLSPATH # export NLSPATH For C-shell users: How to set the TWB_ROOT environment variable: # setenv TWB_ROOT <Teradata Parallel Transporter installation directory> Teradata Tools and Utilities Installation Guide for UNIX and Linux 201

202 Chapter 10: Configuring Teradata Tools and Utilities Configuring Teradata Parallel Transporter <Teradata Parallel Transporter installation directory> is the Teradata Parallel Transporter installation directory. You can find out the Teradata Parallel Transporter installation directory by running the /usr/bin/twbpkgrm tool. How to update the PATH environment variable: # setenv PATH $TWB_ROOT"/bin:$PATH" How to update the LD_LIBRARY_PATH environment variable: # setenv LD_LIBRARY_PATH $TWB_ROOT"/lib:$LD_LIBRARY_PATH" How to update the NLSPATH environment variable: # setenv NLSPATH $TWB_ROOT"/msg/%N:$NLSPATH" Switching the IPC Memory Choice to Shared Memory Procedure - Switching the IPC Choice to Shared Memory Follow these steps to switch the IPC Memory Choice to Shared Memory: 1 Log in as root user. 2 Change directory to the Teradata Parallel Transporter install directory. 3 Remove the mmap directory using this command: # rm -rf mmap After following the above steps, Teradata Parallel Transporter will use shared memory as the IPC memory choice. The change does not require a kernel rebuild or a reboot. Switching the IPC Memory Choice to Memory Mapped File Procedure - Switching the IPC Choice to Memory Mapped File Follow these steps to switch the IPC Memory Choice to Memory Mapped File: 1 Log in as root user. 2 Change directory to the Teradata Parallel Transporter install directory. 3 Create the mmap directory with 777 permission using these commands: # mkdir mmap # chmod 777 mmap After following the above steps, Teradata Parallel Transporter will use memory mapped file as the IPC memory choice. The change does not require a kernel rebuild or a reboot. Uninstalling There are two ways to uninstall Teradata Parallel Transporter software packages. The first way is to uninstall the software packages using the twbpkgrm command. 202 Teradata Tools and Utilities Installation Guide for UNIX and Linux

203 Chapter 10: Configuring Teradata Tools and Utilities Configuring Teradata Parallel Transporter Procedure - Uninstalling Teradata Parallel Transporter Packages Using twbpkgrm Follow these steps to uninstall Teradata Parallel Transporter packages using the twbpkgrm command. 1 Log on as root and enter the password. 2 Run: /usr/bin/twbpkgrm and follow the instructions. See Removing Teradata Warehouse Builder and Teradata Parallel Transporter Packages on page 52 for information on using /usr/bin/twbpkgrm. The second way to uninstall Teradata Parallel Transporter software is to use the pkgrm command: Procedure - Uninstalling Teradata Parallel Transporter Packages pkgrm Follow these steps to uninstall Teradata Parallel Transporter packages using the pkgrm command. 1 Log on as root and enter the password. 2 List all installed packages by entering the following command at the prompt: /usr/bin/pkginfo Alternately, you can check to see if a specific package is installed by typing: /usr/bin/pkginfo <PkgName> 3 Following the order that the next section describes, remove the package by typing: /usr/sbin/pkgrm <PkgName> Order to Uninstall Teradata Parallel Transporter Packages Remove these packages first, in any order: pinsc000 pselc000 pddlc000 podbc000 poscc000 pdtcc000 pexpc000 plodc000 pstmc000 pupdc000 Remove these packages next, in the following order: poslc000 Teradata Tools and Utilities Installation Guide for UNIX and Linux 203

204 Chapter 10: Configuring Teradata Tools and Utilities Configuring Teradata Parallel Transporter tbldc000 picuc000 Configuring Teradata Parallel Transporter for Red Hat Linux Follow the procedures in this section to configure the Teradata Parallel Transporter on Red Hat Linux. Teradata Parallel Transporter configuration normally requires modifications to one file in the Teradata Parallel Transporter installation directory: The configuration file: twbcfg.ini Additionally, your system configuration may require modification of the following parameters: Shared memory parameters: shmmax and shmmni Semaphore parameters: semmni and semmnu You may need to modify the following environment variables: TWB_ROOT PATH LD_LIBRARY_PATH NLSPATH Changing the twbcfg.ini File After the Teradata Parallel Transporter Infrastructure package is installed, you may edit the configuration file, $TWB_ROOT/twbcfg.ini. The configuration file contains default directory for checkpoint and logs. $TWB_ROOT is the environment variable that contains the installation directory for Teradata Parallel Transporter. You must be the root user in order to modify the configuration file. 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. For example, if the logs directory is full, then you should change the logs directory to another directory with free disk space. No kernel rebuild or reboot is required after making the change in the configuration file. Configuration File Defaults The configuration file contains parameters that determine the default behavior for Teradata Parallel Transporter Infrastructure, such as: Default checkpoint directory Default log directory An example of the Teradata Parallel Transporter configuration file defaults is shown in the following: CheckpointDirectory='/opt/teradata/client/tbuild/ /checkpoint' 204 Teradata Tools and Utilities Installation Guide for UNIX and Linux

205 Chapter 10: Configuring Teradata Tools and Utilities Configuring Teradata Parallel Transporter LogDirectory='/opt/teradata/client/tbuild/ /logs' CheckpointDirectory refers to the directory that contains the checkpoint files for Teradata Parallel Transporter jobs. LogDirectory refers to the directory that contains the binary logs for Teradata Parallel Transporter jobs. Each Teradata Parallel Transporter job creates a job log in the jobs directory. Refer to the Teradata Parallel Transporter Reference manual on how to read the job log. Setting the Shared Memory Parameters The Teradata Parallel Transporter Infrastructure installation process checks the values of the following shared memory parameters for the required minimum values: shmmax (minimum value of ) shmmni (minimum value of 200) Note: The Teradata Parallel Transporter Infrastructure installation does not support a formula value for a kernel parameter. If the value for a kernel parameter is less than the required minimum value, the installation will recommend increasing the value to the minimum value. The shmmax value determines the maximum size of a shared memory segment. The shmmni value determines the system wide limit on the number of shared memory segments that can be created. If any of the above shared memory parameter is less than the minimum value, the Teradata Parallel Transporter Infrastructure installation recommends increasing the shared memory parameter to the minimum value. Here is an example on how to check the value of the shmmni parameter: # /sbin/sysctl kernel.shmmni As root user, here is an example on how to increase the shmmni parameter to 200: On Red Hat Linux, add this line in the /etc/rc.d/rc.local file: echo 200 > /proc/sys/kernel/shmmni After the shared memory parameters are changed, a kernel rebuild is not required. After the shared memory parameters are changed, a reboot on the system is required using the shutdown command as the root user. Here is an example on how to shutdown the system in 1 minute: # /sbin/shutdown -r +1 Setting the Semaphore Parameters The Teradata Parallel Transporter Infrastructure installation process checks the values of the following semaphore parameters for the required minimum value: semmni (set to 1000) semmns (set to 1000) Teradata Tools and Utilities Installation Guide for UNIX and Linux 205

206 Chapter 10: Configuring Teradata Tools and Utilities Configuring Teradata Parallel Transporter Note: Note: The Teradata Parallel Transporter Infrastructure installation does not support a formula value for a kernel parameter. If the value for a kernel parameter is less than the required minimum value, the installation will recommend increasing the value to the minimum value. Most significant is the semmns parameter, which determines the number of semaphores in the entire system. The default configuration allows 1000 semaphores in concurrent use. Setting the Environment Variables The Teradata Parallel Transporter Infrastructure installation updates the following environment variables in the system /etc/profile and /etc/csh.login files: Environment Variable TWB_ROOT PATH LD_LIBRARY_PATH NLSPATH Update to Environment Variable Set to the Teradata Parallel Transporter installation directory. Add $TWB_ROOT/bin to the front of the PATH environment variable. Add $TWB_ROOT/lib to the front of the LD_LIBRARY_PATH environment variable. Add $TWB_ROOT/msg/%N to the front of the NLSPATH environment variable. The updates to the environment variables are effective in the next login only if the Teradata Parallel Transporter Infrastructure package is installed. The updates to the environment variables allow users to run the installed version of Teradata Parallel Transporter. If the Teradata Parallel Transporter API package is installed, then the LD_LIBRARY_PATH and NLSPATH environment variables must be updated manually. The 32-bit files is in $TWB_ROOT/lib and $TWB_ROOT/msg. The 64-bit files is in $TWB_ROOT/lib64 and $TWB_ROOT/msg64. The environment variables must be updated on the command line, in the user's profile, or in the system profile. If the environment variables are updated on the command line, then the updates are effective only for the current session. If the environment variables are updated in the user's profile, then the updates are only effective every time that particular user logs in. If the environment variables are updated in the system profile, then the updates are effective every time any user logs in. Note: Users must use the updates to the environment variables in order to run the installed version of Teradata Parallel Transporter properly. Note: If users do not use the updates to the environment variables, then they will not be able to run the installed version of Teradata Parallel Transporter properly. 206 Teradata Tools and Utilities Installation Guide for UNIX and Linux

207 Chapter 10: Configuring Teradata Tools and Utilities Configuring Teradata Parallel Transporter If users do not use the updates to the environment variables, then here are the commands to setup the environment variables: For Bourne and Korn shell users: How to set the TWB_ROOT environment variable: # TWB_ROOT=<Teradata Parallel Transporter installation directory> # export TWB_ROOT <Teradata Parallel Transporter installation directory> is the Teradata Parallel Transporter installation directory. You can find out the Teradata Parallel Transporter installation directory by running the /usr/bin/twbpkgrm tool. How to update the PATH environment variable: # PATH=$TWB_ROOT/bin:$PATH # export PATH How to update the LD_LIBRARY_PATH environment variable: # LD_LIBRARY_PATH=$TWB_ROOT/lib:$LD_LIBRARY_PATH # export LD_LIBRARY_PATH How to update the NLSPATH environment variable: # NLSPATH=$TWB_ROOT/msg/%N:$NLSPATH # export NLSPATH For C-shell users: How to set the TWB_ROOT environment variable: # setenv TWB_ROOT <Teradata Parallel Transporter installation directory> <Teradata Parallel Transporter installation directory> is the Teradata Parallel Transporter installation directory. You can find out the Teradata Parallel Transporter installation directory by running the /usr/bin/twbpkgrm tool. How to update the PATH environment variable: # setenv PATH $TWB_ROOT"/bin:$PATH" How to update the LD_LIBRARY_PATH environment variable: # setenv LD_LIBRARY_PATH $TWB_ROOT"/lib:$LD_LIBRARY_PATH" How to update the NLSPATH environment variable: # setenv NLSPATH $TWB_ROOT"/msg/%N:$NLSPATH" Switching the IPC Memory Choice to Shared Memory Procedure - Switching the IPC Choice to Shared Memory Follow these steps to switch the IPC Memory Choice to Shared Memory: 1 Log in as root user. 2 Change directory to the Teradata Parallel Transporter install directory. 3 Remove the mmap directory using this command: Teradata Tools and Utilities Installation Guide for UNIX and Linux 207

208 Chapter 10: Configuring Teradata Tools and Utilities Configuring Teradata Parallel Transporter # rm -rf mmap After following the above steps, Teradata Parallel Transporter will use shared memory as the IPC memory choice. The change does not require a kernel rebuild or a reboot. Switching the IPC Memory Choice to Memory Mapped File Procedure - Switching the IPC Choice to Memory Mapped File Follow these steps to switch the IPC Memory Choice to Memory Mapped File: 1 Log in as root user. 2 Change directory to the Teradata Parallel Transporter install directory. 3 Create the mmap directory with 777 permission using these commands: # mkdir mmap # chmod 777 mmap After following the above steps, Teradata Parallel Transporter will use memory mapped file as the IPC memory choice. The change does not require a kernel rebuild or a reboot. Uninstalling Teradata Parallel Transporter Software There are two ways to uninstall Teradata Parallel Transporter software. The first way is uninstalling using the twbpkgrm command. Procedure - Uninstalling Teradata Parallel Transporter Using twbpkgrm Follow these steps to uninstall Teradata Parallel Transporter using the twbpkgrm command. 1 Log on as root and enter the password. 2 Run: /usr/bin/twbpkgrm and follow the instructions. See Removing Teradata Warehouse Builder and Teradata Parallel Transporter Packages on page 52 for information on using /usr/bin/twbpkgrm. The second way to uninstall Teradata Parallel Transporter software using the rpm command: 1 Log on as root and enter the password. 2 Following the order that the next section describes, remove the package by typing: rpm -e <package name> Order to Uninstall Teradata Parallel Transporter Packages Remove these packages first, in any order: pinsc Teradata Tools and Utilities Installation Guide for UNIX and Linux

209 Chapter 10: Configuring Teradata Tools and Utilities Configuring Teradata Parallel Transporter pselc000 pddlc000 podbc000 poscc000 pdtcc000 pexpc000 plodc000 pstmc000 pupdc000 Remove these packages next, in the following order: poslc000 tbldc000 picuc000 Teradata Tools and Utilities Installation Guide for UNIX and Linux 209

210 Chapter 10: Configuring Teradata Tools and Utilities Configuring Teradata Parallel Transporter 210 Teradata Tools and Utilities Installation Guide for UNIX and Linux

211 CHAPTER 11 After You Install 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 (npaxsmod) Verifying ODBC Driver for Teradata (tdodbc) Verifying Shared Common Components for Internationalization for Teradata (tdicu) Verifying Teradata Call-Level Interface version 2 (cliv2) Verifying Teradata C Preprocessor2 (sqlpp) Verifying Teradata COBOL Preprocessor2 (cobpp) Verifying Teradata Data Connector (piom) Verifying Teradata Driver for the JDBC Interface Verifying Teradata FastExport (fastexp) Verifying Teradata FastLoad (fastld) Verifying Teradata Generic Security Services (TeraGSS) Verifying Teradata MultiLoad (mload) Verifying Teradata TPump (tpump) Verifying Teradata Parallel Transporter API (papic000) Verifying Teradata Parallel Transporter DDL Operator (pddlc000) Verifying Teradata Parallel Transporter Export Operator (pexpc000) Verifying Teradata Parallel Transporter ICU Library(picuc000) Verifying Teradata Parallel Transporter Infrastructure (tbldc000) Verifying Teradata Parallel Transporter Load Operator (plodc000) Verifying Teradata Parallel Transporter ODBC Operator (podbcc000) Verifying Teradata Parallel Transporter Operator Support Library (poslc000) Verifying Teradata Parallel Transporter OS Command Operator (poscc000) Verifying Teradata Parallel Transporter SQL Inserter Operator (pinsc000) Verifying Teradata Parallel Transporter SQL Selector Operator (pselc000) Verifying Teradata Parallel Transporter Stream Operator (pstmc000) Verifying Teradata Parallel Transporter Update Operator (pupdc000) Verifying WebSphere MQ Access Module (mqaxsmod) Teradata Tools and Utilities Installation Guide for UNIX and Linux 211

212 Chapter 11: After You Install Verifying the Installation of Individual Products Verifying the Installation Using BTEQ Verifying the Installation Using the CLI Sample Program Verifying the Installation of Individual Products Procedure - Verifying Teradata Tools and Utilities Installation Follow these steps to verify that product files have been properly installed: 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) An asterisk (*) after a name in the following table indicates that it is a softlink for a file that has been installed in the directory (default) /opt/teradata/client/usr/bin include. Table 56: Basic Teradata Query Files Directory IBM AIX HP-UX Solaris Red Hat Linux SUSE Linux MP-RAS /usr/bin bteq* bteq* bteq* bteq* bteq* bteq* /usr/include btnfyext.h* btnfyext.h* btnfyext.h* btnfyext.h* btnfyext.h* btnfyext.h* /usr/sample n/a n/a n/a n/a n/a n/a /opt/teradata/client/bin bteq bteq bteq bteq bteq bteq /opt/teradata/client/ sample btnfyext.c mkbtnfyext.aix btnfyext.c mkbtnfyext.hpu x mkbtnfyext.hpu x-ia64 btnfyext.c mkbtnfyext.unx btnfyext.c mkbtnfyext. linux btnfyext.c mkbtnfyext. linux btnfyext.c mkbtnfyext.u nx /opt/teradata/client/ include btnfyext.h btnfyext.h btnfyext.h btnfyext.h btnfyext.h btnfyext.h 212 Teradata Tools and Utilities Installation Guide for UNIX and Linux

213 Chapter 11: After You Install Verifying the Installation of Individual Products Verifying Named Pipes Access Module (npaxsmod) An asterisk (*) after a name in the following table indicates that it is a softlink for files that have been moved to the /opt/teradata/client/include and the /opt/teradata/client/lib directories. Table 57: Named Pipes Access Module Files Directory IBM AIX HP-UX Solaris Red Hat Linux SUSE Linux MP-RAS /usr/lib np_axsmod.so* np_axsmod.sl* np_axsmod.so* np_axsmod.so* np_axsmod.so* np_axsmod.so* /usr/lib np_axsmod TWB.so* np_axsmod TWB.sl* np_axsmod TWB.so* np_axsmod TWB.so* np_axsmod TWB.so* np_axsmod TWB.so* /opt/teradata/ client/lib np_axsmod.so np_axsmod.sl np_axsmod.so np_axsmod.so np_axsmod.so np_axsmod.so /opt/teradata/ client/lib np_axsmod TWB.so np_axsmod TWB.sl np_axsmod TWB.so np_axsmod TWB.so np_axsmod TWB.so np_axsmod TWB.so Verifying ODBC Driver for Teradata (tdodbc) The default directory for the ODBC Driver for Teradata for Solaris platforms is: /opt/teradata/client/odbc The default directory for the ODBC Driver for Teradata for all other platforms is: /usr/odbc Table 58: ODBC Driver for Teradata Files Directory IBM AIX HP-UX Solaris Linux MP-RAS /<install dir>/ README README README README README /<install dir>/ odbc.ini odbc.ini odbc.ini odbc.ini odbc.ini /<install dir>/ odbcinst.ini odbcinst.ini odbcinst.ini odbcinst.ini odbcinst.ini /<install dir>/drivers tdata.so tdata.sl tdata.so tdata.so tdata.so /<install dir>/drivers tdxwinapp tdxwinapp tdxwinapp tdxwinapp tdxwinapp /<install dir>/include odbcinst.h odbcinst.h odbcinst.h odbcinst.h odbcinst.h /<install dir>/include sql.h sql.h sql.h sql.h sql.h /<install dir>/include sqlext.h sqlext.h sqlext.h sqlext.h sqlext.h /<install dir>/include sqltypes.h sqltypes.h sqltypes.h sqltypes.h sqltypes.h /<install dir>/include sqlucode.h sqlucode.h sqlucode.h sqlucode.h sqlucode.h /<install dir>/include sqlunx.h sqlunx.h sqlunx.h sqlunx.h sqlunx.h /<install dir>/lib libodbc.so libodbc.sl libodbc.so libodbc.so libodbc.so /<install dir>/lib libodbcinst.so libodbcinst.sl libodbcinst.so libodbcinst.so libodbcinst.so Teradata Tools and Utilities Installation Guide for UNIX and Linux 213

214 Chapter 11: After You Install Verifying the Installation of Individual Products Table 58: ODBC Driver for Teradata Files (continued) Directory IBM AIX HP-UX Solaris Linux MP-RAS /<install dir>/lib libtdparse.so ibtdparse.sl libtdparse.so libtdparse.so libtdparse.so /<install dir>/lib odbccurs.so odbccurs.sl odbccurs.so odbccurs.so odbccurs.so /<install dir>/lib odbctrac.so odbctrac.sl odbctrac.so odbctrac.so odbctrac.so /<install dir>/lib tdconndlg.so dconndlg.sl tdconndlg.so tdconndlg.so tdconndlg.so /<install dir>/lib vscnctdlg.so vscnctdlg.sl vscnctdlg.so vscnctdlg.so vscnctdlg.so /<install dir>/lib odbc.so n/a n/a n/a n/a /<install dir>/lib tdata.so tdata.sl n/a n/a n/a /<install dir>/man n/a tdata.man n/a n/a n/a /install dir>/messages/ default /<install dir>/samples/ C /<install dir>/samples/ C /<install dir>/samples/ C /<install dir>/samples/ C /<install dir>/samples/ C /<install dir>/samples/ C++ /<install dir>/samples/ C++ /<install dir>/samples/ C++ /<install dir>/samples/ C++ /<install dir>/samples/ C++ n/a odbc.m n/a odbc.m odbc.m Makefile Makefile Makefile Makefile Makefile adhoc adhoc adhoc adhoc adhoc adhoc.c adhoc.c adhoc.c adhoc.c adhoc.c aix.includes common.includes common.includes common.includes common.includes error.c error.c error.c error.c error.c Makefile Makefile Makefile Makefile Makefile adhoc adhoc adhoc adhoc adhoc adhoc.cpp adhoc.cpp adhoc.cpp adhoc.cpp adhoc.cpp aix.includes common.includes common.includes common.includes common.includes error.cpp error.cpp error.cpp error.cpp error.cpp /usr/lib/odbc tdodbc.cat tdodbc.cat n/a tdodbc.cat tdodbc.cat 214 Teradata Tools and Utilities Installation Guide for UNIX and Linux

215 Chapter 11: After You Install Verifying the Installation of Individual Products Table 58: ODBC Driver for Teradata Files (continued) Directory IBM AIX HP-UX Solaris Linux MP-RAS /opt/teradata/client/ lib/odbc (32-bit ODBC Driver for Teradata on Solaris Opteron and SPARC only) /opt/teradata/client/ lib/64/odbc (64-bit ODBC Driver for Teradata on Solaris SPARC) /opt/teradata/client/ lib/amd64/odbc (64-bit ODBC Driver for Teradata on Solaris Opteron) n/a n/a tdodbc.cat n/a n/a n/a n/a tdodbc.cat n/a n/a n/a n/a tdodbc.cat n/a n/a Verifying Shared Common Components for Internationalization for Teradata (tdicu) Table 59: Shared Common Components for Internationalization for Teradata Files Directory IBM AIX HP-UX Solaris Linux MP-RAS /usr/bin libicudatatd.so -> /opt/tdicu/lib/ libicudatatd34.0.so libicudatatd.so -> /opt/tdicu/lib/ libicudatatd34.0.so libicudatatd.so -> /opt/tdicu/lib/ libicudatatd.so.34.0 libicudatatd.so.34 -> /opt/tdicu/lib/ libicudatatd.so.34.0 libicudatatd.so.34 -> /opt/tdicu/lib/ libicudatatd.so.34.0 /usr/bin libicui18ntd.so -> /opt/tdicu/lib/ libicui18ntd34.0.so libicui18ntd.sl -> /opt/tdicu/lib/ libicui18ntd.sl.34.0 libicui18ntd.so -> /opt/tdicu/lib/ libicui18ntd.so.34.0 libicui18ntd.so.34 -> /opt/tdicu/lib/ libicui18ntd.so.34.0 libicui18ntd.so.34 -> /opt/tdicu/lib/ libicui18ntd.so.34.0 /usr/bin libicuuctd.so -> /opt/tdicu/lib/ libicuuctd34.0.so libicuuctd.sl -> /opt/tdicu/lib/ libicuuctd.sl.34.0 libicuuctd.so -> /opt/tdicu/lib/ libicuuctd.so.34.0 libicuuctd.so.34 -> /opt/tdicu/lib/ libicuuctd.so.34.0 libicuuctd.so.34 -> /opt/tdicu/lib/ libicuuctd.so.34.0 /usr/bin libicuiotd.so -> /opt/tdicu/lib/ libicuiotd34.0.so libicuiotd.sl -> /opt/tdicu/lib/ libicuiotd.sl.34.0 libicuiotd.so -> /opt/tdicu/lib/ libicuiotd.so.34.0 libicuiotd.so.34 -> /opt/tdicu/lib/ libicuiotd.so.34.0 libicuiotd.so.34 -> /opt/tdicu/lib/ libicuiotd.so.34.0 /opt/tdicu/lib libicudatatd.so -> libicudatatd34.0.so libicudatatd.sl -> libicudatatd.sl.34.0 libicudatatd.so -> libicudatatd.so.34.0 libicudatatd.so.34 -> libicudatatd.so.34.0 libicudatatd.so.34 -> libicudatatd.so.34.0 /opt/tdicu/lib libicui18ntd.so -> libicui18ntd34.0.so libicui18ntd.sl -> libicui18ntd.sl.34.0 libicui18ntd.so -> libicui18ntd.so.34.0 libicui18ntd.so.34 -> libicui18ntd.so.34.0 libicui18ntd.so.34 -> libicui18ntd.so.34.0 Teradata Tools and Utilities Installation Guide for UNIX and Linux 215

216 Chapter 11: After You Install Verifying the Installation of Individual Products Table 59: Shared Common Components for Internationalization for Teradata Files (continued) Directory IBM AIX HP-UX Solaris Linux MP-RAS /opt/tdicu/lib libicuuctd.so - >libicuuctd34.0.so libicuuctd.sl -> libicuuctd.sl.34.0 libicuuctd.so -> libicuuctd.so.34.0 libicuuctd.so.34 -> libicuuctd.so.34.0 libicuuctd.so.34 -> libicuuctd.so.34.0 /opt/tdicu/lib libicuiotd.so ->libicuiotd34.0.so libicuiotd.sl -> libicuiotd.sl.34.0 libicuiotd.so -> libicuiotd.so.34.0 libicuiotd.so.34 -> libicuiotd.so.34.0 libicuiotd.so.34 -> libicuiotd.so.34.0 /opt/tdicu/lib libicudatatd34.0.so libicudatatd.sl.34.0 libicudatatd.so.34.0 libicudatatd.so.34.0 libicudatatd.so.34.0 /opt/tdicu/lib libicui18ntd34.0.so libicui18ntd.sl.34.0 libicui18ntd.so.34.0 libicui18ntd.so.34.0 libicui18ntd.so.34.0 /opt/tdicu/lib libicuuctd34.0.so libicuuctd.sl.34.0 libicuuctd.so.34.0 libicuuctd.so.34.0 libicuuctd.so.34.0 /opt/tdicu/lib libicuiotd34.0.so libicuiotd.sl.34.0 libicuiotd.so.34.0 libicuiotd.so.34.0 libicuiotd.so.34.0 Verifying Teradata Access Module for JMS Table 60: Teradata Access Module for JMS Files Directory IBM AIX HP-UX Solaris Redhat Linux SUSE Linux 32-bit SUSE Linux 64-bit MP-RAS /opt/teradata/client/ lib libjmsam.so libjmsam.sl libjmsam.so libjmsam.so libjmsam.so n/a n/a /opt/teradata/client/ jmsaxsmod Receiver.clas s Receiver.clas s Receiver.clas s Receiver.clas s Receiver.clas s n/a n/a /opt/teradata/client/ jmsaxsmod readme readme readme readme readme n/a n/a Verifying Teradata Call-Level Interface version 2 (cliv2) An asterisk (*) after a name in the following table indicates that it is a softlink for files that have been moved to the /opt/teradata/client/include and the /opt/teradata/client/lib directories. Table 61: Teradata Call-Level Interface version 2 Files Directory IBM AIX HP-UX Solaris Red Hat Linux SUSE Linux 32-bit SUSE Linux 64-bit MP-RAS /usr/lib clispb.dat* clispb.dat* clispb.dat* clispb.dat* clispb.dat* clispb.dat* clispb.dat* /usr/lib errmsg.cat* errmsg.cat* errmsg.cat* errmsg.cat* errmsg.cat* errmsg.cat* errmsg.cat* /usr/lib errmsg.txt errmsg.txt* errmsg.txt* errmsg.txt* errmsg.txt* errmsg.txt* errmsg.txt* /usr/lib libcliv2.so* libcliv2.sl* libcliv2.so* libcliv2.so* libcliv2.so* libcliv2.so* libcliv2.so* /usr/lib libtdusr.so* libtdusr.sl* libtdusr.so* libtdusr.so* libtdusr.so* libtdusr.so* libtdusr.so* 216 Teradata Tools and Utilities Installation Guide for UNIX and Linux

217 Chapter 11: After You Install Verifying the Installation of Individual Products Table 61: Teradata Call-Level Interface version 2 Files (continued) Directory IBM AIX HP-UX Solaris Red Hat Linux SUSE Linux 32-bit SUSE Linux 64-bit MP-RAS /usr/include cliv2if.h* cliv2if.h* cliv2if.h* cliv2if.h* cliv2if.h* cliv2if.h* cliv2if.h* /usr/include coptypes.h* coptypes.h* coptypes.h* coptypes.h* coptypes.h* coptypes.h* coptypes.h* /usr/include coperr.h* coperr.h* coperr.h* coperr.h* coperr.h* coperr.h* coperr.h* /usr/include dbca2px.h* dbca2px.h* dbca2px.h* dbca2px.h* dbca2px.h* dbca2px.h* dbca2px.h* /usr/include dbcarea.h* dbcarea.h* dbcarea.h* dbcarea.h* dbcarea.h* dbcarea.h* dbcarea.h* /usr/include dbcerr.h* dbcerr.h* dbcerr.h* dbcerr.h* dbcerr.h* dbcerr.h* dbcerr.h* /usr/include dbchqep.h* dbchqep.h* dbchqep.h* dbchqep.h* dbchqep.h* dbchqep.h* dbchqep.h* /usr/include parcel.h* parcel.h* parcel.h* parcel.h* parcel.h* parcel.h* parcel.h* /usr/include mosiif.h* mosiif.h* mosiif.h* mosiif.h* mosiif.h* mosiif.h* mosiif.h* /usr/lib/lib_64 libcliv2.so* n/a n/a n/a n/a n/a n/a /usr/lib/lib_64 libtdusr.so* n/a n/a n/a n/a n/a n/a /usr/lib/pa20_64 n/a libcliv2.sl* n/a n/a n/a n/a n/a /usr/lib/pa20_64 n/a libtdusr.sl* n/a n/a n/a n/a n/a /usr/lib/sparcv9 n/a n/a libcliv2.so* n/a n/a n/a n/a /usr/lib/sparcv9 n/a n/a libtdusr.so* n/a n/a n/a n/a /usr/lib/lib-i386 n/a n/a n/a libcliv2.so* n/a n/a n/a /usr/lib/lib-i386 n/a n/a n/a libtdusr.so* n/a n/a n/a /opt/teradata/client/ lib64 /opt/teradata/client/ lib64 /opt/teradata/client/ lib64 /opt/teradata/client/ lib64 /opt/teradata/client/ lib64 libcliv2.so libcliv2.sl libcliv2.so libcliv2.so libcliv2.so libcliv2.so libcliv2.so libtdusr.so libtdusr.sl libtdusr.so libtdusr.so libtdusr.so libtdusr.so libtdusr.so errmsg.cat errmsg.cat errmsg.cat errmsg.cat errmsg.cat errmsg.cat errmsg.cat errmsg.txt errmsg.txt errmsg.txt errmsg.txt errmsg.txt errmsg.txt errmsg.txt clispb.dat clispb.dat clispb.dat clispb.dat clispb.dat clispb.dat clispb.dat /opt/teradata/client/inc coptypes.h coptypes.h coptypes.h coptypes.h coptypes.h coptypes.h coptypes.h /opt/teradata/client/inc dbchqep.h dbchqep.h dbchqep.h dbchqep.h dbchqep.h dbchqep.h dbchqep.h /opt/teradata/client/inc dbca2px.h dbca2px.h dbca2px.h dbca2px.h dbca2px.h dbca2px.h dbca2px.h /opt/teradata/client/inc cliv2if.h cliv2if.h cliv2if.h cliv2if.h cliv2if.h cliv2if.h cliv2if.h Teradata Tools and Utilities Installation Guide for UNIX and Linux 217

218 Chapter 11: After You Install Verifying the Installation of Individual Products Table 61: Teradata Call-Level Interface version 2 Files (continued) Directory IBM AIX HP-UX Solaris Red Hat Linux SUSE Linux 32-bit SUSE Linux 64-bit MP-RAS /opt/teradata/client/inc coperr.h coperr.h coperr.h coperr.h coperr.h coperr.h coperr.h /opt/teradata/client/inc dbcarea.h dbcarea.h dbcarea.h dbcarea.h dbcarea.h dbcarea.h dbcarea.h /opt/teradata/client/inc parcel.h parcel.h parcel.h parcel.h parcel.h parcel.h parcel.h /opt/teradata/client/inc dbcerr.h dbcerr.h dbcerr.h dbcerr.h dbcerr.h dbcerr.h dbcerr.h /opt/teradata/client/inc mosiff.h mosiff.h mosiff.h mosiff.h mosiff.h mosiff.h mosiff.h /opt/teradata/client/lib errmsg.cat errmsg.cat errmsg.cat errmsg.cat errmsg.cat errmsg.cat errmsg.cat /opt/teradata/client/lib errmsg.txt errmsg.txt errmsg.txt errmsg.txt errmsg.txt errmsg.txt errmsg.txt /opt/teradata/client/lib clispb.dat clispb.dat clispb.dat clispb.dat clispb.dat clispb.dat clispb.dat /opt/teradata/client/ sample /opt/teradata/client/ sample /opt/teradata/client/ sample /opt/teradata/client/ sample /opt/teradata/client/ sample n/a n/a n/a n/a CliLgn.Ex.c CliLgn.Ex.c n/a n/a n/a n/a n/a CliPPS.c CliPPS.c n/a n/a n/a n/a n/a clisamp.c clisamp.c n/a n/a n/a n/a n/a makesamp.lx makesamp.lx n/a n/a n/a n/a n/a makerdusr.lx makerdusr.lx n/a /opt/teradata/client/ sample /opt/teradata/client/ sample n/a n/a n/a n/a n/a makesamp.lx 64 n/a n/a n/a n/a n/a makerdusr.lx 64 n/a n/a Verifying Teradata C Preprocessor2 (sqlpp) Table 62: Teradata C Preprocessor2 Files for IBM AIX, HP-UX, HP Itanium, Solaris SPARC, Solaris Opteron Directory IBM AIX HP-UX HP-UX Itanium Solaris SPARC Solaris Opteron /usr/bin ppcmain ppcmain ppcmain ppcmain ppcmain /usr/lib libppruntim.so libppruntim.sl n/a libppruntim.so libppruntim.so /usr/lib/hpux64 n/a n/a libppruntim.so n/a n/a /usr/bin/bin_64 ppcmain n/a n/a n/a n/a /usr/lib/lib_64 libppruntim.so n/a n/a n/a n/a 218 Teradata Tools and Utilities Installation Guide for UNIX and Linux

219 Chapter 11: After You Install Verifying the Installation of Individual Products Table 62: Teradata C Preprocessor2 Files for IBM AIX, HP-UX, HP Itanium, Solaris SPARC, Solaris Opteron (continued) Directory IBM AIX HP-UX HP-UX Itanium Solaris SPARC Solaris Opteron /usr/bin/pa20_64 n/a ppcmain n/a n/a n/a /usr/lib/pa20_64 n/a libppruntim.sl n/a n/a n/a /usr/bin/sparc9 n/a n/a n/a ppcmain n/a /usr/lib/sparc9 n/a n/a n/a libppruntim.so n/a /usr/bin/amd64 n/a n/a n/a n/a ppcmain /usr/lib/amd64 n/a n/a n/a n/a libppruntim.so /opt/teradata/client/ bin /opt/teradata/client/ bin64 ppcmain ppcmain ppcmain ppcmain ppcmain ppcmain ppcmain n/a ppcmain ppcmain /opt/teradata/client/lib libppruntim.so libppruntim.sl n/a libppruntim.so libppruntim.so /opt/teradata/client/ lib64 /opt/teradata/client/ sample /opt/teradata/client/ sample /opt/teradata/client/ sample /opt/teradata/client/ sample /opt/teradata/client/ sample /opt/teradata/client/ sample /opt/teradata/client/ sample /opt/teradata/client/ sample /opt/teradata/client/ sample /opt/teradata/client/ sample libppruntim.so libppruntim.sl libppruntim.so libppruntim.so libppruntim.so n/a LABSBTEQ LABSBTEQ LABSBTEQ LABSBTEQ PPCLB1 PPCLB1 PPCLB1 PPCLB1 PPCLB1 PPCLB2 PPCLB2 PPCLB2 PPCLB2 PPCLB2 PPCLB3 PPCLB3 PPCLB3 PPCLB3 PPCLB3 PPCLB4 PPCLB4 PPCLB4 PPCLB4 PPCLB4 PPCLB5 PPCLB5 PPCLB5 PPCLB5 PPCLB5 PPCLB6 PPCLB6 PPCLB6 PPCLB6 PPCLB6 PPCLB7 PPCLB7 PPCLB7 PPCLB7 PPCLB7 PPCLB8 PPCLB8 PPCLB8 PPCLB8 PPCLB8 PPCLB9 PPCLB9 PPCLB9 PPCLB9 PPCLB9 Teradata Tools and Utilities Installation Guide for UNIX and Linux 219

220 Chapter 11: After You Install Verifying the Installation of Individual Products Table 63: Teradata C Preprocessor2 Files for Red Hat Linux 32-bit, Red Hat Linux 64-bit, SUSE Linux 64-bit Directory Red Hat Linux 32-bit Red Hat Linux 64-bit Itanium SUSE Linux 64-bit MP-RAS /usr/bin ppcmain n/a n/a ppcmain /usr/lib lippruntim.so n/a n/a lippruntim.so /usr/bin64 n/a ppcmain ppcmain n/a /usr/lib64 n/a lippruntim.so lippruntim.so n/a /opt/teradata/client/ bin /opt/teradata/client/ bin64 ppcmain n/a n/a ppcmain n/a ppcmain ppcmain n/a /opt/teradata/client/lib lippruntim.so n/a n/a lippruntim.so /opt/teradata/client/ lib64 /opt/teradata/client/ sample /opt/teradata/client/ sample /opt/teradata/client/ sample /opt/teradata/client/ sample /opt/teradata/client/ sample /opt/teradata/client/ sample /opt/teradata/client/ sample /opt/teradata/client/ sample /opt/teradata/client/ sample /opt/teradata/client/ sample n/a lippruntim.so lippruntim.so n/a LABSBTEQ LABSBTEQ LABSBTEQ LABSBTEQ PPCLB1 PPCLB1 PPCLB1 PPCLB1 PPCLB2 PPCLB2 PPCLB2 PPCLB2 PPCLB3 PPCLB3 PPCLB3 PPCLB3 PPCLB4 PPCLB4 PPCLB4 PPCLB4 PPCLB5 PPCLB5 PPCLB5 PPCLB5 PPCLB6 PPCLB6 PPCLB6 PPCLB6 PPCLB7 PPCLB7 PPCLB7 PPCLB7 PPCLB8 PPCLB8 PPCLB8 PPCLB8 PPCLB9 PPCLB9 PPCLB9 PPCLB9 Verifying Teradata COBOL Preprocessor2 (cobpp) 220 Teradata Tools and Utilities Installation Guide for UNIX and Linux

221 Chapter 11: After You Install Verifying the Installation of Individual Products Table 64: Teradata COBOL Preprocessor2 Files Directory IBM AIX HP-UX Solaris Linux MP-RAS /usr/bin ppbmain ppbmain n/a n/a ppbmain /usr/bin/bin_64 ppbmain n/a n/a n/a n/a /usr/lib libppruntim.so libppruntim.sl n/a n/a libppruntim.so /usr/lib/lib_64 libppruntim.so n/a n/a n/a n/a /opt/teradata/client/ bin /opt/teradata/client/ bin64 ppbmain ppbmain n/a n/a ppbmain ppbmain n/a n/a n/a n/a /opt/teradata/client/lib libppruntim.so libppruntim.sl n/a n/a libppruntim.so /opt/teradata/client/ lib64 /opt/teradata/client/ sample /opt/teradata/client/ sample /opt/teradata/client/ usr/sample /opt/teradata/client/ usr/sample /opt/teradata/client/ usr/sample /opt/teradata/client/ usr/sample /opt/teradata/client/ usr/sample /opt/teradata/client/ usr/sample /opt/teradata/client/ usr/sample /opt/teradata/client/ usr/sample libppruntim.so n/a n/a n/a n/a n/a LABSBTEQ n/a n/a LABSBTEQ PPCOBLB1 PPCOBLB1 n/a n/a PPCOBLB1 PPCOBLB2 PPCOBLB2 n/a n/a PPCOBLB2 PPCOBLB3 PPCOBLB3 n/a n/a PPCOBLB3 PPCOBLB4 PPCOBLB4 n/a n/a PPCOBLB4 PPCOBLB5 PPCOBLB5 n/a n/a PPCOBLB5 PPCOBLB6 PPCOBLB6 n/a n/a PPCOBLB6 PPCOBLB7 PPCOBLB7 n/a n/a PPCOBLB7 PPCOBLB8 PPCOBLB8 n/a n/a PPCOBLB8 PPCOBLB9 PPCOBLB9 n/a n/a PPCOBLB9 Teradata Tools and Utilities Installation Guide for UNIX and Linux 221

222 Chapter 11: After You Install Verifying the Installation of Individual Products Verifying Teradata Data Connector (piom) An asterisk (*) after a name in the following table indicates that it is a softlink for files that have been moved to the /opt/teradata/client/include and the /opt/teradata/client/lib directories. Table 65: Teradata Data Connector Files Directory IBM AIX HP-UX Solaris RedHat Linux SUSE Linux MP-RAS /usr/lib libpm.so* libpm.sl* libpm.so* libpm.so* libpm.so* libpm.so* /usr/include pmdcomt.h* pmdcomt.h* pmdcomt.h* pmdcomt.h* pmdcomt.h* pmdcomt.h* /usr/include pmddamt.h* pmddamt.h* pmddamt.h* pmddamt.h* pmddamt.h* pmddamt.h* /usr/include pmtypes.h* pmtypes.h* pmtypes.h* pmtypes.h* pmtypes.h* pmtypes.h* /opt/teradata/client/lib libpm.so libpm.sl libpm.so libpm.so libpm.so libpm.so /opt/teradata/client/ include /opt/teradata/client/ include /opt/teradata/client/ include pmdcomt.h pmdcomt.h pmdcomt.h pmdcomt.h pmdcomt.h pmdcomt.h pmddamt.h pmddamt.h pmddamt.h pmddamt.h pmddamt.h pmddamt.h pmtypes.h pmtypes.h pmtypes.h pmtypes.h pmtypes.h pmtypes.h Verifying Teradata Driver for the JDBC Interface Table 66: Teradata Driver for the JDBC Interface Files Directory IBM AIX HP-UX Solaris Linux Executable terajdbc4.jar terajdbc4.jar terajdbc4.jar terajdbc4.jar Sample samples.jar samples.jar samples.jar samples.jar Security tdgssjava.jar tdgssjava.jar tdgssjava.jar tdgssjava.jar tdgssconfig.jar tdgssconfig.jar tdgssconfig.jar tdgssconfig.jar Verifying Teradata FastExport (fastexp) An asterisk (*) after a name in the following table indicates that it is a softlink for files that have been moved to the /opt/teradata/client/bin, /opt/teradata/client/include, and the /opt/ teradata/client/sample directories. Table 67: Teradata FastExport Files Directory IBM AIX HP-UX Solaris Linux MP-RAS /usr/bin fexp* fexp* fexp* fexp* fexp* /usr/include expnfyxt.h* expnfyxt.h* expnfyxt.h* expnfyxt.h* expnfyxt.h* 222 Teradata Tools and Utilities Installation Guide for UNIX and Linux

223 Chapter 11: After You Install Verifying the Installation of Individual Products Table 67: Teradata FastExport Files (continued) Directory IBM AIX HP-UX Solaris Linux MP-RAS /usr/sample expnfyxt.c* expnfyxt.c* expnfyxt.c* expnfyxt.c* expnfyxt.c* /usr/sample mkexpext.aix* mkexpext.hpux* mkexpext.unx* mkexpext.linux* mkexpext.unx* /opt/teradata/client/ bin /opt/teradata/client/ include /opt/teradata/client/ sample /opt/teradata/client/ sample fexp fexp fexp fexp fexp expnfyxt.h expnfyxt.h expnfyxt.h expnfyxt.h expnfyxt.h expnfyxt.c expnfyxt.c expnfyxt.c expnfyxt.c expnfyxt.c mkexpext.aix mkexpext.hpux mkexpext.unx mkexpext.linux mkexpext.unx Verifying Teradata FastLoad (fastld) An asterisk (*) after a name in the following table indicates that it is a softlink for files that have been moved to the /opt/teradata/client/bin, /opt/teradata/client/include, and the /opt/ teradata/client/sample directories. Table 68: Teradata FastLoad Files Directory IBM AIX HP-UX Solaris Linux MP-RAS /usr/bin fastload* fastload* fastload* fastload* fastload* /usr/sample blexit.c* blkexit.c* blkexit.c* blkexit.c* blkexit.c* /usr/sample blexitr.c* blkexitr.c* blkexitr.c* blkexitr.c* blkexitr.c* /usr/sample flnfyext.c* flnfyext.c* flnfyext.c* flnfyext.c* flnfyext.c* /opt/teradata/client/ bin /opt/teradata/client/ sample /opt/teradata/client/ sample /opt/teradata/client/ sample fastload fastload fastload fastload fastload blexit.c blkexit.c blkexit.c blkexit.c blkexit.c blexitr.c blkexitr.c blkexitr.c blkexitr.c blkexitr.c flnfyext.c flnfyext.c flnfyext.c flnfyext.c flnfyext.c Teradata Tools and Utilities Installation Guide for UNIX and Linux 223

224 Chapter 11: After You Install Verifying the Installation of Individual Products Verifying Teradata Generic Security Services (TeraGSS) The files that are included with the TeraGSS package can change from package to package, so there is not a definitive file list to verify. To verify the installation of the TeraGSS packages, you can check for the existence of a file named version in the /usr/teragss/<architecture>/ <version> directory, where <version> is the version of software that is being verified. Table 69: Teradata Generic Security Services Version Files Platform Package File MP-RAS TeraGSS /usr/teragss/mpras-i386/<version>/version AIX TeraGSS_aix-power /usr/teragss/aix-power/<version>/version AIX TeraGSS_aix-power-32 /usr/teragss/aix-power.32/<version>/version HP-UX TeraGSS_hpux-pa /usr/teragss/hpux-pa/<version>/version HP-UX TeraGSS_hpux-pa32 /usr/teragss/hpux-pa.32/<version>/version HP-UX TeraGSS_hpux-ia64 /usr/teragss/hpux-ia64/<version>/version Solaris TeraGSS_solaris-sparc /usr/teragss/solaris-sparc/<version>/version Solaris TeraGSS_solaris-sparc32 /usr/teragss/solaris-sparc.32/<version>/version Red Hat Linux TeraGSS_redhatlinux-i386 /usr/teragss/redhatlinux-i386/<version>/version Red Hat Linux TeraGSS_redhatlinux-i64 /usr/teragss/redhatlinux-i64/<version>/version Red Hat Linux TeraGSS_redhatlinux-ia64 /usr/teragss/redhatlinux-ia64/<version>/version SuSeLinux TeraGSS_suselinux-i386 /usr/teragss/suselinux-i386/<version>/version SuSeLinux TeraGSS_suselinux-i64 /usr/teragss/suselinux-i64/<version>/version SuSeLinux TeraGSS_suselinux-ia64 /usr/teragss/suselinux-ia64/<version>/version Verifying Teradata MultiLoad (mload) An asterisk (*) after a name in the following table indicates that it is a softlink for files that have been moved to the /opt/teradata/client/bin, /opt/teradata/client/include, and the /opt/ teradata/client/sample directories. Table 70: Teradata MultiLoad Files Directory IBM AIX HP-UX Solaris Linux MP-RAS /usr/bin* mload* mload* mload* mload* mload* /usr/include* mldnfyxt.h* mldnfyxt.h* mldnfyxt.h* mldnfyxt.h* mldnfyxt.h* /usr/sample* mldnfyxt.c* mldnfyxt.c* mldnfyxt.c* mldnfyxt.c* mldnfyxt.c* /usr/sample* mkmldext.aix* mkmldext.hpux* mkmldext.unx* mkmldext.linux* mkmldext.unx* 224 Teradata Tools and Utilities Installation Guide for UNIX and Linux

225 Chapter 11: After You Install Verifying the Installation of Individual Products Table 70: Teradata MultiLoad Files (continued) Directory IBM AIX HP-UX Solaris Linux MP-RAS /opt/teradata/client/ bin /opt/teradata/client/ include /opt/teradata/client/ sample /opt/teradata/client/ sample mload mload mload mload mload mldnfyxt.h mldnfyxt.h mldnfyxt.h mldnfyxt.h mldnfyxt.h mldnfyxt.c mldnfyxt.c mldnfyxt.c mldnfyxt.c mldnfyxt.c mkmldext.aix mkmldext.hpux mkmldext.unx mkmldext.linux mkmldext.unx Verifying Teradata TPump (tpump) An asterisk (*) after a name in the following table indicates that it is a softlink for files that have been moved to the /opt/teradata/client/bin, /opt/teradata/client/include, and the /opt/ teradata/client/sample directories. Table 71: Teradata TPump Files Directory IBM AIX HP-UX Solaris Linux MP-RAS /usr/bin tpumpexe* tpumpexe* tpumpexe* tpumpexe* tpumpexe* /usr/bin tpump* tpump* tpump* n/a tpump* /usr/lib tdatpump.cfg* tdatpump.cfg* tdatpump.cfg* tdatpump.cfg* tdatpump.cfg* /opt/teradata/client/ bin /opt/teradata/client/ bin tpumpexe tpumpexe tpumpexe tpumpexe* tpumpexe tpump tpump tpump n/a tpump /opt/teradata/client/lib tdatpump.cfg tdatpump.cfg tdatpump.cfg tdatpump.cfg tdatpump.cfg /opt/teradata/client/ etc/ tpump_examples /opt/teradata/client/ etc/ tpump_examples /opt/teradata/client/ etc/ tpump_examples /opt/teradata/client/ etc/ tpump_examples /opt/teradata/client/ sample /opt/teradata/client/ sample n/a n/a n/a n/a makinmod.3000 n/a n/a n/a n/a tldnfyxt.c n/a n/a n/a n/a tpumpimd.c n/a n/a n/a n/a tpumpar.csql makinmod.3000 makinmod.3000 makinmod.3000 makinmod.3000 n/a tldnfyxt.c tldnfyxt.c n/a tldnfyxt.c n/a Teradata Tools and Utilities Installation Guide for UNIX and Linux 225

226 Chapter 11: After You Install Verifying the Installation of Individual Products Table 71: Teradata TPump Files (continued) Directory IBM AIX HP-UX Solaris Linux MP-RAS /opt/teradata/client/ sample /opt/teradata/client/ sample tpumpimd.c tpumpimd.c tpumpimd.c tpumpimd.c n/a tpumpar.csql tpumpar.csql tpumpar.csql tpumpar.csql n/a Verifying Teradata Parallel Transporter API (papic000) On Linux, the default value of <INSTALLDIR> is /opt/teradata/client/tbuild/ On other platforms, the default value of <INSTALLER> is /usr/tbuild/ Table 72: Teradata Parallel Transporter API Files Directory IBM AIX HP-UX Itanium HP-UX Risc Solaris SPARC Solaris Opteron Linux MP-RAS <INSTALLDIR>/lib libtelapi.so n/a libtelapi.s1 libtelapi.so libtelapi.so libtelapi.so libtelapi.so <INSTALLDIR>/lib64 libtelapi.so libtelapi.so libtelapi.s1 libtelapi.so libtelapi.so libtelapi.so n/a <INSTALLDIR>/tptapi/ inc connection.h connection. h connection. h connection. h connection. h connection. h connection. h <INSTALLDIR>/tptapi/ inc DMLGroup.h DMLGroup. h DMLGroup. h DMLGroup.h DMLGroup.h DMLGroup.h DMLGroup. h <INSTALLDIR>/tptapi/ inc schema.h schema.h schema.h schema.h schema.h schema.h schema.h <INSTALLDIR>/tptapi/ sample/inc connection.h connection. h connection. h connection. h connection. h connection. h connection. h <INSTALLDIR>/tptapi/ sample/inc DMLGroup.h DMLGroup. h DMLGroup. h DMLGroup.h DMLGroup.h DMLGroup.h DMLGroup. h <INSTALLDIR>/tptapi/ sample/inc schema.h schema.h schema.h schema.h schema.h schema.h schema.h <INSTALLDIR>/tptapi/ sample/common OptionsMan ager.cpp OptionsMa nager.cpp OptionsMa nager.cpp OptionsMa nager.cpp OptionsMa nager.cpp OptionsMa nager.cpp OptionsMa nager.cpp <INSTALLDIR>/tptapi/ sample/common OptionsMan ager.h OptionsMa nager.h OptionsMa nager.h OptionsMa nager.h OptionsMa nager.h OptionsMa nager.h OptionsMa nager.h <INSTALLDIR>/tptapi/ sample/generic GenericDrive r.cpp GenericDriv er.cpp GenericDriv er.cpp GenericDri ver.cpp GenericDri ver.cpp GenericDri ver.cpp GenericDriv er.cpp <INSTALLDIR>/tptapi/ sample/generic <INSTALLDIR>/tptapi/ sample/generic main.cpp main.cpp main.cpp main.cpp main.cpp main.cpp main.cpp input.txt input.txt input.txt input.txt input.txt input.txt input.txt 226 Teradata Tools and Utilities Installation Guide for UNIX and Linux

227 Chapter 11: After You Install Verifying the Installation of Individual Products Table 72: Teradata Parallel Transporter API Files (continued) Directory IBM AIX HP-UX Itanium HP-UX Risc Solaris SPARC Solaris Opteron Linux MP-RAS <INSTALLDIR>/tptapi/ sample/generic infile.bigendi an infile.bigend ian infile.bigend ian infile.bigen dian infile.littlee ndian infile.littlee ndian infile.littlee ndian <INSTALLDIR>/tptapi/ sample/generic makedriver.a ix makedriver. hpux makedriver. hpux makedriver. sol_s makedriver. sol_o makedriver. linux makedriver. unx <INSTALLDIR>/tptapi/ sample/generic cleanuptable s.bteq cleanuptabl es.bteq cleanuptabl es.bteq cleanuptab les.bteq cleanuptab les.bteq cleanuptabl es.bteq cleanuptabl es.bteq <INSTALLDIR>/tptapi/ sample/generic setuptables.b teq setuptables. bteq setuptables. bteq setuptables.bteq setuptables.bteq setuptables. bteq setuptables. bteq <INSTALLDIR>/tptapi/ sample/generic/inc GenericDrive r.h GenericDriv er.h GenericDriv er.h GenericDri ver.h GenericDri ver.h GenericDri ver.h GenericDriv er.h <INSTALLDIR>/tptapi/ sample/blockloading BlockLoad.cp p BlockLoad.c pp BlockLoad.c pp BlockLoad. cpp BlockLoad. cpp BlockLoad.c pp BlockLoad.c pp <INSTALLDIR>/tptapi/ sample/blockloading <INSTALLDIR>/tptapi/ sample/blockloading main.cpp main.cpp main.cpp main.cpp main.cpp main.cpp main.cpp input.txt input.txt input.txt input.txt input.txt input.txt input.txt <INSTALLDIR>/tptapi/ sample/blockloading infile.bigendi an infile.bigend ian infile.bigend ian infile.bigen dian infile.littlee ndian infile.littlee ndian infile.littlee ndian <INSTALLDIR>/tptapi/ sample/blockloading makeblock.ai x makeblock.h pux makeblock.h pux makeblock. sol_s makeblock. sol_o makeblock.l inux makeblock.u nx <INSTALLDIR>/tptapi/ sample/blockloading cleanuptable s.bteq cleanuptabl es.bteq cleanuptabl es.bteq cleanuptab les.bteq cleanuptab les.bteq cleanuptabl es.bteq cleanuptabl es.bteq <INSTALLDIR>/tptapi/ sample/blockloading setuptables.b teq setuptables. bteq setuptables. bteq setuptables.bteq setuptables.bteq setuptables. bteq setuptables. bteq <INSTALLDIR>/tptapi/ sample/blockloading/inc BlockLoad.h BlockLoad.h BlockLoad.h BlockLoad. h BlockLoad. h BlockLoad. h BlockLoad.h <INSTALLDIR>/tptapi/ sample/checkpoint checkpoint.cp p checkpoint.c pp checkpoint.c pp checkpoint. cpp checkpoint. cpp checkpoint. cpp checkpoint.c pp <INSTALLDIR>/tptapi/ sample/checkpoint <INSTALLDIR>/tptapi/ sample/checkpoint main.cpp main.cpp main.cpp main.cpp main.cpp main.cpp main.cpp input.txt input.txt input.txt input.txt input.txt input.txt input.txt <INSTALLDIR>/tptapi/ sample/checkpoint infile.bigendi an infile.bigend ian infile.bigend ian infile.bigen dian infile.littlee ndian infile.littlee ndian infile.littlee ndian <INSTALLDIR>/tptapi/ sample/checkpoint makecheckpo int.aix makecheckp oint.hpux makecheckp oint.hpux makecheck point.sol_s makecheck point.sol_o makecheckp oint.linux makecheckp oint.unx Teradata Tools and Utilities Installation Guide for UNIX and Linux 227

228 Chapter 11: After You Install Verifying the Installation of Individual Products Table 72: Teradata Parallel Transporter API Files (continued) Directory IBM AIX HP-UX Itanium HP-UX Risc Solaris SPARC Solaris Opteron Linux MP-RAS <INSTALLDIR>/tptapi/ sample/checkpoint cleanuptable s.bteq cleanuptabl es.bteq cleanuptabl es.bteq cleanuptab les.bteq cleanuptab les.bteq cleanuptabl es.bteq cleanuptabl es.bteq <INSTALLDIR>/tptapi/ sample/checkpoint setuptables.b teq setuptables. bteq setuptables. bteq setuptables.bteq setuptables.bteq setuptables. bteq setuptables. bteq <INSTALLDIR>/tptapi/ sample/checkpoint/inc checkpoint.h checkpoint.h checkpoint.h checkpoint. h checkpoint. h checkpoint. h checkpoint.h <INSTALLDIR>/tptapi/ sample/getbuffer GetBuffer.cp p GetBuffer.c pp GetBuffer.c pp GetBuffer.c pp GetBuffer.c pp GetBuffer.c pp GetBuffer.c pp <INSTALLDIR>/tptapi/ sample/getbuffer <INSTALLDIR>/tptapi/ sample/getbuffer main.cpp main.cpp main.cpp main.cpp main.cpp main.cpp main.cpp input.txt input.txt input.txt input.txt input.txt input.txt input.txt <INSTALLDIR>/tptapi/ sample/getbuffer makedriver.a ix makedriver. hpux makedriver. hpux makedriver. sol_s makedriver. sol_o makedriver. linux makedriver. unx <INSTALLDIR>/tptapi/ sample/getbuffer cleanuptable s.bteq cleanuptabl es.bteq cleanuptabl es.bteq cleanuptab les.bteq cleanuptab les.bteq cleanuptabl es.bteq cleanuptabl es.bteq <INSTALLDIR>/tptapi/ sample/getbuffer setuptables.b teq setuptables. bteq setuptables. bteq setuptables.bteq setuptables.bteq setuptables. bteq setuptables. bteq <INSTALLDIR>/tptapi/ sample/getbuffer/inc GetBuffer.h GetBuffer.h GetBuffer.h GetBuffer.h GetBuffer.h GetBuffer.h GetBuffer.h <INSTALLDIR>/tptapi/ sample/xsp <INSTALLDIR>/tptapi/ sample/xsp <INSTALLDIR>/tptapi/ sample/xsp <INSTALLDIR>/tptapi/ sample/xsp <INSTALLDIR>/tptapi/ sample/xsp n/a n/a n/a n/a n/a GenericDri ver.cpp n/a n/a n/a n/a n/a GenericDri ver.h n/a n/a n/a n/a n/a OptionsRea der.cpp n/a n/a n/a n/a n/a OptionsRea der.h n/a n/a n/a n/a n/a makedriver. linux GenericDriv er.cpp GenericDriv er.h OptionsRea der.cpp OptionsRea der.h makedriver. unx <INSTALLDIR>/tptapi/ sample/xsp <INSTALLDIR>/tptapi/ sample/xsp <INSTALLDIR>/tptapi/ sample/xsp n/a n/a n/a n/a n/a xsp.cpp xsp.cpp n/a n/a n/a n/a n/a input.lod input.lod n/a n/a n/a n/a n/a input.exp input.exp 228 Teradata Tools and Utilities Installation Guide for UNIX and Linux

229 Chapter 11: After You Install Verifying the Installation of Individual Products Table 72: Teradata Parallel Transporter API Files (continued) Directory IBM AIX HP-UX Itanium HP-UX Risc Solaris SPARC Solaris Opteron Linux MP-RAS <INSTALLDIR>/tptapi/ sample/xsp <INSTALLDIR>/tptapi/ sample/xsp n/a n/a n/a n/a n/a input.stm input.stm n/a n/a n/a n/a n/a input.upd input.upd <INSTALLDIR>/tptapi/ sample/xsp n/a n/a n/a n/a n/a infile.littlee ndian infile.littlee ndian <INSTALLDIR>/tptapi/ sample/multiple MultipleOper ators.cpp MultipleOp erators.cpp MultipleOp erators.cpp MultipleOp erators.cpp MultipleOp erators.cpp MultipleOp erators.cpp MultipleOp erators.cpp <INSTALLDIR>/tptapi/ sample/multiple <INSTALLDIR>/tptapi/ sample/multiple main.cpp main.cpp main.cpp main.cpp main.cpp main.cpp main.cpp input.txt input.txt input.txt input.txt input.txt input.txt input.txt <INSTALLDIR>/tptapi/ sample/multiple makemultipl e.aix makemultip le.hpux makemultip le.hpux makemulti ple.sol_s makemulti ple.sol_o makemulti ple.linux makemultip le.unx <INSTALLDIR>/tptapi/ sample/multiple cleanuptable s.bteq cleanuptabl es.bteq cleanuptabl es.bteq cleanuptab les.bteq cleanuptab les.bteq cleanuptabl es.bteq cleanuptabl es.bteq <INSTALLDIR>/tptapi/ sample/multiple setuptables.b teq setuptables. bteq setuptables. bteq setuptables.bteq setuptables.bteq setuptables. bteq setuptables. bteq <INSTALLDIR>/tptapi/ sample/multiple/inc MultipleOper ators.h MultipleOp erators.h MultipleOp erators.h MultipleOp erators.h MultipleOp erators.h MultipleOp erators.h MultipleOp erators.h <INSTALLDIR>/tptapi/ sample/multi_node multitest.cpp multitest.cp p multitest.cp p multitest.cp p multitest.cp p multitest.cp p multitest.cp p <INSTALLDIR>/tptapi/ sample/multi_node synchronize.c pp synchronize. cpp synchronize. cpp synchronize.cpp synchronize.cpp synchronize.cpp synchronize. cpp <INSTALLDIR>/tptapi/ sample/multi_node <INSTALLDIR>/tptapi/ sample/multi_node <INSTALLDIR>/tptapi/ sample/multi_node fileio.cpp fileio.cpp fileio.cpp fileio.cpp fileio.cpp fileio.cpp fileio.cpp master.cpp master.cpp master.cpp master.cpp master.cpp master.cpp master.cpp slave.cpp slave.cpp slave.cpp slave.cpp slave.cpp slave.cpp slave.cpp <INSTALLDIR>/tptapi/ sample/multi_node master_input.txt master_inp ut.txt master_inp ut.txt master_inp ut.txt master_inp ut.txt master_inp ut.txt master_inp ut.txt <INSTALLDIR>/tptapi/ sample/multi_node slave_input.t xt slave_input. txt slave_input. txt slave_input.txt slave_input.txt slave_input. txt slave_input. txt <INSTALLDIR>/tptapi/ sample/multi_node infilemaster.b igendian infilemaster.bigendian infilemaster.bigendian infilemaster.bigendian infilemaster.littleendia n infilemaster.littleendia n infilemaster. littleendian Teradata Tools and Utilities Installation Guide for UNIX and Linux 229

230 Chapter 11: After You Install Verifying the Installation of Individual Products Table 72: Teradata Parallel Transporter API Files (continued) Directory IBM AIX HP-UX Itanium HP-UX Risc Solaris SPARC Solaris Opteron Linux MP-RAS <INSTALLDIR>/tptapi/ sample/multi_node infileslave.big Endian.1 infileslave.bi gendian.1 infileslave.bi gendian.1 infileslave.b igendian.1 infileslave.li ttleendian. 1 infileslave.li ttleendian. 1 infileslave.li ttleendian.1 <INSTALLDIR>/tptapi/ sample/multi_node makemulti.ai x makemulti. hpux makemulti. hpux makemulti. sol_s makemulti. sol_o makemulti. linux makemulti. unx <INSTALLDIR>/tptapi/ sample/multi_node cleanuptable s.bteq cleanuptabl es.bteq cleanuptabl es.bteq cleanuptab les.bteq cleanuptab les.bteq cleanuptabl es.bteq cleanuptabl es.bteq <INSTALLDIR>/tptapi/ sample/multi_node setuptables.b teq setuptables. bteq setuptables. bteq setuptables.bteq setuptables.bteq setuptables. bteq setuptables. bteq <INSTALLDIR>/tptapi/ sample/multi_node/inc <INSTALLDIR>/tptapi/ sample/multi_node/inc fileio.h fileio.h fileio.h fileio.h fileio.h fileio.h fileio.h multitest.h multitest.h multitest.h multitest.h multitest.h multitest.h multitest.h <INSTALLDIR>/tptapi/ sample/multi_node/inc synchronize.h synchronize. h synchronize. h synchronize.h synchronize.h synchronize.h synchronize. h <INSTALLDIR>/tptapi/ sample/threads PerfTestMess age.cpp PerfTestMes sage.cpp PerfTestMes sage.cpp PerfTestMe ssage.cpp PerfTestMe ssage.cpp PerfTestMes sage.cpp n/a <INSTALLDIR>/tptapi/ sample/threads TelapiThread Test.cpp TelapiThrea dtest.cpp TelapiThrea dtest.cpp TelapiThre adtest.cpp TelapiThre adtest.cpp TelapiThre adtest.cpp n/a <INSTALLDIR>/tptapi/ sample/threads makeparallel. aix makeparalle l.hpux makeparalle l.hpux makeparall el.sol_s makeparall el.sol_s makeparall el.linux n/a <INSTALLDIR>/tptapi/ sample/threads TestBase.cpp TestBase.cpp TestBase.cpp TestBase.cp p TestBase.cp p TestBase.cp p n/a <INSTALLDIR>/tptapi/ sample/threads TestExport.cp p TestExport.c pp TestExport.c pp TestExport. cpp TestExport. cpp TestExport. cpp n/a <INSTALLDIR>/tptapi/ sample/threads TestLoad.cpp TestLoad.cp p TestLoad.cp p TestLoad.cp p TestLoad.cp p TestLoad.cp p n/a <INSTALLDIR>/tptapi/ sample/threads TestSim.cpp TestSim.cpp TestSim.cpp TestSim.cp p TestSim.cp p TestSim.cpp n/a <INSTALLDIR>/tptapi/ sample/threads TestStream.c pp TestStream.c pp TestStream.c pp TestStream. cpp TestStream. cpp TestStream. cpp n/a <INSTALLDIR>/tptapi/ sample/threads TestUpdate.c pp TestUpdate. cpp TestUpdate. cpp TestUpdate. cpp TestUpdate. cpp TestUpdate. cpp n/a <INSTALLDIR>/tptapi/ sample/threads ThreadTest.c pp ThreadTest. cpp ThreadTest. cpp ThreadTest. cpp ThreadTest. cpp ThreadTest. cpp n/a <INSTALLDIR>/tptapi/ sample/threads ThreadTestPa rameters.cpp ThreadTestP arameters.c pp ThreadTestP arameters.c pp ThreadTest Parameters. cpp ThreadTest Parameters.cpp ThreadTest Parameters. cpp n/a 230 Teradata Tools and Utilities Installation Guide for UNIX and Linux

231 Chapter 11: After You Install Verifying the Installation of Individual Products Table 72: Teradata Parallel Transporter API Files (continued) Directory IBM AIX HP-UX Itanium HP-UX Risc Solaris SPARC Solaris Opteron Linux MP-RAS <INSTALLDIR>/tptapi/ sample/threads Synchronizer. cpp Synchronize r.cpp Synchronize r.cpp Synchroniz er.cpp Synchroniz er.cpp Synchronize r.cpp n/a <INSTALLDIR>/tptapi/ sample/threads input.txt input.txt input.txt input.txt input.txt input.txt n/a <INSTALLDIR>/tptapi/ sample/threads loaddata.big Endian loaddata.bi gendian loaddata.bi gendian loaddata.b igendian loaddata.li ttleendian loaddata.li ttleendian n/a <INSTALLDIR>/tptapi/ sample/threads cleanuptable s.bteq cleanuptabl es.bteq cleanuptabl es.bteq cleanuptab les.bteq cleanuptab les.bteq cleanuptabl es.bteq n/a <INSTALLDIR>/tptapi/ sample/threads setuptables.b teq setuptables. bteq setuptables. bteq setuptables.bteq setuptables.bteq setuptables. bteq n/a <INSTALLDIR>/tptapi/ sample/threads/inc common.h common.h common.h common.h common.h common.h n/a <INSTALLDIR>/tptapi/ sample/threads/inc PerfTestMess age.h PerfTestMes sage.h PerfTestMes sage.h PerfTestMe ssage.h PerfTestMe ssage.h PerfTestMes sage.h n/a <INSTALLDIR>/tptapi/ sample/threads/inc TestBase.h TestBase.h TestBase.h TestBase.h TestBase.h TestBase.h n/a <INSTALLDIR>/tptapi/ sample/threads/inc TestExport.h TestExport.h TestExport.h TestExport. h TestExport. h TestExport. h n/a <INSTALLDIR>/tptapi/ sample/threads/inc <INSTALLDIR>/tptapi/ sample/threads/inc TestLoad.h TestLoad.h TestLoad.h TestLoad.h TestLoad.h TestLoad.h n/a TestSim.h TestSim.h TestSim.h TestSim.h TestSim.h TestSim.h n/a <INSTALLDIR>/tptapi/ sample/threads/inc TestStream.h TestStream. h TestStream. h TestStream. h TestStream. h TestStream. h n/a <INSTALLDIR>/tptapi/ sample/threads/inc TestUpdate.h TestUpdate. h TestUpdate. h TestUpdate. h TestUpdate. h TestUpdate. h n/a <INSTALLDIR>/tptapi/ sample/threads/inc ThreadTest.h ThreadTest. h ThreadTest. h ThreadTest. h ThreadTest. h ThreadTest. h n/a <INSTALLDIR>/tptapi/ sample/threads/inc ThreadTestPa rameters.h ThreadTestP arameters.h ThreadTestP arameters.h ThreadTest Parameters. h ThreadTest Parameters. h ThreadTest Parameters. h n/a <INSTALLDIR>/tptapi/ sample/threads/inc Synchronizer. h Synchronize r.h Synchronize r.h Synchroniz er.h Synchroniz er.h Synchronize r.h n/a Teradata Tools and Utilities Installation Guide for UNIX and Linux 231

232 Chapter 11: After You Install Verifying the Installation of Individual Products Verifying Teradata Parallel Transporter Data Connector Operator (pdtcc000) Table 73: Teradata Parallel Transporter Data Connector Operator Files Directory IBM AIX HP-UX Solaris Linux MP-RAS <INSTALLDIR>/lib libdataconop.so libdataconop.sl libdataconop.so libdataconop.so libdataconop.so Verifying Teradata Parallel Transporter DDL Operator (pddlc000) Table 74: Teradata Parallel Transporter DDL Operator Files Directory IBM AIX HP-UX Solaris Linux MP-RAS <INSTALLDIR>/lib libddlop.so libddlop.sl libddlop.so libddlop.so libddlop.so Verifying Teradata Parallel Transporter Export Operator (pexpc000) Table 75: Teradata Parallel Transporter Export Operator Files Directory IBM AIX HP-UX PA-RISC HP-UX Itanium Solaris Linux MP-RAS <INSTALLDIR>/lib libexportop.so libexportop.sl n/a libexportop.so libexportop.so libexportop.so <INSTALLDIR>/lib64 libexportop.so libexportop.sl libexportop.so libexportop.so libexportop.so n/a <INSTALLDIR>/sample expnfyxt.c expnfyxt.c expnfyxt.c expnfyxt.c expnfyxt.c expnfyxt.c Verifying Teradata Parallel Transporter ICU Library(picuc000) Table 76: Teradata Parallel Transporter ICU Library Files Directory IBM AIX HP-UX PA-RISC HP-UX Itanium Solaris Linux MP-RAS <INSTALLDIR>/lib libpxicu.so libpxicu.sl n/a libpxicu.so libpxicu.so libpxicu.so <INSTALLDIR>/lib64 libpxicu.so libpxicu.sl libpxicu.so libpxicu.so libpxicu.so n/a 232 Teradata Tools and Utilities Installation Guide for UNIX and Linux

233 Chapter 11: After You Install Verifying the Installation of Individual Products Verifying Teradata Parallel Transporter Infrastructure (tbldc000) Table 77: Teradata Parallel Transporter Infrastructure Files Directory IBM AIX HP-UX Solaris Linux MP-RAS <INSTALLDIR> twbcfg.ini twbcfg.ini twbcfg.ini twbcfg.ini twbcfg.ini <INSTALLDIR> twboper.ini twboper.ini twboper.ini twboper.ini twboper.ini <INSTALLDIR> version version version version version <INSTALLDIR>/bin tbuild tbuild tbuild tbuild tbuild <INSTALLDIR>/bin tlogview tlogview tlogview tlogview tlogview <INSTALLDIR>/bin twbkill twbkill twbkill twbkill twbkill <INSTALLDIR>/bin twbstat twbstat twbstat twbstat twbstat <INSTALLDIR>/bin ptmgts ptmgts ptmgts ptmgts ptmgts <INSTALLDIR>/bin ptmtims ptmtims ptmtims ptmtims ptmtims <INSTALLDIR>/bin ptmexec ptmexec ptmexec ptmexec ptmexec <INSTALLDIR>/bin ptmjlgr ptmjlgr ptmjlgr ptmjlgr ptmjlgr <INSTALLDIR>/bin ptmlvs ptmlvs ptmlvs ptmlvs ptmlvs <INSTALLDIR>/bin coordinator coordinator coordinator coordinator coordinator <INSTALLDIR>/bin planexecutor planexecutor planexecutor planexecutor planexecutor <INSTALLDIR>/bin executor executor executor executor executor <INSTALLDIR>/bin twbpkgrm twbpkgrm twbpkgrm twbpkgrm twbpkgrm <INSTALLDIR>/bin tbuildexe tbuildexe tbuildexe tbuildexe tbuildexe <INSTALLDIR>/bin tlogviewexe tlogviewexe tlogviewexe tlogviewexe tlogviewexe <INSTALLDIR>/bin twbcmdexe twbcmdexe twbcmdexe twbcmdexe twbcmdexe <INSTALLDIR>/bin twbkillexe twbkillexe twbkillexe twbkillexe twbkillexe <INSTALLDIR>/bin twbstatexe twbstatexe twbstatexe twbstatexe twbstatexe <INSTALLDIR>/bin twbrmcpexe twbrmcpexe twbrmcpexe twbrmcpexe twbrmcpexe <INSTALLDIR>/bin twbpathexe twbpathexe twbpathexe twbpathexe twbpathexe <INSTALLDIR>/bin tptlaunch tptlaunch tptlaunch tptlaunch tptlaunch <INSTALLDIR>/bin twbpath twbpath twbpath twbpath twbpath <INSTALLDIR>/bin twbrmcp twbrmcp twbrmcp twbrmcp twbrmcp <INSTALLDIR>/inc pxlogdef.h pxlogdef.h pxlogdef.h pxlogdef.h pxlogdef.h <INSTALLDIR>/inc pxstc.h pxstc.h pxstc.h pxstc.h pxstc.h Teradata Tools and Utilities Installation Guide for UNIX and Linux 233

234 Chapter 11: After You Install Verifying the Installation of Individual Products Table 77: Teradata Parallel Transporter Infrastructure Files (continued) Directory IBM AIX HP-UX Solaris Linux MP-RAS <INSTALLDIR>/inc pxutypes.h pxutypes.h pxutypes.h pxutypes.h pxutypes.h <INSTALLDIR>/inc pxdtypes.h pxdtypes.h pxdtypes.h pxdtypes.h pxdtypes.h <INSTALLDIR>/inc pxoper.h pxoper.h pxoper.h pxoper.h pxoper.h <INSTALLDIR>/inc pxos.h pxos.h pxos.h pxos.h pxos.h <INSTALLDIR>/inc pxtypes.h pxtypes.h pxtypes.h pxtypes.h pxtypes.h <INSTALLDIR>/inc pxdef.h pxdef.h pxdef.h pxdef.h pxdef.h <INSTALLDIR>/inc pxmacros.h pxmacros.h pxmacros.h pxmacros.h pxmacros.h <INSTALLDIR>/inc pxversion.h pxversion.h pxversion.h pxversion.h pxversion.h <INSTALLDIR>/lib libptmos.so libptmos.sl libptmos.so libptmos.so libptmos.so <INSTALLDIR>/lib libptmpo.so libptmpo.sl libptmpo.so libptmpo.so libptmpo.so <INSTALLDIR>/lib libptmpi.so libptmpi.sl libptmpi.so libptmpi.so libptmpi.so <INSTALLDIR>/lib libptmpi.a ibptmpi.a libptmpi.a libptmpi.a libptmpi.a <INSTALLDIR>/lib n/a libptmin.sl libptmin.so libptmin.so libptmin.so <INSTALLDIR>/lib liblogview.so liblogview.sl liblogview.so liblogview.so liblogview.so <INSTALLDIR>/lib libpxcommon.so libpxcommon.sl libpxcommon.so libpxcommon.so libpxcommon.so <INSTALLDIR>/lib libflimop.so libflimop.sl libflimop.so libflimop.so libflimop.so <INSTALLDIR>/lib libfeomop.so libfeomop.sl libfeomop.so libfeomop.so libfeomop.so <INSTALLDIR>/lib libmlimop.so libmlimop.sl libmlimop.so libmlimop.so libmlimop.so <INSTALLDIR>/msg twbmsgs.cat twbmsgs.cat twbmsgs.cat twbmsgs.cat twbmsgs.cat <INSTALLDIR>/ sample/etl <INSTALLDIR>/ sample/etl <INSTALLDIR>/ sample/etl <INSTALLDIR>/ sample/etl <INSTALLDIR>/ sample/etl <INSTALLDIR>/ sample/etl <INSTALLDIR>/ sample/etl GT11.txt GT11.txt GT11.txt GT11.txt GT11.txt GT44.txt GT44.txt GT44.txt GT44.txt GT44.txt GT62.txt GT62.txt GT62.txt GT62.txt GT62.txt GT93.txt GT93.txt GT93.txt GT93.txt GT93.txt GT94.txt GT94.txt GT94.txt GT94.txt GT94.txt GT95.txt GT95.txt GT95.txt GT95.txt GT95.txt GT96.txt GT96.txt GT96.txt GT96.txt GT96.txt 234 Teradata Tools and Utilities Installation Guide for UNIX and Linux

235 Chapter 11: After You Install Verifying the Installation of Individual Products Table 77: Teradata Parallel Transporter Infrastructure Files (continued) Directory IBM AIX HP-UX Solaris Linux MP-RAS <INSTALLDIR>/ sample/etl <INSTALLDIR>/ sample/etl <INSTALLDIR>/ sample/metadata <INSTALLDIR>/ sample/metadata <INSTALLDIR>/ sample/metadata <INSTALLDIR>/ sample/metadata GT97.txt GT97.txt GT97.txt GT97.txt GT97.txt jobvars.txt jobvars.txt jobvars.txt jobvars.txt jobvars.txt sql1.txt sql1.txt sql1.txt sql1.txt sql1.txt sql2.txt sql2.txt sql2.txt sql2.txt sql2.txt twb_status.txt twb_status.txt twb_status.txt twb_status.txt twb_status.txt twb_targets.txt twb_targets.txt twb_targets.txt twb_targets.txt twb_targets.txt /usr/bin twbpkgrm twbpkgrm twbpkgrm twbpkgrm twbpkgrm /var twbpkg twbpkg twbpkg twbpkg twbpkg Verifying Teradata Parallel Transporter Load Operator (plodc000) Table 78: Teradata Parallel Transporter Load Operator Files Directory IBM AIX HP-UX PA-RISC HP-UX Itanium Solaris Linux MP-RAS <INSTALLDIR>/lib libloadop.so libloadop.sl n/a libloadop.so libloadop.so libloadop.so <INSTALLDIR>/lib64 libloadop.so libloadop.sl libloadop.so libloadop.so libloadop.so n/a <INSTALLDIR>/sample ldnfyext.c ldnfyext.c ldnfyext.c ldnfyext.c ldnfyext.c ldnfyext.c Verifying Teradata Parallel Transporter ODBC Operator (podbcc000) Table 79: Teradata Parallel Transporter ODBC Operator Files Directory IBM AIX HP-UX Solaris Linux MP-RAS <INSTALLDIR>/lib libodbcop.so libodbcop.sl libodbcop.so libodbcop.so libodbcop.so Teradata Tools and Utilities Installation Guide for UNIX and Linux 235

236 Chapter 11: After You Install Verifying the Installation of Individual Products Verifying Teradata Parallel Transporter Operator Support Library (poslc000) Table 80: Teradata Parallel Transporter Operator Support Library Files Directory IBM AIX HP-UX PA-RISC HP-UX Itanium Solaris Linux MP-RAS <INSTALLDIR>/lib libopcommon. so libopcommon.sl n/a libopcommon. so libopcommon. so libopcommon. so <INSTALLDIR>/ lib64 libopcommon. so libopcommon.sl libopcommon.so libopcommon. so libopcommon. so n/a <INSTALLDIR>/msg opermsgs.cat opermsgs.cat n/a opermsgs.cat opermsgs.cat opermsgs.cat <INSTALLDIR>/ msg64 opermsgs.cat opermsgs.cat opermsgs.cat opermsgs.cat opermsgs.cat n/a Verifying Teradata Parallel Transporter OS Command Operator (poscc000) Table 81: Teradata Parallel Transporter OS Command Operator Files Directory IBM AIX HP-UX Solaris Linux MP-RAS <INSTALLDIR>/lib liboscmdop.so liboscmdop.sl liboscmdop.so liboscmdop.so liboscmdop.so Verifying Teradata Parallel Transporter SQL Inserter Operator (pinsc000) Table 82: Teradata Parallel Transporter SQL Inserter Operator Files Directory IBM AIX HP-UX Solaris Linux MP-RAS <INSTALLDIR>/lib libinsertop.so libinsertop.sl libinsertop.so libinsertop.so libinsertop.so Verifying Teradata Parallel Transporter SQL Selector Operator (pselc000) Table 83: Teradata Parallel Transporter SQL Selector Operator Files Directory IBM AIX HP-UX Solaris Linux MP-RAS <INSTALLDIR>/lib libselectop.so libselectop.sl libselectop.so libselectop.so libselectop.so 236 Teradata Tools and Utilities Installation Guide for UNIX and Linux

237 Chapter 11: After You Install Verifying the Installation of Individual Products Verifying Teradata Parallel Transporter Stream Operator (pstmc000) Table 84: Teradata Parallel Transporter Stream Operator Files Directory IBM AIX HP-UX PA-RISC HP-UX Itanium Solaris Linux MP-RAS <INSTALLDIR>/lib libstreamop.s o libstreamop.s l n/a libstreamop.s o libstreamop.s o libstreamop.s o <INSTALLDIR>/lib64 libstreamop.s o libstreamop.s l libstreamop.s o libstreamop.s o libstreamop.s o n/a <INSTALLDIR>/ sample stmnfyxt.c stmnfyxt.c stmnfyxt.c stmnfyxt.c stmnfyxt.c stmnfyxt.c Verifying Teradata Parallel Transporter Update Operator (pupdc000) Table 85: Teradata Parallel Transporter Update Operator Files Directory IBM AIX HP-UX PA-RISC HP-UX Itanium Solaris Linux MP-RAS <INSTALLDIR>/lib libupdateop.s o libupdateop.s l n/a libupdateop.s o libupdateop.s o libupdateop.s o <INSTALLDIR>/lib64 libupdateop.s o libupdateop.s l libupdateop.s o libupdateop.s o libupdateop.s o n/a <INSTALLDIR>/ sample updnfyxt.c updnfyxt.c updnfyxt.c updnfyxt.c updnfyxt.c updnfyxt.c Verifying WebSphere MQ Access Module (mqaxsmod) An asterisk (*) after a name in the following table indicates that it is a softlink for files that have been moved to the /opt/teradata/client/lib and the /opt/teradata/client/opt directories. Table 86: WebSphere MQ Access Module Files Directory IBM AIX HP-UX Solaris Linux MP-RAS /usr/lib libmqsc.so* libmqsc.sl* libmqsc.so* libmqsc.so* libmqsc.so* /usr/lib libmqsctwb.so* libmqsctwb.sl* libmqsctwb.so* libmqsctwb.so libmqsctwb.so* /usr/lib libmqs.so* libmqs.sl* libmqs.so* n/a n/a /usr/lib libmqstwb.so* libmqstwb.sl* libmqstwb.so* n/a n/a /opt mqaxsmod* mqaxsmod* mqaxsmod* n/a mq_axsmod* /usr/lib/lib_64 n/a n/a n/a n/a n/a Teradata Tools and Utilities Installation Guide for UNIX and Linux 237

238 Chapter 11: After You Install Verifying the Installation of Individual Products Table 86: WebSphere MQ Access Module Files (continued) Directory IBM AIX HP-UX Solaris Linux MP-RAS /usr/lib/lib_64 n/a n/a n/a n/a n/a /opt/teradata/client/lib libmqsc.so libmqsc.sl libmqsc.so libmqsc.so libmqsc.so /opt/teradata/client/lib libmqsctwb.so libmqsctwb.sl libmqsctwb.so libmqsctwb.so libmqsctwb.so /opt/teradata/client/lib libmqs.so libmqs.sl libmqs.so n/a n/a /opt/teradata/client/lib libmqstwb.so libmqstwb.sl libmqstwb.so n/a n/a /opt/teradata/client/opt mqaxsmod mqaxsmod mqaxsmod n/a mq_axsmod 238 Teradata Tools and Utilities Installation Guide for UNIX and Linux

239 Chapter 11: After You Install Verifying the Installation Using BTEQ Verifying the Installation Using BTEQ Using Basic Teradata Query (BTEQ) is the simplest way to verify that you have installed the software properly. BTEQ files were copied over during the installation of product software on your system. The following sections describe these steps in detail. Refer to Basic Teradata Query Reference for information on how to use BTEQ. Procedure - Verifying the Teradata Tools and Utilities Installation Follow these steps to verify the Teradata Tools and Utilities installation. 1 Add the directory where BTEQ resides to the search path, and change directories to that directory. 2 Start BTEQ by entering: bteq The following will be displayed: Teradata BTEQ for UNIX5. Copyright , NCR Corporation. ALL RIGHTS RESERVED. Enter your logon or BTEQ command: 3 Log on to the Teradata Database. See Log on to the Teradata Database on page Submit a sample query. See Submit a Sample Teradata SQL Query on page 240. Log on to the Teradata Database Complete the steps below to log on to the Teradata Database. You will need a user ID and password for the Teradata Database with which you will be communicating. Note: See Making the Database Connection on page 243 for complete information about logging onto Teradata. Procedure - Logging on to the Teradata Database Follow these steps to log on to the Teradata Database. 1 Enter the BTEQ logon command with your logon ID. Include your dbcpath if the Teradata Database dbcpath is not the default i_dbcpath specified in clispb.dat. The syntax of the.logon command is:.logon dbcpath/username 2 When prompted, enter your password. For example, if the Teradata Database with which you are communicating has a dbcpath of Finance, your username is fml and your password is fml, enter:.logon Finance/fml Password: fml If the logon is successful, the following will be displayed: *** Logon successfully completed. Teradata Tools and Utilities Installation Guide for UNIX and Linux 239

240 Chapter 11: After You Install Verifying the Installation Using BTEQ *** Transaction Semantics are BTET. *** Character Set Name is 'ASCII'. *** Total elapsed time was 1 second. BTEQ -- Enter your DBC/SQL request or BTEQ command: Submit a Sample Teradata SQL Query After successfully logging on to the Teradata Database, try the following sample query, which displays the time of day. Procedure - Submitting a Sample Teradata SQL Query Follow these steps to submit a sample Teradata SQL query. 1 At the prompt, type: SELECT time; The screen will look like this: BTEQ select time output: *** Query completed. One row found. One column returned. *** Total elapsed time was 1 second. Time :09:11 Exit BTEQ After verifying the time returned by the SQL query, log off the Teradata Database. Procedure - Logging off the Teradata Database Follow these steps to log off the Teradata Database. 1 To log off the Teradata Database and exit BTEQ, enter:.quit The host prompt will be displayed. 240 Teradata Tools and Utilities Installation Guide for UNIX and Linux

241 Chapter 11: After You Install Verifying the Installation Using the CLI Sample Program Verifying the Installation Using the CLI Sample Program Another way to verify that you have installed the software properly is to run the sample CLI application called clisamp. The program and its makefile were copied over during installation of the software. Run clisamp Procedure - Running clisamp Follow these steps to verify that software has been installed properly. 1 Modify the makefile makesamp.3000 with the correct directory paths to the include files. 2 Execute the makefile to create the executable module clisamp: # make -f makesamp Change the mode of the executable to execute by entering the following command: # chmod +x clisamp 4 Run the sample program using one of the following commands: To run the sample program using the default logon information (dbc/systemfe,service) enter: # 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 The program will logon to the default dbccop1 (no user input supplied) specified in the / etc/hosts file and execute a simple query SELECT * from dbc.sessioninfo;" and write the output to dat file clisamp.dat. A display similar to the following appears: 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; writintg out to --> CLISAMP.DAT Logging off. Teradata Tools and Utilities Installation Guide for UNIX and Linux 241

242 Chapter 11: After You Install Verifying the Installation Using the CLI Sample Program 242 Teradata Tools and Utilities Installation Guide for UNIX and Linux

243 CHAPTER 12 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. 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. The user logon exit routine can be used to manipulate the fields of the Connect to Teradata Database dialog. Teradata Tools and Utilities Installation Guide for UNIX and Linux 243

244 Chapter 12: Connecting to a Teradata Database Making the Database Connection 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 - Connecting to a Teradata Database Follow these steps 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 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 The fields in the Connect to Teradata Database dialog are: 244 Teradata Tools and Utilities Installation Guide for UNIX and Linux