Teradata Manager. Installation Guide

Transcription

1 Teradata Manager Installation Guide Release 13.0 B A August 2008

2 The product or products described in this book are licensed products of Teradata Corporation or its affiliates. Teradata, BYNET, DBC/1012, DecisionCast, DecisionFlow, DecisionPoint, Eye logo design, InfoWise, Meta Warehouse, MyCommerce, SeeChain, SeeCommerce, SeeRisk, Teradata Decision Experts, Teradata Source Experts, WebAnalyst, and You ve Never Seen Your Business Like This Before are trademarks or registered trademarks of Teradata Corporation or its affiliates. Adaptec and SCSISelect are trademarks or registered trademarks of Adaptec, Inc. AMD Opteron and Opteron are trademarks of Advanced Micro Devices, Inc. BakBone and NetVault are trademarks or registered trademarks of BakBone Software, Inc. EMC, PowerPath, SRDF, and Symmetrix are registered trademarks of EMC Corporation. GoldenGate is a trademark of GoldenGate Software, Inc. Hewlett-Packard and HP are registered trademarks of Hewlett-Packard Company. Intel, Pentium, and XEON are registered trademarks of Intel Corporation. IBM, CICS, RACF, Tivoli, z/os, and z/vm are registered trademarks of International Business Machines Corporation. Linux is a registered trademark of Linus Torvalds. LSI and Engenio are registered trademarks of LSI Corporation. Microsoft, Active Directory, Windows, Windows NT, and Windows Server are registered trademarks of Microsoft Corporation in the United States and other countries. Novell and SUSE are registered trademarks of Novell, Inc., in the United States and other countries. QLogic and SANbox trademarks or registered trademarks of QLogic Corporation. SAS and SAS/C are trademarks or registered trademarks of SAS Institute Inc. SPARC is a registered trademarks of SPARC International, Inc. Sun Microsystems, Solaris, Sun, and Sun Java are trademarks or registered trademarks of Sun Microsystems, Inc., in the United States and other countries. Symantec, NetBackup, and VERITAS are trademarks or registered trademarks of Symantec Corporation or its affiliates in the United States and other countries. Unicode is a collective membership mark and a service mark of Unicode, Inc. UNIX is a registered trademark of The Open Group in the United States and other countries. Other product and company names mentioned herein may be the trademarks of their respective owners. THE INFORMATION CONTAINED IN THIS DOCUMENT IS PROVIDED ON AN AS-IS BASIS, WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING THE IMPLIED WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, OR NON-INFRINGEMENT. SOME JURISDICTIONS DO NOT ALLOW THE EXCLUSION OF IMPLIED WARRANTIES, SO THE ABOVE EXCLUSION MAY NOT APPLY TO YOU. IN NO EVENT WILL TERADATA CORPORATION BE LIABLE FOR ANY INDIRECT, DIRECT, SPECIAL, INCIDENTAL, OR CONSEQUENTIAL DAMAGES, INCLUDING LOST PROFITS OR LOST SAVINGS, EVEN IF EXPRESSLY ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. The information contained in this document may contain references or cross-references to features, functions, products, or services that are not announced or available in your country. Such references do not imply that Teradata Corporation intends to announce such features, functions, products, or services in your country. Please consult your local Teradata Corporation representative for those features, functions, products, or services available in your country. Information contained in this document may contain technical inaccuracies or typographical errors. Information may be changed or updated without notice. Teradata Corporation may also make improvements or changes in the products or services described in this information at any time without notice. To maintain the quality of our products and services, we would like your comments on the accuracy, clarity, organization, and value of this document. Please teradata-books@lists.teradata.com Any comments or materials (collectively referred to as Feedback ) sent to Teradata Corporation will be deemed non-confidential. Teradata Corporation will have no obligation of any kind with respect to Feedback and will be free to use, reproduce, disclose, exhibit, display, transform, create derivative works of, and distribute the Feedback and derivative works thereof without limitation on a royalty-free basis. Further, Teradata Corporation will be free to use any ideas, concepts, know-how, or techniques contained in such Feedback for any purpose whatsoever, including developing, manufacturing, or marketing products or services incorporating Feedback. Copyright by Teradata Corporation. All Rights Reserved.

3 Preface Purpose This book provides information about installing Teradata Manager, which is a Teradata Tools and Utilities product. Teradata Tools and Utilities is a group of products designed to work with Teradata Database. This book provides pre-installation, installation, configuration, and troubleshooting information for Teradata Manager. Audience This book is intended for use by: Database administrators System administrators Technical personnel responsible for maintaining Teradata Manager and the Teradata Manager PC Supported Releases This book supports the following releases: Teradata Database Teradata Tools and Utilities Teradata Manager 13.0 To locate detailed supported-release information, including service pack versions: 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 Manager Installation Guide 3

