Teradata Tools and Utilities for IBM AIX Installation Guide Release B A November 2011

Transcription

1 Teradata Tools and Utilities for IBM AIX Installation Guide Release B A November 2011

2 The product or products described in this book are licensed products of Teradata Corporation or its affiliates. Teradata, Active Enterprise Intelligence, Applications Within, Aprimo, Aprimo Marketing Studio, Aster, BYNET, Claraview, DecisionCast, Gridscale, Managing the Business of Marketing, MyCommerce, Raising Intelligence, Smarter. Faster. Wins., SQL-MapReduce, Teradata Decision Experts, Teradata Labs Logo, Teradata Raising Intelligence Logo, Teradata Source Experts, WebAnalyst, and Xkoto are trademarks or registered trademarks of Teradata Corporation or its affiliates in the United States and other countries. Adaptec and SCSISelect are trademarks or registered trademarks of Adaptec, Inc. AMD Opteron and Opteron are trademarks of Advanced Micro Devices, Inc. EMC, PowerPath, SRDF, and Symmetrix are registered trademarks of EMC Corporation. GoldenGate is a trademark of Oracle. Hewlett-Packard and HP are registered trademarks of Hewlett-Packard Company. Intel, Pentium, and XEON are registered trademarks of Intel Corporation. IBM, CICS, RACF, Tivoli, and z/os are registered trademarks of International Business Machines Corporation. Linux is a registered trademark of Linus Torvalds. LSI is a registered trademark 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. NetVault is a trademark or registered trademark of Quest Software, Inc. in the United States and/or other countries. Novell and SUSE are registered trademarks of Novell, Inc., in the United States and other countries. Oracle, Java, and Solaris are registered trademarks of Oracle and/or its affiliates. QLogic and SANbox are trademarks or registered trademarks of QLogic Corporation. SAS and SAS/C are trademarks or registered trademarks of SAS Institute Inc. SPARC is a registered trademark of SPARC International, Inc. 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 registered trademark of Unicode, Inc. in the United States and other countries. 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 [email protected] Any comments or materials (collectively referred to as Feedback ) sent to Teradata Corporation will be deemed non-confidential. Teradata Corporation will have no obligation of any kind with respect to Feedback and will be free to use, reproduce, disclose, exhibit, display, transform, create derivative works of, and distribute the Feedback and derivative works thereof without limitation on a royalty-free basis. Further, Teradata Corporation will be free to use any ideas, concepts, know-how, or techniques contained in such Feedback for any purpose whatsoever, including developing, manufacturing, or marketing products or services incorporating Feedback. Copyright by Teradata Corporation. All Rights Reserved.

3 Table of Contents Preface...7 Purpose...7 Audience...7 Supported Releases...7 Prerequisites...8 Changes to This Documentation...8 Chapter 1: Prepare for Installation...9 Introduction to Installing Teradata Tools and Utilities from DVD...9 Installation Kit Contents...9 DVD Contents...9 Supported Versions...11 Product Descriptions...11 Product Dependencies...12 Installing Dependencies...14 System Requirements...15 Chapter 2: Uninstall Previous Software...17 Uninstall Script Overview...17 Uninstall Script Operation...17 Uninstall Script Usage and Parameters...18 Usage...18 Parameters...18 Teradata Tools and Utilities Packages Removed...19 Typical Output...20 Library File Checking Output...20 Manually Removing Packages...21 Teradata Tools and Utilities for IBM AIX Installation Guide 3

4 Table of Contents Chapter 3: Install New Software...23 Installing Third Party Software...23 Installing C, C++ Compiler...23 Teradata WebSphere MQ Access Module...23 Installing Teradata Tools and Utilities...24 Installation Order...24 Installing Teradata Tools and Utilities...24 Teradata Developer Exchange...26 Products Available from Teradata Developer Exchange...26 Downloading a Product from the Teradata Developer Exchange...27 Installing Products Downloaded from Teradata Developer Exchange...27 Teradata Software Server...28 Downloading Patches...28 Installing Downloaded Patches...29 Adding CLI User Exit Functions...29 Chapter 4: Configure New Software...31 Overview of Configuring ODBC Driver for Teradata...31 About Configuring Teradata Parallel Transporter...31 Editing twbcfg.ini...31 Selecting Teradata Parallel Transporter Installation Directory...32 Selecting Checkpoint and Log Directories in the Configuration File...33 Selecting the System Kernel Values...33 Updating Environment Variables for Teradata Parallel Transporter...34 Switching IPC Memory to Shared Memory...35 Switching IPC Memory to Mapped Memory...35 Chapter 5: Restart the Client Computer...37 Restarting the Client Computer Teradata Tools and Utilities for IBM AIX Installation Guide

5 Table of Contents Chapter 6: Verify the Complete Installation...39 About Verifying the Installation...39 Verifying the Installation Using Basic Teradata Query...39 Verifying the Installation Using CLI Sample Program...40 Basic Teradata Query Files and Directories...41 Named Pipe Access Module Files and Directories...41 ODBC Driver for Teradata Files and Directories...41 Shared Common Components for Internationalization for Teradata Files and Directories...44 Teradata C Preprocessor2 Files and Directories...47 Teradata Call-Level Interface version 2 Files and Directories...48 Teradata COBOL Preprocessor2 Files and Directories...49 Teradata Data Connector Files and Directories...50 Teradata FastExport Files and Directories...51 Teradata FastLoad Files and Directories...51 Teradata Generic Security Services Files and Directories...52 Teradata JDBC Driver Files and Directories...52 Teradata MultiLoad Files and Directories...52 Teradata Parallel Data Pump Files and Directories...53 Teradata Wallet Files and Directories...53 Teradata WebSphere MQ Access Module Files and Directories...54 Chapter 7: Security and Connecting to a Teradata Database...55 About Connecting to a Teradata Database...55 About Logon Procedures...55 Connecting to a Teradata Database from a GUI Application...55 Connecting to a Teradata Database from a Command Line Application...57 LDAP Logon Examples...58 Implicit Logon...58 Accounting Information...58 TD2 Logon Examples...59 TD2 Logon Mechanisms...59 TD2 Logon...59 Connecting to a Teradata Database Programmatically...59 Checking Logon Error Messages...60 Teradata Tools and Utilities for IBM AIX Installation Guide 5

6 Table of Contents Chapter 8: Troubleshooting the Installation...61 Client Computer Problem: Cannot Communicate Over the Network with Teradata Database...61 Client Computer Problem: Incorrect Path Name in COPLIB...61 Client Computer Problem: Incorrect Path Name in COPERR...62 Client Computer Problem: errmsg.cat File Not Found...62 Client Computer Problem: Incorrect Path Name in COPANOMLOG...62 Client Computer Problem: Missing Hosts File...63 Client Computer Problem: Incorrect Entries in the Hosts File...63 Client Computer Problem: Missing Entries in the /etc/services File...63 Client Computer Problem: Improper Linking...63 Client Computer Problem: Incorrect clispb.dat Parameters...63 Client Computer Problem: Cannot Log On from CLI Application...64 Client Computer Problem: Cannot Log On to Teradata Database...64 Network Problems...64 Teradata Database Problem...65 Teradata Parallel Transporter Problem: Unable to Find tbuild...66 Teradata Parallel Transporter Problem: Can Not Run New Version of Teradata Parallel Transporter...66 Teradata Parallel Transporter Problem: Failed to Load libpxcommon Library...67 Teradata Parallel Transporter Problem: Unable to Find Messages...67 Technical Assistance...67 Chapter 9: Deploy Teradata Tools and Utilities with TAR...69 Deploying Applications with TAR...69 TAR Script Information...69 TAR Script Compatibility with Platform Operating Systems...69 TAR File Contents...69 Verifying TAR Script Dependencies are Installed...70 TAR Script Commands and Their Functions...70 TAR Script Usage Considerations...72 Downloading Windows Utility Software for TAR Deployment...73 Overview of TAR Script Examples...74 Archiving SPARC Packages to Windows...74 Archiving a Single Package to UNIX Teradata Tools and Utilities for IBM AIX Installation Guide

7 Preface Purpose This book describes how to install and deploy Teradata Tools and Utilities Release software on a computer that runs on a supported operating system. Teradata Tools and Utilities is a group of products designed to work with the Teradata Database. Audience This guide is intended for use by: Database administrators and relational database developers System administrators System and application programmers System operators and other database specialists Supported Releases This book supports the following releases: Teradata Database Release 14.0 Teradata Tools and Utilities Release To locate detailed supported-release information: 1 Go to 2 Under Online Publications, click General Search. 3 Type 3119 in the Publication Product ID box. 4 Under Sort By, select Date. 5 Click Search. 6 Open the version of the Teradata Tools and Utilities ##.##.## Supported Platforms and Product Versions spreadsheet associated with this release. The spreadsheet includes supported Teradata Database versions, platforms, and product release numbers. Teradata Tools and Utilities for IBM AIX Installation Guide 7

8 Preface Prerequisites Prerequisites You should be familiar with: Computer technology and terminology Relational database management systems Utilities that load and retrieve data Changes to This Documentation Date November August Description The following changes were made to support the November release of Teradata Tools and Utilities: Teradata JDBC Driver was added. Teradata Wallet was added. The uninstall script, uninstall_ttu.sh, was added. Initial release 8 Teradata Tools and Utilities for IBM AIX Installation Guide

9 CHAPTER 1 Prepare for Installation Introduction to Installing Teradata Tools and Utilities from DVD Before performing the procedures in this document, you must have: Network access Administrative privileges on the target machine Knowledge of which Teradata Tools and Utilities are to be installed Familiarity with UNIX file and path name conventions Access to a bill of materials or similar list of Teradata Tools and Utilities software that was ordered Familiarity with software installation Installation Kit Contents The installation kit contains the following documentation and application media: Teradata User Documentation CD (Teradata Database 14.0, Teradata Tools and Utilities 14.00) Teradata Tools and Utilities AIX - HP-UX - LINUX - Solaris - Windows Release DVD If you did not receive all the installation media ordered, contact the Teradata Solutions Customer Services Remote Services Center (TSCS-RSC). For information on how to contact TSCS-RSC, see B C, Teradata Tools and Utilities Release Definition Release DVD Contents The following table shows the Teradata Tools and Utilities products and dependencies contained on the Installation Kit media. Product Basic Teradata Query Named Pipes Access Module Install From... Teradata Tools and Utilities AIX - HP-UX - LINUX - Solaris - Windows Release DVD Teradata Tools and Utilities AIX - HP-UX - LINUX - Solaris - Windows Release DVD Teradata Tools and Utilities for IBM AIX Installation Guide 9

10 Chapter 1 Prepare for Installation Introduction to Installing Teradata Tools and Utilities from DVD Product ODBC Driver for Teradata Shared Common Components for Internationalization for Teradata Teradata C Preprocessor2 Teradata Call-Level Interface version 2 Teradata COBOL Preprocessor2 Teradata Data Connector Teradata FastExport Teradata FastLoad Teradata Generic Security Services Client Teradata JDBC Driver Teradata JMS Access Module Teradata MultiLoad Teradata Parallel Data Pump Teradata Parallel Transporter Base Teradata Parallel Transporter Stream Teradata Wallet Teradata WebSphere MQ Access Module Install From... Teradata Tools and Utilities AIX - HP-UX - LINUX - Solaris - Windows Release DVD Teradata Tools and Utilities AIX - HP-UX - LINUX - Solaris - Windows Release DVD Teradata Tools and Utilities AIX - HP-UX - LINUX - Solaris - Windows Release DVD Teradata Tools and Utilities AIX - HP-UX - LINUX - Solaris - Windows Release DVD Teradata Tools and Utilities AIX - HP-UX - LINUX - Solaris - Windows Release DVD Teradata Tools and Utilities AIX - HP-UX - LINUX - Solaris - Windows Release DVD Teradata Tools and Utilities AIX - HP-UX - LINUX - Solaris - Windows Release DVD Teradata Tools and Utilities AIX - HP-UX - LINUX - Solaris - Windows Release DVD Teradata Tools and Utilities AIX - HP-UX - LINUX - Solaris - Windows Release DVD Teradata Tools and Utilities AIX - HP-UX - LINUX - Solaris - Windows Release DVD Teradata Tools and Utilities AIX - HP-UX - LINUX - Solaris - Windows Release DVD Teradata Tools and Utilities AIX - HP-UX - LINUX - Solaris - Windows Release DVD Teradata Tools and Utilities AIX - HP-UX - LINUX - Solaris - Windows Release DVD Teradata Tools and Utilities AIX - HP-UX - LINUX - Solaris - Windows Release DVD Teradata Tools and Utilities AIX - HP-UX - LINUX - Solaris - Windows Release DVD Teradata Tools and Utilities AIX - HP-UX - LINUX - Solaris - Windows Release DVD Teradata Tools and Utilities AIX - HP-UX - LINUX - Solaris - Windows Release DVD For information on products that can or must be downloaded from Teradata Developer Exchange, see Products Available from Teradata Developer Exchange. 10 Teradata Tools and Utilities for IBM AIX Installation Guide

11 Chapter 1 Prepare for Installation Introduction to Installing Teradata Tools and Utilities from DVD Supported Versions Teradata Tools and Utilities Version xx xx xx Versions Chart B K, Teradata Tools and Utilities xx Supported Platforms and Product Versions B K, Teradata Tools and Utilities xx Supported Platforms and Product Versions B K, Teradata Tools and Utilities xx Supported Platforms and Product Versions B K, Teradata Tools and Utilities Supported Platforms and Product Versions Product Descriptions Product Basic Teradata Query Named Pipes Access Module ODBC Driver for Teradata Shared Common Components for Internationalization for Teradata Teradata C Preprocessor2 Teradata Call-Level Interface version 2 Teradata COBOL Preprocessor2 Teradata Data Connector Teradata FastExport Description Provides workstation users with command-line-based communication with one or more Teradata Database systems and formatting of reports for both print and screen output. Provides an interprocess communication link between a writer process, such as Teradata FastExport, and a reader process, such as Teradata FastLoad. Named Pipes Access Module works for Teradata Parallel Transporter and the standalone utilities (Teradata FastExport, Teradata FastLoad, Teradata MultiLoad, and Teradata Parallel Data Pump). Enables operating systems to communicate with the Teradata Database across local area networks using the open standards ODBC interface. With ODBC Driver for Teradata, connects applications to the Teradata Database. A library of routines based on the IBM International Components for Unicode version 3.6. The library provides Unicode support. Provides the application programmer with a simplified method of reading and changing information stored in the Teradata Database by interpreting and expanding SQL statements that have been incorporated in an application program. A library of routines that enable an application program to access data on the Teradata Database. Provides the application programmer with a simplified method of reading and changing information stored in a Teradata Database by interpreting and expanding SQL statements that have been incorporated in an application program. Reads and writes flat files to provide the input/output interface for access modules. A command-driven utility that uses multiple sessions to quickly transfer large amounts of data from tables and views of the Teradata Database to a client based application. Teradata Tools and Utilities for IBM AIX Installation Guide 11

