Professional Documents
Culture Documents
PC 811 InstallationGuide
PC 811 InstallationGuide
Informatica PowerCenter
(Version 8.1.1)
Informatica PowerCenter Installation and Configuration Guide Version 8.1.1 April 2007 Copyright (c) 19982007 Informatica Corporation. All rights reserved. Printed in the USA. This software and documentation contain proprietary information of Informatica Corporation and are provided under a license agreement containing restrictions on use and disclosure and are also protected by copyright law. Reverse engineering of the software is prohibited. No part of this document may be reproduced or transmitted in any form, by any means (electronic, photocopying, recording or otherwise) without prior consent of Informatica Corporation. Use, duplication, or disclosure of the Software by the U.S. Government is subject to the restrictions set forth in the applicable software license agreement and as provided in DFARS 227.7202-1(a) and 227.7702-3(a) (1995), DFARS 252.227-7013(c)(1)(ii) (OCT 1988), FAR 12.212(a) (1995), FAR 52.227-19, or FAR 52.227-14 (ALT III), as applicable. The information in this document is subject to change without notice. If you find any problems in the documentation, please report them to us in writing. Informatica Corporation does not warrant that this documentation is error free. Informatica, PowerCenter, PowerCenterRT, PowerCenter Connect, PowerCenter Data Analyzer, PowerMart, SuperGlue, Metadata Manager, Informatica Data Quality and Informatica Data Explorer are trademarks or registered trademarks of Informatica Corporation in the United States and in jurisdictions throughout the world. All other company and product names may be trade names or trademarks of their respective owners. Portions of this software and/or documentation are subject to copyright held by third parties, including without limitation: Copyright DataDirect Technologies, 1999-2002. All rights reserved. Copyright Sun Microsystems. All Rights Reserved. Copyright RSA Security Inc. All Rights Reserved. Copyright Ordinal Technology Corp. All Rights Reserved. Informatica PowerCenter products contain ACE (TM) software copyrighted by Douglas C. Schmidt and his research group at Washington University and University of California, Irvine, Copyright (c) 1993-2002, all rights reserved. Portions of this software contain copyrighted material from The JBoss Group, LLC. Your right to use such materials is set forth in the GNU Lesser General Public License Agreement, which may be found at http://www.opensource.org/licenses/lgpl-license.php. The JBoss materials are provided free of charge by Informatica, as-is, without warranty of any kind, either express or implied, including but not limited to the implied warranties of merchantability and fitness for a particular purpose. Portions of this software contain copyrighted material from Meta Integration Technology, Inc. Meta Integration is a registered trademark of Meta Integration Technology, Inc. This product includes software developed by the Apache Software Foundation (http://www.apache.org/). The Apache Software is Copyright (c) 1999-2005 The Apache Software Foundation. All rights reserved. This product includes software developed by the OpenSSL Project for use in the OpenSSL Toolkit and redistribution of this software is subject to terms available at http://www.openssl.org. Copyright 1998-2003 The OpenSSL Project. All Rights Reserved. The zlib library included with this software is Copyright (c) 1995-2003 Jean-loup Gailly and Mark Adler. The Curl license provided with this Software is Copyright 1996-2004, Daniel Stenberg, <Daniel@haxx.se>. All Rights Reserved. The PCRE library included with this software is Copyright (c) 1997-2001 University of Cambridge Regular expression support is provided by the PCRE library package, which is open source software, written by Philip Hazel. The source for this library may be found at ftp://ftp.csx.cam.ac.uk/pub/software/programming/ pcre. InstallAnywhere is Copyright 2005 Zero G Software, Inc. All Rights Reserved. Portions of the Software are Copyright (c) 1998-2005 The OpenLDAP Foundation. All rights reserved. Redistribution and use in source and binary forms, with or without modification, are permitted only as authorized by the OpenLDAP Public License, available at http://www.openldap.org/software/release/license.html. This Software is protected by U.S. Patent Numbers 6,208,990; 6,044,374; 6,014,670; 6,032,158; 5,794,246; 6,339,775 and other U.S. Patents Pending. DISCLAIMER: Informatica Corporation provides this documentation as is without warranty of any kind, either expressed or implied, including, but not limited to, the implied warranties of non-infringement, merchantability, or use for a particular purpose. The information provided in this documentation may include technical inaccuracies or typographical errors. Informatica could make improvements and/or changes in the products described in this documentation at any time without notice.
Table of Contents
List of Figures . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xvii List of Tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xix Preface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xxiii
About This Book . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xxiv Document Conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xxiv Other Informatica Resources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xxv Visiting Informatica Customer Portal . . . . . . . . . . . . . . . . . . . . . . . . . xxv Visiting the Informatica Web Site . . . . . . . . . . . . . . . . . . . . . . . . . . . xxv Visiting the Informatica Knowledge Base . . . . . . . . . . . . . . . . . . . . . . xxv Obtaining Customer Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xxv
Single or Multiple Machine Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . 17 Single Machine Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17 Multiple Machine Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17 Installing PowerCenter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19 PowerCenter Complete Installation Steps . . . . . . . . . . . . . . . . . . . . . . . 19 PowerCenter Services Custom Installation Steps . . . . . . . . . . . . . . . . . . 20 Data Analyzer Custom Installation Steps . . . . . . . . . . . . . . . . . . . . . . . . 21 Metadata Manager Custom Installation Steps . . . . . . . . . . . . . . . . . . . . 22 Upgrading PowerCenter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23 Compatible PowerCenter Versions . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23 Memory and CPU Resource Usage . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24 PowerCenter Version 6.x / 7.x Upgrade Steps . . . . . . . . . . . . . . . . . . . . 24 PowerCenter Version 8.0 Upgrade Steps . . . . . . . . . . . . . . . . . . . . . . . . 25 PowerCenter Version 8.1 Upgrade Steps . . . . . . . . . . . . . . . . . . . . . . . . 27 Upgrading Data Analyzer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29 Upgrading Metadata Manager . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31 Metadata Manager Upgrade Steps . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31
iv
Table of Contents
Repository on Oracle . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52 PowerCenter Repository on IBM DB2 . . . . . . . . . . . . . . . . . . . . . . . . . 53 PowerCenter Repository on Sybase ASE . . . . . . . . . . . . . . . . . . . . . . . . 53 Data Profiling Warehouse . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53 Data Analyzer Repository on Sybase ASE . . . . . . . . . . . . . . . . . . . . . . . 54 Data Analyzer Repository on Microsoft SQL Server . . . . . . . . . . . . . . . 54 Data Analyzer and Metadata Manager Repository on Sybase ASE . . . . . . 54 Metadata Manager Repository and Source Repository on IBM DB2 . . . . 55 Step 2. Create Database User Accounts . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56 Rules and Guidelines . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56 Step 3. Install Database Client Software . . . . . . . . . . . . . . . . . . . . . . . . . . . 57 Step 4. Create a System User Account . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58 Windows User Account . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58 UNIX User Account . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58 Step 5. Configure Environment Variables . . . . . . . . . . . . . . . . . . . . . . . . . . 59 Configuring Environment Variables on UNIX . . . . . . . . . . . . . . . . . . . 59 Database Client Environment Variables . . . . . . . . . . . . . . . . . . . . . . . . 60 Library Path Environment Variables . . . . . . . . . . . . . . . . . . . . . . . . . . . 60 Locale Environment Variables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61 Java Component Variables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62 libstdc++.so.5 Library . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62 X Window Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63 PowerCenter Services Environment Variables . . . . . . . . . . . . . . . . . . . . 63 Testing the Database Connection on UNIX . . . . . . . . . . . . . . . . . . . . . 65 Step 6. Establish Port Numbers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66 Step 7. Verify License Keys . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67 Step 8. Configure Web Browser . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68 Step 9. Install Languages (Optional) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69 Step 10. Install the Application Server (Optional) . . . . . . . . . . . . . . . . . . . . 70 JBoss Application Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70 BEA WebLogic Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71 IBM WebSphere Application Server . . . . . . . . . . . . . . . . . . . . . . . . . . . 71 Step 11. Install X Virtual Frame Buffer (Optional) . . . . . . . . . . . . . . . . . . . 73 HP-UX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73 AIX and Linux . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73 Solaris . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73 Step 12. Prepare for Installation from a Hard Disk (Optional) . . . . . . . . . . . 74
Table of Contents
vi
Table of Contents
Step 3. Back Up Existing Parameter Files . . . . . . . . . . . . . . . . . . . . . . . 96 Step 4. Note Information for the Business Objects XConnect . . . . . . . . 97
Part II: PowerCenter Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99 Chapter 6: PowerCenter Complete Installation in Graphical Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101
Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 102 Installing PowerCenter Standard Edition . . . . . . . . . . . . . . . . . . . . . . . . . 103 Installing PowerCenter Advanced Edition . . . . . . . . . . . . . . . . . . . . . . . . . 128
Table of Contents
vii
Installation Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 266 Running the Complete Client Installation . . . . . . . . . . . . . . . . . . . . . . . . . 267 Running the Custom Client Installation . . . . . . . . . . . . . . . . . . . . . . . . . . 271 Running a Silent Client Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 277 Step 1. Create the Properties File . . . . . . . . . . . . . . . . . . . . . . . . . . . . 277 Step 2. Run the Installer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 278
Ear Repackager Utility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 311 License Update Utility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 312 Repository Backup Utility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 313 Update System Accounts Utility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 313
Table of Contents
Running the Uninstaller on Windows . . . . . . . . . . . . . . . . . . . . . . . . . 389 Complete Uninstallation in Graphical Mode . . . . . . . . . . . . . . . . . . . . . . . 390 Partial Uninstallation in Graphical Mode . . . . . . . . . . . . . . . . . . . . . . . . . 392 Uninstallation in Console Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 396
Part III: Upgrading PowerCenter . . . . . . . . . . . . . . . . . . . . . . . . . . . . 399 Chapter 18: Upgrading PowerCenter . . . . . . . . . . . . . . . . . . . . . . . . 401
Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 402 PowerCenter Upgrade Steps . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 402 PowerCenter Repository Upgrade . . . . . . . . . . . . . . . . . . . . . . . . . . . . 403 Using the Upgrade Wizard . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 404 Validate Configuration Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 406 Troubleshooting Configuration File Validation . . . . . . . . . . . . . . . . . . 407 Upgrade a Global Repository . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 409 Troubleshooting Creating and Enabling a Repository Service . . . . . . . . 411 Troubleshooting a Repository Upgrade . . . . . . . . . . . . . . . . . . . . . . . . 411 Upgrade a Local Repository . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 413 Upgrade the PowerCenter Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 416 Troubleshooting Creating and Enabling an Integration Service . . . . . . 418 View Upgrade Results . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 419 Upgrade Domain and Node Metadata . . . . . . . . . . . . . . . . . . . . . . . . . . . . 420 Running Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 420 Step 1. Upgrade Gateway Node Metadata . . . . . . . . . . . . . . . . . . . . . . 421 Step 2. Upgrade Domain Metadata . . . . . . . . . . . . . . . . . . . . . . . . . . . 421 Step 3. Upgrade Worker Node Metadata . . . . . . . . . . . . . . . . . . . . . . . 422 Upgrade the PowerCenter Repository . . . . . . . . . . . . . . . . . . . . . . . . . . . . 424 Upgrade the PowerCenter Client . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 426 Upgrade Data Profiling . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 427 Running Data Profiling Upgrade Scripts . . . . . . . . . . . . . . . . . . . . . . . 427 Step 1. Prepare the Data Profiling Warehouse . . . . . . . . . . . . . . . . . . . 428 Step 2. Upgrade the Data Profiling Warehouse . . . . . . . . . . . . . . . . . . 428 Step 3. Upgrade Schema and Views for Data Analyzer Data Profiling Reports (Optional) . . . . . . . . . . . . . . . . . . . . . . . . . . . 429 Step 4. Recreate the ODBC Connection to the Data Profiling Warehouse (Optional) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 430
Table of Contents
xi
Step 2. Update the Cached Reports . . . . . . . . . . . . . . . . . . . . . . . . . . 465 Step 3. Update the Location of Shared Documents . . . . . . . . . . . . . . . 465 Step 4. Refresh the PowerCenter Table Definitions . . . . . . . . . . . . . . . 465 Step 5. Update Applications that Use the Data Analyzer SDK . . . . . . . 466 Metadata Manager Post-Upgrade Tasks . . . . . . . . . . . . . . . . . . . . . . . . . . . 467 Step 1. Refresh Metadata Manager Views . . . . . . . . . . . . . . . . . . . . . . 467 Step 2. Delete Obsolete Metadata Manager Objects . . . . . . . . . . . . . . . 468 Step 3. Import Metamodels for an IBM DB2 Repository . . . . . . . . . . . 469 Step 4. Update Metadata . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 469
Part IV: Configuring Connectivity . . . . . . . . . . . . . . . . . . . . . . . . . . . 471 Chapter 22: Understanding Connectivity . . . . . . . . . . . . . . . . . . . . . 473
Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 474 Connectivity Types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 475 Domain Connectivity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 477 Native Connectivity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 478 Establishing Native Connectivity . . . . . . . . . . . . . . . . . . . . . . . . . . . . 478 ODBC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 479 Establishing ODBC Connectivity . . . . . . . . . . . . . . . . . . . . . . . . . . . 479 PowerCenter Client Connectivity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 481 Connecting to the Repository . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 481 Connecting to Databases . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 481 Connecting to the Integration Service . . . . . . . . . . . . . . . . . . . . . . . . 481 Repository Service Connectivity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 483 Connecting from the PowerCenter Client . . . . . . . . . . . . . . . . . . . . . . 483 Connecting to Databases . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 483 Integration Service Connectivity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 484 Connecting from the PowerCenter Client . . . . . . . . . . . . . . . . . . . . . . 484 Connecting to the Repository Service . . . . . . . . . . . . . . . . . . . . . . . . . 484 Connecting to Databases . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 484 Data Analyzer and Metadata Manager Connectivity . . . . . . . . . . . . . . . . . . 486
Table of Contents
xiii
Configuring ODBC Connectivity . . . . . . . . . . . . . . . . . . . . . . . . . . . . 490 Connecting to an Informix Database . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 491 Configuring Native Connectivity . . . . . . . . . . . . . . . . . . . . . . . . . . . . 491 Configuring ODBC Connectivity . . . . . . . . . . . . . . . . . . . . . . . . . . . . 492 Connecting to Microsoft Access and Microsoft Excel . . . . . . . . . . . . . . . . . 493 Configuring ODBC Connectivity . . . . . . . . . . . . . . . . . . . . . . . . . . . . 493 Connecting to a Microsoft SQL Server Database . . . . . . . . . . . . . . . . . . . . 494 Configuring Native Connectivity . . . . . . . . . . . . . . . . . . . . . . . . . . . . 494 Configuring ODBC Connectivity . . . . . . . . . . . . . . . . . . . . . . . . . . . . 495 Connecting to an Oracle Database . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 496 Configuring Native Connectivity . . . . . . . . . . . . . . . . . . . . . . . . . . . . 496 Configuring ODBC Connectivity . . . . . . . . . . . . . . . . . . . . . . . . . . . . 498 Connecting to a Sybase ASE Database . . . . . . . . . . . . . . . . . . . . . . . . . . . . 499 Configuring Native Connectivity . . . . . . . . . . . . . . . . . . . . . . . . . . . . 499 Configuring ODBC Connectivity . . . . . . . . . . . . . . . . . . . . . . . . . . . . 500 Connecting to a Teradata Database . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 501 Configuring ODBC Connectivity . . . . . . . . . . . . . . . . . . . . . . . . . . . . 501
xiv
Table of Contents
Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 563
Table of Contents
xv
xvi
Table of Contents
List of Figures
Figure Figure Figure Figure Figure Figure Figure 18-1. 18-2. 18-3. 18-4. 22-1. 22-2. 23-1. Upgrade Wizard - Upgrade Global Repository Page . Upgrade Wizard - Upgrade Local Repository Page . . Upgrade Wizard - Upgrade PowerCenter Server Page Upgrade Wizard - Upgrade Summary Page . . . . . . . . PowerCenter Connectivity . . . . . . . . . . . . . . . . . . . . PowerCenter Repository Connectivity . . . . . . . . . . . ODBC Microsoft SQL Server Setup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 409 413 416 419 474 477 495
List of Figures
xvii
xviii
List of Figures
List of Tables
Table Table Table Table Table Table Table Table Table Table Table Table Table Table Table Table Table Table Table Table Table Table Table Table Table Table Table Table Table Table Table Table Table Table Table Table Table Table Table Table 1-1. 1-2. 1-3. 1-4. 1-5. 2-1. 3-1. 3-2. 3-3. 3-4. 3-5. 3-6. 3-7. 4-1. 4-2. 4-3. 4-4. 4-5. 4-6. 5-1. 5-2. 6-1. 6-2. 6-3. 6-4. 6-5. 6-6. 6-7. 7-1. 7-2. 7-3. 7-4. 7-5. 7-6. 8-1. 8-2. 8-3. 8-4. 8-5. 8-6. Installed PowerCenter Components . . . . . . . . . . . . . . . . . . . . . . . . . . PowerCenter Services Installation Directories . . . . . . . . . . . . . . . . . . . Installed Data Analyzer Components . . . . . . . . . . . . . . . . . . . . . . . . . . Installed Metadata Manager Components . . . . . . . . . . . . . . . . . . . . . . Installed Client Components . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . PowerCenter Compatible Upgrades . . . . . . . . . . . . . . . . . . . . . . . . . . . PowerCenter Component Installation Prerequisites . . . . . . . . . . . . . . . Minimum System Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Database Requirements for PowerCenter Components . . . . . . . . . . . . . JBoss Application Server Prerequisites . . . . . . . . . . . . . . . . . . . . . . . . . IBM WebSphere Application Server Prerequisites . . . . . . . . . . . . . . . . BEA WebLogic Server Prerequisites . . . . . . . . . . . . . . . . . . . . . . . . . . Third-Party Software . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . PowerCenter Environment Variables . . . . . . . . . . . . . . . . . . . . . . . . . . UNIX Database Environment Variables . . . . . . . . . . . . . . . . . . . . . . . UNIX Library Path Environment Variable. . . . . . . . . . . . . . . . . . . . . . AIX and HP-UX Library Path Environment Variables . . . . . . . . . . . . . Port Numbers for PowerCenter Services . . . . . . . . . . . . . . . . . . . . . . . Directories and Files Required for Installation . . . . . . . . . . . . . . . . . . . pmserverexportreg Arguments . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Data Analyzer Configuration Files . . . . . . . . . . . . . . . . . . . . . . . . . . . PowerCenter Repository Information . . . . . . . . . . . . . . . . . . . . . . . . . WebSphere Application Server Security and Repository Authentication . Data Analyzer Repository Information . . . . . . . . . . . . . . . . . . . . . . . . PowerCenter Repository Information . . . . . . . . . . . . . . . . . . . . . . . . . WebSphere Application Server Security and Repository Authentication . Data Analyzer Repository Information . . . . . . . . . . . . . . . . . . . . . . . . Metadata Manager Repository Information . . . . . . . . . . . . . . . . . . . . . PowerCenter Repository Information . . . . . . . . . . . . . . . . . . . . . . . . . WebSphere Application Server Security and Repository Authentication . Data Analyzer Repository Information . . . . . . . . . . . . . . . . . . . . . . . . PowerCenter Repository Information . . . . . . . . . . . . . . . . . . . . . . . . . WebSphere Application Server Security and Repository Authentication . Metadata Manager Repository Information . . . . . . . . . . . . . . . . . . . . . JBoss Application Server Default Port Values . . . . . . . . . . . . . . . . . . . . PowerCenter Repository Information . . . . . . . . . . . . . . . . . . . . . . . . . WebSphere Application Server Security and Repository Authentication . Data Analyzer Repository Information . . . . . . . . . . . . . . . . . . . . . . . . JBoss Application Server Default Port Values . . . . . . . . . . . . . . . . . . . . PowerCenter Repository Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. 7 .. 8 .. 9 . 11 . 12 . 23 . 34 . 35 . 38 . 41 . 41 . 42 . 43 . 59 . 60 . 60 . 62 . 66 . 74 . 90 . 94 122 125 126 146 149 150 151 168 188 189 205 208 209 215 220 222 223 226 231
List of Tables
xix
Table Table Table Table Table Table Table Table Table Table Table Table Table Table Table Table Table Table Table Table Table Table Table Table Table Table Table Table Table Table Table Table Table Table Table Table Table Table Table Table Table Table Table
8-7. WebSphere Application Server Security and Repository Authentication. 8-8. Data Analyzer Repository Information . . . . . . . . . . . . . . . . . . . . . . . . 8-9. Metadata Manager Repository Information . . . . . . . . . . . . . . . . . . . . . 9-1. PowerCenter Repository Information . . . . . . . . . . . . . . . . . . . . . . . . . 9-2. JBoss Application Server Default Port Values . . . . . . . . . . . . . . . . . . . 9-3. WebSphere Application Server Security and Repository Authentication. 9-4. Data Analyzer Repository Information . . . . . . . . . . . . . . . . . . . . . . . . 9-5. JBoss Application Server Default Port Values . . . . . . . . . . . . . . . . . . . 9-6. PowerCenter Repository Information . . . . . . . . . . . . . . . . . . . . . . . . . 9-7. WebSphere Application Server Security and Repository Authentication. 9-8. Metadata Manager Repository Information . . . . . . . . . . . . . . . . . . . . . 10-1. Silent Installation Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-1. PowerCenter Command Line Programs and Utilities . . . . . . . . . . . . . 13-2. Data Analyzer Utilities . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-3. EAR Repackager Utility Variables . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-4. Import Export Utility Variable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-5. License Update Utility Variables . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-6. Repository Backup Utility Variable . . . . . . . . . . . . . . . . . . . . . . . . . . 13-7. Repository Upgrade Utility Variables . . . . . . . . . . . . . . . . . . . . . . . . 13-8. Update System Accounts Variables . . . . . . . . . . . . . . . . . . . . . . . . . . 13-9. Metadata Manager Utilities . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-10. EAR Repackager Utility Variables . . . . . . . . . . . . . . . . . . . . . . . . . . 13-11. License Update Utility Variables . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-12. Repository Backup Utility Variables . . . . . . . . . . . . . . . . . . . . . . . . 13-13. Update System Accounts Variables . . . . . . . . . . . . . . . . . . . . . . . . . 15-1. Scripts for Creating a Data Profiling Warehouse . . . . . . . . . . . . . . . . 15-2. Scripts for Creating the Data Profiling Warehouse Views . . . . . . . . . . 15-3. PowerCenter Repository Reports Cached Report Schedules . . . . . . . . 15-4. Data Connector Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16-1. Debug Log File Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16-2. Summary Log File Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16-3. Installation Log Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16-4. WebSphere Application Server Log Files . . . . . . . . . . . . . . . . . . . . . . 17-1. PowerCenter Uninstallation Directories . . . . . . . . . . . . . . . . . . . . . . 17-2. Uninstallation Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-1. PowerCenter Upgrade Steps . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-2. PowerCenter 7.x to PowerCenter 8.1.1 Repository Size Increase . . . . . 18-3. Required Configuration File Parameters . . . . . . . . . . . . . . . . . . . . . . 18-4. Upgrade Global Repository Options . . . . . . . . . . . . . . . . . . . . . . . . . 18-5. Upgrade Local Repository Options . . . . . . . . . . . . . . . . . . . . . . . . . . 18-6. Integration Service Upgrade Options . . . . . . . . . . . . . . . . . . . . . . . . 18-7. upgradeGatewayNode Options and Arguments . . . . . . . . . . . . . . . . . 18-8. upgradeDomain Options and Arguments . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
.. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. ..
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
.. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. ..
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
.233 .234 .235 .244 .250 .253 .254 .257 .260 .262 .263 .278 .301 .302 .303 .303 .304 .309 .309 .310 .311 .312 .312 .313 .314 .331 .332 .345 .353 .362 .363 .364 .375 .388 .396 .402 .403 .408 .410 .414 .417 .421 .422
xx
List of Tables
Table Table Table Table Table Table Table Table Table Table Table Table Table Table Table
18-9. upgradeWorkerNode Option and Argument . . . . . . . . . . . . . . . . . . . . . . . . 18-10. Procedure for Upgrading a Data Profiling Warehouse to PowerCenter 8.1.1 18-11. Scripts for Upgrading the Data Profiling Warehouse to PowerCenter 8.1.1 . 18-12. Scripts for Upgrading the Data Profiling Warehouse Schema and Views . . . 22-1. Drivers Used by PowerCenter Components . . . . . . . . . . . . . . . . . . . . . . . . . 22-2. Native Connect String Syntax . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22-3. Recommended Database ODBC Drivers . . . . . . . . . . . . . . . . . . . . . . . . . . . 22-4. PowerCenter Client Connectivity Requirements . . . . . . . . . . . . . . . . . . . . . 22-5. Repository Service Connectivity Requirements . . . . . . . . . . . . . . . . . . . . . . . 22-6. Integration Service Connectivity Requirements . . . . . . . . . . . . . . . . . . . . . . D-1. PowerCenter Client ODBC Function Calls . . . . . . . . . . . . . . . . . . . . . . . . . D-2. Integration Service ODBC Function Calls . . . . . . . . . . . . . . . . . . . . . . . . . . E-1. JDBC Drivers Installed for Supported Databases . . . . . . . . . . . . . . . . . . . . . . E-2. JDBC Connection String Elements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . F-1. Valid Values for the LANG Environment Variable for Linux Machines . . . . . .
.. .. .. .. .. .. .. .. .. .. .. .. .. .. ..
. . . . . . . . . . . . . . .
423 427 428 429 475 478 480 481 483 484 550 552 554 555 558
List of Tables
xxi
xxii
List of Tables
Preface
Welcome to PowerCenter Standard and Advanced Edition. With these PowerCenter editions, Informatica extends the definition of the base enterprise data integration platform to include additional, key capabilities such as metadata analysis (Metadata Manager), data-ready reporting (Data Analyzer), server grid, and team-based development to enable comprehensive end to end data integration solutions. The PowerCenter repository coordinates and drives a variety of core functions, including extracting, transforming, loading, and managing data. The Integration Service can extract large volumes of data from multiple platforms, handle complex transformations on the data, and support high-speed loads. PowerCenter can simplify and accelerate the process of building a comprehensive data warehouse from disparate data sources. Data Analyzer makes accessing, analyzing, and sharing enterprise data simple and easily available to decision makers. Data Analyzer enables you to gain insight into your business processes and develop business intelligence. Metadata Manager is an enterprise information asset management and analysis solution. It enables you to analyze and manage metadata from any system. It also enables you to gain insight into your metadata for impact and content analysis and allows you to view data and information flow across systems.
xxiii
Document Conventions
This guide uses the following formatting conventions:
If you see It means The word or set of words are especially emphasized. Emphasized subjects. This is the variable name for a value you enter as part of an operating system command. This is generic text that should be replaced with user-supplied values. The following paragraph provides additional facts. The following paragraph provides suggested uses. The following paragraph notes situations where you can overwrite or corrupt data, unless you follow the specified procedure. This is a code example. This is an operating system command you enter from a prompt to run a task.
xxiv
Preface
Informatica Customer Portal Informatica web site Informatica Knowledge Base Informatica Global Customer Support
support@informatica.com for technical inquiries support_admin@informatica.com for general customer service requests
Preface
xxv
WebSupport requires a user name and password. You can request a user name and password at http://my.informatica.com.
North America / South America Informatica Corporation Headquarters 100 Cardinal Way Redwood City, California 94063 United States Europe / Middle East / Africa Informatica Software Ltd. 6 Waltham Park Waltham Road, White Waltham Maidenhead, Berkshire SL6 3TN United Kingdom Asia / Australia Informatica Business Solutions Pvt. Ltd. Diamond District Tower B, 3rd Floor 150 Airport Road Bangalore 560 008 India Toll Free Australia: 1 800 151 830 Singapore: 001 800 4632 4357 Standard Rate India: +91 80 4112 5738
Standard Rate Belgium: +32 15 281 702 France: +33 1 41 38 92 26 Germany: +49 1805 702 702 Netherlands: +31 306 022 797 United Kingdom: +44 1628 511 445
xxvi
Preface
Part I: Introduction
PowerCenter Installation Components, 3 Installation and Upgrade Overview, 15 PowerCenter Prerequisites, 33 Before You Install, 49 Before You Upgrade, 77
Chapter 1
Overview, 4 Installation Package, 5 PowerCenter Services, 7 Data Analyzer, 9 Metadata Manager, 10 PowerCenter Client, 12 PowerCenter Reports, 13
Overview
PowerCenter Standard Edition includes PowerCenter and Data Analyzer for PowerCenter Repository Reports. PowerCenter Advanced Edition includes Standard Edition plus Metadata Manager. The installation process configures the products and establishes connections between services, servers, clients, and repositories. You can install the complete set of PowerCenter components or select a custom installation to install each component separately. The PowerCenter components you can install depend on your license. You can install PowerCenter in graphical mode or console mode. If you perform a complete installation, you install all components on one machine. If you perform a custom installation, you select the component you want to install. You install each component on the same machine or on different machines. Depending on your license, you can install the following components:
PowerCenter Services. Includes the Service Manager and application services that run in a domain. The PowerCenter installer installs and configures PowerCenter Services. You can create a new domain or join an existing domain. The installer can create the PowerCenter repository or connect to an existing PowerCenter repository. For more information, see PowerCenter Services on page 7. Data Analyzer. Includes Data Analyzer and JBoss Application Server. The installer installs Data Analyzer on JBoss Application Server, BEA WebLogic Server, or IBM WebSphere Application Server. The installer can create the Data Analyzer repository or connect to an existing repository. For more information, see Data Analyzer on page 9. Metadata Manager. Includes Metadata Manager and JBoss Application Server. The installer installs Metadata Manager on JBoss Application Server, BEA WebLogic Server, or IBM WebSphere Application Server. The installer can create the Metadata Manager repository or connect to an existing repository. The installer creates the PowerCenter repository for Metadata Manager. For more information, see Metadata Manager on page 10. PowerCenter Client. Includes client tools for PowerCenter and Metadata Manager. For more information, see PowerCenter Client on page 12. PowerCenter Reports. Includes administrative and metadata reports. For more information, see PowerCenter Reports on page 13.
You install the PowerCenter components from the PowerCenter installation DVD. The installation package also includes the PowerCenter Documentation DVD, the PowerCenter Utilities DVD, and the PowerCenter License Key CD. For more information about the installation package, see Installation Package on page 5. Depending on the version of PowerCenter, you may also apply a service pack to a PowerCenter installation. For more information about PowerCenter service packs, see PowerCenter Service Pack on page 6.
Installation Package
The PowerCenter installation package contains the following DVDs, CDs, and service packs:
PowerCenter Standard/Advanced Edition 32 bit/64 bit DVD. Contains the PowerCenter installation files for components on all platforms, PowerCenter utilities, and customer support tools. For more information, see PowerCenter Standard/Advanced Edition 32 bit/64 bit DVD on page 5. PowerCenter Documentation DVD. Contains the PowerCenter manuals, release notes, and online help. For more information about the PowerCenter Documentation DVD, see PowerCenter Documentation DVD on page 6. PowerCenter License Key CD. Contains the license keys for PowerCenter, Data Analyzer, and Metadata Manager. For more information, see PowerCenter License Key CD on page 6. PowerCenter Service Pack. Contains updates to the latest version of PowerCenter. For more information, see PowerCenter Service Pack on page 6.
You can use Informatica Electronic Software Distribution (ESD) to get the PowerCenter installer. Informatica provides the PowerCenter installer in ZIP and TAR format for you to download using FTP. After you download the ZIP or TAR file, you unpack or unzip the installer. You can then run the installation from the download files on a hard disk or create a DVD to run the installer on multiple machines. Informatica provides more information about downloading the installer in an email message when you purchase PowerCenter. The information includes the user name, password, and detailed instructions on downloading the installer. If you do not have the download instructions, contact Informatica Global Customer Support.
Note: If you apply a PowerCenter service pack, the installation package contains the service
pack installer only. The installer is available only through ESD. For more information, see PowerCenter Service Pack on page 6.
line programs and utilities on a machine without installing PowerCenter. The DVD contains all the files required by the programs and utilities. You do not need a license key to install or run the programs and utilities.
All PowerCenter books in PDF format Online help for the PowerCenter Client and the Administration Console Release notes for PowerCenter, Data Analyzer, and Metadata Manager Metadata Manager IME files for custom XConnects
Informatica FTP site, you receive the required license keys by email.
PowerCenter Services
PowerCenter Services consists of a Service Manager and application services that run in a domain. A domain is a collection of nodes and services that you can group in folders based on administration ownership. You create a domain when you first install PowerCenter Services. You can run the installation on other machines to add the machines to the domain as nodes. You use the PowerCenter Administration Console to manage the domain after you install PowerCenter Services. When you run the installer, you install Informatica Services. Informatica Services runs as a service on Windows and as a daemon on UNIX. When you start Informatica Services, Informatica Services starts the Service Manager, which manages all domain operations. For more information about PowerCenter domains, nodes, services, and the Administration Console, see Understanding Domains in the PowerCenter Administrator Guide. For more information about using the installer to create a domain or add a node to a domain, see Single or Multiple Machine Installation on page 17. Table 1-1 describes the PowerCenter Services components included in a PowerCenter Services installation:
Table 1-1. Installed PowerCenter Components
Component Informatica Services Description Starts the Service Manager on a node. Installs as a service on Windows and as a daemon on UNIX. Manages domain operations on a node. Includes authentication, authorization, configuration, domain, licensing, and log functions. Manages connections to the PowerCenter repository. Installation Summary - Installed in /server/bin directory under the PowerCenter installation directory. - Service or daemon started during installation. - Installed in /server/tomcat directory under the PowerCenter installation directory. - Started during installation. - Installed in /server/bin directory under the PowerCenter installation directory. - Service started during installation. - Connection established to the PowerCenter repository. - Repository tables created.
Service Manager
Repository Service
PowerCenter repository
Stores metadata for PowerCenter source and target data, workflows, sessions, and mappings. Extracts, transforms, and loads data to PowerCenter targets. If Metadata Manager is installed, extracts and loads metadata based on XConnect workflows.
Integration Service
- Installed in /server/bin directory under the PowerCenter installation directory. - Service started during installation. - Connection established to the Repository Service.
PowerCenter Services
Directory Structure
PowerCenter Services are installed in the server directory under the PowerCenter installation directory. The server directory contains PowerCenter applications, configuration files, and storage directories for PowerCenter Services. Table 1-2 describes the directories created under the server directory during a PowerCenter Services installation:
Table 1-2. PowerCenter Services Installation Directories
Directory Name bin config infa_shared Contents Contains PowerCenter application service executables and command line programs. Contains the node configuration file. Default storage location for run-time files used by Integration Service processes and domain log events files generated by the Log Manager. You can configure the shared directory location for the Integration Service processes and the Log Manager in the Administration Console after installation. Contains the Service Manager application files and the Service Manager log files.
tomcat
Data Analyzer
You can install Data Analyzer with PowerCenter Standard or Advanced Edition. Data Analyzer requires an application server. You can run Data Analyzer on one of the following application servers:
JBoss Application Server BEA WebLogic Server IBM WebSphere Application Server
If you run Data Analyzer on JBoss Application Server, you can install JBoss Application Server with Data Analyzer or use an existing instance of JBoss Application Server. Informatica includes JBoss Application Server version 4.0.3 in the PowerCenter installer. If you run Data Analyzer on BEA WebLogic Server or IBM WebSphere Application Server, you must obtain and install the application server before you install PowerCenter Standard Edition. For more information about application server prerequisites for Data Analyzer, see Application Servers on page 40. Table 1-3 describes the Data Analyzer components installed with a PowerCenter installation:
Table 1-3. Installed Data Analyzer Components
Component Data Analyzer Description Web application to analyze data from data sources and create reports. Installation Summary - Installed on selected application server. - Data Analyzer utilities installed in the Data Analyzer directory under the PowerCenter installation directory. - Connection established to Data Analyzer repository. - Repository tables created. - Installed in the JBoss403 directory under the PowerCenter installation directory. - Application server started. - Connection established between Data Analyzer and the Data Analyzer repository.
Stores metadata for Data Analyzer schemas, reports, and dashboards. Java application server that manages processes for Data Analyzer. JDBC drivers for use with Data Analyzer.
Data Analyzer
Metadata Manager
Metadata Manager uses an application server to manage processes. You can run Metadata Manager on one of the following application servers:
JBoss Application Server BEA WebLogic Server IBM WebSphere Application Server
If you run Metadata Manager on JBoss Application Server, you can install JBoss Application Server with Metadata Manager or use an existing instance of JBoss Application Server. Informatica includes JBoss Application Server version 4.0.3 in the PowerCenter installer. If you run Metadata Manager on BEA WebLogic Server or IBM WebSphere Application Server, you must obtain and install the application server before you install PowerCenter Standard Edition. The installer does not install BEA WebLogic Server or IBM WebSphere Application Server. For more information about application server prerequisites for Metadata Manager, see Application Servers on page 40. Metadata Manager XConnects are a set of PowerCenter workflows that Metadata Manager uses to extract metadata from sources and load into the Metadata Manager repository. The workflows are stored in the PowerCenter repository. You use the Metadata Manager Configuration Console to run the XConnects to load metadata to the Metadata Manager repository. Metadata Manager XConnects are installed when you install Metadata Manager. When you install Metadata Manager, the PowerCenter installer can create a PowerCenter repository or connect to an existing PowerCenter repository to store the XConnect workflows. It creates a Metadata Manager folder in the PowerCenter repository to store the XConnect workflows that you run from the Metadata Manager Configuration Console. If you perform a complete installation of PowerCenter Advanced Edition, the installer uses the PowerCenter repository as the PowerCenter repository for Metadata Manager. You must create a separate database and user account for another PowerCenter repository and create a Repository Service when you configure the application services.
Note: The PowerCenter repository that stores the Metadata Manager XConnects is called the
10
Table 1-4 describes the Metadata Manager components installed with a PowerCenter installation:
Table 1-4. Installed Metadata Manager Components
Component Metadata Manager Server Description Web application for analyzing and reporting on metadata from PowerCenter and other applications. Installation Summary - Installed on top of selected application server. - Installed in the Metadata Manager directory under the PowerCenter installation directory. - Connections established to the Metadata Manager repository. - Connections established to the PowerCenter repository. - Repository tables created. - Metadata Manager warehouse tables created. - Metamodels installed. - Metadata Manager XConnect metadata created in the Metadata Manager folder. - Installed in the JBoss403 directory under the PowerCenter installation directory if new JBoss Application Server instance is the selected application server. - Application server started. - PowerCenter workflows created in the Metadata Manager folder of specified PowerCenter repository. - Establishes a connection between Metadata Manager and the Metadata Manager repository.
Stores the Metadata Manager schema, reports, dashboards, source metadata to analyze and report on, and the packaged metamodels that classify source metadata. Stores Metadata Manager XConnect metadata. Also known as the Integration repository. Java application server that manages processes for Metadata Manager.
PowerCenter workflows to extract and load metadata. JDBC drivers for use with Metadata Manager.
Metadata Manager
11
PowerCenter Client
With the PowerCenter Client installation, you can install the complete set of PowerCenter client tools or select the custom installation to install the PowerCenter Client and Metadata Manager Client separately. You can install the PowerCenter and Metadata Manager clients on a Windows platform. You can use graphical or silent installation to install the PowerCenter Client components. The PowerCenter Client includes the following tools:
Designer Repository Manager Workflow Manager Workflow Monitor Data Stencil Metadata Manager Console Custom Metadata Configurator
ODBC drivers for use with the PowerCenter Client and Metadata Manager Console.
12
PowerCenter Reports
PowerCenter provides administrative and metadata reports that you can import into a Data Analyzer or Metadata Manager instance. The PowerCenter Reports include the following reports:
Administrative reports PowerCenter Repository Reports Data Analyzer Data Profiling Reports
Administrative Reports
Administrative reports are a set of prepackaged administrative reports that enable system administrators to track user activities and monitor processes. The reports provide a view into the information stored in a Data Analyzer or Metadata Manager repository. They include details on application usage and report schedules and errors. For a list of all reports included in the Data Analyzer administrative reports, see Working with the Data Analyzer Administrative Reports in the Data Analyzer Administrator Guide.
Source and target metadata, including shortcuts, descriptions, and corresponding database names and field-level attributes Transformation metadata in mappings and mapplets, including port-level details for each transformation Mapping and mapplet metadata, including the targets, transformations, and dependencies for each mapping Workflow and worklet metadata, including schedules, instances, events, and variables Session metadata Change management metadata, including versions of sources, targets, labels, and label properties You must enable versioning in PowerCenter for versions to be tracked and analyzed. User and group metadata Operational metadata, including runtime statistics
For a list of all reports included in the PowerCenter Repository Reports, see the PowerCenter Repository Reports Reference.
PowerCenter Reports
13
Composite reports. Display the Data Analyzer Data Profiling metadata reports and summary reports. From the composite reports, you can drill down into profile metadata and summary reporting on specific functions. Metadata reports. Display basic metadata about a data profile and the source-level and column-level functions in a data profile. They also provide historic statistics on previous runs of the same data profile. Summary reports. Display data profile results for specific source-level and column-level functions in a data profile.
14
Chapter 2
Overview, 16 Single or Multiple Machine Installation, 17 Installing PowerCenter, 19 Upgrading PowerCenter, 23 Upgrading Data Analyzer, 29 Upgrading Metadata Manager, 31
15
Overview
This section outlines the steps to install a complete or custom version of PowerCenter Standard and Advanced Edition or to upgrade a previous version of PowerCenter. You can install PowerCenter on a single machine or multiple machines. The installation and upgrade steps depend on whether you install PowerCenter for the first time or upgrade a previous version:
Install PowerCenter. You can install a complete or custom version of PowerCenter Standard or Advanced Edition. For more information about installing PowerCenter, see Installing PowerCenter on page 19. Upgrade PowerCenter. You can upgrade a previous version of PowerCenter. The upgrade steps depend on the version of PowerCenter you want to upgrade. For more information, see Upgrading PowerCenter on page 23. Upgrade Data Analyzer. You can upgrade a previous version of PowerAnalyzer or Data Analyzer. For more information, see Upgrading Data Analyzer on page 29. Upgrade Metadata Manager. You can upgrade a previous version of SuperGlue or Metadata Manager. For more information, see Upgrading Metadata Manager on page 31.
These steps refer to additional chapters where you can obtain more information.
Note: You can install PowerCenter on the same machine as an existing version of PowerCenter
if you do not upgrade the existing version. You do not need to uninstall your current version of PowerCenter to install PowerCenter 8.1.1. You must install PowerCenter 8.1.1 in a different directory from the previous version. If you install on the same machine as an existing PowerCenter 8.x installation, you must first stop Informatica Services.
16
Create domain. The installer installs PowerCenter Services on the machine and creates a domain and node on the machine. Join domain. The installer installs PowerCenter Services and adds the machine as a worker node or gateway node to an existing domain. You must create a domain before you can join a domain.
You can create or join a domain based on your installation requirements. You can install PowerCenter Services in the following environments:
Single machine installation. The domain consists of a single machine or node. All application services, such as the Integration Service and Repository Service, run on a single machine. Multiple machine installation. The domain consists multiple machines or nodes. One node serves as the gateway and routes requests from the other nodes in the domain. The other nodes can be gateway nodes or worker nodes. You can have multiple nodes in the domain.
For more information about the PowerCenter Services architecture, see the Administrator Guide.
17
You can configure the nodes in the domain to run application services. The node where you create the domain serves as the master gateway for the domain and handles requests from services running on the other nodes in the domain. Use the following steps as a guideline to install PowerCenter Services on multiple machines: 1. 2. Complete the pre-installation tasks on each machine. Run the PowerCenter installer on the machine and choose to create a domain. Enter the domain and node information. If you choose to create a Repository Service and an Integration Service, the installer prompts you for the PowerCenter repository information. The installer installs PowerCenter Services, creates the domain and node on the machine, starts Informatica Services, creates application services, and establishes connectivity to the PowerCenter repository. This machine becomes the gateway for the domain. 3. Run the PowerCenter Services installer on another machine and choose to join a domain. Enter the information for the domain, including domain name and port number, that you created in step 2. The installer installs PowerCenter Services, creates a node on the machine, adds the node to the domain, and starts Informatica Services on the node. 4. Use the Administration Console to configure the nodes and the application services for the domain. For example, you can run the Integration Service and Repository Service on separate nodes.
18
Installing PowerCenter
The installation steps depend on the type of installation you want to perform:
Complete PowerCenter Standard or Advanced Edition installation. Installs all PowerCenter Standard or Advanced Edition components. For more information, see PowerCenter Complete Installation Steps on page 19. PowerCenter Services custom installation. Install PowerCenter Services. For more information, see PowerCenter Services Custom Installation Steps on page 20. Data Analyzer custom installation. Install Data Analyzer and PowerCenter Repository Reports. For more information, see Data Analyzer Custom Installation Steps on page 21. Metadata Manager custom installation. Install Metadata Manager. For more information, see Metadata Manager Custom Installation Steps on page 22.
The PowerCenter installer installs the PowerCenter components, collects the configuration information, and then configures the PowerCenter components. You must complete a step successfully before you can continue to the next step. If you are unable to configure PowerCenter components during installation, you may be able to configure them after installation.
2.
3.
4.
Install the PowerCenter Client and Metadata Manager Client. Install the PowerCenter Client on Windows. If you are installing PowerCenter Advanced Edition, you also install the Metadata Manager Client. For more information about installing the PowerCenter Client, see PowerCenter Client Installation on page 265. Install PowerCenter Reports. Install PowerCenter Reports on Data Analyzer. For more information, see PowerCenter Reports Installation on page 281. Install PowerCenter documentation. Install PowerCenter documentation on Windows. For more information, see Documentation Installation on page 291. Configure PowerCenter. Includes configuring Informatica Services and application services, configuring the PowerCenter Integration Utility, creating a Data Profiling warehouse, and setting up PowerCenter Repository Reports. If you installed PowerCenter Advanced Edition, you must also create the PowerCenter repository for use with the PowerCenter Client tools. For more information, see After You Install on page 323. Configure the PowerCenter Client machines. Configure the PowerCenter Client machines to connect to each source and target database you need to access and create an ODBC connection for each database you access. For more information, see Connecting to Databases from Windows on page 487. Set up the Metadata Manager Console. If you install PowerCenter Advanced Edition, verify the PowerCenter repository, Integration Service, and Repository Service connections in the Metadata Manager Console. Also, configure the PowerCenter source directory in the Metadata Manager Console. For more information, see Setting Up the Metadata Manager Console in the Metadata Manager Administrator Guide.
5. 6. 7.
8.
9.
2.
3.
20
5. 6.
Install PowerCenter documentation. Install PowerCenter documentation on Windows. For more information, see Documentation Installation on page 291. Configure PowerCenter. Configure Informatica Services and use the Administration Console to configure application services. You can also configure Data Profiling. For more information, see After You Install on page 323. Configure the PowerCenter Client machines. Configure the PowerCenter Client machines to connect to each database you need to access and create an ODBC connection for each database you access. For more information, see Connecting to Databases from Windows on page 487.
7.
2.
3.
5. 6.
7.
Installing PowerCenter
21
2.
3.
5. 6.
22
Upgrading PowerCenter
You can upgrade PowerCenter from the following previous versions:
PowerCenter 6.x or 7.x. When you upgrade PowerCenter 6.x or 7.x, you install PowerCenter Services, upgrade existing Repository Agents or PowerCenter Servers, upgrade the PowerCenter repository content, and install the PowerCenter Client. For more information about upgrading PowerCenter version 6.x or 7.x, see PowerCenter Version 6.x / 7.x Upgrade Steps on page 24. PowerCenter 8.0. When you upgrade PowerCenter 8.0, you install PowerCenter 8.1.1 on the nodes in the current domain. You then upgrade the PowerCenter 8.0 domain and node metadata and PowerCenter repository, and install the PowerCenter Client. For more information about upgrading PowerCenter 8.0, see PowerCenter Version 8.0 Upgrade Steps on page 25. PowerCenter 8.1. When you upgrade PowerCenter 8.1, you install PowerCenter 8.1.1. The installer upgrades the domain configuration and node configuration for PowerCenter 8.1. You also install the PowerCenter Client. For more information about upgrading PowerCenter 8.1, see PowerCenter Version 8.1 Upgrade Steps on page 27.
Upgrading PowerCenter
23
* Indicates BTree upgrades in PowerCenter. To retain your existing incremental aggregation files, you must upgrade using the indicated BTree path, and run a session to realign the files. For example, to upgrade from PowerCenter 5.1.x to PowerCenter 8.1, first upgrade to PowerCenter 7.1 and then to PowerCenter 8.1. For more information about upgrading incremental aggregation files, see the PostUpgrade Reference.
Updates to Integration Service and Repository Service processes. The pmserver and pmdtm process for the Integration Service and the pmrepagent process for the Repository Service include updated functionality that may increase memory and CPU resource usage. High availability. If you configure a domain for high availability, service restart, failover, and recovery operations, memory and CPU resource usage may increase. Java Runtime Environment (JRE). The PowerCenter service-oriented architecture uses the Java Runtime Environment (JRE) to run the PowerCenter domains and nodes. Domains and nodes require more memory and CPU resources than when you run a PowerCenter Server or Repository Server in PowerCenter 6.x/7.x. Log Manager. If the Log Manager collects and processes a large number of log events, it may require additional memory and CPU resources to collect and process the log events.
Depending on your configuration, PowerCenter 8.0 may consume up to 5 percent more CPU resources for each domain than PowerCenter 6.x/7.x. PowerCenter 8.0 may also consume more memory.
2.
24
3.
Install PowerCenter Services. Install PowerCenter Services and create a domain and gateway node. You do not need to create a Repository Service and Integration Service if you install PowerCenter Services without Metadata Manager. The Repository Service and Integration Service for PowerCenter will be created when you upgrade PowerCenter. You can also join a domain to add other machines as nodes to an existing domain. Join a domain if you want the upgraded Repository Services or Integration Services to run on nodes other than the gateway node for the domain. For more information about installing PowerCenter Services, see PowerCenter Custom Installation in Graphical Mode on page 153 or PowerCenter Custom Installation in Console Mode on page 237.
4.
Upgrade PowerCenter. Use the Upgrade Wizard to upgrade a Repository Agent and PowerCenter Server configuration to a Repository Service and Integration Service in a PowerCenter domain. You can also upgrade existing PowerCenter repository content to the new repository version. You also upgrade the PowerCenter Client and the Data profiling warehouse. For more information, see Upgrading PowerCenter on page 401. Complete the post-upgrade tasks. Post-upgrade tasks include updating $PMRootDir and moving the Integration Service runtime files. You can also update the shared directory for the service logs. If you installed PowerCenter Services with Metadata Manager, you must recreate the Repository Service for the PowerCenter repository for Metadata Manager. For more information about the post-upgrade tasks, see PowerCenter 6.x / 7.x Post-Upgrade Tasks on page 457. Configure PowerCenter. Configure Informatica Services and the Repository Service and Integration Service. For more information about configuring PowerCenter, see After You Install on page 323. Install PowerCenter documentation. You can install the documentation on Windows. For more information, see Documentation Installation on page 291. Complete additional post-upgrade tasks. After you complete the PowerCenter upgrade, you may need to perform additional tasks to complete the upgrade. For more information about behavior changes between different versions, changes to repository objects impacted by the upgrade process, and tasks you may need to perform to maintain previous behavior or take advantage of new behavior, see the PowerCenter Post-Upgrade Reference.
5.
6.
7. 8.
2.
Upgrading PowerCenter
25
information about the pre-upgrade steps, see PowerCenter Version 8.0 Pre-Upgrade Steps on page 82. 3. Install PowerCenter Services. Install PowerCenter Services on all the nodes in the PowerCenter 8.0 domain. You install PowerCenter Services and create a temporary domain on the node that currently hosts the domain. If you have a domain with multiple nodes, install PowerCenter Services and add the other nodes in the domain to the temporary domain. You must follow specific steps to install PowerCenter Services when you upgrade PowerCenter 8.0. For more information, see Installation Steps for Upgrading PowerCenter 8.0 on page 27. For more information about installing PowerCenter Services, see PowerCenter Custom Installation in Graphical Mode on page 153 or PowerCenter Custom Installation in Console Mode on page 237. 4. Upgrade PowerCenter. Use infaupgrade to upgrade the existing metadata in the domainmeta.xml and nodemeta.xml files to the appropriate location in the PowerCenter domain. Use the PowerCenter Administration Console to upgrade the contents of the PowerCenter repository. You also upgrade the PowerCenter Client and the Data Profiling warehouse. For more information, see Upgrading PowerCenter on page 401. Complete the post-upgrade tasks. The post-upgrade tasks include registering local repositories and updating the password environment variable. If you want to use a UTF8 repository, back up the existing repository, create a UTF-8 database, and restore the repository to the new database. You can move the PowerCenter run-time files to the new installation directory. You can also create and configure a Web Services Hub and update the client applications. For more information about the post-upgrade tasks, see PowerCenter 8.0 Post-Upgrade Tasks on page 460. Configure PowerCenter. Configure Informatica Services and the Repository Service and Integration Service. For more information about configuring PowerCenter, see After You Install on page 323. Install PowerCenter documentation. Install the PowerCenter documentation on Windows. For more information, see Documentation Installation on page 291. Complete additional post-upgrade tasks. After you complete the PowerCenter upgrade, you may need to perform additional tasks to complete the upgrade. For more information about behavior changes between different versions, changes to repository objects impacted by the upgrade process, and tasks you may need to perform to maintain previous behavior or take advantage of new behavior, see the PowerCenter Post-Upgrade Reference.
5.
6.
7. 8.
26
2.
3.
For more information about the upgrade process, see Upgrading PowerCenter on page 401.
2.
3.
6. 7.
Upgrading PowerCenter
27
to perform to maintain previous behavior or take advantage of new behavior, see the PowerCenter Post-Upgrade Reference.
Renames the previous server directory. The installer renames the previous server directory to server_810_PC, and installs PowerCenter Services into a new server directory. Copies configuration files. The installer copies nodemeta.xml, adminconsole.url, server.xml, and domains.infa from the previous server folder into the new server folder. Copies log event files. The installer copies the log event files from the previous server\infa_shared\logs directory into the new server directory.
28
To upgrade from Data Analyzer 8.1, install Data Analyzer 8.1.1 and choose the existing Data Analyzer repository. You do not need to perform an upgrade of the Data Analyzer repository. Install the new version of Data Analyzer without uninstalling the current working instance of Data Analyzer. When you install the new version of Data Analyzer, select the option to use an existing repository. You upgrade the copy of the existing repository to the new version. To upgrade Data Analyzer 8.0 or earlier to the latest version, complete the following steps: 1. Verify prerequisites. Verify prerequisites for Data Analyzer, including minimum system requirements and supported repository databases. For more information, see PowerCenter Prerequisites on page 33. Complete the pre-upgrade tasks. Pre-upgrade tasks include backing up the Data Analyzer repository, copying the customized files to a temporary directory, and preparing the Data Analyzer repository. For more information, see Data Analyzer Pre-Upgrade Steps on page 93. Install Data Analyzer. Use PowerCenter installer to install Data Analyzer. You can use the complete or custom installation to install Data Analyzer. For more information about installing Data Analyzer, see PowerCenter Custom Installation in Graphical Mode on page 153 or PowerCenter Custom Installation in Console Mode on page 237. 4. Upgrade the Data Analyzer repository. If you upgrade from Data Analyzer version 8.0 or earlier, use the Repository Upgrade utility provided with Data Analyzer 8.1.1 to upgrade the copy of the existing Data Analyzer repository. Run the Repository Upgrade utility and provide the connection information for the restored repository database. For more information about running the upgrade utility, see Upgrading Data Analyzer on page 431. For information about the changes made to the Data Analyzer repository during the upgrade process, see Data Analyzer in the PowerCenter Post-Upgrade Reference. 5. Complete the post-upgrade tasks. After you upgrade the Data Analyzer repository, you need to restore any customization you previously made. For more information about the post-upgrade tasks, see Data Analyzer Post-Upgrade Tasks on page 464.
2.
3.
29
After you complete the upgrade steps, verify that all schemas, dashboards, and reports are working correctly in Data Analyzer 8.1.1. If the upgrade is successful, you can uninstall the previous version of Data Analyzer.
30
2.
3.
5.
6. 7.
31
objects. For more information about the post-upgrade tasks, see Metadata Manager Post-Upgrade Tasks on page 467. After you complete the upgrade steps, verify that all dashboards and reports are working correctly in Metadata Manager. When you are sure that the new version is working properly, you can delete the old instance of Metadata Manager and switch to the new version.
32
Chapter 3
PowerCenter Prerequisites
This chapter includes the following topics:
Overview, 34 Minimum System Requirements, 35 Web Browsers, 37 Database Requirements, 38 Application Servers, 40 Third-Party Software, 43 Code Pages, 45 Working with 32-bit and 64-bit Platforms, 46
33
Overview
Before you install PowerCenter, verify that the environment meets the minimum requirements. You can verify the prerequisites for the PowerCenter components you install. Table 3-1 describes the installation prerequisites for the PowerCenter components:
Table 3-1. PowerCenter Component Installation Prerequisites
Prerequisite Minimum System Requirements PowerCenter Component PowerCenter Services PowerCenter Client Data Analyzer Metadata Manager PowerCenter Services Data Analyzer Metadata Manager PowerCenter Services Data Profiling Data Analyzer Metadata Manager Data Analyzer Metadata Manager Description and Reference Hardware and operating system requirements. For more information, see Minimum System Requirements on page 35. Web browser required to access the PowerCenter Administration Console, Data Analyzer and Metadata Manager, and the Web Services Hub Console. For more information, see Web Browsers on page 37. Repository database, domain configuration database, and Data Profiling warehouse requirements, including database type and minimum size. For more information, see Database Requirements on page 38. Required information and setup for installing Data Analyzer and Metadata Manager on JBoss Application Server, IBM WebSphere Application Server, and BEA WebLogic Server. For more information, see Application Servers on page 40. X Virtual Frame Buffer for PowerCenter Services on UNIX. Microsoft Visio 2003 for Data Stencil. Microsoft SOAP Toolkit and SVG Viewer for Data Analyzer and Metadata Manager. For more information, see Third-Party Software on page 43. Code page requirements for all PowerCenter components. For more information, see Code Pages on page 45.
Web Browser
Database Requirements
Application Server
Third-party Software
PowerCenter Services PowerCenter Client Data Analyzer Metadata Manager PowerCenter Services PowerCenter Client Data Analyzer Metadata Manager PowerCenter Services
Code Pages
32-bit and 64-bit compatibility between the PowerCenter components. For more information, see Working with 32-bit and 64-bit Platforms on page 46.
34
Verify the minimum hardware and operating system requirements before you install PowerCenter components. Table 3-2 describes the minimum system requirements to run PowerCenter components:
Table 3-2. Minimum System Requirements
Product PowerCenter Advanced Edition complete installation Processor 4 CPUs RAM 4 GB Disk Space 2.3 GB Operating System Windows 2000 / 2003 Sun Solaris HP-UX IBM AIX Red Hat Linux SUSE Linux Windows 2000 / 2003 Sun Solaris HP-UX IBM AIX Red Hat Linux SUSE Linux Windows 2000 / 2003 Sun Solaris HP-UX IBM AIX Red Hat Linux SUSE Linux Windows 2000 / 2003 Sun Solaris HP-UX IBM AIX Red Hat Linux SUSE Linux Windows 2000 / 2003 Sun Solaris HP-UX IBM AIX Red Hat Linux SUSE Linux
1 CPU
1 GB
1.3 GB
PowerCenter Services
1 CPU
1 GB
500 MB
Data Analyzer
2 CPUs
1 GB
800 MB
Metadata Manager
2 CPUs
1 GB
1.0 GB
35
Note: The server installation for PowerCenter requires 1 GB of disk space for temporary files.
On UNIX, the installer writes the temporary files to the /tmp directory. On Windows, it writes the files to the default drive. You can set the TMP or the InstallAnywhere IATEMPDIR environment variable to specify the location of these files.
36
Web Browsers
PowerCenter Components: PowerCenter Services Data Analyzer Metadata Manager
You can use the following browsers to access Data Analyzer, the PowerCenter Administration Console, and the Web Services Hub Console:
For more information about configuring browsers to use with the Administration Console, Data Analyzer, and Metadata Manager, see Step 8. Configure Web Browser on page 68.
Note: The PowerCenter Client requires Internet Explorer to display the Start Page for the
Web Browsers
37
Database Requirements
PowerCenter Components: PowerCenter Services Data Profiling Data Analyzer Metadata Manager
PowerCenter repository PowerCenter domain configuration database Data Profiling warehouse Data Analyzer repository Metadata Manager repository
1 MB
16 MB
60 MB
550 MB
Use the following rules and guidelines when you verify database size requirements:
You can create a PowerCenter repository with a minimum of 30 MB of database space. Allow up to 150 MB to store metadata.
38
Assess how much the PowerCenter, Data Analyzer, and Metadata Manager repositories are likely to grow and plan accordingly. You can create a Data Profiling warehouse with a minimum database space of 16 MB. You may need to allocate more space depending on the amount of data you intend to profile, whether you run profile sessions in verbose or normal mode, whether you use sampling or full tables, and how often you purge the Data Profiling warehouse. If you run profile sessions in verbose mode, the Data Profiling warehouse may store all of the data depending on the functions you use in the data profile. If you run a profile session in normal mode, the Data Profiling warehouse stores less data.
Database Requirements
39
Application Servers
PowerCenter Components: Data Analyzer Metadata Manager
If you install Data Analyzer and Metadata Manager on an existing application server instance, verify the application server installation prerequisites for the following application servers:
JBoss Application Server. You can install Data Analyzer and Metadata Manager on an existing JBoss Application Server instance. You can also install a new JBoss Application Server instance with the PowerCenter installer. For more information, see JBoss Application Server Prerequisites on page 41. IBM WebSphere Application Server. You can install Data Analyzer and Metadata Manager on an existing instance of WebSphere Application Server. For more information, see IBM WebSphere Application Server Prerequisites on page 41. BEA WebLogic Server. You can install Data Analyzer and Metadata Manager on an existing instance of WebLogic Server. For more information, see BEA WebLogic Server Prerequisites on page 42.
If you want to use a new WebSphere Application Server or WebLogic Server instance, you must install the application server before you install Data Analyzer and Metadata Manager. If you want to install Data Analyzer and Metadata Manager on a new JBoss Application Server instance, install JBoss Application Server with the PowerCenter installer. For more information about installing application servers, see Step 10. Install the Application Server (Optional) on page 70. You must stop the application server before you install Data Analyzer and Metadata Manager. For more information about stopping the application server, see Starting and Stopping Application Servers on page 535.
Note: You cannot install multiple instances of Data Analyzer or Metadata Manager on the
same application server. If you want to run multiple instances of Data Analyzer or Metadata Manager, you must install each instance on a different application server. You can run a single instance of Data Analyzer and Metadata Manager on the same application server.
40
Server Name
User Groups WebSphere Application Server Started Administrator User Name and Password
Application Servers
41
User Account
42
Third-Party Software
PowerCenter Components: PowerCenter Installer PowerCenter Services PowerCenter Client Data Analyzer Metadata Manager
PowerCenter requires third-party software to use certain features. You must download and install the third-party software to use the features. Table 3-7 describes the features and third-party software you may need to install:
Table 3-7. Third-Party Software
Third-Party Software Java Runtime Environment (JRE) PowerCenter Component PowerCenter Installer on Windows PowerCenter Client (Data Stencil) PowerCenter Client (Data Stencil) Description To run the PowerCenter installer on Windows, you must have the Java Runtime Environment (JRE), version 1.4.2 or higher, installed on the machine where you install PowerCenter Services and the PowerCenter installer. In PowerCenter, you can use Data Stencil to create PowerCenter mapping templates using Microsoft Office Visio. You must obtain and install Visio 2003 before you can use Data Stencil. Data Stencil on Windows 2000 requires Microsoft .NET Framework 1.1. Service Pack 1. You cannot use other versions of Microsoft .NET Framework. You can download Microsoft .NET Framework 1.1 from the following web site:
http://msdn.microsoft.com/netframework/downloads/ framework1_1/
You can download Microsoft .NET Framework 1.1 Service Pack 1 from the following web site:
http://www.microsoft.com/downloads/ details.aspx?familyid=A8F5654F-088E-40B2-BBDB-A833 53618B38&displaylang=en
You must also install the Security Update for Microsoft .NET Framework, Version 1.1 Service Pack 1 (KB886903). You can download the security update from the following web site:
http://www.microsoft.com/downloads/ details.aspx?familyid=8EC6FB8A-29EB-49CF-9DBC-1A0D C2273FF9&displaylang=en
In Data Analyzer and Metadata Manager, you can export a report to an Excel file and refresh the data in Excel directly from the cached data in Data Analyzer or Metadata Manager or from the data source. To use the data refresh feature, you must install the Microsoft SOAP Toolkit. For information about downloading the Microsoft SOAP Toolkit, see Working with Microsoft Excel in the Data Analyzer User Guide.
Third-Party Software
43
44
Code Pages
PowerCenter Components: PowerCenter Services PowerCenter Client Data Analyzer Metadata Manager
PowerCenter Client. You can generate metadata in any language in the PowerCenter Client. PowerCenter Client includes the Designer, Workflow Manager, Repository Manager, and Workflow Monitor. Integration Service. The Integration Service can move data in ASCII mode and Unicode mode. You set the code page when you configure each Integration Service process. PowerCenter repository. The PowerCenter repository can store data in any language. You can use the UTF-8 code page for the repository to store multibyte data in the repository. The code page for the repository is the same as the database code page. You set a code page for the machine where Repository Service process runs. Sources and targets. The sources and targets store data in one or more languages. Use code pages to specify the type of characters in the sources and targets. PowerCenter command line programs. You must also ensure that the code page for pmrep is compatible with the repository code page and the code page for pmcmd is compatible with the Integration Service process code page.
Verify that the code pages you select for PowerCenter components are compatible. For more information about code pages, see Understanding Globalization in the PowerCenter Administrator Guide.
Code Pages
45
You can run PowerCenter Services on 32-bit or 64-bit platforms. A 64-bit architecture provides a larger memory space that can significantly reduce or eliminate disk input/output. This can improve session performance in the following areas:
Caching. With a 64-bit platform, the Integration Service is not limited to the 2 GB cache limit of a 32-bit platform. Data throughput. With a larger available memory space, the reader, writer, and Data Transformation Manager (DTM) threads can process larger blocks of data.
You can run the PowerCenter 64-bit application on AIX, HP-UX, Red Hat Linux, SUSE Linux, Solaris, and Windows.
Note: The PowerCenter 64-bit platform addresses up to 18 million terabytes (2^64 bytes) of
system memory and has up to 256 terabytes (2^48 bytes) available for a single application. The 32-bit platform addresses up to 4 GB (2^32 bytes) of system memory and has up to 2 GB available for any single application.
Link 32-bit applications with 32-bit libraries. Link 64-bit applications with 64-bit libraries. Link 32-bit machines running an Integration Service with a 32-bit database client. Link a 64-bit machine running an Integration Service with 64-bit database client.
Database clients. Link 32-bit machines running a Repository Service with 32-bit database clients. Link 64-bit machines running a Repository Service with 64-bit database clients. Integration Services and Repository Services. 32-bit and 64-bit machines that run Integration Services and Repository Services are compatible with each other. Caching. If the total configured session cache size is 2 GB or greater (2,147,483,648 bytes), you must run the session using an Integration Service running on a 64-bit machine. The session fails if you run it using an Integration Service running on a 32-bit machine. Server grids. A server grid can contain both 32-bit and 64-bit machines that run the Integration Service. If the total configured session cache size is 2 GB (2,147,483,648 bytes) or greater, you must configure the session to run on an Integration Service on a 64-bit machine.
46
Install current 64-bit database clients. Update the system library path to include only the 64-bit application and database client libraries. Recompile procedures for Custom and External Procedure transformations using the 64-bit makefiles generated by the Designer. Increase cache sizes for Rank, Sorter, Aggregator, Joiner, and Lookup transformations that may benefit from the increased addressable memory. Increase DTM buffer size and buffer block size for sessions that may benefit from the increased memory.
Note: You do not need to update the PowerCenter Client or upgrade the repository if you
47
48
Chapter 4
Pre-Installation Tasks, 50 Step 1. Create Databases, 52 Step 2. Create Database User Accounts, 56 Step 3. Install Database Client Software, 57 Step 4. Create a System User Account, 58 Step 5. Configure Environment Variables, 59 Step 6. Establish Port Numbers, 66 Step 7. Verify License Keys, 67 Step 8. Configure Web Browser, 68 Step 9. Install Languages (Optional), 69 Step 10. Install the Application Server (Optional), 70 Step 11. Install X Virtual Frame Buffer (Optional), 73 Step 12. Prepare for Installation from a Hard Disk (Optional), 74
49
Pre-Installation Tasks
Informatica provides Quick Start guides on the PowerCenter Documentation DVD. You can use the Quick Start guides to track the required installation information as you complete the pre-installation steps. The Quick Start guides contain the required information for databases, user accounts, system accounts, environment variables, and application servers. You will need this information when you install PowerCenter. You can get the Quick Start guides from the following location on the PowerCenter Documentation DVD:
<DVD_Root>\Disk1\InstData\Documentation\PDFs\
For more information about installing PowerCenter documentation, see Documentation Installation on page 291. Before you install PowerCenter, complete the following tasks: 1. Create the databases. Create the databases for PowerCenter, Data Analyzer, and Metadata Manager repositories, the PowerCenter domain configuration database, and the Data Profiling warehouse. For more information, see Step 1. Create Databases on page 52. Create database user accounts. Create user accounts for the repository, domain configuration, and Data Profiling warehouse databases. You need this user account information when you install PowerCenter. For more information, see Step 2. Create Database User Accounts on page 56. Install database client software. Install database client software on the machines where you install PowerCenter. For more information, see Step 3. Install Database Client Software on page 57. Create a system user account for installation. Create a user account to run the installation. For more information, see Step 4. Create a System User Account on page 58. Configure environment variables. Configure environment variables for PowerCenter Services, PowerCenter Client, and database connectivity on UNIX. For more information, see Step 5. Configure Environment Variables on page 59. Establish port numbers. Establish the port numbers used by PowerCenter Services on the nodes in a domain. For more information, see Step 6. Establish Port Numbers on page 66. Verify license keys. Verify that you have the license keys required for installation. For more information, see Step 7. Verify License Keys on page 67. Configure the web browser. Configure the web browser you will use to access the PowerCenter Administration Console, Data Analyzer, and Metadata Manager. For more information, see Step 8. Configure Web Browser on page 68.
2.
3.
4.
5.
6.
7. 8.
50
9.
Install languages (Optional). You may need to install additional languages on machines that run the PowerCenter Client. For more information, see Step 9. Install Languages (Optional) on page 69.
10. Install the application servers (Optional). The PowerCenter installer installs JBoss Application Server during installation. Alternatively, you can install JBoss Application Server, BEA WebLogic Server, or IBM WebSphere Application Server. For more information, see Step 10. Install the Application Server (Optional) on page 70. 11. Install X Virtual Frame Buffer (Optional). On UNIX, the PowerCenter Administration Console requires a graphics display server to display graphics for user activity and license reporting features. You can install X Virtual Buffer on gateway nodes that do not have a graphics display server. For more information, see Step 11. Install X Virtual Frame Buffer (Optional) on page 73. 12. Configure the installer (Optional). You can install PowerCenter from a hard disk. For more information, see Step 12. Prepare for Installation from a Hard Disk (Optional) on page 74.
Pre-Installation Tasks
51
PowerCenter domain configuration PowerCenter repository Data Profiling warehouse Data Analyzer repository Metadata Manager repository
For more information about the required databases, database types, and database sizes, see Database Requirements on page 38. For more information about setting up the database user accounts, see Step 2. Create Database User Accounts on page 56.
The PowerCenter installer uses JDBC to communicate with the domain configuration database. You do not need to configure database connectivity for the database. If you use a domain configuration database from a previous PowerCenter installation, you must drop the existing domain configuration database tables from the database before you install or use a different user account than the previous installation. For more information, see Uninstallation Rules and Guidelines on page 386. On IBM DB2, make sure the primary tablespace for the domain configuration database has a default page size of 16K. You can store the domain configuration database and the PowerCenter repository in one database if you use the same database user name. Store the domain configuration database for different domains in separate user accounts.
For more information about the domain configuration database, see Managing the Domain in the PowerCenter Administrator Guide.
Repository on Oracle
To prevent a PowerCenter, Data Analyzer, or Metadata Manager repository from using excessive amounts of disk space, set the Oracle storage parameters for the tablespace. When you set up an Oracle database, verify that the storage parameters specified for the tablespace are not too large. Storage parameters that are set to very large values cause the
52 Chapter 4: Before You Install
repository to use an excessive amount of space. Also verify that the default tablespace for the user that owns the repository tables is set correctly. The following example shows how to set the recommended storage parameters, assuming that the repository is stored in the REPOSITORY tablespace:
ALTER TABLESPACE "REPOSITORY" DEFAULT STORAGE ( INITIAL 10K NEXT 10K MAXEXTENTS UNLIMITED PCTINCREASE 50 );
node tablespace.
53
Or open the Microsoft SQL Server Enterprise Manager, right-click the database, and select Properties > Options. Set the Compatibility Level to 80 and click OK.
54
Before you install PowerCenter, ask the DB2 administrator to create system temporary tablespaces with 4 KB, 8 KB, 16 KB, and 32 KB page sizes. The Metadata Manager repository and all Metadata Manager source repositories on IBM DB2 require minimum heap sizes. Ask the DB2 database administrator to run the following SQL statements on each database to configure the system temporary tablespaces and update the heap sizes:
CREATE Bufferpool RBF IMMEDIATE ; CREATE Bufferpool STBF IMMEDIATE STORAGE ; SIZE 1000 PAGESIZE 32 K EXTENDED STORAGE EXTENDED
CREATE REGULAR TABLESPACE REGTS32 PAGESIZE 32 K MANAGED BY SYSTEM USING ('C:\DB2\NODE0000\reg32' ) EXTENTSIZE 16 OVERHEAD 10.5 PREFETCHSIZE 16 TRANSFERRATE 0.33 BUFFERPOOL RBF; CREATE SYSTEM TEMPORARY TABLESPACE TEMP32 PAGESIZE 32 K MANAGED BY SYSTEM USING ('C:\DB2\NODE0000\temp32' ) EXTENTSIZE 16 OVERHEAD 10.5 PREFETCHSIZE 16 TRANSFERRATE 0.33 BUFFERPOOL STBF; GRANT USE OF TABLESPACE REGTS32 TO USER <USERNAME>; UPDATE DB CFG FOR <DB NAME> USING APP_CTL_HEAP_SZ 16384 UPDATE DB CFG FOR <DB NAME> USING APPLHEAPSZ 16384 UPDATE DBM CFG USING QUERY_HEAP_SZ 8000 UPDATE DB CFG FOR <DB NAME> USING LOGPRIMARY 100 UPDATE DB CFG FOR <DB NAME> USING LOGFILSIZ 2000 UPDATE DB CFG FOR <DB NAME> USING LOCKLIST 1000 UPDATE DB CFG FOR <DB NAME> USING DBHEAP 2400 "FORCE APPLICATIONS ALL" DB2STOP DB2START Step 1. Create Databases 55
Domain configuration Data Profiling warehouse PowerCenter repository Data Analyzer repository Metadata Manager repository
If you use Oracle 10.2 for a repository database, you must also grant create view privileges to the repository database user. The create view permission is granted independent of the Connect privilege in Oracle 10.2. If you use Sybase ASE for the Data Analyzer or Metadata Manager repository, you must add the role dtm_tm_role to the database user account.
56
Oracle client IBM DB2 Client Application Enabler (CAE) Microsoft SQL Client, with Microsoft OLE DB provider for Microsoft SQL Server Sybase Open Client Oracle client IBM DB2 Client Application Enabler (CAE) Informix ESQL for C, Informix Client SDK, or any other Informix client software Microsoft SQL Client, with Microsoft OLE DB provider for Microsoft SQL Server Sybase Open Client Teradata BTEQ client
Install the following database clients on machines that run Integration Service processes:
For more information about connecting to databases in PowerCenter, see Connecting to Databases from Windows on page 487 and Connecting to Databases from UNIX on page 503.
57
Logged in user account. The user account must be a member of the Administrators group and have the Log on as a service permission. You must log in with this user account before you install PowerCenter. Another user account. The user account must be a member of the Administrators group and have Log on as a service and Act as operating system permissions. You do not have to log in with this user account before you install PowerCenter.
If you install Data Analyzer or Metadata Manager on IBM WebSphere Application Server, you must create a user account named padaemon to install Data Analyzer or Metadata Manager on IBM WebSphere Application Server. You must then install Data Analyzer or Metadata Manager using the same user account. For more information about the IBM WebSphere Application Server requirements, see IBM WebSphere Application Server Prerequisites on page 41.
58
Required Optional
PowerCenter Services
Windows UNIX
Optional
The PowerCenter installer relies on the database environment variables to gain access to the databases. After you install the database client software, verify that the database environment variables are set to the right values. For more information, see Testing the Database Connection on UNIX on page 65. Verify that the existing environment variables do not contain earlier versions of PowerCenter in the PATH or library path environment variables.
59
Log in with the UNIX user account you create for the installation before you configure environment variables. For more information, see in Step 4. Create a System User Account on page 58. If you are installing Data Analyzer or Metadata Manager without PowerCenter Services, you do not need to set the UNIX environment variables.
For more information about configuring database environment variables, see Connecting to Databases from UNIX on page 503.
Sybase ASE
60
Note: Each type of UNIX operating system may require a different value for the same locale.
The command returns the languages installed on the UNIX system and the existing locale settings. Use this command to verify that the value for the locale environment variable is compatible the language settings for the machine and the type of code page you want to use for the repository.
61
Custom transformation that uses Java coding Java transformation PowerCenter Connect for JMS PowerCenter Connect for Web Services PowerCenter Connect for webMethods
To use these components on AIX32, AIX64, or HP-UX, you must configure the library path environment variables to point to the java directory installed with PowerCenter Services. You need to configure these environment variables on machines where the Integration Service process runs. You do not need to configure these variables for Linux or Solaris. Table 4-4 describes the library paths you must configure to use Java-based components:
Table 4-4. AIX and HP-UX Library Path Environment Variables
UNIX Platform AIX32 and AIX64 Environment Variable Name LIBPATH Value Set to: java/jre/bin Set to: java/jre/bin/classic Set to: /usr/lib:/lib Set to: java/jre/lib/PA_RISC2.0/server Set to: java/jre/lib/PA_RISC2.0 Set to: /usr/lib:/lib
HP-UX
SHLIB_PATH
libstdc++.so.5 Library
Before you install PowerCenter Services on Linux, you must install the GCC 3.2.x library libstdc++.so.5 and add the location of the library to the library path environment variable. Use the following command to verify that libstdc++ is installed:
$ rpm -q --whatprovides /usr/lib/libstdc++.so.5
If the command returns libstdc++-3.2-7, the library is properly installed. Otherwise, the command returns error: file /usr/lib/libstdc++.so.5: No such file or directory. If the library is not installed, you can locate and install the libstdc++.so.5 RPM at the following URL:
http://rpmfind.net
If you have problems installing PowerCenter after installing the library, contact Global Customer Support.
62
X Window Server
The graphical mode PowerCenter installer requires a graphics display server. The graphics display server enables the installer to display graphics. Without the graphics display server, the installer generates error messages. On UNIX, the graphics display server is typically an X Window server. If you do not have the X Window server installed on the machine where you want to install PowerCenter, you can install it using an X Window server installed on another machine. You can redirect the DISPLAY variable to use the X Window server on another UNIX machine. To redirect the host output, define the environment variable DISPLAY. Use the following command: C shell:
setenv DISPLAY=<TCP/IP node of XWindows server>:0
Bash/Korn shell:
export DISPLAY=<TCP/IP node of XWindows server>:0
Bourne Shell:
DISPLAY=<TCP/IP node of XWindows server>:0 export display
For example, if you have the X Window server installed on a machine with a TCP/IP node of 10.1.50.23, use the following commands: C shell:
setenv DISPLAY 10.1.50.23:0
Bash/Korn shell:
export DISPLAY=10.1.50.23:0
Bourne shell:
DISPLAY=10.1.50.23:0 export display
If you do not know the IP address of a UNIX machine where the X Window server is installed, ask your network administrator. For more information about redirecting the DISPLAY variable, see the documentation from the UNIX vendor. If the X Window server does not support the font that the PowerCenter installer uses, the installer may not display the labels on the buttons correctly. For example, the button labeled Test Connection may appear with the shortened label Test Connecti....
63
You can configure IINFA_JAVA_OPTS and INFA_DOMAINS_FILE. Configure the environment variables on UNIX or configure the environment variable as a system variable on Windows. Configure these variables if you install PowerCenter Services or the PowerCenter Client. You can also configure the INFA_HOME environment variable after you install PowerCenter Services. Configure INFA_HOME to the location of the PowerCenter Services installation directory or the directory where the installed PowerCenter Services files are located. For more information, see Configuring INFA_HOME on page 357.
INFA_JAVA_OPTS
PowerCenter uses the Java Runtime Environment (JRE) to start and run PowerCenter Services. By default, PowerCenter Services uses a maximum of 512 MB of system memory. You can configure the amount of system memory used by PowerCenter Services with INFA_JAVA_OPTS. If you set INFA_JAVA_OPTS after starting PowerCenter Services, you must restart the node for the changes to take effect. For example, to configure 1 GB of system memory for PowerCenter Services on UNIX in a C shell, use the following command:
setenv INFA_JAVA_OPTS -Xmx1024m
Note: If you are using 64-bit HP-UX on Itanium, add the -d64 switch when you set the system memory using INFA_JAVA_OPTS.
INFA_DOMAINS_FILE
The domains.infa file contains the connectivity information for the gateway nodes in a domain. The connectivity information includes the domain names, domain host names, and domain host port numbers. Configure INFA_DOMAINS_FILE as a system variable on Windows machines. You must include the file name in the path. You can configure this variable before installation or after installation. Configure the variable on the machines that will run the following PowerCenter components:
PowerCenter Services. The installer creates domains.infa in the PowerCenter installation directory when you install PowerCenter Services for use by the infacmd command line program. You must also set this variable if you run the pmcmd command line program from a directory other than the server/bin directory. PowerCenter Client. The PowerCenter Client creates or updates domains.infa when you add or modify domain connectivity information in any PowerCenter Client application. If you want to keep the domains.infa file in a location other than PowerCenter Client installation directory, you can configure INFA_DOMAINS_FILE on the machine where you install the PowerCenter Client. For example, you can use a shared location for domains.infa for all PowerCenter Client installations in a highly available environment. You can set the INFA_DOMAINS_FILE environment variable to the shared location on each machine where you install the PowerCenter Client application. Each PowerCenter Client application uses the same domain connectivity information.
64
sqlplus. Use sqlplus to test the connection between the database client and an Oracle database. db2 connect. Use db2 connect to test the connection between an IBM DB2 database client and the database. isql. Use isql to test the connection between a Sybase ASE database client and the database.
65
you join a domain, the node port number is a worker node port number. Table 4-5 describes the port numbers used by PowerCenter Services:
Table 4-5. Port Numbers for PowerCenter Services
Port Type Gateway Node Default Value 6001 Description Port number for a gateway node in a domain. The Service Manager listens for incoming connection requests on this port. All client applications communicate with the domain using this port number. The installer also sets the shutdown port number as the node port number plus one. Port number for a worker node in a domain. The Service Manager on the gateway node communicates with the worker node using this port number. The installer also sets the shutdown port number as the node port number plus one. If you promote a worker node to a gateway node, the port number becomes a gateway node port number. Range of port numbers used by client applications to communicate with Repository Service, Integration Service, and SAP BW Service processes on gateway and worker nodes. When the Service Manager starts an application service, it starts the service process on the first available port in this range. At a minimum, the range must be equal to the number of application service processes that will run on the node. PowerCenter Client applications and application services communicate with the application service processes on a node using a port number in this range. This port range is similar to the PowerCenter Server and Repository Server port numbers in PowerCenter 6.x/7.x.
Worker Node
6001
6005 - 6105
66
Installation DVD. If you receive the PowerCenter installation files on the PowerCenter Standard or Advanced Edition DVD, the license key files are included on the PowerCenter License Key CD. FTP download. If you download the PowerCenter installation files from the Informatica FTP site, the license keys are included as part of an email message. If you use an incremental license to install Metadata Manager and join a domain, verify that the incremental license is an incremental license for an existing domain license object. Otherwise, the installer cannot create the Repository Service and the installation will fail. If you have an incremental license key, you can join a domain when you install PowerCenter. If you want to create a domain, contact Global Customer Support to obtain a full license key for PowerCenter Services.
Use the following rules and guidelines when verifying the license key:
67
Scripting and ActiveX. Internet Explorer requires the Active scripting, Allow paste operations, Run ActiveX controls and plug-ins, and Script ActiveX controls marked safe for scripting controls enabled. Choose Tools > Internet Options > Security > Custom level to configure the controls. Javascript. Firefox requires Javascript enabled. Pop-up blocking utility. To display the Data Analyzer and Metadata Manager pages properly, disable any pop-up blocking utility on your browser. If a pop-up blocker is running while you are working with Data Analyzer or Metadata Manager, the Data Analyzer or Metadata Manager windows may not display properly.
68
Click Start > Settings > Control Panel. Click Regional Options. Under Language settings for the system, select the languages you want to install. Click Apply.
For more information about IME and code pages, see Globalization Overview in the PowerCenter Administrator Guide.
69
JBoss Application Server. You can install Data Analyzer and Metadata Manager on a new or existing instance of JBoss Application Server. For more information about installing JBoss Application Server, see JBoss Application Server on page 70. BEA WebLogic Server. You can install Data Analyzer and Metadata Manager on a new WebLogic domain or an existing domain. For more information about installing WebLogic Server, see BEA WebLogic Server on page 71. IBM WebSphere Application Server. You can install Data Analyzer and Metadata Manager on an existing WebSphere Application Server instance. For more information about installing WebSphere Application Server, see IBM WebSphere Application Server on page 71.
If you run Data Analyzer and Metadata Manager on BEA WebLogic Server or IBM WebSphere Application Server, you must obtain and install the application server before you install PowerCenter. You must stop the application server before you install Data Analyzer and Metadata Manager. For more information about stopping the application server, see Starting and Stopping Application Servers on page 535.
Note: The installer can configure repository authentication for JBoss Application Server, BEA
WebLogic Server, and IBM WebSphere Application Server during installation. If you do not configure authentication during installation, you must configure authentication before you install PowerCenter. Otherwise, you cannot log in to Data Analyzer or Metadata Manager until you configure authentication. For more information about configuring authentication, see Configuring Authentication in the Data Analyzer Administrator Guide and Managing Authentication for Metadata Manager in the Metadata Manager Administrator Guide.
When you install Data Analyzer and Metadata Manager on an existing JBoss Application Server instance, you provide the location of the application server and the name of the new server configuration directory during installation.
IBM WebSphere Application Server Base Edition IBM WebSphere Application Server Network Deployment Edition
The installer can install Data Analyzer and Metadata Manager on the Network Deployment edition of IBM WebSphere Application Server. Although the PowerCenter installation does not set up a WebSphere cluster for Data Analyzer and Metadata Manager, it sets up an environment that makes it easy to create a cluster later. During the PowerCenter installation, you can provide the name of the server to run Data Analyzer and Metadata Manager. If you do not provide a server name, the PowerCenter installer configures Data Analyzer and Metadata Manager to run on the default server, server1. Before you install IBM WebSphere Application Server, complete the following tasks:
Create padaemon user account. On Windows and UNIX, create the padaemon user account to install and run WebSphere Application Server. For more information, see Create padaemon User Account on page 71. Create user groups. On UNIX, create the mqm and mqbrkrs user groups. For more information, see Create User Groups on page 72.
71
The padaemon user account must be a member of the Administrators group and have the following rights:
For information about creating a user account with advanced rights, see the Microsoft Windows documentation.
2. 3.
You need to use the root account to install IBM WebSphere Application Server. For more information about setting up the required UNIX operating system groups before installing IBM WebSphere Application Server, see platform-specific installation tips on the IBM Information Center web site:
http://publib.boulder.ibm.com/infocenter/ws51help/index.jsp
Expand WebSphere Application Server, Version 5.1.x > Installing > Getting started > Installing the product. Click Platform-specific Tips for Installing and Migrating > Tips for Installing the Embedded Messaging Feature. In the Tips for all Linux and UNIX Platforms section, click Defining the Prerequisite Linux or UNIX operating System Groups, mqm and mqbrkrs.
72
HP-UX
Xvfb is part of the HP-UX operating system. Depending on when you installed or last patched the operating system, you might need to download and install HP-UX patches and graphical packages to run Xvfb. For a description of the steps you need to complete to run Xvfb on HP-UX, see the instructions on the following web site:
http://publib.boulder.ibm.com/tividd/td/ITM/GI10-5797-01/en_US/HTML/ notesmst20.htm
Solaris
You can download the Xvfb server for Solaris from the following web site:
ftp://www.ferret.noaa.gov/special_request/xvfb/solaris/
To set up the Xvfb server, follow the instructions in the README.XVFB. Or read the instructions in the following web site:
http://ferret.wrc.noaa.gov/Ferret/FAQ/graphics/Solaris_Xvfb.html
This sends any graphics output going to display 1 to shared memory. Use the following command to set the current display to use the frame buffer for graphics display in a C shell:
% setenv DISPLAY :1.0
73
PowerCenter (UNIX)
650 MB
350 MB
30 MB
70 MB
Note: You must keep the same Server, Reports, and Client directory structure as on the DVD. On UNIX, install.sh requires the Server directory and install_reports.sh requires the Reports directory. On Windows, install.exe requires the Server, Client, and Reports directory.
After you copy the required directories and files, go to the temporary directory and run the installation file for your operating system.
74
For example, to install PowerCenter from the hard disk on a Solaris machine: 1. 2. 3. Create a Server directory in a temporary directory:
<Temp_dir>/Server
Copy the <DVD_Root>/Server/Solaris/Disk1 directory from installation DVD to the temporary directory:
<Temp_dir>/Server/Solaris/Disk1
4.
5.
Run install.sh.
Note: You may experience decreased performance if you run the PowerCenter installer from a
network location. For optimal performance when installing PowerCenter from a network location, for example, over a WAN, use the console mode installer.
75
76
Chapter 5
Overview, 78 PowerCenter Version 6.x/7.x Pre-Upgrade Steps, 79 PowerCenter Version 8.0 Pre-Upgrade Steps, 82 PowerCenter 8.1 Pre-Upgrade Steps, 84 Preparing the Repository for Upgrade, 86 Backing Up and Copying Configuration Files, 89 Data Analyzer Pre-Upgrade Steps, 93 Metadata Manager Pre-Upgrade Steps, 96
77
Overview
This chapter includes information about the tasks you must complete before you begin the upgrade process. The tasks depend on the PowerCenter component and version you upgrade:
PowerCenter 6.x/7.x. Before you upgrade PowerCenter 6.x/7.x, you must establish the PowerCenter installation environment, prepare the repository for the upgrade, and back up files. For more information, see PowerCenter Version 6.x/7.x Pre-Upgrade Steps on page 79. PowerCenter 8.0. Before you upgrade PowerCenter 8.0, you must prepare the repository, note the domain configuration and stop Informatica Services, remove environment variables, and back up files. For more information, see PowerCenter Version 8.0 PreUpgrade Steps on page 82. PowerCenter 8.1. Before you upgrade PowerCenter 8.1, you must back up domain and node configuration metadata and stop Informatica Services. For more information, see PowerCenter 8.1 Pre-Upgrade Steps on page 84. Data Analyzer version 8.0 or earlier. Before you upgrade Data Analyzer, you must prepare the repository and back up customized files. For more information, see Data Analyzer Pre-Upgrade Steps on page 93. Metadata Manager version 8.1 or earlier. Before you upgrade Metadata Manager, you must prepare the repository database and back up parameter files. For more information, see Metadata Manager Pre-Upgrade Steps on page 96.
78
3.
4.
5. 6.
on the gateway nodes to connect to the repository databases during the upgrade. For example, if you upgrade an Oracle repository, verify that the Oracle database client is correctly configured on the gateway nodes in the domain. If you have a single gateway node, you only need to configure the database connectivity on that node. For more information about configuring database connectivity, see Connecting to Databases from Windows on page 487 and Connecting to Databases from UNIX on page 503.
Drop the existing warehouse tables and recreate the warehouse on the Informix database before you move your PowerCenter 7.x repository. Create the Data Profiling warehouse on a different database.
You can then upgrade the warehouse after you upgrade PowerCenter.
in the PowerCenter Administration Console after you install PowerCenter. You cannot upgrade an existing Web Services Hub. Before you install PowerCenter and create a Web Services Hub, complete the following tasks:
Back up the Web Services Hub configuration file. Back up the Web Services Hub configuration file to use the settings in the configuration file as reference when you create another Web Services Hub. The configuration file is named WSHConfig.xml and located in the WSH_HOME/config directory. Uninstall Web Services Provider. After you back up the configuration file, you can safely uninstall Web Services Provider.
81
After you complete the pre-upgrade steps, upgrade the domain and node metadata from PowerCenter 8.0 to PowerCenter 8.1. For more information, see Upgrading PowerCenter on page 401.
82
INFA_HOME. Designates the PowerCenter Services installation directory. INFA_DOMAINS_FILE. Designates the location of domains.infa on the machine where you install PowerCenter Services or the PowerCenter Client.
domainmeta.xml. Contains the metadata for the domain. By default, domainmeta.xml is stored in the server/infa_shared/config directory on the node that hosts the domain. The domainmeta.xml may be stored in a different location if you configured a shared location in the Administration Console. nodemeta.xml. Contains the metadata for a node in a domain. All nodes store nodemeta.xml in the server/config directory. If the domain contains multiple nodes and you use the same backup directory for the metadata configuration files, you must rename nodemeta.xml before copying it to the backup location. For example, if you back up nodemeta.xml for a node named node01, you can rename the configuration file node1.xml before copying the file.
domains.infa. Stores the connectivity information for the gateway nodes in a domain. The connectivity information includes the domain names, domain host names, and domain host port numbers. On nodes running PowerCenter Services, domains.infa is located in the PowerCenter installation directory, unless you configured a different location using the INFA_DOMAINS_FILE environment variable. You copy domains.infa from the backup location after you upgrade the domain and node metadata.
83
Run the BackupDomain command. Use the infasetup BackupDomain command to back up the domain configuration to an XML file. The BackupDomain command uses the following syntax:
BackupDomain <-DatabaseAddress|-da> database_hostname:database_port <-DatabaseUserName|-du> database_user_name <-DatabasePassword|-dp> database_password <-DatabaseType|-dt> database_type [<-DatabaseServiceName|-ds> database_service_name] <-BackupFile|-bf> backup_file_name [<-Force|-f>] <-DomainName|-dn> domain_name
For more information about the BackupDomain command, see "infasetup Command Reference" the Command Line Reference.
Back up the database tables manually. The BackupDomain command only backs up the PCSF_DOMAIN domain configuration database table. If you want to back up all domain configuration information, including information about the gateway nodes, session and workflow logs, and repository usage information, you can back up the database tables manually. If you want to back up the tables manually, back up the following tables:
84
nodemeta.xml. Contains the metadata for a node in a domain. All nodes store nodemeta.xml in the server/config directory. If the domain contains multiple nodes and you use the same backup directory for the metadata configuration files, you must rename nodemeta.xml before copying it to the backup location. For example, if you back up nodemeta.xml for a node named node01, you can rename the configuration file node1.xml before copying the file.
domains.infa. Stores the connectivity information for the gateway nodes in a domain. The connectivity information includes the domain names, domain host names, and domain host port numbers. On nodes running PowerCenter Services, domains.infa is located in the PowerCenter installation directory, unless you configured a different location using the INFA_DOMAINS_FILE environment variable. You copy domains.infa from the backup location after you upgrade the domain and node metadata.
85
When you prepare a repository for upgrade, you optimize the upgrade performance, set up another repository database, and create a copy of the repository. When you upgrade a PowerCenter repository, you upgrade a copy of the repository. Make a copy of all repositories in the existing version of PowerCenter before upgrading to PowerCenter 8.1.1. Upgrade the copy of the existing PowerCenter repository to evaluate it without altering the existing repository. Complete the following steps to prepare a PowerCenter repository for upgrade: 1. 2. 3. 4. Set up a PowerCenter repository database. Set up another database for each PowerCenter repository you want to upgrade. Optimize repository upgrade performance. You can optimize the repository to increase performance when you upgrade a repository. Prepare Informix, Teradata, or Oracle 8 Repositories. To upgrade an Informix, Oracle 8, or Teradata database, you must restore the repository to a supported repository database. Create a copy of the repository. Use the existing version of PowerCenter to create a copy or restore a backup of the existing repository to the database you created in step 1.
Purge versions from the repository. If your repository is enabled for version control, the repository can quickly grow very large depending on the frequency and number of new versions added to the repository. Each version of an object occupies the same amount of
86
space in the repository database. You may want to monitor the size of the repository database periodically to determine the rate of growth.
Truncate the workflow and session log file. Use the Repository Manager or use the pmrep TruncateLog command to truncate the workflow and session log file and delete run-time information you do not need. For example, you can delete all log events older than one month before upgrading the repository. Update statistics. PowerCenter identifies and updates the statistics of all repository tables and indexes when you upgrade a repository. You can update the statistics before upgrading the repository to increase upgrade performance.
For more information about completing the required tasks for optimizing the repository, see your existing PowerCenter documentation.
TRUE at the database level. Setting this option changes the default null type of the column to null in compliance with the SQL standard.
Copying a Repository
You can create a copy of your existing repository for upgrade by copying it to a new database.
To copy an existing PowerCenter repository to a another database: 1. 2. 3. 4.
Use the existing version of PowerCenter to copy the repository to another database. When you copy multiple repositories in a repository domain, register the local repositories with the global repository after you copy the repositories. Have all users close all PowerCenter Client repository connections. Release all residual locks.
87
5.
If you upgrade from PowerCenter 6.x/7.x, stop the PowerCenter Server and Repository Server. If you upgrade from PowerCenter 8.0, disable the Integration Service and Repository Service.
Backing Up a Repository
You can create a copy of your existing repository for upgrade by backing up the repository and then restoring the backup file to a new database.
Note: In PowerCenter 8.1.1, the Repository Service name cannot contain a tab character,
trailing spaces, any of the following characters: ? " : < > * / \ |, or more than 79 characters. If the name of the repository you want to upgrade contains any of these characters, back up the repository, and then restore it using a name that does not contain these characters. For information about backing up and restoring a repository, see your existing PowerCenter documentation.
To back up and restore an existing PowerCenter repository: 1. 2. 3. 4. 5. 6.
Use the existing version of PowerCenter to back up the existing repository. Use the existing version of PowerCenter to restore the repository backup file to another database. If you want to restore multiple repositories in a repository domain, register the local repositories with the global repository after you restore the repositories. Have all users close all PowerCenter Client repository connections. Release all residual locks. If you upgrade from PowerCenter 6.x/7.x, stop the PowerCenter Server and Repository Server. If you upgrade from PowerCenter 8.0, disable the Integration Service and Repository Service.
88
You must back up the Repository Agent and PowerCenter Server configuration files from PowerCenter 6.x or 7.x before you upgrade. When you upgrade the PowerCenter installation, you can upgrade existing Repository Agent and PowerCenter Server configurations to Repository Services and Integration Services in PowerCenter 8.1.1. Use the following steps to back up and copy the configuration files: 1. Create a PowerCenter Server configuration file. If a PowerCenter Server runs on Windows, create the PowerCenter Server configuration file using the pmserverexportreg utility and copy the file to the backup directory. Back up configuration files. Back up each configuration file that you want to upgrade. Verify the character set. Verify that the character set for the configuration files are compatible with the character set used by the gateway nodes in the domain. Copy the configuration files to the domain. Copy configuration files from the backup directory to the appropriate directory under the server/upgrade/cfgfiles directory on a node in the PowerCenter domain.
2. 3. 4.
Warning: Do not modify the contents of the configuration files before you upgrade the Repository Agent or PowerCenter Server to a Repository Service or Integration Service. Modifying the files may cause the upgrade to fail.
89
For example, the following command creates a configuration file named Production.cfg:
pmserverexportreg c:\PMServer\backup\Production.cfg To use the pmserverexportreg utility to create a configuration file: 1. 2. 3.
Copy the PowerCenter utilities to the machine that hosts the PowerCenter Server. From a command prompt, navigate to the location of pmserverexportreg.exe. Run the utility to create the PowerCenter Server configuration file. For example, use the following command:
pmserverexportreg <file path>\Production.cfg
Note: If you do not configure the file path, the utility creates the configuration file in the
Copy the PowerCenter Server configuration file you created to the backup directory for the PowerCenter Server and Repository Agent configuration files.
Troubleshooting pmserverexportreg
The following error messages may occur when you use pmserverexportreg: Cannot create configuration file because registry entry [<key name>] does not exist. PowerCenter Server not installed or registry contains errors. Cause: The pmserverexportreg utility cannot export the PowerCenter Server values from the registry on the current machine. A PowerCenter Server is not installed on the current machine or the registry contains errors. Verify that you run the utility on a machine where the PowerCenter Server is installed.
Action:
Cannot create file <file name>. The file name is invalid or the file already exists. Cause: The pmserverexportreg utility cannot create the PowerCenter Server configuration file. The name for the configuration file is invalid or the file already exists. Delete the current file or use a different file name, and run the command again.
Action:
90
Cannot create file <file name> due to error: <error text>. Cause: Action: The pmserverexportreg utility did not create the PowerCenter Server configuration file due to an error. Correct the error and run the utility again.
upgrade fails.
Repository Agent
The Repository Agent configuration file is located in the RepositoryServer/bin/Config directory machine where the Repository Server runs. Each repository has an associated Repository Agent configuration file based on the repository name. For example, for the HR_71 repository, the Repository Agent configuration file is named HR_071-es.cfg. If your PowerCenter repository domain includes global and local repositories, you must note which Repository Agent configuration files are associated with the global and local repositories.
PowerCenter Server
The PowerCenter Server configuration file pmserver.cfg is located in the Server/bin directory on UNIX machines. On Windows, you must export the PowerCenter Server configuration to a configuration file. For more information about exporting PowerCenter Server configuration on Windows, see Step 1. Create a PowerCenter Server Configuration File on page 89. If you upgrade multiple PowerCenter Server configurations, rename each configuration file before copying them to the backup location. For example, if you back up pmserver.cfg for a PowerCenter Server named Production, you can rename the configuration file Production.cfg before copying the file.
91
If the language settings are not compatible, the upgraded Repository Service or Integration Service may not start or may contain inconsistent metadata.
local_repo. Directory for Repository Agent configuration files for a local repositories. If your existing PowerCenter installation does not contain a global repository, copy all Repository Agent configuration files into this directory. global_repo. Directory for Repository Agent configuration files for global repositories. PCServer. Directory for PowerCenter Server configuration files.
If you want to upgrade a single configuration file, copy the configuration file to a directory that you can access from the node hosting the PowerCenter domain. You can select this file when you run the Upgrade Wizard.
92
93
After you restore the repository from the backup file, the new repository database is an exact copy of the working repository database. You can now use it as the repository for the new Data Analyzer installation.
DataAnalyzer.properties
Note: The DataAnalyzer.properties configuration file was introduced in Data Analyzer
5.0.2/8.0. You do not have to back up these files in PowerAnalyzer 4.x. If you updated application server configuration files, you must copy the application server configuration files in Data Analyzer to a temporary directory. Table 5-2 describes the application server configuration files:
Table 5-2. Data Analyzer Configuration Files
Application Server BEA WebLogic Server IBM WebSphere Application Server JBoss Application Server File Name config.xml startweblogic.cmd or startweblogic.sh server.xml login-config.xml
If you created custom color schemes or modified a pre-defined color scheme in a previous version of Data Analyzer, you can keep using them in Data Analyzer 8.1.1. To make sure that you do not lose your custom color schemes, copy them to a different location before you upgrade Data Analyzer and then restore them after you upgrade. Or, you can recreate them in the latest version of Data Analyzer.
95
For SuperGlue 2.1 or 2.2, you can find the parameter files in the following directory:
<PowerCenter_Home>\Server\SrcFiles
96
97
98
PowerCenter Complete Installation in Graphical Mode, 101 PowerCenter Custom Installation in Graphical Mode, 153 PowerCenter Complete Installation in Console Mode, 211 PowerCenter Custom Installation in Console Mode, 237 PowerCenter Client Installation, 265 PowerCenter Reports Installation, 281 Documentation Installation, 291 PowerCenter Utilities Installation, 299 Informatica Development Platform Installation, 315 After You Install, 323 Troubleshooting a PowerCenter Installation, 359 Uninstalling PowerCenter, 385
99
100
Chapter 6
Overview, 102 Installing PowerCenter Standard Edition, 103 Installing PowerCenter Advanced Edition, 128
101
Overview
This chapter provides instructions on running the PowerCenter graphical mode installer and installing the complete version of PowerCenter. When you install the complete version of PowerCenter, the PowerCenter installer determines the components available for installation based on the license key you provide. Before you start the installation, complete the pre-installation tasks listed in Before You Install on page 49. You can install the complete version of the following PowerCenter editions:
PowerCenter Standard Edition. Installs all PowerCenter Standard Edition components. Standard Edition includes PowerCenter and Data Analyzer for PowerCenter Repository Reports. For more information, see Installing PowerCenter Standard Edition on page 103. PowerCenter Advanced Edition. Installs all PowerCenter Advanced components, including PowerCenter Services, Data Analyzer, and Metadata Manager. For more information, see Installing PowerCenter Advanced Edition on page 128.
After you run the installer, complete the installation or upgrade of PowerCenter components. For more information, see the steps for your installation or upgrade path in Installation and Upgrade Overview on page 15.
102
Verify that your environment meets the minimum system requirements, and complete the pre-installation tasks. For more information about preparing for the PowerCenter installation, see Before You Install on page 49. Verify that you have the PowerCenter Standard Edition license.
2. 3. 4.
Log in to the machine as the system user. Close all other applications before running the installation. To start the installer on Windows, insert the DVD into the DVD drive. If the installer does not start or if you are installing PowerCenter from a hard disk, run install.exe from the DVD root directory or the root directory in the location where you downloaded the installer. -orTo start the installer on UNIX, run install.sh at a shell command line from the DVD root directory or the root directory in the location where you downloaded the installer. On UNIX, the PowerCenter installer checks the operating system and verifies that the environment variables are correctly set. The environment variables must be specifically set to enable the PowerCenter installer to run processes and connect to databases and services. If the environment variables are not set, the PowerCenter installer gives you the option to stop the installation and modify the environment variables.
5. 6.
On UNIX, select the option to use the GUI mode installation. On the main PowerCenter installation window, select Server. The Welcome window introduces the PowerCenter installation.
7.
Click Next.
103
On UNIX, the PowerCenter installer requires specific environment variable settings. Read the PowerCenter environment configuration requirements and set the environment variables before you continue the installation. If you do not set the environment variables as required, the PowerCenter installation may fail.
8.
104
9. 10.
Enter the location and file name of the PowerCenter Standard Edition license key or click Browse to locate the license key file. Click Next. The Installation Prerequisites window displays the supported platforms and databases and the disk space requirements. Verify that all PowerCenter installation requirements are met before you continue the installation.
11.
Click Next. The Installation Set window displays the PowerCenter installation options.
12.
To install the complete set of PowerCenter Standard Edition components, select Complete and click Next. To install a custom version of PowerCenter, see PowerCenter Custom Installation in Graphical Mode on page 153.
105
13. 14.
Enter the location and file name of the Data Analyzer license key or click Browse to locate the license key file. Click Next. The Installation Directory window appears.
15.
106
The default directory on Windows is C:\Informatica\PowerCenter8.1.1. The default directory on UNIX is $HOME/Informatica/PowerCenter8.1.1, where HOME is the user home directory.
Note: The installation directory path must be an absolute path. On Windows, the
17.
Select the application server to install Data Analyzer on to run PowerCenter Repository Reports. You can select one of the following options:
JBoss Application Server. You can install Data Analyzer on a new or existing instance of JBoss Application Server. If you select JBoss Application Server, continue to the next step. BEA WebLogic Server. You install Data Analyzer on an existing instance of BEA WebLogic Server. You can create a new WebLogic Server domain or install Data Analyzer on an existing WebLogic Server domain. If you select WebLogic Server, skip to step 23. WebSphere Application Server (Network Deployment). You install Data Analyzer on an existing WebSphere Application Server Network Deployment Edition instance. If you select WebSphere Application Server Network Deployment Edition, skip to step 30. WebSphere Application Server (Base). You install Data Analyzer on an existing WebSphere Application Server Base Edition instance. If you select WebSphere Application Server Base Edition, skip to step 30.
107
18.
19.
Select the option to install a new instance of JBoss Application Server or to use an existing instance. If you use an existing instance of JBoss Application Server, verify that the application server is shut down before you continue the installation.
20.
Enter the home directory and the server configuration directory for JBoss Application Server or click Browse to select the directory. If you install a new instance of JBoss Application Server, the installer creates a server configuration in the directory you provide. If you use an existing instance of JBoss Application Server, you must provide the directory for an existing server configuration. The server configuration must support all available JBoss services.
21.
108
You can configure the ports used by JBoss Application Server to avoid port conflicts if you run multiple instances of JBoss Application Server on the same machine.
22. 23.
109
110
25.
Choose to install Data Analyzer on a new domain or an existing domain. Provide the domain name and location. If you are installing Data Analyzer on a new WebLogic domain, continue to the next step. If you are installing on an existing WebLogic domain, skip to step 28.
26.
27. 28.
Enter the account name and password for the WebLogic Administration Console and the listening port number for the new domain. Skip to step 35. Click Next.
111
The Existing WebLogic Server Domain Configuration window appears. The installer will install Data Analyzer on an existing WebLogic domain in WebLogic Server.
29. 30.
Enter the account name and password for the WebLogic Administration Console for the existing domain. Skip to step 35. Click Next. The Existing WebSphere Application Server Directory window appears.
112
Enter the home directory for WebSphere Base Server or click Browse to locate the directory. Skip to step 33.
31.
Click Next. The Existing WebSphere Application Server Directory window appears.
32. 33.
Enter the home directories for the WebSphere Base Server and the Network Deployment or click Browse to locate the directory. Click Next.
113
34.
35.
Click Next. The Pre-Installation Summary page appears. Review the pre-installation summary to verify that the installer will install PowerCenter components in the correct location and with the options you select.
36.
114
After you click Install, the installer copies the files for the selected components to the installation directory. When the file copy process completes, the Create or Join Domain window appears.
37.
Choose to create a domain if you are installing PowerCenter for the first time or you are installing PowerCenter on a single machine. Skip to step 38. -orChoose to join a domain if you have created a PowerCenter domain on another machine and you want to add the current machine to the domain. Skip to step 44. For more information about the available domain options, click the Help Me Select link.
38.
Click Next.
115
PowerCenter stores the PowerCenter domain configuration in a relational database. The domain configuration must be accessible by all gateway nodes in the domain.
39.
40.
Click Next.
116
41.
117
42.
To set the range of port numbers to be used for PowerCenter Services on the node, click Advanced Configuration. The Advanced Configuration window appears.
43.
Enter the range of port numbers that the PowerCenter installer can use for PowerCenter Services on the node and click OK. The default range for the port numbers is 6005 - 6105. Skip to step 50.
44.
The PowerCenter domain that you want to join must be available when you join the domain. Verify that the gateway node for the domain you want to join is available before you continue. If the PowerCenter installer cannot connect to the PowerCenter domain, you cannot continue with the installation.
118
45.
46.
47.
Port number
119
Description Allows you to create a Repository Service for the PowerCenter repository. You must select this option to also create an Integration Service during installation. You can also create a Repository Service after installation. Indicates whether the node can serve as a gateway. If you do not select this option, the node is a worker node in the domain you join.
To set the range of port numbers to be used for PowerCenter Services on the node, click Advanced Configuration. The Advanced Configuration window appears.
49.
Enter the range of port numbers that the PowerCenter installer can use for the PowerCenter Services on the node and click OK. The default range for the port numbers is 6005 - 6105.
50.
120
Informatica Services is the Windows service that runs PowerCenter Services on a node in a PowerCenter domain. Configure the user account if PowerCenter Services need to access a network location not available to the current Windows user account. If you do not configure this option, the Informatica Services service uses the current Windows user account to log on when you start Informatica Services.
Note: You must configure a Windows user account for Informatica Services if you want to
use a trusted connection for authentication with the PowerCenter repository database.
51.
Password 52.
The installer requires the database information to create a PowerCenter repository or connect to an existing PowerCenter repository.
53.
121
To create a PowerCenter repository during the installation, select Create new PowerCenter Repository. To use an existing PowerCenter repository, select Use existing PowerCenter repository content. You may need to upgrade the repository after installing PowerCenter.
54.
Select a database type and enter the database information for the PowerCenter repository. The PowerCenter Repository Configuration window requires different information based on the database type you select. Table 6-1 describes the configuration information required for the repository:
Table 6-1. PowerCenter Repository Information
Option Repository name Description Name for the PowerCenter repository. The name is case sensitive and must be less than 30 characters. The repository name cannot contain spaces or the following characters: \ / : *?><"| Repository code page. The Repository Service uses the character set encoded in the repository code page when it writes data to the repository. Choose a code page that is compatible with the code page of the machine where you install PowerCenter. If you use an existing PowerCenter repository, the PowerCenter installer does not validate the repository code page. You must verify that the code page for the existing repository is compatible with the code page of the machine where you install PowerCenter. The Integration Service created during installation uses the same code page as the Repository Service. Verify that the code page for the Repository Service is compatible with the machine where the services are created. Type of database for the PowerCenter repository. Appears for Microsoft SQL Server only. If selected, the Repository Service uses Windows authentication to access the Microsoft SQL Server database. You must configure a Windows user in the Configure Informatica Services window to enable this option. The user account that runs Informatica Services must have access to the Microsoft SQL Server database. Name of the user account to connect to the repository database. Password for the user account to connect to the database. Use 7-bit ASCII. Appears for Oracle, Microsoft SQL Server, and Sybase ASE databases only. Native connect string to access the repository database. Use the syntax appropriate for the selected database: - Oracle: Same syntax as the TNSNAMES entry: aliasname.world. - Microsoft SQL Server: Syntax is SQLServername@dbname, where SQLServername is the name of the SQL Server instance that contains the dbname database. - Sybase ASE: Syntax is servername@dbname, where servername is the name of the Adaptive Server from the interfaces file. Appears for DB2 databases. DB2 alias name for the repository database. Appears for DB2 databases. Name of the tablespace in which to create the repository tables. If blank, the installation creates the repository tables in the default tablespace.
Code page
122
The installer verifies that the database connection is valid. If the connection fails, an error message indicates the reason for the failure. You can continue the installation if the connection is valid. If you chose to create a Repository Service when you configured the node, continue to the next step. If you do not create a Repository Service, skip to step 58.
56.
Choose the data movement mode. The data movement mode must match the data movement mode of the associated PowerCenter repository.
57.
123
58.
Click Next. If you selected an existing instance of JBoss Application Server, or you selected WebLogic Server or WebSphere Application Server, the Data Analyzer and Metadata Manager Authentication window appears.
Note: WebLogic Server and WebSphere Application Server support one authentication
method for all applications running on the same instance of the application server.
59.
Select Yes to overwrite the authentication in the application server with repository authentication. The new authentication settings will overwrite the security settings on the application server. -orSelect No to keep the current authentication settings in the application server. If you select No, the application server must be configured with an authentication method that is compatible with Data Analyzer. Otherwise, you cannot log in to Data Analyzer. If you install Data Analyzer on WebSphere Application Server, the installer configures WebSphere Application Server security and Data Analyzer authentication based on your selection and the WebSphere Application Server setup.
124
Table 6-2 describes the configuration tasks performed by the installer when you install Data Analyzer on WebSphere Application Server:
Table 6-2. WebSphere Application Server Security and Repository Authentication
WebSphere Security Enabled? Yes Configure Repository Authentication? Yes
Installer Action The installer changes the existing WebSphere Application Server Console administrator user name to admin and the password to admin and configures repository authentication for Data Analyzer. The installer leaves WebSphere Application Server Console security settings intact and does not change the administrator user name and password. The installer does not configure repository authentication. The installer enables the WebSphere Application Server Console security and sets the administrator user name to admin and the password to admin. The installer configures repository authentication for Data Analyzer. The installer does not enable WebSphere Application Server Console security and does not configure repository authentication for Data Analyzer.
Yes
No
No
Yes
No
No
For more information about configuring authentication, see Configuring Authentication in the Data Analyzer Administrator Guide.
60.
Click Next. The installer displays a message about the application server configuration tasks performed by the installer. Click Cancel to return to the Data Analyzer and Metadata Manager Authentication window. Click Continue to continue with the installation.
125
61.
Select whether to use a new or existing Data Analyzer repository. To create a Data Analyzer repository during the installation, select Create new Data Analyzer repository. To use an existing Data Analyzer repository, select Use Existing Data Analyzer repository content. To use existing Data Analyzer repository content, you may need to upgrade the repository after installation.
62.
Select a database type and enter the database information for the Data Analyzer repository. Table 6-3 describes the information required to for the Data Analyzer repository:
Table 6-3. Data Analyzer Repository Information
Option Database type Database URL Description Type of database for the Data Analyzer repository. Database connection string. When you select the database type, the Data Analyzer Repository Configuration window displays the database URL format for the selected database type: Oracle: host_name:port_number;SID=sid DB2:host_name:port_number;DatabaseName=databasename Microsoft SQL Server:
host_name:port_number;SelectMethod=cursor;DatabaseName=databasename Sybase ASE: host_name:port;DatabaseName=database_name
Name of the user account to connect to the repository database. Password for the user account to connect to the database.
126
63.
Click Test Connection to verify the database connection. The installer verifies that the database connection is valid. If the connection fails, an error message indicates the reason for the failure. You can continue the installation if the connection is valid.
64.
Click Next. The installer configures Data Analyzer and the application server, configures the Data Analyzer repository, and starts the application server. The PowerCenter Installation Summary window indicates whether the installation completed successfully. It also shows the configured properties for PowerCenter components and the status of installed components.
65.
Click Done.
You can view the log files generated by the installer to obtain more information about the installation tasks performed by the installer and view configuration properties for the installed components. For more information about the log files generated by the installer, see Installer Log Files on page 362.
127
Verify that your environment meets the minimum system requirements, and complete the pre-installation tasks. For more information about preparing for the PowerCenter installation, see Before You Install on page 49. Verify that you have the PowerCenter Advanced Edition license.
2. 3. 4.
Log in to the machine as the system user. Close all other applications before running the installation. To start the installer on Windows, insert the DVD into the DVD drive. If the installer does not start or if you are installing PowerCenter from a hard disk, run install.exe from the DVD root directory or the root directory in the location where you downloaded the installer. -orTo start the installer on UNIX, run install.sh at a shell command line from the DVD root directory or the root directory in the location where you downloaded the installer. On UNIX, the PowerCenter installer checks the operating system and verifies that the environment variables are correctly set. The environment variables must be specifically set to enable the PowerCenter installer to run processes and connect to databases and services. If the environment variables are not set, the PowerCenter installer gives you the option to stop the installation and modify the environment variables.
5. 6.
On UNIX, select the option to use the GUI mode installation. On the main PowerCenter installation window, select Server. The Welcome window introduces the PowerCenter installation.
7.
Click Next.
128
On UNIX, the PowerCenter installer requires specific environment variable settings. Read the PowerCenter environment configuration requirements and set the environment variables before you continue the installation. If you do not set the environment variables as required, the PowerCenter installation may fail.
8.
129
9. 10.
Enter the location and file name of the PowerCenter Advanced Edition license key or click Browse to locate the license key file. Click Next. The Installation Prerequisites window displays the supported platforms and databases and the disk space requirements. Verify that all PowerCenter installation requirements are met before you continue the installation. For more information about the prerequisites, see Pre-Installation Tasks on page 50.
11.
Click Next. The Installation Set window displays the PowerCenter installation options.
12.
To install the complete set of PowerCenter Advanced Edition components, select Complete and click Next. To install a custom version of PowerCenter, see PowerCenter Custom Installation in Graphical Mode on page 153.
130
13. 14.
Enter the location and file name of the Data Analyzer or Metadata Manager license key or click Browse to locate the license key file. Click Next. The Installation Directory window appears.
131
15.
Use the default directory or click Browse to select a directory. The default directory on Windows is C:\Informatica\PowerCenter8.1.1. The default directory on UNIX is $HOME/Informatica/PowerCenter8.1.1, where HOME is the user home directory.
Note: The installation directory path must be an absolute path. On Windows, the
17.
Select the application server to install Data Analyzer and Metadata Manager on. The installer installs Data Analyzer and Metadata Manager on the same application server. You can select one of the following options:
JBoss Application Server. You can install Data Analyzer and Metadata Manager on a new or existing instance of JBoss Application Server. If you select JBoss Application Server, continue to the next step. BEA WebLogic Server. You install Data Analyzer and Metadata Manager on an existing instance of BEA WebLogic Server. You can create a new WebLogic Server domain or install Data Analyzer and Metadata Manager on an existing WebLogic Server domain. If you select WebLogic Server, skip to step 23. WebSphere Application Server. You install Data Analyzer and Metadata Manager on an existing WebSphere Application Server Network Deployment Edition instance. If you select WebSphere Application Server Network Deployment Edition, skip to step 32.
132
WebSphere Application Server (Base). You install Data Analyzer and Metadata Manager on an existing WebSphere Application Server Base Edition instance. If you select WebSphere Application Server Base Edition, skip to step 30.
18.
19.
Select the option to install a new instance of JBoss Application Server or to use an instance that exists. If you use an existing instance of JBoss Application Server, verify that the application server is shutdown before you continue the installation.
20.
Enter the home directory and the server configuration directory for JBoss Application Server or click Browse to select the directory. If you install a new instance of JBoss Application Server, the installer creates a server configuration in the directory you provide. If you use an existing instance of JBoss Application Server, you must provide the directory for an existing server configuration. The server configuration must support all available JBoss services.
21.
133
You can configure the ports used by the JBoss Application Server to avoid port conflicts if you run multiple instances of JBoss Application Server on the same machine.
22. 23.
134
25.
Choose to install Data Analyzer and Metadata Manager on a new domain or an existing domain. Provide the domain name and location.
135
If you are installing Data Analyzer and Metadata Manager on a new WebLogic domain, continue to the next step. If you are installing on an existing WebLogic domain, skip to step 28.
26.
27. 28.
Enter the account name and password for the WebLogic Administration Console and the listening port number for the new domain. Skip to step 36. Click Next.
136
The installer will install Data Analyzer and Metadata Manager on an existing WebLogic domain in WebLogic Server.
29. 30.
Enter the account name and password for the WebLogic Administration Console for the existing domain. Skip to step 36. Click Next. The Existing WebSphere Application Server Directory window appears.
137
31. 32.
Enter the home directory for WebSphere Base Server or click Browse to locate the directory. Skip to step 34. Click Next. The Existing WebSphere Application Server Directory window appears.
33. 34.
Enter the home directories for the WebSphere Base Server and the Network Deployment or click Browse to locate the directory. Click Next. The WebSphere Application Server Administration Details window appears.
138
35.
36.
Click Next. The Pre-Installation Summary page appears. Review the pre-installation summary to verify that the installer will install PowerCenter components in the correct location and with the options you select.
37.
Click Install to continue or click Previous to modify the options. After you click Install, the installer copies the files for PowerCenter Advanced Edition to the installation directory. When the file copy process completes, the Create or Join Domain window appears.
38.
Choose to create a domain if you are installing PowerCenter for the first time or you are installing PowerCenter on a single machine. Skip to step 39. -orChoose to join a domain if you have created a PowerCenter domain on another machine and you want to add the current machine to the domain. Skip to step 45.
Installing PowerCenter Advanced Edition 139
For more information about the available domain options, click the Help Me Select link.
39.
PowerCenter stores the PowerCenter domain configuration in a relational database. The domain configuration must be accessible by all gateway nodes in the domain.
40.
41.
Click Next.
140
42.
Note: By default, the installer creates a Repository Service and an Integration Service for
Metadata Manager in the PowerCenter domain. You can create a separate Repository
Installing PowerCenter Advanced Edition 141
Service and Integration Service for the PowerCenter repository after you complete the installation.
43.
To set the range of port numbers to be used for PowerCenter Services on the node, click Advanced Configuration. The Advanced Configuration window appears.
44.
Enter the range of port numbers that the PowerCenter installer can use for PowerCenter Services on the node and click OK. The default range for the port numbers is 6005 - 6105. Skip to step 51.
45.
The PowerCenter domain that you want to join must be available when you join the domain. Verify that the gateway node for the domain you want to join is available before you continue. If the PowerCenter installer cannot connect to the PowerCenter domain, you cannot continue with the installation.
142 Chapter 6: PowerCenter Complete Installation in Graphical Mode
46.
47.
48.
Port number
Serves as Gateway
143
Note: By default, the installer creates a Repository Service and Integration Service for
Metadata Manager in the PowerCenter domain. You can create a separate Repository Service and Integration Service for the PowerCenter repository after you complete the installation.
49.
To set the range of port numbers to be used for PowerCenter Services on the node, click Advanced Configuration. The Advanced Configuration window appears.
50.
Enter the range of port numbers that the PowerCenter installer can use for PowerCenter Services on the node and click OK. The default range for the port numbers is 6005 - 6105.
51.
Informatica Services is the Windows service that runs PowerCenter Services on a node in a PowerCenter domain. Configure the user account if PowerCenter Services needs to access a network location not available to the current Windows user account. If you do
144 Chapter 6: PowerCenter Complete Installation in Graphical Mode
not configure this option, the Informatica Services service uses the current Windows user account to log on when you start Informatica Services.
Note: You must configure a Windows user account for Informatica Services if you want to
use a trusted connection for authentication with the PowerCenter repository database.
52.
Password 53.
54.
Select whether to use a new or existing PowerCenter repository. To create a PowerCenter repository during the installation, select Create new PowerCenter Repository. To use an existing PowerCenter repository, select Use existing PowerCenter repository content.
55.
Select a database type and enter the database information for the PowerCenter repository.
145
The PowerCenter Repository Configuration window requires different information based on the database type you select. Table 6-4 describes the configuration information required for the repository:
Table 6-4. PowerCenter Repository Information
Option Repository name Code page Description Name for the PowerCenter repository. The name is case sensitive, must be less than 30 character and not contain the following characters: \/:*?<>| Repository code page. The Repository Service uses the character set encoded in the repository code page when it writes data to the repository. Choose a code page that is compatible with the code page of the machine where you install PowerCenter. If you use an existing PowerCenter repository, the PowerCenter installer does not validate the repository code page. You must verify that the code page for the existing repository is compatible with the code page of the machine where you install PowerCenter. The Integration Service created during installation uses the same code page as the Repository Service. Verify that the code page for the Repository Service is compatible with the machine where the services are created. Note: If you join a domain, the installer creates the Repository Service for the PowerCenter repository for Metadata Manager on the gateway node for the domain. The installer includes a generic list of code pages for the PowerCenter repository. Verify that the code page you select is available on the gateway node for the domain you are joining. Type of database for the PowerCenter repository. Appears for Microsoft SQL Server only. If selected, the Repository Service uses Windows authentication to access the Microsoft SQL Server database. You must configure a Windows user in the Configure Informatica Services window to enable this option. The user account that runs Informatica Services must have access to the Microsoft SQL Server database. Name of the user account to connect to the repository database. Password for the user account to connect to the database. Use 7-bit ASCII. Appears for Oracle, Microsoft SQL Server, and Sybase ASE databases only. Native connect string to access the repository database. Use the syntax appropriate for the selected database: - Oracle: Same syntax as the TNSNAMES entry: aliasname.world. - Microsoft SQL Server: Syntax is SQLServername@dbname, where SQLServername is the name of the Microsoft SQL Server instance that contains the dbname database. - Sybase ASE: Syntax is servername@dbname, where servername is the name of the Adaptive Server from the interfaces file. Appears for DB2 database only. DB2 alias name for the repository database. Appears for DB2 database only. Name of the tablespace in which to create the repository tables. If blank, the installation creates the repository tables in the default tablespace.
Click Test Connection to verify the database connection. The installer verifies that the database connection is valid. If the connection fails, an error message indicates the reason for the failure. You can continue the installation if the connection is valid.
146
57.
Choose the data movement mode. The data movement mode must match the data movement mode of the associated PowerCenter repository for Metadata Manager.
58.
User name
Password 59.
Click Next.
147
If you selected an existing instance of JBoss Application Server, or you selected WebLogic Server or WebSphere Application Server, the Data Analyzer and Metadata Manager Authentication window appears.
Note: WebLogic Server and WebSphere Application Server support one authentication
method for all applications running on the same instance of the application server.
60.
Select Yes to overwrite the authentication in the application server with repository authentication. The new authentication settings will overwrite the security settings on the application server. -orSelect No to keep the current authentication settings in the application server. If you select No, the application server must be configured with an authentication method that is compatible with Data Analyzer and Metadata Manager. Otherwise, you cannot log in to Data Analyzer or Metadata Manager. If you install Data Analyzer or Metadata Manager on WebSphere Application Server, the installer configures WebSphere Application Server security and Data Analyzer or Metadata Manager authentication based on your selection and the WebSphere Application Server setup.
148
Table 6-5 describes the configuration tasks performed by the installer when you install Data Analyzer and Metadata Manager on WebSphere Application Server:
Table 6-5. WebSphere Application Server Security and Repository Authentication
WebSpher e Security Enabled? Yes Configure Repository Authentication? Yes
Installer Action The installer changes the existing WebSphere Application Server Console administrator user name to admin and the password to admin and configures repository authentication for Data Analyzer and Metadata Manager. The installer leaves WebSphere Application Server Console security settings intact and does not change the administrator user name and password. The installer does not configure repository authentication. The installer enables the WebSphere Application Server Console security and sets the administrator user name to admin and the password to admin. The installer configures repository authentication for Data Analyzer and Metadata Manager. The installer does not enable WebSphere Application Server Console security and does not configure repository authentication for Data Analyzer and Metadata Manager.
Yes
No
No
Yes
No
No
For more information about configuring authentication, see Configuring Authentication in the Data Analyzer Administrator Guide and Managing Authentication for Metadata Manager in the Metadata Manager Administrator Guide.
61.
Click Next. The installer displays a message about the application server configuration tasks performed by the installer. Click Cancel to return to the Data Analyzer and Metadata Manager Authentication window. Click Continue to continue with the installation.
149
62.
Select whether to use a new or existing Data Analyzer repository. To create a Data Analyzer repository during the installation, select Create new Data Analyzer repository. To use an existing Data Analyzer repository, select Use existing Data Analyzer repository content
63.
Select a database type and enter the database information for the Data Analyzer repository. Table 6-6 describes the information required for the Data Analyzer repository:
Table 6-6. Data Analyzer Repository Information
Option Database type Database URL Description Type of database for the Data Analyzer repository. Database connection string. When you select the database type, the Data Analyzer Repository Configuration window displays the database URL format for the selected database type: Oracle: host_name:port_number;SID=sid DB2:host_name:port_number;DatabaseName=databasename Microsoft SQL Server:
host_name:port_number;SelectMethod=cursor;DatabaseName=databasename Sybase ASE: host_name:port;DatabaseName=database_name
Name of the user account to connect to the repository database. Password for the user account to connect to the database.
150
The installer verifies that the database connection is valid. If the connection fails, an error message indicates the reason for the failure. You can continue the installation if the connection is valid.
65.
66.
Select whether to use a new or existing Metadata Manager repository. To create a Metadata Manager repository during the installation, select Create new Metadata Manager repository. To use an existing Metadata Manager repository, select Use existing Metadata Manager repository content.
67.
Select a database type and enter the database information for the Metadata Manager repository. Table 6-7 describes the information required for the Metadata Manager repository:
Table 6-7. Metadata Manager Repository Information
Option Database type Database URL Description Type of database for the Metadata Manager repository. Database connection string. When you select the database type, the Metadata Manager Repository Configuration window displays the database URL format for the selected database type: Oracle: host_name:port_number;SID=sid DB2:host_name:port_number;DatabaseName=databasename Microsoft SQL Server:
host_name:port_number;SelectMethod=cursor;DatabaseName=databasename Sybase ASE: host_name:port;DatabaseName=database_name
151
Click Test Connection to verify the database connection. The installer verifies that the database connection is valid. If the connection fails, an error message indicates the reason for the failure. You can continue the installation if the connection is valid.
69.
Click Next. The installer configures Data Analyzer, Metadata Manager, and the application server. It configures the Data Analyzer and Metadata Manager repositories and starts the application server. The PowerCenter Installation Summary window indicates whether the installation completed successfully. It also shows the configured properties for PowerCenter components and the status of installed components.
70.
Click Done.
You can view the log files generated by the installer to obtain more information about the installation tasks performed by the installer and view configuration properties for the installed components. For more information about the log files generated by the installer, see Installer Log Files on page 362.
152
Chapter 7
Overview, 154 Installing PowerCenter Services, 155 Upgrading from PowerCenter 8.1, 170 Installing Data Analyzer, 175 Installing Metadata Manager, 191
153
Overview
This chapter provides instructions on running the PowerCenter graphical mode installer and installing a custom version of PowerCenter. When you select the custom installation option, the PowerCenter installer determines the components available for installation based on the license key you provide. With the custom installation, you can install the PowerCenter components separately. If you choose to install more than one component, the PowerCenter installer installs all the selected components on the same machine in the directory that you provide. You can provide a different database for each repository. Before you install PowerCenter, complete the steps listed in Pre-Installation Tasks on page 50. You can install the following PowerCenter components:
PowerCenter Services. Install only PowerCenter Services. When you install PowerCenter Services, you can choose the following options:
Install PowerCenter Services. Install PowerCenter Services if you have not installed PowerCenter Services or if you are upgrading from version 8.0 or earlier. For more information about installing PowerCenter, see Installing PowerCenter Services on page 155. Upgrade PowerCenter Services. Install PowerCenter Services and upgrade the domain and node metadata if you upgrade from PowerCenter 8.1. For more information about upgrading PowerCenter, see Upgrading from PowerCenter 8.1 on page 170.
Data Analyzer. Install only Data Analyzer. For more information, see Installing Data Analyzer on page 175. Metadata Manager. Install only Metadata Manager. For more information, see Installing Metadata Manager on page 191.
After you run the installer, complete the installation or upgrade of PowerCenter components. For more information, see the steps for your installation or upgrade path in Installation and Upgrade Overview on page 15.
154
Verify that your environment meets the minimum system requirements, and complete the pre-installation tasks. For more information about preparing for the PowerCenter installation, see Before You Install on page 49.
2. 3. 4.
Log in to the machine as the system user. Close all other applications before running the installation. To start the installer on Windows, insert the DVD into the DVD drive. If the installer does not start or if you are installing PowerCenter from a hard disk, run install.exe from the DVD root directory or the root directory in the location where you downloaded the installer. -orTo start the installer on UNIX, run install.sh at a shell command line from the DVD root directory or the root directory in the location where you downloaded the installer. On UNIX, the PowerCenter installer checks the operating system and verifies that the environment variables are correctly set. The environment variables must be specifically set to enable the PowerCenter installer to run processes and connect to databases and services. If the environment variables are not set, the PowerCenter installer gives you the option to stop the installation and modify the environment variables.
5. 6.
On UNIX, select the option to use the GUI mode installation. On the main PowerCenter installation window, select Server. The Welcome window introduces the PowerCenter Standard Edition installation.
7.
Click Next.
155
On UNIX, the PowerCenter installer requires specific environment variable settings. Read the PowerCenter environment configuration requirements and set the environment variables before you continue the installation. If you do not set the environment variables as required, the PowerCenter installation may fail.
8.
156
9. 10.
Enter the location and file name of the PowerCenter license key or click Browse to locate the license key file. Click Next. The Installation Prerequisites window displays the supported platforms and databases and the disk space requirements. Make sure that all PowerCenter installation requirements are met before you continue the installation.
11.
Click Next. The Installation Set window displays the PowerCenter installation options.
12.
To select the PowerCenter components to install, select Custom and click Next. The PowerCenter installer displays the list of available PowerCenter components. The type of license key you provide determines the available components.
157
For the PowerCenter Standard Edition license, the PowerCenter Standard Edition Components window appears.
-orFor the PowerCenter Advanced Edition license, the PowerCenter Advanced Edition Components window appears.
13.
To install PowerCenter Services, clear all options except PowerCenter Services and click Next.
158
14.
Use the default directory or click Browse to select a directory. The default directory on Windows is C:\Informatica\PowerCenter8.1.1. The default directory on UNIX is $HOME/Informatica/PowerCenter8.1.1, where HOME is the user home directory.
Note: The installation directory path must be an absolute path. On Windows, the
installation directory path must be located on the current machine. If the installation directory contains a Metadata Manager installation, you cannot install PowerCenter Services in the directory.
15.
Click Next.
159
16. 17.
Choose Install PowerCenter 8.1.1. Click Next. The Pre-Installation Summary page appears. Review the pre-installation summary to verify that the installer will install PowerCenter components in the correct location and with the options you select.
18.
160
After you click Install, the installer copies the files for the selected components. When the file copy process completes, the Create or Join Domain window appears.
19.
Choose to create a domain if you are installing PowerCenter for the first time or you are installing PowerCenter on a single machine. Skip to step 20. -orChoose to join a domain if you have created a PowerCenter domain on another machine and you want to add the current machine to the domain. Skip to step 26. For more information about the available domain options, click the Help Me Select link.
20.
Click Next.
161
PowerCenter stores the PowerCenter domain configuration in a relational database. The domain configuration must be accessible by all gateway nodes in the domain.
21.
22.
Click Next.
162
23.
163
24.
To set the range of port numbers to be used for PowerCenter Services on the node, click Advanced Configuration. The Advanced Configuration window appears.
25.
Enter the range of port numbers that the PowerCenter installer can use for PowerCenter Services on the node and click OK. The default range for the port numbers is 6005 - 6105.
26.
The PowerCenter domain that you want to join must be available when you join the domain. Verify that the gateway node for the domain you want to join is available before you continue. If the PowerCenter installer cannot connect to the PowerCenter domain, you cannot continue with the installation.
164
27.
28.
29.
Port number
165
Description Allows you to create a Repository Service for the PowerCenter repository. You must select this option to also create an Integration Service using the installer. Indicates whether the node can serve as a gateway. If you do not select this option, the node is a worker node in the domain you join.
To set the range of port numbers to be used for PowerCenter Services on the node, click Advanced Configuration. Enter the port range and click OK. Click Next. On Windows, the Configure Informatica Services window appears.
Informatica Services is the Windows service that runs PowerCenter Services on a node in a PowerCenter domain. Configure the user account if PowerCenter Services needs to access a network location not available to the current Windows user account. If you do not configure this option, the Informatica Services service uses the current Windows user account to log on when you start Informatica Services.
Note: You must configure a Windows user account for Informatica Services if you want to
use a trusted connection for authentication with the PowerCenter repository database.
166
33.
Password 34.
The installer requires the database information to create a PowerCenter repository or connect to an existing PowerCenter repository.
35.
Select whether to use a new or existing PowerCenter repository. To create a PowerCenter repository during the installation, select Create New PowerCenter Repository. To use an existing PowerCenter repository, select Use existing PowerCenter repository content. You may need to upgrade the repository after installing PowerCenter.
36.
Select a database type and enter the database information for the PowerCenter repository. The PowerCenter Repository Configuration window requires different information based on the database type you select.
Installing PowerCenter Services 167
Table 7-1 describes the configuration information required for the repository:
Table 7-1. PowerCenter Repository Information
Option Repository name Code page Description Name for the PowerCenter repository. The name is case sensitive and must be less than 30 characters. It cannot contain spaces or the following characters: \/:*?<>| Repository code page. The Repository Service uses the character set encoded in the repository code page when it writes data to the repository. Choose a code page that is compatible with the code page of the machine where you install PowerCenter. For more information about code pages, see Code Pages on page 45. If you use an existing PowerCenter repository, the PowerCenter installer does not validate the repository code page. You must ensure that the code page for the existing repository is compatible with the code page of the machine where you install PowerCenter. The Integration Service created during installation uses the same code page as the Repository Service. Verify that the code page for the Repository Service is compatible with the machine where the services are created. Type of database for the PowerCenter repository. Appears for Microsoft SQL Server only. If selected, the Repository Service uses Windows authentication to access the Microsoft SQL Server database. You must configure a Windows user in the Configure Informatica Services window to enable this option. The user account that runs Informatica Services must have access to the Microsoft SQL Server database. Name of the user account to connect to the repository database. Password for the user account to connect to the database. Use 7-bit ASCII. Appears for Oracle, Microsoft SQL Server, and Sybase ASE databases only. Native connect string to access the repository database. Use the syntax appropriate for the selected database: - Oracle: Same syntax as the TNSNAMES entry: aliasname.world. Example: OraDB.world - Microsoft SQL Server: Syntax is SQLServername@dbname, where SQLServername is the name of the SQL Server instance that contains the dbname database. - Sybase ASE: Syntax is servername@dbname, where servername is the name of the Adaptive Server from the interfaces file. Appears for DB2 database only. DB2 alias name for the repository database. Appears for DB2 database only. Name of the tablespace in which to create the repository tables. If blank, the installation creates the repository tables in the default tablespace.
Click Test Connection to verify the database connection. The installer verifies that the database connection is valid. If the connection fails, an error message indicates the reason for the failure. You can continue the installation if the connection is valid.
38.
Click Next.
168
Choose the data movement mode. The data movement mode must match the data movement mode of the associated PowerCenter repository.
39.
Click Next. When the installation completes, the PowerCenter Installation Summary window indicates whether the installation completed successfully. It also shows the configured properties for PowerCenter components and the status of installed components.
41.
Click Done. You can view the log files generated by the installer to obtain more information about the installation tasks performed by the installer and view configuration properties for the installed components. For more information about the log files generated by the installer, see Installer Log Files on page 362.
Installing PowerCenter Services 169
Verify that your environment meets the minimum system requirements, and complete the pre-upgrade tasks. For more information about preparing for the PowerCenter installation, see PowerCenter 8.1 Pre-Upgrade Steps on page 84.
2. 3. 4.
Log in to the machine as the system user. Close all other applications before running the installation. To start the installer on Windows, insert the DVD into the DVD drive. If the installer does not start or if you are installing PowerCenter from a hard disk, run install.exe from the DVD root directory or the root directory in the location where you downloaded the installer. -orTo start the installer on UNIX, run install.sh at a shell command line from the DVD root directory or the root directory in the location where you downloaded the installer. On UNIX, the PowerCenter installer checks the operating system and verifies that the environment variables are correctly set. The environment variables must be specifically set to enable the PowerCenter installer to run processes and connect to databases and services. If the environment variables are not set, the PowerCenter installer gives you the option to stop the installation and modify the environment variables.
5. 6.
On UNIX, select the option to use the GUI mode installation. On the main PowerCenter installation window, select Server. The Welcome window introduces the PowerCenter installation.
7.
Click Next.
170
On UNIX, the PowerCenter installer requires specific environment variable settings. Read the PowerCenter environment configuration requirements and set the environment variables before you continue the installation. If you do not set the environment variables as required, the PowerCenter installation may fail.
8.
171
9. 10.
Enter the location and file name of the PowerCenter license key or click Browse to locate the license key file. Click Next. The Installation Prerequisites window displays the supported platforms and databases and the disk space requirements. Make sure that all PowerCenter installation requirements are met before you continue the installation.
11.
Click Next. The Installation Set window displays the PowerCenter installation options.
12.
172
For the PowerCenter Standard Edition license, the PowerCenter Standard Edition Components window appears.
13. 14.
To upgrade PowerCenter Services, clear all options except PowerCenter Services and click Next. Click Next. The Choose Installation Type window appears.
15.
16.
17.
Use the default directory or click Browse to select a directory. You must use the directory where you installed PowerCenter Services 8.1. The installation directory path must be an absolute path. On Windows, the installation directory path must be located on the current machine.
18.
Click Next. The Pre-Installation Summary page appears. Review the pre-installation summary to verify that the installer will install PowerCenter components in the correct location and with the options you select.
19.
Click Install to continue or click Previous to modify the options. The installer installs PowerCenter Services and updates the previous installation. You can view the log files generated by the installer to obtain more information about the installation tasks performed by the installer. For more information about the log files generated by the installer, see Installer Log Files on page 362.
174
Verify that your environment meets the minimum system requirements, and complete the pre-installation tasks. For more information about preparing for the PowerCenter installation, see Before You Install on page 49.
2.
Log in to the machine as the system user. For information about the user requirements, see Step 4. Create a System User Account on page 58.
3. 4.
Close all other applications before running the installation. To start the installer on Windows, insert the DVD into the DVD drive. If the installer does not start or if you are installing PowerCenter from a hard disk, run install.exe from the DVD root directory or the root directory in the location where you downloaded the installer. -orTo start the installer on UNIX, run install.sh at a shell command line from the DVD root directory or the root directory in the location where you downloaded the installer. On UNIX, the PowerCenter installer checks the operating system and verifies that the environment variables are correctly set. The environment variables must be specifically set to enable the PowerCenter installer to run processes and connect to databases and services. If the environment variables are not set, the PowerCenter installer gives you the option to stop the installation and modify the environment variables.
5. 6.
On UNIX, select the option to use the GUI mode installation. On the main PowerCenter installation window, select Server. The Welcome window introduces the PowerCenter installation.
7.
Click Next.
175
On UNIX, the PowerCenter installer requires specific environment variable settings. Read the PowerCenter environment configuration requirements and set the environment variables before you continue the installation. If you do not set the environment variables as required, the PowerCenter installation may fail.
8.
176
9. 10.
Enter the location and file name of the PowerCenter license key or click Browse to locate the license key file. Click Next. The Installation Prerequisites window displays the supported platforms and databases and the disk space requirements. Make sure that all PowerCenter installation requirements are met before you continue the installation.
11.
Click Next. The Installation Set window displays the PowerCenter installation options.
12.
To select the PowerCenter components to install, select Custom and click Next. The PowerCenter installer displays the list of available PowerCenter components. The type of license key you provide determines the available components.
177
For the PowerCenter Standard Edition license, the PowerCenter Standard Edition Components window appears.
-orFor the PowerCenter Advanced Edition license, the PowerCenter Advanced Edition Components window appears.
13.
To install Data Analyzer, clear all options except Data Analyzer and click Next. The Data Analyzer/Metadata Manager License Key window appears.
178
14. 15.
Enter the location and file name of the Data Analyzer license key or click Browse to locate the license key file. Click Next. The Installation Directory window appears.
16.
Use the default directory or click Browse to select a directory. The default directory on Windows is C:\Informatica\PowerCenter8.1.1.
179
The default directory on UNIX is $HOME/Informatica/PowerCenter8.1.1, where HOME is the user home directory.
Note: The installation directory path must be an absolute path. On Windows, the
18.
Select the application server to install Data Analyzer on. The installer installs Data Analyzer on the same application server. You can select one of the following options:
JBoss Application Server. You can install Data Analyzer on a new or existing instance of JBoss Application Server. If you select JBoss Application Server, continue to the next step. BEA WebLogic Server. You install Data Analyzer on an existing instance of BEA WebLogic Server. You can create a new WebLogic Server domain or install Data Analyzer on an existing WebLogic Server domain. If you select WebLogic Server, skip to step 24. WebSphere Application Server (Network Deployment). You install Data Analyzer on an existing WebSphere Application Server Network Deployment Edition instance. If you select WebSphere Application Server Network Deployment Edition, skip to step 33. WebSphere Application Server (Base). You install Data Analyzer on an existing WebSphere Application Server Base Edition instance. If you select WebSphere Application Server Base Edition, skip to step 31.
19.
Click Next.
180
20. 21.
Select the option to install a new instance of JBoss Application Server or to use an existing instance. Enter the home directory and the server configuration directory for JBoss Application Server or click Browse to select the directory. If you install a new instance of JBoss Application Server, the installer creates a server configuration in the directory you provide. If you use an existing instance of JBoss Application Server, you must provide the directory for an existing server configuration. The server configuration must support all available JBoss services.
22.
181
You can configure the ports used by the JBoss Application Server to avoid port conflicts if you run multiple instances of JBoss Application Server on the same machine.
23. 24.
182
26.
Choose to install Data Analyzer on a new domain or an existing domain. Provide the domain name and location. If you are installing Data Analyzer on a new WebLogic domain, continue to the next step. If you are installing on an existing WebLogic domain, skip to step 29.
183
27.
28. 29.
Enter the account name and password for the WebLogic Administration Console and the listening port number for the new domain. Skip to step 37. Click Next. The Existing WebLogic Server Domain Configuration window appears.
The installer will install Data Analyzer on an existing WebLogic domain in WebLogic Server.
184 Chapter 7: PowerCenter Custom Installation in Graphical Mode
30. 31.
Enter the account name and password for the WebLogic Administration Console for the existing domain. Skip to step 37. Click Next. The Existing WebSphere Application Server Directory window appears.
32. 33.
Enter the home directory for WebSphere Base Server or click Browse to locate the directory. Skip to step 35. Click Next.
185
34. 35.
Enter the home directories for the WebSphere Base Server and Network Deployment or click Browse to locate the directory. Click Next. The WebSphere Application Server Administration Details window appears.
186
36.
37.
Click Next. The Pre-Installation Summary page appears. Review the pre-installation summary to verify that the installer will install Data Analyzer components in the correct location and with the options you select.
38.
Click Install to continue or click Previous to modify the options. After you click Install, the installer copies the files for Data Analyzer to the installation directory. If you selected an existing instance of JBoss Application Server, or you selected WebLogic Server or WebSphere Application Server, the Data Analyzer and Metadata Manager Authentication window appears.
Note: WebLogic Server and WebSphere Application Server support only one
authentication method for all applications running on the same instance of the application server.
Installing Data Analyzer 187
39.
Select Yes to overwrite the authentication in the application server with repository authentication. The new authentication settings will overwrite the security settings on the application server. -orSelect No to keep the current authentication settings in the application server. If you select No, the application server must be configured with an authentication method that is compatible with Data Analyzer. Otherwise, you cannot log in to Data Analyzer. If you install Data Analyzer on WebSphere Application Server, the installer configures WebSphere Application Server security and Data Analyzer authentication based on your selection and the WebSphere Application Server setup. Table 7-2 describes the configuration tasks performed by the installer when you install Data Analyzer on WebSphere Application Server:
Table 7-2. WebSphere Application Server Security and Repository Authentication
WebSphere Security Enabled? Yes Configure Repository Authentication? Yes
Installer Action The installer changes the existing WebSphere Application Server Console administrator user name to admin and the password to admin and configures repository authentication for Data Analyzer. The installer leaves WebSphere Application Server Console security settings intact and does not change the administrator user name and password. The installer does not configure repository authentication. The installer enables the WebSphere Application Server Console security and sets the administrator user name to admin and the password to admin. The installer configures repository authentication for Data Analyzer. The installer does not enable WebSphere Application Server Console security and does not configure repository authentication for Data Analyzer.
Yes
No
No
Yes
No
No
For more information about configuring authentication, see Configuring Authentication in the Data Analyzer Administrator Guide.
40.
Click Next. The installer displays a message about the application server configuration tasks performed by the installer. Click Cancel to return to the Data Analyzer and Metadata Manager Authentication window. Otherwise, click Continue to continue with the installation.
41.
Click Next.
188
42.
Select whether to use a new or existing Data Analyzer repository. To create a Data Analyzer repository during the installation, select Create new Data Analyzer repository. To use an existing Data Analyzer repository, select Use Existing Data Analyzer repository content.
43.
Select a database type and enter the database information for the Data Analyzer repository. Table 7-3 describes the information required for the Data Analyzer repository:
Table 7-3. Data Analyzer Repository Information
Option Database type Database URL Description Type of database for the Data Analyzer repository. Database connection string. When you select the database type, the Data Analyzer Repository Configuration window displays the database URL format for the selected database type: Oracle: host_name:port_number;SID=sid DB2:host_name:port_number;DatabaseName=databasename Microsoft SQL Server:
host_name:port_number;SelectMethod=cursor;DatabaseName=databasename Sybase ASE: host_name:port;DatabaseName=database_name
For more information about the JDBC drivers installed withPowerCenter, see JDBC Drivers on page 553. Database user ID Database password Name of the user account to connect to the repository database. Password for the user account to connect to the database.
189
44.
Click Test Connection to verify the database connection. The installer verifies that the database connection is valid. If the connection fails, an error message indicates the reason for the failure. You can continue the installation if the connection is valid.
45.
Click Next. The installer configures the Data Analyzer repository and configures and starts the application server. The PowerCenter Installation Summary window indicates whether the installation completed successfully. It also shows the configured properties for Data Analyzer components and the status of installed components.
46.
Click Done. You can view the log files generated by the installer to obtain more information about the installation tasks performed by the installer and view configuration properties for the installed components. For more information about the log files generated by the installer, see Installer Log Files on page 362.
190
Verify that your environment meets the minimum system requirements, and complete the pre-installation tasks. For more information about preparing for the PowerCenter installation, see Before You Install on page 49.
2. 3. 4.
Log in to the machine as the system user. Close all other applications before running the installation. To start the installer on Windows, insert the DVD into the DVD drive. If the installer does not start or if you are installing PowerCenter from a hard disk, run install.exe from the DVD root directory or the root directory in the location where you downloaded the installer. -orTo start the installer on UNIX, run install.sh at a shell command line from the DVD root directory or the root directory in the location where you downloaded the installer. On UNIX, the PowerCenter installer checks the operating system and verifies that the environment variables are correctly set. The environment variables must be specifically set to enable the PowerCenter installer to run processes and connect to databases and services. If the environment variables are not set, the PowerCenter installer gives you the option to stop the installation and modify the environment variables.
5. 6.
On UNIX, select the option to use the GUI mode installation. On the main PowerCenter installation window, select Server. The Welcome window introduces the PowerCenter installation.
7.
Click Next.
191
On UNIX, the PowerCenter installer requires specific environment variable settings. Read the PowerCenter environment configuration requirements and set the environment variables before you continue the installation. If you do not set the environment variables as required, the PowerCenter installation may fail.
8.
192
9. 10.
Enter the location and file name of the PowerCenter Advanced Edition license key or click Browse to locate the license key file. Click Next. The Installation Prerequisites window displays the supported platforms and databases and the disk space requirements. Make sure that all PowerCenter installation requirements are met before you continue the installation.
11.
Click Next. The Installation Set window displays the PowerCenter Advanced Edition installation options.
12.
To select the PowerCenter components to install, select Custom and click Next.
193
13.
To install Metadata Manager, clear all options except Metadata Manager and click Next. The Data Analyzer/Metadata Manager License Key window appears.
14. 15.
Enter the location and file name of the Metadata Manager license key or click Browse to locate the license key file. Click Next.
194
16.
Use the default directory or click Browse to select a directory. The default directory on Windows is C:\Informatica\PowerCenter8.1.1, The default directory on UNIX is $HOME/Informatica/PowerCenter8.1.1, where HOME is the user home directory. The installation directory path must be an absolute path. On Windows, the installation directory path must be located on the current machine. If the installation directory contains a PowerCenter Services installation, you cannot install Metadata Manager in the directory.
17.
Click Next.
195
18.
Select the application server to install Metadata Manager on. You can select one of the following options:
JBoss Application Server. You can install Metadata Manager on a new or existing instance of JBoss Application Server. If you select JBoss Application Server, continue to the next step. BEA WebLogic Server. You can install Metadata Manager on BEA WebLogic Server. You can create a new WebLogic Server domain with the installer or install Metadata Manager on an existing WebLogic Server domain. If you select WebLogic Server, skip to step 24. WebSphere Application Server (Network Deployment). You install Metadata Manager on an existing WebSphere Application Server Network Deployment Edition instance. If you select WebSphere Application Server Network Deployment Edition, skip to step 33. WebSphere Application Server (Base). You install Metadata Manager on an existing WebSphere Application Server Base Edition instance. If you select WebSphere Application Server Base Edition, skip to step 31.
19.
Click Next.
196
20. 21.
Select the option to install a new instance of JBoss Application Server or to use an existing instance. Enter the home directory and the server configuration directory for JBoss Application Server or click Browse to select the directory. If you install a new instance of JBoss Application Server, the installer creates a server configuration in the directory you provide. If you use an existing instance of JBoss Application Server, you must provide the directory for an existing server configuration. The server configuration must support all available JBoss services.
22.
197
You can configure the ports used by the JBoss Application Server to avoid port conflicts if you run multiple instances of JBoss Application Server on the same machine.
23. 24.
198
26.
Choose to install Metadata Manager on a new domain or an existing domain. Provide the domain name and location. If you are installing Metadata Manager on a new WebLogic domain, continue to the next step. If you are installing on an existing WebLogic domain, skip to step 29.
199
27.
28. 29.
Enter the account name and password for the WebLogic Administration Console and the listening port number for the new domain. Skip to step 37. Click Next. The Existing WebLogic Server Domain Configuration window appears.
The installer will install Metadata Manager on an existing WebLogic domain in WebLogic Server.
200 Chapter 7: PowerCenter Custom Installation in Graphical Mode
30. 31.
Enter the account name and password for the WebLogic Administration Console for the existing domain. Skip to step 37. Click Next. The Existing WebSphere Application Server Directory window appears.
32. 33.
Enter the home directory for WebSphere Base Server or click Browse to locate the directory. Skip to step 35. Click Next.
201
34. 35.
Enter the home directories for the WebSphere Base Server and the Network Deployment or click Browse to locate the directory. Click Next. The WebSphere Application Server Administration Details window appears.
202
36.
37.
Click Next. The Pre-Installation Summary page appears. Review the pre-installation summary to verify that the installer will install Metadata Manager components in the correct location and with the options you select.
38.
Click Install to continue or click Previous to modify the options. After you click Install, the installer copies the Metadata Manager files to the installation directory. When the file copy process completes, the Configure Domain window appears.
The installer creates the Repository Service and Integration Service for the PowerCenter repository for Metadata Manager on the gateway node for the domain.
203
39.
40.
41.
Select whether to use a new or existing PowerCenter repository. To create a PowerCenter repository during the installation, select Create new PowerCenter Repository. To use an existing PowerCenter repository, select Use existing PowerCenter repository content.
42.
Select a database type and enter the database information for the PowerCenter repository. The PowerCenter Repository Configuration window requires different information based on the database type you select.
204
Table 7-4 describes the configuration information required for the repository:
Table 7-4. PowerCenter Repository Information
Option Repository name Code page Description Name for the PowerCenter repository. The name is case sensitive, must be less than 30 character and cannot contain spaces or the following characters: \/:*?<>| Repository code page. The Repository Service uses the character set encoded in the repository code page when it writes data to the repository. Choose a code page that is compatible with the code page of the machine where you install PowerCenter. For more information about code pages, see Code Pages on page 45. The Integration Service created during installation uses the same code page as the Repository Service. Verify that the code page for the Repository Service is compatible with the machine where the services are created. Note: The installer includes a generic list of code pages for the PowerCenter repository. Verify that the code page you select is available on the gateway node for the domain. If you select an existing repository, the code page must also be compatible with the repository. If you select an invalid code page, the installation will fail. Type of database for the PowerCenter repository. Name of the user account to connect to the repository database. Password for the user account to connect to the database. Use 7-bit ASCII. Appears for Oracle, Microsoft SQL Server, and Sybase ASE databases only. Native connect string to access the repository database. Use the syntax appropriate for the selected database: - Oracle: Same syntax as the TNSNAMES entry: aliasname.world. Microsoft SQL Server: Syntax is SQLServername@dbname, where SQLServername is the name of the SQL Server instance that contains the dbname database. - Sybase ASE: Syntax is servername@dbname, where servername is the name of the Adaptive Server from the interfaces file. Appears for DB2 database only. DB2 alias name for the repository database. Appears for DB2 database only. Name of the tablespace in which to create the repository tables. If blank, the installation creates the repository tables in the default tablespace.
Click Test Connection to verify the database connection. The installer verifies that the database connection is valid. If the connection fails, an error message indicates the reason for the failure. You can continue the installation if the connection is valid.
44.
Click Next.
205
Choose the data movement mode. The data movement mode must match the data movement mode of the associated PowerCenter repository for Metadata Manager.
45.
User name
Password 46.
Click Next.
206
If you selected an existing instance of JBoss Application Server, or you selected WebLogic Server or WebSphere Application Server, the Data Analyzer and Metadata Manager Authentication window appears.
Note: WebLogic Server and WebSphere Application Server support only one
authentication method for all applications running on the same instance of the application server.
47.
Select Yes to overwrite the authentication in the application server with repository authentication. The new authentication settings will overwrite the security settings on the application server. -orSelect No to keep the current authentication settings in the application server. If you select No, the application server must be configured with an authentication method that is compatible with Data Analyzer and Metadata Manager. Otherwise, you cannot log in to Data Analyzer or Metadata Manager. If you install Data Analyzer or Metadata Manager on WebSphere Application Server, the installer configures WebSphere Application Server security and Data Analyzer or Metadata Manager authentication based on your selection and the WebSphere Application Server setup.
207
Table 7-5 describes the configuration tasks performed by the installer when you install Metadata Manager on WebSphere Application Server:
Table 7-5. WebSphere Application Server Security and Repository Authentication
WebSphere Security Enabled? Yes Configure Repository Authentication? Yes
Installer Action The installer changes the existing WebSphere Application Server Console administrator user name to admin and the password to admin and configures repository authentication for Metadata Manager. The installer leaves WebSphere Application Server Console security settings intact and does not change the administrator user name and password. The installer does not configure repository authentication. The installer enables the WebSphere Application Server Console security and sets the administrator user name to admin and the password to admin. The installer configures repository authentication for Metadata Manager. The installer does not enable WebSphere Application Server Console security and does not configure repository authentication for Data Analyzer.
Yes
No
No
Yes
No
No
For more information about configuring authentication, see Managing Authentication for Metadata Manager in the Metadata Manager Administrator Guide.
48.
Click Next. The installer displays a message about the application server configuration tasks performed by the installer. Click Cancel to return to the Data Analyzer and Metadata Manager Authentication window. Click Continue to continue with the installation.
208
49.
Select whether to use a new or existing Metadata Manager repository. To create a Metadata Manager repository during the installation, select Create new Metadata Manager repository. To use an existing Metadata Manager repository, select Use existing Metadata Manager repository content.
50.
Select a database type and enter the database information for the Metadata Manager repository. Table 7-6 describes the information required for the Metadata Manager repository:
Table 7-6. Metadata Manager Repository Information
Option Database type Database URL Description Type of database for the Metadata Manager repository. Database connection string. When you select the database type, the Metadata Manager Repository Configuration window displays the database URL format for the selected database type: Oracle: host_name:port_number;SID=sid DB2:host_name:port_number;DatabaseName=databasename Microsoft SQL Server:
host_name:port_number;SelectMethod=cursor;DatabaseName=database name Sybase ASE: host_name:port;DatabaseName=database_name
For more information about the JDBC drivers installed withPowerCenter, see JDBC Drivers on page 553. Database user ID Database password Name of the user account to connect to the repository database. Password for the user account to connect to the database.
209
51.
Click Test Connection to verify the database connection. The installer verifies that the database connection is valid. If the connection fails, an error message indicates the reason for the failure. You can continue the installation if the connection is valid.
52.
Click Next. The installer configures Metadata Manager and the application server, configures the Metadata Manager repository, and starts the application server. The PowerCenter Installation Summary window indicates whether the installation completed successfully. It also shows the configured properties for Metadata Manager components and the status of installed components.
53.
Click Done.
You can view the log files generated by the installer to obtain more information about the installation tasks performed by the installer and view configuration properties for the installed components. For more information about the log files generated by the installer, see Installer Log Files on page 362.
210
Chapter 8
Overview, 212 Installing PowerCenter Standard Edition, 213 Installing PowerCenter Advanced Edition, 224
211
Overview
This chapter provides instructions on running the PowerCenter console mode installer and installing the complete version of PowerCenter. When you install the complete version of PowerCenter, the PowerCenter installer determines the components available for installation based on the license key you provide. The console mode installer is similar to the graphical mode installer. Each panel in the console mode installer prompts you for the same information as each window in the graphical mode installer. Before you install PowerCenter, complete the steps listed in Pre-Installation Tasks on page 50. You can install the complete version of the following PowerCenter editions:
PowerCenter Standard Edition. Installs all PowerCenter Standard Edition components. Standard Edition includes PowerCenter and Data Analyzer for PowerCenter Repository Reports. For more information, see Installing PowerCenter Standard Edition on page 213. PowerCenter Advanced Edition. Installs all PowerCenter Advanced components, including PowerCenter Services, Data Analyzer, and Metadata Manager. For more information, see Installing PowerCenter Advanced Edition on page 224.
After you run the installer, complete the installation or upgrade of PowerCenter components. For more information, see the steps for your installation or upgrade path in Installation and Upgrade Overview on page 15.
Each panel in the installer prompts for configuration information. After the installer collects the information and configures PowerCenter, you may not be able to return to a previous step. After you install, you can change the PowerCenter services settings in the Administration Console.
Each prompt displays default values. You can press Enter to accept default values or enter configuration information at the prompt to change the default value. To enter multiple values in a prompt that accepts multiple values, separate values with commas. Enter quit at any time to quit the installer. Passwords are not encrypted at the prompt. If you enter a value for an optional property, such as an IBM DB2 tablespace name, the installer uses it as the default value if you return to the panel. If you do not want to use the value you entered, you can remove the default value by entering a space for the property.
212
Verify that your environment meets the minimum system requirements, and complete the pre-installation tasks. For more information about preparing for the PowerCenter installation, see Before You Install on page 49.
2. 3. 4.
Log in to the machine as the system user. Close all other applications before running the installation. On a shell command line, run install.sh located in the DVD root directory or the root directory in the location where you downloaded the installer. The PowerCenter installer checks the operating system and verifies that the environment variables are correctly set. The environment variables must be specifically set to enable the PowerCenter installer to run processes and connect to databases and services. If the environment variables are not set, the PowerCenter installer gives you the option to stop the installation and modify the environment variables.
5.
Select the option to use the Console mode installation. The Welcome panel introduces the PowerCenter installation.
6.
Press Enter. The Configure Environment Variables panel appears. The PowerCenter installer requires specific environment variable settings. Read the PowerCenter environment configuration requirements and set the environment variables before you continue with the installation. If you do not set the environment variables as required, the PowerCenter installation may fail.
7.
Enter quit to exit the installer if the required environment variables are not set. -orPress Enter to continue with the installation. The PowerCenter License Key panel appears.
8. 9.
Enter the location and file name of the PowerCenter Standard Edition license key. Press Enter. The Installation Prerequisites panel displays the supported platforms and databases and the disk space requirements. Verify that all PowerCenter installation requirements are met before you continue the installation.
213
10.
Press Enter. The Installation Set panel displays the PowerCenter installation options.
11.
To install the complete set of PowerCenter Standard Edition components, press Enter. The Data Analyzer/Metadata Manager License Key panel appears.
12. 13.
Enter the location and file name of the Data Analyzer license key. Press Enter. The Installation Directory panel appears. Use the default directory or enter the path to a directory. The default directory on UNIX is $HOME/Informatica/PowerCenter8.1.1, where HOME is the user home directory. The installation directory path must be an absolute path.
14.
Press Enter. The Application Server panel appears. Select the application server to install Data Analyzer on to run PowerCenter Repository Reports.
15.
16.
17.
214
18. 19.
Press Enter. Enter the home directory for JBoss Application Server. If you install a new instance of JBoss Application Server, the installer creates a server configuration in the directory you provide. If you use an existing instance of JBoss Application Server, you must provide the directory for an existing server configuration. The server configuration must support all available JBoss services.
Press Enter. Enter the server configuration directory. Press Enter. To configure the JBoss Application Server ports, enter Y at the prompt and enter the values for the JBoss Application Server ports. Enter N to accept the default values. You can configure the ports used by the JBoss Application Server to avoid port conflicts if you run multiple instances of JBoss Application Server on the same machine. Table 8-1 describes the JBoss Application Server ports and the default port values:
Table 8-1. JBoss Application Server Default Port Values
Port Name HTTP Connector Port JBoss MQ Service Port IIOP Port JMS Server Port Web Service Port RMI Services Bind Address Port RMI Invoker Port JRMP Invoker Port HA-JNDI Stub Availability JRMP Invoker Port for cluster UDP Binding Port SNMP Adaptor Port SNMP Manager Port Tomcat Cluster Port Default Port 8080 8093 3538 1099 8093 1098 4444 4445 1100 4446 45566 1161 1162 40000-50000
Press Enter.
215
Enter the existing WebLogic Server directory. Press Enter. The WebLogic Application Server Domain panel appears.
27.
28.
Enter the WebLogic domain name and location. If you are installing Data Analyzer on a new WebLogic domain, continue to the next step. If you are installing on an existing WebLogic domain, skip to step 31.
29.
30. 31.
Enter the account name and password for the WebLogic Administration Console and the listening port number for the new domain. Skip to step 39. Press Enter. The Existing WebLogic Server Domain Configuration panel appears.
32. 33.
Enter the account name and password for the WebLogic Administration Console for the existing domain. Skip to step 39. Press Enter. The Existing WebSphere Application Server Directory panel appears.
34. 35.
Enter the home directory for the WebSphere Base Server. Skip to step 37. Press Enter. The Existing WebSphere Application Server Directory panel appears.
36. 37.
Enter the home directories for the WebSphere Base Server and the Network Deployment. Press Enter. The WebSphere Application Server Administration Details panel appears.
38.
216
Description Name of the server to run Data Analyzer on. Default is server1. Port number for the WebSphere Application Server server. Default is 9080. Name of the WebSphere node. This is not a PowerCenter node name. Default is machine name.
39.
Press Enter. The Pre-Installation Summary panel appears. Review the pre-installation summary to verify that the installer will install PowerCenter components in the correct location and with the options you select.
40.
Press Enter to continue or enter back to return and modify the options. The installer copies the files for the selected components to the installation directory. When the file copy process completes, the Create or Join Domain panel appears.
41.
For more information about the available domain options, see Single or Multiple Machine Installation on page 17.
42.
Press Enter. The Configure Domain Database panel appears. PowerCenter stores the PowerCenter domain configuration in a relational database. The domain configuration database must be accessible by all gateway nodes in the domain.
43.
217
Description Password for the domain configuration database user account. Service name for Oracle and IBM DB2 databases or database name for Microsoft SQL Server or Sybase ASE databases.
44.
45.
To configure the range of available ports that the PowerCenter installer can use for the PowerCenter Services that it installs on the node, enter Y at the prompt and enter the range of available ports. To accept the default values, enter N. The default range for the port numbers is 6005 - 6105. Skip to step 52.
47.
Press Enter. The Configure Domain panel appears. The PowerCenter domain that you want to join must be available when you join the domain. Verify that the gateway node for the domain you want to join is available before
218
you continue. If the PowerCenter installer cannot connect to the PowerCenter domain, you cannot continue with the installation.
48.
49.
50.
Port number
To configure the range of available ports that the PowerCenter installer can use for the PowerCenter Services that it installs on the node, enter Y at the prompt and enter the range of available ports. To accept the default values, enter N. The default range for the port numbers is 6005 - 6105.
52.
219
53.
To use existing PowerCenter repository content, you may need to upgrade the repository after installing PowerCenter.
54.
Press Enter. The Configure PowerCenter Repository panel requires different information based on the database type you select. Table 8-2 describes the configuration information required for the repository:
Table 8-2. PowerCenter Repository Information
Prompt Repository name Description Name for the PowerCenter repository. The name is case sensitive and must be less than 30 characters. The repository name cannot contain spaces or the following characters: \ / : *?><"| Repository code page. The Repository Service uses the character set encoded in the repository code page when it writes data to the repository. Choose a code page that is compatible with the code page of the machine where you install PowerCenter. For more information about code pages, see Code Pages on page 45. If you use an existing PowerCenter repository, the PowerCenter installer does not validate the repository code page. You must verify that the code page for the existing repository is compatible with the code page of the machine where you install PowerCenter. The Integration Service created during installation uses the same code page as the Repository Service. Verify that the code page for the Repository Service is compatible with the machine where the services are created. Type of database for the PowerCenter repository. Name of the user account to connect to the repository database. Password for the user account to connect to the database. Use 7-bit ASCII. Appears for Oracle and Sybase ASE databases only. Native connect string to access the repository database. Use the syntax appropriate for the selected database: - Oracle: Same syntax as the TNSNAMES entry: aliasname.world. - Sybase ASE: Syntax is servername@dbname, where servername is the name of the Adaptive Server from the interfaces file. Appears for DB2 database only. DB2 alias name for the repository database. Appears for DB2 database only. Name of the tablespace in which to create the repository tables. If blank, the installation creates the repository tables in the default tablespace.
Code page
Press Enter.
220
The installer verifies that the database connection is valid. If the connection fails, an error message displays the reason for the failure. You can continue the installation if the connection is valid. The Configure Integration Service panel appears. Choose the data movement mode. The data movement mode must match the data movement mode of the associated PowerCenter repository.
56.
Press Enter. If you selected an existing instance of JBoss Application Server, or you selected WebLogic Server or WebSphere Application Server, the Data Analyzer and Metadata Manager Authentication panel appears.
Note: WebLogic Server and WebSphere Application Server support one authentication
method for all applications running on the same instance of the application server.
58.
Enter Y to overwrite the authentication in the application server with repository authentication. The new authentication settings will overwrite the security settings on the application server. -orEnter N to keep the current authentication settings in the application server. If you select No, the application server must be configured with an authentication method that is compatible with Data Analyzer. Otherwise, you cannot log in to Data Analyzer. If you install Data Analyzer on WebSphere Application Server, the installer configures WebSphere Application Server security and Data Analyzer authentication based on your selection and the WebSphere Application Server setup.
221
Table 8-3 describes the configuration tasks performed by the installer when you install Data Analyzer on WebSphere Application Server:
Table 8-3. WebSphere Application Server Security and Repository Authentication
WebSphere Security Enabled? Yes Configure Repository Authentication? Yes
Installer Action The installer changes the existing WebSphere Application Server Console administrator user name to admin and the password to admin and configures repository authentication for Data Analyzer. The installer leaves WebSphere Application Server Console security settings intact and does not change the administrator user name and password. The installer does not configure repository authentication. The installer enables the WebSphere Application Server Console security and sets the administrator user name to admin and the password to admin. The installer configures repository authentication for Data Analyzer. The installer does not enable WebSphere Application Server Console security and does not configure repository authentication for Data Analyzer.
Yes
No
No
Yes
No
No
For more information about configuring authentication, see Configuring Authentication in the Data Analyzer Administrator Guide.
59.
Press Enter. The installer displays a message about the application server configuration tasks performed by the installer.
60.
Enter N to return to the Data Analyzer and Metadata Manager Authentication panel. -orEnter Y to continue with the installation. The Data Analyzer Repository Configuration panel appears.
61.
To use existing Data Analyzer repository content, you may need to upgrade the repository after installation.
62. 63.
222
Table 8-4 describes the information required for the Data Analyzer repository:
Table 8-4. Data Analyzer Repository Information
Option Database type Database URL Description Type of database for the Data Analyzer repository. Enter the appropriate number for the repository database type. Database connection string. Use the following format: Oracle: host_name:port_number;SID=sid DB2:host_name:port_number;DatabaseName=databasename Microsoft SQL Server:
host_name:port_number;SelectMethod=cursor;DatabaseName=databasename Sybase ASE: host_name:port;DatabaseName=database_name
Name of the user account to connect to the repository database. Password for the user account to connect to the database.
Press Enter. The installer verifies that the database connection is valid. If the connection fails, an error message displays the reason for the failure. You can continue the installation if the connection is valid. The installer configures Data Analyzer and the application server, starts the application server, and configures the Data Analyzer repository. The PowerCenter Installation Summary panel indicates whether the installation completed successfully. It also shows the configured properties for PowerCenter components and the status of installed components.
65.
Press Enter.
You can view the log files generated by the installer to get more information about the installation tasks performed by the installer and view configuration properties for the installed components. For more information about the log files generated by the installer, see Installer Log Files on page 362.
223
Verify that your environment meets the minimum system requirements, and complete the pre-installation tasks. For more information about preparing for the PowerCenter installation, see Before You Install on page 49.
2. 3. 4.
Log in to the machine as the system user. Close all other applications before running the installation. On a shell command line, run install.sh located in the DVD root directory or the root directory in the location where you downloaded the installer. The PowerCenter installer checks the operating system and verifies that the environment variables are correctly set. The environment variables must be specifically set to enable the PowerCenter installer to run processes and connect to databases and services. If the environment variables are not set, the PowerCenter installer gives you the option to stop the installation and modify the environment variables.
5.
Select the option to use the Console mode installation. The Welcome panel introduces the PowerCenter installation.
6.
Press Enter. The Configure Environment Variables panel appears. The PowerCenter installer requires specific environment variable settings. Read the PowerCenter environment configuration requirements and set the environment variables before you continue with the installation. If you do not set the environment variables as required, the PowerCenter installation may fail.
7.
Enter quit to exit the installer if the required environment variables are not set. -orIf the environment variables are set, press Enter. The PowerCenter License Key panel appears.
8. 9.
Enter the location and file name of the PowerCenter Advanced Edition license key. Press Enter.
224
The Installation Prerequisites panel displays the supported platforms and databases and the disk space requirements. Verify that all PowerCenter installation requirements are met before you continue the installation.
10.
Press Enter. The Installation Set panel displays the PowerCenter installation options.
11.
To install the complete set of PowerCenter Advanced Edition components, press Enter. The Data Analyzer/Metadata Manager License Key panel appears.
12. 13.
Enter the location and file name of the Data Analyzer license key. Press Enter. The Installation Directory panel appears. Use the default directory or enter the path to a directory. The default directory on UNIX is $HOME/Informatica/PowerCenter8.1.1, where HOME is the user home directory. The installation directory path must be an absolute path.
14.
Press Enter. The Application Server panel appears. Select the application server to install Data Analyzer and Metadata Manager on. The installer installs Data Analyzer and Metadata Manager on the same application server.
15.
3 - IBM WebSphere Application Server (Network Deployment) 4 - IBM WebSphere Application Server (Base) 16.
225
17.
18. 19.
Press Enter. Enter the home directory for JBoss Application Server. If you install a new instance of JBoss Application Server, the installer creates a server configuration in the directory you provide. If you use an existing instance of JBoss Application Server, you must provide the directory for an existing server configuration. The server configuration must support all available JBoss services.
Press Enter. Enter the server configuration directory. To configure the JBoss Application Server ports, enter Y at the prompt and enter the values for the JBoss Application Server ports. Enter N to accept the default values. You can configure the ports used by the JBoss Application Server to avoid port conflicts if you run multiple instances of JBoss Application Server on the same machine. Table 8-5 describes the JBoss Application Server ports and the default port values:
Table 8-5. JBoss Application Server Default Port Values
Port Name HTTP Connector Port JBoss MQ Service Port IIOP Port JMS Server Port Web Service Port RMI Services Bind Address Port RMI Invoker Port JRMP Invoker Port HA-JNDI Stub Availability JRMP Invoker Port for cluster UDP Binding Port SNMP Adaptor Port Default Port 8080 8093 3538 1099 8093 1098 4444 4445 1100 4446 45566 1161
226
24. 25.
Enter the existing WebLogic Server directory. Press Enter. The WebLogic Application Server Domain panel appears.
26.
27.
Enter the WebLogic domain name and location. If you are installing Data Analyzer on a new WebLogic domain, continue to the next step. If you are installing on an existing WebLogic domain, skip to step 30.
28.
29.
Enter the account name and password for the WebLogic Administration Console and the listening port number for the new domain. Skip to step 38.
30.
Press Enter. The Existing WebLogic Server Domain Configuration panel appears.
31. 32.
Enter the account name and password for the WebLogic Administration Console for the existing domain. Skip to step 38. Press Enter. The Existing WebSphere Application Server Directory panel appears.
33. 34.
Enter the home directory for the WebSphere Base Server. Skip to step 36. Press Enter. The Existing WebSphere Application Server Directory panel appears.
227
35. 36.
Enter the home directories for the WebSphere Base Server and the Network Deployment. Press Enter. The WebSphere Application Server Administration Details panel appears.
37.
38.
Press Enter. The Pre-Installation Summary panel appears. Review the pre-installation summary to verify that the installer will install PowerCenter components in the correct location and with the options you select. Press Enter to continue or enter back to return and modify the options. After you press Enter, the installer copies the files for PowerCenter Advanced Edition to the installation directory. When the file copy process completes, the Create or Join Domain panel appears.
39.
For more information about the available domain options, see Single or Multiple Machine Installation on page 17.
40.
Press Enter. The Configure Domain Database panel appears. PowerCenter stores the PowerCenter domain configuration in a relational database. The domain configuration must be accessible by all gateway nodes in the domain.
228
41.
42.
43.
Note: By default, the installer creates a Repository Service and Integration Service for
Metadata Manager in the PowerCenter domain. You can create a separate Repository Service and Integration Service for the PowerCenter repository after you complete the installation.
229
44.
To set the range of port numbers that the PowerCenter installer can use for the PowerCenter services on the node, enter Y at the prompt and enter the range of available ports. Enter N to accept the default values. The default range for the port numbers is 6005 - 6105. Skip to step 52 to continue with the installation.
45.
Press Enter. The Configure Domain panel appears. The PowerCenter domain must be available. Verify that the gateway node for the domain you want to join is available before you continue. If the PowerCenter installer cannot connect to the PowerCenter domain, you cannot continue with the installation.
46.
47.
48.
Port number
To set the range of port numbers that the PowerCenter installer can use for the PowerCenter services on the node, enter Y at the prompt and enter the range of available ports. Enter N to accept the default values.
230
51.
52.
Press Enter. The PowerCenter Repository Configuration panel requires different information based on the database type you select. Table 8-6 describes the configuration information required for the repository:
Table 8-6. PowerCenter Repository Information
Prompt Repository name Code page Description Name for the PowerCenter repository. The name is case sensitive, must be less than 30 character and not contain the following characters: \/:*?<>| Repository code page. The Repository Service uses the character set encoded in the repository code page when it writes data to the repository. Choose a code page that is compatible with the code page of the machine where you install PowerCenter. If you use an existing PowerCenter repository, the PowerCenter installer does not validate the repository code page. You must verify that the code page for the existing repository is compatible with the code page of the machine where you install PowerCenter. The Integration Service created during installation uses the same code page as the Repository Service. Verify that the code page for the Repository Service is compatible with the machine where the services are created. Note: If you join a domain, the installer creates the Repository Service for the PowerCenter repository for Metadata Manager on the gateway node for the domain. The installer includes a generic list of code pages for the PowerCenter repository. Verify that the code page you select is available on the gateway node for the domain you are joining. Type of database for the PowerCenter repository. Name of the user account to connect to the repository database. Password for the user account to connect to the database. Use 7-bit ASCII. Appears for Oracle and Sybase ASE databases only. Native connect string to access the repository database. Use the syntax appropriate for the selected database: - Oracle: Same syntax as the TNSNAMES entry: aliasname.world. - Sybase ASE: Syntax is servername@dbname, where servername is the name of the Adaptive Server from the interfaces file.
231
Press Enter. The installer verifies that the database connection is valid. If the connection fails, an error message displays the reason for the failure. You can continue the installation if the connection is valid.
54.
Press Enter. The Configure Integration Service panel appears. Choose the data movement mode. The data movement mode must match the data movement mode of the associated PowerCenter repository for Metadata Manager.
55.
User name
Password 56.
Press Enter. If you selected an existing instance of JBoss Application Server, or you selected WebLogic Server or WebSphere Application Server, the Data Analyzer and Metadata Manager Authentication panel appears.
Note: WebLogic Server and WebSphere Application Server support one authentication
method for all applications running on the same instance of the application server.
57.
Enter Y to overwrite the authentication in the application server with repository authentication. The new authentication settings will overwrite the security settings on the application server. -orEnter N to keep the current authentication settings in the application server. If you select No, the application server must be configured with an authentication method that is compatible with Data Analyzer and Metadata Manager. Otherwise, you cannot log in to Data Analyzer or Metadata Manager.
232
If you install Data Analyzer or Metadata Manager on WebSphere Application Server, the installer configures WebSphere Application Server security and Data Analyzer or Metadata Manager authentication based on your selection and the WebSphere Application Server setup. Table 8-7 describes the configuration tasks performed by the installer when you install Data Analyzer and Metadata Manager on WebSphere Application Server:
Table 8-7. WebSphere Application Server Security and Repository Authentication
WebSphere Security Enabled? Yes Configure Repository Authentication? Yes
Installer Action The installer changes the existing WebSphere Application Server Console administrator user name to admin and the password to admin and configures repository authentication for Data Analyzer and Metadata Manager. The installer leaves WebSphere Application Server Console security settings intact and does not change the administrator user name and password. The installer does not configure repository authentication. The installer enables the WebSphere Application Server Console security and sets the administrator user name to admin and the password to admin. The installer configures repository authentication for Data Analyzer and Metadata Manager. The installer does not enable WebSphere Application Server Console security and does not configure repository authentication for Data Analyzer and Metadata Manager.
Yes
No
No
Yes
No
No
For more information about configuring authentication, see Configuring Authentication in the Data Analyzer Administrator Guide and Managing Authentication for Metadata Manager in the Metadata Manager Administrator Guide.
58.
Press Enter. The installer displays a message about the application server configuration tasks performed by the installer.
59.
Enter N to return to the Data Analyzer and Metadata Manager Authentication panel. -orEnter Y to continue with the installation. The Data Analyzer Repository Configuration panel appears.
60.
233
To use existing Data Analyzer repository content, you may need to upgrade the repository after installation.
61. 62.
Press Enter. Enter the Data Analyzer repository configuration information. Table 8-8 describes the information required for the Data Analyzer repository:
Table 8-8. Data Analyzer Repository Information
Option Database type Database URL Description Type of database for the Data Analyzer repository. Enter the appropriate number for the repository database type. Database connection string. Use the following format: Oracle: host_name:port_number;SID=sid DB2:host_name:port_number;DatabaseName=databasename Microsoft SQL Server:
host_name:port_number;SelectMethod=cursor;DatabaseName=databasename Sybase ASE: host_name:port;DatabaseName=database_name
Name of the user account to connect to the repository database. Password for the user account to connect to the database.
Press Enter. The installer verifies that the database connection is valid. If the connection fails, an error message displays the reason for the failure. You can continue the installation if the connection is valid. The Metadata Manager Repository Configuration panel appears.
64.
To use existing Metadata Manager repository content, you may need to upgrade the repository after installation.
65.
234
Table 8-9 describes the information required for the Metadata Manager repository:
Table 8-9. Metadata Manager Repository Information
Prompt Database Type Database URL Description Type of database for the Metadata Manager repository. Enter the appropriate number for the repository database type. Database connection string. Use the following syntax: Oracle: host_name:port_number;SID=sid DB2:host_name:port_number;DatabaseName=databasename Microsoft SQL Server:
host_name:port_number;SelectMethod=cursor;DatabaseName=databasename
Name of the user account to connect to the repository database. Password for the user account to connect to the database.
Press Enter. The installer verifies that the database connection is valid. If the connection fails, an error message displays the reason for the failure. You can continue the installation if the connection is valid. The installer configures Data Analyzer, Metadata Manager, and the application server. It configures the Data Analyzer and Metadata Manager repositories and starts the application server. The PowerCenter Installation Summary panel indicates whether the installation completed successfully. It also shows the configured properties for PowerCenter components and the status of installed components.
67.
Press Enter.
You can view the log files generated by the installer to get more information about the installation tasks performed by the installer and view configuration properties for the installed components. For more information about the log files generated by the installer, see Installer Log Files on page 362.
235
236
Chapter 9
Overview, 238 Installing PowerCenter Services, 240 Upgrading from PowerCenter 8.1, 246 Installing Data Analyzer, 248 Installing Metadata Manager, 255
237
Overview
This chapter provides instructions on running the PowerCenter console mode installer. When you select the custom installation option, the PowerCenter installer determines the components available for installation based on the license key you provide. With the custom installation, you can install the PowerCenter components separately. If you choose to install more than one component, the PowerCenter installer installs all the selected components on the same machine in the directory that you provide. You can provide a different database for each repository. The console mode installer is similar to the graphical mode installer. Each panel in the console mode installer prompts you for the same information as each window in the graphical mode installer. Before you install PowerCenter, complete the steps listed in Pre-Installation Tasks on page 50. You can install the following PowerCenter components:
PowerCenter Services. Install only PowerCenter Services. When you install PowerCenter Services, you can choose the following options:
Install PowerCenter Services. Install PowerCenter Services if you have not installed PowerCenter Services or if you are upgrading from version 8.0 or earlier. For more information about installing PowerCenter, see Installing PowerCenter Services on page 240. Upgrade PowerCenter Services. Install PowerCenter Services and upgrade the domain and node metadata if you upgrade from PowerCenter 8.1. For more information about upgrading PowerCenter, see Upgrading from PowerCenter 8.1 on page 246.
Data Analyzer. Install only Data Analyzer. For more information, see Installing Data Analyzer on page 248. Metadata Manager. Install only Metadata Manager. For more information, see Installing Metadata Manager on page 255.
After you run the installer, complete the installation or upgrade of PowerCenter components. For more information, see the steps for your installation or upgrade path in Installation and Upgrade Overview on page 15.
Each panel in the installer prompts for configuration information. After the installer collects the information and configures PowerCenter, you may not be able to return to a previous step. After you install, you can change the PowerCenter services settings in the Administration Console.
238
Each prompt displays default values. You can press Enter to accept default values or enter configuration information at the prompt to change the default value. To enter multiple values in a prompt that accepts multiple values, separate values with commas. Enter quit at any time to quit the installer. Passwords are not encrypted at the prompt. If you enter a value for an optional property, such as an IBM DB2 tablespace name, the installer uses it as the default value if you return to the panel. If you do not want to use the value you entered, you can remove the default value by entering a space for the property.
Overview
239
Verify that your environment meets the minimum system requirements, and complete the pre-installation tasks. For more information about preparing for the PowerCenter installation, see Before You Install on page 49.
2. 3. 4.
Log in to the machine as the system user. Close all other applications before running the installation. On a shell command line, run install.sh located in the DVD root directory or the root directory in the location where you downloaded the installer. The PowerCenter installer checks the operating system and verifies that the environment variables are correctly set. The environment variables must be specifically set to enable the PowerCenter installer to run processes and connect to databases and services. If the environment variables are not set, the PowerCenter installer gives you the option to stop the installation and modify the environment variables.
5.
Select the option to use the Console mode installation. The Welcome panel introduces the PowerCenter installation.
6.
Press Enter. The Configure Environment Variables panel appears. The PowerCenter installer requires specific environment variable settings. Read the PowerCenter environment configuration requirements and set the environment variables before you continue with the installation. If you do not set the environment variables as required, the PowerCenter installation may fail.
7.
Enter quit to exit the installer if the required environment variables are not set. -orPress Enter to continue with the installation. The PowerCenter License Key panel appears.
8. 9.
Enter the location and file name of the PowerCenter Standard or Advanced Edition license key. Press Enter.
240
The Installation Prerequisites panel displays the supported platforms and databases and the disk space requirements. Make sure that all PowerCenter installation requirements are met before you continue the installation.
10.
Press Enter. The Installation Set panel displays the PowerCenter installation options.
11.
Select the Custom option and press Enter. The PowerCenter installer displays the list of available PowerCenter components. The type of license key you provide determines the available components.
12.
13.
Use the default directory or enter the path to a directory. The default directory on UNIX is $HOME/Informatica/PowerCenter8.1.1, where HOME is the user home directory.
Note: The installation directory path must be an absolute path. If the installation directory contains a Metadata Manager installation, you cannot install PowerCenter Services in the directory.
14.
15. 16.
Enter 1 to install PowerCenter 8.1.1. Press Enter. The Pre-Installation Summary panel appears. Review the pre-installation summary to verify that the installer will install PowerCenter components in the correct location and with the options you select.
17.
Press Enter to continue or enter back to return and modify the options. The installer copies the files for the selected components to the installation directory. When the file copy process completes, the Create or Join Domain panel appears.
18.
For more information about the available domain options, see Single or Multiple Machine Installation on page 17.
19.
Press Enter.
Installing PowerCenter Services 241
The Configure Domain Database panel appears. PowerCenter stores the PowerCenter domain configuration in a relational database. The domain configuration must be accessible by all gateway nodes in the domain.
20.
21.
22.
242
23.
To set the range of port numbers that the PowerCenter installer can use for the PowerCenter services on the node, enter Y at the prompt and enter the range of available ports. To accept the default values, enter N. The default range for the port numbers is 6005 - 6105. Skip to step 29.
24.
Press Enter. The Configure Domain panel appears. The PowerCenter domain that you want to join must be available when you join the domain. Verify that the gateway node for the domain you want to join is available before you continue. If the PowerCenter installer cannot connect to the PowerCenter domain, you cannot continue with the installation.
25.
26.
27.
Port number
243
28.
To set the range of port numbers that the PowerCenter installer can use for the PowerCenter services on the node, enter Y at the prompt and enter the range of available ports. To accept the default values, enter N. The default range for the port numbers is 6005 - 6105.
29.
Press Enter. The PowerCenter Repository Configuration panel appears. The installer requires the database information to create a PowerCenter repository or connect to an existing PowerCenter repository.
30.
To use existing PowerCenter repository content, you may need to upgrade the repository after installing PowerCenter.
31.
Press Enter. The PowerCenter Repository Configuration panel requires different information based on the database type you select. Table 9-1 describes the configuration information required for the repository:
Table 9-1. PowerCenter Repository Information
Prompt Repository name Description Name for the PowerCenter repository. The name is case sensitive and must be less than 30 characters. The repository name cannot contain spaces or the following characters: \ / : *?><"| Repository code page. The Repository Service uses the character set encoded in the repository code page when it writes data to the repository. Choose a code page that is compatible with the code page of the machine where you install PowerCenter. For more information about code pages, see Code Pages on page 45. If you use an existing PowerCenter repository, the PowerCenter installer does not validate the repository code page. You must verify that the code page for the existing repository is compatible with the code page of the machine where you install PowerCenter. The Integration Service created during installation uses the same code page as the Repository Service. Verify that the code page for the Repository Service is compatible with the machine where the services are created. Type of database for the PowerCenter repository. Name of the user account to connect to the repository database. Password for the user account to connect to the database. Use 7-bit ASCII.
Code page
244
32.
Press Enter. The installer verifies that the database connection is valid. If the connection fails, an error message displays the reason for the failure. You can continue the installation if the connection is valid. The Configure Integration Service panel appears. Choose the data movement mode. The data movement mode must match the data movement mode of the associated PowerCenter repository.
33.
Press Enter. When the installation completes, the PowerCenter Installation Summary panel indicates whether the installation completed successfully. It also shows the configured properties for PowerCenter components and the status of installed components.
35.
Press Enter. You can view the log files generated by the installer to obtain more information about the installation tasks performed by the installer and view configuration properties for the installed components. For more information about the log files generated by the installer, see Installer Log Files on page 362.
245
Verify that your environment meets the minimum system requirements, and complete the pre-upgrade tasks. For more information about preparing for the PowerCenter installation, see PowerCenter 8.1 Pre-Upgrade Steps on page 84.
2. 3. 4.
Log in to the machine as the system user. Close all other applications before running the installation. On a shell command line, run install.sh located in the DVD root directory or the root directory in the location where you downloaded the installer. The PowerCenter installer checks the operating system and verifies that the environment variables are correctly set. The environment variables must be specifically set to enable the PowerCenter installer to run processes and connect to databases and services. If the environment variables are not set, the PowerCenter installer gives you the option to stop the installation and modify the environment variables.
5.
Select the option to use the Console mode installation. The Welcome panel introduces the PowerCenter installation.
6.
Press Enter. The Configure Environment Variables panel appears. The PowerCenter installer requires specific environment variable settings. Read the PowerCenter environment configuration requirements and set the environment variables before you continue with the installation. If you do not set the environment variables as required, the PowerCenter installation may fail.
7.
Enter quit to exit the installer if the required environment variables are not set. -orPress Enter to continue with the installation. The PowerCenter License Key panel appears.
8. 9.
Enter the location and file name of the PowerCenter Standard or Advanced Edition license key. Press Enter.
246
The Installation Prerequisites panel displays the supported platforms and databases and the disk space requirements. Make sure that all PowerCenter installation requirements are met before you continue the installation.
10.
Press Enter. The Installation Set panel displays the PowerCenter installation options.
11.
Select the Custom option and press Enter. The PowerCenter installer displays the list of available PowerCenter components. The type of license key you provide determines the available components.
12.
To install PowerCenter Services, enter 1 and press Enter. The Installation Directory panel appears.
13.
Use the default directory or enter the path to a directory. The default directory on UNIX is $HOME/Informatica/PowerCenter8.1.0, where HOME is the user home directory. You must use the directory where you installed PowerCenter Services 8.1. The installation directory path must be an absolute path.
14.
15. 16.
Enter 2 to upgrade to PowerCenter 8.1.1. Press Enter. The Pre-Installation Summary panel appears. Review the pre-installation summary to verify that the installer will install PowerCenter components in the correct location and with the options you select. Press Enter to continue or enter back to return and modify the options. The installer installs PowerCenter Services and updates the previous installation.
You can view the log files generated by the installer to obtain more information about the installation tasks performed by the installer. For more information about the log files generated by the installer, see Installer Log Files on page 362.
247
Verify that your environment meets the minimum system requirements, and complete the pre-installation tasks. For more information about preparing for the PowerCenter installation, see Before You Install on page 49.
2. 3. 4.
Log in to the machine as the system user. Close all other applications before running the installation. On a shell command line, run install.sh located in the DVD root directory or the root directory in the location where you downloaded the installer. The PowerCenter installer checks the operating system and verifies that the environment variables are correctly set. The environment variables must be specifically set to enable the PowerCenter installer to run processes and connect to databases and services. If the environment variables are not set, the PowerCenter installer gives you the option to stop the installation and modify the environment variables.
5.
Select the option to use the Console mode installation. The Welcome panel introduces the PowerCenter installation.
6.
Press Enter. The Configure Environment Variables panel appears. The PowerCenter installer requires specific environment variable settings. Read the PowerCenter environment configuration requirements and set the environment variables before you continue with the installation. If you do not set the environment variables as required, the PowerCenter installation may fail.
7.
Enter quit to exit the installer if the required environment variables are not set. -orPress Enter to continue with the installation. The PowerCenter License Key panel appears.
8. 9.
Enter the location and file name of the PowerCenter Standard or Advanced Edition license key. Press Enter. The Installation Prerequisites panel displays the supported platforms and databases and the disk space requirements. Make sure that all PowerCenter installation requirements are met before you continue the installation.
248
10.
Press Enter. The Installation Set panel displays the PowerCenter installation options.
11.
Select the Custom option and press Enter. The PowerCenter installer displays the list of available PowerCenter components. The type of license key you provide determines the available components.
12.
To install Data Analyzer, enter 2 and press Enter. The Data Analyzer/Metadata Manager License Key panel appears.
13.
Enter the location and file name of the Data Analyzer license key. The Data Analyzer license key is required to run PowerCenter Repository Reports on Data Analyzer.
14.
15.
Use the default directory or enter the path to a directory. The default directory on UNIX is $HOME/Informatica/PowerCenter8.1.1, where HOME is the user home directory. The installation directory path must be an absolute path.
16.
Press Enter. The Application Server panel appears. Select the application server to install Data Analyzer on.
17.
18.
249
19.
20. 21.
Press Enter. Enter the home directory for JBoss Application Server. If you install a new instance of JBoss Application Server, the installer creates a server configuration in the directory you provide. If you use an existing instance of JBoss Application Server, you must provide the directory for an existing server configuration. The server configuration must support all available JBoss services.
Press Enter. Enter the server configuration directory. To configure the JBoss Application Server ports, enter Y at the prompt and enter the values for the JBoss Application Server ports. Enter N to accept the default values. You can configure the ports used by the JBoss Application Server to avoid port conflicts if you run multiple instances of JBoss Application Server on the same machine. Table 9-2 describes the JBoss Application Server ports and the default port values:
Table 9-2. JBoss Application Server Default Port Values
Port Name HTTP Connector Port JBoss MQ Service Port IIOP Port JMS Server Port Web Service Port RMI Services Bind Address Port RMI Invoker Port JRMP Invoker Port HA-JNDI Stub Availability JRMP Invoker Port for cluster UDP Binding Port SNMP Adaptor Port Default Port 8080 8093 3538 1099 8093 1098 4444 4445 1100 4446 45566 1161
250
Press Enter. The WebLogic Server Directory panel appears. Enter the existing WebLogic Server directory.
26.
27.
28.
Enter the WebLogic domain name and location. If you are installing Data Analyzer on a new WebLogic domain, continue to the next step. If you are installing on an existing WebLogic domain, skip to step 31.
29.
30. 31.
Enter the account name and password for the WebLogic Administration Console and the listening port number for the new domain. Skip to step 39. Press Enter. The Existing WebLogic Server Domain Configuration panel appears.
32. 33.
Enter the account name and password for the WebLogic Administration Console for the existing domain. Skip to step 39. Press Enter. The Existing WebSphere Application Server Directory panel appears.
34. 35.
Enter the home directory for the WebSphere Base Server. Skip to step 37. Press Enter. The Existing WebSphere Application Server Directory panel appears.
36.
Enter the home directories for the WebSphere Base Server and the Network Deployment.
251
37.
Press Enter. The WebSphere Application Server Administration Details panel appears.
38.
39.
Press Enter. The Pre-Installation Summary panel appears. Review the pre-installation summary to verify that the installer will install Data Analyzer components in the correct location and with the options you select.
40.
Press Enter to continue or enter back to return and modify the options. The installer copies the files for Data Analyzer to the installation directory. If you selected an existing instance of JBoss Application Server, or you selected WebLogic Server or WebSphere Application Server, the Data Analyzer and Metadata Manager Authentication panel appears when the file copy process completes.
Note: WebLogic Server and WebSphere Application Server support only one
authentication method for all applications running on the same instance of the application server.
41.
Enter Y to overwrite the authentication in the application server with repository authentication. The new authentication settings will overwrite the security settings on the application server. -orEnter N to keep the current authentication settings in the application server. The application server must be configured with an authentication method that is compatible with Data Analyzer. Otherwise, you cannot log in to Data Analyzer. If you install Data Analyzer on WebSphere Application Server, the installer configures WebSphere Application Server security and Data Analyzer authentication based on your selection and the WebSphere Application Server setup.
252
Table 9-3 describes the configuration tasks performed by the installer when you install Data Analyzer on WebSphere Application Server:
Table 9-3. WebSphere Application Server Security and Repository Authentication
WebSphere Security Enabled? Yes Configure Repository Authentication? Yes
Installer Action The installer changes the existing WebSphere Application Server Console administrator user name to admin and the password to admin and configures repository authentication for Data Analyzer. The installer leaves WebSphere Application Server Console security settings intact and does not change the administrator user name and password. The installer does not configure repository authentication. The installer enables the WebSphere Application Server Console security and sets the administrator user name to admin and the password to admin. The installer configures repository authentication for Data Analyzer. The installer does not enable WebSphere Application Server Console security and does not configure repository authentication for Data Analyzer.
Yes
No
No
Yes
No
No
For more information about configuring authentication, see Configuring Authentication in the Data Analyzer Administrator Guide.
42.
Press Enter. The installer displays a message about the application server configuration tasks performed by the installer.
43.
Enter N to return to the Data Analyzer and Metadata Manager Authentication panel. -orEnter Y to continue with the installation. The Data Analyzer Repository Configuration panel appears.
44.
To use existing Data Analyzer repository content, you may need to upgrade the repository after installation.
45. 46.
253
Table 9-4 describes the information required for the Data Analyzer repository:
Table 9-4. Data Analyzer Repository Information
Option Database type Database URL Description Type of database for the Data Analyzer repository. Enter the appropriate number for the repository database type. Database connection string. Use the following format: Oracle: host_name:port_number;SID=sid DB2:host_name:port_number;DatabaseName=databasename Microsoft SQL Server:
host_name:port_number;SelectMethod=cursor;DatabaseName=databasename Sybase ASE: host_name:port;DatabaseName=database_name
For more information about the JDBC drivers installed with PowerCenter, see JDBC Drivers on page 553. Database user ID Database password 47. Name of the user account to connect to the repository database. Password for the user account to connect to the database.
Press Enter. The installer verifies that the database connection is valid. If the connection fails, an error message displays the reason for the failure. You can continue the installation if the connection is valid. The installer configures the Data Analyzer repository and configures and starts the application server. The PowerCenter Installation Summary panel indicates whether the installation completed successfully. It also shows the configured properties for Data Analyzer components and the status of installed components.
48.
Press Enter.
You can view the log files generated by the installer to obtain more information about the installation tasks performed by the installer and view configuration properties for the installed components. For more information about the log files generated by the installer, see Installer Log Files on page 362.
254
Verify that your environment meets the minimum system requirements, and complete the pre-installation tasks. For more information about preparing for the PowerCenter installation, see Before You Install on page 49.
2. 3. 4.
Log in to the machine as the system user. Close all other applications before running the installation. On a shell command line, run install.sh located in the DVD root directory or the root directory in the location where you downloaded the installer. The PowerCenter installer checks the operating system and verifies that the environment variables are correctly set. The environment variables must be specifically set to enable the PowerCenter installer to run processes and connect to databases and services. If the environment variables are not set, the PowerCenter installer gives you the option to stop the installation and modify the environment variables.
5.
Select the option to use the Console mode installation. The Welcome panel introduces the PowerCenter installation.
6.
Press Enter. The Configure Environment Variables panel appears. The PowerCenter installer requires specific environment variable settings. Read the PowerCenter environment configuration requirements and set the environment variables before you continue with the installation. If you do not set the environment variables as required, the PowerCenter installation may fail.
7.
Enter quit to exit the installer if the required environment variables are not set. -orIf the environment variables are set, press Enter. The PowerCenter License Key panel appears.
8. 9.
Enter the location and file name of the PowerCenter Advanced Edition license key. Press Enter.
255
The Installation Prerequisites panel displays the supported platforms and databases and the disk space requirements. Make sure that all PowerCenter installation requirements are met before you continue the installation.
10.
Press Enter. The Installation Set panel displays the PowerCenter installation options.
11.
Select the Custom option and press Enter. The PowerCenter installer displays the list of available PowerCenter components. The type of license key you provide determines the available components.
12.
To install Metadata Manager, enter 2 and press Enter. The Data Analyzer/Metadata Manager License Key panel appears.
13.
Enter the location and file name of the Metadata Manager license key. The Installation Directory panel appears.
14.
Use the default directory or enter the path to a directory. The default directory on UNIX is $HOME/Informatica/PowerCenter8.1.1, where HOME is the user home directory. The installation directory path must be an absolute path. If the installation directory contains a PowerCenter Services installation, you cannot install Metadata Manager in the directory.
15.
16.
Select the application server to install Metadata Manager on. Enter one of the following options:
Option 1 - JBoss Application Server 2 - BEA WebLogic Server 3 - IBM WebSphere Application Server (Network Deployment) 4 - IBM WebSphere Application Server (Base) Description You can install Metadata Manager on a new or existing instance of JBoss Application Server. If you select JBoss Application Server, continue to the next step. You can install Metadata Manager on an existing instance of BEA WebLogic Server. You can create a new WebLogic Server domain or install Data Analyzer on an existing WebLogic Server domain. If you select WebLogic Server, skip to step 24. You can install Metadata Manager on an existing WebSphere Application Server Network Deployment Edition instance. If you select WebSphere Application Server Network Deployment Edition, skip to step 35. You can install Metadata Manager on an existing WebSphere Application Server Base Edition instance. If you select WebSphere Application Server Base Edition, skip to step 33.
17.
256
18.
19. 20.
Press Enter. Enter the home directory for JBoss Application Server. If you install a new instance of JBoss Application Server, the installer creates a server configuration in the directory you provide. If you use an existing instance of JBoss Application Server, you must provide the directory for an existing server configuration. The server configuration must support all available JBoss services.
Press Enter. Enter the server configuration directory. To configure the JBoss Application Server ports, enter Y at the prompt and enter the values for the JBoss Application Server ports. Enter N to accept the default values. You can configure the ports used by the JBoss Application Server to avoid port conflicts if you run multiple instances of JBoss Application Server on the same machine. Table 9-5 describes the JBoss Application Server ports and the default port values:
Table 9-5. JBoss Application Server Default Port Values
Port Name HTTP Connector Port JBoss MQ Service Port IIOP Port JMS Server Port Web Service Port RMI Services Bind Address Port RMI Invoker Port JRMP Invoker Port HA-JNDI Stub Availability JRMP Invoker Port for cluster UDP Binding Port SNMP Adaptor Port Default Port 8080 8093 3538 1099 8093 1098 4444 4445 1100 4446 45566 1161
257
25. 26.
Enter the existing WebLogic Server directory. Press Enter. The WebLogic Application Server Domain panel appears.
27.
28.
Enter the WebLogic domain name and location. If you are installing Data Analyzer on a new WebLogic domain, continue to the next step. If you are installing on an existing WebLogic domain, skip to step 31. Press Enter. The New WebLogic Domain Configuration panel appears.
29.
30. 31.
Enter the account name and password for the WebLogic Administration Console and the listening port number for the new domain. Skip to step 39. Press Enter. The Existing WebLogic Server Domain Configuration panel appears.
32. 33.
Enter the account name and password for the WebLogic Administration Console for the existing domain. Skip to step 39. Press Enter. The Existing WebSphere Application Server Directory panel appears.
34. 35.
Enter the home directory for the WebSphere Base Server. Skip to step 37. Press Enter. The Existing WebSphere Application Server Directory panel appears.
Enter the home directories for the WebSphere Base Server and the Network Deployment. Press Enter.
39.
Press Enter. The Pre-Installation Summary panel appears. Review the pre-installation summary to verify that the installer will install Metadata Manager components in the correct location and with the options you select. Press Enter to continue or enter back to return and modify the options. After you press Enter, the installer copies the Metadata Manager files to the installation directory. When the file copy process completes, the Configure Domain panel appears. The PowerCenter domain must be available. Verify that the gateway node for the domain is available before you continue. If the PowerCenter installer cannot connect to the PowerCenter domain, you cannot continue with the installation.
40.
41.
Press Enter. The PowerCenter Repository Configuration panel appears. The installer creates a Repository Service for the PowerCenter repository for Metadata Manager. You must create another repository for use with the PowerCenter Client after installation.
259
42.
43.
Press Enter. The PowerCenter Repository Configuration panel requires different information based on the database type you select.
Note: The installer includes a generic list of code pages for the PowerCenter repository.
Verify that the code page you select is available on the gateway node for the domain you are joining. If you select an existing repository, the code page must also be compatible with the repository. If you select an invalid code page, the installation will fail. Table 9-6 describes the configuration information required for a repository on the different databases:
Table 9-6. PowerCenter Repository Information
Prompt Repository name Code page Description Name for the PowerCenter repository. The name is case sensitive, must be less than 30 character and cannot contain spaces or the following characters: \/:*?<>| Repository code page. The Repository Service uses the character set encoded in the repository code page when it writes data to the repository. Choose a code page that is compatible with the code page of the machine where you install PowerCenter. For more information about code pages, see Code Pages on page 45. The Integration Service created during installation uses the same code page as the Repository Service. Verify that the code page for the Repository Service is compatible with the machine where the services are created. Note: The installer includes a generic list of code pages for the PowerCenter repository. Verify that the code page you select is available on the gateway node for the domain. If you select an existing repository, the code page must also be compatible with the repository. If you select an invalid code page, the installation will fail. Type of database for the PowerCenter repository. Name of the user account to connect to the repository database. Password for the user account to connect to the database. Use 7-bit ASCII. Appears for Oracle, SQL Server, and Sybase ASE databases only. Native connect string to access the repository database. Use the syntax appropriate for the selected database: - Oracle: Same syntax as the TNSNAMES entry: aliasname.world. - SQL Server: Syntax is SQLServername@dbname, where SQLServername is the name of the SQL Server instance that contains the dbname database. - Sybase ASE: Syntax is servername@dbname, where servername is the name of the Adaptive Server from the interfaces file.
260
Press Enter. The installer verifies that the database connection is valid. If the connection fails, an error message displays the reason for the failure. You can continue the installation if the connection is valid. The Configure Integration Service panel appears. Choose the data movement mode. The data movement mode must match the data movement mode of the associated PowerCenter repository for Metadata Manager.
45.
User name
Password 46.
Press Enter. If you selected an existing instance of JBoss Application Server, or you selected WebLogic Server or WebSphere Application Server, the Data Analyzer and Metadata Manager Authentication panel appears.
Note: WebLogic Server and WebSphere Application Server support one authentication
method for all applications running on the same instance of the application server.
47.
Enter Y to overwrite the authentication in the application server with repository authentication. The new authentication settings will overwrite the security settings on the application server. -orEnter N to keep the current authentication settings in the application server. If you select No, the application server must be configured with an authentication method that is compatible with Metadata Manager. Otherwise, you cannot log in to Metadata Manager.
Installing Metadata Manager 261
If you install Metadata Manager on WebSphere Application Server, the installer configures WebSphere Application Server security and Metadata Manager authentication based on your selection and the WebSphere Application Server setup. Table 9-7 describes the configuration tasks performed by the installer when you install Metadata Manager on WebSphere Application Server:
Table 9-7. WebSphere Application Server Security and Repository Authentication
WebSphere Security Enabled? Yes Configure Repository Authentication? Yes
Installer Action The installer changes the existing WebSphere Application Server Console administrator user name to admin and the password to admin and configures repository authentication for Metadata Manager. The installer leaves WebSphere Application Server Console security settings intact and does not change the administrator user name and password. The installer does not configure repository authentication. The installer enables the WebSphere Application Server Console security and sets the administrator user name to admin and the password to admin. The installer configures repository authentication for Metadata Manager. The installer does not enable WebSphere Application Server Console security and does not configure repository authentication for Metadata Manager.
Yes
No
No
Yes
No
No
For more information about configuring authentication, see Managing Authentication for Metadata Manager in the Metadata Manager Administrator Guide.
48.
Press Enter. The installer displays a message about the application server configuration tasks performed by the installer.
49.
Enter N to return to the Data Analyzer and Metadata Manager Authentication panel. -orEnter Y to continue with the installation. The Metadata Manager Repository Configuration panel appears.
50.
To use existing Metadata Manager repository content, you may need to upgrade the repository.
51. 262
Press Enter.
Enter the Metadata Manager configuration information. Table 9-8 describes the information required for the Metadata Manager repository:
Table 9-8. Metadata Manager Repository Information
Prompt Database Type Database URL Description Type of database for the Metadata Manager repository. Enter the appropriate number for the repository database type. Database connection string. Use the following syntax: Oracle: host_name:port_number;SID=sid DB2:host_name:port_number;DatabaseName=databasename Microsoft SQL Server:
host_name:port_number;SelectMethod=cursor;DatabaseName=databasename
For more information about the JDBC drivers installed with PowerCenter, see JDBC Drivers on page 553. Database User ID Database Password 52. Name of the user account to connect to the repository database. Password for the user account to connect to the database.
Press Enter. The installer verifies that the database connection is valid. If the connection fails, an error message displays the reason for the failure. You can continue the installation if the connection is valid. The installer configures Metadata Manager and the application server, configures the Metadata Manager repository, and starts the application server. The PowerCenter Installation Summary panel indicates whether the installation completed successfully. It also shows the configured properties for Metadata Manager components and the status of installed components.
53.
Press Enter. You can view the log files generated by the installer to obtain more information about the installation tasks performed by the installer and view configuration properties for the installed components. For more information about the log files generated by the installer, see Installer Log Files on page 362.
263
264
Chapter 10
Overview, 266 Running the Complete Client Installation, 267 Running the Custom Client Installation, 271 Running a Silent Client Installation, 277
265
Overview
When you install the PowerCenter Client, you install the following PowerCenter Client tools and components:
PowerCenter Client tools. A set of tools you can use to manage the PowerCenter repository, mappings, and sessions. If you install the PowerCenter Client without the Metadata Manager Client, you do not need to log in with an administrator account.
Metadata Manager Client. A set of applications you can use to configure Metadata Manager and manage metadata. You must log in with an administrator account when you install the Metadata Manager Client for the installer to create the Informatica PowerCenter Metadata Manager Scheduler service.
DataDirect 5.1 ODBC drivers. Drivers designed for PowerCenter to connect the PowerCenter Client to data sources and targets. The Metadata Manager Client uses ODBC for connections to the Metadata Manager repository and PowerCenter repository. Java Runtime Environment. The Java transformation, PowerCenter Connect for JMS, and PowerCenter Connect for webMethods require the JRE.
Installation Options
You can install the PowerCenter Client on a Windows machine. When you run the PowerCenter Client installer, you can select one of the following options:
Complete. Installs the PowerCenter Client and Metadata Manager Client applications on one machine. For more information, see Running the Complete Client Installation on page 267. Custom. Installs the PowerCenter Client or Metadata Manager Client applications separately. You can install the clients on different machines. For more information, see Running the Custom Client Installation on page 271. Silent. Installs the PowerCenter Client in silent mode. For more information, see Running a Silent Client Installation on page 277.
266
Verify that your environment meets the minimum system requirements, and complete the pre-installation tasks. For more information about preparing for the PowerCenter installation, see Before You Install on page 49.
2. 3.
Close all other applications before running the installation. To run the PowerCenter Client installer from the DVD, run the installer from the following location:
<DVD_Root>\install.exe
-orTo run the PowerCenter Client installer if you downloaded the installer, run the installer from the following location:
<download location>\install.exe 4.
On the PowerCenter main installation window, select Client. The Welcome window introduces the PowerCenter Client installation.
5.
Click Next. The Installation Set window displays the PowerCenter installation options.
267
6.
To install the complete set of PowerCenter Client applications, select Complete and click Next. The Installation Directory window appears.
7.
Use the default directory or click Browse to find a directory. The default directory is C:\Informatica\PowerCenter8.1.1. The installation directory path must be an absolute path.
8.
Click Next. The installer generates the list of code pages to use with the Metadata Manager Client.
268
9. 10. 11.
Select the code page for the machine where you are installing the Metadata Manager Client. For the Integration repository, enter the name of the PowerCenter repository for Metadata Manager. Click Next. The Pre-Installation Summary window summarizes the installation information.
269
12.
Review the installation information, and click Install to continue. The installation process displays several windows that show the progress of the installation and configuration. The Installation Complete window displays a message about whether the installation completed successfully. You can select the PowerCenter Client applications to launch when the installation completes.
13.
Click Done.
After the installation completes, the installer creates installation log files. For more information about the log files created by the PowerCenter Client installer, see Installer Log Files on page 362. If this is the first time you installed the Metadata Manager Client on this machine, you must reboot the client machine after the installation completes.
270
PowerCenter Client. Install the Designer, Repository Manager, Workflow Manager, Workflow Monitor, and Data Stencil. Metadata Manager Client. Install the Configuration Console and Custom Metadata Configurator.
Verify that your environment meets the minimum system requirements, and complete the pre-installation tasks. For more information about preparing for the PowerCenter installation, see Before You Install on page 49.
2. 3.
Close all other applications before running the installation. To run the PowerCenter Client installer from the DVD, run the installer from the following location:
<DVD_Root>\install.exe
-orTo run the PowerCenter Client installer if you downloaded the installer, run the installer from the following location:
<download location>\install.exe 4.
On the PowerCenter main installation window, select Client. The Welcome window introduces the PowerCenter Client installation.
5.
Click Next.
271
The Installation Set window displays the PowerCenter Client installation options.
6.
To select the PowerCenter products to install, select Custom and click Next. The PowerCenter Client Components window appears.
272
7.
To install only the PowerCenter Client, clear the Metadata Manager option.
-orTo install only the Metadata Manager Client, clear the PowerCenter option.
8.
Click Next.
273
9.
Use the default directory or click Browse to find a directory. The default directory is C:\Informatica\PowerCenter8.1.1. The installation directory path must be an absolute path. If you are installing the PowerCenter Client only, skip to step 13. If you are installing the Metadata Manager Client only, continue to the next step.
10.
Click Next. The installer generates the list of code pages to use with the Metadata Manager Client.
274
Enter the code page for the machine where you are installing the Metadata Manager Client. For the Integration repository, enter the name of the PowerCenter repository for Metadata Manager. Click Next.
275
The Pre-Installation Summary window displays the component to be installed and summarizes the installation information.
14.
Review the installation information, and click Install to continue. The installation process displays several windows that show the progress of the installation and configuration. The installer displays a message about whether the installation completed successfully. It also shows the location of the PowerCenter Client.
15.
Click Done.
After the PowerCenter Client installation completes, the installer creates installation log files. For more information about the log files created by the PowerCenter Client installer, see Installer Log Files on page 362. If this is the first time you installed the Metadata Manager Client on this machine, you must reboot the client machine after the installation completes.
276
2.
277
If you are installing from the PowerCenter installation DVD, copy the sample installer properties file from the DVD to the hard disk. Open the installer properties file in a text editor. Modify the installation properties in the properties file. Table 10-1 describes the installation properties:
Table 10-1. Silent Installation Properties
Property Name INSTALLER_UI USER_INSTALL_DIR CHOSEN_INSTALL_SET Description Installation mode for the installer. Use Silent for silent mode. PowerCenter Client installation directory. Use \\ to separate directories. Installation set type. You can configure the following options: - Complete. Install all PowerCenter Client and Metadata Manager Client tools. - Custom. Install only components selected in CHOSEN_INSTALL_BUNDLE_LIST. Use Custom to install PowerCenter Client components on different machines. PowerCenter Client components to install. Separate multiple components with commas. You can configure the following options: - PowerCenter Client - Metadata Manager Client Code page ID for the PowerCenter repository for Metadata Manager. Name of the PowerCenter repository for Metadata Manager.
CHOSEN_INSTALL_BUNDLE_LIST
CODEPAGE INTREPONAME 4.
Save the properties file on the machine where you install the PowerCenter Client.
278
The installer performs the installation and reports errors. It may report errors if you incorrectly configured the properties file or the installer could not access the installation directory. You can correct the errors and run the silent installation again. For more information about the log files created by the PowerCenter Client installer, see Installer Log Files on page 362.
279
280
Chapter 11
Overview, 282 Installing PowerCenter Reports in Graphical Mode, 284 Installing PowerCenter Reports in Console Mode, 288
281
Overview
When you install PowerCenter Reports, you install the following reports on a Data Analyzer instance:
Administrative reports. A set of prepackaged administrative reports that enable system administrators to track user activities and monitor processes. PowerCenter Repository Reports. A set of prepackaged dashboards and reports that allow you to analyze PowerCenter repository metadata. Data Analyzer Data Profiling reports. Composite, metadata, and summary reports for a Data Profiling warehouse.
When you install PowerCenter reports, you can use the complete installation to install PowerCenter Reports on the same instance of Data Analyzer. You can use the custom installation to install reports on more than one Data Analyzer instance. Before you install the PowerCenter Reports, you must install Data Analyzer. You can install PowerCenter Reports and then set up Data Analyzer to run the PowerCenter Reports and create dashboards and other reports for other data sources. After you install the Data Analyzer administrative reports, PowerCenter Repository Reports, or Data Analyzer Data Profiling reports, you must set up data sources and a data connector in Data Analyzer before you can run the reports. For more information about setting up the administrative reports, see Working with the Data Analyzer Administrative Reports in the Data Analyzer Administrator Guide. For more information about setting up the PowerCenter Repository Reports, see Setting Up the PowerCenter Repository Reports on page 339. For more information about setting up Data Analyzer Data Profiling Reports, see Setting Up the Data Analyzer Data Profiling Reports on page 351.
Installation Modes
You can run the PowerCenter Report installer in the following modes:
Graphical user interface mode. You can install PowerCenter Reports in graphical user interface mode on UNIX and Windows. For more information, see Installing PowerCenter Reports in Graphical Mode on page 284. Console mode. You can install PowerCenter Reports in console mode on UNIX. For more information, see Installing PowerCenter Reports in Console Mode on page 288.
282
Use the following rules and guidelines when installing PowerCenter Reports with the console mode installer:
Each panel in the installer prompts for configuration information. Type back at the installer prompt return to the previous panel. You can only go back from panel to panel. You cannot go back to a previous prompt from the same panel. The installer stores previous entries. For example, if you go back two panels, you can change configuration information and press Enter at each subsequent prompt to accept the values you already entered. Each prompt displays default values. You can press Enter to accept default values or enter configuration information at the prompt to change the default value. Enter quit at any time to quit the installer.
Overview
283
Verify that the Data Analyzer instance where you want to install the reports is running. Close all other applications before running the installation. To start the installer on Windows, insert the DVD into the DVD drive. If the installer does not start or if you are installing PowerCenter from a hard disk, run install.exe from the DVD root directory or the root directory in the location where you downloaded the installer. -orTo start the installer on UNIX, run install_reports.sh at a shell command line from the DVD root directory or the root directory in the location where you downloaded the installer.
4. 5.
On UNIX, select the option to use the GUI mode installation. On the PowerCenter main installation window, select Reports. The Welcome window introduces the PowerCenter Reports installation.
6.
284
7.
Click Next. The Installation Set window displays the PowerCenter Reports installation options.
8.
To install the complete set of PowerCenter Reports, select Complete. Skip to step 11. To select the PowerCenter reports to install, select Custom.
9.
285
10. 11.
Select the components you want to install. Click Next. The Application Details window appears.
12.
Enter the URL and administrator name and password for the Data Analyzer instance where you want to install the reports. Verify the administrator name and password are correct before you continue. The installer does not verify the values. The Data Analyzer instance must be running when you install the reports.
13.
Enter the type of database that the reports will use as a data source.
Report Type PowerCenter Repository Reports Administrative reports Data Profiling reports Data Source PowerCenter repository Data Analyzer repository Data Profiling warehouse
14.
Click Next.
286
15.
Review the installation information, and click Install to continue. When the installation finishes, the installer displays a message about whether the installation completed successfully. It also shows details about the Data Analyzer instance where the PowerCenter reports are installed.
16.
Click Done.
After the PowerCenter Reports installation completes, you can view the log file created during the installation. For more information about the PowerCenter Reports log files, see Installer Log Files on page 362.
287
Verify that the Data Analyzer instance where you want to install the reports is running. Close all other applications before running the installation. On a shell command line, run install_reports.sh located in the DVD root directory or the root directory in the hard disk location. The Welcome panel introduces the PowerCenter installation.
4.
5.
Press Enter. The Installation Set panel displays the PowerCenter Reports installation options.
6.
To install the complete set of PowerCenter Reports, press 1 and press Enter. Skip to step 9.
7.
To select the PowerCenter reports to install, press 2 and press Enter. The PowerCenter Report Components panel appears. You can use the custom installation to install PowerCenter reports on separate Data Analyzer instances.
8. 9.
Enter 1 to install only Administrative Reports, enter 2 to install Repository Reports, and enter 3 to install Data Profiling Reports. Enter 1,2,3 to install all reports. Press Enter. The Application Details panel appears.
10.
Enter the URL and administrator name and password for the Data Analyzer instance where you want to install the reports. Verify the administrator name and password are correct before you continue. The installer does not verify the values. The Data Analyzer instance must be running when you install the reports.
288
11.
Enter the type of database that the reports will use as a data source.
Report Type PowerCenter Repository Reports Administrative reports Data Profiling reports Data Source PowerCenter repository Data Analyzer repository Data Profiling warehouse
12.
Press Enter. The Pre-Installation Summary panel summarizes the installation information.
13.
Review the installation information, and press Enter to install. The installer displays a status bar that shows the progress of the PowerCenter Reports installation. When the installation finishes, the installer displays a message about whether the installation completed successfully. It also shows details about the Data Analyzer instance where the PowerCenter reports are installed.
14.
Press Enter.
After the PowerCenter Reports installation completes, you can view the log file created during the installation. For more information about the PowerCenter Reports log files, see Installer Log Files on page 362.
289
290
Chapter 12
Documentation Installation
Overview, 292 Installing PowerCenter Documentation, 293 Viewing PowerCenter Documentation, 295 Updating PowerCenter Online Help, 296 Installing the PowerCenter Web-Based HTML Help, 297
291
Overview
Informatica provides the PowerCenter Documentation DVD to install and view PowerCenter documentation in PDF format and install online help files for the PowerCenter Client and Administration Console. The PowerCenter Documentation DVD includes the following components:
PowerCenter documentation. PowerCenter documentation in PDF format. You can view the documentation directly from the DVD or you can install the documentation using the DVD. It also includes the Informatica Documentation Start Page which provides an easy way to select and view PowerCenter documents. For more information about installing the PowerCenter documentation, see Installing PowerCenter Documentation on page 293. For more information about viewing the PowerCenter documentation, see Viewing PowerCenter Documentation on page 295. Online help files. Context-sensitive online help files for the PowerCenter Client and the PowerCenter Administration Console. The PowerCenter installer installs the online help files when you install PowerCenter Standard or Advanced Edition. Install updated versions of the online help files from the Documentation DVD. For more information, see Updating PowerCenter Online Help on page 296. PowerCenter Web-based HTML documentation. PowerCenter documentation in HTML format. You can install the PowerCenter documentation web-based help on a nonWindows machine. Copy and unzip the pc_web.war file to an accessible directory. For more information, see Installing the PowerCenter Web-Based HTML Help on page 297.
292
On the PowerCenter Documentation DVD, locate and run the documentation installation file:
\Disk1\install.bat
Informatica Documentation Start Page appears. Click Exit to close the Documentation Start Page. Run the PowerCenter documentation installer.
2.
3.
Enter the full path of the folder where you want to install the PowerCenter documentation. The PowerCenter documentation installer displays the following default directory:
C:\Informatica\PowerCenter8.1.1
Click Next.
293
5.
Verify the installation information and click Install. When the documentation installation completes, the Post-Installation Summary window indicates whether the installation completed successfully.
6.
Click Done. The PowerCenter documentation installer creates a documentation shortcut in the Informatica PowerCenter 8.1.1 program group.
294
From the Start menu, choose Programs > Informatica PowerCenter 8.1.1 > Documentation > Start Documentation. Insert the PowerCenter Documentation DVD into the DVD drive and run start.bat in the root directory.
Click the type of documentation you want to view. Navigate through the selections to locate the document you want to view.
3.
Tip: If you want to go back to the Informatica Documentation Start Page while viewing a
document, click the last selection in the document bookmarks, Return to Start.
295
PowerCenter Client. Online help files for the PowerCenter Designer, Repository Manager, Workflow Manager, and Workflow Monitor. For more information about copying the Help files, see Updating PowerCenter Online Help on page 296. PowerCenter Administration Console. HTML help files for the Administration Console. For more information, see Updating PowerCenter Online Help on page 296.
Copy the CHM files from the Help_Files directory on the Documentation DVD to the client\bin directory in the PowerCenter Client installation directory. When you view online help, the client tool displays the most recent version.
Locate the WAR file for the Administration Console in the following location:
<DVD Root>\Help_Files\adminhelp.war
2. 3. 4.
Copy the WAR file to the server\tomcat\webapps directory on each gateway node in the domain. Stop and restart Informatica Services on the master gateway node for the domain. For more information, see Starting and Stopping Informatica Services on page 529. Log in to the Administration Console and click Help in the main window.
Each node that serves as a gateway node for a domain uses a local copy of the HTML help for the Administration Console. To view the online help on a gateway node, you must copy the online help file to that node.
296
Locate the WAR file for PowerCenter web-based help in the following location:
<DVD Root>\Help_Files\pc_web.war
2. 3.
Copy the WAR file to any directory that you want to use. Unzip the WAR file. If you install the WAR file on a Windows machine, you can use WinZip to unzip the files. -orYou can use the following Java command:
jar xf pc_web.war
4.
To view the table of contents and index, double-click the index.html file.
297
298
Chapter 13
Overview, 300 PowerCenter Command Line Programs and Utilities, 301 Data Analyzer Utilities, 302 Metadata Manager Utilities, 311
299
Overview
Informatica includes PowerCenter utilities with the PowerCenter product. PowerCenter utilities are customer support tools and command line programs and utilities for PowerCenter, Data Analyzer, and Metadata Manager. You can install and run the programs and utilities on any machine without installing PowerCenter. The PowerCenter utilities are included in a ZIP or TAR file on the root of the PowerCenter installation DVD or in the root directory of the location where you download the installer. To install the utilities, unzip or untar and configure the utilities on the machine where you want to run them. The PowerCenter utilities include the following components:
PowerCenter command line programs and utilities. Command line programs and utilities for use with PowerCenter Services and the PowerCenter Client. For more information about the included programs and utilities, see PowerCenter Command Line Programs and Utilities on page 301. Data Analyzer utilities. Utilities for use with the Data Analyzer application. For more information about installing and configuring the Data Analyzer utilities, see Data Analyzer Utilities on page 302. Metadata Manager utilities. Utilities for use with the Metadata Manager application. For more information about installing and configuring the Metadata Manager utilities, see Metadata Manager Utilities on page 311.
300
Table 13-1 describes the PowerCenter command line programs and utilities:
Table 13-1. PowerCenter Command Line Programs and Utilities
Program or Utility Name infacmd Description Administer PowerCenter domains and services. Use infacmd to administer application services and processes, the PowerCenter domain, licenses, log events, and grids. For more information about infacmd, see infacmd Command Reference in the Command Line Reference. Manage workflows. Use pmcmd to start, stop, schedule, and monitor workflows. For more information about pmcmd, see pmcmd Command Reference in the Command Line Reference. Encrypt passwords to use with pmcmd and pmrep environment variables. For more information about pmpasswd, see Configuring Environment Variables in the Command Line Reference. Performs repository administration tasks. Use pmrep to list repository objects, create and edit groups, and restore and delete repositories. For more information about pmrep, see pmrep Command Reference in the Command Line Reference. Export the PowerCenter Server configuration information from the Windows registry and create a PowerCenter Server configuration file. Use pmserverexportreg to create configuration files for use with the Upgrade Wizard in the PowerCenter Administration Console. For more information about pmserverexportreg, see Backing Up and Copying Configuration Files on page 89.
pmcmd
pmpasswd
pmrep
pmserverexportreg
You must preserve the directory structure of the PowerCenter811 directory to run infacmd and pmserverexportreg. These programs require the java directory. On UNIX, to run pmrep, pmcmd, and pmpasswd, you must copy domains.infa for the existing PowerCenter installation directory to the utilities directory, and set INFA_HOME, the PATH environment variable, and library path environment variable to the location of the PowerCenter utilities.
301
You must configure the utilities before you run them. You configure the variables required by the utilities in the utility script files. To configure the script files, open the files in a text editor and modify the variable values required by the script. Table 13-2 describes the Data Analyzer utilities included in the DataAnalyzer811 directory:
Table 13-2. Data Analyzer Utilities
Utility Name EAR Repackager Utility Import Export Utility License Update Utility PowerCenter Integration Utility Repository Backup Utility Description Unpacks and repackages the customizable files in the Data Analyzer EAR file. For more information, see Ear Repackager Utility on page 302. Imports or exports Data Analyzer repository objects. For more information, see Import Export Utility on page 303. Updates an expired license in a Data Analyzer EAR file. For more information, see License Update Utility on page 303. Notifies Data Analyzer when a PowerCenter session completes. For more information, see PowerCenter Integration Utility on page 304. Backs up a Data Analyzer repository to a repository backup file and recovers a repository from a repository backup file. For more information, see Repository Backup Utility on page 309. Upgrades a repository from a previous version of Data Analyzer. For more information, see Data Analyzer Repository Upgrade Utility on page 309. Updates the system accounts in the Data Analyzer repository. For more information, see Update System Accounts Utility on page 309.
302
Table 13-3 describes the variables you must configure to run the EAR Repackager utility:
Table 13-3. EAR Repackager Utility Variables
Variable Name ANT_HOME Description Location of the ANT Java build program used by the EAR Repackager Utility. The ANT Java build program is located in the following directory:
<PowerCenterUtilityDir>/DataAnalyzer811/ ear_repackagerutil/ant161
JAVA_HOME
Location of the Java Runtime Environment. By default, the installer installs the JRE in the following directory:
PowerCenterInstallationDir>/java
Name for the Data Analyzer instance on the application server. For Data Analyzer, the value is ias. Name of the Data Analyzer EAR file. For Data Analyzer, the value is ias.ear. Folder where the Data Analyzer EAR file is located. The EAR file is located in the following directories:
- <WebLogicInstallationDir>/user_projects/domains/<domain name>/applications - <WebSphereInstallationDir>/DeploymentManager/ installableApps - <JBossInstallationDir>/server/informatica/deploy
For more information about the EAR Repackager utility, see Accessing the Data Analyzer EAR file in the Data Analyzer Administrator Guide.
Table 13-4 describes the variable you must configure to run the Import Export utility:
Table 13-4. Import Export Utility Variable
Variable Name JAVA_HOME Description Location of the Java Runtime Environment. By default, the PowerCenter installer installs the JRE in the following directory:
<PowerCenterInstallationDir>/java
For more information about using the Import Export utility, see Using the Import Export Utility in the Data Analyzer Administrator Guide.
updateLicense.bat or updateLicense.sh, located in the following directory in the Data Analyzer utilities directory:
\DataAnalyzer811\license
For more information about using the License Update utility, see Updating a Data Analyzer or Metadata Manager License on page 337. Table 13-5 describes the variables you must configure to run the License Update utility:
Table 13-5. License Update Utility Variables
Variable Name EAR_LOCATION Description Application server directory where the EAR file for the Data Analyzer application is located. The EAR file is located in the following directories:
- <WebLogicInstallationDir>/user_projects/domains/<domain name>/ applications - <WebSphereInstallationDir>/DeploymentManager/installableApps - <JBossInstallationDir>/server/informatica/deploy
Name of the Data Analyzer EAR file. For Data Analyzer, the EAR file name is ias.ear. Location of the Data Analyzer license file to update the expired Data Analyzer license file. Name of the license file you use to update the expired Data Analyzer license file. Location of the Java Runtime Environment. By default, the PowerCenter installer installs the JRE in the following directory:
<PowerCenterInstallationDir>/java
You configure the PowerCenter Integration utility depending on the application server where you run Data Analyzer. You can run Data Analyzer on the following application servers:
JBoss Application Server BEA Weblogic Server IBM WebSphere Application Server
Before you configure the PowerCenter Integration utility for Data Analyzer, you must create an event-based schedule in Data Analyzer. After you configure the schedule, you can configure the PowerCenter Integration utility to notify Data Analyzer when a PowerCenter session completes, based on that schedule. For more information about the PowerCenter Integration Utility and event-based schedules in Data Analyzer, see Managing Event-Based Schedules in the Data Analyzer Administrator Guide.
304
java.naming.provider.url
Host name and JMS Server port number for the application server instance. For example, for JBoss Application Server running on host calvin with the default value for the JMS Server port, enter the following value:
jnp://calvin:1099
4.
Open notifyias.bat or notifyias.sh in a text editor and change the values for the following variables:
Variable Name JAVA_HOME Description Location of the Java Runtime Environment. By default, the PowerCenter installer installs the JRE in the following directory:
<PowerCenterInstallationDir>/java
NOTIFYIAS_HOME CLASSPATH
Directory for the PowerCenter Integration Utility. Use the directory where the notifyias.bat or notifyias.sh file you modify is located. Location of jbossall-client.jar in JBoss Application Server installation directory. For example, enter the following value:
<JBossInstallationDir>/server/client/jbossall-client.jar
5.
Enter one of the following commands at a command prompt or shell command line, where <event name> is the name of the event-based schedule you created in Data Analyzer: On UNIX, enter the following command:
sh notifyias.sh <event name>
305
WebLogic Server
To configure the PowerCenter Integration utility for Data Analyzer running on WebLogic Server, complete the following steps: 1. 2. 3. Copy weblogic.jar from the <Weblogic installation directory>\weblogic81\server\lib directory to the notifyias_Weblogic directory. Rename the notifyias_Weblogic directory to notifyias. Open notifyias.properties in a text editor and change the values for the variables:
Variable Name logfile.location Description Location of the notifyias log file for WebLogic Server. By default, the file is named notifyias.log and is located in the following directory:
<PowerCenterInstallationDir>/DataAnalyzer/notifyias
java.naming.provider.url
Host name and JMS Server port number for the application server instance. For example, for WebLogic Server running on host calvin with the default value for the JMS Server port, enter the following value:
t3://calvin:7001
4.
Open notifyias.bat or notifyias.sh in a text editor and change the values for the following variables:
Variable Name JAVA_HOME Description Location of the Java Runtime Environment. By default, the PowerCenter installer installs the JRE in the following directory:
<PowerCenterInstallationDir>\java
NOTIFYIAS_HOME JAVA_CLASS_PATH
Directory for the PowerCenter Integration Utility. Use the directory where the notifyias.bat or notifyias.sh file you modify is located. Replace the value WEBLOGIC_HOME with the WebLogic Server home directory. For example, enter the following value:
C:\bea\weblogic81
URL
URL for the WebLogic Server instance. For example, for a WebLogic Server running on host calvin, enter the following value:
t3://calvin:7001
5.
Open updateNotifyIASEar.bat or updateNotifyIASEar.sh in a text editor and change the values for the following variables:
Variable Name JAVA_HOME Description Location of the Java Runtime Environment. By default, the PowerCenter installer installs the JRE in the following directory:
<PowerCenterInstallationDir>/java
NOTIFYIAS_HOME
Directory for the PowerCenter Integration Utility. Use the directory where the notifyias.bat or notifyias.sh file you modify is located.
306
6. 7.
Add changeJndiNames.jar and PowerCenterIntegration.jar, located in the notifyias directory, to the system classpath. Enter one of the following commands at a command prompt or shell command line, where <event name> is the name of the event-based schedule you created in Data Analyzer. On UNIX, enter the following command:
sh notifyias.sh <event name>
java.naming.provider.url
Host name and JMS Server port number for the application server instance. For example, for WebSphere Application Server running on host calvin with the default value for the JMS Server port, enter the following value:
iiop://calvin:2809
3.
Open setupClient.bat or setupClient.sh, located in the notifyias\bin directory, in a text editor and change the values for the following variables:
Variable Name COMPUTERNAME DEFAULTSERVERNAME SERVERPORTNUMBER WAS_HOME JAVA_JDK Description Host name of the machine where WebSphere Application Server runs. Fully qualified host name of the machine where WebSphere Application Server runs. For example, <machine name>.<domain name>.com Port number for the WebSphere Application Server. Directory where the notifyias utility is located. Java Development Kit (JDK) directory location for WebSphere Application Server. By default, the JDK is located in the following directory locations:
- <WebSphere installation directory>\DeploymentManager\java - <WebSphere installation directory>\AppServer\java
307
4.
Open notifyias.bat or notifyias.sh in a text editor and change the values for the following variables:
Variable Name NOTIFYIAS_HOME BOOTSTRAP_HOST BOOTSTRAP_PORT Description Directory for the PowerCenter Integration Utility. Use the directory where the notifyias.bat or notifyias.sh file you modify is located. Host name of the machine where WebSphere Application Server runs. Port number for the WebSphere Application Server.
5.
Open updateNotifyIASEar.bat or updateNotifyIASEar.sh, located in the notifyias\bin directory, in a text editor and change the values for the following variables:
Variable Name JAVA_HOME Description Location of the Java Runtime Environment. By default, the PowerCenter installer installs the JRE in the following directory:
<PowerCenterInstallationDir>\java
NOTIFYIAS_HOME
Directory for the PowerCenter Integration Utility. Use the directory where the notifyias.bat or notifyias.sh file you modify is located.
6.
Open sas.client.props, located in the notifyias\properties directory, in a text editor and change the values for the following variables:
Variable Name com.ibm.ssl.keyStore com.ibm.ssl.trustStore Description Location of DummyClientKeyFile.jks. Set the variable to the following value:
\DataAnalyzer811\notifyias\etc\DummyClientKeyFile.jks
7. 8.
Add changeJndiNames.jar and PowerCenterIntegration.jar in the notifyias directory to the system classpath. Enter one of the following commands at a command prompt or shell command line, where <event name> is the name of the event-based schedule you created in Data Analyzer. On UNIX, enter the following command:
sh notifyias.sh <event name>
308
Table 13-6 describes the variable you must configure to run the Repository Backup utility:
Table 13-6. Repository Backup Utility Variable
Variable Name JAVA_HOME Description Location of the Java Runtime Environment. By default, the PowerCenter installer installs the JRE in the following directory:
<PowerCenterInstallationDir>/java
For more information about the Repository Backup Utility, see Using the Command Line Repository Backup Utility in the Data Analyzer Administrator Guide.
Table 13-7 describes the variables you must configure to run the Repository Upgrade Utility:
Table 13-7. Repository Upgrade Utility Variables
Variable Name JAVA_HOME Description Location of the Java Runtime Environment. By default, the PowerCenter installer installs the JRE in the following directory:
<PowerCenterInstallationDir>/java
UTILS_DIR DOMAIN_PATH
Directory where the Data Analyzer utilities are located. Domain path for the application server instance. The domain path depends on the application server where Data Analyzer runs.
For more information about the Repository Upgrade utility, see Run the Repository Upgrade Utility on page 433.
the variables in UpdateSystemAccounts.bat or UpdateSystemAccounts.sh, located in the following directory in the Data Analyzer utilities directory:
\DataAnalyzer811\adminutil\<application server>
Table 13-8 describes the variables you must configure to run the Update System Accounts Utility:
Table 13-8. Update System Accounts Variables
Variable Name DBDRIVER * URL * DBUSER DBPASSWORD UTILITY_DIR JAVA_HOME Description JDBC driver for the Data Analyzer repository database. URL for the Data Analyzer repository database,. Administrator user name for the Data Analyzer repository database. Password for the database administrator. Directory where the Data Analyzer utilities are located. Location of the Java Runtime Environment. By default, the PowerCenter installer installs the JRE in the following directory:
<PowerCenterInstallationDir>/java * For more information about the JDBC drivers and URL for the Data Analyzer repository database, see JDBC Drivers on page 553.
For more information about the Update System Accounts utility, see Working with System User Accounts in the Data Analyzer Administrator Guide.
310
You must configure the utilities before you run them. You configure the variables required by the utilities in the utility script files. To configure the script files, open the files in a text editor and modify the variables values required by the script. Table 13-9 describes the Metadata Manager utilities included in the MetadataManager811 directory:
Table 13-9. Metadata Manager Utilities
Utility Name EAR Repackager Utility License Update Utility Repository Backup Utility Description Unpacks and repackages the customizable files in the Metadata Manager EAR file. For more information, see Ear Repackager Utility on page 311. Updates an expired license in a Metadata Manager EAR file. For more information, see License Update Utility on page 312. Backs up a Metadata Manager repository to a repository backup file and recovers a repository from a repository backup file. For more information, see Repository Backup Utility on page 313. Updates the system accounts in the Metadata Manager repository. For more information, see Update System Accounts Utility on page 313. Upgrades a repository from a previous version of Metadata Manager. For more information, see Upgrading Metadata Manager on page 441.
311
Table 13-10 describes the variables you must configure to run the EAR Repackager utility:
Table 13-10. EAR Repackager Utility Variables
Variable Name ANT_HOME Description Location of the ANT Java build program used by the EAR Repackager Utility. The ANT Java build program is located in the following directory
<PowerCenterUtilityDir>/MetadataManager811/ ear_repackagerutil/ant161
JAVA_HOME
Location of the Java Runtime Environment. By default, the installer installs the JRE in the following directory:
<PowerCenterInstallationDir>/java
Name for the Metadata Manager instance on the application server. For Metadata Manager, the value is imm. Name of the Metadata Manager EAR file. For Metadata Manager, the value is imm.ear. Folder where the Metadata ManagerEAR file is located. The EAR file is located in the following directories:
- <WebLogicInstallationDir>/user_projects/domains/<domain name>/applications - <WebSphereInstallationDir>/DeploymentManager/ installableApps - <JBossInstallationDir>/server/informatica/deploy
For more information about the EAR Repackager utility, see Metadata Manager Utilities in the Metadata Manager Administrator Guide.
Table 13-11 describes the variables you must configure to run the License Update utility:
Table 13-11. License Update Utility Variables
Variable Name EAR_LOCATION Description Application server directory where the EAR file for the Metadata Manager application is located. The EAR file is located in the following directories:
- <WebLogicInstallationDir>/user_projects/domains/<domain name>/ applications - <WebSphereInstallationDir>/DeploymentManager/installableApps - <JBossInstallationDir>/server/informatica/deploy
EAR_FILE
Name of the Metadata Manager EAR file. For Metadata Manager, the EAR file name is imm.ear.
312
For more information about using the License Update utility, see Updating a Data Analyzer or Metadata Manager License on page 337.
Table 13-12 describes the variables you must configure to run the Repository Backup utility:
Table 13-12. Repository Backup Utility Variables
Variable Name JAR_DIR JAVA_HOME Description Location of backup.bat or backup.sh. Location of the Java Runtime Environment. By default, the PowerCenter installer installs the JRE in the following directory:
<PowerCenterInstallationDir>/java
For more information about the Repository Backup Utility, see Metadata Manager Utilities in the Metadata Manager Administrator Guide.
For more information about the Update System Accounts utility, see Metadata Manager Utilities in the Metadata Manager Administrator Guide.
313
Table 13-13 describes the variables you must configure to run the Update System Accounts Utility:
Table 13-13. Update System Accounts Variables
Variable Name DBDRIVER * URL * DBUSER DBPASSWORD UTILITY_DIR JAVA_HOME Description JDBC driver for the Metadata Manager repository database. URL for the Metadata Manager repository database. Administrator user name for the Metadata Manager repository database. Password for the database administrator. Directory where the Metadata Manager utilities are located. Location of the Java Runtime Environment. By default, the PowerCenter installer installs the JRE in the following directory:
<PowerCenterInstallationDir>/java * For more information about the JDBC drivers and URL for the Metadata Manager repository database, see JDBC Drivers on page 553.
314
Chapter 14
Overview, 316 Installing the Informatica Development Platform, 317 Installation Directories, 321
315
Overview
The Informatica Development Platform provides the following PowerCenter application programming interfaces (API) and software development kits (SDK):
Custom Function SDK. Provides an interface that allows you to develop functions written in C and integrate them into PowerCenter. For more information about the Custom Function SDK, see Creating Custom Functions in the PowerCenter Transformation Language Reference. Load Manager API (C). Provides a set of interfaces that allows you to write a C application that accesses the Integration Service and issues commands related to Integration Service administration, workflow, task, reporting, and log requests. Load Manager API (Java). Provides a set of interfaces that allows you to write a Java application to issue commands to the Integration Service to administer the Integration Service and manage workflow, task, reporting, and log requests. For more information about the Java Load Manager API, see Getting Started with the Java Load Manager SDK. Mapping API (Java). Provides a set of interfaces that allows you to generate PowerCenter XML documents containing mappings, sessions, and workflows. Metadata Exchange SDK. Provides a set of COM-based APIs for exchanging metadata with the PowerCenter repository. For more information about the Metadata Exchange SDK, see the PowerCenter Metadata Exchange SDK Guide. PowerCenter Connect SDK. Provides a set of interfaces that allows you to create plug-ins for PowerCenter to extend its functionality. For more information about the PowerCenter Connect SDK, see the PowerCenter Connect SDK Developer Guide. Session Log API. Provides an interface that allows you write your own modules to handle the session log output for PowerCenter. Transformation SDK. Provides an interface that allows you to create custom transformations that call procedures outside of PowerCenter. For more information about the Transformation SDK, see Custom Transformation in the Transformation Guide.
316
To start the installer on Windows, insert the DVD into the DVD drive. If the installer does not start or if you are installing PowerCenter from a hard disk, run install.exe from the DVD root directory or the root directory in the location where you downloaded the installer. -orTo start the installer on UNIX, run install.sh at a shell command line from the DVD root directory or the root directory in the location where you downloaded the installer. The Welcome window introduces the Informatica Development Platform installation.
2.
Click Next. The License Agreement window displays license agreement for the use of the SDKs. You must accept the license agreement to be able to continue.
3.
Select I accept the terms of the license agreement option and click Next. The Installation Set window displays the installation options.
4.
Click Next. The Custom Install Set window displays the list of PowerCenter SDK and APIs available with the Informatica Development Platform.
6. 7.
Select the SDKs and APIs you want to install. Click Next.
318
8.
On the Choose Installation Folder window, select enter the folder where you want to install the PowerCenter SDKs.
9.
Click Next. The Pre-Installation Summary window summarizes the installation information.
10.
319
11.
When the installation completes, the installer displays a message about whether the installation completed successfully.
12.
Click Done.
After the PowerCenter SDK installation completes, you can view the log file created during the installation. For more information about the PowerCenter log files, see Installer Log Files on page 362.
320
Installation Directories
The Informatica Development Platform installer installs the PowerCenter SDKs in the directory you provide. The default Informatica Development Platform installation directory is c:/InformaticaDeveloperPlatform8.1.1. The Informatica Development Platform installer installs the APIs and SDKs in the following subdirectories:
Name Custom Function SDK Load Manager API (C) Load Manager API (Java) Mapping API (Java) Metadata Exchange SDK PowerCenter Connect SDK Session Log API Transformation SDK Directory <SDKInstallationDir>/EP_AEP_CT <SDKInstallationDir>/LoadManager_API <SDKInstallationDir>/Java_LM_API <SDKInstallationDir>/Mapping_SDK <SDKInstallationDir>/Metadata_Exchange_SDK <SDKInstallationDir>/PowerCenter_Connect_SDK <SDKInstallationDir>/SessionLog_API <SDKInstallationDir>/Expression_SDK
Installation Directories
321
322
Chapter 15
Overview, 324 Configuring Informatica Services, 325 Configuring Application Services, 328 Configuring the Metadata Manager Scheduler Service, 330 Creating a Data Profiling Warehouse, 331 Configuring the PowerCenter Integration Utility for WebSphere, 334 Updating a Data Analyzer or Metadata Manager License, 337 Configuring Microsoft SQL Server for a Data Analyzer Repository, 338 Setting Up the PowerCenter Repository Reports, 339 Setting Up the Data Analyzer Data Profiling Reports, 351 Configuring INFA_HOME, 357
323
Overview
After you install PowerCenter, you must configure PowerCenter components. The tasks you must complete depend on he PowerCenter components you install. Configure the following PowerCenter components after you install PowerCenter:
Informatica Services. Informatica runs as a service on Windows. You can configure the service to start when the operating system starts, configure the service to automatically restart if the service fails, and configure the user account that logs on to the service. For more information, see Configuring Informatica Services on page 325. Application services. Configure application service properties if the installer could not create or enable a Repository Service during installation or you want to configure additional properties. For more information about configuring application service during or after installation, see Configuring Application Services on page 328. Metadata Manager Scheduler service. Configure the Metadata Manager Scheduler service properties if you want to run the Business Objects XConnect on a schedule. For more information about configuring the Metadata Manager Scheduler service, see Configuring the Metadata Manager Scheduler Service on page 330. Data Profiling. Create the Data Profiling warehouse. For more information, see Creating a Data Profiling Warehouse on page 331. PowerCenter Integration Utility. If you run Data Analyzer on IBM WebSphere Application Server, you must configure the PowerCenter Integration Utility client resource (notifyias.ear). For more information, see Configuring the PowerCenter Integration Utility for WebSphere on page 334. Data Analyzer and Metadata Manager licenses. You can use the License Update utility to update an expired Data Analyzer or Metadata Manager license. For more information about updating a license, see Updating a Data Analyzer or Metadata Manager License on page 337. Microsoft SQL Server for a Data Analyzer repository. If you use a Microsoft SQL Server database for the Data Analyzer repository, you must configure JDBC distributed transaction support in the repository database. For more information, see Configuring Microsoft SQL Server for a Data Analyzer Repository on page 338. PowerCenter Repository Reports. If you installed PowerCenter Repository Reports, you can set up the reports in Data Analyzer. For more information, see Setting Up the PowerCenter Repository Reports on page 339. Data Profiling reports. If you installed Data Analyzer Data Profiling reports, you can set up the reports in Data Analyzer. For more information, see Setting Up the Data Analyzer Data Profiling Reports on page 351. INFA_HOME. Configure INFA_HOME to the location of the PowerCenter Services installation directory or the directory where the installed PowerCenter Services files are located. For more information, see Configuring INFA_HOME on page 357.
324
The installer installs and starts Informatica Services. Informatica Services starts the Service Manager for a node. The Service Manager runs within Informatica Services. Informatica Services runs as a service on Windows and as a daemon on UNIX. The Service Manager runs application services on a node. You can configure the Informatica Services service on Windows. You can configure the service behavior when the operating system starts or when the service fails, and configure the user account that logs on to the service. For more information about starting and Stopping Informatica Services, see Starting and Stopping Informatica Services on page 529. The PowerCenter installer can install the Informatica Services service on the Local System account on Windows. If you store files on a network drive, use a system account instead of the Local System account to run Informatica Services. If you want to use the Local System account, make sure the user starting Informatica Services has access to the network location. If you configure shared storage on a network drive to store files used by the domain or the application services that run on the domain, the user account that runs Informatica Services must have access to the shared location. If the user account used to start Informatica Services cannot access the shared storage location, service processes on the node fail or the node or domain will not start.
Note: If you configure a system user account, the user account must have the Act as operating
From the Start Menu, click Administrative Tools > Services. Double-click Informatica Services.
325
3.
4. 5. 6. 7.
On the Log On tab, select This account. Type the domain and user name or click Browse to locate a system user. Enter and confirm the password for the selected user account. Click the Recovery tab.
326
8.
For more information about configuring system accounts for services and service restart options on Windows, see the Windows documentation.
327
You can create and configure application services in a PowerCenter domain during or after installation. You may need to configure application services during installation if the application service was not enabled during installation. You may need to create and configure application services after installation if you require additional application services in the domain. You use the Administration Console to configure application services. You can create and configure the following application services during or after installation:
Repository Service. Create or configure a Repository Service for a PowerCenter repository. For more information about why you might need to create or configure a Repository Service, see Creating and Configuring the Repository Service on page 328. Integration Service. Create or configure an Integration Service for an associated Repository Service. For more information about why you might need to create or configure an Integration Service, see Creating and Configuring the Integration Service on page 329.
The Repository Service could not be created during installation. If you perform a custom installation of PowerCenter Advanced Edition and install PowerCenter Services or you perform a complete installation of PowerCenter Standard Edition, the installer allows you to skip Repository Service creation. If you choose not to install the Repository Service, or the installer cannot create the Repository Service due to an error, you can continue with the installation without creating the service. However, you must create the service after installation completes.
The Repository Service could not be enabled during installation. If the installer cannot enable a Repository Service during installation, you can correct the Repository Service configuration in the Administration Console to continue with the installation. For example, you select an incorrect code page for an existing PowerCenter repository during installation. The installer creates the Repository Service but cannot enable the Repository Service process. You can modify the code page for the Repository Service in the Administration Console, enable the service process, and continue the installation.
You want to configure additional Repository Service properties. The installer creates a Repository Service with a default set of properties. You can configure additional properties for the Repository Service in the Administration Console. For example, you want to enable versioning for a repository. The installer does not enable versioning when it creates a Repository Service. You can enable versioning for the Repository Service after installation.
328
You perform a complete installation of PowerCenter Advanced Edition. The PowerCenter Advanced Edition installer creates the Repository Service and configures the PowerCenter repository for Metadata Manager. After installation, you must use the Administration Console to create a Repository Service to connect to the PowerCenter repository. Your installation includes multiple PowerCenter repositories. You can create one Repository Service with the installer. If you require multiple repositories, you must create the additional Repository Services for the repositories in the Administration Console.
For more information about creating and configuring a Repository Service, see Creating and Configuring the Repository Service in the Administrator Guide.
The Integration Service could not be created during installation. If you perform a custom installation of PowerCenter Advanced Edition and install PowerCenter Services or you perform a complete installation of PowerCenter Standard Edition, the installer allows you to skip Integration Service creation. If you choose not to install the Integration Service or the installer cannot create the Integration Service due to an error, you can continue with the installation without creating the service. However, you must create the service after installation completes.
The Integration Service could not be enabled during installation. If the installer cannot enable an Integration Service during installation, you can correct the Integration Service configuration in the Administration Console to continue with the installation. The installer skipped Repository Service creation. You need to create an Integration Service if the installer skipped creating the Repository Service during installation. If you skip creating a Repository Service, the installer also skips Integration Service creation. You want to configure additional Integration Service properties. The installer creates an Integration Service with a default set of properties. You can configure additional properties for the Integration Service in the Administration Console. For example, you want to configure $PMRootDir for an Integration Service process. The installer uses the server/infa_shared directory on the machine where the installer runs as the location of the Integration Service run-time files. If you want to change the location, you must configure the Integration Service after installation.
You perform a complete installation of PowerCenter Advanced Edition. The PowerCenter Advanced Edition installer creates the Integration Service for Metadata Manager. After installation, you must use the Administration Console to create an Integration Service.
For more information about creating and configuring an Integration Service, see Creating and Configuring the Integration Service in the Administrator Guide.
329
After you install or upgrade Metadata Manager Client, you must configure the Informatica PowerCenter Metadata Manager Scheduler service to interact with the desktop if you want to run the Business Objects XConnect on a schedule.
To configure the service to interact with the desktop: 1.
On the Metadata Manager Console machine, navigate to the Services window. For example, in Windows XP Professional, select Settings > Control Panel > Administrative Tools > Services.
2.
Stop the Informatica PowerCenter Metadata Manager Scheduler service. To stop the service, right-click the service and click Stop.
3.
Right-click Informatica PowerCenter Metadata Manager Scheduler service and select Properties. The Informatica PowerCenter Metadata Manager Scheduler Properties window appears.
4. 5. 6.
Click the Log On tab. Select the Allow Service to Interact with Desktop option. Click OK to close the Informatica PowerCenter Metadata Manager Scheduler Properties window. The Services window appears again.
7.
Start the Informatica PowerCenter Metadata Manager Scheduler service. To start the service, right-click the service and click Start.
8. 9.
Click OK to close the Informatica PowerCenter Metadata Manager Scheduler dialog box. Close the Services window.
330
Create a Data Profiling warehouse for each PowerCenter repository in which you want to store data profiles. You can create a Data Profiling warehouse on any relational database that PowerCenter supports as a source and target database. You can also create the Data Profiling warehouse on the same database instance as the PowerCenter repository. Complete the following steps to create the Data Profiling warehouse: 1. 2. 3. 4. Run scripts to create the Data Profiling warehouse. Create the Data Profiling warehouse views for Data Analyzer (Optional). Configure connectivity to the Data Profiling warehouse. Configure a data source and data connector for Data Analyzer (Optional).
Table 15-1 shows the script you must run for each database type:
Table 15-1. Scripts for Creating a Data Profiling Warehouse
Database Type IBM DB2 UDB Informix Microsoft SQL Server Oracle Script create_schema_db2.sql create_schema_inf.sql create_schema_sql.sql To create the warehouse... Connect to DB2. Enter the following command from the command line: db2 -tvf create_schema_db2.sql Run the dbaccess command line program. Select create_schema_inf.sql as the file you want to execute. Select Run. Open Query Analyzer. Run the create_schema_sql.sql script. Note: Use Query Analyzer rather than isql to run the script. Otherwise, the script may not run successfully. Run the following command from the command line: sqlplus <user name>/<password>@<database server> @create_schema_ora.sql
create_schema_ora.sql
331
Teradata
create_schema_ter.sql
Step 2. Create the Data Profiling Warehouse Views for Data Analyzer (Optional)
If you want to use Data Analyzer to view Data Profiling reports, you can create views in the Data Profiling warehouse for Data Analyzer to use. If you create a Data Profiling warehouse on Informix, you cannot use Data Analyzer to view Data Profiling reports. After you create the Data Profiling warehouse, you can run a script to create views. When you install PowerCenter, the installer places the script in the following directory:
<PowerCenter Client>\bin\Extensions\DataProfile\ProfileWarehouse\DA811 \DAViews
Table 15-2 shows the script you must run for each target database type:
Table 15-2. Scripts for Creating the Data Profiling Warehouse Views
Database Type IBM DB2 UDB Microsoft SQL Server Oracle Script upgrade_05_db2.sql upgrade_05_sql.sql To create the Data Profiling warehouse views for Data Analyzer... Connect to DB2. Enter the following command from the command line: db2 -tvf upgrade_05_db2.sql Open Query Analyzer. Run the upgrade_05_sql.sql script. Note: Use Query Analyzer rather than isql to run the script. Otherwise, the script may not run successfully. Run the following command from the command line: sqlplus <user name>/<password>@<database server> @upgrade_05_ora.sql Run the following command from the command line:
isql -U <user name> -P <password> -S <database server> -i upgrade_05_syb.sql
upgrade_05_ora.sql
Sybase ASE
upgrade_05_syb.sql
Teradata
upgrade_05_ter.sql
Open Teradata SQL Assistant. Open the file upgrade_05_ter.sql and click Execute. You can also run the script from BTEQWin. Do not use the Execute Parallel option in Teradata Client 6.2. This option produces errors and the Data Profiling warehouse creation fails.
332
Step 4. Configure a Data Source and Data Connector for Data Analyzer (Optional)
To view Data Analyzer Data Profiling reports in PowerCenter 8.1.1, you configure a data source and data connector in Data Analyzer. Complete the following steps to configure Data Analyzer Data Profiling reports: 1. Configure a data source for the Data Profiling warehouse in Data Analyzer. You must configure a data source for each Data Profiling warehouse that contains data profile results for which you want to view with Data Analyzer Data Profiling reports. Create a data connector in Data Analyzer. If you do not already have a data connector, you must create one. When you create the data connector, add the Data Profiling warehouse data source to the data connector.
2.
For information on configuring a data source and data connector, see Setting Up the Data Analyzer Data Profiling Reports on page 351.
333
If you run Data Analyzer on IBM WebSphere Application Server, you must configure the PowerCenter Integration Utility client resource (notifyias.ear). Use the IBM WebSphere Application Server utility called Application Client Resource Configuration Tool to configure the notifyias.ear file. After you configure the notifyias.ear, you must also update the notifyias.properties file. To configure the PowerCenter Integration Utility for Data Analyzer running on IBM WebSphere Application Server, complete the following steps: 1. 2. Configure the notifyias.ear file. Update the notifyias.properties file.
Start the Application Client Resource Configuration Tool. Go to the /bin directory of the PowerCenter Integration Utility and run the clientconfig program. By default, the PowerCenter Integration Utility is installed in the following directory:
/<PowerCenterInstallationDir>/DataAnalyzer/notifyias/
In the /notifyias/bin/ directory, run the following command: Windows: clientconfig.bat UNIX: clientConfig.sh The Application Client Resource Configuration Tool window appears.
2. 3. 4. 5. 6.
On the menu, choose File > Open. Navigate to the directory where the PowerCenter Integration Utility is installed and select the file notifyias.ear. Click Open. On the configuration tool menu, click PowerCenterIntegration.jar > JMS Providers. Right-click WebSphere JMS Providers, and then select Properties.
334
Select the General tab. In the Context Factory Class property, enter the following factory class name:
com.ibm.websphere.naming.WsnInitialContextFactory
9.
In the Provider URL property, enter the IBM WebSphere Application Server host name and JMS server port number. The machine that hosts Data Analyzer also hosts IBM WebSphere Application Server. The host name must start with iiop://. The JMS server uses the default port number 9810 to communicate with the PowerCenter Integration Service. For example, if the Data Analyzer host name is sculder.mully.com and the JMS server uses the default port, enter the following host name and port:
iiop://sculder.mully.com:9810
Click OK. On the configuration tool menu, click PowerCenterIntegration.jar > JMS Providers > WebSphere JMS Providers > WAS Queue Connection Factories. Right-click jms/QueueConnectionFactory and select Properties. The Queue Connection Factory Properties window appears.
13. 14.
Select the General tab. Enter the user name and password: padaemon. This is the default user name and password used to install IBM WebSphere Application Server. If you used another user name and password to install IBM WebSphere Application Server, enter the name you selected.
15.
Enter the node name for IBM WebSphere Application Server. You set the node name when you install IBM WebSphere Application Server. The default node name is typically the name of the machine hosting IBM WebSphere Application Server. The node name is case sensitive.
Verify that the application server is JMS server. Click OK. On the configuration tool menu, click PowerCenterIntegration.jar > JMS Providers > WebSphere JMS Providers > WAS Topic Connection Factories. Right-click jms/TopicConnectionFactory and select Properties. The Topic Connection Factory Properties window appears.
20. 21.
Select the General tab. Enter the user name and password: padaemon.
335
This is the default user name and password used to install IBM WebSphere Application Server. If you used another user name and password to install IBM WebSphere Application Server, enter the name you selected.
22.
Enter the node name for IBM WebSphere Application Server. You set the node name when you install IBM WebSphere Application Server. The default node name is typically the name of the machine hosting IBM WebSphere Application Server.
Verify that the application server is JMS server.In the Port option, select QUEUED. Click OK. From the menu, choose File > Save. Choose File > Exit to close the Application Client Resource Configuration Tool.
2. 3.
Open the file with a text editor. Search for the following text:
ProviderURL=
4.
Set the provider URL property to the IBM WebSphere Application Server host name:
iiop://<WASHostName>:<JMSPortNumber>
The machine that hosts Data Analyzer also hosts IBM WebSphere Application Server. The host name must start with iiop://. The JMS server uses the default port number 9810 to communicate with the PowerCenter Integration Service. The value of the provider URL property in the notifyias.properties file must match the value of the Provider URL property in the notifyias.ear file. For more information, see step 9 in Step 1. Configure the notifyias.ear File on page 334.
5.
336
You can use the License Update utility to update the license for Data Analyzer or Metadata Manager. For example, if the Data Analyzer or Metadata Manager license expires, you can use the utility to add a new license key. When you install Data Analyzer or Metadata Manager, the PowerCenter installer adds the license key to the appropriate EAR file. There is a separate EAR file for Data Analyzer and Metadata Manager. The EAR file must contain a valid license key file for you to run Data Analyzer or Metadata Manager. To update a license, copy the license key file to the License Upgrade utility directory and run the utility. On Windows, run the License Update utility from the command line. On UNIX, run the License Update utility as a shell script.
To update a Data Analyzer or Metadata Manager license: 1.
Copy the new license key file to the License Update utility directory. Copy the file to the appropriate directory:
Application Data Analyzer Metadata Manager License Update Utility Directory <Installation directory>\DataAnalyzer\license <Installation directory>\MetadataManager\license
2.
Run the License Update utility. For Windows, run the updateLicense.bat utility from the command line. For UNIX, run the updateLicense.sh utility as a shell script.
3.
337
Data Analyzer requires JDBC distributed transaction support in the repository database. When you use Microsoft SQL Server 2000 or 2005 with Data Analyzer, you must configure distributed transaction support in Microsoft SQL Server. To configure distributed transaction support on Microsoft SQL Server, you install JDBC XA stored procedures. Complete the following steps to install JDBC XA stored procedures on Microsoft SQL Server: 1. 2. 3. Back up the master database for the Microsoft SQL Server instance. Copy sqljdbc.dll to the <Microsoft SQL Server installation directory>\Binn directory from the <PowerCenter installation directory>\DataAnalyzer\SQLServerJTA directory. Use the following command to run instjdbc.sql:
isql -U <database administrator name> -P <administrator password> -S <SQL Server name> -i <PowerCenter installation directory>\DataAnalyzer\SQLServerJTA\instjdbc.sql
The script generates a large amount of messages. View the messages for errors generated by the script to troubleshoot issues with the installation. The script may fail if there is insufficient space in the master database to store the procedures or log changes to the existing procedures.
338
To set up the PowerCenter Repository Reports, complete the following steps: 1. Create a data source to access the metadata for the reports. The PowerCenter Repository Reports display metadata from a PowerCenter repository. Create a data source in Data Analyzer to access the metadata from the PowerCenter repository. Add the data source to a data connector. To run the PowerCenter Repository Reports, you need a data connector that uses the data source to read metadata in the PowerCenter repository. Set up schedules for cached reports. To regularly update the reports and indicators, run the PowerCenter Repository Reports on specific schedules.
2.
3.
After you set up the PowerCenter Repository Reports, you can view and use the reports just like any other Data Analyzer reports. For more information about working with Data Analyzer reports, see the Data Analyzer User Guide.
In Data Analyzer, click Administration > Schema Design > Data Sources. On the Data Source page, click Add.
339
3.
4.
Enter the data source information for the PowerCenter repository. The following table describes the database information you need to enter to create the JDBC data source:
Property System Name Required/ Optional Required Description Name of the data source must be unique. The system name can include any character except a space, tab, newline character, and the following special characters: \/:*?<>|&[] Description for the data source. Maximum length for the description of the data source is 255 characters. Database type of the PowerCenter repository. You can run PowerCenter Repository Reports on the following databases: - Oracle - Microsoft SQL Server - IBM DB2 Select the database for the PowerCenter repository you want to report on. JDBC driver name. Data Analyzer supplies the driver name for the selected database drivers.
Optional Required
Driver Name
Required
340
Description JDBC driver connection string. Data Analyzer supplies the connection string syntax for the selected database driver. The connection string requires the JDBC driver URL and database server information. Enter the host name, port, and database information for the PowerCenter repository database. User name to connect to the PowerCenter repository database. Password for the user name to connect to the PowerCenter repository database. Table used to test the connection between Data Analyzer and the PowerCenter repository. When you select the server type, Data Analyzer supplies the table name. To use another table to test the connection, enter a table name. Select a small table to test the connection to avoid a performance impact at run time.
5. 6.
Select PowerCenter Repository. Click Test Connection. If the connection fails, verify that the repository database information is correct. Consult your database administrator if necessary.
7.
Create a data connector. If Data Analyzer does not have data connectors, create a data connector and add the PowerCenter Repository Reports data source to it. Add the data source to the system data connector. If Data Analyzer has data connectors, you can add the PowerCenter Repository Reports data source to the system data connector.
341
In Data Analyzer, click Administration > Schema Design > Data Connectors. The list of data connectors defined in the repository appears in the task area. The list is empty if no data connectors have been defined.
2.
3. 4.
Enter a name and description for the data connector. From the Primary Data Source list, select the PowerCenter repository data source. This is the JDBC data source you created in Step 1. Create a Data Source on page 339.
5.
Click OK. When you create the first data connector in Data Analyzer, Data Analyzer saves the data connector to the repository as the system data connector, making it available to all users. All Data Analyzer users can run the PowerCenter Repository Reports.
342
In Data Analyzer, click Administration > Schema Design > Data Connectors. The list of data connectors defined in the repository appears in the task area.
2.
Click the name of the system data connector or the data connector you want to use for PowerCenter Repository Reports. The Data Connector page displays the data sources included in the data connector.
3.
In Additional Schema Mappings, click Add. The Additional Schema Mappings section expands to allow you to enter additional data sources.
343
4.
From the Data Source list, select the PowerCenter repository data source.
5. 6.
Add the JDBC data source that you created in Step 1. Create a Data Source on page 339. In the Available Schemas list, select the following schemas:
DEPLOYMENT LABEL MAPPING MAPPLET METADATA SECURITY SESSION SOURCE TARGET TRANSFORM VERSION WORKFLOW WORKLET
7. 8.
Click Add >> to move the schemas to the Selected Schemas list. Click Add. Data Analyzer adds the JDBC data source to the data connector and displays it in the list of additional schema mappings.
9.
Click OK. If you add the data source for PowerCenter Repository Reports to the system data connector, you cannot edit the list of users who can use the data connector.
344
Click the Find tab. Click Public Folders > PowerCenter Repository Reports. Select one of the cached reports to which you want to add to a schedule. The reports are organized into folders. Navigate through the folders to locate each cached report. Table 15-3 describes the cached reports, their folder location, and associated schedules:
Table 15-3. PowerCenter Repository Reports Cached Report Schedules
Cached Report Average Load Times (Last Month) Connection Usage Failed Session Statistics (Started Today) Invalid Mapping Statistics by Folder Mapping Statistics by Folder Server Load (Yesterday) Sessions with Rejected Rows (Yesterday) Source Statistics by Folder Target Statistics by Folder Top 10 Sessions with Rejected Rows (Yesterday) Report Folder Path Operations > Session Execution Operations > Session Execution Operations > Session Execution PowerCenter Objects > Mappings PowerCenter Objects > Mappings Operations > Session Execution Operations > Session Execution PowerCenter Objects > Sources PowerCenter Objects > Targets Operations > Session Execution Schedule Monthly Midnight Daily Hourly Midnight Daily Midnight Daily Midnight Daily Midnight Daily Midnight Daily Midnight Daily Midnight Daily
345
For example, to select the report named Average Load Times (Last Month), click PowerCenter Repository Reports > Operations > Session Execution. Next, select Average Load Times (Last Month).
4.
5.
Click Publish.
346
6.
On the Properties tab, select the Cached option, and then select the name of a schedule from the list of schedules.
Select a schedule.
For a list of the cached reports and their assigned schedules, see Table 15-3 on page 345.
7. 8.
Click Save to save the report. Click Close after Data Analyzer displays the following message:
The report has been saved successfully.
9.
Repeat steps 3 to 8 to associate all other PowerCenter Repository Reports cached reports to specific schedules. You might want to review the properties of the cached reports listed in Table 15-3 on page 345 to verify that the correct schedule has been added to each report.
347
10.
To verify the schedule for a report, select a report and look at the Report Properties section to identify the attached schedule.
Starting Schedules
PowerCenter Repository Reports provides several schedules to run reports. These schedules run cached reports at regular intervals. After you attach the cached reports to schedules, start the schedules to generate the cached reports. Data Analyzer caches the results for the reports when the schedules run. You can open the report to view the cached data. If you want to update report results before the next scheduled run, manually start the schedule again.
348
Click Administration > Scheduling > Time-Based Schedules. A list of schedules appears.
2.
Click Run Now for the schedule that you want to start. For example, to start the Midnight Daily schedule, click Run Now next to the Midnight Daily schedule. Data Analyzer adds the reports in the schedule to the queue and then runs the scheduled reports.
3.
Click OK to clear the acknowledgement message. After you run the scheduled reports, click Dashboards to view the report indicators and access the reports on the dashboards.
2.
3.
Use the global variables appropriate for the database type. When you install the PowerCenter Repository Reports, you install global variables specific to the database type of your PowerCenter repository. If the new repository is of a different database type, you must delete the existing global variables and import the global variable XML file that is applicable to the new database type. By default, the PowerCenter Repository Reports XML files are installed in the following directory:
/Informatica/PowerCenter8.1.1/DataAnalyzer/RepositoryReports
For more information about deleting global variables, see Working with Global Variables in the Data Analyzer Schema Designer Guide. For more information about importing global variables, see Importing Objects to the Repository in the Data Analyzer Administrator Guide. Use this procedure when you run the PowerCenter Repository Reports on a new PowerCenter repository. If you already have a data source for a repository, you only need to modify the data connector. If the PowerCenter repositories are of the same database type, you do not need to update the global variables.
350
If you want to view Data Profiling reports with Data Analyzer, you must install and configure Data Analyzer. You must be a Data Analyzer user with a System Administrator role to set up the Data Profiling reports. To install Data Analyzer Data Profiling reports, complete the following steps: 1. Configure a data source for the Data Profiling warehouse in Data Analyzer. Configure a data source for each Data Profiling warehouse that contains profiling data for which you want to view Data Analyzer Data Profiling reports. Create a data connector in Data Analyzer. If you do not have a data connector, you must create one. When you create the data connector, add the Data Profiling warehouse data source to the data connector. If you create a data connector, you can skip the next step. Add the Data Profiling warehouse data source to a data connector in Data Analyzer. If you already have a data connector, add the Data Profiling warehouse data source to the data connector. If you recently created a data connector, you should have already added the Data Profiling warehouse data source to the data connector.
2.
3.
In Data Analyzer, click Administration > Schema Design > Data Sources. On the Data Sources page, click Add.
351
3.
4.
Select the server type of the Data Profiling warehouse. Data Analyzer provides JDBC drivers to connect to the Data Profiling warehouse. When you select the server type, Data Analyzer supplies the driver name and connection string format for the JDBC drivers that Data Analyzer provides.
Note: You cannot create an Informix data source.
5. 6. 7.
Customize the JDBC connection string with the information for the warehouse. Enter the user name and password to connect to the warehouse. Test the connection. If the connection fails, verify that the warehouse information is correct. Consult your database administrator if necessary.
8.
For more information about Data Analyzer data sources, see the Data Analyzer Administrator Guide.
However, you must add the Data Profiling data source to the data connector. For more information about adding a data source to a data connector, see Step 3. Add a Data Profiling Data Source to a Data Connector on page 354.
To create a data connector: 1.
352
The list of data connectors defined in the repository appears in the task area.
2.
3.
Optional Required
Description for the data connector. The connector description can be between 1 and 255 characters. Primary data source from the list of data sources available in Data Analyzer. Data Analyzer uses this data source to connect to the Data Profiling warehouse and read the metric and attribute data for a report. For information about how Data Analyzer connects to the primary and additional data sources, see the Data Analyzer Administrator Guide.
353
If you do not want to set up additional data sources, click OK. If this is the first data connector in Data Analyzer, Data Analyzer saves the data connector to the repository as the system data connector, making it available to all users. You cannot edit the list of users who can use this data connector. If this is not the system data connector, you can edit the list of users who can use this data connector. You can activate this data connector in addition to the system data connector.
Data Profiling data source. Click the data connector name to see if the data source is listed as the primary data source. For more information about Data Analyzer data connectors, see the Data Analyzer Administrator Guide.
To add the Data Profiling warehouse data source to the system data connector: 1.
Click Administration > Schema Design > Data Connectors. The Data Connectors page appears.
2.
354
3.
In the Additional Schema Mappings, click Add. Data Analyzer expands the section and displays the available schemas in the repository.
4.
In the Data Source list, select the Data Profiling data source you created in Step 1. Configure a Data Source for the Data Profiling Warehouse on page 351.
5. 6.
In the Available Schemas section, select the Data Profiling schemas you want to add and click Add >>. Click Add.
355
Data Analyzer displays the additional schema mappings for the system data connector.
7.
Click OK.
You can now run Data Profiling reports using the system data connector.
356
Configuring INFA_HOME
Use INFA_HOME to designate the PowerCenter Services installation directory. If you modify the PowerCenter Services directory structure, you need to configure the environment variable to the location of the PowerCenter Services installation directory or the directory where the installed PowerCenter Services files are located. For example, you use a softlink in UNIX for any of the PowerCenter Services directories. To configure INFA_HOME so that any PowerCenter Services application or service can locate the other PowerCenter components it needs to run, configure INFA_HOME to the location of the PowerCenter Services installation directory.
Configuring INFA_HOME
357
358
Chapter 16
Overview, 360 Installer Log Files, 362 Troubleshooting Domains and Nodes, 366 Troubleshooting Application Services, 369 Troubleshooting Data Analyzer and Metadata Manager, 372 Troubleshooting Application Servers, 373 Troubleshooting the PowerCenter Client, 376 Installer Error Messages, 377
359
Overview
The installer configures and starts PowerCenter components, configures the Data Analyzer and Metadata Manager applications, and starts the application server. The installer collects information about the PowerCenter components you want to install, such as the installation directory, license keys, and application server. It copies the PowerCenter product files to the installation directory. After the installer copies the files to the installation directory, you configure the PowerCenter components. The installer may generate errors or warnings based on what you install:
Domain and nodes. The installer creates a domain and gateway node or creates a node and adds it to a domain. It also starts Informatica Services on a node and adds or updates license objects in the domain. For more information about troubleshooting domain and node creation, see Troubleshooting Domains and Nodes on page 366. Application services. The installer creates and enables a Repository Service and Integration Service during installation. It also creates the content for a PowerCenter repository or restores the content for the PowerCenter repository for Metadata Manager. For more information about troubleshooting creation of Repository Services and Integration Services, see Troubleshooting Application Services on page 369. Data Analyzer and Metadata Manager repositories. If you use a new Data Analyzer or Metadata Manager repository, the installer creates the repository. It also switches the database connection in the PowerCenter repository for Metadata Manager. For more information about troubleshooting creation of the repositories for Data Analyzer and Metadata Manager, see Troubleshooting Data Analyzer and Metadata Manager on page 372. Data Analyzer and Metadata Manager applications. The installer deploys the Data Analyzer and Metadata Manager applications on JBoss Application Server, BEA WebLogic Server, or IBM WebSphere Application Server. The installer installs and configures Data Analyzer and Metadata Manager and configures and starts the application server. For more information about troubleshooting errors during deployment of Data Analyzer and Metadata Manager on an application server, see Troubleshooting Application Servers on page 373. PowerCenter Client. You may encounter errors when installing the PowerCenter Client. For more information about troubleshooting errors during the PowerCenter Client installation, see Troubleshooting the PowerCenter Client on page 376.
Note: Use the information in this chapter to get more information about the installation
process and the cause and resolution of errors that occur during the installation of PowerCenter. The examples included in this chapter are intended to illustrate general troubleshooting strategies and are not a comprehensive list of possible causes of installation issues. For more information about the error messages generated by the installer, see Installer Error Messages on page 377.
360
Troubleshooting Process
The PowerCenter installer allows you to incrementally configure PowerCenter components during installation. The installer prompts for configuration information and then configures the components. The installer validates the information in the installer window before proceeding. If the verification passes, the installer configures the component with the information in the installer window. If the installer fails to validate the information, or fails to successfully configure or start the component, it generates an error message. For example, if you create a domain, the installer creates the domain and gateway node and starts Informatica Services. If the installer cannot start Informatica Services, it generates an error. After you resolve the error and the installer starts Informatica Services, you can continue to configure the other PowerCenter components. Depending on the type of error, you may be able to continue the installation and resolve the error later. For example, if you install PowerCenter Services without Metadata Manager and the repository content creations fails for the PowerCenter repository, you can ignore the error, skip repository content creation, and continue with the installation. Use the PowerCenter Administration Console to correct the error and create the PowerCenter repository content after installation completes. For more information about whether you can skip the configuration of a PowerCenter component, see Installer Error Messages on page 377.
Note: On Windows, if you leave the installer window when an error dialog box is open, you
Overview
361
Installation log files. Includes debug, summary, and installation log files. For more information, see Installation Log Files on page 362. Service Manager log files. Log files for the start up of the Service Manager for a node. For more information, see Service Manager Log Files on page 364. Services log files. Log events for a PowerCenter domain and application services in a domain. For more information, see Services Log Events on page 365.
Location Usage
Contents
The installer uses the PowerCenter infacmd and infasetup commands to create the domain and node and create and start application services. It uses pmrep commands to create the PowerCenter repository database tables and create and switch the database connection in the
362
PowerCenter repository for Metadata Manager. The installation debug log contains the output of these commands. For more information about the infacmd, infasetup, and pmrep commands, see the PowerCenter Command Line Reference. You can find more information about errors generated by these commands in the PowerCenter Troubleshooting Guide.
SUCCESS. The creation or configuration of the component was successful. FAILURE. The creation or configuration of the component failed. This may occur if the installer could not create a domain or node, or the installer could not create or start a required service. SKIPPED. The creation or configuration of the component was skipped. This may occur if a previous required component could not be created or configured, or you choose an existing repository for PowerCenter, Metadata Manager, or Data Analyzer. For example, if you choose an existing repository for the PowerCenter repository, the PowerCenter repository creation status in the installation summary log indicates that creation was skipped for that component. The installation summary log might indicate that the configuration of a component was skipped if creation or configuration of a previous component failed or you chose to ignore an error generated by the installer. For example, if the installer cannot create a PowerCenter repository, it skips the creation of the Metadata Manager and Data Analyzer repositories.
363
Note: The creation of some PowerCenter components can have a failure status, but the
installation succeeds with warnings. Use the component status listed in the summary log file to find out which components you need to configure after installation.
catalina.out. Log events from the Java Virtual Machine (JVM) that runs the Service Manager. For example, if a port is available during installation, but in use when the Service Manager starts, you can use this log to get more information about which port was unavailable during startup of the Service Manager. node.log. Log events generated during the startup of the Service Manager on a node. You can use this log to get more information about why the Service Manager for a node failed to start. For example, if the Service Manager cannot connect to the domain configuration database after 30 seconds, the Service Manager fails to start. localhost_log.<date>.txt. Internal log events from the Service Manager running on a node. Log events are written to this file during startup and shutdown of a node.
Note: The Service Manager also uses node.log to log events when the Log Manager is
unavailable. For example, if the machine where the Service Manager runs does not have
364
enough available disk space to write log event files, the Log Manager is unavailable. For more information, see Managing Logs in the Administrator Guide.
Domain. Use the domain log to view log events related to the creation of application services during installation. Integration Service. Use the Integration Service log events to troubleshoot issues related to the startup of Integration Services during installation. Repository Service. Use the Repository Service log events to troubleshoot issues related to the startup of Repository Services and the creation of PowerCenter repository content during installation.
For more information about using the Log Viewer in the Administration Console, see Managing Logs in the Administrator Guide. For more information about logging in to the Administration Console, see Logging in to the Administration Console on page 547.
365
Creating the domain configuration database. The installer adds the domain configuration metadata to a database. For more information about troubleshooting errors for the domain configuration database, see Creating the Domain Configuration Database on page 366. Creating or joining a domain. The installer creates a domain and gateway node or creates a node and adds it to a domain. For more information about troubleshooting errors when the installer creates or joins a domain, see Creating or Joining a Domain on page 367. Starting Informatica Services. The installer starts Informatica Services on the node. For more information about troubleshooting errors when the installer starts Informatica Services, see Starting Informatica Services on page 367. Pinging the domain. The installer verifies that the domain you created or are joining is available before it continues the installation. For more information about troubleshooting errors when the installer pings the domain, see Pinging the Domain on page 368. Adding a license. The installer uses PowerCenter license key that you enter during installation to create a license object in the PowerCenter domain. For more information about troubleshooting errors when the installer adds the license to the domain, see Adding a License on page 368.
Note: The installer must successfully complete the PowerCenter Services configuration to
continue with the installation. You cannot continue the installation if any configuration fails.
366
Create a domain. The installer runs the infasetup DefineDomain command to create the domain and the gateway node for the domain on the current machine based on the information you enter in the Configure Domain window. Join a domain. The installer runs the infasetup DefineWorkerNode command to create a node on the current machine, and runs the infacmd AddDomainNode command to add the node to the domain. The installer uses the information you enter in the Configure Domain and Configure Node windows to run the commands.
The infasetup and infacmd commands that create a domain or create a worker node and join the domain fail if the gateway node is unavailable. If you cannot log into the PowerCenter Administration Console, the gateway node is unavailable. For example, the DefineDomain command may fail if you click Test Connection and the connection test passed, but the database became unavailable before you clicked Next. The DefineDomain command may also fail if the host name or IP address does not belong to the current machine. Verify that the database for the domain configuration is available and that the host name is correct and try again. If the AddDomainNode command fails, verify that Informatica Services is running on the gateway node and try again.
The Service Manager is out of system memory. The Java Runtime Environment (JRE) that starts Informatica Services and runs the Service Manager may not have enough system memory to start. Set the INFA_JAVA_OPTS environment variable to configure the amount of system memory used by PowerCenter Services. On UNIX, you can set the memory configuration when you start Informatica Services. For more information, see PowerCenter Services Environment Variables on page 63.
Troubleshooting Domains and Nodes 367
The domain configuration database is not available. Informatica Services fails to start on a node if the Service Manager on a gateway node cannot connect to the domain configuration database after 30 seconds. Verify that the domain configuration database is available. You incorrectly configure the Informatica Services user account. Informatica Services fails to start if you incorrectly configure the Windows domain, user name, or password when you configure the user account to start Informatica Services on Windows. In addition, the user account must have the Act as operating system permission.
Adding a License
The installer runs the infacmd AddLicense command to read the PowerCenter license key file and create a license object in the domain. A valid license object must exist in the domain to enable the Repository Service and Integration Service. If you use an incremental license and join a domain, the serial number of the incremental license must match the serial number for an existing license object in the domain. If the serial numbers do not match, the AddLicense command fails. You can get more information about the contents of the license key file used for installation, including serial number, version, expiration date, operating systems, and PowerCenter and connectivity options in the installation debug log. You can get more information about existing licenses for the domain in the Administration Console. For more information about licenses and license objects, see Managing Licenses in the Administrator Guide.
368
Creating and enabling a Repository Service. The installer creates and enables a Repository Service for PowerCenter Services or Metadata Manager. For more information about troubleshooting Repository Service errors, see Creating and Enabling a Repository Service on page 369. Creating or restoring repository content. The installer creates content for a PowerCenter repository or restores the content for a PowerCenter repository for Metadata Manager. For more information about troubleshooting creating or restoring repository content, see Creating and Restoring Repository Content on page 370. Creating and enabling an Integration Service. The installer creates and enables an Integration Service for PowerCenter Services or Metadata Manager. For more information about troubleshooting an Integration Service, see Creating and Enabling an Integration Service on page 371.
Note: If you install PowerCenter Services without Metadata Manager, you can continue the
installation and resolve the errors later. If you install Metadata Manager, the Repository Service and Integration Service must be successfully created and enabled and the repository content must be restored to continue with the installation.
369
use with the PowerCenter repository for Metadata Manager. The Repository Service uses the same name as the repository name.
Note: If you install Metadata Manager and join a domain, the installer creates the Repository
Service for the PowerCenter repository for Metadata Manager on the gateway node for the domain. The installer includes a generic list of code pages for the PowerCenter repository. Verify that the code page you select is available on the gateway node for the domain you are joining. If you select an existing repository, the code page must also be compatible with the repository. For example, the installer may fail to create the Repository Service if a Repository Service with the same name as the PowerCenter repository exists in the domain. To correct the error, you can complete one of the following steps:
Rename the PowerCenter repository. If you create a PowerCenter repository, click Retry in the error dialog box to return to the installer and enter a different name for the PowerCenter repository. Remove the Repository Service. In the Administration Console, remove the Repository Service with the conflicting name.
For more information about creating and enabling a Repository Service in the Administration Console, see Creating and Configuring the Repository Service in the Administrator Guide.
you can connect to the repository using the PowerCenter Client. For more information, see Upgrading PowerCenter on page 401. For more information about creating repository content in the Administration Console, see Managing the Repository in the PowerCenter Administrator Guide. For more information about pmrep, see the PowerCenter Command Line Reference.
370
Name exists in domain. The CreateIntegrationService command fails if another Integration Service with the same name exists in the domain. Click Retry in the error dialog box and use another name or remove the existing Integration Service from the domain. The associated Repository Service is unavailable. If the Repository Service created by the installer is unavailable, the Integration Service is not enabled. Enable the Repository Service and click Retry in the error dialog box. Incorrect user name or password in Configure Integration Service window. You can enter the user name and password for the associated repository database if you choose an existing PowerCenter repository for the Repository Service. Click Retry in the error dialog box and correct the user name or password.
For more information about creating and enabling an Integration Service in the Administration Console, see Creating and Configuring the Integration Service in the Administrator Guide.
371
Creating the Data Analyzer repository. The installer creates content for a new Data Analyzer repository. Creating or updating a Metadata Manager repository. The installer creates content for a new Metadata Manager repository. The installer also switches the existing database connections in the PowerCenter repository for Metadata Manager to a connection to the Metadata Manager repository.
Switching Connections
The installer runs the pmrep DeleteConnection, CreateConnection, and SwitchConnection commands to delete the existing database connection object from the PowerCenter repository, create a new database connection object, and switch it with the existing database connection in the PowerCenter repository. For more information about creating, deleting, and switching connections with pmrep, see the PowerCenter Command Line Reference.
372
JBoss Application Server. You can use the error message generated by the installer, the installation debug log file, and the JBoss Application Server log files to troubleshoot issues with JBoss Application Server. WebLogic Server. Use the error messages generated by the installer, the installation debug log file, and the WebLogic Administration Console to troubleshoot issues with WebLogic Server. WebSphere Application Server. Use the error messages generated by the installer, the installation debug log file, WebSphere Application Server log files, and the WebSphere Administration Console to troubleshoot issues with WebSphere Application Server.
Before you begin troubleshooting issues with application servers, verify that you have correctly configured the application server. For more information about pre-installation tasks for application servers, see Application Servers on page 40 and Step 10. Install the Application Server (Optional) on page 70.
The installer removes any existing JBoss Application Server service and creates a new service with the new JBoss Application Server installation path. Therefore, the Windows service for the first JBoss Application Server instance does not exist after installation. To run two JBoss Application Server instances on a Windows machine, you must start the instance not associated with the JBoss Application Server service from the command line. For more information about starting JBoss Application Server from the command line, see Starting and Stopping Applications on JBoss Application Server on page 537.
373
I installed JBoss Application Server with the installer, but the application server did not start. Data Analyzer and Metadata Manager may not start during PowerCenter installation due to a problem with JBoss Application Server or the Data Analyzer and Metadata Manager applications.
To troubleshoot startup problems with JBoss Application Server: 1.
Verify that the port numbers for JBoss Application Server are not used by any other JBoss Application Server or other application. The installation debug log file contains a list of the JBoss Application Server ports configured during installation. If you find a conflict, you must reconfigure the ports. For more information about configuring JBoss Application Server ports, see the JBoss documentation.
2.
Verify that JBoss Application Server is running. On UNIX, verify the following process is running:
/bin/sh run.sh -c informatica
If JBoss Application Server is running, skip to step 4. -orIf JBoss Application Server is not running, start JBoss Application Service. For more information, see Starting and Stopping Applications on JBoss Application Server on page 537.
4.
On Windows, use the Event Viewer to view the event messages from JBoss Application Server startup to determine why the Data Analyzer and Metadata Manager applications were not deployed. On UNIX, restart JBoss Application Server and use the console messages to determine why the Data Analyzer and Metadata Manager applications were not deployed. Correct the errors, make sure no other JBoss Application Server is running, and restart JBoss Application Server.
5. 6.
For more information about starting and stopping JBoss Application Server, see Starting and Stopping Applications on JBoss Application Server on page 537.
WebLogic Server
To troubleshoot issues with WebLogic Server, use the error messages from the installer, the installation debug log file, and the WebLogic Administration Console to troubleshoot errors. During the installation, you may encounter errors if the installer cannot install or configure Data Analyzer or Metadata Manager, if WebLogic Server does not start, or if the Data Analyzer or Metadata Manager applications do not start.
374
You can verify that WebLogic Server started successfully by logging in to the WebLogic Administration Console. You can also view the log generated by WebLogic Server during startup. The log file, <server name>.log, is located in the following directory:
<BEA_HOME>/user_projects/domains/<domain name>/<server name>/
After you correct any errors, restart WebLogic Server. For more information, see Starting and Stopping Applications on BEA WebLogic Server on page 540. After WebLogic Server starts, use the domain and server logs in the WebLogic Administration Console to troubleshoot issues with Data Analyzer and Metadata Manager. For more information about domain and server logs, see the BEA WebLogic Server documentation.
SystemErr.log SystemOut.log
Table 16-4 describes the locations of the WebSphere Application Server log files:
Table 16-4. WebSphere Application Server Log Files
Server Type Deployment Manager Node Agent JMS Server Server Log Files Location <WAS_HOME>\DeploymentManager\logs\dmgr\ <WAS_HOME>\AppServer\logs\nodeagent\ <WAS_HOME>\AppServer\logs\jmsserver\ <WAS_HOME>\AppServer\logs\<server name>\
Note: The name of the default server for WebSphere Application Server is server1.
You can manually start WebSphere Application Server and deploy Data Analyzer or Metadata Manager. For more information about starting WebSphere Application Server, see Starting and Stopping Applications on IBM WebSphere Application Server on page 542.
375
The message indicates the installation succeeded. You must restart the machine after the installation completes. The messages in the installation debug log indicated that the installer could not remove the Metadata Manager Client service, but the Metadata Manager Client was not installed on the machine. The installation debug log file for the PowerCenter Client installation may contain errors related to the installation of Windows services for the Metadata Manager Client. The installer first removes the existing services. If no service exists, the installer may report an error. You can ignore this error. I installed the PowerCenter Client, but PowerCenter Data Stencil does not appear in the Windows Start menu, and the MappingTemplate folder in the client directory is empty. You must have the correct version and service pack level of the Microsoft .NET Framework for PowerCenter Data Stencil to install properly. Uninstall the PowerCenter Client, install the correct version of the Microsoft .NET Framework, and reinstall the PowerCenter Client. For more information about the correct version of the Microsoft .NET Framework, see Third-Party Software on page 43.
376
Action:
Action:
377
Cannot configure Metadata Manager on WebLogic Server. Cause: Action: The installer failed to configure the application server files for Metadata Manager. Use the message in the error dialog box and the installation debug log to identify why the Metadata Manager configuration failed. Correct the error and click Retry in the error dialog box. You must successfully configure the Metadata Manager application to continue the installation. For more information, see WebLogic Server on page 374. Cannot configure Metadata Manager on WebSphere Application Server. Cause: Action: The wsadmin configuration command for Metadata Manager failed. Use the error message in the error dialog box and the installation debug log to identify the cause of the error. Correct the error and click Retry. You must successfully configure Metadata Manager to continue the installation. For more information, see WebSphere Application Server on page 375. Cannot connect to Repository Service. Cause: Action: The pmrep Connect command failed to connect to the repository for the Repository Service. The Repository Service was not enabled. Use the output of the Connect command in the error dialog box and the log events in the Administration Console Log Viewer to identify why the command failed. Log in to the Administration Console and view the log events for the Repository Service in the domain to determine why the Repository Service could not be enabled. Correct the error and click Retry. If you are not installing Metadata Manager, you can click Ignore to continue the installation and enable the Repository Service in the Administration Console after installation. If you ignore the error, you must also create repository content for the repository after installation. For more information, see Creating and Enabling a Repository Service on page 369. Cannot create Data Analyzer repository. Cause: Action: The installer could not create the tables in the Data Analyzer repository database. Use the message in the error dialog box and the installation debug log to identify why the repository creation failed. Correct the error and click Retry in the error dialog box. The installer must successfully create the repository to continue the installation. For more information, see Creating a Data Analyzer Repository on page 372.
378
Cannot create domain. Cause: Action: The infasetup DefineDomain command failed. Use the output of the DefineDomain command in the error dialog box to identify why the command failed. Correct the error and click Retry. For more information, see Creating or Joining a Domain on page 367. Cannot create Integration Service. Cause: Action: The infacmd CreateIntegrationService command failed to create the Integration Service. Use the output of the CreateIntegrationService command in the error dialog box and the log events in the Administration Console Log Viewer to identify why the command failed. Log in to the Administration Console and view the log events for the domain to determine why the Integration Service could not be created. Correct the error and click Retry. If you are not installing Metadata Manager, you can click Ignore to continue the installation and create the Integration Service in the Administration Console after installation. For more information, see Creating and Enabling an Integration Service on page 371. Cannot create Metadata Manager repository. Cause: Action: The installer could not create the tables in the Metadata Manager repository database. Use the error message in the error dialog box and the installation debug log to identify why the repository creation failed. Correct the error and click Retry in the error dialog box. The installer must successfully create the repository to continue the installation. For more information, see Creating and Updating a Metadata Manager Repository on page 372. Cannot create node. Cause: The infasetup DefineWorkerNode command failed. A domain contains gateway nodes and worker nodes. When you join a domain, the installer creates a worker node on the current machine. Use the output of the DefineWorkerNode command in the error dialog box and the installation debug log to identify why the command failed. Correct the error and click Retry. For more information, see Creating or Joining a Domain on page 367.
Action:
379
Cannot create or restore repository content. Cause: Action: The pmrep Create or Restore command failed to create the repository tables or restore the PowerCenter repository content. Use the output of the pmrep command in the error dialog box and the log events in the Administration Console Log Viewer to identify why the command failed. Log in to the Administration Console and view the log events for the Repository Service to determine why the repository contents could not be created or restored. Correct the error and click Retry. If you are not installing Metadata Manager, you can click Ignore to continue the installation and create repository content after installation. The pmrep Create command rolls back any changes to the repository database if content creation is unsuccessful. For more information, see Creating and Restoring Repository Content on page 370. Cannot create Repository Service. Cause: Action: The infacmd CreateRepositoryService command failed to create the Repository Service. Use the output of the CreateRepositoryService command in the error dialog box and the log events in the Administration Console Log Viewer to identify why the command failed. Log in to the Administration Console and view the log events for the domain to determine why the Repository Service could not be created. Correct the error and click Retry. If you are not installing Metadata Manager, you can click Ignore to continue the installation and create the Repository Service in the Administration Console after installation. If you skip creation of the Repository Service, the installer also skips creation of the Integration Service. For more information, see Creating and Enabling a Repository Service on page 369. Cannot federate WebSphere node. Cause: Action: The wsadmin addNode command failed to add the WebSphere node. Use the error message in the error dialog box and the installation debug log to identify the cause of the error. Correct the error and click Retry. If you already added the node, click Ignore. For more information, see WebSphere Application Server on page 375. Cannot install Data Analyzer on WebLogic Server. Cause: The installer failed to copy application server files and Data Analyzer configuration files to the application server directory.
380
Action:
Use the message in the error dialog box and the installation debug log to identify why the Data Analyzer installation failed. Correct the error and click Retry in the error dialog box. You must successfully install the Data Analyzer application to continue the installation. For more information, see WebLogic Server on page 374.
Cannot install JBoss service. Cause: Action: The installer could not install the JBoss Application Server service. Use the installation debug log to identify why the service installation failed. Correct the error and click Retry in the error dialog box. You must successfully install the JBoss Application Server service to continue the installation. For more information, see JBoss Application Server on page 373. Cannot install Metadata Manager on WebLogic Server. Cause: Action: The installer failed to copy application server files and Metadata Manager configuration files to the application server directory. Use the message in the error dialog box and the installation debug log to identify why the Metadata Manager installation failed. Correct the error and click Retry in the error dialog box. You must successfully install the Metadata Manager application to continue the installation. For more information, see WebLogic Server on page 374. Cannot ping domain. Cause: Action: The infacmd Ping command failed to connect to the PowerCenter domain. Use the output of the Ping command in the error dialog box and the installation debug log to identify why the command failed. Verify that the domain is available and try again. You may need to start Informatica Services on the gateway node. For more information, see Pinging the Domain on page 368. Cannot ping Integration Service. Cause: Action: The infacmd Ping command failed to ping the Integration Service. The Integration Service was not enabled. Use the output of the Ping command in the error dialog box and the log events in the Administration Console Log Viewer to identify why the command failed. Log in to the Administration Console and view the log events for the Integration Service in the domain to determine why the Integration Service could not be enabled. Correct the error and click Retry. If you are not installing Metadata Manager, you can click Ignore to continue the installation and enable the Integration Service in the Administration Console after installation.
381
For more information, see Creating and Enabling an Integration Service on page 371. Cannot remove Informatica Services service. Cause: Action: On Windows, the installer ran the infaservice remove command to remove an existing Informatica Services service, but the removal failed. If you are installing PowerCenter Services on the current machine for the first time, click Ignore. infaservice reports an error if it could not remove the service when the service does not exist. If the service currently exists on the machine, verify that the user account installing PowerCenter Services has permissions to remove a service and click Retry. You can get more information about the error in the installation debug log. For more information, see Starting Informatica Services on page 367. Cannot start Informatica Services. Cause: Action: The infaservice startup command failed to start Informatica Services. Use the node.log and catalina.out Service Manager log files to identify the reason why Informatica Services could not be started on the machine. After you correct the error, click Retry. For more information, see Starting Informatica Services on page 367. Cannot stop WebSphere Application Server node. Cause: Action: The wsadmin stopNode command failed. Use the error message in the error dialog box and the installation debug log to identify the cause of the error. Correct the error and click Retry. For more information, see WebSphere Application Server on page 375. Cannot stop WebSphere Manager. Cause: Action: The wsadmin stopManager command failed. Use the error message in the error dialog box and the installation debug log to identify the cause of the error. Correct the error and click Retry. You can also stop the WebSphere Manager manually and click Ignore. For more information, see WebSphere Application Server on page 375. Cannot Sync Node on WebSphere Application Server. Cause: Action: The wsadmin syncNode command failed. Use the error message in the error dialog box and the installation debug log to identify the cause of the error. Correct the error and click Retry. If you already synchronized the node, click Ignore. For more information, see WebSphere Application Server on page 375.
382
Cannot switch repository connections. Cause: The pmrep DeleteConnection, CreateConnection or SwitchConnection command failed. If the CreateConnection command fails, the SwitchConnection command fails also. Use the output of the pmrep command in the error dialog box and the installation debug log to identify why the command failed. Correct the error and click Retry in the error dialog box. You can also click Ignore to continue the installation. You create or switch the database connection objects in the PowerCenter repository before you can run XConnect workflows with Metadata Manager after installation. For more information, see Switching Connections on page 372. Cannot update Metadata Manager repository content. Cause: Action: The installer could not update the tables in the Metadata Manager repository database. Use the error message in the error dialog box and the installation debug log to identify why the repository update failed. Correct the error and click Retry in the error dialog box. The installer must successfully update the repository to continue the installation. For more information, see Creating and Updating a Metadata Manager Repository on page 372.
Action:
383
384
Chapter 17
Uninstalling PowerCenter
Overview, 386 Running the Uninstaller, 388 Complete Uninstallation in Graphical Mode, 390 Partial Uninstallation in Graphical Mode, 392 Uninstallation in Console Mode, 396
385
Overview
When you install PowerCenter Standard Edition or Advanced Edition, the installer creates an uninstaller. The uninstaller keeps a record of all the files copied to the installation directory. To uninstall PowerCenter and PowerCenter components, run the uninstaller created by the installer. On UNIX, run the uninstaller from the command line. On Windows, run the uninstaller from the Windows Start Menu. When you run the uninstaller, the uninstaller deletes the PowerCenter files and clears all configuration. The uninstallation process does not delete files that are not installed by the installer. For example, the configuration process that happens as part of the installation may create temporary directories. The uninstaller does not keep a record of these directories and therefore cannot delete them. You must manually delete these directories for a clean uninstallation. When you uninstall a specific PowerCenter component, the uninstaller deletes the files for the product component. It does not delete files for the other installed PowerCenter components. The uninstaller allows you to select the component you want to uninstall. You do not need to uninstall all components at one time. After you run the uninstaller, it keeps a record of the components that remain installed. The next time you run the uninstaller, the components that remain installed are available for uninstallation.
Uninstalling PowerCenter does not affect the PowerCenter repositories. The uninstaller removes the PowerCenter files. It does not remove repositories from the database. If you need to move the repositories, you can back them up and restore them in another database. Uninstalling PowerCenter Services does not remove the metadata tables from the domain configuration database. If you install PowerCenter Services again using the same domain configuration database and user account, you must manually remove the tables. If you want to remove the metadata tables manually, drop the following tables:
If you want to back up the domain configuration database before you remove the metadata tables, use the infasetup BackupDomain command. For more information, see "infasetup Command Reference" the Command Line Reference.
386
When you uninstall Data Analyzer and Metadata Manager, the uninstaller removes files installed during the installation of the application. It does not remove files related to the application server files or those created during configuration. Generally, the uninstaller also does not remove application server files that may be shared by other applications running on the application server. You must manually remove the files. For example, you install Data Analyzer on BEA WebLogic Server and choose to create a WebLogic domain named Informatica. When you uninstall Data Analyzer, the uninstaller removes the Data Analyzer files copied into the domain during installation. It does not remove the Informatica WebLogic domain or application server files and directories created in the domain. To remove the Informatica WebLogic domain, delete the domain directory manually.
If you install Data Analyzer and Metadata Manager on the same application server and you uninstall Data Analyzer or Metadata Manager, the uninstaller removes the application you select. It does not remove files related to the application you did not uninstall. The uninstaller removes JBoss Application Server installed with Data Analyzer or Metadata Manager if no application currently uses JBoss Application Server. For example, you install Data Analyzer and Metadata Manager on JBoss Application Server. If you uninstall Data Analyzer, JBoss Application Server remains installed. If you then uninstall Metadata Manager, the uninstaller removes JBoss Application Server. The uninstaller does not create a log of the uninstallation process. At the end of the uninstallation process, the uninstaller displays the names of the files and directories that could not be removed. If you run the installer and install one PowerCenter component, and then install another PowerCenter component in a different directory, the uninstaller available through the Windows Start menu removes the last installed component. You must run the uninstaller in the _uninstallServer directory to remove the first installed component. If you install PowerCenter Services and the PowerCenter Client in the same directory, and uninstall PowerCenter Services, the uninstaller removes the ODBC5.1 directory. The ODBC5.1 directory is required by the PowerCenter Client. You must reinstall either the PowerCenter Client or PowerCenter Services to reinstall the ODBC drivers.
Overview
387
Uninstallation Options
The method you use to uninstall depends on your operating system:
UNIX. Use the console mode interface or graphical mode interface to uninstall PowerCenter components. Windows. Use the graphical mode interface to uninstall PowerCenter components.
388
For more information about using the console mode interface, see Uninstallation in Console Mode on page 396.
389
On UNIX, go to the uninstallation directory for the PowerCenter component you want to uninstall and type the following command to run the uninstaller:
./uninstaller
For the list of uninstallation directories, see Table 17-1 on page 388.
2.
On Windows, click Start > Program Files > Informatica PowerCenter 8.1.1 > Server > Uninstaller. The Uninstall PowerCenter 8.1.1 window displays information about the uninstallation process.
3.
Click Next. The Uninstallation window displays the PowerCenter uninstallation options.
4. 5.
To uninstall all the PowerCenter components in the installation directory, select Uninstall All Components. Click Next.
390
The uninstaller displays the names of the files as they are deleted. When uninstallation completes, the uninstaller displays the Uninstall Complete window. If all files are successfully deleted, the Uninstall Complete window displays a message that the uninstallation was successful.
If not all files are deleted, the Uninstall Complete window displays the list of files that were not deleted. You can choose to restart the system now, or restart the system later.
6. 7.
Click Done. If the installer does not delete all files, review the files and directories to determine if it is safe to delete them. Then delete them manually.
391
On UNIX, go to the uninstallation directory for the PowerCenter component you want to uninstall and type the following command to run the uninstaller:
./uninstaller
For the list of uninstallation directories, see Table 17-1 on page 388.
2.
On Windows, click Start > Program Files > Informatica PowerCenter 8.1.1 > Server | Client > Uninstaller. For more information about running the uninstaller, see Running the Uninstaller on page 388. The Uninstall PowerCenter 8.1.1 window displays information about the uninstallation process.
3.
Click Next. The Uninstallation window displays the PowerCenter uninstallation options.
4.
To uninstall specific PowerCenter components, select Uninstall Specific Components and click Next.
392
The Choose Components to Uninstall window displays the installed PowerCenter components.
5.
Select the components you want to uninstall. You can select any number of components to uninstall. For example, you can select to uninstall Data Analyzer and Metadata Manager.
6.
Click Uninstall.
393
The uninstaller displays the names of the files that are uninstalled. When uninstallation completes, the uninstaller displays the Uninstall Complete window. If all files are successfully uninstalled, the Uninstall Complete window displays a message that the uninstallation was successful.
If not all files are deleted, the Uninstall Complete window displays the list of files that were not deleted. You can choose to restart the system now, or restart the system later.
7.
Click Done. If the installer does not uninstall all files, review the files and directories to determine if it is safe to delete them and delete them manually.
If you do not delete all components, you can run the same uninstaller again to remove the remaining installed components. When you run the uninstaller, you can uninstall those programs and components that you have not uninstalled previously.
394
For example, if you uninstall Data Analyzer and Metadata Manager, the next time you run the uninstaller, the list of installed PowerCenter components available for uninstallation does not include Data Analyzer and Metadata Manager.
You can run the uninstaller until all PowerCenter components are uninstalled.
395
Help. There is no associated help for any of the panels. If you need more information, refer to the relevant section on using graphical user interface mode. Input method. All input is collected through the keyboard. You cannot select information from a list, click a button, or select check boxes to enable options. Quitting the uninstaller. To exit the uninstaller, type quit at any prompt.
Go to the uninstallation directory for the PowerCenter component you want to uninstall. For the list of uninstallation directories, see Table 17-1 on page 388.
2.
Use the -console option if you configured X Windows and you want to use console mode. Otherwise, the uninstaller starts in graphical mode. The Uninstall PowerCenter Components panel displays information about the uninstallation process.
3. 4.
Press Enter. Enter the number for the type of uninstallation you want to perform and press Enter. Table 17-2 describes the options you can choose for uninstalling PowerCenter:
Table 17-2. Uninstallation Options
Option 1 2 Description Completely remove all features and components. Choose specific features installed by InstallAnywhere.
Enter the number for the features you want to uninstall. You can enter multiple values separated by commas. Depending on your installation, you can uninstall the following features:
PowerCenter Services
396
6.
Press Enter. The uninstaller uninstalls the selected components. After uninstallation completes, the console displays the results of the uninstallation.
397
398
Upgrading PowerCenter, 401 Upgrading Data Analyzer, 431 Upgrading Metadata Manager, 441 After You Upgrade, 455
399
400
Chapter 18
Upgrading PowerCenter
Overview, 402 Validate Configuration Files, 406 Upgrade a Global Repository, 409 Upgrade a Local Repository, 413 Upgrade the PowerCenter Server, 416 View Upgrade Results, 419 Upgrade Domain and Node Metadata, 420 Upgrade the PowerCenter Repository, 424 Upgrade the PowerCenter Client, 426 Upgrade Data Profiling, 427
401
Overview
This chapter describes the tasks you must complete to upgrade PowerCenter. You may need to perform upgrade tasks depending on the version of PowerCenter you upgrade:
PowerCenter 6.x/7.x. Use the Upgrade Wizard in the PowerCenter Administration Console to upgrade a Repository Agent and PowerCenter Server configuration in PowerCenter 6.x or 7.x to a Repository Service and Integration Service in a PowerCenter 8.1.1 domain. You can also upgrade existing PowerCenter repository content to the new repository version and upgrade PowerCenter Client. PowerCenter 8.0. Upgrade domain and node metadata, upgrade PowerCenter repository content and the PowerCenter Client, and upgrade the Data Profiling warehouse. PowerCenter 8.1. Upgrade the PowerCenter Client and the Data Profiling warehouse. You use the installer to install PowerCenter and upgrade the domain and nodes when you upgrade PowerCenter 8.1.
5 -
402
7 8
3 4
1 2
You may need to increase the size of the database or add more disk space. Informatica recommends that you allocate up to approximately 50 percent more available disk space and temporary storage space in the database, depending on the version you upgrade from.
Overview
403
you have permission on a folder, you can upgrade one configuration file at a time. For more information about domain users and permissions, see Managing Users and User Accounts in the PowerCenter Administrator Guide.
upgrade process generates a log event and the time that the log event appears in the Log Viewer. This delay may be up to several minutes. You can refresh the query in the Log Viewer to see the log event. For more information about troubleshooting errors in the Upgrade Wizard, see the appropriate Upgrade Wizard step. For more information about the errors during the upgrade process, see PCSF Messages in the PowerCenter Troubleshooting Guide.
404
The Upgrade Wizard maintains the state of the upgrade during the upgrade process. You can return to any previous step in the Upgrade Wizard to restart an upgrade of a Repository Agent or PowerCenter Server configuration. If you close the browser or click Finish Upgrade in the Upgrade Wizard, the previous state of the upgrade is lost and you must restart the upgrade process. You must upgrade the contents for a global repository before you upgrade the contents for any registered local repository. You must also upgrade the contents for a repository before you can upgrade the PowerCenter Server for that repository. If you want to change an option after you upgrade a Repository Agent or PowerCenter Server, you must reconfigure the Repository Service or Integration Service in the Administration Console. When you restart an upgrade for a Repository Agent or PowerCenter Server, the Upgrade Wizard restarts the upgrade from the point of failure. To restart the upgrade at Repository Service creation, you must exit the wizard, remove the Repository Service, and restart the upgrade process. You can continue to a subsequent step in the Upgrade Wizard even though some upgrade activities fail during the previous step. For example, you upgrade two Repository Agents and two PowerCenter Servers. If one Repository Agent upgrade fails and one succeeds, you can continue to the next step to upgrade the associated PowerCenter Server for the successful Repository Agent upgrade. The Upgrade Wizard reads a configuration file during validation only. If an upgrade fails because of an error in a configuration file, you must revalidate the configuration file before you continue with the upgrade.
Overview
405
To start the upgrade process, select the Repository Agent and PowerCenter Server configuration files you want to upgrade in the Select Configuration Files page of the Upgrade Wizard. You can select the configuration files individually or select multiple configuration files. After you select the configuration files to upgrade, fetch, and validate the files. When the wizard validates the files, it checks the configuration files for the required parameters and verifies that the name of the Repository Agent or PowerCenter Server configuration does not currently exist in the domain. The validation fails if the configuration file does not meet either of the conditions.
Note: If you want to upgrade multiple files, you must copy the configuration files to a node in
the PowerCenter 8.1.1 domain before you validate the files. For more information, see Backing Up and Copying Configuration Files on page 89.
To select and validate configuration files: 1.
Log in to the Administration Console. For instructions to log in to the Administration Console, see Logging in to the Administration Console on page 547.
2.
In the Administration Console, click the Upgrade tab. The Select Configuration Files page appears.
3.
406
4. 5.
To select multiple configuration files, select the node where you copied the configuration files. Click Validate Files. The Upgrade Wizard reads and validates the configuration files. If a configuration file is invalid, correct the error and validate the files again. For more information about troubleshooting validation errors, see Troubleshooting Configuration File Validation on page 407.
6.
Missing required parameters. A configuration file must contain a minimum number of parameters to be upgraded to a Repository Service or Integration Service. If a configuration file is missing a required parameter, correct the error in the configuration file and validate the file again.
407
Table 18-3 describes the required parameters for Repository Agent and PowerCenter Server configuration files:
Table 18-3. Required Configuration File Parameters
Configuration File Type Repository Agent Required Parameters RepositoryName DatabaseType ConnectString DBUser DBPassword ServerName RepositoryName PMUser PMPassword
PowerCenter Server
Application service with the same name exists. You cannot upgrade a Repository Agent or PowerCenter Server configuration if a Repository Service or Integration Service with the same name exists in the domain. If an application service with the same name exists in the domain, remove the application service from the domain and revalidate the configuration files.
408
You can upgrade a Repository Agent configuration for a global repository, enable the Repository Service created by the Upgrade Wizard, and then upgrade the contents of the global repository. The Upgrade Wizard can upgrade multiple global repositories during this step. If you do not have a global repository in your repository domain, skip this step. The Upgrade Wizard displays the results of the upgrade after the Repository Service has been created and enabled and the repository contents upgraded. You can view the status of the Repository Agent upgrade and the repository contents upgrade in the Log Viewer during and after the upgrade. Figure 18-1 shows the Upgrade Global Repository page:
Figure 18-1. Upgrade Wizard - Upgrade Global Repository Page
Start upgrade.
409
Configure the global repository upgrade options for each global Repository Agent configuration file you want to upgrade. Table 18-4 describes the global repository upgrade options:
Table 18-4. Upgrade Global Repository Options
Option Name License Node Location Enable the Repository Service after Upgrade Upgrade Contents Required/ Optional Required Required Required Optional Description Name of the license you want to assign to the Repository Service. You must assign a license to enable the Repository Service. Name of the node that runs the Repository Service. Name of the folder in the domain that contains the Repository Service object. Click Select Folder to change the folder. Enables the Repository Service after upgrading the Repository Agent configuration to a Repository Service. You must enable the Repository Service to upgrade repository contents. Upgrades the repository contents after enabling the Repository Service. You must upgrade repository contents before upgrading a local repository registered to the global repository or before upgrading the PowerCenter Server to which the global repository is associated. User name of database user account used to create the repository database. Password for the database user account.
Optional
Optional Optional
Click Start Upgrade. The Upgrade Wizard begins the upgrade process. Upgrade Status shows the number of failed, successful, and in-progress Repository Agent upgrades.
3. 4.
To view the upgrade activity, click View Activity Log for Upgrade Contents. If the upgrade fails, correct the errors indicated under Upgrade Status and click Restart Upgrade. The upgrade continues from the point of failure. For more information about troubleshooting errors that occur during a Repository Agent upgrade, see Troubleshooting Creating and Enabling a Repository Service on page 411 and Troubleshooting a Repository Upgrade on page 411.
5.
If the upgrade succeeds, the Upgrade Wizard displays the following message for each global repository:
<repository name> Upgrade Status: Upgrade Complete
6.
410
Creating a Repository Service. If the Upgrade Wizard cannot create the Repository Service, correct the error indicated in the Upgrade Status section of the Upgrade Wizard and restart the upgrade. If the upgrade error was caused by the Repository Agent configuration file, you must revalidate the configuration file after fixing the error. For example, the creation of a Repository Service may fail if the configuration file passed validation but contains another error not caught by the validation process. Correct the error in the configuration file, revalidate the configuration file, and then proceed to the appropriate repository upgrade step. To revalidate the configuration file, see Validate Configuration Files on page 406.
Enabling a Repository Service. If the Upgrade Wizard could not enable the Repository Service, use the log events for the Repository Service in the Log Viewer to identify the error. After you correct the error, enable the Repository Service in the Administration Console and use the Actions list in the Administration Console to upgrade the contents for the repository. For more information about enabling a Repository Service, see Managing the Repository in the PowerCenter Administrator Guide. For more information about upgrading repository contents in the Administration Console, see Upgrade the PowerCenter Repository on page 424.
The upgrade process has trouble reading or writing to the repository database. The repository database has insufficient disk space or temporary storage space. The client system has insufficient memory. The repository has inconsistent data.
For information about errors that occur when you upgrade a repository, see REP Messages in the PowerCenter Troubleshooting Guide. The Upgrade Wizard sends log events to the Log Manager when it performs the upgrade. You can view the progress of the upgrade by viewing the log events for the upgrade in the Log Viewer. The Administration Console lists the upgrade activities in the Administration Console window. Use the Log Viewer or the Administration Console window to determine the cause of a failure during a repository contents upgrade.
Upgrade a Global Repository 411
After you identify and fix the problem, restart the upgrade in the Upgrade Wizard or the Administration Console. When you upgrade the repository the second time, the upgrade process starts at the last successful version number. For example, if the upgrade fails between version 175 and 176, the upgrade process starts at version 175 when you run upgrade the second time. However, you should always maintain a copy of the original repository in case you need to start the upgrade from the beginning.
Note: Depending on the size of the repository, the upgrade process may take several hours to
412
You can upgrade a Repository Agent configuration for a local repository, enable the Repository Service created by the Upgrade Wizard, and then upgrade the contents of the local repository. The Upgrade Wizard can upgrade multiple local repositories during this step. The Upgrade Wizard displays the results of the upgrade after the Repository Service is created and enabled and the repository contents are upgraded. You can view the status of the Repository Agent upgrade and the repository contents upgrade in the Log Viewer during and after the upgrade. Figure 18-2 shows the Upgrade Local Repository page:
Figure 18-2. Upgrade Wizard - Upgrade Local Repository Page
Start upgrade.
413
Configure the local repository upgrade options for each global Repository Agent configuration file you want to upgrade. Table 18-5 describes the local repository upgrade options:
Table 18-5. Upgrade Local Repository Options
Option Name License Node Location Enable the Repository Service After Upgrade Upgrade Contents Required/ Optional Required Required Required Optional Description Name of the license you want to assign to the Repository Service. You must assign a license to enable the Repository Service. Name of the node that runs the Repository Service. Name of the folder in the domain that contains the Repository Service object. Click Select Folder to change the folder. Enables the Repository Service after upgrading the Repository Agent configuration to a Repository Service. You must enable the Repository Service to upgrade repository contents. Upgrades the repository contents after enabling the Repository Service. You must upgrade repository contents before upgrading the PowerCenter Server to which the local repository is associated. User name of database user account used to create the repository database. Password for the database user account. PowerCenter domain that contains the Repository Service for the global repository. You can also choose Manage Domain List to select a global repository in a different domain. Name of the Repository Service for the global repository. User name of database user account used to create the repository database. Password for the database user account.
Optional
Repository User Name Password Domain for Global Repository Global Repository Global Repository User Name Password 2.
Click Start Upgrade. The Upgrade Wizard begins the upgrade process. The upgrade status shows the number of failed, successful, and in-progress Repository Agent upgrades.
3. 4.
To view the upgrade activity, click View Activity Log for Upgrade Contents. If the upgrade fails, correct the errors indicated under Upgrade status and click Restart Upgrade. The upgrade continues from the point of failure. For more information about troubleshooting errors that occur during a Repository Agent upgrade, see Troubleshooting Creating and Enabling a Repository Service on page 411 and Troubleshooting a Repository Upgrade on page 411.
414
5.
If the upgrade succeeds, the Upgrade Wizard displays the following message for each local repository:
<repository name> Upgrade Status: Upgrade Complete
6.
415
You can upgrade a PowerCenter Server configuration to an Integration Service and enable the Integration Service in the domain. The Upgrade Wizard can upgrade a PowerCenter Server configuration during this step. You must upgrade the contents for the associated repository for the PowerCenter Server before you can upgrade the PowerCenter Server. The Upgrade Wizard displays the results of the upgrade after the Integration Service has been created and enabled. You can view the status of the PowerCenter Server upgrade in the Log Viewer during and after the upgrade. Figure 18-3 shows the Upgrade PowerCenter Server page:
Figure 18-3. Upgrade Wizard - Upgrade PowerCenter Server Page
416
Configure the Integration Service options for the first listed Integration Service. Table 18-6 describes the Integration Service upgrade options:
Table 18-6. Integration Service Upgrade Options
Option Domain for Associated Repository Service Associated Repository Service Required/ Optional Required Description Name of the domain that contains the associated Repository Service for the Integration Service. You can choose Manage Domain List to choose a Repository Service in another domain. Name of the associated Repository Service. You must upgrade a Repository Service and the repository contents or create the Repository Service in the domain before you can choose a Repository Service. Name of the license you want to assign to the Integration Service. You must assign a license to enable the Integration Service. Name of the node that runs the Repository Service. Name of the folder in the domain that contains the Repository Service object. Default folder is the top-level folder for the domain. Click Select Folder to change the folder. Enables the Integration Service after upgrade.
Required
Optional
If you want all Integration Services to inherit the same configuration, click Apply Settings to All Integration Services. To upgrade a single PowerCenter Server, click Start Upgrade. The Upgrade Wizard begins the upgrade process. Upgrade Status shows the number of failed, successful, and in-progress PowerCenter Server upgrades.
4.
To upgrade all PowerCenter Servers simultaneously, click Start Upgrade for All Integration Services. The Upgrade Wizard begins the upgrade process for all PowerCenter Servers. Upgrade Status shows the number of failed, successful, and in-progress PowerCenter Server upgrades.
5. 6.
To view the upgrade activity, click View Log for Upgrade Service. If the upgrade fails, correct the errors indicated under Upgrade Status and click Restart Upgrade. The upgrade continues from the last point of failure. For more information about troubleshooting errors that occur during a PowerCenter Server upgrade, see Troubleshooting Creating and Enabling an Integration Service on page 418.
417
7.
If the upgrade succeeds, the Upgrade Wizard displays the following message for each PowerCenter Server:
<Integration Service name> Upgrade Status: Upgrade Complete
8.
Creating an Integration Service fails. If the Upgrade Wizard could not create the Integration Service, correct the error indicated in the Upgrade Status section of the Upgrade Wizard and restart the upgrade. If the upgrade error was caused by the PowerCenter Server configuration file, you must revalidate the configuration file after fixing the error. For example, the creation of a Integration Service may fail if the configuration file passed validation but contains another error not caught by the validation process. Correct the error in the configuration file and revalidate it. Then proceed to the Upgrade PowerCenter Server step. For information about validating the configuration file, see Validate Configuration Files on page 406.
Enabling an Integration Service fails. If the Upgrade Wizard could not enable the Integration Service, use the log events for the Integration Service in the Log Viewer to identify the error. After you correct the error, enable the Integration Service in the Administration Console. For more information about enabling an Integration Service, see Creating and Configuring the Integration Service in the PowerCenter Administrator Guide.
418
View the results of all upgrade activities on the summary page. The summary page contains upgrade information for the following components:
Repository Services. Includes the name of the Repository Agent configuration file, the name of the Repository Service, and the results of the upgrade service, enable service, and upgrade contents actions. Integration Services. Includes the name of the PowerCenter Server configuration file, the name of the Integration Service, and the results of the create service and enable service actions.
After you review the upgrade summary, click Finish Upgrade to complete the upgrade process or close the browser. After you click Finish Upgrade or close the browser, you must restart the upgrade process to correct errors that occurred during the upgrade process.
419
When you upgrade PowerCenter 8.0, you use infaupgrade to upgrade the domain and node metadata. In PowerCenter 8.1.1, the domain metadata is stored in a domain configuration database. The node metadata is stored in the domain configuration database and nodemeta.xml on nodes in the domain. Use infaupgrade to upgrade the existing metadata in the domainmeta.xml and nodemeta.xml files to the appropriate location in a PowerCenter 8.1.1 domain. Complete the following tasks to upgrade a PowerCenter 8.0 domain with infaupgrade: 1. Run upgradeGatewayNode on each gateway node in the domain to upgrade nodemeta.xml for the gateway nodes. For more information, see Step 1. Upgrade Gateway Node Metadata on page 421. Run upgradeDomain on the master gateway node in the domain to upgrade the metadata in domainmeta.xml to the domain configuration database. For more information, see Step 2. Upgrade Domain Metadata on page 421. Run upgradeWorkerNode on each worker node in the domain to upgrade nodemeta.xml for the worker nodes in the domain. For more information, see Step 3. Upgrade Worker Node Metadata on page 422. After you run infaupgrade, copy domains.infa from the backup location to the installation directory on each node in the domain and start Informatica Services on each node in the domain.
2.
3.
4.
Note: Do not upgrade the gateway node if you did not install PowerCenter Services on all the
nodes in the PowerCenter 8.0 domain. If you upgrade the gateway node before installing PowerCenter Services on the non-gateway nodes in the domain, the infaupgrade fails because the node names already exist in the domain.
Running Commands
You invoke infaupgrade from the command line. On Windows, infaupgrade is a batch file with a .bat extension. On UNIX, infaupgrade is a script file with a .sh extension.
To run infaupgrade commands: 1.
At the command prompt, change to the directory where infaupgrade is located. By default, infaupgrade installs in the server directory.
2. 3.
Enter infaupgrade followed by the command name and its required options and arguments. At the command prompt, type the following command to run infaupgrade:
infaupgrade(.sh) command_name [-option1] argument_1 [-option2] argument_2...
420
database_type
Required
-databaseservicename -ds
database_service_name
Conditional
-nodeconfigfile -nf
node_configuration_file
Required
database_type
Required
-databaseservicename -ds
database_service_name
Conditional
domain_config_file n/a
Required Conditional
422
423
You can upgrade a repository using the Administration Console if you upgrade from 8.0 and did not use the Upgrade Wizard or you upgrade from PowerCenter 6.x or 7.x and the Upgrade Wizard did not successfully enable the Repository Service for the repository. A Repository Service runs in exclusive mode until you upgrade the repository contents. After you upgrade the contents, the Repository Service runs in normal mode. You must create a Repository Service for the repository before you upgrade the repository contents. For more information about creating a Repository Service, see Creating and Configuring the Repository Service in the PowerCenter Administrator Guide. For more information about changes the upgrade process makes to the functionality of existing metadata, see the PowerCenter Post-Upgrade Reference.
To upgrade a repository: 1. 2.
Log in to the Administration Console. For information about logging in to the Administration Console, see Logging in to the Administration Console on page 547. In the Navigator, select the Repository Service for the repository you want to upgrade. The page displays the existing repository and data version and the current repository and data version.
424
3.
4.
Enter the repository administrator user name and password and click OK. The activity log displays the results of the upgrade operation.
If the upgrade operation fails, view the error messages in the activity log to identify the problem. After you fix the problem, upgrade the repository again. For more information, see Troubleshooting a Repository Upgrade on page 411.
425
You can run the PowerCenter Client installer to upgrade the PowerCenter Client. You can install the complete version of the PowerCenter Client tools or a custom version, depending on your license. When you install the PowerCenter Client, you install the following PowerCenter Client tools and components:
PowerCenter Client tools. A set of tools you can use to manage the PowerCenter repository, mappings, and sessions. Metadata Manager Client. A set of applications you can use to configure Metadata Manager and manage metadata. DataDirect 5.1 ODBC drivers. Drivers designed for PowerCenter to connect the PowerCenter Client to data sources and targets. The Metadata Manager Client uses ODBC for connections to the Metadata Manager repository and PowerCenter repository. Java Runtime Environment. The Java transformation, PowerCenter Connect for JMS, and PowerCenter Connect for webMethods require the JRE.
The PowerCenter Client installer installs DataDirect 5.1 ODBC drivers. If you upgrade from PowerCenter 6.x or 7.x, you must recreate ODBC connections to use the new drivers. For more information, see Connecting to Databases from Windows on page 487.
426
When you upgrade PowerCenter, you must upgrade Data Profiling. Depending on the version of PowerCenter you upgrade, you backup, restore, and upgrade the Data Profiling warehouse. If you use Data Analyzer Data Profiling reports, you must also update the warehouse schema and views to include the new PowerCenter 8.1.1 Data Profiling reports. Complete the following tasks to upgrade Data Profiling from PowerCenter 7.x or 8.0: 1. 2. 3. 4. Backup and restore the Data Profiling warehouse. Upgrade the Data Profiling warehouse. Upgrade schema and views for Data Analyzer Data Profiling reports (Optional). Recreate ODBC connections (Optional).
If you upgrade from PowerCenter 8.1, you only update the Data Profiling warehouse schema and views for Data Analyzer Data Profiling reports. You do not upgrade the Data Profiling warehouse.
Run the dbaccess command line program. Select the script and select Run. Run the upgrade schema script with Query Analyzer. Note: Do not use isql to run the script. The script may not run successfully. Run the following command from the command line :
sqlplus <user name>/<password>@<database server> @<upgrade script name>
Sybase ASE
Teradata
Open Teradata SQL Assistant. Open the upgrade schema script and click Execute. Note: The upgrade script fails if you use the Execute Parallel option in Teradata Client 6.2.
427
Table 18-11 describes the script you must run for each database type and PowerCenter version:
Table 18-11. Scripts for Upgrading the Data Profiling Warehouse to PowerCenter 8.1.1
Existing Warehouse 8.0 8.0 8.0 8.0 8.0 8.0 7.1.1 / 7.1.2 / 7.1.3 / 7.1.4 7.1.1 / 7.1.2 / 7.1.3 / 7.1.4 7.1.1 / 7.1.2 / 7.1.3 / 7.1.4 7.1.1 / 7.1.2 / 7.1.3 / 7.1.4 7.1.1 / 7.1.2 / 7.1.3 / 7.1.4 7.1.1 / 7.1.2 / 7.1.3 / 7.1.4 7.1.0 7.1.0 7.1.0 7.1.0 7.1.0 7.1.0 7.0 7.0 Database Type IBM DB2 UDB Informix Microsoft SQL Server Oracle Sybase ASE Teradata IBM DB2 UDB Informix Microsoft SQL Server Oracle Sybase ASE Teradata IBM DB2 UDB Informix Microsoft SQL Server Oracle Sybase ASE Teradata IBM DB2 UDB Informix Script upgrade_schema04-05_db2.sql upgrade_schema04-05_inf.sql upgrade_schema04-05_sql.sql upgrade_schema04-05_ora.sql upgrade_schema04-05_syb.sql upgrade_schema04-05_ter.sql upgrade_schema03-05_db2.sql upgrade_schema03-05_inf.sql upgrade_schema03-05_sql.sql upgrade_schema03-05_ora.sql upgrade_schema03-05_syb.sql upgrade_schema03-05_ter.sql upgrade_schema02-05_db2.sql upgrade_schema02-05_inf.sql upgrade_schema02-05_sql.sql upgrade_schema02-05_ora.sql upgrade_schema02-05_syb.sql upgrade_schema02-05_ter.sql upgrade_schema01-05_db2.sql upgrade_schema01-05_inf.sql
428
Table 18-11. Scripts for Upgrading the Data Profiling Warehouse to PowerCenter 8.1.1
Existing Warehouse 7.0 7.0 7.0 7.0 Database Type Microsoft SQL Server Oracle Sybase ASE Teradata Script upgrade_schema01-05_sql.sql upgrade_schema01-05_ora.sql upgrade_schema01-05_syb.sql upgrade_schema01-05_ter.sql
Step 3. Upgrade Schema and Views for Data Analyzer Data Profiling Reports (Optional)
If you want to view Data Analyzer Data Profiling reports, you must upgrade the Data Profiling warehouse schema and views. You upgrade the Data Profiling warehouse views for Data Analyzer reports after you upgrade the Data Profiling schema. The scripts to upgrade the schema and views have the same name. You must upgrade the schema before you upgrade the views. The scripts to upgrade the schema are located in the following PowerCenter Client directory:
\bin\Extensions\DataProfile\ProfileWarehouse\DA811
The scripts to upgrade the views are located in the following PowerCenter Client directory:
\bin\Extensions\DataProfile\ProfileWarehouse\DA811\DAViews
Table 18-12 describes the scripts you must run for each Data Profiling warehouse database type:
Table 18-12. Scripts for Upgrading the Data Profiling Warehouse Schema and Views
Database Type IBM DB2 UDB Microsoft SQL Server Oracle Sybase ASE Teradata Script upgrade_05_db2.sql upgrade_05_sql.sql upgrade_05_ora.sql upgrade_05_syb.sql upgrade_05_ter.sql
After you upgrade the views and schema, you can install the new Data Analyzer Data Profiling reports. For more information about installing reports, see PowerCenter Reports Installation on page 281.
429
Step 4. Recreate the ODBC Connection to the Data Profiling Warehouse (Optional)
PowerCenter 8.1.1 includes DataDirect 5.1 ODBC drivers. If the existing PowerCenter Client connection to the Data Profiling warehouse was created with an earlier version of the drivers, you must recreate the ODBC connection to each Data Profiling warehouse.
430
Chapter 19
Overview, 432 Run the Repository Upgrade Utility, 433 Update Configuration Files, 436 Complete the Repository Upgrade, 437
431
Overview
To upgrade Data Analyzer, you must first install the new version of Data Analyzer. Then use the Repository Upgrade utility provided with the new version of Data Analyzer to upgrade the repository of the previous version. After you upgrade the repository, you log in to Data Analyzer to complete the repository upgrade. Previous versions of Data Analyzer were named PowerAnalyzer. You can upgrade any version of PowerAnalyzer 4.1.1 and later to Data Analyzer 8.1.1, and you can upgrade Data Analyzer 8.0 and 8.1 to Data Analyzer 8.1.1. To upgrade the Data Analyzer repository, complete the following steps: 1. Run the Repository Upgrade utility. Run the Repository Upgrade utility to upgrade the Data Analyzer repository. For more information, see Run the Repository Upgrade Utility on page 433. Update the configuration files. Update any customized configuration files in the Data Analyzer 8.1.1 instance. For more information, see Update Configuration Files on page 436. Log in to Data Analyzer and complete the repository upgrade. The repository upgrade requires you to log in to Data Analyzer to complete the upgrade process. You may need to increase the transaction timeout for the application server to allow the upgrade to complete. For more information, see Complete the Repository Upgrade on page 437.
2.
3.
432
Complete the pre-upgrade tasks. For more information about the pre-upgrade tasks, see Data Analyzer Pre-Upgrade Steps on page 93. On the machine where you installed Data Analyzer, navigate to the Data Analyzer utilities directory. The upgrade utility is installed in the default Data Analyzer utilities directory:
/Informatica/PowerCenter8.1.1/DataAnalyzer/upgradeutil
3.
Start the Repository Upgrade utility. On Windows, start the upgrade utility with the following command:
upgrade.bat
433
4.
Select the database type of the Data Analyzer repository to upgrade. The Repository Upgrade utility displays the driver name and the JDBC connection string syntax for the selected database type.
5.
Customize the JDBC connection string for the repository database you want to upgrade.
Note: For an IBM DB2 repository, you must set the JDBC connection string with additional parameters:
CreateDefaultPackage=TRUE ReplacePackage=TRUE DynamicSections=1000
For example, use the following syntax for the connection string to upgrade an IBM DB2 repository:
jdbc:informatica:db2:// host_name:port;DatabaseName=database_name;CreateDefaultPackage=TRUE; ReplacePackage=TRUE;DynamicSections=1000 6.
Enter the user name and password to connect to the Data Analyzer repository database.
Note: For an IBM DB2 repository, the user account must have database administrator privileges.
7.
To ensure that you can connect to the database, click Test Connection. If an error message displays, verify that the connection information for the database is correct. Data Analyzer provides the reason for the connection failure. If necessary, check with the database administrator to resolve any problem.
Note: For an IBM DB2 repository, click Test Connection to ensure that the DynamicSections property is set to the correct value. After you click Test Connection, remove the extra parameters from the JDBC connection string so that the
434
DynamicSections property is not set a second time. Change the connection string to the default string for a DB2 database connection:
jdbc:informatica:db2://host_name:port;DatabaseName=database_name 8.
Click Start Upgrade. The Repository Upgrade utility displays a warning to back up the repository before you upgrade.
9. 10. 11.
Click OK to continue the upgrade. Select the locale you want to use and click OK. Select whether you want to use Smart Sum for all custom metrics. Select Yes if you enabled this feature in PowerAnalyzer 4.x. Select No if you did not enable this feature in PowerAnalyzer 4.x. Smart sum is enabled in PowerAnalyzer 4.x if you set the CustomMetric.UseExpressionForSum property to True in the IAS.properties file. When you enable smart sum, Data Analyzer calculates the sum and average of custom metrics by the base metrics used in the expression. For more information about custom metrics, see the Data Analyzer User Guide and Schema Designer Guide. The Repository Upgrade utility upgrades the selected Data Analyzer repository to the latest version. If the upgrade fails, Data Analyzer provides the reason for the upgrade failure. If necessary, check with the database administrator to resolve any problem. Data Analyzer writes the details of the upgrade process to an upgrade log called IASUpgrade.log. You can find the upgrade log in the Repository Upgrade utility directory.
After the Repository Upgrade utility completes the upgrade procedure, log in to Data Analyzer and review all dashboards, reports, and indicators to verify that they were upgraded properly. After you log in, allow Data Analyzer to complete the second phase of the upgrade.
435
436
WebLogic Server
Use the WebLogic Administration Console to increase the transaction timeout for Data Analyzer. For more information about configuring the Java Transactions API (JTA) for BEA WebLogic Server, see the documentation on the BEA Systems web site:
http://e-docs.bea.com/wls/docs81/ConsoleHelp/jta.html#1112051 To increase the transaction timeout in WebLogic: 1. 2.
Start the WebLogic Administration Console and log in with the console system user name and password. On the left panel of the WebLogic Administration Console, click the name of the domain for Data Analyzer. The default WebLogic domain for Data Analyzer is Informatica.
3. 4.
On the right panel, click the JTA tab. Set the Timeout Seconds property to a larger value. By default, the timeout length is 30 seconds. Increase it to at least 300 seconds (5 minutes).
5. 6. 7.
Click Apply. Close the WebLogic Administration Console. Restart BEA WebLogic Server.
When you log in to Data Analyzer, Data Analyzer can complete the upgrade process and display the View tab without errors.
437
Start the WebSphere Administrative Console and log in with the console system user name and password. On the left panel of the WebSphere Administrative Console, click Servers > Application Servers. On the Application Servers page, click the name of the server associated with Data Analyzer. By default, the name of the server is server1.
4. 5.
In the Additional Properties section of the Configuration tab, click Transaction Services. On the Transaction Services page, set the Total Transaction Lifetime Timeout to a larger value. By default, the timeout length is 120 seconds (2 minutes). Increase it to at least 300 seconds (5 minutes).
6. 7. 8.
Click OK. Save the configuration change and close the WebSphere Administrative Console. Restart IBM WebSphere Application Server.
When you log in to Data Analyzer, Data Analyzer can complete the upgrade process and display the View tab without errors.
Go to the JBoss deployment directory in the Data Analyzer server configuration. If you install JBoss Application Server with Data Analyzer, the default deployment directory is /Informatica/PowerCenter8.1.1/JBoss403/server/informatica/deploy.
2.
Locate the transaction-service.xml configuration file. Back up the transaction-service.xml file into another directory before you modify it. Do not create the backup file in the /deploy directory.
438
3. 4.
Open the transaction-service.xml file with a text editor. Locate the line with the following text:
TransactionManagerService
5.
Typically, the default transaction timeout for JBoss (5 minutes) is high enough for most situations. However, if you still encounter problems, raise the timeout to 600 seconds (10 minutes).
6. 7.
Change the value for the TransactionTimeout attribute to a higher number. Save and close the transaction-service.xml file.
When you log in to Data Analyzer, Data Analyzer can complete the upgrade process and display the View tab without errors.
439
440
Chapter 20
Overview, 442 Running the Metadata Manager Upgrade Utility on Windows, 444 Running the Metadata Manager Upgrade Utility on UNIX, 449 Upgrading the Metadata Manager Client, 453
441
Overview
When you upgrade Metadata Manager, you update the Metadata Manager repository, objects in the PowerCenter repository for Metadata Manager, Metadata Manager metamodels and reports, and the Metadata Manager Client. You must upgrade Metadata Manager when you install Metadata Manager 8.1.1. You can upgrade SuperGlue 2.1 and 2.2 and Metadata Manager 8.0 and above to Metadata Manager 8.1.1. To upgrade Metadata Manager, install the current version of Metadata Manager and run the upgrade utility installed with Metadata Manager. You must run the upgrade utility on the machine that has access to the Metadata Manager repository and the Metadata Manager instance. In addition, the Repository Service for the associated PowerCenter repository for Metadata Manager must be available. The mode you run the utility in depends on the operating system where you installed Metadata Manager:
Windows. You can run the upgrade utility in graphical mode on Windows. For more information, see Running the Metadata Manager Upgrade Utility on Windows on page 444. UNIX. You can run the upgrade utility in console mode on UNIX. For more information, see Running the Metadata Manager Upgrade Utility on UNIX on page 449.
When you install Metadata Manager, the PowerCenter installer configures the upgrade utility settings based on the directories and options you select during installation and stores the values from the installation in sg_upgrade.properties. The upgrade utility reads the values from the configuration file when you run the utility. You can modify the settings if they do not match the settings for the Metadata Manager components you want to upgrade. After you run the upgrade utility and upgrade the Metadata Manager components, upgrade the Metadata Manager Client. For more information, see Upgrading the Metadata Manager Client on page 453.
Note: The PowerCenter repository for Metadata Manager you upgrade must be version 8.1.1.
Upgrade Process
When you run the upgrade utility, you can choose to upgrade repositories and metamodels and reports. If you choose not to upgrade a component when you upgrade Metadata Manager, you can run the utility again to upgrade the component. During the upgrade process, you need to start or stop Metadata Manager, depending on the component you upgrade:
Repository. The utility upgrades objects in the Metadata Manager repository and updates objects in the PowerCenter repository for Metadata Manager. You start the Metadata Manager server before you upgrade the repositories. Metamodels and reports. The upgrade utility imports the latest version of the metamodels and reports into the Metadata Manager. The Metadata Manager server must be running
442
when you import metamodels and reports. The utility will prompt you to start the Metadata Manager server if it is not already running.
Note: The upgrade utility does not import the metamodels for a Metadata Manager repository
into an IBM DB2 database. You must manually import the metamodels for an IBM DB2 Metadata Manager repository. For more information about importing the metamodels, see Metadata Manager Post-Upgrade Tasks on page 467.
Overview
443
Stop the Metadata Manager server. On the command line, switch to the location of the upgrade utility. By default, the PowerCenter installer installs the Metadata Manager upgrade utility in the following directory:
/Informatica/PowerCenter8.1.1/MetadataManager/upgrade
3.
4. 5.
Under Upgrade Options, select the upgrade tasks that you want to perform. In the Server section, verify the details for the Metadata Manager server.
444
User name to log in to the Metadata Manager server. Default is admin. Password for the user name to log in to the Metadata Manager server.
If you are upgrading the repositories, continue with the next step. To import the latest metamodels and reports, skip to step 8.
6.
In the Metadata Manager Repository section, verify the database and directory information for the Metadata Manager repository you want to upgrade. If you upgrade a copy of the existing Metadata Manager repository, the Metadata Manager repository settings displayed on the upgrade utility refer to the original version of the repository database. You must enter the database information for the copy of the Metadata Manager repository database. Verify the following information:
Option Database User Name Database Password Database Type Database URL Description User name to connect to the database that contains the Metadata Manager repository. Password to connect to the database that contains the Metadata Manager repository. Type of database for the Metadata Manager repository. JDBC connection string used to connect to the Metadata Manager repository database. When you select the database type, the Metadata Manager upgrade utility displays the database URL syntax for the selected database type: Oracle:
jdbc:informatica:oracle://<host>:<port>;SID=<sid>
DB2:
jdbc:informatica:db2://<host>:<port>;DatabaseName=<database>
For more information about the JDBC drivers included in the PowerCenter installation, see JDBC Drivers on page 553. Database Connect String Native connect string to access the repository database. Required for an Oracle or IBM DB2 repository database. Use the syntax appropriate for the selected database: - Oracle: Same syntax as the TNSNAMES entry: aliasname.world. Example:
OraDB.world
- DB2: Syntax is DatabaseName. Database Code Page Code page for the connection object to the Metadata Manager repository database. The upgrade utility displays a list of valid code pages. For more information about these code pages, see Code Pages in the PowerCenter Administrator Guide.
445
Description Directory where the Metadata Manager upgrade SQL scripts are located. When you install Metadata Manager, the PowerCenter installer sets the directory to the default SQL directory:
<PowerCenter_installation_directory>\MetadataManager\ upgrade\upgrade_scripts
By default, you do not need to enter the directory. If the directory is blank, click Browse to locate the default directory. Report File Directory Directory where the Metadata Manager objects such as schemas, dashboards, and reports are located. When you install Metadata Manager, the PowerCenter installer sets the directory to the default report file directory:
/Informatica/PowerCenter8.1.1/MetadataManager/upgrade/reports
By default, you do not need to enter the directory. If the directory is blank, click Browse to locate the default directory. Metamodel File Directory Directory where the Metadata Manager metamodels are located. When you install Metadata Manager, the PowerCenter installer sets the directory to the default metamodel file directory:
/Informatica/PowerCenter8.1.1/MetadataManager/upgrade/ metamodel
By default, you do not need to enter the directory. If the directory is blank, click Browse to locate the default directory. Report Link Utility Directory Directory where the Metadata Manager report link utility is located. When you install Metadata Manager, the PowerCenter installer sets the directory to the default report link utility directory:
/Informatica/PowerCenter8.1.1/MetadataManager/upgrade/ reportlink
By default, you do not need to enter the directory. If the directory is blank, click Browse to locate the default directory. Metamodel Import Utility Directory Directory where the Metadata Manager metamodel import utility is located. When you install Metadata Manager, the PowerCenter installer sets the directory to the default metamodel import utility directory:
/Informatica/PowerCenter8.1.1/MetadataManager/upgrade/sgcmd
By default, you do not need to enter the directory. If the directory is blank, click Browse to locate the default directory. 7.
In the PowerCenter Repository for Metadata Manager section, enter the database and directory information for the PowerCenter repository for Metadata Manager. You may need to consult with the PowerCenter administrator to get the PowerCenter repository for Metadata Manager information. Verify the following information:
Windows Option Domain Name Domain Host Domain Port Domain User Name Description Name of the domain of the PowerCenter repository for Metadata Manager. Name of the machine hosting the PowerCenter domain. Port number for the domain where the PowerCenter repository for Metadata Manager is located. User name of the domain administrator.
446
Windows Option Domain Password Repository Service Name Integration Service Name Repository User Name Repository Password Database User Name Database Password Database Type Database URL
Description Password for the domain administrator. Name of the Repository Service associated with the PowerCenter repository for Metadata Manager. Name of the Integration Service associated with the PowerCenter repository. Repository user name with rights to update repository objects. Password for repository user. Database user name used to create to the PowerCenter repository for Metadata Manager. Password for the database user name used to create the PowerCenter repository for Metadata Manager. Type of database for the PowerCenter repository for Metadata Manager. JDBC connection string used to connect to the database that contains the PowerCenter repository for Metadata Manager. When you select the database type, the Metadata Manager upgrade utility displays the database URL syntax for the selected database type. Oracle:
jdbc:informatica:oracle://<host>:<port>;SID=<sid>
DB2:
jdbc:informatica:db2://<host>:<port>;DatabaseName=<database>
For more information about the JDBC drivers included in the PowerCenter installation, see JDBC Drivers on page 553. PowerCenter Utility Directory Directory where the PowerCenter utility commands are located. When you install Metadata Manager, the PowerCenter installer sets the directory to the default PowerCenter utility directory:
/Informatica/PowerCenter8.1.1/server/bin
By default, you do not need to enter the directory. If the directory is blank, click Browse to locate the default directory. 8. 9.
Review the upgrade information and click Save Settings to save the upgrade settings to sg_upgrade.properties file. Click Upgrade. The upgrade utility starts the repository upgrade process. If you select the option to upgrade the Metadata Manager metamodels and reports, the upgrade utility prompts you to start the Metadata Manager server. Start the Metadata Manager server and verify that it is running before you continue the upgrade process. If you do not want to upgrade the Metadata Manager metamodels and reports at this time, click No at the prompt to stop the upgrade utility from upgrading the metamodels and reports. You can run the upgrade utility again later to upgrade the metamodels and reports.
Running the Metadata Manager Upgrade Utility on Windows 447
When the upgrade utility completes the upgrade process, it writes information about the process to a log file with the file name imm_upgrade_<DateTime>.log. You can view the log file in the Metadata Manager upgrade /Log directory.
10.
Click Open Log to view the log file. The Open Log button displays after the upgrade process completes.
11.
Click Exit to close the utility. When you click Exit, the upgrade utility closes without saving the settings. You must click Save Settings to save any changes you make to the upgrade settings.
448
Stop the Metadata Manager server. On the command line, switch to the location of the upgrade utility. By default, the PowerCenter installer installs the Metadata Manager upgrade utility in the following directory:
/Informatica/PowerCenter8.1.1/MetadataManager/upgrade
3.
4. 5.
Select whether to override the inputs in the properties file. Select the upgrade options. Enter one of the following options:
Option Repository Metamodels and reports All Description Upgrades a previous version of the Metadata Manager repository and updates the PowerCenter repository for Metadata Manager. Imports the updated version of Metadata Manager metamodels and reports. Upgrades and updates the repositories and imports the updated metamodels and reports.
6.
Enter or verify the following information for the Metadata Manager server:
Option Metadata Manager Database URL Metadata Manager Server User Name Metadata Manager Server Password Description URL of the Metadata Manager instance. Use the following syntax for the URL:
http://<host>:<port>/imm
User name to log in to the Metadata Manager server. Default is admin. Password for the user name to log in to the Metadata Manager server.
449
If you are upgrading repositories, continue with the next step. To import the latest metamodels and reports, skip to step 9.
7.
In the Metadata Manager Repository section, verify the following database and directory information for the Metadata Manager repository you want to upgrade.
Option Metadata Manager Database User Name Metadata Manager Database Password Metadata Manager Database Type Metadata Manager Database URL Description User name to connect to the database that contains the Metadata Manager repository. Password to connect to the database that contains the Metadata Manager repository. Type of database for the Metadata Manager repository. JDBC connection string used to connect to the Metadata Manager repository database. When you select the database type, the Metadata Manager upgrade utility displays the database URL syntax for the selected database type. Oracle:
jdbc:informatica:oracle://<host>:<port>;SID=<sid>
DB2:
jdbc:informatica:db2://<host>:<port>;DatabaseName=<database>
For more information about the JDBC drivers included in the PowerCenter installation, see JDBC Drivers on page 553. Metadata Manager Database Connect String Native connect string to access the repository database. Required for an Oracle or IBM DB2 repository database. Use the syntax appropriate for the selected database: - Oracle: Same syntax as the TNSNAMES entry: aliasname.world. Example:
OraDB.world
- DB2: Syntax is DatabaseName. Metadata Manager Database Code Page Database SQL Directory Code page for the connection object to the Metadata Manager repository database. The upgrade utility displays a list of valid code pages. For more information about these code pages, see Code Pages in the PowerCenter Administrator Guide. Directory where the Metadata Manager upgrade SQL scripts are located. When you install Metadata Manager, the PowerCenter installer sets the directory to the default SQL directory:
<PowerCenter_installation_directory>\MetadataManager\ upgrade\upgrade_scripts
By default, you do not need to enter the directory. If the directory is blank, click Browse to locate the default directory. Report File Directory Directory where the Metadata Manager objects such as schemas, dashboards, and reports are located. When you install Metadata Manager, the PowerCenter installer sets the directory to the default report file directory:
/Informatica/PowerCenter8.1.1/MetadataManager/upgrade/reports
By default, you do not need to enter the directory. If the directory is blank, click Browse to locate the default directory.
450
Description Directory where the Metadata Manager metamodels are located. When you install Metadata Manager, the PowerCenter installer sets the directory to the default metamodel file directory:
/Informatica/PowerCenter8.1.1/MetadataManager/upgrade/ metamodel
By default, you do not need to enter the directory. If the directory is blank, click Browse to locate the default directory. Report Link Utility Directory Directory where the Metadata Manager report link utility is located. When you install Metadata Manager, the PowerCenter installer sets the directory to the default report link utility directory:
/Informatica/PowerCenter8.1.1/MetadataManager/upgrade/ reportlink
By default, you do not need to enter the directory. If the directory is blank, click Browse to locate the default directory. Metamodel Import Utility Directory Directory where the Metadata Manager metamodel import utility is located. When you install Metadata Manager, the PowerCenter installer sets the directory to the default metamodel import utility directory:
/Informatica/PowerCenter8.1.1/MetadataManager/upgrade/sgcmd
By default, you do not need to enter the directory. If the directory is blank, click Browse to locate the default directory.
Note: If you upgrade a copy of the existing Metadata Manager repository, the Metadata
Manager repository settings displayed on the upgrade utility refer to the original version of the repository database. You must enter the database information for the copy of the Metadata Manager repository database.
8.
In the PowerCenter Repository for Metadata Manager section, enter or verify the following database and directory information for the PowerCenter repository for Metadata Manager:
Option PowerCenter Repository Domain Name PowerCenter Repository Domain Host PowerCenter Repository Domain Port PowerCenter Repository Domain User Name PowerCenter Repository Domain Password PowerCenter Repository Service Name PowerCenter Integration Service Name Description Name of the domain of the PowerCenter repository for Metadata Manager. Name of the machine hosting the PowerCenter domain. Port number for the domain where the PowerCenter repository for Metadata Manager is located. User name of the domain administrator. Password for the domain administrator. Name of the Repository Service associated with the PowerCenter repository for Metadata Manager. Name of the Integration Service associated with the PowerCenter repository.
451
Option PowerCenter Repository User Name PowerCenter Repository Password PowerCenter Repository Database User Name PowerCenter Repository Database Password PowerCenter Repository Database Type PowerCenter Repository Database URL
Description Repository user name with rights to update repository objects. Password for repository user. Database user name used to create the PowerCenter repository for Metadata Manager. Password of the database user name used to create the PowerCenter repository for Metadata Manager. Type of database for the PowerCenter repository for Metadata Manager. JDBC connection string used to connect to the database that contains the PowerCenter repository for Metadata Manager. When you select the database type, the Metadata Manager upgrade utility displays the database URL syntax for the selected database type. Oracle:
jdbc:informatica:oracle://<host>:<port>;SID=<sid>
DB2:
jdbc:informatica:db2://<host>:<port>;DatabaseName=<database>
For more information about the JDBC drivers included in the PowerCenter installation, see JDBC Drivers on page 553. PowerCenter Utilities Directory Directory where the PowerCenter utility commands are located. When you install Metadata Manager, the PowerCenter installer sets the directory to the default PowerCenter utility directory:
/Informatica/PowerCenter8.1.1/server/bin
By default, you do not need to enter the directory. If the directory is blank, click Browse to locate the default directory.
Note: You may need to consult with the PowerCenter administrator to get the
When the utility prompts you, start the Metadata Manager server and verify the application is running before you continue.
The upgrade utility continues the repository upgrade process. When the upgrade utility completes the upgrade process, it writes information about the process to imm_upgrade_<DateTime>.log, located in the Metadata Manager upgrade directory.
452
2.
Stop the Metadata Manager Scheduler service. To ensure a clean uninstallation of the Metadata Manager Client, stop the scheduler service. The scheduler service runs on the Windows machine hosting the Configuration Console. Go to Services in the Control Panel and stop the service named Informatica PowerCenter Metadata Manager Scheduler. For SuperGlue 2.1 or 2.2, the service is named Informatica SuperGlue Scheduler. Uninstall the Metadata Manager Client. Run the uninstaller for the Metadata Manager Client (previously named SuperGlue). Follow the instructions in the uninstaller. Manually delete any file that was not removed by the uninstaller. Install the latest version of the Metadata Manager Client. For information about installing the Metadata Manager Client, see PowerCenter Client Installation on page 265. Verify and save the source repository connections for XConnects. Verify and save the source repository connections for XConnects. Verify and save the source repository connection information for each XConnect in the Metadata Manager Console. If password or DSN is blank, enter the password again and select a DSN for PowerCenter, Data Analyzer, and RDBMS Xconnects. For more information about saving the source repository connections, see Setting Up XConnect Source Repository Connections in the Metadata Manager Administrator Guide. Configure the parameters for XConnects. Verify the values for the parameters before you run the upgraded XConnects. Reconfigure the settings if necessary. For more information about setting the parameters for the packaged XConnects, see Configuring Parameters for XConnects in the Metadata Manager Administrator Guide.
3.
4.
5.
6.
453
For custom XConnects, manually configure the new parameter files to match the old parameter files. For more information about configuring parameter files for custom XConnects, see the Creating an XConnect Manually in the Metadata Manager Custom Metadata Integration Guide.
454
Chapter 21
Overview, 456 PowerCenter 6.x / 7.x Post-Upgrade Tasks, 457 PowerCenter 8.0 Post-Upgrade Tasks, 460 PowerCenter 8.1 Post-Upgrade Tasks, 462 Data Analyzer Post-Upgrade Tasks, 464 Metadata Manager Post-Upgrade Tasks, 467
455
Overview
The post-upgrade tasks you perform depend on the PowerCenter version and component you upgrade from:
PowerCenter 6.x or 7.x. If you upgrade from PowerCenter 6.x or 7.x, you may need to register a local repository with a global repository, configure application services, update password variables, and move PowerCenter run-time files. You can also upgrade to a UTF-8 repository. For more information, see PowerCenter 6.x / 7.x Post-Upgrade Tasks on page 457. PowerCenter 8.0. If you upgrade from PowerCenter 8.0, copy domains.infa to the new installation directory and start Informatica Services. You may need recreate the Repository Service for Metadata Manager, change $PMRootDir and move Integration Service runtime files, and reconfigure the shared directory for the Log Manager. For more information, see PowerCenter 8.0 Post-Upgrade Tasks on page 460. PowerCenter 8.1. If you upgrade from PowerCenter 8.1, reconfigure environment variables, restart Informatica Services, and run the RegisterPlugin pmrep command to update the repository. For more information, see PowerCenter 8.1 Post-Upgrade Tasks on page 462. Data Analyzer. If you upgrade from Data Analyzer version 8.0 or earlier, you must update configuration files, color schemes, cached reports, location of shared documents, and refresh PowerCenter table definitions. For more information, see Data Analyzer PostUpgrade Tasks on page 464. Metadata Manager. If you upgrade from Metadata Manager 8.1 or earlier, you must refresh Metadata Manager views. You may also need to delete obsolete Metadata Manager objects, import metamodels, and update metadata. For more information, see Metadata Manager Post-Upgrade Tasks on page 467.
456
457
Move the files to server/infa_shared directory under the PowerCenter Services installation directory. Update $PMRootDir for the Integration Service process in the Administration Console. For more information about configuring $PMRootDir, see Creating and Configuring the Integration Service in the PowerCenter Administrator Guide.
Note: If you upgraded the PowerCenter Server to an Integration Service on the same machine,
the Integration Service can access the files if you do not move them.
Create and configure the Web Services Hub. Create the Web Services Hub in the Administration Console. You must upgrade the associated repository before you create a new Web Services Hub. Use the settings from the backup version of the configuration file to duplicate the previous settings. For more information, see Creating and Configuring the Web Services Hub in the PowerCenter Administrator Guide. Update client applications. The services hosted by the Web Services Hub are stateless. You must update service workflows and service-enabled objects to use the new URL and user name and password. The new endpoint for web services consumer applications is WSH. The client application samples included with PowerCenter include the new URL. For more information, see the PowerCenter Post-Upgrade Reference and the PowerCenter Web Services Provider Guide.
458
459
4.
5.
Move the files to server/infa_shared directory under the PowerCenter Services installation directory. Update $PMRootDir for the Integration Service process in the Administration Console. For more information about configuring $PMRootDir, see Creating and Configuring the Integration Service in the PowerCenter Administrator Guide.
460
461
SQL transformation Unstructured Data Option PowerExchange Client for PowerCenter PowerCenter Connect for Saleforce.com PowerCenter Connect for SAP NetWeaver mySAP Option business content integration PowerCenter Connect for Web Services
Complete the following steps to update the repository: 1. 2. Configure the 8.1.1 Repository Service to run in exclusive mode. Connect to the 8.1.1 Repository Service with the pmrep Connect command using a user account with Admin Repository privilege. For more information about using the pmrep Connect command, see the PowerCenter Command Line Reference. 3. Locate the registration file name of the feature that requires a repository content update. The files are located in $INFA_ROOT\server\bin\native.
Note: $INFA_ROOT is the PowerCenter 8.1.1 installation directory.
462
The following table lists the registration files for each feature:
Feature SQL transformation Unstructured Data Option PowerExchange Client for PowerCenter PowerCenter Connect for Salesforce.com PowerCenter Connect for SAP NetWeaver mySAP Option business content integration PowerCenter Connect for Web Services Filename pmsqlt.xml pmudt.xml pmpwxclnt.xml pmsfdc.xml lmapitgt.xml pmwsconsumer.xml
4.
Use the pmrep RegisterPlugin command to update the repository. The RegisterPlugin command uses the following syntax:
registerplugin -i <input_registration_file_name_or_path> -e -N
For more information about the pmrep RegisterPlugin command, see the PowerCenter Command Line Reference. 5. Repeat steps 3 to 4 for each feature.
463
3. 4.
5.
3. 4.
Use the EAR Repackager utility to repackage the color scheme files back into the Data Analyzer 8.1.1 EAR file. Set up the custom color scheme in the Color Schemes and Logos section of the Administration tab in Data Analyzer.
For more information about setting up color schemes in Data Analyzer, see the color schemes section in Managing System Settings in the Data Analyzer Administrator Guide. For more information about using the EAR Repackager utility to access the Data Analyzer EAR file, see Accessing the Data Analyzer EAR File in the Data Analyzer Administrator Guide.
464
Log in to Data Analyzer. Click Administration > Scheduling > Time-Based Schedules. Click Run Now for each time-based schedule in the list. Data Analyzer queues all the cached reports and runs them on the time-based schedule. Depending on the number of cached reports, the process may take a while.
4. 5.
Click Administration > Scheduling > Event-Based Schedules. Click Run Now for each event-based schedule in the list. Data Analyzer queues all the reports and runs them on the event-based schedule. Depending on the number of cached reports, the process may take a while.
6.
Log in to Data Analyzer with system administrator privileges. Click Administration > Schema Design > Table Definitions.
465
Click Refresh Tables. The Refresh Tables page displays the list of data sources available in Data Analyzer. The pound symbol (#) before the data source name indicates a PowerCenter data source.
4.
Select the data source for the PowerCenter tables. The list of tables definitions from the selected data source appears.
5.
Click OK to refresh all the table definitions. If you do not want to refresh all the table definitions, select only the tables that you want to refresh and click OK.
466
2.
3.
4.
Log in to Metadata Manager with the administrator user name and password. Click Administration > Table Definitions. On the Table Definitions page, click Refresh Tables. Select the IMMREPORT data source. The Refresh Tables page displays the list of table definitions available in the data source. By default, all tables are selected.
5. 6.
Clear all table selections, except IMA_ASSOCIATION and IMA_REPOSITORY. Click OK.
467
Log in to Metadata Manager with the administrator user name and password. The default Metadata Manager administrator user name is admin and the default password is admin.
2. 3. 4.
Click Administration > Schema Directory > Metrics. On the Metrics page, select all metric folders. Clear the following options to keep the associated folders:
5. 6.
Click Remove to delete the selected folders. Click OK to confirm that you want to delete the folders. Metadata Manager deletes the selected folders. It does not delete the folders that are not selected.
7. 8. 9.
Click Administration > Schema Directory > Attributes. On the Attributes page, select all attribute folders. Clear the following options to keep the associated folders:
ODS Report Attributes Operational Attributes Metamodel Element Association From Elements To Elements Associations
10. 11.
Click Remove. Click OK to confirm that you want to delete the folders. Metadata Manager deletes the selected folders.
12. 13.
Click the Find tab. On the Show list, select Information Directory.
468
Under Public Folders, expand Business Intelligence. Select Semantic Exploration. In the Details task area, click Delete. Click OK to confirm that you want to delete the folder. Metadata Manager deletes the selected folder.
18.
Database Content Exploration (a subfolder in the Database Management folder) ODS Report Templates
19.
Import all the metamodels in the directory into the upgraded Metadata Manager repository. You must import the first three metamodels in the following order:
After you import the first three metamodels, you can import the rest of the metamodels in any order.
Note: You must import the DB2Cubeviews.xml metamodel twice.
For more information about importing metamodels, see Exchanging Metamodels in the Metadata Manager Administrator Guide.
470
Understanding Connectivity, 473 Connecting to Databases from Windows, 487 Connecting to Databases from UNIX, 503
471
472
Chapter 22
Understanding Connectivity
Overview, 474 Domain Connectivity, 477 Native Connectivity, 478 ODBC, 479 PowerCenter Client Connectivity, 481 Repository Service Connectivity, 483 Integration Service Connectivity, 484 Data Analyzer and Metadata Manager Connectivity, 486
473
Overview
PowerCenter uses the TCP/IP network protocol, native database drivers, ODBC, and JDBC for communication between the following PowerCenter components:
Domain and nodes. Nodes and services within a domain use TCP/IP to communicate with other nodes and services. For more information, see Domain Connectivity on page 477. PowerCenter Client. The PowerCenter Client uses ODBC to connect to source and target databases. The PowerCenter Client uses native protocol to communicate with the Repository Service and Integration Service. For more information about PowerCenter Client connectivity, see PowerCenter Client Connectivity on page 481. Repository Service. The Repository Service uses native database drivers to communicate with the PowerCenter repository. The Repository Service uses TCP/IP to communicate with other PowerCenter components. For more information about Repository Service connectivity, see Repository Service Connectivity on page 483. Integration Service. The Integration Service uses native database connectivity and ODBC to connect to source and target databases. The Integration Service uses TCP/IP to communicate with other PowerCenter components. For more information about Integration Service connectivity, see Integration Service Connectivity on page 484. Data Analyzer and Metadata Manager. Data Analyzer and Metadata Manager use JDBC and ODBC to access data sources and repositories. For more information, see Data Analyzer and Metadata Manager Connectivity on page 486.
474
Connectivity Types
PowerCenter components use the following types of connectivity:
Network protocol. Application services and the Service Managers in a domain use TCP/IP network protocol to communicate with other nodes and services. The PowerCenter Client also uses TCP/IP to communicate with application services. You can configure the host name and port number for TCP/IP communication on a node when you install PowerCenter Services. You can configure the port numbers used for services on a node when you install PowerCenter or by using the Administration Console. Native drivers. Native drivers are packaged with database server and client software. The Repository Service and Integration Service use the native drivers to communicate with databases. You must install and configure native database client software on the machines where the Integration Service and Repository Service run. For more information, see Native Connectivity on page 478. ODBC. The PowerCenter installer installs ODBC drivers when you install PowerCenter Services and the PowerCenter Client. For more information about ODBC, see ODBC on page 479. JDBC. Data Analyzer uses JDBC to communicate with the Data Analyzer repository and data sources. Metadata Manager uses JDBC to communicate with the Metadata Manager repository and metadata source repositories. For more information about connectivity between Data Analyzer and Metadata Manager components, see Data Analyzer and Metadata Manager Connectivity on page 486. The PowerCenter installer uses JDBC to communicate with the domain configuration database during installation. The gateway nodes in the PowerCenter domain use JDBC to connect to the domain configuration database after you install.
Data Analyzer
Overview
475
476
Domain Connectivity
Services on a node in a PowerCenter domain use TCP/IP to connect to services on other nodes. Because services can run on multiple nodes in the domain, services rely on the Service Manager running on the master gateway node to route requests. The Service Manager on the master gateway node handles requests for services and responds with the address of the requested service. Nodes communicate through TCP/IP on the port you select for a node when you install PowerCenter Services. When you create a node, you select a port number for the node. The Service Manager on a node listens for incoming TCP/IP connections on that port. Figure 22-2 shows the path of a request when you use the PowerCenter Client to connect to the repository:
Figure 22-2. PowerCenter Repository Connectivity
PowerCenter Client 1 Node 1 Service Manager Application Services Repository Service Node 2 (Gateway) Service Manager Application Services
Repository Database
The following process describes how a repository client application connects to the repository database: 1. 2. The PowerCenter Client receives the address of the Repository Service from the master gateway node. The PowerCenter Client connects to the Repository Service.
Other client applications and nodes use a similar process to establish connections between other application services and nodes in a domain.
Domain Connectivity
477
Native Connectivity
Native drivers are packaged with database server and client software. The Repository Service and Integration Service use native drivers to communicate with databases. When communicating with a database, the services pass database calls directly to the native drivers installed with the database client software. The client software passes the calls to the database, and returns information from the database to the service. For example, the Integration Service writes session data to a DB2 target. When you run the session, the Integration Service reads target database information from the target database connection stored in the repository. It uses this information to connect to the target database through the drivers included with the DB2 Client Application Enabler (CAE) installed on the Integration Service machine. The Integration Service performs all transactions with the target database through this client software.
*Sybase ASE servername is the name of the Adaptive Server from the interfaces file. **Use Teradata ODBC drivers to connect to source and target databases.
For more information about establishing native connectivity on Windows, see Connecting to Databases from Windows on page 487. For more information about establishing native connectivity on UNIX, see Connecting to Databases from UNIX on page 503.
478 Chapter 22: Understanding Connectivity
ODBC
Open Database Connectivity (ODBC) provides a common way to communicate with different database platforms. The PowerCenter Client uses ODBC drivers to connect to source target, lookup, and stored procedure databases. The Integration Service may also use ODBC drivers to connect to databases. When communicating with a database, the PowerCenter application passes all database calls to the ODBC driver. The driver interprets the information and sends it to the native database client connectivity software. From there, the information passes to the database that processes the command and sends the requested information back to the PowerCenter Client tool. For example, when you import a source definition using the PowerCenter Client, the PowerCenter Client issues a call to the ODBC driver. The ODBC driver translates the call and passes it to the native database connectivity software, which in turn passes it to the database. The database processes the request and sends the information back to the Designer (passing through the native software layer and ODBC software), which displays the source definition.
Note: Some ODBC drivers contain wire protocols and do not require database client software
installed on the PowerCenter Client machine or the machine where the Integration Service process runs. For more information about which ODBC drivers require a database client, see Table 22-3 on page 480.
Database client software. Install the client software included with the database platform. This installs the client libraries needed to connect to the database. ODBC drivers. PowerCenter installs DataDirect closed 32-bit ODBC drivers when you install PowerCenter Services or the PowerCenter Client. Your database platform may also come with an ODBC driver.
After you install the necessary components you must configure an ODBC data source for each database you want to connect to. A data source contains information that you need to locate and access the database, such as database name, user name, and database password. On Windows, you use the ODBC Data Source Administrator to create a data source name. On UNIX, you add data source entries to the odbc.ini file found in the system $ODBCHOME directory. When you create an ODBC data source, you must also specify the driver that the ODBC driver manager sends database calls to. For more information about ODBC calls, see ODBC Calls on page 549.
ODBC
479
Table 22-3 shows the recommended ODBC drivers to use with each database:
Table 22-3. Recommended Database ODBC Drivers
Database IBM DB2 Informix Microsoft Access Microsoft Excel Microsoft SQL Server Oracle Sybase ASE Teradata ODBC Driver IBM ODBC driver DataDirect 32-bit closed ODBC driver Microsoft Access driver Microsoft Excel driver Microsoft SQL Server ODBC driver DataDirect 32-bit closed ODBC driver DataDirect 32-bit closed ODBC driver Teradata ODBC driver Requires Database Client Software Yes No Yes Yes Yes No No n/a
For more information about establishing ODBC connectivity on Windows, see Connecting to Databases from Windows on page 487. For more information about establishing ODBC connectivity on UNIX, see Connecting to Databases from UNIX on page 503.
480
Connecting to Databases
To connect the Designer to databases, use the Windows ODBC Data Source Administrator to create a data source for each database you want to access. Select the data source names in the Designer when you perform the following tasks:
Import a table or a stored procedure definition from a database. Use the Source Analyzer or Target Designer to import the table from the database. Use the Transformation Developer, Mapplet Designer, or Mapping Designer to import a stored procedure or a table for a Lookup transformation. To connect to the database, you must also provide your database user name, password, and table or stored procedure owner name.
Preview data. You can select the data source name when you preview data in the Source Analyzer or Target Designer. You must also provide your database user name, password, and table owner name.
481
that repository in the Administration Console. For more information, see Using the Workflow Manager and Monitoring Workflows in the PowerCenter Workflow Administration Guide.
482
Note: The Integration Service connects to the Repository Service to retrieve metadata when it
runs workflows. You configure the associated repository for an Integration Service when you create or configure an Integration Service in the Administration Console.
Connecting to Databases
The Repository Service uses the connection information for the service and native database drivers to communicate with the repository. To connect a Repository Service to a repository database, you configure the database properties in the Administration Console. You must install and configure the native database drivers for the repository database on the machine where the Repository Service runs. When you install PowerCenter Services, the installer establishes the connection to the repository database from the Repository Service. You can create additional repository databases and create additional Repository Services for repository databases.
483
Note: Both the Windows and UNIX versions of the Integration Service can use ODBC drivers to connect to databases. You can use native drivers to improve performance.
The Integration Service includes ODBC libraries that you can use to connect to other ODBC sources. The PowerCenter installer installs ODBC drivers. For flat file, XML, or COBOL sources, you can either access data with network connections (such as NFS) or transfer data to the Integration Service machine through FTP software. For information about connectivity software for other ODBC sources, refer to your database documentation.
Connecting to Databases
Use the Workflow Manager to create connections to databases. You can select native database drivers for the Integration Service or you can use ODBC. For each connection, you must
484
specify the database user name, password, and native connect string. The Integration Service uses this information to connect to the database when it runs the session.
Note: PowerCenter supports ODBC drivers, such as ISG Navigator, that do not need user
names and passwords to connect. To avoid using empty strings or nulls, use the reserved words PmNullUser and PmNullPasswd for the user name and password when you configure a database connection. The Integration Service treats PmNullUser and PmNullPasswd as no user and no password.
485
You can use the installed JDBC drivers to connect to the Data Analyzer or Metadata Manager repository, data source, or to a PowerCenter repository. The PowerCenter installer does not install ODBC drivers or the JDBC-ODBC bridge for Data Analyzer or Metadata Manager. It installs ODBC drivers for the Metadata Manager Client. For more information on the JDBC drivers installed with Data Analyzer and Metadata Manager, see Installed JDBC Drivers on page 554.
486
Chapter 23
Overview, 488 Connecting to an IBM DB2 Universal Database, 489 Connecting to an Informix Database, 491 Connecting to Microsoft Access and Microsoft Excel, 493 Connecting to a Microsoft SQL Server Database, 494 Connecting to an Oracle Database, 496 Connecting to a Sybase ASE Database, 499 Connecting to a Teradata Database, 501
487
Overview
The Repository Service uses native drivers to communicate with the repository database. The Integration Service uses either native drivers or ODBC to communicate with databases. To improve performance, use native database drivers. The PowerCenter Client uses ODBC. To connect to a database, you must install and configure native database client connectivity software on the machine where you configure the Repository Service and Integration Service processes to run. To ensure compatibility between the Integration Service, the Repository Service, and a repository database, use the appropriate database client libraries. For more information, see Working with 32-bit and 64-bit Platforms on page 46. PowerCenter 8.1.1 includes DataDirect 5.1 ODBC drivers. If you have existing ODBC data sources created with an earlier version of the drivers, you must create new ODBC data sources using the new drivers for all ODBC data sources used by the Integration Service or PowerCenter Client.
488
Integration Service. Install or verify that you have installed IBM DB2 Client Application Enabler (CAE) on the machine where the Integration Service process runs. The Integration Service uses either native connectivity or ODBC to communicate with IBM DB2. For increased performance, use native connectivity. Repository Service. If you create an IBM DB2 repository, install or verify that you have installed IBM DB2 Client Application Enabler (CAE) on the machine where the Repository Service process runs. The Repository Service uses native connectivity to communicate with IBM DB2. PowerCenter Client. Install or verify you have installed IBM DB2 Client Application Enabler (CAE) on each PowerCenter Client machine accessing IBM DB2. The PowerCenter Client uses ODBC to communicate with IBM DB2. Use the Workflow Manager to create a database connection object for the IBM DB2 database.
You must install the IBM DB2 Client Application Enabler (CAE) version that is compatible with the IBM DB2 database server. To verify compatibility, contact IBM.
Verify that the following environment variable settings have been established by DB2 Client Application Enabler:
DB2HOME=C:\SQLLIB (directory where the client is installed) DB2INSTANCE = DB2 DB2CODEPAGE = 437 (Sometimes required. Use only if you encounter problems. Depends on the locale, you may use other values.)
2.
Verify that the PATH environment variable includes the DB2 bin directory. For example:
PATH=C:\WINNT\SYSTEM32;C:\SQLLIB\BIN;...
3.
Configure the IBM DB2 client to connect to the database that you want to access.
Launch the Client Configuration Assistant. Add the database connection and BIND the connection.
4.
489
If the connection is successful, disconnect and clean up with the TERMINATE command. If the connection fails, refer to the database documentation.
Install the IBM DB2 Client Application Enabler (CAE) and configure native connectivity. Create an ODBC data source using the driver provided by IBM. Do not use the DataDirect 32-bit closed ODBC driver for DB2 provided by Informatica. For specific instructions on creating an ODBC data source using the IBM DB2 ODBC driver, refer to the database documentation.
3.
Verify that you can connect to the DB2 database using the ODBC data source. If the connection fails, refer to the database documentation.
490
Integration Service.You must install or verify that you have installed ESQL for C, Informix Client SDK, or any other Informix client software on the machine where the Integration Service process runs. Also, install compatible versions of ESQL/runtime or iconnect. The Integration Service uses either native connectivity or ODBC to communicate with Informix. Use native connectivity for increased performance. You must install the ESQL/C version that is compatible with the Informix database server. To verify compatibility, contact Informix.
PowerCenter Client. Use the Workflow Manager to create a database connection object for the Informix database.
Note: You do not need to install the database client on PowerCenter Client machines. To
connect to an Informix database using the PowerCenter Client, use the DataDirect 5.1 ODBC drivers provided with PowerCenter. The ODBC wire protocols do not require database client software to connect to sources and targets.
Set environment variables for INFORMIXDIR, DBDATE, and DBMONEY: INFORMIXDIR. Verify that the INFORMIXDIR environment variable is set. For example:
INFORMIXDIR=C:\Informix
DBDATE. Verify that DBDATE is set to the default value, MDY4/. DBMONEY. Set DBMONEY environment variable to ensure that Informix does not prefix the data with the dollar sign ($).
DBMONEY=' .' 2.
Verify that the PATH environment variable includes the INFORMIXDIR\bin directory. For example:
PATH=C:\Informix\bin;....
3.
Launch Informix SetNet32, and configure the Informix client to connect to the database that you want to access.
Connecting to an Informix Database 491
You may need to ask the Informix administrator for the following entries for the Server Information tab:
Protocol Name. Enter the protocol the Informix database server uses, usually onsoctcp. Service Name. Enter the service name the Informix server uses. The Informix server must also be defined in the services file. You might find the services file in the following location:
%WINDIR%\System32\Drivers\etc\Services
A sample entry in the services file might look like the following entry:
inflsnr 4. 1525/tcp
Verify that you can connect to the Informix database. To connect to the database, launch dbping and enter the necessary information. If you fail to connect to the database, verify that you correctly entered all of the connectivity information. The syntax for the connect string is dbname@servername. User names and database names may be case sensitive.
492
Integration Service. Install or verify that you have installed Microsoft Access or Excel on the machine where the Integration Service process runs. You must also create an ODBC data source to connect to a database. PowerCenter Client. Install or verify that you have installed Microsoft Access or Excel on the machine hosting the PowerCenter Client. You must also create an ODBC data source to connect to a database.
Create an ODBC data source using the driver provided by Microsoft. To avoid using empty string or nulls, use the reserved words PmNullUser for the user name and PmNullPasswd for the password when you create a database connection in the Workflow Manager.
493
Integration Service. Install or verify that you have installed SQL Client, including the Microsoft OLE DB provider for Microsoft SQL Server, on the machine where the Integration Service process runs. The Integration Service uses either native connectivity or ODBC to communicate with Microsoft SQL Server. Use native connectivity for increased performance. Repository Service. If you create a Microsoft SQL Server repository, install or verify that you have installed SQL Client, including the Microsoft OLE DB provider, on the machine where the Repository Service runs. The Repository Service uses native connectivity to communicate with Microsoft SQL Server. PowerCenter Client. Install or verify that you have installed SQL Client, including the Microsoft OLE DB provider for Microsoft SQL Server, on each PowerCenter Client machine accessing Microsoft SQL Server. The PowerCenter Client uses ODBC to communicate with Microsoft SQL Server. Use the Workflow Manager to create a database connection object for the Microsoft SQL Server database.
You must install an SQL Client version that is compatible with the Microsoft SQL Server database server. To verify compatibility, contact Microsoft.
Note: PowerCenter can communicate with Microsoft SQL Server 7.0, with Service Pack 1 or
Verify that the Microsoft SQL Server home directory is set. Verify that the PATH environment variable includes the Microsoft SQL Server directory. For example:
PATH=C:\MSSQL\BIN;C:\MSSQL\BINN;....
3.
Configure the Microsoft SQL Server client to connect to the database that you want to access. Launch the Client Network Utility. On the General tab, verify that the Default Network Library matches the default network for the Microsoft SQL Server database.
494
4.
Verify that you can connect to the Microsoft SQL Server database. To connect to the database, launch ISQL_w, and enter the connectivity information. If you fail to connect to the database, verify that you correctly entered all of the connectivity information.
Install the Microsoft SQL Server client and configure native connectivity. Create an ODBC data source using the driver provided by Microsoft. Do not use the DataDirect 32-bit closed ODBC driver for Microsoft SQL Server provided by Informatica. To ensure consistent data in Microsoft SQL Server repositories, clear the Create temporary stored procedures for prepared SQL statements option in the Create a New Data Source to SQL Server dialog box. Figure 23-1 shows the dialog box for the Microsoft SQL Server ODBC setup:
Figure 23-1. ODBC Microsoft SQL Server Setup
Clear Create temporary stored procedures for prepared SQL statements and drop the stored procedures.
If you have difficulty clearing the temporary stored procedures for prepared SQL statements options, see the Informatica Knowledge Base for more information about configuring Microsoft SQL Server. You can access the Knowledge Base at http://my.informatica.com.
3.
Verify that you can connect to the Microsoft SQL Server database using the ODBC data source. If the connection fails, refer to the database documentation.
495
Integration Service. Install or verify that you have installed the Oracle client on the machine hosting the Integration Service. The Integration Service can use native connectivity or ODBC to communicate with Oracle. Use native connectivity for increased performance. Repository Service. If you create an Oracle repository, install or verify that you have installed the Oracle client on the machine where Repository Service process runs. The Repository Service uses native connectivity to communicate with Oracle. PowerCenter Client. Use the Workflow Manager to create a database connection object for the Oracle database.
Note: You do not need to install the database client on PowerCenter Client machines. To
connect to an Oracle database using the PowerCenter Client, use the DataDirect 5.1 ODBC driver provided with PowerCenter. The ODBC wire protocols do not require database client software to connect to sources and targets. You must install compatible versions of the Oracle client and Oracle database server. You must also install the same version of the Oracle client on each machine where an Integration Service or Repository Service process runs and hosts the Oracle database server. To verify compatibility, contact Oracle.
2.
Verify that the PATH environment variable includes the Oracle bin directory. For example, if you install Net8, the path might include the following entry:
PATH=C:\ORANT\BIN;
3.
Configure the Oracle client to connect to the database that you want to access. Launch SQL*Net Easy Configuration Utility or edit an existing tnsnames.ora file to the home directory and modify it.
496
The tnsnames.ora file is stored in the $ORACLE_HOME\network\admin directory. Enter the correct syntax for the Oracle connect string, typically databasename.world. Make sure the SID entered here matches the database server instance ID defined on the Oracle server. Following is a sample tnsnames.ora. You need to enter the information for the database.
mydatabase.world = (DESCRIPTION (ADDRESS_LIST = (ADDRESS = (COMMUNITY = mycompany.world (PROTOCOL = TCP) (Host = mymachine) (Port = 1521) ) ) (CONNECT_DATA = (SID = MYORA7) (GLOBAL_NAMES = mydatabase.world) 4.
Set the NLS_LANG environment variable to the locale (language, territory, and character set) you want the database client and server to use with the login. The value of this variable depends on the configuration. For example, if the value is american_america.UTF8, you must set the variable as follows:
NLS_LANG=american_america.UTF8;
Verify that you can connect to the Oracle database. To connect to the database, launch SQL*Plus and enter the connectivity information. If you fail to connect to the database, verify that you correctly entered all of the connectivity information. Use the connect string as defined in tnsnames.ora.
497
Create an ODBC data source using the DataDirect 5.1 ODBC driver for Oracle provided by Informatica. Verify that you can connect to the Oracle database using the ODBC data source.
498
Integration Service. Install or verify that you have installed Open Client on the machine where the Integration Service process runs. The Integration Service uses either native connectivity or ODBC to communicate with Sybase ASE. You should use native connectivity. Repository Service. Install or verify that you have installed Open Client on the machine where the Repository Service process runs. The Repository Service uses native connectivity to communicate with Sybase ASE. If you want to create, restore, or upgrade a Sybase ASE repository, set allow nulls by default to TRUE at the database level. Setting this option changes the default null type of the column to null in compliance with the SQL standard.
PowerCenter Client. Use the Workflow Manager to create a database connection object for the Sybase ASE database.
Note: You do not need to install the database client on PowerCenter Client machines. To
connect to an Sybase ASE database using the PowerCenter Client, use the DataDirect 5.1 ODBC drivers provided with PowerCenter. The ODBC wire protocols do not require database client software to connect to sources and targets.
Verify that the SYBASE environment variable refers to the Sybase ASE directory. For example:
SYBASE=C:\SYBASE
2.
Verify that the PATH environment variable includes the Sybase ASE directory. For example:
PATH=C:\SYBASE\BIN;C:\SYBASE\DLL
3.
Configure Sybase Open Client to connect to the database that you want to access.
499
Use SQLEDIT to configure the Sybase client, or copy an existing SQL.INI file (located in the %SYBASE%\INI directory) and make any necessary changes. Select NLWNSCK as the Net-Library driver and include the Sybase ASE server name. Enter the host name and port number for the Sybase ASE server. If you do not know the host name and port number, check with the system administrator.
4.
Verify that you can connect to the Sybase ASE database. To connect to the database, launch ISQL and enter the connectivity information. If you fail to connect to the database, verify that you correctly entered all of the connectivity information. User names and database names are case sensitive.
Create an ODBC data source using the DataDirect 32-bit closed ODBC driver for Sybase provided by Informatica. On the Performance tab, set Prepare Method to 2-Full. This ensures consistent data in the repository, optimizes performance, and reduces overhead on tempdb. Verify that you can connect to the Sybase ASE database using the ODBC data source.
500
Integration Service. Install or verify that you have installed the Teradata client, the Teradata ODBC driver, and any other Teradata client software you might need on the machine where the Integration Service process runs. You must also configure ODBC connectivity. PowerCenter Client. Install or verify that you have installed the Teradata client, the Teradata ODBC driver, and any other Teradata client software you might need on each PowerCenter Client machine accessing Teradata. Use the Workflow Manager to create a database connection object for the Teradata database.
Create an ODBC data source for each Teradata database that you want to access. To create the ODBC data source, use the driver provided by Teradata. Create a System DSN if you start the Informatica Services service with a Local System account logon. Create a User DSN if you select the This account log in option to start the Informatica Services service.
2.
Enter the name for the new ODBC data source and the name of the Teradata server or its IP address. To configure a connection to a single Teradata database, enter the DefaultDatabase name. To create a single connection to the default database, enter the user name and password. To connect to multiple databases, using the same ODBC data source, leave the DefaultDatabase field and the user name and password fields empty.
3. 4.
Configure Date Options in the Options dialog box. In the Teradata Options dialog box, specify AAA for DateTime Format. Configure Session Mode in the Options dialog box. When you create a target data source, choose ANSI session mode. If you choose ANSI session mode, Teradata does not roll back the transaction when it encounters a row error. If you choose Teradata session mode, Teradata rolls back the transaction when it
501
encounters a row error. In Teradata mode, the Integration Service cannot detect the rollback and does not report this in the session log.
5.
Verify that you can connect to the Teradata database. To test the connection, use a Teradata client program, such as WinDDI, BTEQ, Teradata Administrator, or Teradata SQL Assistant.
502
Chapter 24
Overview, 504 Connecting to an IBM DB2 Universal Database, 505 Connecting to an Informix Database, 508 Connecting to an Oracle Database, 511 Connecting to a Sybase ASE Database, 515 Connecting to a Teradata Database, 518 Connecting to an ODBC Data Source, 522 Sample odbc.ini File, 525
503
Overview
The Repository Service uses native drivers to communicate with the repository database. The Integration Service can use native drivers or ODBC to communicate with databases. Use native database drivers to increase performance. To connect to a database, install and configure native database client connectivity software on the machine where you configure the Repository Service and Integration Service processes to run. To ensure compatibility between the Integration Service, the Repository Service, and a repository database, use the appropriate database client libraries. For more information, see Working with 32-bit and 64-bit Platforms on page 46. On Linux, use native drivers to connect to IBM DB2, Oracle, or Sybase ASE databases.You can connect to other sources and targets using ODBC. The Informix client is not available on Linux. Use ODBC to connect to Informix from Linux. Configure ODBC connections using the DataDirect ODBC drivers provided with PowerCenter or third-party ODBC drivers that are Level 2 or above compliant. The ODBC wire protocols do not require database client software to connect to sources and targets. For more information, see Connecting to an ODBC Data Source on page 522.
Note: You cannot use Teradata or Informix for a PowerCenter repository.
504
Integration Service. Install IBM DB2 Client Application Enabler (CAE) on the machine where the Integration Service process runs. The Integration Service can use native connectivity or ODBC to communicate with IBM DB2. Use native connectivity for increased performance. Repository Service. If you create an IBM DB2 repository, install IBM DB2 Client Application Enabler (CAE) on the machine where the Repository Service process runs. The Repository Service uses native connectivity to communicate with IBM DB2.
You must install the IBM DB2 Client Application Enabler (CAE) version that is compatible with the IBM DB2 database server. To verify compatibility, contact IBM.
To configure connectivity on the machine where the Integration Service or Repository Service process runs, log in to the machine as a user who can start a service process. Set the DB2INSTANCE, INSTHOME, DB2DIR, and PATH environment variables. The UNIX IBM DB2 software always has an associated user login, often db2admin, which serves as a holder for database configurations. This user holds the instance for DB2. DB2INSTANCE. The name of the instance holder. Using a Bourne shell:
$ DB2INSTANCE=db2admin; export DB2INSTANCE
Using a C shell:
$ setenv DB2INSTANCE db2admin
Using a C shell:
$ setenv INSTHOME ~db2admin>
505
DB2DIR. Set the variable to point to the IBM DB2 CAE installation directory. For example, if the client is installed in the /opt/IBMdb2/v6.1 directory: Using a Bourne shell:
$ DB2DIR=/opt/IBMdb2/v6.1; export DB2DIR
Using a C shell:
$ setenv DB2DIR /opt/IBMdb2/v6.1
PATH. To run the IBM DB2 command line programs, set the variable to include the DB2 bin directory. Using a Bourne shell:
$ PATH=${PATH}:$DB2DIR/bin; export PATH
Using a C shell:
$ setenv PATH ${PATH}:$DB2DIR/bin 3.
Set the shared library variable to include the DB2 lib directory. The IBM DB2 client software contains a number of shared library components that the Integration Service and the Repository Service processes load dynamically. To locate the shared libraries during run time, set the shared library environment variable. The shared library path must also include the PowerCenter Services installation directory (server_dir). Set the shared library environment variable based on the operating system. The following table describes the shared library variables for each operating system:
Operating System Solaris Linux AIX HP-UX Variable LD_LIBRARY_PATH LD_LIBRARY_PATH LIBPATH SHLIB_PATH
For example, use the following syntax for Solaris and Linux:
Using a C shell:
$ setenv LD_LIBRARY_PATH ${LD_LIBRARY_PATH}:$HOME/server_dir:$DB2DIR/lib
For HP-UX:
506
Using a C shell:
For AIX:
4.
Using a C shell:
$ setenv LIBPATH ${LIBPATH}:$HOME/server_dir:$DB2DIR/lib
Edit the .cshrc or .profile to include the complete set of shell commands. Save the file and either log out and log in again or issue the source command. Using a Bourne shell:
$ source .profile
Using a C shell:
$ source .cshrc 5.
If the DB2 database resides on the same machine on which Integration Service or Repository Service processes run, configure the DB2 instance as a remote instance. Run the following command to verify if there is a remote entry for the database:
DB2 LIST DATABASE DIRECTORY
The command lists all the databases that the DB2 client can access and their configuration properties. If this command lists an entry for Directory entry type of Remote, skip to step 6. If the database is not configured as remote, run the following command to verify whether a TCP/IP node is cataloged for the host:
DB2 LIST NODE DIRECTORY
If the node name is empty, you can create one when you set up a remote database. Use the following command to set up a remote database and, if needed, create a node:
db2 CATALOG TCPIP NODE <nodename> REMOTE <hostname_or_address> SERVER <port number>
For more information about these commands, refer to the database documentation.
6.
Verify that you can connect to the DB2 database. Run the DB2 Command Line Processor and issue the command:
CONNECT TO <dbalias> USER <username> USING <password>
If the connection is successful, clean up with the CONNECT RESET or TERMINATE command.
507
To configure connectivity for the Integration Service process, log in to the machine as a user who can start the server process. Set the INFORMIXDIR, INFORMIXSERVER, DBMONEY, and PATH environment variables. INFORMIXDIR. Set the variable to the directory where the database client is installed. For example, if the client is installed in the /databases/informix directory: Using a Bourne shell:
$ INFORMIXDIR=/databases/informix; export INFORMIXDIR
Using a C shell:
$ setenv INFORMIXDIR /databases/informix
INFORMIXSERVER. Set the variable to the name of the server. For example, if the name of the Informix server is INFSERVER: Using a Bourne shell:
$ INFORMIXSERVER=INFSERVER; export INFORMIXSERVER
Using a C shell:
$ setenv INFORMIXSERVER INFSERVER
DBMONEY. Set the variable so Informix does not prefix the data with the dollar sign ($) for money datatypes.
508
Using a C shell:
$ setenv DBMONEY=' .'
PATH. To run the Informix command line programs, set the variable to include the Informix bin directory. Using a Bourne shell:
$ PATH=${PATH}:$INFORMIXDIR/bin; export PATH
Using a C shell:
$ setenv PATH ${PATH}:$INFORMIXDIR/bin 3.
Set the shared library path to include the Informix lib directory. The Informix client software contains a number of shared library components that the Integration Service process loads dynamically. To locate the shared libraries during run time, set the shared library environment variable. The shared library path must also include the PowerCenter Services installation directory (server_dir). Set the shared library environment variable based on the operating system. The following table describes the shared library variables for each operating system:
Operating System Solaris Linux AIX HP-UX Variable LD_LIBRARY_PATH LD_LIBRARY_PATH LIBPATH SHLIB_PATH
Using a C shell:
$ setenv LD_LIBRARY_PATH ${LD_LIBRARY_PATH}:$HOME/ server_dir:$INFORMIXDIR/lib:$INFORMIXDIR/lib/esql
For HP-UX
509
Using a C shell:
$ setenv SHLIB_PATH ${SHLIB_PATH}:$HOME/server_dir:$INFORMIXDIR/ lib:$INFORMIXDIR/lib/esql
For AIX
Using a C shell:
$ setenv LIBPATH ${LIBPATH}:$HOME/server_dir:$INFORMIXDIR/ lib:$INFORMIXDIR/lib/esql
4. 5. 6.
Optionally, set the $ONCONFIG environment variable to the Informix configuration file name. If you plan to call Informix stored procedures in mappings, set all of the date parameters to the Informix datatype Datetime year to fraction(5). Make sure the DBDATE environment variable is not set. For example, to check if DBDATE is set, you might type the following at a UNIX prompt:
$ env | grep -i DBDATE
Edit the .cshrc or .profile to include the complete set of shell commands. Save the file and either log out and log in again, or issue the source command. Using a Bourne shell:
$ source .profile
Using a C shell:
$ source .cshrc 8. 9.
Verify that the Informix server name is defined in the $INFORMIXDIR/etc/sqlhosts file. Verify that the Service (last column entry for the server named in the sqlhosts file) is defined in the services file (usually /etc/services). If not, define the Informix Services name in the Services file. Enter the Services name and port number. The default port number is 1525, which should work in most cases. See the Informix and UNIX documentation for more information.
10.
Verify that you can connect to the Informix database. If you fail to connect to the database, verify that you have correctly entered all the information.
510
Integration Service. Install the Oracle client on the machine where the Integration Service process runs. The Integration Service can use native connectivity or ODBC to communicate with Oracle. Use native connectivity for increased performance. Repository Service. If you create an Oracle repository, install the Oracle client on the machine where the Repository Service process runs. The Repository Service uses native connectivity to communicate with Oracle.
You must install compatible versions of Oracle client and Oracle database server. You must also install the same version of the Oracle client on the Oracle database server and each machine where Integration Service or Repository Service processes run. To verify compatibility, contact Oracle.
To configure connectivity for the Integration Service or Repository Service process, log in to the machine as a user who can start the server process. Set the ORACLE_HOME, NLS_LANG, TNS_ADMIN, and PATH environment variables. ORACLE_HOME. Set the variable to the Oracle client installation directory. For example, if the client is installed in the /HOME2/oracle directory: Using a Bourne shell:
$ ORACLE_HOME=/HOME2/oracle; export ORACLE_HOME
Using a C shell:
$ setenv ORACLE_HOME /HOME2/oracle
NLS_LANG. Set the variable to the locale (language, territory, and character set) you want the database client and server to use with the login. The value of this variable depends on the configuration. For example, if the value is american_america.UTF8, you must set the variable as follows: Using a Bourne shell:
$ NLS_LANG=american_america.UTF8; export NLS_LANG
511
Using a C shell:
$ NLS_LANG american_america.UTF8
To determine the value of this variable, contact the Administrator. TNS_ADMIN. Set the variable to the directory where the tnsnames.ora file resides. For example, if the file is in the /HOME2/oracle/network/admin directory: Using a Bourne shell:
$ TNS_ADMIN=$HOME2/oracle/network/admin; export TNS_ADMIN
Using a C shell:
$ setenv TNS_ADMIN=$HOME2/oracle/network/admin
Setting the TNS_ADMIN is optional, and might vary depending on the configuration. PATH. To run the Oracle command line programs, set the variable to include the Oracle bin directory. Using a Bourne shell:
$ PATH=${PATH}:$ORACLE_HOME/bin; export PATH
Using a C shell:
$ setenv PATH ${PATH}:ORACLE_HOME/bin 3.
Set the shared library environment variable. The Oracle client software contains a number of shared library components that the Integration Service and Repository Service processes load dynamically. To locate the shared libraries during run time, set the shared library environment variable. The shared library path must also include the PowerCenter Services installation directory (server_dir). Set the shared library environment variable based on the operating system. The following table describes the shared library variables for each operating system:
Operating System Solaris Linux AIX HP-UX Variable LD_LIBRARY_PATH LD_LIBRARY_PATH LIBPATH SHLIB_PATH
For example, use the following syntax for Solaris and Linux:
512
Using a C shell:
$ setenv LD_LIBRARY_PATH ${LD_LIBRARY_PATH}:$HOME/ server_dir:$ORACLE_HOME/lib
For HP-UX
Using a C shell:
$ setenv SHLIB_PATH ${SHLIB_PATH}:$HOME/server_dir:$ORACLE_HOME/lib
For AIX
4.
Using a C shell:
$ setenv LIBPATH ${LIBPATH}:$HOME/server_dir:$ORACLE_HOME/lib
Edit the .cshrc or .profile to include the complete set of shell commands. Save the file and either log out and log in again, or issue the source command. Using a Bourne shell:
$ source .profile
Using a C shell:
$ source .cshrc 5.
Verify that the Oracle client is configured to access the database. Use the SQL*Net Easy Configuration Utility or copy an existing tnsnames.ora file to the home directory and modify it. The tnsnames.ora file is stored in the $ORACLE_HOME/network/admin directory. Enter the correct syntax for the Oracle connect string, typically databasename.world. Here is a sample tnsnames.ora. You need to enter the information for the database.
mydatabase.world = (DESCRIPTION (ADDRESS_LIST = (ADDRESS = (COMMUNITY = mycompany.world (PROTOCOL = TCP) (Host = mymachine) (Port = 1521) ) )
513
Verify that you can connect to the Oracle database. To connect to the Oracle database, launch SQL*Plus and enter the connectivity information. If you fail to connect to the database, verify that you correctly entered all of the connectivity information. Enter the correct user name and connect string as defined in tnsnames.ora.
514
Integration Service. Install Open Client on the machine where the Integration Service process runs. The Integration Service can use native connectivity or ODBC to communicate with Sybase ASE. Use native connectivity for increased performance. Repository Service. If you create an Sybase ASE repository, install Open Client on the machine where the Repository Service process runs. The Repository Service uses native connectivity to communicate with Sybase ASE.
Note: If you want to create, restore, or upgrade a Sybase ASE repository, set allow nulls by
default to TRUE at the database level. Setting this option changes the default null type of the column to null in compliance with the SQL standard. You must install Open Client version that is compatible with the Sybase ASE database server. You must also install the same version of Open Client on the machines hosting the Sybase ASE database and PowerCenter. To verify compatibility, contact Sybase.
To configure connectivity to the Integration Service or Repository Service, log in to the machine as a user who can start the server process. Set the SYBASE and PATH environment variables. SYBASE. Set the variable to the Sybase Open Client installation directory. For example, if the client is installed in the /usr/sybase directory: Using a Bourne shell:
$ SYBASE=/usr/sybase; export SYBASE
Using a C shell:
$ setenv SYBASE /usr/sybase
PATH. To run the Sybase command line programs, set the variable to include the Sybase bin directory. Using a Bourne shell:
$ PATH=${PATH}:/usr/sybase/bin; export PATH
515
Using a C shell:
$ setenv PATH ${PATH}:/usr/sybase/bin 3.
Set the shared library environment variable. The Sybase Open Client software contains a number of shared library components that the Integration Service and the Repository Service processes load dynamically. To locate the shared libraries during run time, set the shared library environment variable. The shared library path must also include the PowerCenter Services installation directory (server_dir). Set the shared library environment variable based on the operating system. The following table describes the shared library variables for each operating system.
Operating System Solaris Linux AIX HP-UX Variable LD_LIBRARY_PATH LD_LIBRARY_PATH LIBPATH SHLIB_PATH
For example, use the following syntax for Solaris and Linux:
Using a C shell:
$ setenv LD_LIBRARY_PATH ${LD_LIBRARY_PATH}:$HOME/server_dir:$SYBASE/lib
For HP-UX
Using a C shell:
$ setenv SHLIB_PATH ${SHLIB_PATH}:$HOME/server_dir:$SYBASE/lib
For AIX
4.
Using a C shell:
$ setenv LIBPATH ${LIBPATH}:$HOME/server_dir:$SYBASE/lib
Edit the .cshrc or .profile to include the complete set of shell commands. Save the file and either log out and log in again, or issue the source command. Using a Bourne shell:
$ source .profile
516
Using a C shell:
$ source .cshrc 5. 6.
Verify the Sybase ASE server name in the Sybase interfaces file (stored in the $SYBASE directory). Verify that you can connect to the Sybase ASE database. To connect to the Sybase ASE database, launch ISQL and enter the connectivity information. If you fail to connect to the database, verify that you correctly entered all of the connectivity information. User names and database names are case sensitive.
517
Teradata. ODBC is a native interface for Teradata. Teradata does not have an ODBC driver for Linux.
To configure connectivity for the Integration Service process, log in to the machine as a user who can start a service process. Set the TERADATA_HOME, ODBCHOME, and PATH environment variables. TERADATA_HOME. Set the variable to the Teradata driver installation directory. The defaults are as follows: Using a Bourne shell:
$ TERADATA_HOME=/teradata/usr; export TERADATA_HOME
Using a C shell:
$ setenv TERADATA_HOME /teradata/usr
ODBCHOME. Set the variable to the ODBC installation directory. For example: Using a Bourne shell:
$ ODBCHOME=/usr/odbc; export ODBCHOME
Using a C shell:
$ setenv ODBCHOME /usr/odbc
PATH. To run the ivtestlib utility, to verify that the UNIX ODBC manager can load the driver files, set the variable as follows: Using a Bourne shell:
PATH="${PATH}:$ODBCHOME/bin:$TERADATA_HOME/bin"
Using a C shell:
$ setenv PATH ${PATH}:$ODBCHOME/bin:$TERADATA_HOME/bin
518
3.
Set the shared library environment variable. The Teradata software contains a number of shared library components that the Integration Service process loads dynamically. To locate the shared libraries during run time, set the shared library environment variable. The shared library path must also include the PowerCenter Services installation directory (server_dir). Set the shared library environment variable based on the operating system. The following table describes the shared library variables for each operating system:
Operating System Solaris Linux AIX HP-UX Variable LD_LIBRARY_PATH LD_LIBRARY_PATH LIBPATH SHLIB_PATH
Using a C shell:
$ setenv LD_LIBRARY_PATH "${LD_LIBRARY_PATH}:$HOME/server_dir:$ODBCHOME/ lib:$TERADATA_HOME/lib:$TERADATA_HOME/odbc/lib"
For HP-UX
Using a C shell:
$ setenv SHLIB_PATH ${SHLIB_PATH}:$HOME/server_dir:$ODBCHOME/lib
For AIX
4.
Using a C shell:
$ setenv LIBPATH ${LIBPATH}:$HOME/server_dir:$ODBCHOME/lib
Edit the existing odbc.ini file or copy the odbc.ini file to the home directory and edit it. This file exists in $ODBCHOME directory.
$ cp $ODBCHOME/odbc.ini $HOME/.odbc.ini
Add an entry for the Teradata data source under the section [ODBC Data Sources] and configure the data source.
519
For example:
MY_TERADATA_SOURCE=Teradata Driver [MY_TERADATA_SOURCE] Driver=/u01/app/teradata/td-tuf611/odbc/drivers/tdata.so Description=NCR 3600 running Teradata V1R5.2 DBCName=208.199.59.208 DateTimeFormat=AAA SessionMode=ANSI DefaultDatabase= Username= Password= 5. 6.
Set the DateTimeFormat to AAA in the Teradata data ODBC configuration. Optionally, set the SessionMode to ANSI. When you use ANSI session mode, Teradata does not roll back the transaction when it encounters a row error. If you choose Teradata session mode, Teradata rolls back the transaction when it encounters a row error. In Teradata mode, the Integration Service process cannot detect the rollback, and does not report this in the session log. To configure connection to a single Teradata database, enter the DefaultDatabase name. To create a single connection to the default database, enter the user name and password. To connect to multiple databases, using the same ODBC DSN, leave the DefaultDatabase field empty. For more information about Teradata connectivity, consult the Teradata ODBC driver documentation. For a sample odbc.ini file, see Sample odbc.ini File on page 525.
7.
8.
Verify that the last entry in the odbc.ini is InstallDir and set it to the odbc installation directory. For example:
InstallDir=/usr/odbc
9. 10.
Edit the .cshrc or .profile to include the complete set of shell commands. Save the file and either log out and log in again, or issue the source command. Using a Bourne shell:
$ source .profile
Using a C shell:
$ source .cshrc 11.
For each data source you use, make a note of the file name under the Driver=<parameter> in the data source entry in odbc.ini. Use the ivtestlib utility to verify that the UNIX ODBC manager can load the driver file.
520
521
earlier version, edit odbc.ini to update your existing connections to use the new drivers.
To connect to an ODBC data source: 1. 2.
To configure connectivity for the Integration Service process, log in to the machine as a user who can start a service process. Set the ODBCHOME and PATH environment variables. ODBCHOME. Set to the DataDirect ODBC installation directory. For example, if the install directory is /opt/ODBC5.1. Using a Bourne shell:
$ ODBCHOME=/opt/ODBC5.1; export ODBCHOME
Using a C shell:
$ setenv ODBCHOME /opt/ODBC5.1
PATH. To run the ODBC command line programs, like ivtestlib, set the variable to include the odbc bin directory. Using a Bourne shell:
$ PATH=${PATH}:$ODBCHOME/bin; export PATH
Using a C shell:
$ setenv PATH ${PATH}:$ODBCHOME/bin
Run the ivtestlib utility to verify that the UNIX ODBC manager can load the driver files.
3.
Set the shared library environment variable. The ODBC software contains a number of shared library components that the Integration Service and Repository Service processes load dynamically. To locate the shared libraries during run time, set the shared library environment variable.
522
The shared library path must also include the PowerCenter Services installation directory (server_dir). Set the shared library environment variable based on the operating system. The following table describes the shared library variables for each operating system:
Operating System Solaris Linux AIX HP-UX Variable LD_LIBRARY_PATH LD_LIBRARY_PATH LIBPATH SHLIB_PATH
For example, use the following syntax for Solaris and Linux:
Using a C shell:
$ setenv LD_LIBRARY_PATH $HOME/server_dir:$ODBCHOME:${LD_LIBRARY_PATH}
For HP-UX
Using a C shell:
$ setenv SHLIB_PATH ${SHLIB_PATH}:$HOME/server_dir:$ODBCHOME/lib
For AIX
4.
Using a C shell:
$ setenv LIBPATH ${LIBPATH}:$HOME/server_dir:$ODBCHOME/lib
Edit the existing odbc.ini file or copy the odbc.ini file to the home directory and edit it. This file exists in $ODBCHOME directory.
$ cp $ODBCHOME/odbc.ini $HOME/.odbc.ini
Add an entry for the ODBC data source under the section [ODBC Data Sources] and configure the data source. For example:
MY_MSSQLSERVER_ODBC_SOURCE=<Driver name or Data source description> [MY_SQLSERVER_ODBC_SOURCE] Driver=<path to ODBC drivers> Description=DataDirect 5.1 SQL Server Wire Protocol
523
This file might already exist if you have configured one or more ODBC data sources. For a sample odbc.ini file, see Sample odbc.ini File on page 525.
5.
Verify that the last entry in the odbc.ini is InstallDir and set it to the odbc installation directory. For example:
InstallDir=/usr/odbc
6.
If you use the odbc.ini file in the home directory, set the ODBCINI environment variable. Using a Bourne shell:
$ ODBCINI=/$HOME/.odbc.ini; export ODBCINI
Using a C shell:
$ setenv ODBCINI $HOME/.odbc.ini 7.
Edit the .cshrc or .profile to include the complete set of shell commands. Save the file and either log out and log in again, or issue the source command. Using a Bourne shell:
$ source .profile
Using a C shell:
$ source .cshrc 8.
Use the ivtestlib utility to verify that the UNIX ODBC manager can load the driver file you specified for the data source in the odbc.ini file. For example, if you have the driver entry:
Driver = /opt/odbc/lib/DWxxxx.so
Install and configure any underlying client access software needed by the ODBC driver.
Note: While some ODBC drivers are self-contained and have all information inside the
.odbc.ini file, most are not. For example, if you want to use an ODBC driver to access Oracle, you must install the Oracle SQL*NET software and set the appropriate environment variables. Verify such additional software configuration separately before using ODBC.
524
[dBase] Driver=/u02/app/ODBC5.1/lib/ivdbf21.so Description=DataDirect 5.1 dBaseFile(*.dbf) ApplicationUsingThreads=1 CacheSize=4 CreateType=dBASE5 Database=/u02/app/ODBC5.1/demo DataFileExtension=DBF ExtensionCase=UPPER FileOpenCache=0 IntlSort=0 LockCompatibility=dBASE Locking=RECORD UseLongNames=0 UseLongQualifiers=0
[FoxPro3] Driver=/u02/app/ODBC5.1/lib/ivdbf21.so Description=DataDirect 5.1 dBaseFile(*.dbf) ApplicationUsingThreads=1 CacheSize=4 CreateType=FoxPro30 Database=/u02/app/ODBC5.1/demo DataFileExtension=DBF ExtensionCase=UPPER FileOpenCache=0 IntlSort=0 LockCompatibility=Fox Locking=RECORD UseLongNames=0 UseLongQualifiers=0
525
Driver=/u02/app/ODBC5.1/lib/ivifcl21.so Description=DataDirect 5.1 Informix Wire Protocol AlternateServers= ApplicationUsingThreads=1 CancelDetectInterval=0 ConnectionRetryCount=0 ConnectionRetryDelay=3 Database=<database_name> HostName=<Informix_host> LoadBalancing=0 LogonID= Password= PortNumber=<Informix_server_port> ServerName=<Informix_server> TrimBlankFromIndexName=1
[SQLServer Wire Protocol] Driver=/u02/app/ODBC5.1/lib/ivmsss21.so Description=DataDirect 5.1 SQL Server Wire Protocol Address=<SQLServer_host, SQLServer_server_port> AlternateServers= AnsiNPW=Yes ConnectionRetryCount=0 ConnectionRetryDelay=3 Database=<database_name> LoadBalancing=0 LogonID= Password= QuotedId=No
526
Part V: Appendices
Starting and Stopping Informatica Services, 529 Starting and Stopping Application Servers, 535 Logging in to the Administration Console, 547 ODBC Calls, 549 JDBC Drivers, 553 LANG Environment Variable for Linux, 557
527
528
Appendix A
Overview, 530 Starting and Stopping Informatica Services on UNIX, 531 Starting and Stopping Informatica Services on Windows, 532
529
Overview
The method you use to start and stop Informatica Services depends on the operating system:
UNIX. Start and stop Informatica Services from the command line. Windows. Start and stop Informatica Services from the Windows Start Menu or from Windows Services.
You can also use the Administration Console to shut down a node. When you shut down a node, you stop Informatica Services on the node. Use the following rules and guidelines when starting and stopping Informatica Services on a node:
When you shut down a node, the node is unavailable to the domain. If you shut down a gateway node and do not have another gateway node in the domain, the domain is unavailable. When you start Informatica Services, verify that the port used by Informatica Services on the node is available. For example, if you stop Informatica Services on a node and then restart Informatica Services, verify that another process on the machine is not using the port. If the port is not available, Informatica Services will fail to start on the node. If you do not use the Administration Console to shut down a node, any process running on the node will be aborted. If you want to wait for all processes to complete before shutting down a node, use the Administration Console. If you have two nodes in a domain with one node configured as a primary node for an application service and the other node configured as a backup node, you must start Informatica Services on the primary node before you start the backup node. Otherwise, the application service will run on the backup node and not the primary node.
530
At the command prompt, switch to the directory where the infaservice executable is located. At the command prompt, type the following command to start or stop the Service Manager:
infaservice [startup | shutdown]
Note: If you use a softlink to specify the location of infaservice, you must set the INFA_HOME environment variable to the location of the PowerCenter Services installation directory. For more information, see Configuring INFA_HOME on page 357.
531
You can start and stop Informatica Services by starting and stopping the service using Windows Services or by using the Windows shortcut.
To use Windows Services to start or stop the Informatica Services service: 1. 2.
From the Start Menu, click Administrative Tools > Services. Double-click Informatica Services. The Informatica Services 8.1.1 Properties dialog box appears.
3.
If the service is running, click Stop. -orIf the service is stopped, click Start.
For more information about configuring the Informatica Services service on Windows, see Configuring Informatica Services on page 325.
To start or stop Informatica Service using the Start menu:
Choose Start menu > Informatica PowerCenter 8.1.1 > Server > Stop | Start Informatica Services.
532
Log in to the Administration Console. For more information, see Logging in to the Administration Console on page 547. Select the node in the Navigator. Click Shutdown in the Main window.
533
534
Appendix B
Overview, 536 Starting and Stopping Applications on JBoss Application Server, 537 Starting and Stopping Applications on BEA WebLogic Server, 540 Starting and Stopping Applications on IBM WebSphere Application Server, 542
535
Overview
Data Analyzer and Metadata Manager use JBoss Application Server, BEA WebLogic Server, and IBM WebSphere Application Server to manage processes and manage application, network, and system resources. On UNIX, you start and stop the application servers from the command line. On Windows, the PowerCenter installer installs the server as a service and provides shortcuts for starting the server from the Windows Start menu. The PowerCenter installer starts all servers as part of the installation. Typically, you do not need to start the servers manually. To start Data Analyzer or Metadata Manager, you need to start the application server where you installed them. After you start the application server, use a web browser to access Data Analyzer or Metadata Manager. You can start and stop servers depending on the type of application server:
JBoss Application Server. You can start and stop JBoss Application Server from the command line or the Windows Start menu. For more information, see Starting and Stopping Applications on JBoss Application Server on page 537. BEA WebLogic Server. You can start and stop BEA WebLogic Server from the command line. For more information, see Starting and Stopping Applications on BEA WebLogic Server on page 540. IBM WebSphere Application Server. You can start and stop the deployment manager, node agent, JMS server, and default server from the command line. For more information, see Starting and Stopping Applications on IBM WebSphere Application Server on page 542.
536
Navigate to the drive and directory where you installed JBoss Application Server and go to the /bin directory. The default /bin directory is /Informatica/PowerCenter8.1.1/JBoss403/bin.
2.
Run JBoss Application Server with the server configuration parameter. The default JBoss server configuration for Data Analyzer and Metadata Manager is informatica. On Windows, run JBoss Application Server with the following command:
run -c informatica
When the application server starts its processes, the command prompt stops scrolling. Wait until JBoss Application Server starts before you access the applications.
537
The default JBoss server configuration for Data Analyzer or Metadata Manager is informatica. The service name for JBoss Application Server is Informatica_811_JBoss_Informatica. The PowerCenter installer also creates a shortcut on the Windows Start menu to start the service. You can start JBoss Application Server from Windows Services or from the Windows Start menu.
To start JBoss Application Server from the Windows Start menu: 1. 2.
On the Windows Start menu, select Programs > Informatica PowerCenter 8.1.1 > Server. Select Start JBoss Service.
The JBoss Application Server service takes a moment to start. Wait until JBoss Application Server starts before you access the applications.
Navigate to the drive and directory where you installed JBoss Application Server and go to the /bin directory. The default /bin directory is /Informatica/JBoss403/bin.
2.
Stop JBoss Application Server with the shutdown parameter. On Windows, stop JBoss Application Server with the following command:
shutdown --s jnp://<HostName>:<JNP invoker port> --S
The --s parameter requires the host name of the machine that hosts JBoss Application Server. It is preceded by two dashes (--). The --S parameter is also preceded by two dashes (--). The JBoss Application Server service takes a moment to stop. JBoss Application Server is stopped when the command prompt stops scrolling and the command line displays again.
538 Appendix B: Starting and Stopping Application Servers
On the Windows Start menu, select Programs > Informatica PowerCenter 8.1.1 > Server. Select Stop JBoss Service.
539
Navigate to the drive and directory where BEA WebLogic Server is installed and go to the domain directory for Data Analyzer and Metadata Manager. In PowerCenter, the default WebLogic domain for Data Analyzer and Metadata Manager is informatica. The default domain directory is
/bea/user_projects/domains/informatica
2.
Start BEA WebLogic Server with the startWebLogic command. On Windows, start BEA WebLogic Server with the following command:
startWebLogic.cmd
When the application server successfully starts all its processes, a message similar to the following displays:
Started WebLogic Admin Server myserver for domain Informatica running in Production Mode Server started in RUNNING mode
The initialization process may take a while. After the initialization process completes, the command prompt stops scrolling.
540
In PowerCenter, the default WebLogic domain name for Data Analyzer and Metadata Manager is informatica. The default application server name is myserver. The service name for BEA WebLogic Server is beasvc informatica_myserver. The PowerCenter installer also creates a shortcut on the Windows Start menu to start the service. You can start BEA WebLogic Server from the Windows Services or from the Windows Start menu.
To start BEA WebLogic Ser ver from the Windows Start menu: 1. 2.
On the Windows Start menu, select Programs > Informatica PowerCenter 8.1.1 > Server. Select Start WebLogic Service.
The BEA WebLogic Server service takes a moment to start. Wait until BEA WebLogic Server starts before you access the applications.
Open a web browser and type the URL for the WebLogic Administration Console. The URL for the BEA WebLogic Server contains the host name and port for BEA WebLogic Server with the /console context path:
http://MachineName.DomainName.com:7001/console
2. 3. 4. 5. 6.
Log in to the WebLogic Administration Console. On the left panel of the WebLogic Administration Console, click Servers under the Informatica domain to display the available servers. Right-click the default server name and choose Graceful shutdown of this server or Force shutdown of this server. Click Yes to confirm that you want to stop BEA WebLogic Server. Close the browser.
541
You must start the servers in the sequence listed. Wait until a server completes its initialization processes before you start the next server.
542
Navigate to the IBM WebSphere Application Server Network Deployment /bin directory. The default /bin directory for IBM WebSphere Application Server Network Deployment is:
/WebSphere/DeploymentManager/bin.
2.
Start the WebSphere deployment manager with the startManager command. On Windows, start the deployment manager with the following command:
startManager -username WASAdmin -password WASAdminPassword
WASAdmin is the user name for the WebSphere Administrative Console administrator. WASAdminPassword is the password for the WebSphere Administrative Console administrator. When the deployment manager successfully starts all its processes, the following message appears:
Server launched. Waiting for initialization status. Server dmgr open for e-business;
The initialization process may take a while. You must wait for the message before you start the other servers. After the initialization process completes, the command prompt stops scrolling.
Navigate to the IBM WebSphere Application Server /bin directory. The default /bin directory for IBM WebSphere Application Server is
/WebSphere/AppServer/bin.
2.
Start the WebSphere node agent with the startNode command. On Windows, start the node agent with the following command:
startNode.bat -username WASAdmin -password WASAdminPassword
543
WASAdmin is the user name for the WebSphere Administrative Console administrator. WASAdminPassword is the password for the WebSphere Administrative Console administrator. When the node agent successfully starts all its processes, the following message displays:
Server launched. Waiting for initialization status. Server nodeagent open for e-business;
The initialization process may take a while. Make sure that the node agent starts before you start the other servers. After the initialization process completes, the command prompt stops scrolling.
Navigate to the IBM WebSphere Application Server /bin directory. The default /bin directory for IBM WebSphere Application Server is
/WebSphere/AppServer/bin
2.
Start the WebSphere JMS Server with the startServer command. On Windows, start the JMS Server with the following command:
startServer.bat jmsserver -username WASAdmin -password WASAdminPassword
WASAdmin is the user name for the WebSphere Administrative Console administrator. WASAdminPassword is the password for the WebSphere Administrative Console administrator. The JMS server is started when the status column displays a green arrow. The initialization process may take a while. Wait until the JMS server completes its initialization processes before you start the default server. Do not close the WebSphere Administrative Console. Start the default WebSphere server on the same console.
544
The node agent and the JMS server must be running before you start the default server.
To start the WebSphere default server: 1.
Navigate to the IBM WebSphere Application Server /bin directory. The default /bin directory for IBM WebSphere Application Server is:
/WebSphere/AppServer/bin
2.
Start the WebSphere default server with the startServer command. On Windows, start the default server with the following command:
startServer.bat servername -username WASAdmin -password WASAdminPassword
WASAdmin is the user name for the WebSphere Administrative Console administrator. WASAdminPassword is the password for the WebSphere Administrative Console administrator. The default server is started when the status column displays a green arrow. The initialization process may take a while. Wait until the default server starts before you access the applications.
Step 1. Stop the Default Server, JMS Server, and Node Agent
On Windows, open a command window and run the batch files to stop the servers. On UNIX, run the script files as shell commands. If Data Analyzer and Metadata Manager run on a server other than the default server, stop the specified server instead of the default server.
To stop the WebSphere servers: 1.
Navigate to the IBM WebSphere Application Server /bin directory. The default /bin directory for IBM WebSphere Application Server is:
/WebSphere/AppServer/bin
2.
Stop servers in the following sequence: default server, JMS server, and node agent. Wait until a server stops and the message Server <ServerType> stop completed before stopping the next server.
545
WASAdmin is the user name for the WebSphere Administrative Console administrator. WASAdminPassword is the password for the WebSphere Administrative Console administrator.
Navigate to the IBM WebSphere Application Server Network Deployment /bin directory. The default /bin directory for IBM WebSphere Application Server Network Deployment is:
/WebSphere/DeploymentManager/bin
2.
Stop the WebSphere deployment manager with the stopManager command. On Windows, stop the deployment manager with the following command:
stopManager -username WASAdmin -password WASAdminPassword
WASAdmin is the user name for the WebSphere Administrative Console administrator. WASAdminPassword is the password for the WebSphere Administrative Console administrator. The message Server dmgr stop completed displays on the command line. The shutdown process might take a while. After the shutdown process completes, the command prompt stops scrolling.
546
Appendix C
547
Open Microsoft Internet Explorer or Mozilla Firefox. For information about browser configuration, see Web Browsers on page 37.
2.
In the Address field, enter the following URL for the Administration Console login page:
http://<host>:<port>/adminconsole
In the URL, <host> is the name of the machine that hosts the domain, and <port> is the gateway port number. If you are not using the Internet Explorer Enhanced Security Configuration, you can enter the following URL, and the browser is directed to the full URL for the login page:
http://<host>:<port>
3.
Enter the domain user name and password. When you log in to the Administration Console for the first time, you use the domain administrator user name and password you created when you created the domain.
4. 5.
Click Login. Create an additional domain user to use when you perform administration tasks in the Administration Console. For more information about creating users and setting permissions, see Managing Users and User Accounts in the PowerCenter Administrator Guide.
548
Appendix D
ODBC Calls
549
SQLNumResultsCols SQLPrepare
550
SQLProcedureColumns
SQLTransact
551
Integration Service uses ODBC calls to communicate with databases. Table D-2 describes the core function calls the Integration Service makes to connect to ODBC drivers:
Table D-2. Integration Service ODBC Function Calls
Function SQLAllocConnect SQLAllocStmt SQLBindCol SQLBindParameter SQLConnect SQLDisconnect SQLError SQLExecDirect SQLExecute SQLFetch SQLFreeConnect SQLFreeStmt SQLParamOptions SQLPrepare SQLSetConnectOption SQLSetParam SQLSetStmtAttr SQLTransact SQLSetStmtOption SQLExtendedFetch SQLGetInfo SQLGetFunctions SQLGetStmtOptions SQLRowCount Description Allocates resources for a connection. Allocates resources for a statement. Binds a result column. Binds a parameter. Connects. Disconnects. Errors. Executes a statement. Executes a statement. Fetches row by row. Frees the resources allocated by connect. Frees resources allocated by a statement. Sets number of parameter rows to run. Parses an SQL statement. Sets connection options. Sets a parameter. Sets statement handle attributes. Turns on/off the auto commit feature. Sets the options for a statement to control how to read and how many rows to read. Fetches arrays. Gets information about the ODBC driver. Gets supported ODBC driver functions. Gets attributes from the statement in the connection. Returns the number of rows affected by the SQLExecute command.
552
Appendix E
JDBC Drivers
553
JDBC Driver Name: Database URL: Default Database Port: Microsoft SQL Server Vendor: JDBC Driver and Type: JDBC Driver Name: Database URL: Default Database Port: IBM DB2 Vendor: JDBC Driver Type: JDBC Driver Name: Database URL: Default Database Port: Sybase ASE Vendor: JDBC Driver and Type: JDBC Driver Name:
1521
1433
50000
554
Table E-1. JDBC Drivers Installed for Supported Databases Database URL: Default Database Port:
jdbc:informatica:sybase:// host_name:port;DatabaseName=database_name
2048
Table E-2 describes the information you need to supply in the database URL for the supported JDBC drivers:
Table E-2. JDBC Connection String Elements Element host_name port sid database_name Description IP address or host name of the machine hosting the database server. Port number of the database server. Oracle database only. Unique system identifier that represents an instance of an Oracle database in a server. Name of the database to connect to.
For more information about the types of JDBC drivers, visit the Java web site:
http://java.sun.com/products/jdbc/driverdesc.html
Informatica recommends that you use the JDBC driver from Informatica to connect to Oracle data sources in Data Analyzer. If you use the JDBC driver from Oracle (also known as the Oracle thin driver) to connect to data sources, you might not be able to use stored procedures in the SQL queries of your Data Analyzer reports. For more information about using stored procedures in the SQL query for a report, see Running a Report in the Data Analyzer User Guide.
555
556
Appendix F
Overview, 558
557
Overview
When you set up the locale on a Linux machine, you can specify one of many values for the locale in the LANG environment variable. PowerCenter accepts a subset of all possible values that Linux accepts. If you install PowerCenter on a Linux machine, use one of the valid values for the LANG environment variable. Table F-1 provides a list of values that PowerCenter accepts for the LANG environment variable:
Table F-1. Valid Values for the LANG Environment Variable for Linux Machines
Language CanadianFrench Catalan Croatian Croatian Czech Czech Danish Danish Danish Danish Dutch Dutch Dutch Dutch Dutch Dutch English English English English English English English English Territory/Region French-Canada Catalonia Croatia Croatia Czech Republic Czech Republic Denmark Denmark Denmark Denmark Dutch-Belgium Dutch-Belgium Netherlands Netherlands Netherlands Netherlands Australia Canada Denmark Ireland United Kingdom United Kingdom United Kingdom United States Locale fr_CA ca_ES croatian hr_HR czech cs_CZ da_DK da.ISO8859-15 danish dansk nl_BE.ISO8859-15 nl_BE dutch nl nl_NL nl.ISO8859-15 en_AU en_CA en_DK en_IE en_GB en_GB.ISO8859-15 en_UK C
558
Table F-1. Valid Values for the LANG Environment Variable for Linux Machines
Language English English English English Estonian Estonian Faroese Finnish Finnish Finnish Finnish Finnish French French French French French French French French French German German German German German German German German Greek Greek Territory/Region United States United States United States United States Estonia Estonia Faroes Finland Finland Finland Finland Finland France France France France France French-Belgium French-Belgium French-Switzerland Luxembourg Austria Austria German-Switzerland Germany Germany Germany Germany Luxembourg Greece Greece Locale en_US en_US.utf8 POSIX en_US.iso88591 et et_EE fo_FO fi fi.ISO8859-15 fi_FI finnish su fr franais fr.ISO8859-15 fr_FR french fr_BE fr_BE.ISO8859-15 fr_CH fr_LU de_AT de_AT.ISO8859-15 de_CH de de_DE deutsch german de_LU el_GR el_GR.iso88597
Overview
559
Table F-1. Valid Values for the LANG Environment Variable for Linux Machines
Language Greek Hebrew Hebrew Hungarian Hungarian Hungarian Icelandic Icelandic Icelandic Indonesian Indonesian Irish Italian Italian Italian Italian Italian Italian Japanese Japanese Japanese Japanese Japanese Korean Korean Latvian Lithuanian Macedonian Norwegian Norwegian Norwegian Territory/Region Greece Israel Israel Hungary Hungary Hungary Iceland Iceland Iceland Indonesia Indonesia Ireland Italian-Switzerland Italy Italy Italy Italy Italy Japan Japan Japan Japan Japan Korea Korea Latvia Lithuania Macedonia Norway Norway Norway Locale greek hebrew iw_IL hu hu_HU hungarian icelandic is is_IS id in ga_IE it_CH it it.ISO859-15 it.UTF-8 italian it_IT japanese japanese.euc ja_JP.eucjp ja_JP.PCK ja_JP.UTF-8 ko ko_KR.euckr lv_LV lt_LT mk_MK no no_NO norwegian
560
Table F-1. Valid Values for the LANG Environment Variable for Linux Machines
Language Norwegian Polish Polish Polish Portuguese Portuguese Portuguese Portuguese Portuguese Romanian Romanian Romanian Russian Russian Russian Russian Serbian Serbian Simplified Chinese Simplified Chinese Slovak Slovak Slovak Slovenian Slovenian Slovenian Spanish Spanish Spanish Spanish Spanish Territory/Region Norway Poland Poland Poland Brazil Portugal Portugal Portugal Portugal Romania Romania Romania Russia Russia Russia Ukraine Yugoslavia Yugoslavia China China Slovakia Slovakia Slovakia Slovenia Slovenia Slovenia Dominican Republic El Salvador Guatemala Honduras Mexico Locale no@nynorsk pl pl_PL polish pt_BR pt pt.ISO8859-15 portuguese pt_PT ro ro_RO romanian ru ru_RU ru_RU.KOI8-R ru_UA sr sr_YU zh.GBK zh sk sk_SK slovak slovene slovenian sl_SI es_DO es_SV es_GT es_HN es_MX
Overview
561
Table F-1. Valid Values for the LANG Environment Variable for Linux Machines
Language Spanish Spanish Spanish Spanish Spanish Spanish Spanish Spanish Swedish Swedish Swedish Swedish Swedish Swedish TraditionalChinese Turkish Turkish Turkish Ukrainian Ukrainian Territory/Region Panama Peru Spain Spain Spain Spain Spain Spain Finland Sweden Sweden Sweden Sweden Sweden Taiwan Turkey Turkey Turkey Ukraine Ukraine Locale es_PA es_PE es spanish es.ISO8859-15 es.UTF-8 es_ES eu_ES sv_FI se sv sv.ISO8859-15 sv_SE swedish zh_TW.Big5 tr tr_TR turkish ua uk_UA
562
Index
A
AddLicense (infacmd) troubleshooting 368 Administration Console log events 365 logging in 548 Upgrade Wizard 402 upgrading a repository 424 Administrative reports importing 282 installing 282 AIX configuring JRE path 62 configuring X Virtual Frame Buffer (Xvfb) 73 Java components 62 LIBPATH 62 application server See also JBoss Application Server See also WebLogic Server See also WebSphere Application Server installation prerequisites 40 installing 70 troubleshooting 373 uninstalled files 387 authentication configuring for application server 70
B
BEA WebLogic Server See WebLogic Server
C
cached reports list for PowerCenter Repository Reports 345 catalina.out troubleshooting installation 364 cfgfiles upgrade directory 92 COBOL connectivity 484 code pages PowerCenter 45 setting for repository configuration 122, 146, 220, 231 color schemes See also Data Analyzer Administrator Guide upgrading 464 configuring Sybase ASE repository 54 Connect (pmrep) troubleshooting 369 connect string examples 478 setting for repository configuration 122, 146, 220, 231 syntax 478
563
connecting Integration Service to IBM DB2 (UNIX) 505 Integration Service to IBM DB2 (Windows) 489 Integration Service to Informix (UNIX) 508 Integration Service to Informix (Windows) 491 Integration Service to Microsoft Access 493 Integration Service to Microsoft SQL Server 494 Integration Service to ODBC data sources (UNIX) 522 Integration Service to Oracle (UNIX) 511 Integration Service to Oracle (Windows) 496 Integration Service to Sybase ASE (UNIX) 515 Integration Service to Sybase ASE (Windows) 499 Integration Service to Teradata (Windows) 501 Microsoft Excel to Integration Service 493 PowerCenter Client to Informix 501 to UNIX databases 504 to Windows databases 488 connecting to databases JDBC 486 connection strings JDBC connections 554 native connectivity 478 connectivity COBOL 484 configuring for upgrade 79 connect string examples 478 Data Analyzer 486 diagram of 474 Integration Service 484 Metadata Manager 486 overview 474 PowerCenter Client 481 Repository Service 483 console mode installing PowerCenter Advanced Edition 224 installing PowerCenter Reports 288 installing PowerCenter Standard Edition 213 rules and guidelines 212, 238 uninstallation 396 using 212, 238 Create (pmrep) troubleshooting 370 create domain guidelines 17 Create New Domain console mode 217, 228 graphical mode 115, 139, 161 CreateConnection (pmrep) troubleshooting 372
CreateIntegrationService (infacmd) troubleshooting 371 CreateRepositoryService (infacmd) troubleshooting 369 Custom Function SDK Informatica Developer Platform 316 installation directory 321 installing 317
D
Data Analyzer adding data sources 354 components 9 configuring a data source 351 configuring authentication 70 configuring Sybase ASE repository 54 connectivity 486 creating data connectors 352 custom installation in console mode 248 custom installation in graphical mode 175 database drivers 475 EAR Repackager utility 302 Import Export utility 303 installing JDBC XA on Microsoft SQL Server 338 installing on JBoss Application Server 4 installing on WebLogic Server 4 installing on WebSphere Application Server 4 JDBC-ODBC bridge 486 License Update utility 303 minimum system requirements 35 ODBC (Open Database Connectivity) 474 PowerCenter Integration utility 304, 334 repository 372 Repository Backup utility 309 Repository Upgrade utility 309 troubleshooting 372 uninstalling 386 Update System Accounts utility 309 updating license 337 upgrading 29 utilities 300, 302 Data Analyzer Data Profiling reports installing 351 upgrading 429 Data Analyzer repository database size 38 optimizing for Oracle 52 optimizing for Sybase 53 data connectors adding data source for PowerCenter Repository
564
Index
Reports 341 adding the Data Profiling data source 354 creating for Data Profiling 352 primary data source 353 properties 353 Data Profiling warehouse back up 428 configuring a data source 351 creating 331 database size 38 restore 428 upgrading 427 upgrading Data Analyzer views 429 user account privileges 56 data sources adding to data connector 354 adding to data connector for PowerCenter Repository Reports 341 configuring for the Data Profiling warehouse 351 for PowerCenter Repository Reports 339 primary in data connector 353 using new repository for PowerCenter Repository Reports 349 Data Stencil description 43 installation prerequisites 43 uninstalling 386 database client configuring 60 environment variables 60 database drivers Integration Service 474 Repository Service 474 database type Data Analyzer repository 126, 150, 223 Metadata Manager repository 151, 235 PowerCenter repository 122, 231 PowerCenter repository for Metadata Manager 146 setting for repository configuration 234 database user ID setting for repository configuration 122, 146, 220, 231 database user password setting for repository configuration 122, 146, 220, 231 databases connecting to (UNIX) 504 connecting to (Windows) 488 connecting to IBM DB2 489, 505 connecting to Informix 491, 508 connecting to Microsoft Access 493 connecting to Microsoft SQL Server 494 connecting to Oracle 496, 511
connecting to Sybase ASE 499, 515 connecting to Teradata (UNIX) 518 connecting to Teradata (Windows) 501 creating accounts 56 Data Analyzer 52 Data Profiling warehouse 52 domain configuration 52 heap size for IBM DB2 55 JDBC connection strings 554 Metadata Manager repository 52 page size for Sybase 53 password 56 PowerCenter repository 52 privileges for Data Analyzer repositories 56 privileges for Data Profiling warehouse 56 privileges for Metadata Manager repositories 56 privileges for PowerCenter repositories 56 setting name on IBM DB2 220, 232 setting URL for repository configuration 223, 234, 235 size for Data Profiling warehouse 38 storage parameters for Oracle 52 tablespace name for IBM DB2 53 temporary tablespace for IBM DB2 55 testing connections 65 DataDirect ODBC drivers platform-specific drivers required 480 datatypes overview 558 transformation 558 DB2 See IBM DB2 dbs2 connect testing database connection 65 debug log description 362 DeleteConnection (pmrep) troubleshooting 372 disk space minimum requirements 35, 37, 38, 40, 43, 45, 46 DISPLAY variable redirecting graphics on UNIX 63 documentation installed 6 installing 293 installing from the hard disk 292 viewing 295 Domain Activity Reporting setting up on UNIX 73 domain configuration database configuring with installer 116, 140, 217, 228 database size 38
Index
565
definition 52 setting up 52 troubleshooting 366 uninstalling 386 domainmeta.xml backing up before upgrade 83 upgrading 420, 421 domains See PowerCenter domains See WebLogic domain domains.infa backing up before upgrade 83, 85 description 64 location 64
G
global repository upgrading 409 global_repo upgrade directory 92 graphical mode configuring 63 installing PowerCenter Advanced Edition 128 installing PowerCenter Reports 284 installing PowerCenter Standard Edition 103 uninstallation 390, 392
H
HP-UX configuring JRE path 62 configuring X Virtual Frame Buffer (Xvfb) 73 Java components 62 SHLIB_PATH 62
E
EAR Repackager utility See also Data Analyzer Administrator Guide configuring 302, 311 upgrading color schemes 464 environment variables configuring for PowerCenter 59 database client 60 DISPLAY 63 INFA_DOMAINS_FILE 64 INFA_HOME 357 INFA_JAVA_OPTS 64 Java components 62 LANG 61 LANG_C 61 LC_ALL 61 LC_CTYPE 61 library path 60 local 61 NLS_LANG 61 UNIX 59 UNIX database client 60 UNIX requirements 104, 129, 176 event-based schedules upgrading 465
I
IBM DB2 connect string syntax 478 connecting to Integration Service (UNIX) 505 connecting to Integration Service (Windows) 489 creating a Data Profiling warehouse 331, 427 creating Data Profiling warehouse views for Data Analyzer 332 importing Metadata Manager metamodels 469 optimizing repositories 53, 55 setting DB2CODEPAGE 489 setting DB2INSTANCE 489 setting tablespace name 122, 146, 220, 232 IBM WebSphere Application Server default server 544 Import Export utility configuring 303 INFA_DOMAINS_FILE environment variable 64 removing before upgrade 83 INFA_HOME configuring for PowerCenter utilities 301 environment variable 357 removing before upgrade 83 INFA_JAVA_OPTS environment variables 64 infacmd Integration Services, creating 371
F
Firefox See Mozilla Firefox 68 flat files connectivity 484
566
Index
nodes, adding to domains 367 pinging objects 368 Repository Services, creating 369 troubleshooting 362 infasetup domains, defining 367 troubleshooting 362 worker nodes, defining 367 infaupgrade commands 420 description 420 upgradeDomain command 421 upgradeGatewayNode command 421 upgradeWorkerNode command 422 Informatica Developer Platform description 316 list of SDKs and APIs 316 Informatica Development Platform installation directories 321 Informatica Services configuring 325 configuring memory 64 description 7 starting and stopping on UNIX 531 starting and stopping on Windows 532 troubleshooting 367 Informix connect string syntax 478 connecting to Integration Service (UNIX) 508 connecting to Integration Service (Windows) 491 connecting to PowerCenter Client 501 creating a Data Profiling warehouse 331 upgrading repository 87 installation log description 364 installing console mode 212 creating a domain 115, 139, 161, 217, 228 creating a user 58 Data Analyzer Data Profiling reports 351 graphical mode 102, 154 installation and configuration steps 16 joining a domain 115, 139, 161, 217, 228 minimum system requirements 35, 37, 38, 40, 43, 45, 46 PowerCenter Advanced Edition 102, 154, 212 PowerCenter Client 266 PowerCenter documentation 293 PowerCenter Reports 282 PowerCenter Standard Edition 102, 154, 212
Integration Service code pages 45 connectivity 484 creating in console mode 221, 261 creating in graphical mode 123, 147 database client 57 database drivers 475 datatype usage 558 description 7 log events 365 ODBC (Open Database Connectivity) 474 troubleshooting 371 Integration Service run-time files moving 460 Internet Explorer See Microsoft Internet Explorer 68 isql testing database connection 65
J
Java components AIX 62 HP-UX 62 Java transformation configuring JRE path 62 Javascript configuring in Firefox 68 JBoss Application Server authentication 70 installation prerequisites 40 installing 70 installing Metadata Manager on 4 server configuration 70 service name 374 starting 537 startup command 374 stopping 538 troubleshooting 373, 374 uninstalling 387 JDBC drivers connection strings 554 Data Analyzer 474 Data Analyzer connection to repository 486 driver types 555 installed 9, 11 installed drivers 486 Metadata Manager 474 Metadata Manager connection to databases 486 PowerCenter domain 474 shipped with PowerCenter 554
Index 567
JDBC-ODBC bridge Data Analyzer 486 join domain guidelines 17 Join Existing Domain console mode 217, 228 graphical mode 115, 139, 161 guidelines 17
L
LANG environment variable 61 languages installing on Windows 69 NLS_LANG 61 LC_ALL environment variable 61 LC_CTYPE environment variable 61 LD_LIBRARY_PATH library paths 60 LIBPATH AIX 62 library paths 60 library paths LD_LIBRARY_PATH 60 LIBPATH 60 SHLIB_PATH 60 libstdc++.so library 62 license key description 6 obtaining 6 PowerCenter Advanced Edition 6 PowerCenter Standard Edition 6 verifying 67 License Update utility configuring 303, 312 updating licenses 337 licenses adding 368 updating 337 Linux configuring locale 61 configuring X Virtual Frame Buffer (Xvfb) 73 database client environment variables 60 libraries 62 library paths 60 Load Manager API (C) Informatica Developer Platform 316
568 Index
installation directory 321 installing 317 Load Manager API (Java) Informatica Developer Platform 316 installation directory 321 installing 317 local repository upgrading 413 local_repo upgrade directory 92 locale configuring 61 localhost_log.<date>.txt troubleshooting installation 364 log files catalina.out 364 debug log 362 domain log events 365 installation 362 installation log 364 Integration Service log events 365 localhost_log.<date>.txt 364 node.log 364 Repository Service log events 365 summary log 363 types 362 WebSphere Application Server 375 Log Manager upgrading 460, 461
M
Mapping API (Java) Informatica Developer Platform 316 installation directory 321 installing 317 memory specifying for Informatica Services 64 memory requirements system memory 64 Metadata Exchange SDK Informatica Developer Platform 316 installation directory 321 installing 317 Metadata Manager client upgrade steps 453 components 10 configuring authentication 70 connectivity 486 custom installation in console mode 255 custom installation in graphical mode 191
database drivers 475 deleting obsolete objects 468 EAR Repackager utility 311 importing metamodels 469 installing on JBoss Application Server 4 installing on WebLogic Server 4 installing on WebSphere Application Server 4 License Update utility 312 minimum system requirements 35 ODBC (Open Database Connectivity) 474 post-upgrade tasks 467 refreshing views 467 repository 372 Repository Backup utility 313 troubleshooting 372 uninstalling 386 Update System Accounts utility 313 updating license 337 upgrade utility 442 upgrading 31 upgrading the client 453 upgrading the repository 442 utilities 300, 311 Metadata Manager Client components 12 database drivers 476 troubleshooting 376 uninstalling 386 Metadata Manager repository database size 38 optimizing for IBM DB2 55 optimizing for Sybase 53 Microsoft Access connecting to Integration Service 493 Microsoft Excel connecting to Integration Service 493 using PmNullPasswd 493 using PmNullUser 493 Microsoft Internet Explorer configuring 68 Microsoft SQL Server configuring Data Analyzer repository database 54 connect string syntax 478 connecting from UNIX 504 connecting to Integration Service 494 creating a Data Profiling warehouse 331 creating Data Profiling warehouse views for Data Analyzer 332 installing JDBC XA stored procedures 338 Microsoft Visio installation prerequisite 43
N
native connect string See connect string NLS_LANG environment variable 61 node.log troubleshooting installation 364 nodemeta.xml backing up before upgrade 83, 85 upgrading 420, 422 nodes TCP/IP network protocol 474 troubleshooting 367 normal mode Data Profiling warehouse size 38 notifyias configuring for Data Analyzer 334
O
ODBC (Open Database Connectivity) DataDirect driver issues 480 drivers 266, 426 establishing connectivity 479 Integration Service 474 Metadata Manager 474 overview 479 PowerCenter Client 474 requirement for PowerCenter Client 481 ODBC calls Integration Service 552 PowerCenter Client 550 ODBC data sources connecting to (UNIX) 522 connecting to (Windows) 488 odbc.ini file sample 525 optimizing IBM DB2 repositories 53, 55 Oracle repositories 52 repositories 86 Sybase repositories 53 Oracle connect string syntax 478
Index
569
connecting to Data Analyzer repository 555 connecting to Integration Service (UNIX) 511 connecting to Integration Service (Windows) 496 creating a Data Profiling warehouse 331 creating Data Profiling warehouse views for Data Analyzer 332 displaying non-ASCII characters 498 JDBC requirements 555 NLS_LANG 61 optimizing repositories 52 Oracle Net Services using to connect Integration Service to Oracle (UNIX) 511 using to connect Integration Service to Oracle (Windows) 496
P
padaemon user account configuring for WebSphere 71 password repository database 56 PCServer upgrade directory 92 Ping (infacmd) troubleshooting 368 PmNullPasswd reserved word 485 PmNullUser reserved word 485 pmpasswd updating password 457 pmrep repositories, connecting to 369 troubleshooting 362 pmserverexportreg creating PowerCenter Server configuration file 90 troubleshooting 90 pmserverexportreg utility syntax 89 pop-up blocker avoiding in Data Analyzer 68 port numbers PowerCenter Services 66 PowerCenter complete installation in console mode 212 complete installation in graphical mode 102, 154 configuring 324 connectivity 474 post-install tasks 324 post-upgrade tasks 456
570 Index
pre-installation tasks 50 repository version number 403 troubleshooting 361 upgrading 78 utilities 300 PowerCenter Advanced Edition complete installation in console mode 224 complete installation in graphical mode 128 DVD contents 5 minimum system requirements 35 uninstalling 386 PowerCenter Client code pages 45 components 12 connectivity 481 database drivers 475 installing complete 267 installing custom 271 installing languages 69 ODBC (Open Database Connectivity) 474 TCP/IP network protocol 474 troubleshooting 376 uninstalling 386 PowerCenter Connect for JMS configuring JRE path 62 PowerCenter Connect for Web Services configuring JRE path 62 PowerCenter Connect for webMethods configuring JRE path 62 PowerCenter Connect SDK Informatica Developer Platform 316 installation directory 321 installing 317 PowerCenter Documentation DVD description 6 PowerCenter domains connectivity 477 creating 17 description guidelines 17 joining 17 log events 365 pinging 368 TCP/IP network protocol 474 troubleshooting 367 upgrading 420, 421 PowerCenter Integration utility configuring 304 PowerCenter Reports description 13 installing 282
installing in console mode 288 installing in graphical mode 284 uninstalling 386 PowerCenter repository database size 38 description 7 optimizing for IBM DB2 53 PowerCenter repository for Metadata Manager database type 146 PowerCenter Repository Reports adding cached reports to schedules 345 importing report objects 282 installing 13, 282 installing in console mode 288 installing in graphical mode 284 running schedules for cached reports 348 setting up data source 339 switching repositories 349 PowerCenter Server backing up configuration files 89 configuration file location 91 creating configuration file 89 troubleshooting upgrade 418 upgrading 416 PowerCenter Server run-time files moving 458 PowerCenter Services components 7 custom installation in console mode 240 custom installation in graphical mode 155 description directory structure 8 multiple machine installation 17 port numbers 66 Service Manager 7 single machine installation 17 uninstalling 386 PowerCenter Standard Edition complete installation in console mode 213 complete installation in graphical mode 103 DVD contents 5 minimum system requirements 35 uninstalling 386 PowerCenter table definitions refreshing after upgrade 465 PowerCenter utilities included utilities 300 rules and guidelines 301 primary data sources data connector 353
R
reports adding PowerCenter Repository Reports to schedules 345 cached reports for PowerCenter Repository Reports 345 running schedules for PowerCenter Repository Reports 348 repositories backing up 93 connectivity requirements 483 copying 87 database size 38 description 7 optimizing 86 password 56 supported databases 38 switching data sources for PowerCenter Repository Reports 349 troubleshooting 370 troubleshooting upgrade 411 upgrading 86, 409, 413 upgrading in Administration Console 424 upgrading Informix 87 upgrading Teradata 87 version number 403 Repository Agent backing up configuration files 89 configuration file location 91 troubleshooting upgrade 411 upgrading 409, 413 repository authentication configuring 70 Repository Backup utility backing up the repository 93 configuring 309, 313 repository configuration Data Analyzer repository database type 126, 150, 223, 234 Metadata Manager repository database type 151, 235 PowerCenter repository database type 122 PowerCenter repository for Metadata Manager 146 PowerCenter repository for Metadata Manager database type 231 setting code page 122, 146, 220, 231 setting connect string 122, 146, 220, 231 setting database URL 223, 234, 235 setting database user ID 122, 146, 220, 231 setting database user password 122, 146, 220, 231 setting IBM DB2 database name 220, 232
Index
571
setting IBM DB2 tablespace name 122, 146, 220, 232 repository name description 122, 146, 220, 231 PowerCenter repository 220 setting for repository configuration 122, 146, 231 Repository Server troubleshooting upgrade 411 upgrading 409, 413 Repository Service connectivity 483 connectivity requirements 483 creating with installer 117, 120, 163, 166, 218, 219, 242, 243 database client 57 database drivers 475 description 7 log events 365 troubleshooting 369 Repository Upgrade utility configuring 309 Restore (pmrep) troubleshooting 370
S
samples odbc.ini file 525 schedules adding the PowerCenter Repository Reports to the schedules 345 cached reports for PowerCenter Repository Reports 345 running for PowerCenter Repository Reports 348 upgrading 465 Service Manager description 7 log files 364 service pack description 6 services starting and stopping 531, 532 Session Log API Informatica Developer Platform 316 installation directory 321 installing 317 SHLIB_PATH HP-UX 62 library path 60 single machine installation guidelines 17
64-bit platforms guidelines 46 supported platforms 46 softlinks using with INFA_HOME 357 Solaris configuring X Virtual Frame Buffer (Xvfb) 73 source databases connecting through ODBC (UNIX) 522 sqlplus testing database connection 65 Start Page Informatica documentation 295 summary log description 363 SwitchConnection (pmrep) troubleshooting 372 switching connections troubleshooting 372 Sybase ASE configuring Data Analyzer repository 54 configuring Metadata Manager repository 54 connect string syntax 478 connecting to Integration Service (UNIX) 515 connecting to Integration Service (Windows) 499 creating a Data Profiling warehouse 332 creating Data Profiling warehouse views for Data Analyzer 332 page size for repositories 53 system requirements minimum installation requirements 35, 37, 38, 40, 43, 45, 46 system user user account 58
T
target databases connecting through ODBC (UNIX) 522 TCP/IP network protocol nodes 474 PowerCenter Client 474 PowerCenter domains 474 requirement for Integration Service 481 Teradata connect string syntax 478 connecting to Integration Service (UNIX) 518 connecting to Integration Service (Windows) 501 creating a Data Profiling warehouse 332 creating Data Profiling warehouse views for Data Analyzer 332
572
Index
upgrading repository 87 time-based schedules upgrading 465 transformation datatypes overview 558 Transformation SDK Informatica Developer Platform 316 installation directory 321 installing 317 troubleshooting creating a domain 367 domain configuration database 366 error messages 377 infacmd 362 infasetup 362 Informatica Services 367 JBoss Application Server 373 joining a domain 367 licenses 368 Metadata Manager Client 376 pinging a domain 368 pmrep 362 PowerCenter Client 376 PowerCenter installation 361 Repository Service 369, 371 steps for PowerCenter installation 361 switching connections 372 uninstallation 386 Upgrade Wizard 411, 418 upgrading repositories 411 WebLogic Server 374 WebSphere Application Server 375
U
Unicode repository upgrading 457, 458 uninstalling application server files 387 Data Analyzer 386 Metadata Manager 386 Metadata Manager Client 386 PowerCenter Client 386 PowerCenter Reports 386 PowerCenter Services 386 process 388 rules and guidelines 386 troubleshooting 386 UNIX connecting to ODBC data sources 522 database client environment variables 60
database client variables 60 environment variables 59 library paths 60 user account 58 Update System Accounts utility configuring 309, 313 upgrade steps Data Analyzer 29, 93 Metadata Manager 31, 96 Metadata Manager Client 453 PowerCenter 23 upgrade utility Data Analyzer 432 Metadata Manager 442 Upgrade Wizard description 402 rules and guidelines 405 selecting configuration files 406 troubleshooting 411, 418 upgrade process 402 upgrading a PowerCenter Server 416 upgrading a Repository Agent 409, 413 viewing results 419 upgradeDomain (infaupgrade) usage 421 upgradeGatewayNode (infaupgrade) usage 421 upgradeWorkerNode (infaupgrade) usage 422 upgrading backing up the repository 93 color schemes 94 compatible PowerCenter upgrades 23 Data Profiling warehouse 427 deleting obsolete Metadata Manager objects 468 domain 420 importing Metadata Manager metamodels 469 Log Manager 460, 461 Metadata Manager Client 453 Metadata Manager repository 442 post-upgrade tasks 456 post-upgrade tasks for Data Analyzer 464 post-upgrade tasks for Metadata Manager 467 PowerCenter 78 PowerCenter 6.x/7.x 24 PowerCenter 8.0 25 PowerCenter 8.1 27 PowerCenter Server 416 pre-upgrade steps for Data Analyzer 93 pre-upgrade steps for Metadata Manager 96 pre-upgrade steps for PowerCenter 78
Index
573
refreshing Metadata Manager views 467 repositories 86 Repository Agent 409, 413 schedules 94 shared documents 94 steps for Metadata Manager 31 steps for Metadata Manager client 453 troubleshooting 411, 418 troubleshooting repository 411 Unicode repository 457, 458 Upgrade Wizard 402 using infaupgrade 420 using pmserverexportreg 89 Web Services Hub 80, 457, 458 user account system user 58 user account privileges Data Analyzer repositories 56 Data Profiling warehouse 56 Metadata Manager repositories 56 PowerCenter repositories 56 user accounts creating on database 56 user groups creating for WebSphere Application Server 72 users database 56 installation user 58 UTF-8 repository upgrading 457, 458
installing Metadata Manager on 4 starting 540 stopping 541 troubleshooting 374 WebSphere Application Server authentication 70 base edition 71 deployment manager 543, 546 installation prerequisites 40 installing 70 installing Data Analyzer on 4 installing Metadata Manager on 4 JMS server 544 Network Deployment edition 71 node agent 543 padaemon user account 71 PowerCenter Integration Utility 334 prerequisites for UNIX 71, 72 prerequisites for Windows 71 starting 542 stopping 545 troubleshooting 375 user groups 72 Windows Event Viewer troubleshooting JBoss Application Server 374
X
X Virtual Frame Buffer (Xvfb) installing on UNIX 73 X Window installation requirement on UNIX 63 XConnect description 10 installed 10
V
verbose mode Data Profiling warehouse size 38 viewing PowerCenter documentation 295
W
web browsers supported browsers 37 Web Services Hub upgrading 80, 457, 458 WebLogic domain uninstalling 387 WebLogic Server authentication 70 installation prerequisites 40 installing 70
574
Index