4 Preface Prerequisites Prerequisites The following prerequisite knowledge is required for this product: Computer technology and terminology Teradata Database Connectivity software, such as ODBC or CLIv2 Microsoft Windows 2000, Windows Server 2003 Windows XP, or Windows Vista Changes to This Book The following changes were made to this book in support of the current release. Changes are marked with change bars. For a complete list of changes to the product, see the Release Definition associated with this release. Date and Release August Description Removed specific service pack version numbers and added information on locating service pack versions to the Preface. See Supported Releases on page 3. Added information for Installing the Teradata Manager Server on page 23. Added information for Installing Teradata Manager Client on page 21, Customizing Teradata Manager Features on page 26 and Installing Only Online Help on page 27. Changed the name of the Teradata Manager log file in this guide from tmgr.log to tmgr_u.log, a change made in the product in a previous release to support Unicode. Removed obsolete information pertaining to pre-teradata Manager 7.0 tables. Changed NCR to Teradata throughout guide, were applicable. Additional Information Additional information that supports this product and Teradata Tools and Utilities is available at the web sites listed in the table that follows. In the table, mmyx represents the publication date of a manual, where mm is the month, y is the last digit of the year, and x is an internal publication code. Match the mmy of a related publication to the date on the cover of this book. This ensures that the publication selected supports the same release. 4 Teradata Manager Installation Guide

5 Preface Additional Information Type of Information Description Source Release overview Late information Additional product information CD-ROM images Ordering information for manuals Use the Release Definition for the following information: Overview of all of the products in the release Information received too late to be included in the manuals Operating systems and Teradata Database versions that are certified to work with each product Version numbers of each product and the documentation for each product Information about available training and the support center Use the Teradata Information Products web site to view or download specific manuals that supply related or additional information to this manual. Access a link to a downloadable CD-ROM image of all customer documentation for this release. Customers are authorized to create CD-ROMs for their use from this image. Use the Teradata Information Products web site to order printed versions of manuals. 1 Go to 2 Under Online Publications, click General Search 3 Type 2029 in the Publication Product ID box. 4 Click Search. 5 Select the appropriate Release Definition from the search results. 1 Go to 2 Under the Online Publications subcategory, Browse by Category, click Data Warehousing. 3 Do one of the following: For a list of Teradata Tools and Utilities documents, click Teradata Tools and Utilities, and then select an item under Releases or Products. Select a link to any of the data warehousing publications categories listed. Specific books related to Teradata Manager are as follows: Teradata Database V2R6.0 for Microsoft Windows 2000 Installation Guide B K Teradata Manager User Guide B mmyx Teradata Tools and Utilities Installation Guide for Microsoft Windows B mmyx 1 Go to 2 Under the Online Publications subcategory, Browse by Category, click Data Warehousing. 3 Click CD-ROM List and Images. 4 Follow the ordering instructions. 1 Go to 2 Under Print & CD Publications, click How to Order. 3 Follow the ordering instructions. Teradata Manager Installation Guide 5

6 Preface Additional Information Type of Information Description Source General information about Teradata The Teradata home page provides links to numerous sources of information about Teradata. Links include: Executive reports, case studies of customer experiences with Teradata, and thought leadership Technical information, solutions, and expert advice Press releases, mentions, and media resources 1 Go to Teradata.com. 2 Select a link. 6 Teradata Manager Installation Guide

7 Table of Contents Preface Purpose Audience Supported Releases Prerequisites Changes to This Book Additional Information Chapter 1: Before Installation Installation Requirements Hardware Recommendations Software Requirements Space Requirements Authorization Communications Teradata Database Dependencies Single Sign On Requirements Windows Updates: Important Information Teradata Manager File Locations Performance Considerations Multiple Teradata Manager PCs with a Single Teradata Database Improve Logon Performance Chapter 2: Teradata Manager Installation Task 1: Actions To Take Before Upgrading Task 2: Verify the PC-to-Teradata Database Connection Task 3: [Optional] Enable Support for Non-ASCII Character Sets Task 4: Run the Installation Program Teradata Manager Installation Guide 7

8 Table of Contents Typical, Custom, and Network Installations Client, Server, Custom, or Help Only Installing Teradata Manager Client Installing the Teradata Manager Server Customizing Teradata Manager Features Task 5: Configure Teradata Manager Task 6: Windows Vista Operating System Installing Only Online Help Appendix A: Troubleshoot Verify Software Compatibility Teradata Manager Errors SNMP Key Configuration for Alerts ISService.exe Registration Graphics Server Problem XML Parser Upgrade Problem Install a Japanese Version on a Non-Japanese PC Glossary Index Teradata Manager Installation Guide

9 List of Tables Table 1: Teradata Manager Server Hardware Configuration Requirements Table 2: Teradata Manager Client Hardware Configuration Requirements Table 3: Space Requirements for Installation Table 4: Teradata Manager File Locations Table 5: Troubleshooting Hints Table 6: SNMP Key Configuration - Key Table 7: SNMP Key Configuration - Key Teradata Manager Installation Guide 9

10 List of Tables 10 Teradata Manager Installation Guide