12 Chapter 1 Prepare for Installation Introduction to Installing Teradata Tools and Utilities from DVD Product Teradata FastLoad Teradata Generic Security Services Client Teradata JDBC Driver Teradata JMS Access Module Teradata MultiLoad Teradata Parallel Data Pump Teradata Parallel Transporter Base Teradata Parallel Transporter Stream Teradata Wallet Teradata WebSphere MQ Access Module Description A command-driven utility that quickly loads large amounts of data to empty tables in the Teradata Database. Teradata FastLoad uses multiple sessions to load data; however, it loads data into only one table on the Teradata Database per job. Teradata implementation of industry-standard Generic Security Services APIs in C language. It provides enhanced security services interfaces between Teradata network clients and the Teradata Database. Provides access to the Teradata Database using Java applications. Note: Can be downloaded and installed from the web. A utility that provides a fast, reliable, asynchronous method to transfer data between any JMS-enabled messaging system and Teradata Database. Teradata JMS Access Module works for Teradata Parallel Transporter and the standalone utilities (Teradata FastExport, Teradata FastLoad, Teradata MultiLoad, and Teradata Parallel Data Pump). Provides an efficient way to deal with batch maintenance of large databases. Teradata MultiLoad is a command-driven utility for fast, high-volume maintenance on multiple tables and views of the Teradata Database. A data loading utility that helps maintain the data in the Teradata Database. Teradata Parallel Data Pump uses standard Teradata SQL to achieve moderate to high data loading rates to the Teradata Database. Object-oriented client application that provides scalable, high-speed, parallel data extraction, loading, and updating. A consumer operator that emulates the Teradata Parallel Data Pump utility to perform high-speed DML transactions (SQL INSERT, UPDATE, DELETE, or UPSERT) in a near-real-time mode to a table (or tables) while queries are performed on the table (or tables). Enables users to securely store private information, such as Teradata Database passwords, on client computers. The stored information can then be used when logging in to the Teradata Database. Allows Teradata utilities to import data using IBM Teradata WebSphere MQ Access Module message queuing middleware. Teradata WebSphere MQ Access Module works for Teradata Parallel Transporter and the standalone utilities (Teradata FastExport, Teradata FastLoad, Teradata MultiLoad, and Teradata Parallel Data Pump). Product Dependencies Product Teradata Tools and Utilities Dependencies Third-party Dependencies Basic Teradata Query Shared Common Components for Internationalization for Teradata Teradata Call-Level Interface version 2 Teradata Data Connector None 12 Teradata Tools and Utilities for IBM AIX Installation Guide

13 Chapter 1 Prepare for Installation Introduction to Installing Teradata Tools and Utilities from DVD Product Teradata Tools and Utilities Dependencies Third-party Dependencies Teradata Generic Security Services Client Named Pipes Access Module None None ODBC Driver for Teradata Shared Common Components for Internationalization for Teradata Teradata C Preprocessor2 Teradata Call-Level Interface version 2 Teradata COBOL Preprocessor2 Teradata Data Connector Teradata FastExport Teradata FastLoad Teradata Generic Security Services Client Shared Common Components for Internationalization for Teradata Teradata Generic Security Services Client None Shared Common Components for Internationalization for Teradata Teradata Call-Level Interface version 2 Teradata Generic Security Services Client Shared Common Components for Internationalization for Teradata Teradata Generic Security Services Client Shared Common Components for Internationalization for Teradata Teradata Call-Level Interface version 2 Teradata Generic Security Services Client None Shared Common Components for Internationalization for Teradata Teradata Call-Level Interface version 2 Teradata Data Connector Teradata Generic Security Services Client Shared Common Components for Internationalization for Teradata Teradata Call-Level Interface version 2 Teradata Data Connector Teradata Generic Security Services Client None Microsoft Data Access Components (MDAC), version 2.8 SP1 (on distribution DVD) IBM XL C/C++ Compiler V9.0 (runtime libraries fileset xlc.rte v9.x.x.x) or later None None None None None None None Teradata JDBC Driver None JDK 1.4, JDK 5.0, or JDK 6.0 Note: The environment can be downloaded from Java Downloads. Teradata Tools and Utilities for IBM AIX Installation Guide 13

14 Chapter 1 Prepare for Installation Introduction to Installing Teradata Tools and Utilities from DVD Product Teradata Tools and Utilities Dependencies Third-party Dependencies Teradata JMS Access Module None None Teradata MultiLoad Teradata Parallel Data Pump Teradata Parallel Transporter Base Teradata Parallel Transporter Stream Shared Common Components for Internationalization for Teradata Teradata Call-Level Interface version 2 Teradata Data Connector Teradata Generic Security Services Client Shared Common Components for Internationalization for Teradata Teradata Call-Level Interface version 2 Teradata Data Connector Teradata Generic Security Services Client Shared Common Components for Internationalization for Teradata Teradata Call-Level Interface version 2 Teradata Generic Security Services Client Teradata Call-Level Interface version 2 Teradata Generic Security Services Client Teradata Parallel Transporter Base None None None Note: The environment can be downloaded from Java Downloads. None Teradata Wallet None None Teradata WebSphere MQ Access Module Teradata Data Connector IBM WebSphere MQ V5.2 Installing Dependencies The Teradata Tools and Utilities installation automatically installs dependent products. A message appears if a dependent product already exists on the client system for one of the following products: ODBC Driver for Teradata Shared Common Components for Internationalization for Teradata Teradata Call-Level Interface version 2 Teradata Data Connector Teradata Generic Security Services Client The installation displays one of these messages: If the version of the product on the system is the same as the version of the product being installed, a message like this appears: ODBC Driver for Teradata is already installed. Do you want to reinstall it? If the version of the product on the system is different than the version of the product being installed, a message like this appears: 14 Teradata Tools and Utilities for IBM AIX Installation Guide

15 Chapter 1 Prepare for Installation Introduction to Installing Teradata Tools and Utilities from DVD ODBC Driver for Teradata is already installed. Do you want to overwrite it with version ? System Requirements When installing on a UNIX system, use the Korn shell (/bin/ksh) before running the installation procedure for Teradata Tools and Utilities. This ensures correct execution of the installation script. Transmission Control Protocol/Internet Protocol (TCP/IP) is used to communicate with the Teradata Database. The client must be connected to one of the following: The same Ethernet LAN as the Teradata Database 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. The appropriate Ethernet hardware and software supporting a TCP/IP-based network must be installed on every Teradata Database with which the client communicates. Teradata Tools and Utilities for IBM AIX Installation Guide 15

16 Chapter 1 Prepare for Installation Introduction to Installing Teradata Tools and Utilities from DVD 16 Teradata Tools and Utilities for IBM AIX Installation Guide

17 CHAPTER 2 Uninstall Previous Software Uninstall Script Overview Before installing new Teradata Tools and Utilities software, previous versions of Teradata Tools and Utilities software must be removed. Use the uninstall script, uninstall_ttu.sh, located in the root directory on the media, to remove previous versions of Teradata Tools and Utilities software. It removes all Teradata Tools and Utilities packages, including dependency packages, in the correct order. When the uninstall script is executed from the main install script, it offers to remove packages from previous versions of TTU and leave any current versions installed. The uninstall script can be used before installing a new or a specific version of Teradata Tools and Utilities software or if decommissioning Teradata Tools and Utilities software from a particular system. The uninstall script can specify individual packages to be removed. Teradata recommends that you remove the dependency products (CLIv2, PIOM, TDICU, and TeraGSS) last; however they can be removed individually regardless of the order. Caution: If a dependency product is removed without reinstalling a new version, the products that depend on that product cease to function. For example, if CLIv2 is removed, all products that depend on CLIv2 fail. The uninstall script warns you if the product you have asked to remove is a dependency and asks if you are sure you want to remove it. The uninstall script does not require any parameters to execute and all information within the script is displayed. The uninstall script must be executed as root or with root privileges, as it uses system packaging commands to remove packages. Uninstall Script Operation The uninstall script: 1. Searches for packages with "Teradata" in the package name installed on the system 2. Creates an internal list of currently installed Teradata Tools and Utilities packages 3. Checks the created list against a list of known Teradata Tools and Utilities packages (so only Teradata Tools and Utilities packages will be removed) 4. Reorders the created list to remove dependency products last 5. Displays the list with additional information so you can decide whether to remove the packages or not Teradata Tools and Utilities for IBM AIX Installation Guide 17

18 Chapter 2 Uninstall Previous Software Uninstall Script Overview After the package removal process is complete, the uninstall script checks to see if any Teradata Tools and Utilities packages remain on the system. If any Teradata Tools and Utilities packages are found, it displays a list of those packages. Not all packages with "Teradata" in the package name are Teradata Tools and Utilities packages. Teradata DBS packages, for example, might contain "Teradata" in the package name, but would not be in the list of known Teradata Tools and Utilities packages. Uninstall Script Usage and Parameters Usage Command uninstall_ttu.sh uninstall_ttu.sh priorto xx.xx.xx.xx uninstall_ttu.sh noremove uninstall_ttu.sh nocheck Description Executes the script to remove packages Removes all packages before a specific version number Executes the script, but does not remove any packages Executes the script, but does not check against known Teradata Tools and Utilities packages Parameters Parameter priorto xx.xx.xx.xx noremove nocheck Description Removes packages prior to a specified version If the packages to be installed on a system are from Teradata Tools and Utilities version 14.00, and packages prior to this version (for example, 13.10, 13.0, or 12.00) need to be removed, enter priorto The number parameter must contain all four version numbers, and can be specific enough to remove all packages before, for example, Typically the last two sets of digits would just be Executes the script without removing packages This parameter can be used to test the script without removing the packages. The package remove commands that would have been used to remove each package are displayed. This may be useful to do a test package remove without actually removing the packages, to see in what order the packages would have been removed, or to capture the commands used to remove the packages for use in another script. Executes the script looking for packages with "Teradata" in the package name, but skipping the check against the known list of Teradata Tools and Utilities packages 18 Teradata Tools and Utilities for IBM AIX Installation Guide

19 Chapter 2 Uninstall Previous Software Uninstall Script Overview Parameter Description This may be useful for packages the script does not know about or additional "Teradata" packages (not Teradata Tools and Utilities) that you may want to remove. Caution: Use this parameter with care, particularly if run on a Teradata DBS node, as important Database packages could be removed. debug Outputs useful debugging input to a file in /tmp/remove-tcpdebug-<processid>.out This may be useful for debugging purposes. It lists the known Teradata Tools and Utilities packages, the initial list of the packages selected, and the final ordered list, and could be helpful in determining why a package was not removed. Teradata Tools and Utilities Packages Removed The uninstall script recognizes the following Teradata Tools and Utilities packages: Basic Teradata Query (bteq) DUL/Dultape (dul and dultape) Named Pipes Access Module (npaxsmod) ODBC Driver for Teradata (tdodbc and tdodbc64) Shared Common Components for Internationalization for Teradata (tdicu, tdicu_64, and so on) SQL C Preprocessor (sqlpp) Teradata Call-Level Interface version 2 (cliv2, cliv2_64, cliv2so, and so on) Teradata COBOL Preprocessor2 (cobpp) Teradata Data Connector (piom) Teradata FastExport (fastexp) Teradata FastLoad (fastld) Teradata Generic Security Services Client (TeraGSS) Teradata JMS Access Module (jmsaxsmod) Teradata MultiLoad (mload) Teradata Parallel Data Pump (tpump) Teradata Query Director (qrydir and sockclient) All Teradata Parallel Transporter packages up to Teradata Tools and Utilities13.10 (Teradata Tools and Utilities 13.10, 13.0, and 12.0; TWB 5.0; TPT 8.1, 8.2, and 12.0) Teradata Parallel Transporter Base (TTU14.00) (tptbase) Teradata Parallel Transporter Stream (TTU14.00) (tptstream) Teradata Wallet (tdwallet) Teradata WebSphere MQ Access Module (mqaxsmod) This list is subject to change as future products are added to Teradata Tools and Utilities. On rare occasions files are left on systems after improper installations or uninstallations or if very old Teradata Tools and Utilities packages were installed by copying files to the /usr/ Teradata Tools and Utilities for IBM AIX Installation Guide 19

20 Chapter 2 Uninstall Previous Software Uninstall Script Overview bin or /usr/lib directories. The uninstall script checks and displays a warning message that the files still exist and may cause problems. The script offers to rename the files and displays the command to remove them. The script does not delete the files automatically. If the files for the following products exist in the /usr/lib directory, the uninstall script renames them and adds the extension teradata-package-remove.old: ODBC Driver for Teradata Shared Common Components for Internationalization for Teradata Teradata Call-Level Interface version 2 Teradata Data Connector Teradata Generic Security Services Client Typical Output Package Removal Type: installp The following packages are installed: 1. bteq fastexp fastld mload mload mqaxsmod npaxsmod npaxsmod tdodbc tdwallet tptstream tpump tpump tptbase piom cliv cliv tdicu tdicu TeraGSS TeraGSS f. Display the full package information on the packages listed. a. Remove all of the above software. h. Display help information. q. Quit the package remove script. Enter one or more selections (separated by space): 16 cliv is a product dependency. Are you sure you wish to remove it? [Y/N] > Library File Checking Output If all files are not removed, output similar to this appears: 20 Teradata Tools and Utilities for IBM AIX Installation Guide