11 CHAPTER 1 Before Installation This chapter provides pre-installation information. Description Hardware, software, space and communications requirements, as well as Teradata Database dependencies that must be met before Teradata Manager software can be installed Important prerequisites for installing software updates Description of the Teradata Manager directory structure Performance considerations for sites using multiple Teradata Manager PCs with a single Teradata Database Additional Information Installation Requirements on page 11 Windows Updates: Important Information on page 14 Teradata Manager File Locations on page 14 Performance Considerations on page 16 Installation Requirements This section describes hardware, software, disk space, and network communications requirements for installing and running Teradata Manager. Hardware Recommendations The following configuration is recommended for Teradata Manager Server PCs: Table 1: Teradata Manager Server Hardware Configuration Requirements Minimum Configuration Recommended Configuration 1.2 GHz Pentium IV 2 GHz Pentium IV 512 MB of RAM 1 GB of RAM Two 18 GB Hard Disk (100 MB for Teradata Manager software) CD-ROM drive Two 30 GB Hard Disk (200 MB for Teradata Manager software) CD-ROM drive Teradata Manager Installation Guide 11

12 Chapter 1: Before Installation Installation Requirements Table 1: Teradata Manager Server Hardware Configuration Requirements (continued) Minimum Configuration Network connection supporting TCP/IP Modem (required to use the Send a Page action of the Alerts facility) Monitor running a minimum of 256 colors at a resolution of 1024x768 or higher Recommended Configuration Network connection supporting TCP/IP Modem (required to use the Send a Page action of the Alerts facility) Monitor running a minimum of 256 colors at a resolution of 1280x1024 or higher The following configuration is recommended for Teradata Manager Client PCs: Table 2: Teradata Manager Client Hardware Configuration Requirements Minimum Configuration Recommended Configuration 500 MHz Pentium III 1.2 GHz Pentium IV 256 MB of RAM 512 MB of RAM 10 GB Hard Disk (100MB for Teradata Manager) CD-ROM drive Network connection supporting TCP/IP Monitor running a minimum of 256 colors at a resolution of 1024x768 or higher 40 GB Hard Disk (200MB for Teradata Manager) CD-ROM drive Network connection supporting TCP/IP Monitor running a minimum of 256 colors at a resolution of 1280x1024 or higher Software Requirements One of the following operating systems is required to run Teradata Manager: 32-bit or 64-bit Windows Vista, Windows Server 2003, or Windows XP Professional. 32-bit Windows The following system software and middleware are required to run Teradata Manager: Internet Explorer or higher. Teradata Call-Level Interface Version 2 (CLIv2) for Network Attached Systems or higher. Teradata Data Connector version or later Shared ICU Libraries (TDICU) for Teradata version or later Teradata GSS Client (TeraGSS). See TeraGSS Version on page 13. Microsoft Exchange Server and MAPI-based client software (for example, MS Outlook) or SMTP mail only required if the notification option is used from the Alerts server application. Windows SNMP Service Only required if the SNMP Trap action is used from the Alerts server application. 12 Teradata Manager Installation Guide

13 Chapter 1: Before Installation Installation Requirements TeraGSS Version Space Requirements Microsoft Visual C++ Compiler Required on the database if the Teradata Database is running on a Windows operating system and Teradata stored procedures are being used. Stored procedures are used in basic features of Teradata Manager such as creating a user. For more information about installing the compiler software, see Teradata Database V2R6.0 for Microsoft Windows 2000 Installation Guide, B K. Note: The Teradata Database must be configured for compiling stored procedures. See the Teradata Database documentation for more information. For a particular release, the TDGSS version number matches the Teradata Database version number. The TeraGSS versions on the client and server may be revised independently and may or may not match for a particular Teradata Database release. Updating the TDGSS or TeraGSS packages is not required when upgrading the Teradata Database or TTU to a new version. However, if there is a version mismatch between client and server, only the security features common to both versions will be used. For more information, see Security Administration. Refer to Additional Information on page 4. The following table lists the application space required for each of the available installation types. The minimum required size is the amount of disk space needed to install the program files. The recommended size includes the size of the temporary files required for monitoring the Teradata Database. Table 3: Space Requirements for Installation Installation Type Minimum Required Size Recommended Size Server 100 MB 200 MB Client 100 MB 200 MB Custom 8 MB plus the size of the selected applications 100 MB Authorization Note: The actual size required for a custom installation varies with the number and size of the applications installed. The required size listed (8 MB) does not include any Teradata Manager applications. Use the Teradata Manager Custom Setup dialog box to select the applications. The sizes of the individual applications are listed. To install Teradata Manager, log on as a member of the Administrators group. Teradata Manager Installation Guide 13

14 Chapter 1: Before Installation Windows Updates: Important Information Communications The Teradata Manager PC must have established communications with the Teradata Database system. Your System Administrator can help verify or establish the required network connection. A remote network connection, such as PPP, is required to access Teradata Database systems from a remote location. Teradata Database Dependencies Teradata Manager and its applications are dependent on the following Teradata Database characteristics: Hardware The supported Teradata hardware platforms are those that are currently supported for the Teradata Database. Software Teradata Manager is certified on of the Teradata Database, and supported on V2R6.1.x and higher. Single Sign On Requirements To use Single Sign On from Teradata Manager, set the environment variable GUILOGON=NO. For information on setting environment variables, see Improve Logon Performance on page 16. Windows Updates: Important Information It is recommended all applications be stopped, including the Teradata Manager Service, before applying any Microsoft Windows updates. If your Teradata Manager PC has the Windows Automatic Updates feature, choose any option except Automatic (recommended). This allows the complete shutdown of Teradata Manager prior to applying a Windows update. Teradata Manager File Locations Teradata Manager files are stored in the various locations described in the following table. In all cases: x - is the drive selected during the installation procedure userid - is the name of the logged on user DatabaseName - is the name of the Teradata Database being monitored by Teradata Manager. 14 Teradata Manager Installation Guide

15 Chapter 1: Before Installation Teradata Manager File Locations Table 4: Teradata Manager File Locations These types of files... Program files and other read-only files Are stored in... The program files directory. The default for 32-bit platforms is: x:\program Files\Teradata\Teradata Manager 13.0 The default for 64-bit platforms is: x:\program Files(x86)\Teradata\Teradata Manager 13.0 The Teradata Manager 13.0 directory contains the following subdirectories: BIN - Program executables, resource files and some help files Data - Template files and data files Help - HTML Help files Samples - Sample code to get started with the Teradata Manager Performance Object Model Secure - All user applications and BTEQ scripts that will be called by alert actions. Write permission to this directory can only be granted to users responsible for setting up the Teradata Alerts system. SQL - SQL scripts used to set up the Teradata Manager tables, and for various applications to retrieve data Data files, reports and logs The user s My Documents and Application Data directories. The default is: x:\documents and Settings\<userid>\My Documents\ Teradata\Teradata Manager This Teradata Manager directory contains the following sub-directories: Data - Saved run-time data Profiles - Logs and other output files associated with databases being monitored by Teradata Manager Teradata Manager Service log files (tmgr_u.log) User s personal Teradata Manager log files (tmgr_u.log) Alert Action log file (alerts.log) The system application directory. The default is: x:\documents and Settings\All Users\Application Data\ Teradata\Teradata Manager The user s My Documents directory. Prior to Teradata Manager connecting to Teradata Database, the default is: x:\documents and Settings\<userid>\My Documents\Teradata\ Teradata Manager\Data After Teradata Manager has connected to Teradata Database, the default is: x:\documents and Settings\<userid>\My Documents\Teradata\ Teradata Manager\Profiles\<DatabaseName>\logs Typically the tmgr_u.log does not appear in the logs directory until data is written to it. The system application directory. The default is: x:\documents and Settings\All Users\Application Data\ Teradata\Teradata Manager\Databases\<DatabaseName>\ Teradata Manager Installation Guide 15

16 Chapter 1: Before Installation Performance Considerations Performance Considerations Multiple Teradata Manager PCs with a Single Teradata Database When multiple Teradata Manager PCs access a single Teradata Database, the volume of requests may degrade the database performance. To avoid degrading performance of the Teradata Database, Teradata Manager provides a network feature where one Teradata Manager PC is set up as a server of data to the other client PCs. Communication is over a TCP/IP network. In client/server operation, data collector applications run on the server PC, obtaining performance data from the Teradata Database. When client PCs run supported applications, they obtain performance data from the server PC. For more information, see the Teradata Manager User Guide. Important: Before running any Teradata Manager Client applications, be sure the Client PC is running the same version of Teradata Manager software as the Server PC. Improve Logon Performance The time required to logon to a Teradata system can be greatly improved by adding an environment variable for each Teradata Database system. (Environment variables are defined using the System control panel.) The variable name is the host name of the Database (without the copn suffix). For example, if the Database is named Productioncop1, referred to as Production when logging on to the system, the variable name would be Production. The variable value is the number of copn entries in the hosts file. This number is the same as the number of parsing engines connected to your network. For example, if there are eight copn entries, the variable value is Teradata Manager Installation Guide

17 CHAPTER 2 Teradata Manager Installation This chapter provides step-by-step instructions for installing Teradata Manager. Task Important actions to take before upgrading your Teradata Manager installation Verifying the connection from your Teradata Manager PC to the Teradata Database Handling of non-ascii character set object names (for example, KANJISJIS_0S) Running the Teradata Manager installation program Configuring and customizing your installed Teradata Manager software Installing a Windows Help program so online help files display when using Windows Vista operating systems Additional Information Task 1: Actions To Take Before Upgrading on page 17 Task 2: Verify the PC-to-Teradata Database Connection on page 19 Task 3: [Optional] Enable Support for Non-ASCII Character Sets on page 20 Task 4: Run the Installation Program on page 20 Task 5: Configure Teradata Manager on page 26 Task 6: Windows Vista Operating System on page 27 Installing only online help Installing Only Online Help on page 27 Task 1: Actions To Take Before Upgrading If not upgrading from a previous release, skip to Task 2: Verify the PC-to-Teradata Database Connection on page 19. Actions to Take if Upgrading Software from a Previous Release If upgrading your Teradata Manager software from a previous release, use the following procedure to prepare your system for the new version: As a safety precaution, perform a full backup of your Teradata Manager system, including the current data, output, and log files. Note: The installation program is designed to preserve the files of all Teradata Manager installations already on the PC. If any existing Teradata Manager installation is removed, program files are deleted, but the preferences from the registry are saved. Teradata Manager Installation Guide 17