21 Chapter 2 Uninstall Previous Software Uninstall Script Overview WARNING: Teradata Libraries were found after post package removal. /usr/lib/libcliv2.so /usr/lib/libtdusr.so /usr/lib/libpm.so /usr/lib/libicudatatd.so /usr/lib/libicui18ntd.so /usr/lib/libicuiotd.so /usr/lib/libiculetd.so /usr/lib/libiculxtd.so /usr/lib/libicuuctd.so These files/softlinks may be the result of broken package uninstall and may interfere with future Teradata Client installations. Would you like to move these files to <filename>.teradata-package-remove.old in order to prevent this conflict? [Y/N] (default N): If you answer yes when asked if you would like to move these files, output similar to this appears: Moving /usr/lib/libcliv2.so to /usr/lib/libcliv2.so-teradata-package-remove.old Moving /usr/lib/libtdusr.so to /usr/lib/libtdusr.so-teradata-package-remove.old Moving /usr/lib/libpm.so to /usr/lib/libpm.so-teradata-package-remove.old Moving /usr/lib/libicudatatd.so to /usr/lib/libicudatatd.so-teradata-package-remove.old Moving /usr/lib/libicui18ntd.so to /usr/lib/libicui18ntd.so-teradata-package-remove.old Moving /usr/lib/libicuiotd.so to /usr/lib/libicuiotd.so-teradata-package-remove.old Moving /usr/lib/libiculetd.so to /usr/lib/libiculetd.so-teradata-package-remove.old Moving /usr/lib/libiculxtd.so to /usr/lib/libiculxtd.so-teradata-package-remove.old Moving /usr/lib/libicuuctd.so to /usr/lib/libicuuctd.so-teradata-package-remove.old To permanently remove these files execute the command : $ rm /usr/lib/*-teradata-package-remove.old If you answer no when asked if you would like to move these files, output similar to this appears: The following listed files have not been moved: /usr/lib/libcliv2.so /usr/lib/libtdusr.so /usr/lib/libpm.so /usr/lib/libicudatatd.so /usr/lib/libicui18ntd.so /usr/lib/libicuiotd.so /usr/lib/libiculetd.so /usr/lib/libiculxtd.so /usr/lib/libicuuctd.so These could cause problems later. It is recommended that these files be manually moved or removed before installing new Teradata Client Packages. Manually Removing Packages If a package was not properly removed by the uninstall script, trying running the script a second time. To manually remove a package, follow these steps: Teradata Tools and Utilities for IBM AIX Installation Guide 21

22 Chapter 2 Uninstall Previous Software Uninstall Script Overview 1 To see if a package is still installed, type: /usr/sbin/lslpp L <packagename> 2 To manually remove a package, type: /usr/sbin/installp u <packagename> 22 Teradata Tools and Utilities for IBM AIX Installation Guide

23 CHAPTER 3 Install New Software Installing Third Party Software Some Teradata Tools and Utilities products require the installation of third-party software. Most third-party software can be downloaded and installed from the manufacturer's website. Teradata JDBC Driver JDK 1.4, JDK 5.0, or JDK 6.0 Java JDK 5.0 Java SE Downloads Teradata WebSphere MQ Access Module IBM WebSphere MQ 5.2 IBM WebSphere Product Center Installing C, C++ Compiler Versions of IBM AIX support IBM XL C/C++ Compiler v7.0 (runtime libraries fileset xlc.rte v7.x.x.x) through IBM XL C/C++ Compiler v10.0 (runtime libraries fileset xlc.rte v10.x.x.x). IBM XL C/C++ Compiler v9.0 (runtime libraries fileset xlc.rte v9.x.x.x) or later must be used because Shared ICU Libraries for Teradata has been compiled with v9.0, otherwise runtime errors such as unresolved symbols from libc.a will occur. 1 Download the appropriate compiler from IBM C and C++ Compilers. 2 Install the downloaded compiler according to the instructions provided with the compiler. Teradata WebSphere MQ Access Module 1 Download and install IBM WebSphere MQ 5.2 before running Teradata WebSphere MQ Access Module. Teradata Tools and Utilities for IBM AIX Installation Guide 23

24 Chapter 3 Install New Software Installing Teradata Tools and Utilities Installing Teradata Tools and Utilities Whenever installing Teradata Tools and Utilities software, always compare the versions available on the DVD installation media, the Teradata Developer Exchange and the Teradata Software Server. In general, the software server will contain the most recent point release of a software product, followed in turn by the download center, and finally the installation media. Installation Type Installing from a Web URL Installing from DVD Installing from the Teradata Developer Exchange Installing from the Teradata Software Server Installing from the Teradata ESDM Server Deploying using tar Description Some Teradata Tools and Utilities have third-party dependencies. Install these dependencies from their respective URLs. The initial distribution of software is on DVD media. Using the main install, install products on a single-user from the DVD media in the Teradata Tools and Utilities Installation Kit. The DVDs contain installation packages for the current release. The download center may contain more current software packages which should be installed instead of lower version software contained on the DVD media. Packages on the download center include drivers and connectivity software. The server may contain updated software packages which should be installed in lieu of lower version software contained on the DVD media, or on the Teradata Developer Exchange. Teradata Electronic Software Distribution Management (ESDM) program allows users tax benefits for some users that download software. The DVD media include files that allow you to deploy Teradata Tools and Utilities products across your network using tar.vbs scripts and tar. Installation Order The main installation procedure installs all products and their dependencies in the correct order. Using an alternative method to do the installation requires that the products be installed manually in the correct order. When installing individual products, they must be installed in the following order. Teradata Generic Security Services Client (teragss) Shared Common Components for Internationalization for Teradata (tdicu) Teradata Call-Level Interface version 2 (cliv2) Teradata Data Connector (piom) Any other products Note: Because the installation procedure for the ODBC Driver for Teradata installs both 32- bit and 64-bit versions of the ODBC Driver for Teradata, both the 32-bit and 64-bit versions of Teradata Generic Security Services Client must be installed before installing ODBC Driver for Teradata. Installing Teradata Tools and Utilities 1 Log on as the root user. 2 If a /mnt directory does not exist, create one: 24 Teradata Tools and Utilities for IBM AIX Installation Guide

25 Chapter 3 Install New Software Installing Teradata Tools and Utilities mkdir /mnt 3 Insert the Teradata Tools and Utilities AIX - HP-UX - LINUX - Solaris - Windows Release DVD into the media drive and type: mount -V cdrfs -o ro /dev/<media device name>/mnt For example, if the media device name is c0t1d0, type: mount -V cdrfs -o ro /dev/c0t1d0/mnt where the media mount point is /mnt. 4 To begin the installation process, type: cd /mnt./setup.bat A screen appears that: Identifies the platform and media Lists numbered products that can be installed Provides options for: Installing all software Removing previously installed software Displaying the sizes of the installed package Quitting the installation 5 Select the packages to install. Software must be installed in the following order: 1. Teradata Generic Security Services Client (teragss) 2. Shared ICU Libraries for Teradata (tdicu) 3. Teradata Call-Level Interface version 2 (cliv2) 4. Teradata Data Connector (piom) 5. Other Products Note: If Teradata Call-Level Interface version 2 is installed before Teradata Wallet and Teradata Wallet is installed using a different directory prefix than the default /opt, Teradata Call-Level Interface version 2 will not be able to use Teradata Wallet. To avoid this situation, either install Teradata Wallet before installing Teradata Call-Level Interface version 2 or install Teradata Wallet using the default directory prefix. To rectify this situation, reinstall Teradata Call-Level Interface version 2. For Teradata Wallet Help, enter tdwallet help at the command prompt. See B A, Security Administration for more information about Teradata Wallet. 6 After reviewing product dependencies, do one of the following: Command Install All Packages Action Type a. The number of products selected appears in the bottom right corner of the screen. The packages selected for installation have an asterisk (*) beside them. Teradata Tools and Utilities for IBM AIX Installation Guide 25

26 Chapter 3 Install New Software Installing Teradata Tools and Utilities Command Uninstall All Display installed package sizes Install Selected Packages Quit Action Type u. This removes previous versions of Teradata Tools and Utilities products, except Teradata Generic Security Services Client (TeraGSS). Type s to display the size of each installed package. Type the numbers of the desired products and dependencies, separated by spaces, and press the Enter key. Dependencies: If individual products are to be installed, first determine the product dependencies, such as Teradata Call-Level Interface version 2 (cliv2) or Teradata Data Connector (piom). Enter the numbers for the dependencies at the prompt, separated by spaces. For information on dependent products, see Product Dependencies. Products: Enter the numbers for the products at the prompt, separated by spaces. Type q to quit the installation. 7 Change back to the root directory and unmount the DVD. umount /mnt 8 Remove the installation DVD from the media drive. 9 When you are finished installing products, remove the last installation DVD from the media drive. Teradata Developer Exchange The Teradata Developer Exchange Downloads page contains software that is not included on Teradata Tools and Utilities media or is released more frequently than the Teradata Tools and Utilities collection of applications. Products Available from Teradata Developer Exchange Note: Products and versions of them available from Teradata Developer Exchange are subject to change. This list is limited to Teradata Tools and Utilities applications. Table 1: Connectivity Product Teradata Call-Level Interface version 2 for IBM AIX Teradata Call-Level Interface version 2 for Windows Teradata Call-Level Interface version 2 for Solaris Teradata Call-Level Interface version 2 for Linux Teradata Call-Level Interface version 2 for HP-UX Teradata JDBC Driver 26 Teradata Tools and Utilities for IBM AIX Installation Guide

27 Chapter 3 Install New Software Installing Teradata Tools and Utilities Product Teradata JMS Universal Connector.NET Data Provider for Teradata ODBC Driver for Teradata for HP-UX ODBC Driver for Teradata for Linux ODBC Driver for Teradata for IBM AIX ODBC Driver for Teradata for Solaris ODBC Driver for Teradata for Windows OLE DB Provider for Teradata Table 2: Tools Product Teradata SQL Assistant Java Edition Teradata Plug-in for Eclipse Downloading a Product from the Teradata Developer Exchange 1 Go to Teradata Developer Exchange. The Teradata Developer Exchange DOWNLOADS page with a list of selectable products appears. 2 Click the product name or the platform next to the product name. The list of available downloads by software version and processor or platform appears. 3 Click the software package or text file to download. 4 You may be asked to enter a user name and password or to create a user name and password. 5 Read the License Agreement, then click I Agree. A page with a link to the Download file appears. 6 If a readme file is included, click on the readme file link and read and print any special download or installation instructions before continuing. 7 Return to the DOWNLOADS page. 8 Click the package to download. This is typically a.tar,.tar.gz, or.zip file. 9 Click Save. 10 Select a location where to save the file and click Save. The file is saved to the location chosen. Installing Products Downloaded from Teradata Developer Exchange 1 Log on to the client as root. Teradata Tools and Utilities for IBM AIX Installation Guide 27

28 Chapter 3 Install New Software Installing Teradata Tools and Utilities 2 Go to the location where the *.zip file containing the required *.tar.gz files and associated files was saved. 3 Read the *.txt readme file to determine further installation instructions. 4 Uncompress and untar the files and dependent product packages into a folder for the setup packages. Typically the instructions describe how to uncompress and untar the files and dependent product packages into a folder for the setup packages. For example, uncompress and untar the cliv2 package with: gunzip cliv21400.tar.gz tar xvf 5 Uninstall the previous software. 6 Install dependencies, if any, in order. 1. Teradata Generic Security Services Client (teragss) 2. Shared Common Components for Internationalization for Teradata (tdicu) 3. Teradata Call-Level Interface version 2 (cliv2) 4. Teradata Data Connector (piom) 5. Other Products 7 Install the product. Teradata Software Server To ensure the highest quality and best performance of Teradata Tools and Utilities products, download the most recent critical post-production updates from Teradata Software Server. Downloading Patches To ensure the highest quality and best performance of Teradata Tools and Utilities products, the most recent critical post-production updates should be installed from the Teradata Software Server. 1 Log on to Teradata At Your Service. 2 Click Downloads. 3 In the Teradata Software Server dialog box, click Teradata Client. 4 In the Client Help dialog box, click the desired platform. 5 In the Teradata Client Released Software dialog box, select the software base and the platform base, then click Submit. 6 In the Client Patches dialog box, select the check boxes for the software patches to download. 7 Select the Download Type and the Download Readme Files (if desired), enter your User Name and , then click Submit. 8 Click Download. 9 Click Save. 10 Specify to save-to location and click Save to start the download. 28 Teradata Tools and Utilities for IBM AIX Installation Guide

29 Chapter 3 Install New Software Installing Teradata Tools and Utilities Installing Downloaded Patches 1 Log on to the client as root. 2 Go to the location where the *.zip file containing the required *.tar.gz files and associated files was saved. 3 Read the *.txt readme file to determine further installation instructions. 4 Uncompress and untar the files and dependent product packages into a folder for the setup packages. Typically the instructions describe how to uncompress and untar the files and dependent product packages into a folder for the setup packages. For example, uncompress and untar the cliv2 package with: gunzip cliv21400.tar.gz tar xvf 5 Uninstall the previous software. 6 Install dependencies, if any, in order. 1. Teradata Generic Security Services Client (teragss) 2. Shared Common Components for Internationalization for Teradata (tdicu) 3. Teradata Call-Level Interface version 2 (cliv2) 4. Teradata Data Connector (piom) 5. Other Products 7 Install the product. Adding CLI User Exit Functions CLI User Exit functions are general purpose facilities that can be added to the CLI workstation architecture on the selected operating system. These functions allow userdefined processing to take place. 1 Change directories to /opt/teradata/client/14.00/sample, using the following command: cd /opt/teradata/client/14.00/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. To compile the 32-bit version, type: make -f maketdusr.aix 4 Move the libtdusr.so file into the cli installation directory, and verify that libcliv2 exists in the same directory. 5 For more information on CLI User Exit Functions, see B A, Teradata Call- Level Interface Version 2 Reference for Network-Attached Systems, Appendix D. Teradata Tools and Utilities for IBM AIX Installation Guide 29

30 Chapter 3 Install New Software Installing Teradata Tools and Utilities 30 Teradata Tools and Utilities for IBM AIX Installation Guide

31 CHAPTER 4 Configure New Software Overview of Configuring ODBC Driver for Teradata After installing the ODBC Driver for Teradata, you may need to configure the following: Environment variables The odbc.ini template ODBC data sources For complete configuration information on the ODBC Driver for Teradata, see B A, ODBC Driver for Teradata User Guide. About Configuring Teradata Parallel Transporter The Teradata Parallel Transporter configuration normally requires modifications to only one file in the Teradata Parallel Transporter installation directory: twbcfg.ini. Additionally, the system configuration may require modification of the following parameters: Shared memory parameters: shmmax and shmesg Semaphore parameters: semmni, semmns, semmnu, and semmap The following environment variables may also need to be modified: TWB_ROOT PATH SHLIB_PATH NLSPATH Editing twbcfg.ini After the Teradata Parallel Transporter Base 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. 1 Log on as the root user. 2 Use a text editor to edit the configuration file to change the checkpoint or logs directory. Teradata Tools and Utilities for IBM AIX Installation Guide 31

32 Chapter 4 Configure New Software About Configuring Teradata Parallel Transporter For example, if the logs directory is full, then you should change the logs directory to another directory with free disk space. Note: No kernel rebuild or reboot is required after making the changes in the configuration file. Selecting Teradata Parallel Transporter Installation Directory Teradata Parallel Transporter allows a user-specified installation directory. The default installation directory for Teradata Parallel Transporter is /opt/teradata/client/ <version>/tbuild. where: <version> is the version number for Teradata Parallel Transporter. For example, the default installation directory for Teradata Parallel Transporter version is: /opt/teradata/client/14.00/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 requests the installation directory. Subsequent Teradata Parallel Transporter packages of the same version do not request the installation directory, but use the same installation directory as the first package installed. The installation of a Teradata Parallel Transporter emergency fix (efix) package overwrites the installed Teradata Parallel Transporter package. For example, the installation of Teradata Parallel Transporter Base overwrites the Teradata Parallel Transporter Base package. 1 The installation of a new version of Teradata Parallel Transporter prompts for the Teradata Parallel Transporter installation directory. Please specify the install directory [default:/opt/ teradata/client/14.00/tbuild]: Note: It is not recommended to use / or /usr as the installation directory. 2 Press Enter, to use the default installation directory, or enter an alternate installation directory and press Enter. Note: The installation directory also contains any log files. 32 Teradata Tools and Utilities for IBM AIX Installation Guide

33 Chapter 4 Configure New Software About Configuring Teradata Parallel Transporter Selecting Checkpoint and Log Directories in the Configuration File The configuration file contains parameters that determine the default behavior for Teradata Parallel Transporter Base, such as default checkpoint and log directories. These must be selected. 1 Edit the configuration file and specify the Teradata Parallel Transporter default directory and default log directory. 'CheckpointDirectory='/opt/teradata/client/14.00/tbuild/ checkpoint' CheckpointDirectory refers to the directory that contains the checkpoint files for Teradata Parallel Transporter jobs. 'LogDirectory='/opt/teradata/client/14.00/tbuild/logs' 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 B A, Teradata Parallel Transporter Reference on how to read the job log. Selecting the System Kernel Values During installation, the Teradata Parallel Transporter Base package checks for the system kernel values. 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 Base installation does not support formula value. If the kernel value is a formula, then the Teradata Parallel Transporter Base installation displays a warning message. 1 Start to install a Teradata Parallel Transporter product. If the system does not meet the required minimum value, the Teradata Parallel Transporter installation prompts to increase the value to the minimum required value. 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. Teradata Tools and Utilities for IBM AIX Installation Guide 33

34 Chapter 4 Configure New Software About Configuring Teradata Parallel Transporter 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)] 2 At the prompt, enter n to keep the current kernel value, enter y, or press Enter to change the kernel value. A reboot is required to make the kernel parameter changes effective. 3 Log on as root user to reboot the system. The reboot can be done after all the installations, but must be done before running a Teradata Parallel Transporter job. 4 The following reboot command reboots the system in 60 seconds: cd /usr/sbin/shutdown -y -g60 -i6 Updating Environment Variables for Teradata Parallel Transporter Prerequisite: You must have root access to update the environment variables. At the end of the Teradata Parallel Transporter Base installation, the environment variables in the system /etc/profile and /etc/csh.login files are updated as shown in the following table. Environment Variable TWB_ROOT PATH LIBPATH NLSPATH Update 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 only effective at the next logon if the Teradata Parallel Transporter Base package has been installed. The updates allow users to run the installed version of Teradata Parallel Transporter. If the Teradata Parallel Transporter API package has been installed, the 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 profile, or in the system profile. Where updates are made Command line Effectivity of updates Current session only 34 Teradata Tools and Utilities for IBM AIX Installation Guide

35 Chapter 4 Configure New Software About Configuring Teradata Parallel Transporter Where updates are made User profile System profile Effectivity of updates Whenever the user logs on Whenever any user logs on Note: The updates to the environment variables must be used to run the installed version of Teradata Parallel Transporter. If the updates are not used, the installed version of Teradata Parallel Transporter will not run correctly. Note: After installing Teradata Parallel Transporter and before running a Teradata Parallel Transporter job, the LANG environment variable must be set to en_us or the LC FASTMSG environment variable must be set to false. 1 Update the environment variables. Switching IPC Memory to Shared Memory The default Interprocess Communication (IPC) memory choice is memory mapped. You can switch to shared memory. 1 Log on as the root user. 2 Change directory to the Teradata Parallel Transporter installation directory: cd <installation directory> 3 Remove the mmap directory: rm -rf mmap Teradata Parallel Transporter will use shared memory as the IPC memory choice. The change does not require a kernel rebuild or a reboot. Switching IPC Memory to Mapped Memory This task is only required when the Interprocess Communication (IPC) method has been changed from the default, memory mapped, to shared memory. 1 Log on as the root user. 2 Change directory to the Teradata Parallel Transporter installation directory: cd <installation directory> 3 Create the mmap directory with "777" permissions: mkdir mmap chmod 777 mmap Teradata Parallel Transporter will use memory mapped as the IPC memory choice. The change does not require a kernel rebuild or a reboot. Teradata Tools and Utilities for IBM AIX Installation Guide 35

36 Chapter 4 Configure New Software About Configuring Teradata Parallel Transporter 36 Teradata Tools and Utilities for IBM AIX Installation Guide

37 CHAPTER 5 Restart the Client Computer Restarting the Client Computer 1 Reboot if the client installation requires it. In most cases, the client computer does not require a restart. Note: Teradata Parallel Transporter adds some kernel modifications that require a computer restart. Teradata Tools and Utilities for IBM AIX Installation Guide 37

38 Chapter 5 Restart the Client Computer Restarting the Client Computer 38 Teradata Tools and Utilities for IBM AIX Installation Guide

39 CHAPTER 6 Verify the Complete Installation About Verifying the Installation Use one or all of the following methods to verify the installation of Teradata Tools and Utilities: Verify the installation using BTEQ Verify the installation using the CLI Sample Program Check that the product files were loaded in the proper folders Verifying the Installation Using Basic Teradata Query Using Basic Teradata Query (BTEQ) is the simplest way to verify that Teradata Tools and Utilities has been installed properly because BTEQ files are part of the installation. Refer to B A, Basic Teradata Query Reference for detailed information on how to use BTEQ. 1 Add the directory where BTEQ resides to the search path. 2 Change directory to the BTEQ directory. 3 Start BTEQ: bteq A screen similar to the following appears: Teradata BTEQ for UNIX5. Copyright , Teradata Corporation. ALL RIGHTS RESERVED. Enter your logon or BTEQ command: 4 Log on to the Teradata Database:.logon dbcpath/username Enter the BTEQ logon command with a logon ID. Include the dbcpath if the Teradata Database dbcpath is not the default i_dbcpath specified in clispb.dat. 5 When prompted, enter the password. For example, if the Teradata Database has a dbcpath of Finance, the username is fml, and the password is fml, type:.logon Finance/fml Password: fml If the logon is successful, a screen similar to the following appears: *** Logon successfully completed. *** Transaction Semantics are BTET. Teradata Tools and Utilities for IBM AIX Installation Guide 39

40 Chapter 6 Verify the Complete Installation About Verifying the Installation *** Character Set Name is 'ASCII'. *** Total elapsed time was 1 second. BTEQ -- Enter your DBC/SQL request or BTEQ command: 6 Submit a sample Teradata SQL query: SELECT time; If the test passes, a screen similar to the following appears. BTEQ select time output: *** Query completed. One row found. One column returned. *** Total elapsed time was 1 second. Time :09:11 7 Log off the Teradata Database and exit BTEQ. Verifying the Installation Using CLI Sample Program To verify that the Teradata Tools and Utilities software installed properly, run the sample CLI application, clisamp. The program and its makefile are installed during installation of Teradata Tools and Utilities. 1 Modify the makesamp.3000 makefile 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 run: chmod +x clisamp 4 Run the sample program using one of the following commands: Run the sample program using the default logon information (dbc/ systemfe,service): clisamp Show help for the sample program: clisamp -h Run the sample program using a user-provided input string: clisamp slugger/dbc,dbc where TDPID= slugger, user=dbc, and password=dbc. The program logs on to the default dbccop1 (no user input supplied) specified in the / etc/hosts file, runs a simple query SELECT * from dbc.sessioninfo, and writes the output to the clisamp.dat file. A display similar to the following appears: CLIv2 version is MTDP version is MOSIOS version is Teradata Tools and Utilities for IBM AIX Installation Guide

41 Chapter 6 Verify the Complete Installation About Verifying the Installation MOSIDEP version is OSERR version is Logging on to --> dbc/systemfe,service writing out to --> CLISAMP.DAT submitting --> select* from dbc.sessioninfo; writing out to --> CLISAMP.DAT Logging off. Basic Teradata Query Files and Directories An asterisk (*) after a filename in the following table indicates that it is a "softlink" for a file that has been installed in the default directory /opt/teradata/client/<version>/ bin. Note: The silent install method works only if the default installation path is /opt, as shown in the above example. Directory /usr/bin /usr/include /opt/teradata/client/<version>/bin /opt/teradata/client/<version>/sample /opt/teradata/client/<version>/sample /opt/teradata/client/<version>/sample Files bteq* btnfyext.h* bteq btnfyext.c mkbtnfyext.aix btnfyext.h Named Pipe Access Module Files and Directories 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/<version>/lib directory. Note: The silent install method works only if the default installation path is /opt, as shown in the above example. Directory /usr/lib /opt/teradata/client/<version>/lib Files np_axsmod.so* np_axsmod.so ODBC Driver for Teradata Files and Directories The default directory for the ODBC Driver for Teradata is opt/teradata/client/ ODBC_32 opt/teradata/client/odbc_32 or /opt/teradata/client/odbc_64, depending on the platform. 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/<version>/lib directory. Teradata Tools and Utilities for IBM AIX Installation Guide 41

42 Chapter 6 Verify the Complete Installation About Verifying the Installation Note: The silent install method works only if the default installation path is /opt, as shown in the above example. Directory /usr/lib /usr/lib /usr/lib /usr/lib /usr/lib /opt/teradata/client/<version>/odbc_32 /opt/teradata/client/<version>/odbc_32 /opt/teradata/client/<version>/odbc_32 /opt/teradata/client/<version>/odbc_32/bin /opt/teradata/client/<version>/odbc_32/bin /opt/teradata/client/<version>/odbc_32/bin /opt/teradata/client/<version>/odbc_32/help/man/man5 /opt/teradata/client/<version>/odbc_32/include /opt/teradata/client/<version>/odbc_32/include /opt/teradata/client/<version>/odbc_32/include /opt/teradata/client/<version>/odbc_32/include /opt/teradata/client/<version>/odbc_32/include /opt/teradata/client/<version>/odbc_32/include /opt/teradata/client/<version>/odbc_32/lib /opt/teradata/client/<version>/odbc_32/lib /opt/teradata/client/<version>/odbc_32/lib /opt/teradata/client/<version>/odbc_32/lib /opt/teradata/client/<version>/odbc_32/msg /opt/teradata/client/<version>/odbc_32/samples/c /opt/teradata/client/<version>/odbc_32/samples/c Files libivicu24.so -> /opt/ teradata/client/odbc_32/lib/ libivicu24.so libodbc.so.so -> /opt/ teradata/client/odbc_32/lib/ libodbc.so libodbcinst.so -> /opt/ teradata/client/odbc_32/lib/ libodbc.so libtdparse.so -> /opt/ teradata/client/odbc_32/lib/ libtdparse.so libtdsso.so -> /opt/teradata/ client/odbc_32/lib/libtdsso.so README odbc.ini odbcinst.ini tdxodbc tdxodbc tdxodbc tdata.5 odbcinst.h sql.h sqlext.h sqltypes.h sqlunx.h tdsql.h Iibtdparse.so libtdsso.so tdata.so tdconndlg.so tdodbc.cat adhoc adhoc.c 42 Teradata Tools and Utilities for IBM AIX Installation Guide

43 Chapter 6 Verify the Complete Installation About Verifying the Installation Directory /opt/teradata/client/<version>/odbc_32/samples/c /opt/teradata/client/<version>/odbc_32/samples/c /opt/teradata/client/<version>/odbc_32/samples/c /opt/teradata/client/<version>/odbc_32/samples/c++ /opt/teradata/client/<version>/odbc_32/samples/c++ /opt/teradata/client/<version>/odbc_32/samples/c++ /opt/teradata/client/<version>/odbc_32/samples/c++ /opt/teradata/client/<version>/odbc_32/samples/c++ /usr/lib /usr/lib /usr/lib /usr/lib /usr/lib /opt/teradata/client/<version>/odbc_64 /opt/teradata/client/<version>/odbc_64 /opt/teradata/client/<version>/odbc_64 /opt/teradata/client/<version>/odbc_64/bin /opt/teradata/client/<version>/odbc_64/bin /opt/teradata/client/<version>/odbc_64/bin /opt/teradata/client/<version>/odbc_64/bin/man/man5 /opt/teradata/client/<version>/odbc_64/bin /opt/teradata/client/<version>/odbc_64/include /opt/teradata/client/<version>/odbc_64/include /opt/teradata/client/<version>/odbc_64/include /opt/teradata/client/<version>/odbc_64/include /opt/teradata/client/<version>/odbc_64/include Files aix.includes error.c Makefile adhoc adhoc.cpp aix.includes error.cpp Makefile lib64/libivicu24.so -> /opt/ teradata/client/odbc_64/lib/ libivicu24.so lib64/libodbc.so.so* -> /opt/ teradata/client/odbc_64/lib/ libodbc.so lib64/libodbcinst.so* -> /opt/ teradata/client/odbc_64/lib/ libodbc.so lib64/libtdparse.so* -> /opt/ teradata/client/odbc_64/lib/ libtdparse.so lib64/libtdsso.so* -> /opt/ teradata/client/odbc_64/lib/ libtdsso.so odbc.ini odbcinst.ini README tdxodbc tdxwinapp.build_pre130_bridge tdata.5 README odbcinst.h sql.h sqlext.h sqltypes.h sqlucode.h Teradata Tools and Utilities for IBM AIX Installation Guide 43

44 Chapter 6 Verify the Complete Installation About Verifying the Installation Directory /opt/teradata/client/<version>/odbc_64/include /opt/teradata/client/<version>/odbc_64/include /opt/teradata/client/<version>/odbc_64/lib /opt/teradata/client/<version>/odbc_64/lib /opt/teradata/client/<version>/odbc_64/lib /opt/teradata/client/<version>/odbc_64/lib /opt/teradata/client/<version>/odbc_64/msg /opt/teradata/client/<version>/odbc_64/samples/c /opt/teradata/client/<version>/odbc_64/samples/c /opt/teradata/client/<version>/odbc_64/samples/c /opt/teradata/client/<version>/odbc_64/samples/c /opt/teradata/client/<version>/odbc_64/samples/c /opt/teradata/client/<version>/odbc_64/samples/c++ /opt/teradata/client/<version>/odbc_64/samples/c++ /opt/teradata/client/<version>/odbc_64/samples/c++ /opt/teradata/client/<version>/odbc_64/samples/c++ /opt/teradata/client/<version>/odbc_64/samples/c++ Files sqlunx.h tdsql.h libtdparse.so libtdsso.so tdata.so tdconndlg.so tdodbc.cat adhoc adhoc.c aix.includes error.c Makefile adhoc adhoc.cpp aix.includes error.cpp Makefile Shared Common Components for Internationalization for Teradata Files and Directories Directory /usr/lib /usr/lib /usr/lib /usr/lib /usr/lib /usr/lib /usr/lib Files libicudatatd.so -> /opt/teradata/client/<version>/tdicu/lib/ libicudatatd46.0.so libicui18ntd.so -> /opt/teradata/client/<version>/tdicu/lib/ libicui18ntd46.0.so libicuuctd.so -> /opt/teradata/client/<version>/tdicu/lib/ libicuuctd46.0.so libicuiotd.so -> /opt/teradata/client/<version>/tdicu/lib/ libicuiotd46.0.so libiculxtd.so -> /opt/teradata/client/<version>/tdicu/lib/ libiculxtd46.0.so libiculetd.so -> /opt/teradata/client/<version>/tdicu/lib/ libiculetd46.0.so libicudatatd46.so -> /opt/teradata/client/<version>/tdicu/lib/ libicudatatd46.0.so 44 Teradata Tools and Utilities for IBM AIX Installation Guide

45 Chapter 6 Verify the Complete Installation About Verifying the Installation Directory /usr/lib /usr/lib /usr/lib /usr/lib /usr/lib /opt/teradata/client/ <version>/tdicu/lib /opt/teradata/client/ <version>/tdicu/lib /opt/teradata/client/ <version>/tdicu/lib /opt/teradata/client/ <version>/tdicu/lib /opt/teradata/client/ <version>/tdicu/lib /opt/teradata/client/ <version>/tdicu/lib /opt/teradata/client/ <version>/tdicu/lib /opt/teradata/client/ <version>/tdicu/lib /opt/teradata/client/ <version>/tdicu/lib /opt/teradata/client/ <version>/tdicu/lib /opt/teradata/client/ <version>/tdicu/lib /opt/teradata/client/ <version>/tdicu/lib /opt/teradata/client/ <version>/tdicu/lib /opt/teradata/client/ <version>/tdicu/lib /opt/teradata/client/ <version>/tdicu/lib Files libicui18ntd46.so -> /opt/teradata/client/<version>/tdicu/lib/ ibicui18ntd46.0.so libicuuctd46.so -> /opt/teradata/client/<version>/tdicu/lib/ libicuuctd46.0.so libicuiotd46.so -> /opt/teradata/client/<version>/tdicu/lib/ libicuiotd46.0.so libiculxtd46.so -> /opt/teradata/client/<version>/tdicu/lib/ libiculxtd46.0.so libiculetd46.so -> /opt/teradata/client/<version>/tdicu/lib/ libiculetd46.0.so libicudatatd.so -> libicudatatd46.0.so libicui18ntd.so -> libicui18ntd46.0.so libicuuctd.so -> libicuuctd46.0.so libicuiotd.so -> libicuiotd46.0.so libiculxtd.so -> libiculxtd46.0.so libiculetd.so -> libiculetd46.0.so libicudatatd.so.46 -> libicudatatd46.0.so libicui18ntd.so.46 -> libicui18ntd46.0.so libicuuctd.so.46 -> libicuuctd46.0.so libicuiotd.so.46 -> libicuiotd46.0.so libiculxtd46.so.46 -> libiculxtd46.0.so libiculetd46.so.46 -> libiculetd46.0.so libicudatatd46.0.so libicui18ntd46.0.so libicuuctd46.0.so Teradata Tools and Utilities for IBM AIX Installation Guide 45

46 Chapter 6 Verify the Complete Installation About Verifying the Installation Directory /opt/teradata/client/ <version>/tdicu/lib /opt/teradata/client/ <version>/tdicu/lib /opt/teradata/client/ <version>/tdicu/lib /usr/lib/lib_64 /usr/lib/lib_64 /usr/lib/lib_64 /usr/lib/lib_64 /usr/lib/lib_64 /usr/lib/lib_64 /usr/lib/lib_64 /usr/lib/lib_64 /usr/lib/lib_64 /usr/lib/lib_64 /usr/lib/lib_64 /usr/lib/lib_64 /opt/teradata/client/ <version>/tdicu/lib64 /opt/teradata/client/ <version>/tdicu/lib64 /opt/teradata/client/ <version>/tdicu/lib64 /opt/teradata/client/ <version>/tdicu/lib64 /opt/teradata/client/ <version>/tdicu/lib64 Files libicuiotd46.0.so libiculxtd46.0.so libiculetd46.0.so libicudatatd.so -> /opt/teradata/client/<version>/tdicu/lib64/ libicudatatd46.0.so libicuuctd.so -> /opt/teradata/client/<version>/tdicu/lib64/ libicuuctd46.0.so libiculxtd.so -> /opt/teradata/client/<version>/tdicu/lib64/ libiculxtd46.0.so libiculetd.so -> /opt/teradata/client/<version>/tdicu/lib64/ libiculetd46.0.so libicuiotd.so -> /opt/teradata/client/<version>/tdicu/lib64/ libicuiotd46.0.so libicui18ntd.so -> /opt/teradata/client/<version>/tdicu/lib64/ libicui18ntd46.0.so libicudatatd.so.46 -> /opt/teradata/client/<version>/tdicu/lib64/ libicudatatd46.0.so libicuuctd.so.46 -> /opt/teradata/client/<version>/tdicu/lib64/ libicuuctd46.0.so libiculxtd.so.46 -> /opt/teradata/client/<version>/tdicu/lib64/ libiculxtd46.0.so libiculetd.so.46 -> /opt/teradata/client/<version>/tdicu/lib64/ libiculetd46.0.so libicuiotd.so.46 -> /opt/teradata/client/<version>/tdicu/lib64/ libicuiotd46.0.so libicui18ntd.so.46 -> /opt/teradata/client/<version>/tdicu/lib64/ libicui18ntd46.0.so libicudatatd.so -> libicudatatd46.0.so libicui18ntd.so -> libicui18ntd46.0.so libicuuctd.so -> libicuuctd46.0.so libicuiotd.so -> libicuiotd46.0.so libiculetd.so -> libiculetd46.0.so 46 Teradata Tools and Utilities for IBM AIX Installation Guide

47 Chapter 6 Verify the Complete Installation About Verifying the Installation Directory /opt/teradata/client/ <version>/tdicu/lib64 /opt/teradata/client/ <version>/tdicu/lib64 /opt/teradata/client/ <version>/tdicu/lib64 /opt/teradata/client/ <version>/tdicu/lib64 /opt/teradata/client/ <version>/tdicu/lib64 /opt/teradata/client/ <version>/tdicu/lib64 /opt/teradata/client/ <version>/tdicu/lib64 /opt/teradata/client/ <version>/tdicu/lib64 /opt/teradata/client/ <version>/tdicu/lib64 /opt/teradata/client/ <version>/tdicu/lib64 /opt/teradata/client/ <version>/tdicu/lib64 /opt/teradata/client/ <version>/tdicu/lib64 /opt/teradata/client/ <version>/tdicu/lib64 Files libiculxtd.so -> libiculxtd46.0.so libicudatatd46.0.so -> libicudatatd46.0.so libicui18ntd46.0.so -> libicui18ntd46.0.so libicuuctd46.0.so -> libicuuctd46.0.so libicuiotd46.0.so -> libicuiotd46.0.so libiculetd46.0.so -> libiculetd46.0.so libiculxtd46.0.so -> libiculxtd46.0.so libicudatatd46.0.so libicui18ntd46.0.so libicuuctd46.0.so libicuiotd46.0.so libiculetd46.0.so libiculxtd46.0.so Teradata C Preprocessor2 Files and Directories An asterisk (*) after a filename in the following table indicates that it is a "softlink" for files that have been moved to the /opt/teradata/client/<version>/bin, /opt/ teradata/client/<version>/bin64, /opt/teradata/client/<version>/lib or the /opt/teradata/client/<version>/lib64 directories. Note: The silent install method works only if the default installation path is /opt, as shown in the above example. Directory /usr/bin /usr/lib /usr/bin/bin_64 Files ppcmain* lippruntim.so* ppcmain* Teradata Tools and Utilities for IBM AIX Installation Guide 47

48 Chapter 6 Verify the Complete Installation About Verifying the Installation Directory /usr/bin/lib_64 /opt/teradata/client/<version>/bin /opt/teradata/client/<version>/bin64 /opt/teradata/client/<version>/lib /opt/teradata/client/<version>/lib64 /opt/teradata/client/<version>/sample /opt/teradata/client/<version>/sample /opt/teradata/client/<version>/sample /opt/teradata/client/<version>/sample /opt/teradata/client/<version>/sample /opt/teradata/client/<version>/sample /opt/teradata/client/<version>/sample /opt/teradata/client/<version>/sample /opt/teradata/client/<version>/sample /opt/teradata/client/<version>/sample Files lippruntim.so* ppcmain ppcmain lippruntim.so lippruntim.so LABSBTEQ PPCLB1 PPCLB2 PPCLB3 PPCLB4 PPCLB5 PPCLB6 PPCLB7 PPCLB8 PPCLB9 Teradata Call-Level Interface version 2 Files and Directories An asterisk (*) after a filename in the following table indicates that it is a "softlink" for files that have been moved to either the /opt/teradata/client/<version>/include or the /opt/teradata/client/<version>/lib directory. Note: The silent install method works only if the default installation path is /opt, as shown in the above example. Directory /usr/lib /usr/lib /usr/lib /usr/lib /usr/lib /usr/include /usr/include /usr/include /usr/include /usr/include Files clispb.dat* errmsg.cat* errmsg.txt* libcliv2.so* libtdusr.so* cliv2if.h* coptypes.h* coperr.h* dbca2px.h* dbcarea.h* 48 Teradata Tools and Utilities for IBM AIX Installation Guide

49 Chapter 6 Verify the Complete Installation About Verifying the Installation Directory /usr/include /usr/include /usr/include /usr/include /opt/teradata/client/<version>/lib64 /opt/teradata/client/<version>/lib64 /opt/teradata/client/<version>/lib64 /opt/teradata/client/<version>/lib64 /opt/teradata/client/<version>/lib64 /opt/teradata/client/<version>/include /opt/teradata/client/<version>/include /opt/teradata/client/<version>/include /opt/teradata/client/<version>/include /opt/teradata/client/<version>/include /opt/teradata/client/<version>/include /opt/teradata/client/<version>/include /opt/teradata/client/<version>/include /opt/teradata/client/<version>/include /opt/teradata/client/<version>/lib /opt/teradata/client/<version>/lib /opt/teradata/client/<version>/lib Files dbcerr.h* dbchqep.h* parcel.h* mosiif.h* libcliv2.so libtdusr.so errmsg.cat errmsg.txt clispb.dat coptypes.h dbchqep.h dbca2px.h cliv2if.h coperr.h dbcarea.h parcel.h dbcerr.h mosiff.h errmsg.cat errmsg.txt clispb.dat Teradata COBOL Preprocessor2 Files and Directories An asterisk (*) after a filename in the following table indicates that it is a "softlink" for files that have been moved to the /opt/teradata/client/<version>/bin, /opt/ teradata/client/<version>/bin64, /opt/teradata/client/<version>/lib or the /opt/teradata/client/<version>/lib64 directories. Note: The silent install method works only if the default installation path is /opt, as shown in the above example. Directory /usr/bin /usr/lib /usr/bin/bin_64 Files ppbmain* libppruntim.so* ppcmain* Teradata Tools and Utilities for IBM AIX Installation Guide 49

50 Chapter 6 Verify the Complete Installation About Verifying the Installation Directory /usr/lib/lib_64 /opt/teradata/client/<version>/bin /opt/teradata/client/<version>/bin64 /opt/teradata/client/<version>/lib /opt/teradata/client/<version>/lib64 /opt/teradata/client/<version>/sample /opt/teradata/client/<version>/sample /opt/teradata/client/<version>/sample /opt/teradata/client/<version>/sample /opt/teradata/client/<version>/sample /opt/teradata/client/<version>/sample /opt/teradata/client/<version>/sample /opt/teradata/client/<version>/sample /opt/teradata/client/<version>/sample /opt/teradata/client/<version>/sample Files libppruntim.so* ppbmain ppbmain lbppruntim.so libppruntim.so LABSBTEQ PPCOBLB1 PPCOBLB2 PPCOBLB3 PPCOBLB4 PPCOBLB5 PPCOBLB6 PPCOBLB7 PPCOBLB8 PPCOBLB9 Teradata Data Connector Files and Directories An asterisk (*) after a filename in the following table indicates that it is a "softlink" for files that have been moved to either the /opt/teradata/client/<version>/include or the /opt/teradata/client/<version>/lib directory. Note: The silent install method works only if the default installation path is /opt, as shown in the above example. Directory /usr/lib /usr/include /usr/include /usr/include /opt/teradata/client/<version>/lib /opt/teradata/client/<version>/include /opt/teradata/client/<version>/include /opt/teradata/client/<version>/include Files libpm.so* pmdcomt.h* pmddamt.h* pmtypes.h* libpm.so pmdcomt.h pmddamt.h pmtypes.h 50 Teradata Tools and Utilities for IBM AIX Installation Guide

51 Chapter 6 Verify the Complete Installation About Verifying the Installation Teradata FastExport Files and Directories An asterisk (*) after a filename in the following table indicates that it is a "softlink" for files that have been moved to the /opt/teradata/client/<version>/bin, /opt/ teradata/client/<version>/include, or the /opt/teradata/client/ <version>/sample directories. Note: The silent install method works only if the default installation path is /opt, as shown in the above example. Directory /usr/bin /usr/include /usr/sample /usr/sample /opt/teradata/client/<version>/bin /opt/teradata/client/<version>/sample /opt/teradata/client/<version>/sample /opt/teradata/client/<version>/sample Files fexp* expnfyxt.h* expnfyxt.c* mkexpext.aix* fexp expnfyxt.h expnfyxt.c mkexpext.aix Teradata FastLoad Files and Directories An asterisk (*) after a filename in the following table indicates that it is a "softlink" for files that have been moved to the /opt/teradata/client/<version>/bin or the /opt/ teradata/client/<version>/sample directories. Note: The silent install method works only if the default installation path is /opt, as shown in the above example. Directory /usr/bin /usr/sample /usr/sample /usr/sample /opt/teradata/client/<version>/bin /opt/teradata/client/<version>/sample /opt/teradata/client/<version>/sample /opt/teradata/client/<version>/sample Files fastload* blkexit.c* blkexitr.c* flnfyext.c* fastload blkexit.c blkexitr.c flnfyext.c Teradata Tools and Utilities for IBM AIX Installation Guide 51

52 Chapter 6 Verify the Complete Installation About Verifying the Installation Teradata Generic Security Services Files and Directories The files included with the Teradata Generic Security Services Client package can change from package to package, so there is no definitive filename list to verify. To verify the installation of the Teradata Generic Security Services Client packages, verify the existence of a file named version in the /usr/teragss/<architecture>/<version> directory, where: <version> is the version of software being verified. Directory /usr/teragss/aix-power/<version> /usr/teragss/aix-power.32/<version> Files teragss_aix-power teragss_aix-power-32 Teradata JDBC Driver Files and Directories File Type File Name Default Folder Executable terajdbc4.jar user selectable Sample samples.jar user selectable Security tdgssconfig.jar user selectable Teradata MultiLoad Files and Directories An asterisk (*) after a filename in the following table indicates that it is a "softlink" for files that have been moved to the /opt/teradata/client/<version>/bin, /opt/ teradata/client/<version>/include, or the /opt/teradata/client/ <version>/sample directories. Note: The silent install method works only if the default installation path is /opt, as shown in the above example. Directory /usr/bin* /usr/include* /usr/sample* /usr/sample* /opt/teradata/client/<version>/bin /opt/teradata/client/<version>/include /opt/teradata/client/<version>/sample /opt/teradata/client/<version>/sample Files mload* mldnfyxt.h* mldnfyxt.c* mkmldext.aix* mload mldnfyxt.h mldnfyxt.c mkmldext.aix 52 Teradata Tools and Utilities for IBM AIX Installation Guide

53 Chapter 6 Verify the Complete Installation About Verifying the Installation Teradata Parallel Data Pump Files and Directories An asterisk (*) after a filename in the following table indicates that it is a "softlink" for files that have been moved to the /opt/teradata/client/<version>/bin and /opt/ teradata/client/<version>/lib directories. Note: The silent install method works only if the default installation path is /opt, as shown in the above example. Directory /usr/bin /usr/bin /usr/lib /opt/teradata/client/<version>/bin /opt/teradata/client/<version>/bin /opt/teradata/client/<version>/lib /opt/teradata/client/<version>/sample /opt/teradata/client/<version>/sample /opt/teradata/client/<version>/sample Files tpumpexe* tpump* tdatpump.cfg* tpumpexe tpump tdatpump.cfg makinmod.3000 tpumpimd.c tpumpar.csql Teradata Wallet Files and Directories An asterisk (*) after a filename in the following table indicates that it is a symbolic link. Directory /usr/bin /opt/teradata/client/<version>/tdwallet /opt/teradata/client/<version>/tdwallet/aix-power /opt/teradata/client/<version>/tdwallet/aix-power /opt/teradata/client/<version>/tdwallet/aix-power /opt/teradata/client/<version>/tdwallet/aix-power /opt/teradata/client/<version>/tdwallet/aix-power.32 /opt/teradata/client/<version>/tdwallet/aix-power.32 /opt/teradata/client/<version>/tdwallet/aix-power.32 /opt/teradata/client/<version>/tdwallet/aix-power.32 /opt/teradata/client/tdwallet/wallets Files tdwallet* config.xml libtdwallet.so tdwallet tdwalletdir* tdwhelper.exe libtdwallet.so tdwallet tdwalletdir* tdwalletdir* initially empty Teradata Tools and Utilities for IBM AIX Installation Guide 53

54 Chapter 6 Verify the Complete Installation About Verifying the Installation Teradata WebSphere MQ Access Module Files and Directories An asterisk (*) after a filename in the following table indicates that it is a "softlink" for files that have been moved to the /opt/teradata/client/<version>/lib and the /opt/ teradata/client/<version>/opt directories. Note: The silent install method works only if the default installation path is /opt, as shown in the above example. Directory /usr/lib /usr/lib /opt/teradata/client/<version>/opt /opt/teradata/client/<version>/lib /opt/teradata/client/<version>/lib /opt/teradata/client/<version>/lib /opt/teradata/client/<version>/opt Files libmqsc* libmqs.so mqaxsmod libupdateop.so libmqsc.so libmqs.so mqaxsmod 54 Teradata Tools and Utilities for IBM AIX Installation Guide

55 CHAPTER 7 Security and Connecting to a Teradata Database About Connecting to a Teradata Database You can establish a connection to a Teradata Database with any of the following methods: From a GUI application From a command line driven application Programmatically Regardless of the connection method, you must check logon error messages. About Logon Procedures The logon string can be provided 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 appears that allows entry of the missing logon information. If the Connect to Teradata Database dialog appears, all application-provided parameters are automatically entered into the dialog fields. You can change the value 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 also be used to manipulate the fields of the Connect to Teradata Database dialog. Connecting to a Teradata Database from a GUI Application This procedure describes how to use the Connect to Teradata Database dialog box from a Graphical User Interface (GUI) application to connect to a Teradata Database. This procedure is for a typical application. See the product's User or Reference guide for specific information about an individual product. 1 If the application connecting to the Teradata Database has a Connectivity tab in the Tools options menu, select CLI or ODBC depending on the desired method for connecting to the Teradata Database. 2 Click Connect. 3 In the Connect to Teradata Database dialog box, select or enter the appropriate values for the Teradata Database. Teradata Tools and Utilities for IBM AIX Installation Guide 55

56 Chapter 7 Security and Connecting to a Teradata Database About Connecting to a Teradata Database Database Name (Required) This is the name of the Teradata Database to connect to. Enter a valid Teradata Database name, or select a Teradata Database name that was previously entered from the drop-down list. Authentication Mechanism (Optional) The authentication mechanism identifies the mechanism used for connections to the data source. Select the authentication mechanism specified by the client system administrator from the list of authentication mechanisms provided in the drop down list. Valid authentication mechanism values are: Empty - If no authentication mechanism is listed in the drop down list, or if the authentication mechanism selected is not supported, the mechanism used is the system default TD2 - Teradata 2 mechanism ldap - ldap mechanism Other - user-defined mechanism Authentication Parameter (Optional) Enter the parameters required by the selected authentication mechanism. See your system administrator for these values. User Name (Optional) Select your user name from the drop down list or enter a valid user name. Password (Optional) Enter the password for the user name you selected. Default Database (Optional) Select the default Teradata Database for the session. Account String (Optional) Enter a new account string or select an account string from the drop down list. The account string is used to create a user in a Teradata Database, instead of providing account information during configuration of ODBC. It allows Teradata to isolate users, to find out what applications users are running, or to restrict users trying to connect to the Teradata Database. Even though the User Name and Password parameters are required to log on to the Teradata Database, entry into the Connect to Teradata Database dialog box is not required because they may be filled in by the user logon exit routine or retrieved from another parameter or service. 4 Click OK. 56 Teradata Tools and Utilities for IBM AIX Installation Guide

57 Chapter 7 Security and Connecting to a Teradata Database About Connecting to a Teradata Database Connecting to a Teradata Database from a Command Line Application 1 Enter the.logmech command. The.logmech command identifies the desired logon authentication mechanism (logmech_name_string). The logmech_name_string is limited to eight bytes and is not case sensitive. The syntax for the.logmech command is:.logmech logmech_name_string where logmech_name_string can have any one of the following values: None - If no authentication mechanism is entered, or if the authentication mechanism selected is not supported, the system determines a default based on client and server settings TD2 - Teradata 2 mechanism LDAP - LDAP mechanism 2 Enter the.logdata command. To successfully authenticate the user, the.logdata command provides all the parameters needed by the authentication mechanism other than a UserId and Password. The information is entered into and passed by the logdata_string. The logdata_string is limited to 64 KB. The syntax for the.logdata command is:.logdata logdata_string; If logdata_string has white space characters or other special characters embedded, the entire logdata_string must be delimited with single quotes:.logdata `logdata_string'; The exact contents of the logdata_string vary according to the selected authentication mechanism. The string is not displayed, parsed, or otherwise processed by the application. 3 Enter the.logon command. The syntax for the.logon command is:.logon DBCName/[UserId,Password][,AccountId] where The required DBCName is also referred to as the TDPID (Teradata Director Program ID). It identifies a particular Teradata Database. If no identifier is specified, the value of this field is copied from the clispb.dat field, i_dbcpat. DBCName is not case sensitive. The optional UserId or user name string can be up to 30 characters long. The first character cannot be a numeric character. UserId is not case sensitive. The optional Password string can be up to 30 characters long. The first character cannot be a numeric character. In the dialog box, each character of Password is displayed as an asterisk (*). Password is not case sensitive. Teradata Tools and Utilities for IBM AIX Installation Guide 57

58 Chapter 7 Security and Connecting to a Teradata Database About Connecting to a Teradata Database The AccountId is optional. If supplied, it must be separated from the Password by a comma, and if the Password is not supplied, by two commas. The first character cannot be a numeric character. Do not enter the single quote (') that normally surrounds an AccountId. AccountId is not case sensitive. Example Logons from the Command Line In general, mechanisms that perform authentication and validation do not require that a Teradata Database UserID and Password be included as part of the logon string. If these items are provided in conjunction with an authentication mechanism, they are ignored. Mechanism Mechanism Parameter UserID Password TD2 Never Must Must LDAP Optional Optional Optional LDAP Logon Examples Implicit Logon The LDAP authentication mechanism allows a user to be authenticated via LDAP and, optionally, to assume a role or user identity other than his or her own, as allowed by the appropriate directory settings. The user may supply a UserId, Password, and Domain or Realm. The exact contents of the LDAP.logdata information necessarily depends largely on how the site is using LDAP, and how LDAP has been configured. The samples below are generic examples. Once the user's identity has been verified by LDAP, an implicit logon will proceed using the UserId as the Teradata Database username:.logmech LDAP.logdata domain7authcid=joe password=password real=myrealm.logon mydbs/joe,password Accounting Information If required, Teradata Database accounting information may be included as part of.logon command as follows:.logmech LDAP.logdata authcid=joe password=password real=myrealm.logon mydbs/,, If the directory maps the UserId to a specific Teradata Database Username, that Username must be defined in the target Teradata Database and must have previously been granted the "logon with null password privilege." Once the user's identity has been verified by LDAP, an implicit logon will proceed using the tendered UserId as the Teradata Database Username. Note: The special "dbc" username cannot be used with the LDAP authentication mechanism because "dbc" cannot be granted the "logon with null password privilege." If "dbc" is passed as the username, the Teradata Database will return error Teradata Tools and Utilities for IBM AIX Installation Guide

59 Chapter 7 Security and Connecting to a Teradata Database About Connecting to a Teradata Database Note: If the directory does not map the UserId to a specific Teradata Database Username, a generic username will be used and a role assigned. The role will be derived from information contained in the directory. Logon will be by extended logon. Note:.logdata information must always be provided for the LDAP authentication mechanism. TD2 Logon Examples TD2 Logon Mechanisms TD2 represents the Teradata Database logon mechanism. It does not perform any authentication. It facilitates encryption/decryption for sessions connected without the mediation of extended security. A valid Teradata Database username and password are always required. TD2 is used by Teradata Tools and Utilities 8.0 and later for the V2R6.0 Teradata Database and later. There should be no.logdata parameter; if one is passed to CLIv2, it is ignored. TD2 Logon TD2 is the default mechanism for the server-based XML configuration file:.logmech TD2.logon mydbs/rhh,password Connecting to a Teradata Database Programmatically Product ODBC Driver for Teradata OLE DB Provider for Teradata Teradata Call-Level Interface version 2 Several Teradata Tools and Utilities products allow a programmatic connection to a Teradata Database using SQL and APIs. 1 Consult the manual for the specified connectivity product to learn how to programmatically connect to a Teradata Database. Document and Description B A, ODBC Driver for Teradata User Guide Describes SQLConnect, SQLDriverConnect, SQLBrowseConnect, and the parameters implemented for security, and includes information on configuring the ODBC Driver for Teradata B A, OLE DB Provider for Teradata User Guide Teradata JDBC Driver Teradata JDBC Driver Reference : Describes the security implemented for the OLE DB Provider for Teradata B A, Teradata Call-Level Interface Version 2 Reference for Network- Attached Systems Describes the security implemented for the Teradata Call-Level Interface version 2 Describes the security-related connection parameters of the Teradata JDBC Driver Teradata Tools and Utilities for IBM AIX Installation Guide 59

60 Chapter 7 Security and Connecting to a Teradata Database About Connecting to a Teradata Database Checking Logon Error Messages Message Text Explanation Generated by Remedy UTY1652 Logon mechanism is not supported in the version of CLI. The user specified an option that needs to use the logon authentication mechanism feature but this feature is not supported in the version of CLI. UTYMSG Remove specified logon mechanism options. UTY6668 Invalid use of the.logmech statement. It is invalid to specify the.logmech statement after the.logon statement. UTYMSG Remove the invalid statement and resubmit the program. UTY6669 Invalid use of the.logdata statement. It is invalid to specify the.logdata statement after the.logon statement. UTYMSG Remove the invalid statement and resubmit the program. UTY6670 A.LOGMECH statement has been previously specified, terminating. A.LOGMECH statement has already been processed. UTYMSG Remove the extra statement and resubmit the program. UTY6671 A.LOGDATA statement has been previously specified, terminating. A.LOGDATA statement has already been processed. UTYMSG Remove the extra statement and resubmit the program. 60 Teradata Tools and Utilities for IBM AIX Installation Guide

61 CHAPTER 8 Troubleshooting the Installation Client Computer Problem: Cannot Communicate Over the Network with Teradata Database 1 To confirm that a client can communicate over the network to a Teradata Database, ping the Teradata Database: /usr/etc/ping dbcnamecopn dbcnamecopn can appear in upper or lower case. The following is returned as a positive response: dbcnamecopn is alive 2 To perform the second test to verify communication to the Teradata Database, type: telnet dbcnamecopn The following response is returned: telnet: connect: Connection refused 3 If these responses are not received, consult Troubleshooting Network Problems. Client Computer Problem: Incorrect Path Name in COPLIB Check that the COPLIB environment variable has the correct path name to the CLI system parameter block file, clispb.dat. The COPLIB environment variable is set to /usr/lib in the /etc/profile file during the installation of the software. 1 Use one of the following commands to define the correct path name to the clispb.dat file in the COPLIB environment variable: Bourne shell users, add the following to the.profile file: COPLIB=/sd;export COPLIB where sd (source directory) is the name of the directory you created to receive the object library, the system parameter block file, and the executable files. C shell users, add the following to the.login file: setenv COPLIB /sd Teradata Tools and Utilities for IBM AIX Installation Guide 61

62 Chapter 8 Troubleshooting the Installation Client Computer Problem: Incorrect Path Name in COPERR where sd (source directory) is the name of the directory you created to receive the object library, the system parameter block file, and the executable files. 2 Run the.profile or.login file. Client Computer Problem: Incorrect Path Name in COPERR If the No such error found message appears, check that the COPERR environment variable has the correct path name to the error message catalog file, errmsg.cat. 1 Use one of the following commands to define the correct path name to the errmsg.cat file in the COPERR environment variable: Bourne shell users, add the following to the.profile file: COPERR=/ed; export COPERR where ed (error directory) is the name of the directory created to contain the error message catalog file. C shell users, add the following to the.login file: setenv COPERR /ed where ed (error directory) is the name of the directory created to contain the error message catalog file. 2 Run the.profile or.login file. Client Computer Problem: errmsg.cat File Not Found If the CLI: Message catalog open failed! error message appears, the errmsg.cat file cannot be opened. This error is displayed when the errmsg.cat file is not found in the /usr/lib directory or in the directory specified in the COPERR environment variable. 1 Set the COPERR environment variable to the directory where the errmsg.cat file is located. Client Computer Problem: Incorrect Path Name in COPANOMLOG 1 To produce an anomaly log file, verify that the COPANOMLOG environment variable has the correct path name to the anomaly log file. 62 Teradata Tools and Utilities for IBM AIX Installation Guide

63 Client Computer Problem: Missing Hosts File 1 Verify that the /etc/hosts file exists on the client. Chapter 8 Troubleshooting the Installation Client Computer Problem: Missing Hosts File Client Computer Problem: Incorrect Entries in the Hosts File 1 Check the following entries in the /etc/hosts file or in the hosts file on the NIS master: Check all entries for incorrect, missing, or duplicate network addresses of COPs, APs, or nodes. Remember that a TCP/IP (Internet) address is a 4-byte value in the form a.b.c.d. COPs, APs or nodes on the same logical network must have the same network Id portion of the network address. Check that COPs, APs, or nodes in the same group for a Teradata Database have the same dbcname and are numbered sequentially, starting with 1. Remember that the format of a COP name is dbcnamecopn, where dbcname must begin with an alphabetic character. Client Computer Problem: Missing Entries in the / etc/services File 1 Verify that the following lines are in the /etc/services file or the services file on the NIS master. tdmst tdses 1025/udp 1025/tcp Client Computer Problem: Improper Linking 1 Check that the software files are linked properly with your application. Whenever maintenance or upgrade software is installed, relink all applications. Client Computer Problem: Incorrect clispb.dat Parameters 1 Verify that the parameters in the system parameter block file, clispb.dat, have correct values. Teradata Tools and Utilities for IBM AIX Installation Guide 63

64 Chapter 8 Troubleshooting the Installation Client Computer Problem: Cannot Log On from CLI Application 2 Set the default i_dbcpath to correspond to the dbcnames in the /etc/hosts file or in the hosts file on the NIS master. Client Computer Problem: Cannot Log On from CLI Application 1 If you cannot log on to the Teradata Database from a CLI application, try to log on from Basic Teradata Query (BTEQ). 2 If you can log on from Basic Teradata Query, check the CLI application for errors. Client Computer Problem: Cannot Log On to Teradata Database 1 If you cannot log on to a Teradata Database, try logging on to a different database. If you can log on to a different database, there is a problem with the first database or an incorrect address for the first database computer in the /etc/hosts file or the hosts file on the NIS master. Network Problems If there is a network problem, use the following procedure to troubleshoot whether the problem is with network hardware or software. All steps may not be required. 1 Verify that the transceiver is connected to the network, client, and Teradata Database. 2 Check for broken or disconnected network cables. 3 Verify that drop cables are not too long. The cables must comply with IEEE standards. 4 Verify that all repeaters, bridges, routers, and gateways functioning properly. 5 Verify that all jumpers are setup correctly on the client's network controller board. 6 Verify that the network software is installed and running properly on the client. 7 Verify that the network software is compatible with the network controller board installed on the client. 8 Confirm that the network is operational using a network utility program. 9 Use Basic Teradata Query or a network utility program from another client on the same network segment as the first client. If this works, there may be a problem with the first client. 64 Teradata Tools and Utilities for IBM AIX Installation Guide

65 Chapter 8 Troubleshooting the Installation Teradata Database Problem 10 Use Basic Teradata Query or a network utility program from another client on a different network segment from the first client. If this works, there may be a problem with the first network segment. 11 If a network controller board is replaced on the client, reboot Teradata Database so it can obtain the network address of the new board. 12 If the network configuration was changed, check that all network related files were changed accordingly. 13 Reboot the client to reset network hardware and reload network software. Teradata Database Problem Teradata Database problems should be diagnosed with the assistance of a field service representative. 1 Log on to the Teradata Database computer from the operator's console, another network-attached host, or a mainframe. If the logon succeeds, the Teradata Database is operational. If you are unable to log on, contact a field representative. 2 Have a field representative verify that the adaptor cable is connected. 3 Have a field representative check the Multibus Adaptor Board (MAB). 4 Perform the following tests for all entries in CopInfoTbl on the Teradata Database. Check for incorrect, missing, or duplicate cabinet and processor numbers (ccc_p). Check for incorrect, missing, or duplicate network addresses. Check for the correct network protocol type (CopKind) for each COP. Check for the correct host number for each COP, AP, or node. Verify that the entries in CopInfoTbl match the entries in the /etc/hosts file (on the client) or the hosts file on the NIS master. Use the CopUpdate macro to change CopInfoTbl. 5 If a COP, AP, or node is added to or removed from the Teradata Database or if the network address a COP is changed, execute the CopUpdate macro so the Teradata Database can determine changes to network addresses. Restart the Teradata Database for the changes to take effect. 6 If using Internet routing (routers), perform the following tests for CopRoutesTbl: Check for incorrect or missing network addresses of destinations. Check for incorrect or missing network addresses of routes. Verify that each router is identified by two (or more) Internet addresses, one for each network on which it resides. Use the TcpRoute macro to change CopRoutesTbl. 7 If a subnet outing (subnetting) is used, check CopOptionsTbl for incorrect or missing subnet masks. 8 Use the AddOption macro to change CopOptionsTbl. Teradata Tools and Utilities for IBM AIX Installation Guide 65

66 Chapter 8 Troubleshooting the Installation Teradata Parallel Transporter Problem: Unable to Find tbuild 9 If the Teradata Database goes down and then comes back up, its sessions table still contains information about the sessions generated by hosts. The Teradata Database expects to receive reconnect messages from hosts. If the Teradata Database does not receive the reconnect messages within 20 minutes after it comes back up, it removes the sessions that were generated by hosts that have not reconnected from the sessions table. This implies that for 20 minutes after the Teradata Database comes back up, some sessions are being kept that may not be used. If use of the Teradata Database is heavy, users unable to log on during that 20 minute period (because the maximum number of sessions has been reached) can try again after the unclaimed sessions are cleared away. Teradata Parallel Transporter Problem: Unable to Find tbuild If the path to tbuild cannot be found: 1 Log out from the system and log on again. 2 Rerun the Teradata Parallel Transporter job. 3 If you still cannot find tbuild, check that the $TWB_ROOT/bin path is in your PATH environment variable. The TWB_ROOT environment variable is set to the installation directory for Teradata Parallel Transporter. 4 If the $TWB_ROOT/bin path is not in the PATH environment variable, add the $TWB_ROOT/bin path to the front of the PATH environment variable. 5 Run the Teradata Parallel Transporter job again. Teradata Parallel Transporter Problem: Can Not Run New Version of Teradata Parallel Transporter If you cannot run the newly installed version of Teradata Parallel Transporter: 1 Log off from the system and log on again. 2 Run the Teradata Parallel Transporter job again. 3 If you are still unable to run the new installed version of Teradata Parallel Transporter, verify that the $TWB_ROOT/bin path is in the PATH environment variable. TWB_ROOT is the environment variable that is set to the installation directory for Teradata Parallel Transporter. 4 If the $TWB_ROOT/bin path is not in the PATH environment variable, add the $TWB_ROOT/bin path to the front of the PATH environment variable. 5 Run the Teradata Parallel Transporter job again. 66 Teradata Tools and Utilities for IBM AIX Installation Guide

67 Chapter 8 Troubleshooting the Installation Teradata Parallel Transporter Problem: Failed to Load libpxcommon Library Teradata Parallel Transporter Problem: Failed to Load libpxcommon Library 1 If a message similar to the following error message appears when executing a Teradata Parallel Transporter job, log off the system and log on again. ld.so.1: tbuild: fatal: libpxcommon.so: open failed: No such file or directory Killed 2 Run the Teradata Parallel Transporter job again. 3 If the error message still appears, check the $TWB_ROOT/lib path is in the LIBPATH environment variable. TWB_ROOT is the environment variable that is set to the installation directory for Teradata Parallel Transporter. 4 If the $TWB_ROOT/lib path is not in the LIBPATH environment variable, then add the $TWB_ROOT/lib path to the front of the LIBPATH environment variable. 5 Run the Teradata Parallel Transporter job again. Teradata Parallel Transporter Problem: Unable to Find Messages 1 If an error messages similar to the following appears when executing a Teradata Parallel Transporter job, log off the system and log on again. Message Catalog Error: Message 4000 was not found Message Catalog Error: Message 2014 was not found Message Catalog Error: Message 2041 was not found 2 Rerun the Teradata Parallel Transporter job. 3 If the error messages still appears, check the $TWB_ROOT/msg/%N path is in the NLSPATH environment variable. TWB_ROOT is the environment variable that is set to the installation directory for Teradata Parallel Transporter. 4 If the $TWB_ROOT/msg/%N path is not in the NLSPATH environment variable, add the $TWB_ROOT/msg/%N path to the NLSPATH environment variable. 5 Rerun the Teradata Parallel Transporter job. Technical Assistance Technical assistance during installation of the Teradata Tools and Utilities software is available from the Teradata Solutions Customer Services Remote Services Center (TSCS- RSC). For more information, see B C, Teradata Tools and Utilities Release Definition Release Teradata Tools and Utilities for IBM AIX Installation Guide 67

68 Chapter 8 Troubleshooting the Installation Technical Assistance 68 Teradata Tools and Utilities for IBM AIX Installation Guide

69 CHAPTER 9 Deploy Teradata Tools and Utilities with TAR Deploying Applications with TAR The tar_teradata_client_packages script is intended for use by system administrators. The script aids with deploying Teradata Tools and Utilities products across a network. TAR Script Information The tar_teradata_client_packages script downloads Teradata client packages from a disk mount and packages them in a tar file for distribution to other systems. If the gzip executable is installed, packages are compressed accordingly. The tar file can include specific packages or all packages depending on the command options selected. Dependent Teradata Tools and Utilities packages are automatically included in the tar file. The files are copied from the Teradata client media. Third-party software dependencies must be installed separately. TAR Script Compatibility with Platform Operating Systems The tar script provided on the installation media runs on all of the major Linux and UNIX platforms that Teradata client supports and can be run from the DOS prompt in a Windows command window: IBM AIX HP-UX SUSE Linux Red Hat Linux Sun Solaris SPARC Sun Solaris Opteron Executed within a Windows command window (DOS) On UNIX machine with the Korn shell (/bin/ksh) TAR File Contents The tar_teradata_client_packages script is contained on each of the Teradata Tools and Utilities UNIX installation media. It allows the creation of a subset of the Teradata client packages from the DVD media by simply copying a single tar file across the network. The tar file created: Contains all of the files for the specified platform, or all the files for a specified package Includes all of the dependent packages for the client packages in the file Teradata Tools and Utilities for IBM AIX Installation Guide 69

70 Chapter 9 Deploy Teradata Tools and Utilities with TAR Deploying Applications with TAR Verifying TAR Script Dependencies are Installed The tar executable must be located in the PATH on the system running the script. On UNIX, the tar program is typically available in /bin. Note: Windows does not automatically include tar.exe or gzip.exe. They must be installed manually. 1 Ensure the tar executable is located in the PATH on the system running the script. If the tar.exe executable isn't located on the system, the script aborts and provides a suggested location for the user to download the GNU version of tar.exe from ftp:// ftp.gnu.org/pub/pub/gnu/tar/tar-1.12.msdos.exe. Note: On a UNIX system, the tar program is typically available in /bin. If the gzip executable on Windows is available in the PATH, the script attempts to compress the tar file, to make it faster to transfer across a network. Note: The Linux tar file only compresses a small amount, compared to the other platform's packages. TAR Script Commands and Their Functions Two versions of the script are provided: tar_teradata_client_packages.bat for Windows tar_teradata_client_packages.sh for UNIX and Linux Command tar_teradata_client_packages or Description Displays the available commands tar_teradata_client_packages help tar_teradata_client_packages list tar_teradata_client_packages list {platform} Displays the available platforms and packages on the DVD Lists the products available for a specific platform on the DVD Running the script with [platform] as the first parameter creates a tar file in the default target path. The resulting tar file contains all Teradata client packages on that media for that system. The [platform] parameter can be one of the following: aix i386 ia64 opteron pa-risc s390x sparc The path for the output can be changed. The output filename is in the following format: 70 Teradata Tools and Utilities for IBM AIX Installation Guide

71 Chapter 9 Deploy Teradata Tools and Utilities with TAR Deploying Applications with TAR Command Description teradata-client-{platform}-{media_name}.tar (.gz if compressed) Running the script with [platform] as the second parameter following the list parameter only lists the packages available for the specified platform. tar_teradata_client_packages {platform} tar_teradata_client_packages {platform} [{package1} {package2} ] Runs the script creating a tar file for a specific platform, including all packages Optional parameters following the [platform] parameter list specific packages, including: bteq cliv2 fastexp fastld mload If any packages other than the four dependent packages are specified, the dependent packages are all included: cliv2 piom tdicu teragss Adding package names (previously displayed by the list command) after the [platform] parameter always includes the dependent packages if they are available on the media. If any of these packages is individually specified, all of these dependencies are included in the archive. Runs the script creating a tar file for a specific platform and specific packages Optional parameters following the [platform] parameter list specific packages, including: bteq cliv2 fastexp fastld mload If any packages other than the four dependent packages are specified, the dependent packages are all included: cliv2 piom tdicu teragss Adding package names (previously displayed by the list command) after the [platform] parameter always includes the dependent packages if they are available on the media. If any of these packages is individually specified, all of these dependencies are included in the archive. Teradata Tools and Utilities for IBM AIX Installation Guide 71

72 Chapter 9 Deploy Teradata Tools and Utilities with TAR Deploying Applications with TAR Note: The version of the package is not required with the package name; bteq works as well as bteq1400. TAR Script Usage Considerations Subject Default Directory Multiple and Dependent Packages Getting Help on the Script Description The tar script prompts for a directory to create the tar file, and accepts Enter for the default user directory. The default location is: C:\Documents and Settings\username is usually HOME for Windows UNIX user home directory for UNIX /tmp if the script is run as root on UNIX tar_teradata_client_packages attempts to create the directory if it does not exist. If the location is read-only or unable to be written, the script ends. If a single package or multiple packages are selected, all of the dependent products are included, even if the product selected is one of the single dependent packages. Typically, the dependent packages depend on each other; cliv2 depends on tdicu and TeraGSS. For tar_teradata_client_packages, the tar executable can run without parameters, or with the help parameter: D:\tar_teradata_client_packages D:\tar_teradata_client_packages help A screen similar to the following, listing the command usage and optional parameters, appears as a result of the command: ************************************************************************ * Tar Teradata Client Packages v * ************************************************************************ Tar Teradata Client Packages Usage: tar_teradata_client_packages list tar_teradata_client_packages list {platform} tar_teradata_client_packages {platform} [{package1} {package2}...] Parameters: commands : help, list, {platform} [{package1} {package2}...] help : Display this help message. list : List the available platforms and packages from the media. list {platform} : List the packages available for the specified platform. {platform} : Available platforms: aix, ia64, pa-risc, i386, s390x, opteron, sparc Create the tar file for the supplied platform and include all packages or individual packages. {package} : Specify the packages available on this media for the specific platform. The parameter "all" (or blank) will include all available packages. To specify individual packages, list the packages separated by a space. Example: ttcp.bat linux bteq fastld The dependencies will automatically be included and do not need to be listed individually. The following packages are included: ---TeraGSS cliv2 tdicu piom 72 Teradata Tools and Utilities for IBM AIX Installation Guide

73 Chapter 9 Deploy Teradata Tools and Utilities with TAR Deploying Applications with TAR Subject Listing the Available Packages and Platforms Description All of the platforms and packages contained on the DVD can be listed by running the tar executable with the list parameter (platforms and packages vary), for example: /mount/loadunloadvol2> tar_teradata_client_packages.sh list To list all packages for a specific platform available on the DVD, run the tar executable with the list parameter followed by the platform parameter, for example: /mount/loadunloadvol2> tar_teradata_client_packages.sh list HP-UX A screen similar to the following appears as a result of the list command. It lists all the platforms and packages on the current DVD: ************************************************************************ * Tar Teradata Client Packages v * ************************************************************************ Load /Unload - Volume 2 The available platforms are: HP-UX Linux The available packages are: --- HP-UX Products bteq fastexp mload npaxsmod tdicu tpump cliv2 fastld mqaxsmod piom TeraGSS --- Linux Products bteq fastexp mload npaxsmod tdicu tpump cliv2 fastld mqaxsmod piom TeraGSS Downloading Windows Utility Software for TAR Deployment This task is necessary only if you are installing from a Windows platform. 1 Enter the following command to check if tar.exe is installed: D:\tar_teradata_client_packages A screen similar to the following appears, directing you to a location where the tar.exe file can be downloaded, if tar.exe is not installed, and the tar_teradata_client_packages executable is run on the initial skeleton system: ************************************************************************ * Tar Teradata Client Packages v * ************************************************************************ Load/Unload - Volume 2 ERROR: The executable tar.exe doesn't exist on this system or isn't in the PATH. Please download the GNU tar executable from the following address: ftp://ftp.gnu.org/pub/pub/gnu/tar/tar-1.12.msdos.exe Save the file as tar.exe in the C:\WINDOWS directory, or to another directory in the PATH, then rerun this script again. GNU Tar version 1.12 is the recommended tar for DOS to use. For more information see: Teradata Tools and Utilities for IBM AIX Installation Guide 73

74 Chapter 9 Deploy Teradata Tools and Utilities with TAR Deploying Applications with TAR 2 If tar.exe is not installed, install tar.exe and save tar-1.12.msdos.exe as tar.exe in your windows directory: ftp://ftp.gnu.org/pub/pub/gnu/tar/tar-1.12.msdos.exe 3 Enter the following command to check if gzip.exe is installed: D:\tar_teradata_client_packages When the tar file is being created, and gzip.exe cannot be found a message similar to the following is displayed: Notice: The executable gzip.exe is not found. Download from for MSDOS to automatically compress the output tar file to a gzip file. To compress files, download gzip.exe 4 Unless gzip.exe was previously installed, gzip.exe does not exist in your C: \Windows directory. To install it, go to: gzip home page and download the MSDOS version to the C:\Windows directory. Overview of TAR Script Examples The file tar_teradata_client_packages is available on all installation media. The examples list packages available and create tar files that include all packages or individual packages and their dependent packages. Examples are provided that show: Archiving packages on Windows for SPARC Archiving a single package for a UNIX platform Archiving SPARC Packages to Windows This example copies all Sun Solaris SPARC packages on the installation media to a Windows client. The resulting tar file can be copied to Sun Solaris SPARC machines, and the packages loaded there. The procedure includes the following steps 1. Listing available products 2. Downloading/archiving products Note: In this example, gzip.exe has not been installed and the files are not compressed. 1 Enter the tar executable on the Windows system with the list parameter to list the products available for each product and platform: D:\tar_teradata_client_packages list A screen similar to the following appears: ************************************************************************ * Tar Teradata Client Packages v * ************************************************************************ Preprocessors - Volume 3 The available platforms are: AIX Solaris 74 Teradata Tools and Utilities for IBM AIX Installation Guide

75 Chapter 9 Deploy Teradata Tools and Utilities with TAR Deploying Applications with TAR For Solaris Sparc use "sparc" for the platform parameter. For Solaris Opteron use "opteron" for the platform parameter. The available packages are: --- AIX Products cliv2 cobpp sqlpp tdicu TeraGSS --- Solaris Sparc Products cliv21400 sqlpp1400 tdicu1400 TeraGSS TeraGSS Solaris Opteron Products cliv21400 sqlpp1400 tdicu1400 TeraGSS_solaris-i386 TeraGSS_solaris-x Enter the following commands to download the Sun Solaris SPARC packages and dependencies on the Teradata Tools and Utilities media to the Windows client. a D:\tar_teradata_client_packages sparc A screen similar to the following appears: ************************************************************************ * Tar Teradata Client Packages v * ************************************************************************ Preprocessors - Volume 3 Platform: Solaris\Sparc Default Path and Output File: C:\Documents and Settings\<user>\teradata-client-sparc-preprocessors-volume-3.tar Hit [Enter] to accept the path: "C:\Documents and Settings\<user>", or input a different save directory :Output File "C:\Documents and Settings\<user>\teradata-client-sparc-preprocessors-volume-3.tar" b Press Enter to download the packages. A screen similar to the following appears: ---Archiving all packages for sparc. tar cvf "C:\Documents and Settings\<user>\teradata-client-sparc-preprocessors-volume-3.tar" Solaris\Sparc Solaris/Sparc/ Solaris/Sparc/TeraGSS/ Solaris/Sparc/TeraGSS/install/ Solaris/Sparc/TeraGSS/install/depend.. (more files). Solaris/Sparc/tdicu1400/reloc/$LIBDIR64/libiculxtd.so.46.0 Teradata Tools and Utilities for IBM AIX Installation Guide 75

76 Chapter 9 Deploy Teradata Tools and Utilities with TAR Deploying Applications with TAR Solaris/Sparc/tdicu1400/reloc/$LIBDIR64/libicuuctd.so.46.0 tar rvf "C:\Documents and Settings\<user>\teradata-client-sparcpreprocessorsvolume-3.tar".setup.sh.setup.sh tar rvf "C:\Documents and Settings\<user>\teradata-client-sparcpreprocessors-volume-3.tar" setup.bat setup.bat tar rvf "C:\Documents and Settings\<user>\teradata-client-sparcpreprocessors-volume-3.tar" MEDIALABEL MEDIALABEL tar rvf "C:\Documents and Settings\<user>\teradata-client-sparcpreprocessors-volume-3.tar" tar_teradata_client_packages.* tar_teradata_client_packages.bat tar_teradata_client_packages.sh Notice: The executable gzip.exe is not found. Download from for MSDOS to automatically compress the output tar file to a gzip file. The file has been saved at : C:\Documents and Settings\<user>\teradata-client-sparc-preprocessors-volume-3.tar Archiving a Single Package to UNIX This example copies the HP-UX BTEQ package and its dependent packages. 1 Run the tar executable with HP-UX as the platform: D:\tar_teradata_client_packages tar hp-ux bteq A screen similar to the following appears: ************************************************************************ * Tar Teradata Client Packages v * ************************************************************************ Load/Unload - Volume 2 Platform: HP-UX Default Path and Output File: C:\Documents and Settings\user\teradata-client-hp-ux-load-unload-volume-2.tar Hit [Enter] to accept the path: "C:\Documents and Settings\user", or input a different save directory :d: Output File "d:\teradata-client-hp-ux-load-unload-volume-2.tar" ---Archiving setup files and dependency packages for hp-ux tar cvf "d:\teradata-client-hp-ux-load-unload-volume-2.tar" HPUX\TeraGSS* a HP-UX/TeraGSS/ia64/pkginfo.txt 1 block a HP-UX/TeraGSS/ia64/TeraGSS_hpux-ia64_ depot blocks a HP-UX/TeraGSS/ia64/TeraGSS_hpux-ia64_ psf 3 blocks a HP-UX/TeraGSS/pa32/pkginfo.txt 1 block a HP-UX/TeraGSS/pa32/TeraGSS_hpux-pa32_ depot blocks a HP-UX/TeraGSS/pa32/TeraGSS_hpux-pa32_ psf 3 blocks tar rvf "d:\teradata-client-hp-ux-load-unload-volume-2.tar" HP-UX\tdicu* tar: blocksize = 20 a HP-UX/tdicu/ia64/swagent.log 3 blocks a HP-UX/tdicu/ia64/tdicu1400/tdicu1400/opt/teradata/client/14.00/tdicu/ lib/libicudatatd.so blocks a HP-UX/tdicu/ia64/tdicu1400/tdicu1400/opt/teradata/client/14.00/tdicu/ lib/libicui18ntd.so blocks a HP-UX/tdicu/ia64/tdicu1400/tdicu1400/opt/teradata/client/14.00/tdicu/ lib/libicuiotd.so blocks 76 Teradata Tools and Utilities for IBM AIX Installation Guide

77 Chapter 9 Deploy Teradata Tools and Utilities with TAR Deploying Applications with TAR a HP-UX/bteq/pa32/catalog/swlock 0 blocks a HP-UX/bteq/pa32/catalog/INDEX 9 blocks a HP-UX/bteq/pa32/catalog/bteq1400/bteq1400/INFO 4 blocks a HP-UX/bteq/pa32/catalog/bteq1400/bteq1400/INDEX 1 block a HP-UX/bteq/pa32/catalog/bteq1400/bteq1400/postinstall 10 blocks a HP-UX/bteq/pa32/catalog/bteq1400/bteq1400/postremove 5 blocks a HP-UX/bteq/pa32/catalog/bteq1400/bteq1400/preinstall 11 blocks a HP-UX/bteq/pa32/catalog/bteq1400/pfiles/INFO 1 block a HP-UX/bteq/pa32/catalog/bteq1400/pfiles/INDEX 8 blocks a HP-UX/bteq/pa32/catalog/bteq1400/pfiles/README 1 block a HP-UX/bteq/pa32/catalog/bteq1400/pfiles/_ACL 1 block a HP-UX/bteq/pa32/catalog/bteq1400/pfiles/_LOCK_FILE 0 blocks a HP-UX/bteq/pa32/catalog/bteq1400/pfiles/_OWNER 1 block a HP-UX/bteq/pa32/catalog/dfiles/INFO 1 block a HP-UX/bteq/pa32/catalog/dfiles/INDEX 1 block a HP-UX/bteq/pa32/catalog/dfiles/_ACL 1 block a HP-UX/bteq/pa32/catalog/dfiles/_PROD_DFLT_ACL 1 block a HP-UX/bteq/pa32/catalog/dfiles/_LOCK_FILE 0 blocks a HP-UX/bteq/pa32/catalog/dfiles/_OWNER 1 block The file has been saved at : d:\teradata-client-hp-ux-load-unload-volume-2.tar.gz Teradata Tools and Utilities for IBM AIX Installation Guide 77

78 Chapter 9 Deploy Teradata Tools and Utilities with TAR Deploying Applications with TAR 78 Teradata Tools and Utilities for IBM AIX Installation Guide