18 Chapter 2: Teradata Manager Installation Task 1: Actions To Take Before Upgrading Note: The person removing Teradata Manager must be a member of the Administrators group. Actions to Take if Upgrading the Teradata Database If upgrading the Teradata Database from V2R6.x or 12.0 to 13.0 and Teradata Manager was configured on the V2R6.x or 12.0 database, use the following procedure: 1 Backup the dbcmngr database. 2 Upgrade the Teradata Database to Run Teradata Manager 13.0 Database Setup on the upgraded Teradata Database. This is necessary even if Teradata Manager 13.0 was already configured on V2R6.x or Recommendations Accept the default program installation directory and Program Folder. By default, the program icons are installed in the Teradata Manager 13.0 folder, and the program is installed in a Program Files directory of the same name. When upgrading an installation to a new version, the installation program prevents an upgrade in an existing directory. Therefore, if the user intends to use or remove the older Teradata Manager version after the upgrade, do not install the new version into the old directory (for example, \Program Files\NCR\Teradata Manager). If the same directory is used, some files essential for running the new version will be removed. To determine if a file is missing or at the wrong version If removing an older version of Teradata Manager after installing Teradata Manager 13.0, do the following to determine if a file is missing or at the wrong version: 1 Run the Verify application. See Verify Software Compatibility on page If a file is missing or at the wrong version, run the Repair option. a b c d From the Windows desktop, click Start>Settings>Control Panel>Add or Remove Programs or from the Windows Vista desktop, click Start>Settings>Control Panel>Programs and Features. Click Teradata Manager number, where number is the version number. Click Change/Remove. Click Repair. 3 Run the Verify application again. 18 Teradata Manager Installation Guide

19 Chapter 2: Teradata Manager Installation Task 2: Verify the PC-to-Teradata Database Connection Task 2: Verify the PC-to-Teradata Database Connection Verify the Teradata Manager PC can communicate with the Teradata Database system. If upgrading from a previous release or already verified your communications, skip to Task 3: [Optional] Enable Support for Non-ASCII Character Sets on page 20. To verify communication with the Teradata Database Enter the PING command from a Windows DOS window to check communication with the Teradata Database. For example, PING ssscop1 where sss is the Teradata Database name at your site. The Teradata Database system returns the message: Reply from xxx.xxx.xxx.xxx where xxx.xxx.xxx.xxx is the IP Address of the Database. If the PING command does not receive a response from the Database, check with your Network Administrator for the cause of the error. Note: Failure to communicate with the Teradata Database can be caused by an incorrect or missing IP address and system name in the hosts file on the PC. The hosts file is located in the system32\drivers\etc subdirectory of the directory in which Windows is installed. If Domain Name Services (DNS) is not used, check that the HOSTS file contains entries similar to the following: xxx.xxx.xxx.xxx ssscop1 where xxx.xxx.xxx.xxx is the functional IP address and sss is the Teradata Database name. If DNS is used, contact your network administrator for help with system identification. Ensure that a remote access provider, such as PPP, is available to enable the PC to access the Teradata Database from a remote location. Teradata Manager Installation Guide 19

20 Chapter 2: Teradata Manager Installation Task 3: [Optional] Enable Support for Non-ASCII Character Sets Task 3: [Optional] Enable Support for Non- ASCII Character Sets Non-ASCII Character Sets If your installation requires the handling of non-ascii character set object names (for example, KANJISJIS_0S), complete this procedure. 1 Create a new directory x:\coplib (where x is an available drive). 2 Copy clispb.dat from the Teradata Client for Windows installation directory to x:\coplib. The default installation directory is c:\program Files\Teradata\Client\13.0\cliv2. 3 Add the following two lines to x:\coplib\clispb.dat, specifying the database character set name to be used in place of KANJISJIS_0S: charset_type=n charset_id=kanjisjis_0s 4 Add the new user environment variable COPLIB to your Windows settings, and set the location to x:\coplib. 5 Restart your PC to enable the new user environment variable. Note: This procedure is not required to run BTEQ Window. When initiating a BTEQ Window session, the session character set must be selected. Since BTEQ Window sessions now require this initial character set choice, the charset_id value as defined in the clispb.dat file is not processed. Task 4: Run the Installation Program Teradata Manager is installed using the Teradata Tools and Utilities installation media. Typical, Custom, and Network Installations Running the installation, you can: Typical Custom Network Install all the applications (Teradata Manager and all other applications on the Database Management installation CD). Allows you to choose which applications to install, silently or interactively. Choose specific applications to install, silently or interactively. To install Teradata Manager Server, you must choose this option. Copy selected product setup files to a specified directory for installation now or at a later time. Client, Server, Custom, or Help Only During the installation process, the options in the table below are presented. Teradata Manager Server is required for users who want to use alerts, the Dashboard, workload analysis 20 Teradata Manager Installation Guide

21 Chapter 2: Teradata Manager Installation Task 4: Run the Installation Program and trends, the scheduler, or client/server mode connections. Installing the Teradata Manager Server should be limited to a small number of PCs to minimize the impact and resource consumption of Teradata Manager on the Teradata Database. For more information, see Multiple Teradata Manager PCs with a Single Teradata Database on page 16. All other PCs should have Teradata Manager Client installed. Client Server Custom Help Only Installs all Teradata Manager applications except for server applications used by the client/server. Recommended for most computers. See Installing Teradata Manager Client on page 21. Installs all Teradata Manager applications. Recommended for computers that will be acting as a Teradata Manager server. Typically this is one or two computers. To use the Alert Viewer, Dashboard, SNMP Agent, or Workload Trend Analysis, at least one PC at your site must be set up as a Teradata Manager Server. See Installing the Teradata Manager Server on page 23. Installs specific applications of your choice. Recommended for advanced users. Choose specific features where you want the user to have limited functionality or access. See Customizing Teradata Manager Features on page 26. Installs help files for Teradata Manager, but does not install the software. Recommended for users interested in learning about Teradata Manager, but do not want to install Teradata Manager. See Installing Only Online Help on page 27. Installing Teradata Manager Client Use the following procedure to install all Teradata Manager applications, except for server applications, on your PC. Using the default program installation directory and Program Folder is recommended. To install Teradata Manager Client on your PC 1 Exit all currently running Windows programs and disable any virus protection software running on the computer. 2 Insert the Teradata Tools and Utilities Release 13.0 Database Management into the CD drive. 3 In the Welcome to Teradata Tools and Utilities dialog box, click Install Product. 4 In the Choose Setup Language dialog box, click the drop-down arrow, and select the desired language from the list, then click OK. English and Japanese are the only setup languages currently supported. 5 After reading the information in the Welcome dialog box, click Next. 6 In the Software License Agreement dialog box, read the agreement, then click Yes to accept it. 7 In the Setup Type dialog box, click Custom, then click Next. Teradata Manager Installation Guide 21

22 Chapter 2: Teradata Manager Installation Task 4: Run the Installation Program 8 In the Select Components dialog box, select the check box next to Teradata Manager, then click Next. Note: Products that Teradata Manager is dependent on will be automatically selected. 9 If Shared ICU Libraries are already installed on your PC, a message appears asking if you want to overwrite it with the new version. Select Yes to overwrite the old version or No to not overwrite the old version. 10 If Teradata CLIv2 is already installed on your PC, a message appears asking if you want to reinstall it. Select Yes to install it or No to not install it. 11 In the Choose Destination Location dialog box, the default path is shown in the Destination Folder. If this is acceptable, click Next (recommended). To use a destination location other than the default, click Browse, navigate to the location where you want the files installed, click OK, then click Next. Note: You must have write access to the destination folder, the Windows root folder, and the Windows system folder. 12 In the Select Install Method dialog box, select Teradata Manager as well as all the dependencies shown to install the products silently (recommended) or select Clear All to install the products interactively. 13 Click Next. 22 Teradata Manager Installation Guide

23 Chapter 2: Teradata Manager Installation Task 4: Run the Installation Program 14 If you selected at least one product for silent installation, an informational message appears indicating you can now modify the product response file using a text editor. Click OK to close the message and then modify the product response file, if desired. During installation, progress monitors will appear. If all applications were selected for silent installation, no action is required. This may take a few minutes. 15 In the Setup Complete dialog box, choose whether or not to view the Release Definition, then click Finish. 16 Remove the installation CD from the CD drive. 17 [Optional] We recommend you reboot your PC. Installing the Teradata Manager Server Use the following procedure to install all Teradata Manager applications on a PC that will be acting as a Teradata Manager server. To use the Alert Viewer, Dashboard, SNMP Agent, or Workload Trend Analysis, at least one PC at your site must be set up as a Teradata Manager Server. To install Teradata Manager Server on your PC 1 Exit all currently running Windows programs and disable any virus protection software running on the computer. 2 Insert the Teradata Tools and Utilities Release 13.0 Database Management CD into the CD drive. 3 In the Welcome to Teradata Tools and Utilities dialog box, click Install Product. 4 In the Choose Setup Language dialog box, click the drop-down arrow, and select the desired language from the list, then click OK. English and Japanese are the only setup languages currently supported. 5 After reading the information in the Welcome dialog box, click Next. 6 In the Software License Agreement dialog box, read the agreement, then click Yes to accept it. 7 In the Setup Type dialog box, click Custom, then click Next. 8 In the Select Components dialog box, select the check box next to Teradata Manager, then click Next. Note: Products that Teradata Manager is dependent on will be automatically selected. 9 If Shared ICU Libraries are already installed on your PC, a message appears asking if you want to overwrite it with the new version. Select Yes to overwrite the old version or No to not overwrite the old version. 10 If Teradata CLIv2 is already installed on your PC, a message appears asking if you want to reinstall it. Select Yes to install it or No to not install it. 11 In the Choose Destination Location dialog box, the default path is shown in the Destination Folder. If this is acceptable, click Next (recommended). Teradata Manager Installation Guide 23

24 Chapter 2: Teradata Manager Installation Task 4: Run the Installation Program To use a destination location other than the default, click Browse, navigate to the location where you want the files installed, click OK, then click Next. Note: You must have write access to the destination folder, the Windows root folder, and the Windows system folder. 12 In the Select Install Method dialog box, unselect Teradata Manager (refer to the following example). Keep the remaining dependencies highlighted to install them silently (recommended) or select Clear All to install the products interactively. If Clear All is selected, Shared ICU Libraries for Teradata remains highlighted because it must be installed silently. 13 Click Next. 14 If you selected at least one product for silent installation, an informational message appears indicating you can now modify the product response file using a text editor. Click OK to close the message and then modify the product response file, if desired. During installation, progress monitors will appear. No action is required. This may take a few minutes. 15 In the Teradata Manager - InstallShield Wizard dialog box, select Next. 16 Read the Teradata Software Agreement, then click Yes. 17 In the Choose Destination Location dialog box, the default path is shown in the Destination Folder. If this is acceptable, click Next (recommended). To use a destination location other than the default, click Browse, navigate to the location where you want the files installed, click OK, then click Next. Note: You must have write access to the destination folder, the Windows root folder, and the Windows system folder. 24 Teradata Manager Installation Guide

25 Chapter 2: Teradata Manager Installation Task 4: Run the Installation Program 18 In the Setup Type dialog box, click Server, then click Next. 19 In the Select Program Folder dialog box, the default program folder is shown. If this is acceptable, click Next (recommended). To rename the default program folder, type a new name in the Program Folder box, then click Next. 20 In the Start Copying Files dialog box, click Next. During installation, progress monitors will appear. No action is required. This may take a few minutes. 21 Read the information in the Teradata Manager Service dialog box, then click Next. 22 In the InstallShield Wizard Complete dialog box, choose whether or not to view online help or to start Database Setup, then click Finish. 23 In the Setup Complete dialog box, choose whether or not to view the Release Definition, then click Finish. 24 Remove the installation CD from the CD drive. 25 If installing Teradata Manager or other Teradata Tools and Utilities 13.0 software on a new workstation or upgrading the CLIv2 package on Microsoft Windows platforms, reboot before using the Teradata Manager Service. This ensures the service acquires the updated system PATH environment variable. To check status of the Teradata Manager Service, see the Teradata Manager User Guide. Teradata Manager Installation Guide 25

26 Chapter 2: Teradata Manager Installation Task 5: Configure Teradata Manager Customizing Teradata Manager Features During installation, you have the option of customizing which features are installed on a Client or Server PC. Typically, this is done if you want the user to have limited functionality or access. These features include Alert Viewer, Alert Policy Editor, BTEQWIN, Error Log Analyzer, Locking Logger, LogOnOff Usage, Performance Monitor, Priority Scheduler Administrator, Remote Console, Session Information, and Statistics Collection. To specify which Teradata Manager features are installed 1 Complete steps 1 through 17 in To install Teradata Manager Server on your PC on page In the Setup Type dialog box, click Custom, then click Next. 3 In the Select Features dialog box, select the features you want to install, then click Next. 4 Complete the rest of the installation using the InstallShield Wizard. Task 5: Configure Teradata Manager After Teradata Manager is installed, see the Teradata Manager User Guide: Chapter 4, Configuring Teradata Manager for instructions on setting up the program. 26 Teradata Manager Installation Guide

27 Chapter 2: Teradata Manager Installation Task 6: Windows Vista Operating System Task 6: Windows Vista Operating System If Teradata Manager is being installed on a Windows Vista operating system, perform this task. Starting with Windows Vista, a Windows Help program called WinHlp32.exe is no longer included. This application is required to display 32-bit online help files. Use the following procedure to install the Windows Help program. To install the Windows Help program Teradata Manager must be installed before proceeding. 1 Go to 2 In the Search box, type WinHlp32 Vista to locate the WinHlp32.exe file. Note: Windows Vista users must pass a short validation process before downloading the file. Once validated, specific instructions are given for obtaining the download. 3 From Files in This Download, the following files appear: For 32-bit operating systems, click Download for Windows6.0-KB x86.msu. For 64-bit operating systems, click Download for Windows6.0-KB x64.msu. 4 Click Run and follow the instructions. The default location is the c:\windows directory. Note: Context-sensitive help works, but the Contents, Index, and Search tabs may not be available if full WinHelp macro functionality is not enabled. For more information, see the Microsoft Knowledge Base article Installing Only Online Help For users interested in learning about Teradata Manager, but do not want to install the application, you can install just the online help using the following procedure. To install only online help 1 Complete steps 2 through 17 in To install Teradata Manager Server on your PC on page In the Setup Type dialog box, click Help Only, then click Next. 3 Complete the rest of the installation using the Installation Wizard. For information on using online help or to allow online help content to appear using Internet Explorer, version 7.0, see Teradata Manager User Guide. Teradata Manager Installation Guide 27

28 Chapter 2: Teradata Manager Installation Installing Only Online Help 28 Teradata Manager Installation Guide

29 APPENDIX A Troubleshoot This appendix provides information for troubleshooting your Teradata Manager installation. Problem How to be sure the software on your system is compatible with this new release What to do if Teradata Manager generates errors What to do if your SNMP registry key is not configured correctly Registering the Teradata Manager Service after installing Teradata Manager 13.0, and then going back to version 7.2 A graphics server problem after installing Teradata Manager 13.0, and then going back to version 7.1 Additional Information Verify Software Compatibility on page 29 Teradata Manager Errors on page 30 SNMP Key Configuration for Alerts on page 31 ISService.exe Registration on page 32 Graphics Server Problem on page 33 An XML Parser Upgrade problem XML Parser Upgrade Problem on page 33 Installing a Japanese version of Teradata Manager on a non-japanese PC Install a Japanese Version on a Non-Japanese PC on page 33 Verify Software Compatibility If Teradata Manager does not run after installing it, be sure the software on your system is compatible with this new release by running the Verify application. To run the Verify application 1 Locate the Verify application (Verify.exe) in the BIN subdirectory of the Teradata Manager application installation. The default location for 32-bit platforms is: c:\program Files\Teradata\Teradata Manager 13.0\BIN Teradata Manager Installation Guide 29

30 Appendix A: Troubleshoot Teradata Manager Errors The default location for 64-bit platforms is: c:\program Files(x86)\Teradata\Teradata Manager 13.0\BIN 2 Double-click the Verify.exe file to launch the application. A message displays indicating if there are any software mismatches. 3 If there are any problems, click View Log to open the Verify log file. 4 Check the Verify log file. This log file shows a detailed version and location description of each required file, and the ability to flag the compatibility status. If the status of any of the files is questionable, print the log file and contact Teradata to resolve the problem. Note: If a custom installation was performed where only a subset of the Teradata Manager applications were installed, Verify may report some software as Not Found. If a Client-type installation is performed, the server files will be reported as Not Found (AlertAction.dll, AlertMem.dll, AlertSrv.dll, DataCollect.dll, ISService.exe, and tmsnmpx.dll). Teradata Manager Errors Error messages appear in pop-up dialog boxes. Review the Teradata Manager log file (tmgr_u.log) to get information about the error. See the Teradata Manager User Guide for the location of this file. When the cause of an error cannot be readily identified, see Table 5. Table 5: Troubleshooting Hints If... An application is unable to log on to the associated Teradata Database Locking Logger will not run Then... Use BTEQ Window, installed from the Teradata Tools and Utilities Utility Pack CD, to log on to the Database. This is the quickest way to see if your connection is down. If logging on from a BTEQ Window is successful, but not from your application, examine the default logon information for the associated Database by selecting Options>Change Logon Settings from the Teradata Manager Menu Bar. Be sure the Locking Logger user is defined using the Teradata Manager Database Setup utility. To use Locking Logger, the user must have the correct database permissions. 30 Teradata Manager Installation Guide

31 Appendix A: Troubleshoot SNMP Key Configuration for Alerts Table 5: Troubleshooting Hints (continued) If... An error occurs stating any of the following: VC++ compiler is not installed no C++ compiler C/C++ compiler is not installed no compiler available Then... Install a Microsoft Visual C++ compiler on the database if the Teradata Database is running on a Windows operating system. Do this if Teradata stored procedures will be used. Stored procedures are used in basic features of Teradata Manager such as creating a user. For more information about installing the compiler, see Teradata Database V2R6.0 for Microsoft Windows 2000 Installation Guide, B K. Note: The Teradata Database must be configured for compiling stored procedures. See the Teradata Database documentation for more information. SNMP Key Configuration for Alerts If there are two versions of Teradata Manager installed, and the most recently installed version is uninstalled, your SNMP registry key will not be configured correctly. To use SNMP for alerts, modify the following keys to have the correct values. Table 6: SNMP Key Configuration - Key 1 Label Key Value Name Value Data Value HKLM\SYSTEM\CurrentControlSet\Services\SNMP\Parameters\ExtensionAgents Any value unique in the list of values, for example a number For Teradata Manager 13.0 and later releases: SOFTWARE\Teradata \TeradataManager\SNMPAgent\CurrentVersion For Teradata Manager 12.0 and earlier releases: SOFTWARE\NCR\TeradataManager\SNMPAgent\CurrentVersion Table 7: SNMP Key Configuration - Key 2 Label Key Value Name Value For Teradata Manager 13.0 and later releases: HKLM\SOFTWARE\Teradata\TeradataManager\SNMPAgent\CurrentVersion For Teradata Manager 12.0 and earlier releases: HKLM\SOFTWARE\NCR\TeradataManager\SNMPAgent\CurrentVersion PathName Teradata Manager Installation Guide 31